chore: prepare v1.12.0

Signed-off-by: Jan Kowalleck <[email protected]>

Author: jkowalleck

HISTORY.md

@@ -4,7 +4,7 @@ All notable changes to this project will be documented in this file.
 
 ## unreleased
 
-## 1.12.0 -  2023-03-02
+## 1.12.0 - 2023-03-02
 
 * Docs
   * Made it clear, that `{Builders,Factories}.{FromNodePackageJson,FromPackageJson}.*` functionality is to be run on already normalized structures. ([#517] via [#518])  

src/_helpers/packageJson.ts

@@ -28,9 +28,10 @@ export function splitNameGroup (data: string): [string, string?] {
 }
 
 /**
- * Intended to represent [normalized](https://www.npmjs.com/package/normalize-package-data) data structures
+ * Intended to represent normalized data structures
  * based on [PackageJson spec](https://github.com/SchemaStore/schemastore/blob/master/src/schemas/json/package.json)
- * and [PackageJson description](https://docs.npmjs.com/cli/v9/configuring-npm/package-json).
+ * and explained by [PackageJson description](https://docs.npmjs.com/cli/v9/configuring-npm/package-json).
+ * Normalization should be done downstream, for example via [`normalize-package-data`](https://www.npmjs.com/package/normalize-package-data).
  */
 export interface PackageJson {
   name?: string

src/builders/fromNodePackageJson.node.ts

@@ -20,10 +20,10 @@ Copyright (c) OWASP Foundation. All Rights Reserved.
 /**
  * Node-specifics.
  *
- * Intended to run on [normalized](https://www.npmjs.com/package/normalize-package-data) data structures
+ * Intended to run on normalized data structures
  * based on [PackageJson spec](https://github.com/SchemaStore/schemastore/blob/master/src/schemas/json/package.json)
- * and [PackageJson description](https://docs.npmjs.com/cli/v9/configuring-npm/package-json).
- * Normalization should be done downstream.
+ * and explained by [PackageJson description](https://docs.npmjs.com/cli/v9/configuring-npm/package-json).
+ * Normalization should be done downstream, for example via [`normalize-package-data`](https://www.npmjs.com/package/normalize-package-data).
  */
 
 import type { PackageJson } from '../_helpers/packageJson'

src/factories/fromNodePackageJson.node.ts

@@ -20,10 +20,10 @@ Copyright (c) OWASP Foundation. All Rights Reserved.
 /**
  * Node-specifics.
  *
- * Intended to run on [normalized](https://www.npmjs.com/package/normalize-package-data) data structures
+ * Intended to run on normalized data structures
  * based on [PackageJson spec](https://github.com/SchemaStore/schemastore/blob/master/src/schemas/json/package.json)
- * and [PackageJson description](https://docs.npmjs.com/cli/v9/configuring-npm/package-json).
- * Normalization should be done downstream.
+ * and explained by [PackageJson description](https://docs.npmjs.com/cli/v9/configuring-npm/package-json).
+ * Normalization should be done downstream, for example via [`normalize-package-data`](https://www.npmjs.com/package/normalize-package-data).
  */
 
 import type { PackageURL } from 'packageurl-js'