@jackens/nnn 2025.6.20 → 2025.9.4

package/nnn.d.ts

@@ -1,67 +1,66 @@
 /**
- * The type of arguments of the `c` helper.
+ * Argument type for the `c` helper.
  */
 export type C_Node = {
     [attribute_or_selector: string]: string | number | C_Node | undefined;
 };
 /**
- * The type of arguments of the `c` helper.
+ * Argument type for the `c` helper.
  */
 export type C_Root = Record<PropertyKey, C_Node>;
 /**
- * A simple JS-to-CSS (aka CSS-in-JS) helper.
+ * A minimal JS-to-CSS (CSS‑in‑JS) helper.
  *
- * The `root` parameter provides a hierarchical description of CSS rules.
+ * The `root` object describes a hierarchy of CSS rules.
  *
- * - Keys of sub-objects whose values are NOT objects are treated as CSS attribute, and values are treated as values of those CSS attributes; the concatenation of keys of all parent objects is a CSS rule.
- * - All keys ignore the part starting with a splitter (default: `$$`) sign until the end of the key (e.g. `src$$1` → `src`, `@font-face$$1` → `@font-face`).
- * - In keys specifying CSS attribute, all uppercase letters are replaced by lowercase letters with an additional `-` character preceding them (e.g. `fontFamily` → `font-family`), while all `_` characters are replaced by `-` character (e.g. `font_family` → `font-family`).
- * - Commas in keys that makes a CSS rule cause it to “split” and create separate rules for each part (e.g. `{div:{margin:1,'.a,.b,.c':{margin:2}}}` → `div{margin:1}div.a,div.b,div.c{margin:2}`).
- * - Top-level keys that begin with `@` are not concatenated with sub-object keys.
+ * - Keys whose values are not objects are treated as CSS property names; their values become property values. The concatenation of parent keys produces a selector.
+ * - For every key, the substring starting with the splitter (default: `$$`) to the end is ignored (e.g. `src$$1` → `src`, `@font-face$$1` → `@font-face`).
+ * - In property keys, uppercase letters are converted to lowercase and prefixed with `-` (e.g. `fontFamily` → `font-family`); underscores are converted to `-` (e.g. `font_family` → `font-family`).
+ * - Commas inside selector keys cause them to expand into multiple selectors (e.g. `{div:{margin:1,'.a,.b,.c':{margin:2}}}` → `div{margin:1}div.a,div.b,div.c{margin:2}`).
+ * - Top-level keys beginning with `@` (at-rules) are not concatenated with parent keys.
  */
 export declare const c: (root: C_Root, splitter?: string) => string;
 /**
- * A tiny helper for parsing CSV.
+ * A tiny CSV parsing helper.
  */
-export declare const csv_parse_raw: (csv: string, separator?: string) => string[][];
+export declare const csv_parse: (csv: string, separator?: string) => string[][];
 /**
- * A tiny helper for parsing CSV.
- */
-export declare const csv_parse: (csv: string, separator?: string) => Record<PropertyKey, string>[];
-/**
- * The type of arguments of the `escape_values` and `escape` helpers.
+ * Argument type accepted by the `escape_values` and `escape` helpers.
  */
 export type Escape_Map = Map<unknown, (value?: unknown) => string>;
 /**
- * A generic helper for escaping `values` by given `escape_map`.
+ * Escapes array `values` using the provided `escape_map`.
  */
 export declare const escape_values: (escape_map: Escape_Map, values: unknown[]) => string[];
 /**
- * A generic helper for escaping `values` by given `escape_map` (in *TemplateStrings* flavor).
+ * Escapes interpolated template `values` using the provided `escape_map`.
  */
 export declare const escape: (escape_map: Escape_Map, template: TemplateStringsArray, ...values: unknown[]) => string;
 /**
- * A helper that implements typographic corrections specific to Polish typography.
+ * Applies Polish‑specific typographic corrections.
  */
 export declare const fix_typography: (node: Node) => void;
 /**
- * The type of arguments of the `h` and `s` helpers.
+ * Argument type for the `h` and `s` helpers.
  */
 export type H_Args_1 = Record<PropertyKey, unknown> | null | undefined | Node | string | number | H_Args;
 /**
- * The type of arguments of the `h` and `s` helpers.
+ * Argument type for the `h` and `s` helpers.
  */
 export type H_Args = [string | Node, ...H_Args_1[]];
 /**
  * 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.
- * - The first argument of type `Node` specifies the element to be modified.
- * - All other arguments of type `Record<PropertyKey, unknown>` are mappings of attributes and properties. Keys starting with `$` specify *properties* (without the leading `$`) to be set on the element being created or modified. (Note that `$` is not a valid attribute name character.) All other keys specify *attributes* to be set by `setAttribute`. An attribute equal to `false` causes the attribute to be removed by `removeAttribute`.
- * - All other arguments of type `null` or `undefined` are simply ignored.
- * - All other arguments of type `Node` are appended to the element being created or modified.
- * - 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.
+ * - If the first argument is a `string`, it is treated as the tag name to create.
+ * - If the first argument is a `Node`, that node is modified.
+ * - Object arguments map attributes/properties:
+ *   - Keys starting with `$` set element properties (without `$`).
+ *   - Other keys set attributes via `setAttribute`.
+ *   - Attributes with value `false` are removed via `removeAttribute`.
+ * - `null` / `undefined` are ignored.
+ * - `Node` arguments are appended.
+ * - `string` / `number` arguments become `Text` nodes.
+ * - `H_Args` arrays are processed recursively.
  */
 export declare const h: {
     <T extends keyof HTMLElementTagNameMap>(tag: T, ...args1: H_Args_1[]): HTMLElementTagNameMap[T];
@@ -71,13 +70,16 @@ export declare const h: {
 /**
  * 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.
- * - The first argument of type `Node` specifies the element to be modified.
- * - All other arguments of type `Record<PropertyKey, unknown>` are mappings of attributes and properties. Keys starting with `$` specify *properties* (without the leading `$`) to be set on the element being created or modified. (Note that `$` is not a valid attribute name character.) All other keys specify *attributes* to be set by `setAttributeNS`. An attribute equal to `false` causes the attribute to be removed by `removeAttributeNS`.
- * - All other arguments of type `null` or `undefined` are simply ignored.
- * - All other arguments of type `Node` are appended to the element being created or modified.
- * - 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.
+ * - If the first argument is a `string`, it is treated as the tag name to create.
+ * - If the first argument is a `Node`, that node is modified.
+ * - Object arguments map attributes/properties:
+ *   - Keys starting with `$` set element properties (without `$`).
+ *   - Other keys set attributes via `setAttributeNS`.
+ *   - Attributes with value `false` are removed via `removeAttributeNS`.
+ * - `null` / `undefined` are ignored.
+ * - `Node` arguments are appended.
+ * - `string` / `number` arguments become `Text` nodes.
+ * - `H_Args` arrays are processed recursively.
  */
 export declare const s: {
     <T extends keyof SVGElementTagNameMap>(tag: T, ...args1: H_Args_1[]): SVGElementTagNameMap[T];
@@ -85,39 +87,48 @@ export declare const s: {
     (tag_or_node: string | Node, ...args1: H_Args_1[]): Node;
 };
 /**
- * A convenient shortcut for `s('svg', ['use', { 'xlink:href': '#' + id }], ...args)`.
+ * Shorthand for: `s('svg', ['use', { 'xlink:href': '#' + id }], ...args)`.
  */
 export declare const svg_use: (id: string, ...args: H_Args_1[]) => SVGSVGElement;
 /**
- * A replacement for the `in` operator (not to be confused with the `for-in` loop) that works properly.
+ * A replacement to the `in` operator (not to be confused with `for-in`).
  */
 export declare const has_own: (ref: unknown, key: unknown) => boolean;
 /**
- * A helper that checks if the given argument is of type `any[]`.
+ * Checks whether the argument is an array.
  */
 export declare const is_array: (arg: any) => arg is any[];
+declare const FINITE_NUMBER: unique symbol;
+type Finite_Number = number & {
+    readonly [FINITE_NUMBER]: true;
+};
+/**
+ * Checks whether the argument is a finite number (excluding `±Infinity` and `NaN`).
+ */
+export declare const is_finite_number: ((arg: unknown) => arg is Finite_Number);
 /**
- * A helper that checks if the given argument is of type `number`.
+ * Checks whether the argument is a number.
  */
-export declare const is_number: (arg: any) => arg is number;
+export declare const is_number: (arg: unknown) => arg is number;
 /**
- * A helper that checks if the given argument is of type `Record<PropertyKey, unknown>`.
+ * Checks whether the argument is a plain object record.
  */
-export declare const is_record: (arg: any) => arg is Record<PropertyKey, unknown>;
+export declare const is_record: (arg: unknown) => arg is Record<PropertyKey, unknown>;
 /**
- * A helper that checks if the given argument is of type `string`.
+ * Checks whether the argument is a string.
  */
-export declare const is_string: (arg: any) => arg is string;
+export declare const is_string: (arg: unknown) => arg is string;
+export {};
 /**
  * `JSON.parse` with “JavaScript turned on”.
  *
- * Objects having *exactly* one property which is present in the `handlers` map, i.e. objects of the form:
+ * Objects having *exactly* one property whose name exists in `handlers`, i.e.:
  *
  * ```js
  * { "«handler_name»": [«params»] }
  * ```
  *
- * are replaced by the result of call
+ * are replaced with:
  *
  * ```js
  * handlers['«handler_name»'](...«params»)
@@ -126,32 +137,32 @@ export declare const is_string: (arg: any) => arg is string;
 export declare const js_on_parse: (handlers: Record<PropertyKey, Function>, text: string) => any;
 import type { H_Args_1 } from './h.js';
 /**
- * A generic helper for syntax highlighting (see also `nanolight_js`).
+ * Generic syntax highlighting helper (see also `nanolight_js`).
  */
 export declare const nanolight: (pattern: RegExp, highlighters: ((chunk: string, index: number) => H_Args_1)[], code: string) => H_Args_1[];
 /**
- * A helper for highlighting JavaScript (see also `nanolight`).
+ * JavaScript syntax highlighting helper (built on `nanolight`).
  */
 export declare const nanolight_js: (code: string) => H_Args_1[];
 /**
- * A helper that implements TypeScript’s `Pick` utility type (see also `omit`).
+ * Runtime implementation of TypeScript’s `Pick` (see also `omit`).
  */
 export declare const pick: <T, K extends keyof T>(ref: T, keys: K[]) => Pick<T, K>;
 /**
- * A helper that implements TypeScript’s `Omit` utility type (see also `pick`).
+ * Runtime implementation of TypeScript’s `Omit` (see also `pick`).
  */
 export declare const omit: <T, K extends keyof T>(ref: T, keys: unknown[]) => Omit<T, K>;
 /**
- * A helper for choosing the correct singular and plural.
+ * Chooses the appropriate Polish noun form based on a numeric value.
  */
 export declare const pl_ural: (singular: string, plural_2: string, plural_5: string, value: number) => string;
 /**
- * A helper that protects calls to nested properties by a `Proxy` that initializes non-existent values with an empty object.
+ * A `Proxy`-based helper that safely creates nested structures on access and allows deep assignment without guards.
  */
 export declare const pro: (ref: unknown) => any;
 /**
- * A helper that generates a UUID v1 identifier (with a creation timestamp).
+ * Generates a UUID v1 (time-based) identifier.
  *
- * - The optional `node` parameter should have the format `/^[0123456789abcdef]+$/`. Its value will be trimmed to last 12 characters and left padded with zeros.
+ * - Optional `node` must match `/^[0-9a-f]*$/`; it is trimmed to the last 12 characters and left-padded with zeros.
  */
 export declare const uuid_v1: (date?: Date, node?: string) => string;

package/nnn.js

@@ -1,5 +1,6 @@
 // src/nnn/is.ts
 var is_array = Array.isArray;
+var is_finite_number = Number.isFinite;
 var is_number = (arg) => typeof arg === "number";
 var is_record = (arg) => typeof arg === "object" && arg != null && !is_array(arg);
 var is_string = (arg) => typeof arg === "string";
@@ -57,19 +58,11 @@ var c = (root, splitter = "$$") => {
   return chunks.join("");
 };
 // src/nnn/csv_parse.ts
-var csv_parse_raw = (csv, separator = ",") => {
+var csv_parse = (csv, separator = ",") => {
   const main_pattern = /\n|(?<!")("(?:[^"]|"")*")(?!")/g;
   const line_pattern = new RegExp(`${separator}|(?<!")\\s*"((?:[^"]|"")*)"\\s*(?!")`, "g");
   return csv.replace(/\r/g, "").replace(/\n+$/, "").replace(main_pattern, (_, chunk) => chunk ?? "\r").split("\r").map((line) => line.replace(line_pattern, (_, chunk) => chunk == null ? "\r" : chunk.replace(/""/g, '"')).split("\r"));
 };
-var csv_parse = (csv, separator = ",") => {
-  const rows = csv_parse_raw(csv, separator);
-  const keys = rows.shift();
-  return keys != null ? rows.map((row) => keys.reduce((record, key, index) => {
-    record[key] = row[index];
-    return record;
-  }, {})) : [];
-};
 // src/nnn/escape.ts
 var escape_values = (escape_map, values) => values.map((value) => (escape_map.get(value?.constructor) ?? escape_map.get(undefined))?.(value) ?? "");
 var escape = (escape_map, template, ...values) => String.raw(template, ...escape_values(escape_map, values));
@@ -90,7 +83,7 @@ var _h = (namespace_uri) => {
           if (name[0] === "$") {
             const name1 = name.slice(1);
             if (is_record(value)) {
-              node[name1] = node[name1] ?? {};
+              node[name1] ??= {};
               Object.assign(node[name1], value);
             } else {
               node[name1] = value;
@@ -221,7 +214,7 @@ var pl_ural = (singular, plural_2, plural_5, value) => {
 // src/nnn/pro.ts
 var pro = (ref) => new Proxy(ref, {
   get(target, key) {
-    return pro(target[key] = target[key] ?? {});
+    return pro(target[key] ??= {});
   }
 });
 // src/nnn/uuid_v1.ts
@@ -246,13 +239,13 @@ export {
   is_string,
   is_record,
   is_number,
+  is_finite_number,
   is_array,
   has_own,
   h,
   fix_typography,
   escape_values,
   escape,
-  csv_parse_raw,
   csv_parse,
   c
 };

package/package.json

@@ -15,6 +15,7 @@
     "in",
     "is",
     "is_array",
+    "is_finite_number",
     "is_number",
     "is_record",
     "is_string",
@@ -35,5 +36,5 @@
   "name": "@jackens/nnn",
   "type": "module",
   "types": "nnn.d.ts",
-  "version": "2025.6.20"
+  "version": "2025.9.4"
 }

package/readme.md

@@ -1,6 +1,6 @@
 # nnn
 
-Jackens’ JavaScript helpers.
+A collection of Jackens’ JavaScript helper utilities.
 
 ## Installation
 
@@ -28,33 +28,33 @@ import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 
 ## Exports
 
-- `C_Node`: The type of arguments of the `c` helper.
-- `C_Root`: The type of arguments of the `c` helper.
-- `Escape_Map`: The type of arguments of the `escape_values` and `escape` helpers.
-- `H_Args`: The type of arguments of the `h` and `s` helpers.
-- `H_Args_1`: The type of arguments of the `h` and `s` helpers.
-- `c`: A simple JS-to-CSS (aka CSS-in-JS) helper.
-- `csv_parse`: A tiny helper for parsing CSV.
-- `csv_parse_raw`: A tiny helper for parsing CSV.
-- `escape`: A generic helper for escaping `values` by given `escape_map` (in *TemplateStrings* flavor).
-- `escape_values`: A generic helper for escaping `values` by given `escape_map`.
-- `fix_typography`: A helper that implements typographic corrections specific to Polish typography.
+- `C_Node`: Argument type for the `c` helper.
+- `C_Root`: Argument type for the `c` helper.
+- `Escape_Map`: Argument type accepted by the `escape_values` and `escape` helpers.
+- `H_Args`: Argument type for the `h` and `s` helpers.
+- `H_Args_1`: Argument type for the `h` and `s` helpers.
+- `c`: A minimal JS-to-CSS (CSS‑in‑JS) helper.
+- `csv_parse`: A tiny CSV parsing helper.
+- `escape`: Escapes interpolated template `values` using the provided `escape_map`.
+- `escape_values`: Escapes array `values` using the provided `escape_map`.
+- `fix_typography`: Applies Polish‑specific typographic corrections.
 - `h`: A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `HTMLElement`s (see also `s`).
-- `has_own`: A replacement for the `in` operator (not to be confused with the `for-in` loop) that works properly.
-- `is_array`: A helper that checks if the given argument is of type `any[]`.
-- `is_number`: A helper that checks if the given argument is of type `number`.
-- `is_record`: A helper that checks if the given argument is of type `Record<PropertyKey, unknown>`.
-- `is_string`: A helper that checks if the given argument is of type `string`.
+- `has_own`: A replacement to the `in` operator (not to be confused with `for-in`).
+- `is_array`: Checks whether the argument is an array.
+- `is_finite_number`: Checks whether the argument is a finite number (excluding `±Infinity` and `NaN`).
+- `is_number`: Checks whether the argument is a number.
+- `is_record`: Checks whether the argument is a plain object record.
+- `is_string`: Checks whether the argument is a string.
 - `js_on_parse`: `JSON.parse` with “JavaScript turned on”.
-- `nanolight`: A generic helper for syntax highlighting (see also `nanolight_js`).
-- `nanolight_js`: A helper for highlighting JavaScript (see also `nanolight`).
-- `omit`: A helper that implements TypeScript’s `Omit` utility type (see also `pick`).
-- `pick`: A helper that implements TypeScript’s `Pick` utility type (see also `omit`).
-- `pl_ural`: 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.
+- `nanolight`: Generic syntax highlighting helper (see also `nanolight_js`).
+- `nanolight_js`: JavaScript syntax highlighting helper (built on `nanolight`).
+- `omit`: Runtime implementation of TypeScript’s `Omit` (see also `pick`).
+- `pick`: Runtime implementation of TypeScript’s `Pick` (see also `omit`).
+- `pl_ural`: Chooses the appropriate Polish noun form based on a numeric value.
+- `pro`: A `Proxy`-based helper that safely creates nested structures on access and allows deep assignment without guards.
 - `s`: A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `SVGElement`s (see also `h`).
-- `svg_use`: A convenient shortcut for `s('svg', ['use', { 'xlink:href': '#' + id }], ...args)`.
-- `uuid_v1`: A helper that generates a UUID v1 identifier (with a creation timestamp).
+- `svg_use`: Shorthand for: `s('svg', ['use', { 'xlink:href': '#' + id }], ...args)`.
+- `uuid_v1`: Generates a UUID v1 (time-based) identifier.
 
 ### C_Node
 
@@ -64,7 +64,7 @@ type C_Node = {
 };
 ```
 
-The type of arguments of the `c` helper.
+Argument type for the `c` helper.
 
 ### C_Root
 
@@ -72,7 +72,7 @@ The type of arguments of the `c` helper.
 type C_Root = Record<PropertyKey, C_Node>;
 ```
 
-The type of arguments of the `c` helper.
+Argument type for the `c` helper.
 
 ### Escape_Map
 
@@ -80,7 +80,7 @@ The type of arguments of the `c` helper.
 type Escape_Map = Map<unknown, (value?: unknown) => string>;
 ```
 
-The type of arguments of the `escape_values` and `escape` helpers.
+Argument type accepted by the `escape_values` and `escape` helpers.
 
 ### H_Args
 
@@ -88,7 +88,7 @@ The type of arguments of the `escape_values` and `escape` helpers.
 type H_Args = [string | Node, ...H_Args_1[]];
 ```
 
-The type of arguments of the `h` and `s` helpers.
+Argument type for the `h` and `s` helpers.
 
 ### H_Args_1
 
@@ -96,7 +96,7 @@ The type of arguments of the `h` and `s` helpers.
 type H_Args_1 = Record<PropertyKey, unknown> | null | undefined | Node | string | number | H_Args;
 ```
 
-The type of arguments of the `h` and `s` helpers.
+Argument type for the `h` and `s` helpers.
 
 ### c
 
@@ -104,15 +104,15 @@ The type of arguments of the `h` and `s` helpers.
 const c: (root: C_Root, splitter?: string) => string;
 ```
 
-A simple JS-to-CSS (aka CSS-in-JS) helper.
+A minimal JS-to-CSS (CSS‑in‑JS) helper.
 
-The `root` parameter provides a hierarchical description of CSS rules.
+The `root` object describes a hierarchy of CSS rules.
 
-- Keys of sub-objects whose values are NOT objects are treated as CSS attribute, and values are treated as values of those CSS attributes; the concatenation of keys of all parent objects is a CSS rule.
-- All keys ignore the part starting with a splitter (default: `$$`) sign until the end of the key (e.g. `src$$1` → `src`, `@font-face$$1` → `@font-face`).
-- In keys specifying CSS attribute, all uppercase letters are replaced by lowercase letters with an additional `-` character preceding them (e.g. `fontFamily` → `font-family`), while all `_` characters are replaced by `-` character (e.g. `font_family` → `font-family`).
-- Commas in keys that makes a CSS rule cause it to “split” and create separate rules for each part (e.g. `{div:{margin:1,'.a,.b,.c':{margin:2}}}` → `div{margin:1}div.a,div.b,div.c{margin:2}`).
-- Top-level keys that begin with `@` are not concatenated with sub-object keys.
+- Keys whose values are not objects are treated as CSS property names; their values become property values. The concatenation of parent keys produces a selector.
+- For every key, the substring starting with the splitter (default: `$$`) to the end is ignored (e.g. `src$$1` → `src`, `@font-face$$1` → `@font-face`).
+- In property keys, uppercase letters are converted to lowercase and prefixed with `-` (e.g. `fontFamily` → `font-family`); underscores are converted to `-` (e.g. `font_family` → `font-family`).
+- Commas inside selector keys cause them to expand into multiple selectors (e.g. `{div:{margin:1,'.a,.b,.c':{margin:2}}}` → `div{margin:1}div.a,div.b,div.c{margin:2}`).
+- Top-level keys beginning with `@` (at-rules) are not concatenated with parent keys.
 
 #### Usage Examples
 
@@ -313,10 +313,10 @@ expect(actual).to.deep.equal(expected)
 ### csv_parse
 
 ```ts
-const csv_parse: (csv: string, separator?: string) => Record<PropertyKey, string>[];
+const csv_parse: (csv: string, separator?: string) => string[][];
 ```
 
-A tiny helper for parsing CSV.
+A tiny CSV parsing helper.
 
 #### Usage Examples
 
@@ -329,38 +329,7 @@ yyy",zzz
  42 , "42" , 17
 
 `
-
-expect(csv_parse(text)).to.deep.equal([{
-  'aaa\n"aaa"\naaa': 'xxx,xxx',
-  bbb: 'yyy\nyyy',
-  'ccc,ccc': 'zzz'
-}, {
-  'aaa\n"aaa"\naaa': ' 42 ',
-  bbb: '42',
-  'ccc,ccc': ' 17'
-}])
-```
-
-### csv_parse_raw
-
-```ts
-const csv_parse_raw: (csv: string, separator?: string) => string[][];
-```
-
-A tiny helper for parsing CSV.
-
-#### Usage Examples
-
-```ts
-const text = `"aaa
-""aaa""
-aaa",bbb, "ccc,ccc"
-"xxx,xxx", "yyy
-yyy",zzz
- 42 , "42" , 17
-
-`
-expect(csv_parse_raw(text)).to.deep.equal([
+expect(csv_parse(text)).to.deep.equal([
   ['aaa\n"aaa"\naaa', 'bbb', 'ccc,ccc'],
   ['xxx,xxx', 'yyy\nyyy', 'zzz'],
   [' 42 ', '42', ' 17']
@@ -373,7 +342,7 @@ expect(csv_parse_raw(text)).to.deep.equal([
 const escape: (escape_map: Escape_Map, template: TemplateStringsArray, ...values: unknown[]) => string;
 ```
 
-A generic helper for escaping `values` by given `escape_map` (in *TemplateStrings* flavor).
+Escapes interpolated template `values` using the provided `escape_map`.
 
 #### Usage Examples
 
@@ -408,7 +377,7 @@ expect(actual).to.deep.equal(expected)
 const escape_values: (escape_map: Escape_Map, values: unknown[]) => string[];
 ```
 
-A generic helper for escaping `values` by given `escape_map`.
+Escapes array `values` using the provided `escape_map`.
 
 ### fix_typography
 
@@ -416,7 +385,7 @@ A generic helper for escaping `values` by given `escape_map`.
 const fix_typography: (node: Node) => void;
 ```
 
-A helper that implements typographic corrections specific to Polish typography.
+Applies Polish‑specific typographic corrections.
 
 #### Usage Examples
 
@@ -442,13 +411,16 @@ const h: {
 
 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.
-- The first argument of type `Node` specifies the element to be modified.
-- All other arguments of type `Record<PropertyKey, unknown>` are mappings of attributes and properties. Keys starting with `$` specify *properties* (without the leading `$`) to be set on the element being created or modified. (Note that `$` is not a valid attribute name character.) All other keys specify *attributes* to be set by `setAttribute`. An attribute equal to `false` causes the attribute to be removed by `removeAttribute`.
-- All other arguments of type `null` or `undefined` are simply ignored.
-- All other arguments of type `Node` are appended to the element being created or modified.
-- 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.
+- If the first argument is a `string`, it is treated as the tag name to create.
+- If the first argument is a `Node`, that node is modified.
+- Object arguments map attributes/properties:
+  - Keys starting with `$` set element properties (without `$`).
+  - Other keys set attributes via `setAttribute`.
+  - Attributes with value `false` are removed via `removeAttribute`.
+- `null` / `undefined` are ignored.
+- `Node` arguments are appended.
+- `string` / `number` arguments become `Text` nodes.
+- `H_Args` arrays are processed recursively.
 
 #### Usage Examples
 
@@ -524,7 +496,7 @@ expect(div.key).to.deep.equal({ one: 1, two: 2 })
 const has_own: (ref: unknown, key: unknown) => boolean;
 ```
 
-A replacement for the `in` operator (not to be confused with the `for-in` loop) that works properly.
+A replacement to the `in` operator (not to be confused with `for-in`).
 
 #### Usage Examples
 
@@ -563,33 +535,46 @@ expect(has_own(undefined, 'key')).to.be.false
 
 ```ts
 const is_array: (arg: any) => arg is any[];
+declare const FINITE_NUMBER: unique symbol;
+type Finite_Number = number & {
+    readonly [FINITE_NUMBER]: true;
+};
+```
+
+Checks whether the argument is an array.
+
+### is_finite_number
+
+```ts
+const is_finite_number: ((arg: unknown) => arg is Finite_Number);
 ```
 
-A helper that checks if the given argument is of type `any[]`.
+Checks whether the argument is a finite number (excluding `±Infinity` and `NaN`).
 
 ### is_number
 
 ```ts
-const is_number: (arg: any) => arg is number;
+const is_number: (arg: unknown) => arg is number;
 ```
 
-A helper that checks if the given argument is of type `number`.
+Checks whether the argument is a number.
 
 ### is_record
 
 ```ts
-const is_record: (arg: any) => arg is Record<PropertyKey, unknown>;
+const is_record: (arg: unknown) => arg is Record<PropertyKey, unknown>;
 ```
 
-A helper that checks if the given argument is of type `Record<PropertyKey, unknown>`.
+Checks whether the argument is a plain object record.
 
 ### is_string
 
 ```ts
-const is_string: (arg: any) => arg is string;
+const is_string: (arg: unknown) => arg is string;
+export {};
 ```
 
-A helper that checks if the given argument is of type `string`.
+Checks whether the argument is a string.
 
 ### js_on_parse
 
@@ -599,13 +584,13 @@ const js_on_parse: (handlers: Record<PropertyKey, Function>, text: string) => an
 
 `JSON.parse` with “JavaScript turned on”.
 
-Objects having *exactly* one property which is present in the `handlers` map, i.e. objects of the form:
+Objects having *exactly* one property whose name exists in `handlers`, i.e.:
 
 ```js
 { "«handler_name»": [«params»] }
 ```
 
-are replaced by the result of call
+are replaced with:
 
 ```js
 handlers['«handler_name»'](...«params»)
@@ -664,7 +649,7 @@ expect(actual).to.deep.equal(expected)
 const nanolight: (pattern: RegExp, highlighters: ((chunk: string, index: number) => H_Args_1)[], code: string) => H_Args_1[];
 ```
 
-A generic helper for syntax highlighting (see also `nanolight_js`).
+Generic syntax highlighting helper (see also `nanolight_js`).
 
 ### nanolight_js
 
@@ -672,7 +657,7 @@ A generic helper for syntax highlighting (see also `nanolight_js`).
 const nanolight_js: (code: string) => H_Args_1[];
 ```
 
-A helper for highlighting JavaScript (see also `nanolight`).
+JavaScript syntax highlighting helper (built on `nanolight`).
 
 #### Usage Examples
 
@@ -696,7 +681,7 @@ expect(nanolight_js(code_js)).to.deep.equal([
 const omit: <T, K extends keyof T>(ref: T, keys: unknown[]) => Omit<T, K>;
 ```
 
-A helper that implements TypeScript’s `Omit` utility type (see also `pick`).
+Runtime implementation of TypeScript’s `Omit` (see also `pick`).
 
 #### Usage Examples
 
@@ -712,7 +697,7 @@ expect(omit(obj, ['c'])).to.deep.equal({ a: 42, b: '42' })
 const pick: <T, K extends keyof T>(ref: T, keys: K[]) => Pick<T, K>;
 ```
 
-A helper that implements TypeScript’s `Pick` utility type (see also `omit`).
+Runtime implementation of TypeScript’s `Pick` (see also `omit`).
 
 #### Usage Examples
 
@@ -728,7 +713,7 @@ expect(pick(obj, ['a', 'b'])).to.deep.equal({ a: 42, b: '42' })
 const pl_ural: (singular: string, plural_2: string, plural_5: string, value: number) => string;
 ```
 
-A helper for choosing the correct singular and plural.
+Chooses the appropriate Polish noun form based on a numeric value.
 
 #### Usage Examples
 
@@ -754,7 +739,7 @@ expect(car(42)).to.deep.equal('cars')
 const pro: (ref: unknown) => any;
 ```
 
-A helper that protects calls to nested properties by a `Proxy` that initializes non-existent values with an empty object.
+A `Proxy`-based helper that safely creates nested structures on access and allows deep assignment without guards.
 
 #### Usage Examples
 
@@ -798,13 +783,16 @@ const s: {
 
 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.
-- The first argument of type `Node` specifies the element to be modified.
-- All other arguments of type `Record<PropertyKey, unknown>` are mappings of attributes and properties. Keys starting with `$` specify *properties* (without the leading `$`) to be set on the element being created or modified. (Note that `$` is not a valid attribute name character.) All other keys specify *attributes* to be set by `setAttributeNS`. An attribute equal to `false` causes the attribute to be removed by `removeAttributeNS`.
-- All other arguments of type `null` or `undefined` are simply ignored.
-- All other arguments of type `Node` are appended to the element being created or modified.
-- 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.
+- If the first argument is a `string`, it is treated as the tag name to create.
+- If the first argument is a `Node`, that node is modified.
+- Object arguments map attributes/properties:
+  - Keys starting with `$` set element properties (without `$`).
+  - Other keys set attributes via `setAttributeNS`.
+  - Attributes with value `false` are removed via `removeAttributeNS`.
+- `null` / `undefined` are ignored.
+- `Node` arguments are appended.
+- `string` / `number` arguments become `Text` nodes.
+- `H_Args` arrays are processed recursively.
 
 ### svg_use
 
@@ -812,7 +800,7 @@ A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style help
 const svg_use: (id: string, ...args: H_Args_1[]) => SVGSVGElement;
 ```
 
-A convenient shortcut for `s('svg', ['use', { 'xlink:href': '#' + id }], ...args)`.
+Shorthand for: `s('svg', ['use', { 'xlink:href': '#' + id }], ...args)`.
 
 ### uuid_v1
 
@@ -820,9 +808,9 @@ A convenient shortcut for `s('svg', ['use', { 'xlink:href': '#' + id }], ...args
 const uuid_v1: (date?: Date, node?: string) => string;
 ```
 
-A helper that generates a UUID v1 identifier (with a creation timestamp).
+Generates a UUID v1 (time-based) identifier.
 
-- The optional `node` parameter should have the format `/^[0123456789abcdef]+$/`. Its value will be trimmed to last 12 characters and left padded with zeros.
+- Optional `node` must match `/^[0-9a-f]*$/`; it is trimmed to the last 12 characters and left-padded with zeros.
 
 ## License