@jackens/nnn 2026.2.11 → 2026.2.18

package/nnn.d.ts

@@ -35,33 +35,6 @@ export type CRoot = Record<PropertyKey, CNode>;
  * - Top-level keys starting with `@` (at-rules) are not concatenated with child selectors.
  */
 export declare const c: (root: CRoot, splitter?: string) => string;
-/**
- * A responsive web design helper that generates CSS rules for a grid-like layout.
- *
- * @param root
- *
- * The CSS root object to populate (see {@link c}).
- *
- * @param selector
- *
- * The CSS selector for the grid item.
- *
- * @param cell_width_px
- *
- * The base cell width in pixels.
- *
- * @param cell_height_px
- *
- * The base cell height in pixels.
- *
- * @param specs
- *
- * An array of breakpoint specifications, each a tuple of:
- * - `max_width`: maximum number of cells per row (defines the viewport breakpoint).
- * - `width` (optional, default `1`): number of horizontal cells the element spans.
- * - `height` (optional, default `1`): number of vertical cells the element spans.
- */
-export declare const rwd: (root: CRoot, selector: string, cell_width_px: number, cell_height_px: number, ...specs: [number, number?, number?][]) => void;
 /**
  * Parses a CSV string into a two-dimensional array of strings.
  *
@@ -80,40 +53,6 @@ export declare const rwd: (root: CRoot, selector: string, cell_width_px: number,
  * A 2D array where each inner array represents a row of fields.
  */
 export declare const csv_parse: (csv: string, separator?: string) => string[][];
-/**
- * A map from value constructors (or `null`/`undefined`) to escape functions.
- *
- * Used by {@link escape_values} and {@link new_escape}.
- */
-export type EscapeMap = Map<unknown, (value?: unknown) => string>;
-/**
- * Escapes an array of values using the provided escape map.
- *
- * @param escape_map
- *
- * A map where keys are constructors (e.g., `String`, `Number`) and values are escape functions.
- *
- * @param values
- *
- * The array of values to escape.
- *
- * @returns
- *
- * An array of escaped strings.
- */
-export declare const escape_values: (escape_map: EscapeMap, values: unknown[]) => string[];
-/**
- * Creates a tag function for escaping interpolated values in template literals.
- *
- * @param escape_map
- *
- * A map where keys are constructors and values are escape functions.
- *
- * @returns
- *
- * A tag function that escapes interpolated values using the provided escape map.
- */
-export declare const new_escape: (escape_map: EscapeMap) => (template: TemplateStringsArray, ...values: unknown[]) => string;
 /**
  * Applies Polish-specific typographic corrections to a DOM subtree.
  *
@@ -136,8 +75,7 @@ export type HArgs1 = Record<PropertyKey, unknown> | null | undefined | Node | st
  */
 export type HArgs = [string | Node, ...HArgs1[]];
 /**
- * A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper
- * for creating and modifying `HTMLElement`s (see also {@link s}).
+ * A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `HTMLElement`s (see also {@link s}).
  *
  * @param tag_or_node
  *
@@ -164,8 +102,7 @@ export declare const h: {
     (tag_or_node: string | Node, ...args1: HArgs1[]): Node;
 };
 /**
- * A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper
- * for creating and modifying `SVGElement`s (see also {@link h}).
+ * A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `SVGElement`s (see also {@link h}).
  *
  * @param tag_or_node
  *
@@ -191,24 +128,6 @@ export declare const s: {
     <N extends Node>(node: N, ...args1: HArgs1[]): N;
     (tag_or_node: string | Node, ...args1: HArgs1[]): Node;
 };
-/**
- * Shorthand for creating an SVG element with a `<use>` child referencing an icon by ID.
- *
- * Equivalent to: `s('svg', ['use', { 'xlink:href': '#' + id }], ...args)`.
- *
- * @param id
- *
- * The ID of the symbol to reference (without the `#` prefix).
- *
- * @param args
- *
- * Additional arguments passed to the outer `<svg>` element.
- *
- * @returns
- *
- * An `SVGSVGElement` containing a `<use>` element.
- */
-export declare const svg_use: (id: string, ...args: HArgs1[]) => SVGSVGElement;
 /**
  * Checks whether an object has the specified key as its own property.
  *
@@ -306,11 +225,61 @@ export declare const is_string: (arg: unknown) => arg is string;
  * The parsed value with handler substitutions applied.
  */
 export declare const js_on_parse: (handlers: Record<PropertyKey, Function>, text: string) => any;
+/**
+ * A Monokai-inspired color scheme for use with the {@link c} helper and {@link nanolight_ts} tokenizer.
+ */
+export declare const monokai: CRoot;
+/**
+ * A TypeScript/JavaScript syntax highlighting tokenizer built using {@link new_tokenizer}.
+ *
+ * @param code
+ *
+ * The source code string to tokenize.
+ *
+ * @returns
+ *
+ * An array of {@link HArgs1} elements suitable for rendering with {@link h}.
+ */
+export declare const nanolight_ts: (code: string) => HArgs1[];
+/**
+ * A map from value constructors (or `null`/`undefined`) to escape functions.
+ *
+ * Used by {@link escape_values} and {@link new_escape}.
+ */
+export type EscapeMap = Map<unknown, (value?: unknown) => string>;
+/**
+ * Escapes an array of values using the provided escape map.
+ *
+ * @param escape_map
+ *
+ * A map where keys are constructors (e.g., `String`, `Number`) and values are escape functions.
+ *
+ * @param values
+ *
+ * The array of values to escape.
+ *
+ * @returns
+ *
+ * An array of escaped strings.
+ */
+export declare const escape_values: (escape_map: EscapeMap, values: unknown[]) => string[];
+/**
+ * Creates a tag function for escaping interpolated values in template literals.
+ *
+ * @param escape_map
+ *
+ * A map where keys are constructors and values are escape functions.
+ *
+ * @returns
+ *
+ * A tag function that escapes interpolated values using the provided escape map.
+ */
+export declare const new_escape: (escape_map: EscapeMap) => (template: TemplateStringsArray, ...values: unknown[]) => string;
 /**
  * Creates a function that returns the appropriate noun form based on a numeric value using `Intl.PluralRules`.
  *
- * Different languages have different plural rules. The `Intl.PluralRules` API provides
- * locale-aware plural category selection. Possible categories are:
+ * Different languages have different plural rules. The `Intl.PluralRules` API provides locale-aware plural category selection.
+ * Possible categories are:
  *
  * - `zero`: for zero items (used in some languages like Arabic, Latvian)
  * - `one`: for singular (e.g., 1 item)
@@ -334,23 +303,31 @@ export declare const js_on_parse: (handlers: Record<PropertyKey, Function>, text
  */
 export declare const new_noun_form: (locale: string, forms: Partial<Record<Intl.LDMLPluralRule, string>>) => (value: number) => string;
 /**
- * Creates a new object containing only the specified keys from the source object.
- *
- * A runtime equivalent of TypeScript’s `Pick<T, K>` utility type. See also {@link omit}.
+ * A helper for building simple tokenizers (see also {@link nanolight_ts}).
  *
- * @param ref
+ * @param decorator
  *
- * The source object.
+ * A function that wraps each matched chunk. It receives the matched text (`chunk`)
+ * and optionally the `metadata` associated with the pattern that produced the match.
+ * For unmatched text between patterns, `metadata` is `undefined`.
  *
- * @param keys
+ * @param specs
  *
- * An array of keys to include in the result.
+ * An array of tuples `[metadata, pattern]` where:
+ * - `metadata`: arbitrary data (e.g., a CSS class name) passed to `decorator` when the pattern matches.
+ * - `pattern`: a `string` or `RegExp` to match against the input.
  *
  * @returns
  *
- * A new object with only the specified keys.
+ * A tokenizer function that accepts a code string and returns an array of decorated tokens.
+ *
+ * @remarks
+ *
+ * 1. Matches starting at an earlier position take precedence.
+ * 2. Among matches at the same position, the longer one wins.
+ * 3. Among matches of the same position and length, the one defined earlier wins.
  */
-export declare const pick: <T, K extends keyof T>(ref: T, keys: K[]) => Pick<T, K>;
+export declare const new_tokenizer: <M, T>(decorator: (chunk: string, metadata?: M) => T, ...specs: [M, string | RegExp][]) => (code: string) => T[];
 /**
  * Creates a new object excluding the specified keys from the source object.
  *
@@ -370,56 +347,68 @@ export declare const pick: <T, K extends keyof T>(ref: T, keys: K[]) => Pick<T,
  */
 export declare const omit: <T, K extends keyof T>(ref: T, keys: unknown[]) => Omit<T, K>;
 /**
- * A helper for building simple tokenizers (see also {@link nanolight_ts}).
- *
- * @param decorator
+ * Creates a new object containing only the specified keys from the source object.
  *
- * A function that wraps each matched chunk. It receives the matched text (`chunk`)
- * and optionally the `metadata` associated with the pattern that produced the match.
- * For unmatched text between patterns, `metadata` is `undefined`.
+ * A runtime equivalent of TypeScript’s `Pick<T, K>` utility type. See also {@link omit}.
  *
- * @param specs
+ * @param ref
  *
- * An array of tuples `[metadata, pattern]` where:
- * - `metadata`: arbitrary data (e.g., a CSS class name) passed to `decorator` when the pattern matches.
- * - `pattern`: a `string` or `RegExp` to match against the input.
+ * The source object.
  *
- * @returns
+ * @param keys
  *
- * A tokenizer function that accepts a code string and returns an array of decorated tokens.
+ * An array of keys to include in the result.
  *
- * @remarks
+ * @returns
  *
- * 1. Matches starting at an earlier position take precedence.
- * 2. Among matches at the same position, the longer one wins.
- * 3. Among matches of the same position and length, the one defined earlier wins.
+ * A new object with only the specified keys.
  */
-export declare const new_tokenizer: <M, T>(decorator: (chunk: string, metadata?: M) => T, ...specs: [M, string | RegExp][]) => (code: string) => T[];
+export declare const pick: <T, K extends keyof T>(ref: T, keys: K[]) => Pick<T, K>;
 /**
- * A TypeScript/JavaScript syntax highlighting tokenizer built using {@link new_tokenizer}.
+ * A responsive web design helper that generates CSS rules for a grid-like layout.
  *
- * @param code
+ * @param root
  *
- * The source code string to tokenize.
+ * The CSS root object to populate (see {@link c}).
  *
- * @returns
+ * @param selector
  *
- * An array of {@link HArgs1} elements suitable for rendering with {@link h}.
+ * The CSS selector for the grid item.
+ *
+ * @param cell_width_px
+ *
+ * The base cell width in pixels.
+ *
+ * @param cell_height_px
+ *
+ * The base cell height in pixels.
+ *
+ * @param specs
+ *
+ * An array of breakpoint specifications, each a tuple of:
+ * - `max_width`: maximum number of cells per row (defines the viewport breakpoint).
+ * - `width` (optional, default `1`): number of horizontal cells the element spans.
+ * - `height` (optional, default `1`): number of vertical cells the element spans.
  */
-export declare const nanolight_ts: (code: string) => HArgs1[];
+export declare const rwd: (root: CRoot, selector: string, cell_width_px: number, cell_height_px: number, ...specs: [number, number?, number?][]) => void;
 /**
- * A Monokai-inspired color scheme for use with the {@link c} helper and {@link nanolight_ts} tokenizer.
+ * Shorthand for creating an SVG element with a `<use>` child referencing an icon by ID.
  *
- * Defines CSS custom properties for eight colors (`--black`, `--blue`, `--green`, `--grey`,
- * `--purple`, `--red`, `--white`, `--yellow`) with both light and dark mode variants.
+ * Equivalent to: `s('svg', ['use', { 'xlink:href': '#' + id }], ...args)`.
  *
- * @remarks
+ * @param id
+ *
+ * The ID of the symbol to reference (without the `#` prefix).
+ *
+ * @param args
  *
- * - In light mode, `--black` is a light background and `--white` is dark text.
- * - In dark mode (via `prefers-color-scheme: dark`), the palette inverts to a dark background with light text.
- * - Includes base styles for `body`, `pre` and `code>span.*` (syntax highlighting).
+ * Additional arguments passed to the outer `<svg>` element.
+ *
+ * @returns
+ *
+ * An `SVGSVGElement` containing a `<use>` element.
  */
-export declare const monokai: CRoot;
+export declare const svg_use: (id: string, ...args: HArgs1[]) => SVGSVGElement;
 /**
  * Generates a UUID v1 (time-based) identifier.
  *
@@ -446,14 +435,14 @@ export declare const uuid_v1: (date?: Date, node?: string) => string;
  * Intermediates of the last level in a get-only property chain are NOT auto-created.
  * For example, `vivify(ref).one.two` will create `ref.one` as `{}`, but will NOT create `ref.one.two`.
  * Only when a deeper access, assignment, or deletion occurs
- * (e.g. `vivify(ref).one.two[3]` or `vivify(ref).one.two.three = 42`) will `ref.one.two` be materialized.
+ * (e.g. `delete vivify(ref).one.two.three` or `vivify(ref).one.two.three = 4`) will `ref.one.two` be materialized.
  *
  * When traversal reaches a primitive value, no auto-creation happens;
  * the primitive’s own property is returned instead
  * (e.g. accessing `.toString.name` on a number yields `'toString'` without modifying the underlying structure).
  *
  * Deletion on a non-existing intermediate path will auto-create intermediates up to the parent of the deleted key
- * (e.g. `delete vivify(ref).a.b.c` will create `ref.a.b` as `{}` if it does not exist).
+ * (e.g. `delete vivify(ref).one.two.three` will create `ref.one.two` as `{}` if it does not exist).
  *
  * @param ref
  *

package/nnn.js

@@ -1,41 +1,11 @@
-// src/nnn/is.ts
+// src/nnn/is_array.ts
 var is_array = Array.isArray;
-var is_finite_number = Number.isFinite;
+
+// src/nnn/is_number.ts
 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";
 
-// src/nnn/vivify.ts
-var ARRAY_INDEX_REGEXP = /^(0|[1-9]\d*)$/;
-var get_target = (parent, parent_key, child_key) => {
-  if (parent_key == null) {
-    return parent;
-  }
-  if (!(parent_key in parent)) {
-    parent[parent_key] = is_string(child_key) && ARRAY_INDEX_REGEXP.test(child_key) ? [] : {};
-  }
-  return parent[parent_key];
-};
-var _vivify = (parent, parent_key) => new Proxy({}, {
-  get(_, key) {
-    const target = get_target(parent, parent_key, key);
-    if (target != null && typeof target === "object") {
-      return _vivify(target, key);
-    }
-    return target?.[key];
-  },
-  set(_, key, value) {
-    const target = get_target(parent, parent_key, key);
-    target[key] = value;
-    return true;
-  },
-  deleteProperty(_, key) {
-    const target = get_target(parent, parent_key, key);
-    delete target[key];
-    return true;
-  }
-});
-var vivify = (ref) => _vivify(ref);
+// src/nnn/is_string.ts
+var is_string = (arg) => typeof arg === "string";
 
 // src/nnn/c.ts
 var _c = (node, prefix, result, splitter) => {
@@ -89,37 +59,15 @@ var c = (root, splitter = "$$") => {
   }
   return chunks.join("");
 };
-var rwd = (root, selector, cell_width_px, cell_height_px, ...specs) => {
-  const main = vivify(root)[selector];
-  main.boxSizing = "border-box";
-  main.display = "block";
-  main.float = "left";
-  main.width = "100%";
-  main.height = `${cell_height_px}px`;
-  specs.sort(([a], [b]) => a - b);
-  for (let [max_width, width, height] of specs) {
-    const node = max_width === 1 ? main : vivify(root)[`@media(min-width:${cell_width_px * max_width}px)`][selector];
-    width ??= 1;
-    height ??= 1;
-    let gcd = 100 * width;
-    let tmp = max_width;
-    while (tmp > 0) {
-      [gcd, tmp] = [tmp, gcd % tmp];
-    }
-    const w_100_per_gcd = 100 * width / gcd;
-    node.width = max_width === gcd ? `${w_100_per_gcd}%` : `calc(${w_100_per_gcd}% / ${max_width / gcd})`;
-    node.height = `${cell_height_px * height}px`;
-  }
-};
 // src/nnn/csv_parse.ts
+var MAIN_PATTERN = /\n|(?<!")("(?:[^"]|"")*")(?!")/g;
 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"));
+  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"));
 };
-// src/nnn/escape.ts
-var escape_values = (escape_map, values) => values.map((value) => (value == null ? escape_map.get(value) : escape_map.get(value?.constructor))?.(value) ?? "");
-var new_escape = (escape_map) => (template, ...values) => String.raw(template, ...escape_values(escape_map, values));
+// src/nnn/is_record.ts
+var is_record = (arg) => typeof arg === "object" && arg != null && !is_array(arg);
+
 // src/nnn/h.ts
 var _h = (namespace_uri) => {
   const create_element = namespace_uri == null ? (tag) => document.createElement(tag) : (tag) => document.createElementNS(namespace_uri, tag);
@@ -181,7 +129,6 @@ var _h = (namespace_uri) => {
 };
 var h = /* @__PURE__ */ _h();
 var s = /* @__PURE__ */ _h("http://www.w3.org/2000/svg");
-var svg_use = (id, ...args) => s("svg", ["use", { "xlink:href": "#" + id }], ...args);
 
 // src/nnn/fix_pl_typography.ts
 var TAGS_TO_SKIP = ["IFRAME", "NOSCRIPT", "PRE", "SCRIPT", "STYLE", "TEXTAREA"];
@@ -216,6 +163,8 @@ var fix_pl_typography = (node) => {
 };
 // src/nnn/has_own.ts
 var has_own = (ref, key) => ref != null && Object.hasOwn(ref, key);
+// src/nnn/is_finite_number.ts
+var is_finite_number = Number.isFinite;
 // src/nnn/js_on_parse.ts
 var js_on_parse = (handlers, text) => JSON.parse(text, (key, value) => {
   if (is_record(value)) {
@@ -234,13 +183,72 @@ var js_on_parse = (handlers, text) => JSON.parse(text, (key, value) => {
   }
   return value;
 });
-// src/nnn/new_noun_form.ts
-var PLURAL_RULES = {};
-var new_noun_form = (locale, forms) => (value) => forms[(PLURAL_RULES[locale] ??= new Intl.PluralRules(locale)).select(value)] ?? forms.other ?? "";
-// src/nnn/omit_pick.ts
-var pick = (ref, keys) => Object.fromEntries(Object.entries(ref).filter(([key]) => keys.includes(key)));
-var omit = (ref, keys) => Object.fromEntries(Object.entries(ref).filter(([key]) => !keys.includes(key)));
-// src/nnn/tokenizer.ts
+// src/nnn/monokai.ts
+var monokai = {
+  ":root": {
+    __bg: "#faf4f2",
+    __fg: "#29242a",
+    __comment: "#918c8e",
+    __identifier_1: "#7058be",
+    __identifier_2: "#269d69",
+    __identifier_3: "#1c8ca8",
+    __identifier_4: "#29242a",
+    __keyword_1: "#e14775",
+    __keyword_2: "#7058be",
+    __keyword_3: "#1c8ca8",
+    __number: "#7058be",
+    __operator: "#e14775",
+    __punctuation: "#918c8e",
+    __string: "#cc7a0a"
+  },
+  body$$monokai: {
+    backgroundColor: "var(--bg)",
+    color: "var(--fg)"
+  },
+  "code>span.": {
+    bg: { color: "var(--bg)" },
+    fg: { color: "var(--fg)" },
+    comment: { color: "var(--comment)" },
+    "identifier-1": { color: "var(--identifier-1)" },
+    "identifier-2": { color: "var(--identifier-2)" },
+    "identifier-3": { color: "var(--identifier-3)" },
+    "identifier-4": { color: "var(--identifier-4)" },
+    "keyword-1": { color: "var(--keyword-1)" },
+    "keyword-2": { color: "var(--keyword-2)" },
+    "keyword-3": { color: "var(--keyword-3)" },
+    number: { color: "var(--number)" },
+    operator: { color: "var(--operator)" },
+    punctuation: { color: "var(--punctuation)" },
+    string: { color: "var(--string)" }
+  },
+  pre: {
+    margin: 0,
+    overflow: "visible",
+    " code": {
+      fontFamily: '"Source Code Pro"',
+      padding: 0
+    }
+  },
+  "@media only screen and (prefers-color-scheme: dark)": {
+    ":root": {
+      __bg: "#2d2a2e",
+      __fg: "#fcfcfa",
+      __comment: "#727072",
+      __identifier_1: "#ae81ff",
+      __identifier_2: "#a9dc76",
+      __identifier_3: "#66d9ef",
+      __identifier_4: "#fcfcfa",
+      __keyword_1: "#ff6188",
+      __keyword_2: "#ae81ff",
+      __keyword_3: "#66d9ef",
+      __number: "#ae81ff",
+      __operator: "#ff6188",
+      __punctuation: "#727072",
+      __string: "#ffd866"
+    }
+  }
+};
+// src/nnn/new_tokenizer.ts
 var new_tokenizer = (decorator, ...specs) => (code) => {
   const result = [];
   while (code.length > 0) {
@@ -278,60 +286,80 @@ var new_tokenizer = (decorator, ...specs) => (code) => {
   }
   return result;
 };
-var BLUE = "blue";
-var GREEN = "green";
-var GREY = "grey";
-var PURPLE = "purple";
-var RED = "red";
-var WHITE = "white";
-var YELLOW = "yellow";
-var nanolight_ts = /* @__PURE__ */ new_tokenizer((chunk, name) => name != null ? ["span", { class: name }, chunk] : chunk, [YELLOW, /".*?"/], [YELLOW, /'.*?'/], [YELLOW, /`[\s\S]*?`/], [RED, "?"], [RED, /(?<=\s):/], [GREY, "("], [GREY, ")"], [GREY, ","], [GREY, "."], [GREY, ":"], [GREY, ";"], [GREY, "?."], [GREY, "["], [GREY, "]"], [GREY, "{"], [GREY, "}"], [GREY, /\/\*[\s\S]*?\*\//], [GREY, /(?<!\\)\/\/.*?(?=\n)/], [RED, "!"], [RED, "!="], [RED, "!=="], [RED, "%"], [RED, "%="], [RED, "&&"], [RED, "&&="], [RED, "&"], [RED, "&="], [RED, "*"], [RED, "**"], [RED, "**="], [RED, "*="], [RED, "+"], [RED, "++"], [RED, "+="], [RED, "-"], [RED, "--"], [RED, "-="], [RED, "..."], [RED, "/"], [RED, "/="], [RED, ":"], [RED, "<"], [RED, "<<"], [RED, "<<="], [RED, "<="], [RED, "="], [RED, "=="], [RED, "==="], [RED, "=>"], [RED, ">"], [RED, ">="], [RED, ">>"], [RED, ">>="], [RED, ">>>"], [RED, ">>>="], [RED, "?"], [RED, "??"], [RED, "??="], [RED, "^"], [RED, "^="], [RED, "as"], [RED, "async"], [RED, "await"], [RED, "break"], [RED, "case"], [RED, "catch"], [RED, "class"], [RED, "const"], [RED, "continue"], [RED, "debugger"], [RED, "default"], [RED, "delete"], [RED, "do"], [RED, "else"], [RED, "export"], [RED, "extends"], [RED, "finally"], [RED, "for"], [RED, "from"], [RED, "function"], [RED, "function*"], [RED, "goto"], [RED, "if"], [RED, "import"], [RED, "in"], [RED, "instanceof"], [RED, "is"], [RED, "keyof"], [RED, "let"], [RED, "new"], [RED, "of"], [RED, "package"], [RED, "return"], [RED, "super"], [RED, "switch"], [RED, "this"], [RED, "throw"], [RED, "try"], [RED, "type"], [RED, "typeof"], [RED, "var"], [RED, "void"], [RED, "while"], [RED, "with"], [RED, "yield"], [RED, "yield*"], [RED, "|"], [RED, "|="], [RED, "||"], [RED, "||="], [RED, "~"], [RED, "~="], [PURPLE, "false"], [PURPLE, "Infinity"], [PURPLE, "NaN"], [PURPLE, "null"], [PURPLE, "true"], [PURPLE, "undefined"], [PURPLE, /0b[01_]+/], [PURPLE, /0o[01234567_]+/], [PURPLE, /0x[\dabcdef_]+/], [PURPLE, /[\p{Lu}_$][\p{Lu}\d_$]+/u], [PURPLE, /\d[\d_]*(\.[\d_]+)?(e[+-]?[\d_]+)?/], [BLUE, "any"], [BLUE, "bigint"], [BLUE, "boolean"], [BLUE, "eval"], [BLUE, "number"], [BLUE, "string"], [BLUE, "symbol"], [BLUE, "unknown"], [GREEN, /[\p{L}_$][\p{L}\d_$]+(?=\()/u], [BLUE, /\p{Lu}[\p{L}\d_$]+/u], [WHITE, /[\p{L}_$][\p{L}\d_$]+/u]);
-var monokai = {
-  ":root": {
-    __black: "$faf4f2",
-    __blue: "#1c8ca8",
-    __green: "#269d69",
-    __grey: "#918c8e",
-    __purple: "#7058be",
-    __red: "#e14775",
-    __white: "#29242a",
-    __yellow: "#cc7a0a"
-  },
-  body$$monokai: {
-    backgroundColor: "var(--black)",
-    color: "var(--white)"
-  },
-  "code>span.": {
-    black: { color: "var(--black)" },
-    blue: { color: "var(--blue)" },
-    green: { color: "var(--green)" },
-    grey: { color: "var(--grey)" },
-    purple: { color: "var(--purple)" },
-    red: { color: "var(--red)" },
-    white: { color: "var(--white)" },
-    yellow: { color: "var(--yellow)" }
-  },
-  pre: {
-    margin: 0,
-    overflow: "visible",
-    " code": {
-      fontFamily: '"Source Code Pro"',
-      padding: 0
+
+// src/nnn/nanolight_ts.ts
+var COMMENT = "comment";
+var IDENTIFIER_1 = "identifier-1";
+var IDENTIFIER_2 = "identifier-2";
+var IDENTIFIER_3 = "identifier-3";
+var IDENTIFIER_4 = "identifier-4";
+var KEYWORD_1 = "keyword-1";
+var KEYWORD_2 = "keyword-2";
+var KEYWORD_3 = "keyword-3";
+var NUMBER = "number";
+var OPERATOR = "operator";
+var PUNCTUATION = "punctuation";
+var STRING = "string";
+var nanolight_ts = /* @__PURE__ */ new_tokenizer((chunk, name) => name != null ? ["span", { class: name }, chunk] : chunk, [STRING, /".*?"/], [STRING, /'.*?'/], [STRING, /`[\s\S]*?`/], [COMMENT, /\/\*[\s\S]*?\*\//], [COMMENT, /(?<!\\)\/\/.*?(?=\n)/], [NUMBER, /0b[01_]+/], [NUMBER, /0o[01234567_]+/], [NUMBER, /0x[\dabcdef_]+/], [NUMBER, /\d[\d_]*(\.[\d_]+)?(e[+-]?[\d_]+)?/], [OPERATOR, "!"], [OPERATOR, "!="], [OPERATOR, "!=="], [OPERATOR, "%"], [OPERATOR, "%="], [OPERATOR, "&&"], [OPERATOR, "&&="], [OPERATOR, "&"], [OPERATOR, "&="], [OPERATOR, "*"], [OPERATOR, "**"], [OPERATOR, "**="], [OPERATOR, "*="], [OPERATOR, "+"], [OPERATOR, "++"], [OPERATOR, "+="], [OPERATOR, "-"], [OPERATOR, "--"], [OPERATOR, "-="], [OPERATOR, "..."], [OPERATOR, "/"], [OPERATOR, "/="], [OPERATOR, ":"], [OPERATOR, "<"], [OPERATOR, "<<"], [OPERATOR, "<<="], [OPERATOR, "<="], [OPERATOR, "="], [OPERATOR, "=="], [OPERATOR, "==="], [OPERATOR, "=>"], [OPERATOR, ">"], [OPERATOR, ">="], [OPERATOR, ">>"], [OPERATOR, ">>="], [OPERATOR, ">>>"], [OPERATOR, ">>>="], [OPERATOR, "?"], [OPERATOR, "?"], [OPERATOR, "??"], [OPERATOR, "??="], [OPERATOR, "^"], [OPERATOR, "^="], [OPERATOR, "|"], [OPERATOR, "|="], [OPERATOR, "||"], [OPERATOR, "||="], [OPERATOR, "~"], [OPERATOR, "~="], [OPERATOR, /(?<=\s):/], [PUNCTUATION, "("], [PUNCTUATION, ")"], [PUNCTUATION, ","], [PUNCTUATION, "."], [PUNCTUATION, ":"], [PUNCTUATION, ";"], [PUNCTUATION, "?."], [PUNCTUATION, "["], [PUNCTUATION, "]"], [PUNCTUATION, "{"], [PUNCTUATION, "}"], [KEYWORD_1, "as"], [KEYWORD_1, "async"], [KEYWORD_1, "await"], [KEYWORD_1, "break"], [KEYWORD_1, "case"], [KEYWORD_1, "catch"], [KEYWORD_1, "class"], [KEYWORD_1, "const"], [KEYWORD_1, "continue"], [KEYWORD_1, "debugger"], [KEYWORD_1, "default"], [KEYWORD_1, "delete"], [KEYWORD_1, "do"], [KEYWORD_1, "else"], [KEYWORD_1, "export"], [KEYWORD_1, "extends"], [KEYWORD_1, "finally"], [KEYWORD_1, "for"], [KEYWORD_1, "from"], [KEYWORD_1, "function"], [KEYWORD_1, "function*"], [KEYWORD_1, "goto"], [KEYWORD_1, "if"], [KEYWORD_1, "import"], [KEYWORD_1, "in"], [KEYWORD_1, "instanceof"], [KEYWORD_1, "is"], [KEYWORD_1, "keyof"], [KEYWORD_1, "let"], [KEYWORD_1, "new"], [KEYWORD_1, "of"], [KEYWORD_1, "package"], [KEYWORD_1, "return"], [KEYWORD_1, "super"], [KEYWORD_1, "switch"], [KEYWORD_1, "this"], [KEYWORD_1, "throw"], [KEYWORD_1, "try"], [KEYWORD_1, "type"], [KEYWORD_1, "typeof"], [KEYWORD_1, "var"], [KEYWORD_1, "void"], [KEYWORD_1, "while"], [KEYWORD_1, "with"], [KEYWORD_1, "yield"], [KEYWORD_1, "yield*"], [KEYWORD_2, "false"], [KEYWORD_2, "Infinity"], [KEYWORD_2, "NaN"], [KEYWORD_2, "null"], [KEYWORD_2, "true"], [KEYWORD_2, "undefined"], [KEYWORD_3, "any"], [KEYWORD_3, "bigint"], [KEYWORD_3, "boolean"], [KEYWORD_3, "eval"], [KEYWORD_3, "number"], [KEYWORD_3, "string"], [KEYWORD_3, "symbol"], [KEYWORD_3, "unknown"], [IDENTIFIER_1, /[\p{Lu}_$][\p{Lu}\d_$]*/u], [IDENTIFIER_2, /[\p{L}_$][\p{L}\d_$]*(?=\()/u], [IDENTIFIER_3, /\p{Lu}[\p{L}\d_$]*/u], [IDENTIFIER_4, /[\p{L}_$][\p{L}\d_$]*/u]);
+// src/nnn/new_escape.ts
+var escape_values = (escape_map, values) => values.map((value) => (value == null ? escape_map.get(value) : escape_map.get(value?.constructor))?.(value) ?? "");
+var new_escape = (escape_map) => (template, ...values) => String.raw(template, ...escape_values(escape_map, values));
+// src/nnn/new_noun_form.ts
+var PLURAL_RULES = {};
+var new_noun_form = (locale, forms) => (value) => forms[(PLURAL_RULES[locale] ??= new Intl.PluralRules(locale)).select(value)] ?? forms.other ?? "";
+// src/nnn/omit.ts
+var omit = (ref, keys) => Object.fromEntries(Object.entries(ref).filter(([key]) => !keys.includes(key)));
+// src/nnn/pick.ts
+var pick = (ref, keys) => Object.fromEntries(Object.entries(ref).filter(([key]) => keys.includes(key)));
+// src/nnn/vivify.ts
+var ARRAY_INDEX_REGEXP = /^(0|[1-9]\d*)$/;
+var is_object = (ref) => typeof ref === "object";
+var get_target = (parent, parent_key, key) => parent[parent_key] ??= is_string(key) && ARRAY_INDEX_REGEXP.test(key) ? [] : {};
+var _vivify = (parent, parent_key) => {
+  return parent != null && is_object(parent) ? new Proxy(parent, {
+    get(_, key) {
+      const target = get_target(parent, parent_key, key);
+      const value = target[key];
+      return is_string(key) && is_object(target) && (value == null || is_object(value)) ? _vivify(target, key) : value;
+    },
+    set(_, key, value) {
+      const target = get_target(parent, parent_key, key);
+      target[key] = value;
+      return true;
+    },
+    deleteProperty(_, key) {
+      const target = get_target(parent, parent_key, key);
+      return delete target[key];
     }
-  },
-  "@media only screen and (prefers-color-scheme: dark)": {
-    ":root": {
-      __black: "#2d2a2e",
-      __blue: "#66d9ef",
-      __green: "#a9dc76",
-      __grey: "#727072",
-      __purple: "#ae81ff",
-      __red: "#ff6188",
-      __white: "#fcfcfa",
-      __yellow: "#ffd866"
+  }) : parent?.[parent_key];
+};
+var vivify = (ref) => _vivify({ _: ref }, "_");
+
+// src/nnn/rwd.ts
+var rwd = (root, selector, cell_width_px, cell_height_px, ...specs) => {
+  const main = vivify(root)[selector];
+  main.boxSizing = "border-box";
+  main.display = "block";
+  main.float = "left";
+  main.width = "100%";
+  main.height = `${cell_height_px}px`;
+  specs.sort(([a], [b]) => a - b);
+  for (let [max_width, width, height] of specs) {
+    const node = max_width === 1 ? main : vivify(root)[`@media(min-width:${cell_width_px * max_width}px)`][selector];
+    width ??= 1;
+    height ??= 1;
+    let gcd = 100 * width;
+    let tmp = max_width;
+    while (tmp > 0) {
+      [gcd, tmp] = [tmp, gcd % tmp];
     }
+    const w_100_per_gcd = 100 * width / gcd;
+    node.width = max_width === gcd ? `${w_100_per_gcd}%` : `calc(${w_100_per_gcd}% / ${max_width / gcd})`;
+    node.height = `${cell_height_px * height}px`;
   }
 };
+// src/nnn/svg_use.ts
+var svg_use = (id, ...args) => s("svg", ["use", { "xlink:href": "#" + id }], ...args);
 // src/nnn/uuid_v1.ts
 var ZEROS = /* @__PURE__ */ "0".repeat(16);
 var counter = 0;

package/package.json

@@ -43,5 +43,5 @@
   "name": "@jackens/nnn",
   "type": "module",
   "types": "nnn.d.ts",
-  "version": "2026.2.11"
+  "version": "2026.2.18"
 }

package/readme.md

@@ -1,22 +1,23 @@
 # nnn
 
-A collection of Jackens’ JavaScript helper utilities.
+A collection of Jackens’ JavaScript helper utilities (version: `2026.2.18`).
 
 ## Installation
 
 ```sh
-bun i @jackens/nnn # npm i @jackens/nnn
+bun i @jackens/nnn
+```
+
+or
+
+```sh
+npm i @jackens/nnn
 ```
 
 ## Usage
 
 ```js
 import {
-  CNode,
-  CRoot,
-  EscapeMap,
-  HArgs,
-  HArgs1,
   c,
   csv_parse,
   escape_values,
@@ -41,7 +42,7 @@ import {
   svg_use,
   uuid_v1,
   vivify
-} from '@jackens/nnn' // './node_modules/@jackens/nnn/nnn.js'
+} from '@jackens/nnn' // or './node_modules/@jackens/nnn/nnn.js'
 ```
 
 ## Exports
@@ -55,8 +56,7 @@ import {
 - [`csv_parse`](#csv_parse): Parses a CSV string into a two-dimensional array of strings.
 - [`escape_values`](#escape_values): Escapes an array of values using the provided escape map.
 - [`fix_pl_typography`](#fix_pl_typography): Applies Polish-specific typographic corrections to a DOM subtree.
-- [`h`](#h): A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper
-  for creating and modifying `HTMLElement`s (see also [`s`](#s)).
+- [`h`](#h): A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `HTMLElement`s (see also [`s`](#s)).
 - [`has_own`](#has_own): Checks whether an object has the specified key as its own property.
 - [`is_array`](#is_array): Checks whether the argument is an array.
 - [`is_finite_number`](#is_finite_number): Checks whether the argument is a finite number (excludes `±Infinity` and `NaN`).
@@ -72,8 +72,7 @@ import {
 - [`omit`](#omit): Creates a new object excluding the specified keys from the source object.
 - [`pick`](#pick): Creates a new object containing only the specified keys from the source object.
 - [`rwd`](#rwd): A responsive web design helper that generates CSS rules for a grid-like layout.
-- [`s`](#s): A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper
-  for creating and modifying `SVGElement`s (see also [`h`](#h)).
+- [`s`](#s): A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `SVGElement`s (see also [`h`](#h)).
 - [`svg_use`](#svg_use): Shorthand for creating an SVG element with a `<use>` child referencing an icon by ID.
 - [`uuid_v1`](#uuid_v1): Generates a UUID v1 (time-based) identifier.
 - [`vivify`](#vivify): A Proxy-based helper for auto-vivification of nested object structures.
@@ -156,7 +155,7 @@ A CSS string representing the compiled rules.
 #### Usage Examples
 
 ```ts
-const actual = c({
+const actual_1 = c({
   a: {
     color: 'red',
     margin: 1,
@@ -165,7 +164,7 @@ const actual = c({
   }
 })
 
-const expected = `
+const expected_1 = `
 a{
   color:red;
   margin:1
@@ -178,11 +177,9 @@ a{
   padding:1
 }`.replace(/\n\s*/g, '')
 
-expect(actual).to.deep.equal(expected)
-```
+expect(actual_1).to.equal(expected_1)
 
-```ts
-const actual = c({
+const actual_2 = c({
   a: {
     '.b': {
       color: 'red',
@@ -193,7 +190,7 @@ const actual = c({
   }
 })
 
-const expected = `
+const expected_2 = `
 a.b{
   color:red;
   margin:1
@@ -206,11 +203,9 @@ a.b{
   padding:1
 }`.replace(/\n\s*/g, '')
 
-expect(actual).to.deep.equal(expected)
-```
+expect(actual_2).to.equal(expected_2)
 
-```ts
-const actual = c({
+const actual_3 = c({
   '@font-face$$1': {
     fontFamily: 'Jackens',
     src$$1: 'url(otf/jackens.otf)',
@@ -239,7 +234,7 @@ const actual = c({
   }
 })
 
-const expected = `
+const expected_3 = `
 @font-face{
   font-family:Jackens;
   src:url(otf/jackens.otf);
@@ -281,11 +276,9 @@ div.c2{
   }
 }`.replace(/\n\s*/g, '')
 
-expect(actual).to.deep.equal(expected)
-```
+expect(actual_3).to.equal(expected_3)
 
-```ts
-const actual = c({
+const actual_4 = c({
   a: {
     '.b,.c': {
       margin: 1,
@@ -296,7 +289,7 @@ const actual = c({
   }
 })
 
-const expected = `
+const expected_4 = `
 a.b,a.c{
   margin:1
 }
@@ -304,11 +297,9 @@ a.b.d,a.c.d{
   margin:2
 }`.replace(/\n\s*/g, '')
 
-expect(actual).to.deep.equal(expected)
-```
+expect(actual_4).to.equal(expected_4)
 
-```ts
-const actual = c({
+const actual_5 = c({
   '.b,.c': {
     margin: 1,
     '.d': {
@@ -317,7 +308,7 @@ const actual = c({
   }
 })
 
-const expected = `
+const expected_5 = `
 .b,.c{
   margin:1
 }
@@ -325,11 +316,9 @@ const expected = `
   margin:2
 }`.replace(/\n\s*/g, '')
 
-expect(actual).to.deep.equal(expected)
-```
+expect(actual_5).to.equal(expected_5)
 
-```ts
-const actual = c({
+const actual_6 = c({
   '.a,.b': {
     margin: 1,
     '.c,.d': {
@@ -338,7 +327,7 @@ const actual = c({
   }
 })
 
-const expected = `
+const expected_6 = `
 .a,.b{
   margin:1
 }
@@ -346,7 +335,7 @@ const expected = `
   margin:2
 }`.replace(/\n\s*/g, '')
 
-expect(actual).to.deep.equal(expected)
+expect(actual_6).to.equal(expected_6)
 ```
 
 ### csv_parse
@@ -382,6 +371,7 @@ yyy",zzz
  42 , "42" , 17
 
 `
+
 expect(csv_parse(text)).to.deep.equal([
   ['aaa\n"aaa"\naaa', 'bbb', 'ccc,ccc'],
   ['xxx,xxx', 'yyy\nyyy', 'zzz'],
@@ -448,8 +438,7 @@ const h: {
 };
 ```
 
-A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper
-for creating and modifying `HTMLElement`s (see also [`s`](#s)).
+A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `HTMLElement`s (see also [`s`](#s)).
 
 #### tag_or_node
 
@@ -475,49 +464,41 @@ The created or modified `HTMLElement`.
 ```ts
 const b = h('b')
 
-expect(b.outerHTML).to.deep.equal('<b></b>')
+expect(b.outerHTML).to.equal('<b></b>')
 
 const i = h('i', 'text')
 
 h(b, i)
 
-expect(i.outerHTML).to.deep.equal('<i>text</i>')
-expect(b.outerHTML).to.deep.equal('<b><i>text</i></b>')
+expect(i.outerHTML).to.equal('<i>text</i>')
+expect(b.outerHTML).to.equal('<b><i>text</i></b>')
 
 h(i, { $className: 'some class' })
 
-expect(i.outerHTML).to.deep.equal('<i class="some class">text</i>')
-expect(b.outerHTML).to.deep.equal('<b><i class="some class">text</i></b>')
-```
+expect(i.outerHTML).to.equal('<i class="some class">text</i>')
+expect(b.outerHTML).to.equal('<b><i class="some class">text</i></b>')
 
-```ts
-expect(h('span', 'text').outerHTML).to.deep.equal('<span>text</span>')
-expect(h('span', { $innerText: 'text' }).outerHTML).to.deep.equal('<span>text</span>')
-```
+expect(h('span', 'text').outerHTML).to.equal('<span>text</span>')
+expect(h('span', { $innerText: 'text' }).outerHTML).to.equal('<span>text</span>')
 
-```ts
-expect(h('span', '42').outerHTML).to.deep.equal('<span>42</span>')
-expect(h('span', 42).outerHTML).to.deep.equal('<span>42</span>')
-```
+expect(h('span', '42').outerHTML).to.equal('<span>42</span>')
+expect(h('span', 42).outerHTML).to.equal('<span>42</span>')
 
-```ts
 expect(h('div', { style: 'margin:0;padding:0' }).outerHTML)
-  .to.deep.equal('<div style="margin:0;padding:0"></div>')
+  .to.equal('<div style="margin:0;padding:0"></div>')
 expect(h('div', { $style: 'margin:0;padding:0' }).outerHTML)
-  .to.deep.equal('<div style="margin: 0px; padding: 0px;"></div>')
+  .to.equal('<div style="margin: 0px; padding: 0px;"></div>')
 expect(h('div', { $style: { margin: 0, padding: 0 } }).outerHTML)
-  .to.deep.equal('<div style="margin: 0px; padding: 0px;"></div>')
-```
+  .to.equal('<div style="margin: 0px; padding: 0px;"></div>')
 
-```ts
 const input1 = h('input', { value: 42 })
 const input2 = h('input', { $value: '42' })
 
-expect(input1.value).to.deep.equal('42')
-expect(input2.value).to.deep.equal('42')
+expect(input1.value).to.equal('42')
+expect(input2.value).to.equal('42')
 
-expect(input1.outerHTML).to.deep.equal('<input value="42">')
-expect(input2.outerHTML).to.deep.equal('<input>')
+expect(input1.outerHTML).to.equal('<input value="42">')
+expect(input2.outerHTML).to.equal('<input>')
 
 const checkbox1 = h('input', { type: 'checkbox', checked: true })
 const checkbox2 = h('input', { type: 'checkbox', $checked: true })
@@ -525,11 +506,9 @@ const checkbox2 = h('input', { type: 'checkbox', $checked: true })
 expect(checkbox1.checked).to.be.true
 expect(checkbox2.checked).to.be.true
 
-expect(checkbox1.outerHTML).to.deep.equal('<input type="checkbox" checked="">')
-expect(checkbox2.outerHTML).to.deep.equal('<input type="checkbox">')
-```
+expect(checkbox1.outerHTML).to.equal('<input type="checkbox" checked="">')
+expect(checkbox2.outerHTML).to.equal('<input type="checkbox">')
 
-```ts
 const div = h('div')
 
 expect(div.key).to.be.undefined
@@ -700,6 +679,7 @@ expect(is_record(new Number(42))).to.be.true
 expect(is_record(new String('42'))).to.be.true
 
 class Foo_Bar { }
+
 expect(is_record(new Foo_Bar())).to.be.true
 ```
 
@@ -810,15 +790,6 @@ const monokai: CRoot;
 
 A Monokai-inspired color scheme for use with the [`c`](#c) helper and [`nanolight_ts`](#nanolight_ts) tokenizer.
 
-Defines CSS custom properties for eight colors (`--black`, `--blue`, `--green`, `--grey`,
-`--purple`, `--red`, `--white`, `--yellow`) with both light and dark mode variants.
-
-#### Remarks
-
-- In light mode, `--black` is a light background and `--white` is dark text.
-- In dark mode (via `prefers-color-scheme: dark`), the palette inverts to a dark background with light text.
-- Includes base styles for `body`, `pre` and `code>span.*` (syntax highlighting).
-
 ### nanolight_ts
 
 ```ts
@@ -841,25 +812,25 @@ An array of [`HArgs1`](#HArgs1) elements suitable for rendering with [`h`](#h).
 const code_js = "const answer_to_life_the_universe_and_everything = { 42: 42 }['42'] /* 42 */"
 
 expect(nanolight_ts(code_js)).to.deep.equal([
-  ['span', { class: 'red' }, 'const'],
+  ['span', { class: 'keyword-1' }, 'const'],
   ' ',
-  ['span', { class: 'white' }, 'answer_to_life_the_universe_and_everything'],
+  ['span', { class: 'identifier-4' }, 'answer_to_life_the_universe_and_everything'],
   ' ',
-  ['span', { class: 'red' }, '='],
+  ['span', { class: 'operator' }, '='],
   ' ',
-  ['span', { class: 'grey' }, '{'],
+  ['span', { class: 'punctuation' }, '{'],
   ' ',
-  ['span', { class: 'purple' }, '42'],
-  ['span', { class: 'grey' }, ':'],
+  ['span', { class: 'number' }, '42'],
+  ['span', { class: 'operator' }, ':'],
   ' ',
-  ['span', { class: 'purple' }, '42'],
+  ['span', { class: 'number' }, '42'],
   ' ',
-  ['span', { class: 'grey' }, '}'],
-  ['span', { class: 'grey' }, '['],
-  ['span', { class: 'yellow' }, "'42'"],
-  ['span', { class: 'grey' }, ']'],
+  ['span', { class: 'punctuation' }, '}'],
+  ['span', { class: 'punctuation' }, '['],
+  ['span', { class: 'string' }, "'42'"],
+  ['span', { class: 'punctuation' }, ']'],
   ' ',
-  ['span', { class: 'grey' }, '/* 42 */']
+  ['span', { class: 'comment' }, '/* 42 */']
 ])
 ```
 
@@ -904,7 +875,7 @@ const expected = `
   FROM table_name
   WHERE column_name IN (b'1', NULL, NULL, 42, '42', '4''2', '1980-03-31 04:30:00')`
 
-expect(actual).to.deep.equal(expected)
+expect(actual).to.equal(expected)
 ```
 
 ### new_noun_form
@@ -915,8 +886,8 @@ const new_noun_form: (locale: string, forms: Partial<Record<Intl.LDMLPluralRule,
 
 Creates a function that returns the appropriate noun form based on a numeric value using `Intl.PluralRules`.
 
-Different languages have different plural rules. The `Intl.PluralRules` API provides
-locale-aware plural category selection. Possible categories are:
+Different languages have different plural rules. The `Intl.PluralRules` API provides locale-aware plural category selection.
+Possible categories are:
 
 - `zero`: for zero items (used in some languages like Arabic, Latvian)
 - `one`: for singular (e.g., 1 item)
@@ -943,17 +914,17 @@ A function that takes a numeric value and returns the appropriate noun form.
 ```ts
 const auto = new_noun_form('pl', { one: 'auto', few: 'auta', other: 'aut' })
 
-expect(auto(0)).to.deep.equal('aut')
-expect(auto(1)).to.deep.equal('auto')
-expect(auto(17)).to.deep.equal('aut')
-expect(auto(42)).to.deep.equal('auta')
+expect(auto(0)).to.equal('aut')
+expect(auto(1)).to.equal('auto')
+expect(auto(17)).to.equal('aut')
+expect(auto(42)).to.equal('auta')
 
 const car = new_noun_form('en', { one: 'car', other: 'cars' })
 
-expect(car(0)).to.deep.equal('cars')
-expect(car(1)).to.deep.equal('car')
-expect(car(17)).to.deep.equal('cars')
-expect(car(42)).to.deep.equal('cars')
+expect(car(0)).to.equal('cars')
+expect(car(1)).to.equal('car')
+expect(car(17)).to.equal('cars')
+expect(car(42)).to.equal('cars')
 ```
 
 ### new_tokenizer
@@ -1011,9 +982,9 @@ A new object without the specified keys.
 #### Usage Examples
 
 ```ts
-const obj = { a: 42, b: '42', c: 17 }
+const ref = { a: 42, b: '42', c: 17 }
 
-expect(omit(obj, ['c'])).to.deep.equal({ a: 42, b: '42' })
+expect(omit(ref, ['c'])).to.deep.equal({ a: 42, b: '42' })
 ```
 
 ### pick
@@ -1041,9 +1012,9 @@ A new object with only the specified keys.
 #### Usage Examples
 
 ```ts
-const obj = { a: 42, b: '42', c: 17 }
+const ref = { a: 42, b: '42', c: 17 }
 
-expect(pick(obj, ['a', 'b'])).to.deep.equal({ a: 42, b: '42' })
+expect(pick(ref, ['a', 'b'])).to.deep.equal({ a: 42, b: '42' })
 ```
 
 ### rwd
@@ -1134,8 +1105,7 @@ const s: {
 };
 ```
 
-A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper
-for creating and modifying `SVGElement`s (see also [`h`](#h)).
+A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `SVGElement`s (see also [`h`](#h)).
 
 #### tag_or_node
 
@@ -1206,41 +1176,37 @@ for (let i = 1; i <= 22136; ++i) {
   const uuid = uuid_v1()
 
   if (i === 1) {
-    expect(uuid.split('-')[3]).to.deep.equal('8001')
+    expect(uuid.split('-')[3]).to.equal('8001')
   }
 
   if (i === 4095) {
-    expect(uuid.split('-')[3]).to.deep.equal('8fff')
+    expect(uuid.split('-')[3]).to.equal('8fff')
   }
 
   if (i === 4096) {
-    expect(uuid.split('-')[3]).to.deep.equal('9000')
+    expect(uuid.split('-')[3]).to.equal('9000')
   }
 
   if (i === 9029) {
-    expect(uuid.split('-')[3]).to.deep.equal('a345')
+    expect(uuid.split('-')[3]).to.equal('a345')
   }
 
   if (i === 13398) {
-    expect(uuid.split('-')[3]).to.deep.equal('b456')
+    expect(uuid.split('-')[3]).to.equal('b456')
   }
 
   if (i === 16384) {
-    expect(uuid.split('-')[3]).to.deep.equal('8000')
+    expect(uuid.split('-')[3]).to.equal('8000')
   }
 
   if (i === 17767) {
-    expect(uuid.split('-')[3]).to.deep.equal('8567')
+    expect(uuid.split('-')[3]).to.equal('8567')
   }
 }
-```
 
-```ts
-expect(uuid_v1(new Date(), '000123456789abc').split('-')[4]).to.deep.equal('123456789abc')
-expect(uuid_v1(new Date(), '123456789').split('-')[4]).to.deep.equal('000123456789')
-```
+expect(uuid_v1(new Date(), '000123456789abc').split('-')[4]).to.equal('123456789abc')
+expect(uuid_v1(new Date(), '123456789').split('-')[4]).to.equal('000123456789')
 
-```ts
 expect(uuid_v1(new Date(323325000000)).startsWith('c1399400-9a71-11bd')).to.be.true
 ```
 
@@ -1258,14 +1224,14 @@ Accessing, assigning, or deleting any nested property on the returned proxy auto
 Intermediates of the last level in a get-only property chain are NOT auto-created.
 For example, `vivify(ref).one.two` will create `ref.one` as `{}`, but will NOT create `ref.one.two`.
 Only when a deeper access, assignment, or deletion occurs
-(e.g. `vivify(ref).one.two[3]` or `vivify(ref).one.two.three = 42`) will `ref.one.two` be materialized.
+(e.g. `delete vivify(ref).one.two.three` or `vivify(ref).one.two.three = 4`) will `ref.one.two` be materialized.
 
 When traversal reaches a primitive value, no auto-creation happens;
 the primitive’s own property is returned instead
 (e.g. accessing `.toString.name` on a number yields `'toString'` without modifying the underlying structure).
 
 Deletion on a non-existing intermediate path will auto-create intermediates up to the parent of the deleted key
-(e.g. `delete vivify(ref).a.b.c` will create `ref.a.b` as `{}` if it does not exist).
+(e.g. `delete vivify(ref).one.two.three` will create `ref.one.two` as `{}` if it does not exist).
 
 #### ref
 
@@ -1280,140 +1246,83 @@ A proxy that auto-creates nested objects/arrays on property access.
 ```ts
 const ref: any = {}
 
-vivify(ref).one.two[1][2] = 42
+vivify(ref).one.two[3][4]
 
 expect(ref).to.deep.equal({
   one: {
-    two: [
-      undefined,
-      [undefined, undefined, 42]
-    ]
+    two: [undefined, undefined, undefined, []]
   }
 })
 
-vivify(ref).one.two[1][3] = 42
+vivify(ref).one.two[3][4] = 5
 
 expect(ref).to.deep.equal({
   one: {
-    two: [
-      undefined,
-      [undefined, undefined, 42, 42]
-    ]
+    two: [undefined, undefined, undefined, [undefined, undefined, undefined, undefined, 5]]
   }
 })
 
-vivify(ref).one.two[1] = 42
+vivify(ref).one.two[3].length = 1
 
 expect(ref).to.deep.equal({
   one: {
-    two: [
-      undefined,
-      42
-    ]
+    two: [undefined, undefined, undefined, [undefined]]
   }
 })
 
-vivify(ref).one.two[3][0] = 42
+vivify(ref).one.two[3] = 4
 
 expect(ref).to.deep.equal({
   one: {
-    two: [
-      undefined,
-      42,
-      undefined,
-      [42]
-    ]
+    two: [undefined, undefined, undefined, 4]
   }
 })
 
-vivify(ref).one.two[3].length = 2
+expect(vivify(ref).one.two.length).to.equal(4)
 
 expect(ref).to.deep.equal({
   one: {
-    two: [
-      undefined,
-      42,
-      undefined,
-      [42, undefined]
-    ]
+    two: [undefined, undefined, undefined, 4]
   }
 })
 
-vivify(ref).one.two = 12
+vivify(ref).one.two = 3
 
-expect(ref).to.deep.equal({
-  one: {
-    two: 12
-  }
-})
+expect(ref).to.deep.equal({ one: { two: 3 } })
 
 vivify(ref).one.two = undefined
 
-expect(ref).to.deep.equal({
-  one: {
-    two: undefined
-  }
-})
+expect(ref).to.deep.equal({ one: { two: undefined } })
 
 delete vivify(ref).one.two
 
-expect(ref).to.deep.equal({
-  one: {}
-})
+expect(ref).to.deep.equal({ one: {} })
+
+expect(vivify(ref).one.toString instanceof Function).to.be.true
+
+expect(vivify(ref).one.toString.name).to.equal('toString')
+
+expect(ref).to.deep.equal({ one: {} })
 
 delete vivify(ref).one.two.three
 
-expect(ref).to.deep.equal({
-  one: {
-    two: {}
-  }
-})
+expect(ref).to.deep.equal({ one: { two: {} } })
 
 vivify(ref).one.two.three.four
 
-expect(ref).to.deep.equal({
-  one: {
-    two: {
-      three: {}
-    }
-  }
-})
+expect(ref).to.deep.equal({ one: { two: { three: {} } } })
 
 vivify(ref).one.two[3]
 
-expect(ref).to.deep.equal({
-  one: {
-    two: {
-      three: {}
-    }
-  }
-})
+expect(ref).to.deep.equal({ one: { two: { three: {} } } })
 
-vivify(ref).one.two.three.four = 42
+vivify(ref).one.two.three.four = 5
 
-expect(ref).to.deep.equal({
-  one: {
-    two: {
-      three: {
-        four: 42
-      }
-    }
-  }
-})
+expect(ref).to.deep.equal({ one: { two: { three: { four: 5 } } } })
 
-const name = vivify(ref).one.two.three.four.toString.name
+expect(vivify(ref).one.two.three.four.toString.name).to.equal('toString')
 
-expect(name).to.deep.equal('toString')
-
-expect(ref).to.deep.equal({
-  one: {
-    two: {
-      three: {
-        four: 42
-      }
-    }
-  }
-})
+expect(ref).to.deep.equal({ one: { two: { three: { four: 5 } } } })
 ```
 
 ## License