@jackens/nnn 2024.7.9 → 2024.7.12

package/package.json

@@ -1,7 +1,7 @@
 {
   "author": "Jackens",
   "description": "Jackens’ JavaScript helpers.",
-  "homepage": "https://jackens.github.io/nnn/",
+  "homepage": "https://jackens.github.io/doc/",
   "keywords": [
     "CSS-in-JS",
     "CSV",
@@ -33,8 +33,8 @@
   ],
   "license": "MIT",
   "main": "nnn.js",
-  "types": "nnn.d.ts",
   "name": "@jackens/nnn",
   "type": "module",
-  "version": "2024.7.9"
-}
+  "types": "nnn.d.ts",
+  "version": "2024.7.12"
+}

package/readme.md

@@ -2,7 +2,7 @@
 
 Jackens’ JavaScript helpers.
 
-<sub>Version: <code class="version">2024.7.9</code></sub>
+<sub>Version: <code class="version">2024.7.12</code></sub>
 
 ## Installation
 
@@ -31,7 +31,7 @@ import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 or:
 
 ```js
-import { «something» } from 'https://unpkg.com/@jackens/nnn@2024.7.9/nnn.js'
+import { «something» } from 'https://unpkg.com/@jackens/nnn@2024.7.12/nnn.js'
 ```
 
 ## Exports
@@ -84,8 +84,6 @@ The type of arguments of the `h` and `s` helpers.
 type HArgs1 = Partial<Record<PropertyKey, unknown>> | null | undefined | Node | string | number | HArgs;
 ```
 
-> See [here](https://jackens.github.io/nnn/doc/#Why-Partial-Array-and-Partial-Record) for an explanation of why `Partial<Record>` instead of `Record`.
-
 The type of arguments of the `h` and `s` helpers.
 
 ### JcNode
@@ -104,8 +102,6 @@ The type of arguments of the `jc` helper.
 type JcRoot = Partial<Record<PropertyKey, JcNode>>;
 ```
 
-> See [here](https://jackens.github.io/nnn/doc/#Why-Partial-Array-and-Partial-Record) for an explanation of why `Partial<Record>` instead of `Record`.
-
 The type of arguments of the `jc` helper.
 
 ### csvParse
@@ -117,8 +113,6 @@ const csvParse: (text: string, { header, separator }?: {
 }) => Partial<Array<Partial<Record<PropertyKey, string>>>> | Partial<Array<Partial<Array<string>>>>;
 ```
 
-> See [here](https://jackens.github.io/nnn/doc/#Why-Partial-Array-and-Partial-Record) for an explanation of why `Partial<Array>`/`Partial<Record>` instead of `Array`/`Record`.
-
 A tiny helper for CSV parsing.
 
 Options:
@@ -159,8 +153,6 @@ expect(csvParse(text)).to.deep.equal([{
 const escape: (escapeMap: EscapeMap, template: TemplateStringsArray, ...values: Partial<Array<unknown>>) => string;
 ```
 
-> See [here](https://jackens.github.io/nnn/doc/#Why-Partial-Array-and-Partial-Record) for an explanation of why `Partial<Array>` instead of `Array`.
-
 A generic helper for escaping `values` by given `escapeMap` (in *TemplateStrings* flavor).
 
 #### Usage Examples
@@ -196,8 +188,6 @@ expect(actual).to.deep.equal(expected)
 const escapeValues: (escapeMap: EscapeMap, values: Partial<Array<unknown>>) => Partial<Array<string>>;
 ```
 
-> See [here](https://jackens.github.io/nnn/doc/#Why-Partial-Array-and-Partial-Record) for an explanation of why `Partial<Array>` instead of `Array`.
-
 A generic helper for escaping `values` by given `escapeMap`.
 
 ### fixTypography
@@ -230,8 +220,6 @@ const h: {
 };
 ```
 
-> See [here](https://jackens.github.io/nnn/doc/#Why-Partial-Array-and-Partial-Record) for an explanation of why `Partial<Array>` instead of `Array`.
-
 A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `HTMLElement`s (see also `s`).
 
 - The first argument of type `string` specifies the tag of the element to be created.
@@ -369,8 +357,6 @@ const is: {
 };
 ```
 
-> See [here](https://jackens.github.io/nnn/doc/#Why-Partial-Array-and-Partial-Record) for an explanation of why `Partial<Array>`/`Partial<Record>` instead of `Array`/`Record`.
-
 A helper that checks if the given argument is of a certain type.
 
 #### Usage Examples
@@ -651,8 +637,6 @@ expect(actual).to.deep.equal(expected)
 const jsOnParse: (handlers: Partial<Record<PropertyKey, Function>>, text: string) => any;
 ```
 
-> See [here](https://jackens.github.io/nnn/doc/#Why-Partial-Array-and-Partial-Record) for an explanation of why `Partial<Record>` instead of `Record`.
-
 `JSON.parse` with “JavaScript turned on”.
 
 Objects having *exactly* one property which is present in the `handlers` map, i.e. objects of the form:
@@ -720,8 +704,6 @@ expect(actual).to.deep.equal(expected)
 const locale: (map: Partial<Record<PropertyKey, Partial<Record<PropertyKey, string>>>>, defaultVersion: string) => (text: string, version?: string) => string;
 ```
 
-> See [here](https://jackens.github.io/nnn/doc/#Why-Partial-Array-and-Partial-Record) for an explanation of why `Partial<Record>` instead of `Record`.
-
 Language translations helper.
 
 #### Usage Examples
@@ -752,8 +734,6 @@ expect(_('toString', 'undefined_version')).to.deep.equal('toString')
 const nanolight: (pattern: RegExp, highlighters: Partial<Array<(chunk: string, index: number) => HArgs1>>, code: string) => HArgs1[];
 ```
 
-> See [here](https://jackens.github.io/nnn/doc/#Why-Partial-Array-and-Partial-Record) for an explanation of why `Partial<Array>` instead of `Array`.
-
 A generic helper for syntax highlighting (see also `nanolightJs`).
 
 ### nanolightJs
@@ -786,8 +766,6 @@ expect(nanolightJs(codeJs)).to.deep.equal([
 const omit: <T extends Partial<Record<PropertyKey, unknown>>, K extends Array<keyof T>>(obj: Partial<Record<PropertyKey, unknown>>, keys: Partial<Array<unknown>>) => Omit<T, K[number]>;
 ```
 
-> See [here](https://jackens.github.io/nnn/doc/#Why-Partial-Array-and-Partial-Record) for an explanation of why `Partial<Array>`/`Partial<Record>` instead of `Array`/`Record`.
-
 A helper that implements TypeScript’s `Omit` utility type.
 
 #### Usage Examples
@@ -804,8 +782,6 @@ expect(omit(obj, ['c'])).to.deep.equal({ a: 42, b: '42' })
 const pick: <T extends Partial<Record<PropertyKey, unknown>>, K extends Array<keyof T>>(obj: Partial<Record<PropertyKey, unknown>>, keys: Partial<Array<unknown>>) => Pick<T, K[number]>;
 ```
 
-> See [here](https://jackens.github.io/nnn/doc/#Why-Partial-Array-and-Partial-Record) for an explanation of why `Partial<Array>`/`Partial<Record>` instead of `Array`/`Record`.
-
 A helper that implements TypeScript’s `Pick` utility type.
 
 #### Usage Examples
@@ -886,8 +862,6 @@ expect(ref).to.deep.equal({ one: { two: { three: { four: 1234 } } } })
 const refsInfo: (...refs: Partial<Array<unknown>>) => Partial<Array<[string, string, Partial<Array<string>>]>>;
 ```
 
-> See [here](https://jackens.github.io/nnn/doc/#Why-Partial-Array-and-Partial-Record) for an explanation of why `Partial<Array>` instead of `Array`.
-
 A helper that provides information about the given `refs`.
 
 It returns an array of triples: `[«name», «prototype-name», «array-of-own-property-names»]`.
@@ -935,8 +909,6 @@ const s: {
 };
 ```
 
-> See [here](https://jackens.github.io/nnn/doc/#Why-Partial-Array-and-Partial-Record) for an explanation of why `Partial<Array>` instead of `Array`.
-
 A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `SVGElement`s (see also `h`).
 
 - The first argument of type `string` specifies the tag of the element to be created.
@@ -957,8 +929,6 @@ A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style help
 const svgUse: (id: string, ...args: Partial<Array<HArgs1>>) => SVGSVGElement;
 ```
 
-> See [here](https://jackens.github.io/nnn/doc/#Why-Partial-Array-and-Partial-Record) for an explanation of why `Partial<Array>` instead of `Array`.
-
 A convenient shortcut for `s('svg', ['use', { 'xlink:href': '#' + id }], ...args)`.
 
 ### uuid1