@jackens/nnn 2023.12.3 → 2023.12.5

package/h.d.ts

@@ -23,7 +23,9 @@ export type HArgs1 = Record<string, any> | null | undefined | Node | string | nu
  * - All other arguments of type `string`/`number` are converted to `Text` nodes and appended to the element being created or modified.
  * - All other arguments of type `HArgs` are passed to `h` and the results are appended to the element being created or modified.
  */
-export function h<T extends keyof HTMLElementTagNameMap>(tag: T, ...args1: HArgs1[]): HTMLElementTagNameMap[T];,export function h<N extends Node>(node: N, ...args1: HArgs1[]): N;,export function h(tagOrNode: string | Node, ...args1: HArgs1[]): Node;
+export function h<T extends keyof HTMLElementTagNameMap>(tag: T, ...args1: HArgs1[]): HTMLElementTagNameMap[T];
+export function h<N extends Node>(node: N, ...args1: HArgs1[]): N;
+export function h(tagOrNode: string | Node, ...args1: HArgs1[]): Node;
 
 /**
  * A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `SVGElement`s (see also `h`).
@@ -40,6 +42,8 @@ export function h<T extends keyof HTMLElementTagNameMap>(tag: T, ...args1: HArgs
  * - All other arguments of type `string`/`number` are converted to `Text` nodes and appended to the element being created or modified.
  * - All other arguments of type `HArgs` are passed to `s` and the results are appended to the element being created or modified.
  */
-export function s<T extends keyof SVGElementTagNameMap>(tag: T, ...args1: HArgs1[]): SVGElementTagNameMap[T];,export function s<N extends Node>(node: N, ...args1: HArgs1[]): N;,export function s(tagOrNode: string | Node, ...args1: HArgs1[]): Node;
+export function s<T extends keyof SVGElementTagNameMap>(tag: T, ...args1: HArgs1[]): SVGElementTagNameMap[T];
+export function s<N extends Node>(node: N, ...args1: HArgs1[]): N;
+export function s(tagOrNode: string | Node, ...args1: HArgs1[]): Node;
 
 export const tests: Record<string, () => void>;

package/package.json

@@ -40,5 +40,5 @@
   "types": "nnn.d.ts",
   "name": "@jackens/nnn",
   "type": "module",
-  "version": "2023.12.3"
+  "version": "2023.12.5"
 }

package/readme.md

@@ -1,6 +1,6 @@
 # nnn
 
-Jackens’ JavaScript helpers (version: 2023.12.3).
+Jackens’ JavaScript helpers.
 
 ## Installation
 
@@ -30,33 +30,33 @@ import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 
 ## Exports
 
-- `EscapeMap`: The type of arguments of the `escapeValues` and `escape` helpers.
-- `HArgs`: The type of arguments of the `h` and `s` helpers.
-- `HArgs1`: The type of arguments of the `h` and `s` helpers.
-- `JcssNode`: The type of arguments of the `jcss` helper.
-- `JcssRoot`: The type of arguments of the `jcss` helper.
-- `chartable`: A helper for creating a chart based on a table (conf. <https://jackens.github.io/nnn/chartable/>).
-- `eq`: A helper that checks equality of the given arguments.
-- `escape`: A generic helper for escaping `values` by given `escapeMap` (in *TemplateStrings* flavor).
-- `escapeValues`: A generic helper for escaping `values` by given `escapeMap`.
-- `fixTypography`: A helper that implements typographic corrections specific to Polish typography.
-- `h`: A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `HTMLElement`s (see also `s`).
-- `has`: A replacement for the `in` operator (not to be confused with the `for-in` loop) that works properly.
-- `is`: A helper that checks if the given argument is of a certain type.
-- `jcss`: A simple CSS-in-JS helper.
-- `jsOnParse`: `JSON.parse` with “JavaScript turned on”.
-- `locale`: Language translations helper.
-- `nanolight`: A generic helper for syntax highlighting (see also `nanolightJs`).
-- `nanolightJs`: A helper for highlighting JavaScript.
-- `plUral`: A helper for choosing the correct singular and plural.
-- `pro`: A helper that protects calls to nested properties by a `Proxy` that initializes non-existent values with an empty object.
-- `refsInfo`: A helper that provides information about the given `refs`.
-- `s`: A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `SVGElement`s (see also `h`).
-- `uuid1`: A helper that generates a UUID v1 identifier (with a creation timestamp).
-
-<a href="#EscapeMap" id="EscapeMap" name="EscapeMap">
-<h3>EscapeMap</h3>
-</a>
+- [EscapeMap](#EscapeMap): The type of arguments of the `escapeValues` and `escape` helpers.
+- [HArgs](#HArgs): The type of arguments of the `h` and `s` helpers.
+- [HArgs1](#HArgs1): The type of arguments of the `h` and `s` helpers.
+- [JcssNode](#JcssNode): The type of arguments of the `jcss` helper.
+- [JcssRoot](#JcssRoot): The type of arguments of the `jcss` helper.
+- [chartable](#chartable): A helper for creating a chart based on a table (conf. <https://jackens.github.io/nnn/chartable/>).
+- [eq](#eq): A helper that checks equality of the given arguments.
+- [escape](#escape): A generic helper for escaping `values` by given `escapeMap` (in *TemplateStrings* flavor).
+- [escapeValues](#escapeValues): A generic helper for escaping `values` by given `escapeMap`.
+- [fixTypography](#fixTypography): A helper that implements typographic corrections specific to Polish typography.
+- [h](#h): A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `HTMLElement`s (see also `s`).
+- [has](#has): A replacement for the `in` operator (not to be confused with the `for-in` loop) that works properly.
+- [is](#is): A helper that checks if the given argument is of a certain type.
+- [jcss](#jcss): A simple CSS-in-JS helper.
+- [jsOnParse](#jsOnParse): `JSON.parse` with “JavaScript turned on”.
+- [locale](#locale): Language translations helper.
+- [nanolight](#nanolight): A generic helper for syntax highlighting (see also `nanolightJs`).
+- [nanolightJs](#nanolightJs): A helper for highlighting JavaScript.
+- [plUral](#plUral): A helper for choosing the correct singular and plural.
+- [pro](#pro): A helper that protects calls to nested properties by a `Proxy` that initializes non-existent values with an empty object.
+- [refsInfo](#refsInfo): A helper that provides information about the given `refs`.
+- [s](#s): A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `SVGElement`s (see also `h`).
+- [uuid1](#uuid1): A helper that generates a UUID v1 identifier (with a creation timestamp).
+
+<a href="#EscapeMap" id="EscapeMap" name="EscapeMap"></a>
+
+### EscapeMap
 
 ```ts
 export type EscapeMap = Map<any, (value?: any) => string>;
@@ -64,9 +64,9 @@ export type EscapeMap = Map<any, (value?: any) => string>;
 
 The type of arguments of the `escapeValues` and `escape` helpers.
 
-<a href="#HArgs" id="HArgs" name="HArgs">
-<h3>HArgs</h3>
-</a>
+<a href="#HArgs" id="HArgs" name="HArgs"></a>
+
+### HArgs
 
 ```ts
 export type HArgs = [string | Node, ...HArgs1[]];
@@ -74,9 +74,9 @@ export type HArgs = [string | Node, ...HArgs1[]];
 
 The type of arguments of the `h` and `s` helpers.
 
-<a href="#HArgs1" id="HArgs1" name="HArgs1">
-<h3>HArgs1</h3>
-</a>
+<a href="#HArgs1" id="HArgs1" name="HArgs1"></a>
+
+### HArgs1
 
 ```ts
 export type HArgs1 = Record<string, any> | null | undefined | Node | string | number | [string | Node, ...HArgs1[]];
@@ -84,9 +84,9 @@ export type HArgs1 = Record<string, any> | null | undefined | Node | string | nu
 
 The type of arguments of the `h` and `s` helpers.
 
-<a href="#JcssNode" id="JcssNode" name="JcssNode">
-<h3>JcssNode</h3>
-</a>
+<a href="#JcssNode" id="JcssNode" name="JcssNode"></a>
+
+### JcssNode
 
 ```ts
 export type JcssNode = {
@@ -96,9 +96,9 @@ export type JcssNode = {
 
 The type of arguments of the `jcss` helper.
 
-<a href="#JcssRoot" id="JcssRoot" name="JcssRoot">
-<h3>JcssRoot</h3>
-</a>
+<a href="#JcssRoot" id="JcssRoot" name="JcssRoot"></a>
+
+### JcssRoot
 
 ```ts
 export type JcssRoot = Record<string, JcssNode>;
@@ -106,9 +106,9 @@ export type JcssRoot = Record<string, JcssNode>;
 
 The type of arguments of the `jcss` helper.
 
-<a href="#chartable" id="chartable" name="chartable">
-<h3>chartable</h3>
-</a>
+<a href="#chartable" id="chartable" name="chartable"></a>
+
+### chartable
 
 ```ts
 export function chartable({ bottom, gapX, gapY, headerColumn, headerRow, id, left, maxY, right, singleScale, table, title, top, xLabels, zLabels, zxY }?: {
@@ -151,9 +151,9 @@ Options:
 - `zLabels`: data series labels
 - `zxY`: chart data
 
-<a href="#eq" id="eq" name="eq">
-<h3>eq</h3>
-</a>
+<a href="#eq" id="eq" name="eq"></a>
+
+### eq
 
 ```ts
 export function eq(x: any, y: any): boolean;
@@ -195,9 +195,9 @@ console.assert(!eq(
 ))
 ```
 
-<a href="#escape" id="escape" name="escape">
-<h3>escape</h3>
-</a>
+<a href="#escape" id="escape" name="escape"></a>
+
+### escape
 
 ```ts
 export function escape(escapeMap: EscapeMap, template: TemplateStringsArray, ...values: any[]): string;
@@ -232,9 +232,9 @@ const expected = `
 console.assert(actual === expected)
 ```
 
-<a href="#escapeValues" id="escapeValues" name="escapeValues">
-<h3>escapeValues</h3>
-</a>
+<a href="#escapeValues" id="escapeValues" name="escapeValues"></a>
+
+### escapeValues
 
 ```ts
 export function escapeValues(escapeMap: EscapeMap, values: any[]): string[];
@@ -242,9 +242,9 @@ export function escapeValues(escapeMap: EscapeMap, values: any[]): string[];
 
 A generic helper for escaping `values` by given `escapeMap`.
 
-<a href="#fixTypography" id="fixTypography" name="fixTypography">
-<h3>fixTypography</h3>
-</a>
+<a href="#fixTypography" id="fixTypography" name="fixTypography"></a>
+
+### fixTypography
 
 ```ts
 export function fixTypography(node: Node): void;
@@ -264,9 +264,9 @@ console.assert(p.innerHTML ===
   '(zob. https://\u200Bpl.\u200Bwikipedia.\u200Borg/\u200Bwiki/\u200BPangram).')
 ```
 
-<a href="#h" id="h" name="h">
-<h3>h</h3>
-</a>
+<a href="#h" id="h" name="h"></a>
+
+### h
 
 ```ts
 export function h<T extends keyof HTMLElementTagNameMap>(tag: T, ...args1: HArgs1[]): HTMLElementTagNameMap[T];
@@ -356,9 +356,9 @@ h(div, { $key: { two: 2 } })
 console.assert(eq(div.key, { one: 1, two: 2 }))
 ```
 
-<a href="#has" id="has" name="has">
-<h3>has</h3>
-</a>
+<a href="#has" id="has" name="has"></a>
+
+### has
 
 ```ts
 export function has(key: any, ref: any): boolean;
@@ -397,9 +397,9 @@ console.assert(typeError instanceof TypeError) // Cannot use 'in' operator to se
 console.assert(!has('key', null))
 ```
 
-<a href="#is" id="is" name="is">
-<h3>is</h3>
-</a>
+<a href="#is" id="is" name="is"></a>
+
+### is
 
 ```ts
 export const is: {
@@ -459,9 +459,9 @@ console.assert(is(Object, fakeFooBar))
 console.assert(!iz(Object, fakeFooBar))
 ```
 
-<a href="#jcss" id="jcss" name="jcss">
-<h3>jcss</h3>
-</a>
+<a href="#jcss" id="jcss" name="jcss"></a>
+
+### jcss
 
 ```ts
 export function jcss(root: JcssRoot, splitter?: string): string;
@@ -673,9 +673,9 @@ const expected = `
 console.assert(actual === expected)
 ```
 
-<a href="#jsOnParse" id="jsOnParse" name="jsOnParse">
-<h3>jsOnParse</h3>
-</a>
+<a href="#jsOnParse" id="jsOnParse" name="jsOnParse"></a>
+
+### jsOnParse
 
 ```ts
 export function jsOnParse(handlers: Record<string, Function>, text: string): any;
@@ -740,9 +740,9 @@ const expected = [
 console.assert(eq(actual, expected))
 ```
 
-<a href="#locale" id="locale" name="locale">
-<h3>locale</h3>
-</a>
+<a href="#locale" id="locale" name="locale"></a>
+
+### locale
 
 ```ts
 export function locale(locales: Record<string, Record<string, string | Record<string, string>>>, defaultLanguage: string, languages?: readonly string[]): (text?: string | undefined, version?: string | undefined) => string;
@@ -775,9 +775,9 @@ console.assert(_('toString') === 'toString')
 console.assert(_('toString', 'undefined_version') === 'toString')
 ```
 
-<a href="#nanolight" id="nanolight" name="nanolight">
-<h3>nanolight</h3>
-</a>
+<a href="#nanolight" id="nanolight" name="nanolight"></a>
+
+### nanolight
 
 ```ts
 export function nanolight(pattern: RegExp, highlighters: ((chunk: string, index: number) => import('./h.js').HArgs)[], code: string): import("./h.js").HArgs[];
@@ -785,9 +785,9 @@ export function nanolight(pattern: RegExp, highlighters: ((chunk: string, index:
 
 A generic helper for syntax highlighting (see also `nanolightJs`).
 
-<a href="#nanolightJs" id="nanolightJs" name="nanolightJs">
-<h3>nanolightJs</h3>
-</a>
+<a href="#nanolightJs" id="nanolightJs" name="nanolightJs"></a>
+
+### nanolightJs
 
 ```ts
 export const nanolightJs: (code?: string | undefined) => import("./h.js").HArgs[];
@@ -804,9 +804,9 @@ console.assert(h('pre', ['code', ...nanolightJs(codeJs)]).outerHTML ===
   '<pre><code><b>const</b> <i>answerToLifeTheUniverseAndEverything</i> <b>=</b> <u>42</u></code></pre>')
 ```
 
-<a href="#plUral" id="plUral" name="plUral">
-<h3>plUral</h3>
-</a>
+<a href="#plUral" id="plUral" name="plUral"></a>
+
+### plUral
 
 ```ts
 export function plUral(singular: string, plural2: string, plural5: string, value: number): string;
@@ -832,9 +832,9 @@ console.assert(car(17) === 'cars')
 console.assert(car(42) === 'cars')
 ```
 
-<a href="#pro" id="pro" name="pro">
-<h3>pro</h3>
-</a>
+<a href="#pro" id="pro" name="pro"></a>
+
+### pro
 
 ```ts
 export function pro(ref: any): any;
@@ -872,9 +872,9 @@ pro(ref).one.two.three.four = 1234
 console.assert(eq(ref, { one: { two: { three: { four: 1234 } } } }))
 ```
 
-<a href="#refsInfo" id="refsInfo" name="refsInfo">
-<h3>refsInfo</h3>
-</a>
+<a href="#refsInfo" id="refsInfo" name="refsInfo"></a>
+
+### refsInfo
 
 ```ts
 export function refsInfo(...refs: any[]): [string, string, string[]][];
@@ -917,9 +917,9 @@ const browserFingerprint = () => {
 console.log(browserFingerprint())
 ```
 
-<a href="#s" id="s" name="s">
-<h3>s</h3>
-</a>
+<a href="#s" id="s" name="s"></a>
+
+### s
 
 ```ts
 export function s<T extends keyof SVGElementTagNameMap>(tag: T, ...args1: HArgs1[]): SVGElementTagNameMap[T];
@@ -941,9 +941,9 @@ A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style help
 - All other arguments of type `string`/`number` are converted to `Text` nodes and appended to the element being created or modified.
 - All other arguments of type `HArgs` are passed to `s` and the results are appended to the element being created or modified.
 
-<a href="#uuid1" id="uuid1" name="uuid1">
-<h3>uuid1</h3>
-</a>
+<a href="#uuid1" id="uuid1" name="uuid1"></a>
+
+### uuid1
 
 ```ts
 export function uuid1({ date, node }?: {