@jackens/nnn 2025.12.11 → 2025.12.13

package/nnn.d.ts

@@ -1,138 +1,3 @@
-/**
- * Single argument type for the {@link h} and {@link s} helpers.
- */
-export type HArgs1 = Record<PropertyKey, unknown> | null | undefined | Node | string | number | HArgs;
-/**
- * Tuple argument type for the {@link h} and {@link s} helpers.
- */
-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}).
- *
- * @param tag_or_node
- *
- * If a `string`, it is treated as the tag name for a new element.
- * If a `Node`, that node is modified in place.
- *
- * @param args
- *
- * Additional arguments processed as follows:
- * - `Object`: Maps attributes/properties. Keys starting with `$` set element properties
- *   (without the `$` prefix); other keys set attributes via `setAttribute`.
- *   A value of `false` removes the attribute.
- * - `null` / `undefined`: Ignored.
- * - `Node`: Appended as a child.
- * - `string` / `number`: Converted to a `Text` node and appended.
- * - {@link HArgs} array: Processed recursively.
- *
- * @returns
- *
- * The created or modified `HTMLElement`.
- */
-export declare const h: {
-    <T extends keyof HTMLElementTagNameMap>(tag: T, ...args1: HArgs1[]): HTMLElementTagNameMap[T];
-    <N extends Node>(node: N, ...args1: HArgs1[]): N;
-    (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}).
- *
- * @param tag_or_node
- *
- * If a `string`, it is treated as the tag name for a new element.
- * If a `Node`, that node is modified in place.
- *
- * @param args
- *
- * Additional arguments processed as follows:
- * - `Object`: Maps attributes/properties. Keys starting with `$` set element properties
- *   (without the `$` prefix); other keys set attributes via `setAttributeNS`.
- *   A value of `false` removes the attribute.
- * - `null` / `undefined`: Ignored.
- * - `Node`: Appended as a child.
- * - `string` / `number`: Converted to a `Text` node and appended.
- * - {@link HArgs} array: Processed recursively.
- *
- * @returns
- *
- * The created or modified `SVGElement`.
- */
-export declare const s: {
-    <T extends keyof SVGElementTagNameMap>(tag: T, ...args1: HArgs1[]): SVGElementTagNameMap[T];
-    <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;
-/**
- * A helper for building simple tokenizers (see also {@link nanolight_ts}).
- *
- * @param decorator
- *
- * 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 specs
- *
- * 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 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 new_tokenizer: <M, T>(decorator: (chunk: string, metadata?: M) => T, ...specs: [M, string | RegExp][]) => (code: string) => T[];
-/**
- * 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} or {@link s}.
- */
-export declare const nanolight_ts: (code: string) => HArgs1[];
-/**
- * Applies Polish-specific typographic corrections to a DOM subtree.
- *
- * This function prevents orphaned conjunctions (single-letter words like “a”, “i”, “o”, “u”, “w”, “z”)
- * from appearing at the end of a line by wrapping them with the following word in a non-breaking span.
- * It also inserts zero-width spaces after slashes and dots to allow line breaks.
- *
- * @param node
- *
- * The root DOM node to process. All descendant text nodes are corrected recursively,
- * except those inside `IFRAME`, `NOSCRIPT`, `PRE`, `SCRIPT`, `STYLE`, or `TEXTAREA` elements.
- */
-export declare const fix_typography: (node: Node) => void;
 /**
  * Represents a CSS rule node for the {@link c} helper. Keys are CSS properties or nested selectors.
  */
@@ -192,11 +57,31 @@ export declare const c: (root: CRoot, splitter?: string) => string;
  * @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.
+ * - `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.
+ *
+ * Supports quoted fields with escaped double quotes (`""`). Carriage returns are normalized.
+ *
+ * @param csv
+ *
+ * The CSV string to parse.
+ *
+ * @param separator
+ *
+ * The field delimiter (default: `','`).
+ *
+ * @returns
+ *
+ * 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.
  *
@@ -239,71 +124,123 @@ export declare const escape_values: (escape_map: EscapeMap, values: unknown[]) =
  * The resulting string with all interpolated values escaped.
  */
 export declare const escape: (escape_map: EscapeMap, template: TemplateStringsArray, ...values: unknown[]) => string;
+
 /**
- * Returns the appropriate Polish noun form based on a numeric value.
+ * Applies Polish-specific typographic corrections to a DOM subtree.
  *
- * Polish has three plural forms depending on the number:
- * - Singular: used for exactly 1.
- * - “Plural 2-4”: used for 2, 3, 4, 22, 23, 24, etc. (but not 12, 13, 14).
- * - “Plural 5+”: used for 0, 5–21, 25–31, etc.
+ * This function prevents orphaned conjunctions (single-letter words like “a”, “i”, “o”, “u”, “w”, “z”)
+ * from appearing at the end of a line by wrapping them with the following word in a non-breaking span.
+ * It also inserts zero-width spaces after slashes and dots to allow line breaks.
  *
- * @param singular
+ * @param node
  *
- * The singular form (e.g., ”auto” for “car”).
+ * The root DOM node to process. All descendant text nodes are corrected recursively,
+ * except those inside `IFRAME`, `NOSCRIPT`, `PRE`, `SCRIPT`, `STYLE`, or `TEXTAREA` elements.
+ */
+export declare const fix_typography: (node: Node) => void;
+
+/**
+ * Single argument type for the {@link h} and {@link s} helpers.
+ */
+export type HArgs1 = Record<PropertyKey, unknown> | null | undefined | Node | string | number | HArgs;
+/**
+ * Tuple argument type for the {@link h} and {@link s} helpers.
+ */
+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}).
  *
- * @param plural_2
+ * @param tag_or_node
  *
- * The form for 2, 3, 4 (e.g., “auta”).
+ * If a `string`, it is treated as the tag name for a new element.
+ * If a `Node`, that node is modified in place.
  *
- * @param plural_5
+ * @param args
  *
- * The form for 5+ (e.g., “aut”).
+ * Additional arguments processed as follows:
+ * - `Object`: maps attributes/properties. Keys starting with `$` set element properties (without the `$` prefix);
+ *   other keys set attributes via `setAttribute`. A value of `false` removes the attribute.
+ * - `null`/`undefined`: ignored.
+ * - `Node`: appended as a child.
+ * - `string`/`number`: converted to a `Text` node and appended.
+ * - {@link HArgs} array: processed recursively.
  *
- * @param value
+ * @returns
  *
- * The numeric value to evaluate.
+ * The created or modified `HTMLElement`.
+ */
+export declare const h: {
+    <T extends keyof HTMLElementTagNameMap>(tag: T, ...args1: HArgs1[]): HTMLElementTagNameMap[T];
+    <N extends Node>(node: N, ...args1: HArgs1[]): N;
+    (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}).
+ *
+ * @param tag_or_node
+ *
+ * If a `string`, it is treated as the tag name for a new element.
+ * If a `Node`, that node is modified in place.
+ *
+ * @param args
+ *
+ * Additional arguments processed as follows:
+ * - `Object`: maps attributes/properties. Keys starting with `$` set element properties (without the `$` prefix);
+ *   other keys set attributes via `setAttributeNS`. A value of `false` removes the attribute.
+ * - `null`/`undefined`: ignored.
+ * - `Node`: appended as a child.
+ * - `string`/`number`: converted to a `Text` node and appended.
+ * - {@link HArgs} array: processed recursively.
  *
  * @returns
  *
- * The appropriate noun form for the given value.
+ * The created or modified `SVGElement`.
  */
-export declare const pl_ural: (singular: string, plural_2: string, plural_5: string, value: number) => string;
+export declare const s: {
+    <T extends keyof SVGElementTagNameMap>(tag: T, ...args1: HArgs1[]): SVGElementTagNameMap[T];
+    <N extends Node>(node: N, ...args1: HArgs1[]): N;
+    (tag_or_node: string | Node, ...args1: HArgs1[]): Node;
+};
 /**
- * Generates a UUID v1 (time-based) identifier.
+ * Shorthand for creating an SVG element with a `<use>` child referencing an icon by ID.
  *
- * @param date
+ * Equivalent to: `s('svg', ['use', { 'xlink:href': '#' + id }], ...args)`.
  *
- * The date to use for the timestamp portion (default: current date/time).
+ * @param id
  *
- * @param node
+ * The ID of the symbol to reference (without the `#` prefix).
  *
- * A hexadecimal `string` for the node portion (default: random).
- * Must match `/^[0-9a-f]*$/`; it is trimmed to the last 12 characters and left-padded with zeros if shorter.
+ * @param args
+ *
+ * Additional arguments passed to the outer `<svg>` element.
  *
  * @returns
  *
- * A UUID v1 `string` in the standard format `xxxxxxxx-xxxx-1xxx-xxxx-xxxxxxxxxxxx`.
+ * An `SVGSVGElement` containing a `<use>` element.
  */
-export declare const uuid_v1: (date?: Date, node?: string) => string;
+export declare const svg_use: (id: string, ...args: HArgs1[]) => SVGSVGElement;
+
 /**
- * Parses JSON with support for handler-based value transformation (“JavaScript ON”).
+ * Checks whether an object has the specified key as its own property.
  *
- * Objects with exactly one property whose key exists in `handlers` and whose value is an array
- * are replaced by invoking the corresponding handler with the array elements as arguments.
+ * A null-safe wrapper around `Object.hasOwn`.
  *
- * @param handlers
+ * @param ref
  *
- * An object mapping handler names to functions.
+ * The object to check.
  *
- * @param text
+ * @param key
  *
- * The JSON string to parse.
+ * The property key to look for.
  *
  * @returns
  *
- * The parsed value with handler substitutions applied.
+ * `true` if `ref` is not nullish and has `key` as an own property, `false` otherwise.
  */
-export declare const js_on_parse: (handlers: Record<PropertyKey, Function>, text: string) => any;
+export declare const has_own: (ref: unknown, key: unknown) => boolean;
+
 /**
  * Checks whether the argument is an array.
  *
@@ -364,57 +301,67 @@ export declare const is_record: (arg: unknown) => arg is Record<PropertyKey, unk
  * `true` if `typeof arg === 'string'`, `false` otherwise.
  */
 export declare const is_string: (arg: unknown) => arg is string;
+
 /**
- * Checks whether an object has the specified key as its own property.
+ * Parses JSON with support for handler-based value transformation (“JavaScript ON”).
  *
- * A null-safe wrapper around `Object.hasOwn`.
+ * Objects with exactly one property whose key exists in `handlers` and whose value is an array
+ * are replaced by invoking the corresponding handler with the array elements as arguments.
  *
- * @param ref
+ * @param handlers
  *
- * The object to check.
+ * An object mapping handler names to functions.
  *
- * @param key
+ * @param text
  *
- * The property key to look for.
+ * The JSON string to parse.
  *
  * @returns
  *
- * `true` if `ref` is not nullish and has `key` as an own property, `false` otherwise.
+ * The parsed value with handler substitutions applied.
  */
-export declare const has_own: (ref: unknown, key: unknown) => boolean;
+export declare const js_on_parse: (handlers: Record<PropertyKey, Function>, text: string) => any;
+
 /**
- * A Proxy-based helper for auto-vivification of nested object structures.
- *
- * Accessing any property on the returned proxy automatically creates an empty object if the property does not exist,
- * allowing deep assignments without explicit null checks.
+ * A TypeScript/JavaScript syntax highlighting tokenizer built using {@link new_tokenizer}.
  *
- * @param ref
+ * @param code
  *
- * The root object to wrap.
+ * The source code string to tokenize.
  *
  * @returns
  *
- * A proxy that auto-creates nested objects on property access.
+ * An array of {@link HArgs1} elements suitable for rendering with {@link h} or {@link s}.
  */
-export declare const pro: (ref: unknown) => any;
+export declare const nanolight_ts: (code: string) => HArgs1[];
+
 /**
- * Parses a CSV string into a two-dimensional array of strings.
- *
- * Supports quoted fields with escaped double quotes (`""`). Carriage returns are normalized.
+ * A helper for building simple tokenizers (see also {@link nanolight_ts}).
  *
- * @param csv
+ * @param decorator
  *
- * The CSV string to parse.
+ * 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 separator
+ * @param specs
  *
- * The field delimiter (default: `','`).
+ * 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 2D array where each inner array represents a row of fields.
+ * 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 csv_parse: (csv: string, separator?: string) => string[][];
+export declare const new_tokenizer: <M, T>(decorator: (chunk: string, metadata?: M) => T, ...specs: [M, string | RegExp][]) => (code: string) => T[];
+
 /**
  * Creates a new object containing only the specified keys from the source object.
  *
@@ -451,3 +398,67 @@ export declare const pick: <T, K extends keyof T>(ref: T, keys: K[]) => Pick<T,
  * A new object without the specified keys.
  */
 export declare const omit: <T, K extends keyof T>(ref: T, keys: unknown[]) => Omit<T, K>;
+
+/**
+ * Returns the appropriate Polish noun form based on a numeric value.
+ *
+ * Polish has three plural forms depending on the number:
+ * - Singular: used for exactly 1.
+ * - “Plural 2-4”: used for 2, 3, 4, 22, 23, 24, etc. (but not 12, 13, 14).
+ * - “Plural 5+”: used for 0, 5–21, 25–31, etc.
+ *
+ * @param singular
+ *
+ * The singular form (e.g., “auto” for “car”).
+ *
+ * @param plural_2
+ *
+ * The form for 2, 3, 4 (e.g., “auta”).
+ *
+ * @param plural_5
+ *
+ * The form for 5+ (e.g., “aut”).
+ *
+ * @param value
+ *
+ * The numeric value to evaluate.
+ *
+ * @returns
+ *
+ * The appropriate noun form for the given value.
+ */
+export declare const pl_ural: (singular: string, plural_2: string, plural_5: string, value: number) => string;
+
+/**
+ * A Proxy-based helper for auto-vivification of nested object structures.
+ *
+ * Accessing any property on the returned proxy automatically creates an empty object if the property does not exist,
+ * allowing deep assignments without explicit null checks.
+ *
+ * @param ref
+ *
+ * The root object to wrap.
+ *
+ * @returns
+ *
+ * A proxy that auto-creates nested objects on property access.
+ */
+export declare const pro: (ref: unknown) => any;
+
+/**
+ * Generates a UUID v1 (time-based) identifier.
+ *
+ * @param date
+ *
+ * The date to use for the timestamp portion (default: current date/time).
+ *
+ * @param node
+ *
+ * A hexadecimal `string` for the node portion (default: random).
+ * Must match `/^[0-9a-f]*$/`; it is trimmed to the last 12 characters and left-padded with zeros if shorter.
+ *
+ * @returns
+ *
+ * A UUID v1 `string` in the standard format `xxxxxxxx-xxxx-1xxx-xxxx-xxxxxxxxxxxx`.
+ */
+export declare const uuid_v1: (date?: Date, node?: string) => string;

package/nnn.js

@@ -1,4 +1,101 @@
-// src/nnn.ts
+// 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";
+
+// src/nnn/pro.ts
+var pro = (ref) => new Proxy(ref, {
+  get(target, key) {
+    return pro(target[key] ??= {});
+  }
+});
+
+// src/nnn/c.ts
+var _c = (node, prefix, result, splitter) => {
+  const queue = [[node, prefix]];
+  while (queue.length > 0) {
+    const [style_0, prefix_0] = queue.shift();
+    if (style_0 == null || prefix_0 == null) {
+      continue;
+    }
+    if (is_array(style_0)) {
+      result.push(prefix_0, prefix_0 !== "" ? "{" : "", style_0.join(";"), prefix_0 !== "" ? "}" : "");
+    } else {
+      const todo = [];
+      let attributes = [];
+      let attributes_pushed = false;
+      for (const key in style_0) {
+        const value = style_0[key];
+        if (is_string(value) || is_number(value)) {
+          if (!attributes_pushed) {
+            attributes_pushed = true;
+            attributes = [];
+            todo.push([attributes, prefix_0]);
+          }
+          const attribute = key.split(splitter)[0].replace(/_/g, "-").replace(/([A-Z])/g, (_, letter) => "-" + letter.toLowerCase());
+          attributes.push(`${attribute}:${value}`);
+        } else if (value != null) {
+          attributes_pushed = false;
+          const prefix_n = [];
+          const key_chunks = key.split(",");
+          prefix_0.split(",").forEach((prefix_chunk) => key_chunks.forEach((key_chunk) => prefix_n.push(prefix_chunk + key_chunk)));
+          todo.push([value, prefix_n.join()]);
+        }
+      }
+      queue.unshift(...todo);
+    }
+  }
+};
+var c = (root, splitter = "$$") => {
+  const chunks = [];
+  for (const key in root) {
+    const value = root[key];
+    if (value != null) {
+      if (key[0] === "@") {
+        chunks.push(key.split(splitter)[0] + "{");
+        _c(value, "", chunks, splitter);
+        chunks.push("}");
+      } else {
+        _c(value, key.split(splitter)[0], chunks, splitter);
+      }
+    }
+  }
+  return chunks.join("");
+};
+var rwd = (root, selector, cell_width_px, cell_height_px, ...specs) => {
+  const main = pro(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 : pro(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 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"));
+};
+// 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 escape = (escape_map, template, ...values) => String.raw(template, ...escape_values(escape_map, values));
+// src/nnn/h.ts
 var _h = (namespace_uri) => {
   const create_element = namespace_uri == null ? (tag) => document.createElement(tag) : (tag) => document.createElementNS(namespace_uri, tag);
   const h = (tag_or_node, ...args) => {
@@ -57,9 +154,62 @@ var _h = (namespace_uri) => {
   };
   return h;
 };
-var h = _h();
-var s = _h("http://www.w3.org/2000/svg");
+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_typography.ts
+var TAGS_TO_SKIP = ["IFRAME", "NOSCRIPT", "PRE", "SCRIPT", "STYLE", "TEXTAREA"];
+var fix_typography = (node) => {
+  const queue = [node];
+  while (queue.length > 0) {
+    const node_0 = queue.shift();
+    if (node_0 instanceof Element) {
+      node_0.childNodes.forEach((child_node) => {
+        if (child_node instanceof Text) {
+          queue.push(child_node);
+        } else if (child_node instanceof Element && !TAGS_TO_SKIP.includes(child_node.tagName)) {
+          queue.push(child_node);
+        }
+      });
+    } else if (node_0 instanceof Text) {
+      const node_value = node_0.nodeValue?.trim?.();
+      if (node_value != null) {
+        let previous_node = node_0;
+        node_value.split(/(\s|\(|„)([aiouwz—]\s)/gi).forEach((chunk, i) => {
+          i %= 3;
+          const current_node = i === 2 ? h("span", { style: "white-space:nowrap" }, chunk) : i === 1 ? document.createTextNode(chunk) : document.createTextNode(chunk.replace(/(\/(?=[^/\s])|\.(?=[^\s]))/g, "$1​"));
+          if (node_0.parentNode != null) {
+            node_0.parentNode.insertBefore(current_node, previous_node.nextSibling);
+          }
+          previous_node = current_node;
+        });
+        node_0.parentNode?.removeChild(node_0);
+      }
+    }
+  }
+};
+// src/nnn/has_own.ts
+var has_own = (ref, key) => ref != null && Object.hasOwn(ref, key);
+// src/nnn/js_on_parse.ts
+var js_on_parse = (handlers, text) => JSON.parse(text, (key, value) => {
+  if (is_record(value)) {
+    let is_second_key = false;
+    for (key in value) {
+      if (is_second_key) {
+        return value;
+      }
+      is_second_key = true;
+    }
+    const handler = handlers[key];
+    const params = value[key];
+    if (handler instanceof Function && is_array(params)) {
+      return handler(...params);
+    }
+  }
+  return value;
+});
+// src/nnn/new_tokenizer.ts
 var new_tokenizer = (decorator, ...specs) => (code) => {
   const result = [];
   while (code.length > 0) {
@@ -97,6 +247,8 @@ var new_tokenizer = (decorator, ...specs) => (code) => {
   }
   return result;
 };
+
+// src/nnn/nanolight.ts
 var BLUE = "blue";
 var GREEN = "green";
 var GREY = "grey";
@@ -104,159 +256,24 @@ var PURPLE = "purple";
 var RED = "red";
 var WHITE = "white";
 var YELLOW = "yellow";
-var nanolight_ts = new_tokenizer((chunk, name) => name != null ? ["span", { class: name }, chunk] : chunk, [YELLOW, /".*?"/], [YELLOW, /'.*?'/], [YELLOW, /`[\s\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, "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, /[A-Z_$][A-Z0-9_$]+/], [PURPLE, /\d[\d_]*(\.[\d_]+)?(e[+-]?[\d_]+)?/], [BLUE, "any"], [BLUE, "bigint"], [BLUE, "boolean"], [BLUE, "eval"], [BLUE, "number"], [BLUE, "string"], [BLUE, "symbol"], [BLUE, "unknown"], [GREEN, /[$\w]+(?=\()/], [BLUE, /[A-Z][$\w]+/], [WHITE, /[$\w]+/]);
-var TAGS_TO_SKIP = ["IFRAME", "NOSCRIPT", "PRE", "SCRIPT", "STYLE", "TEXTAREA"];
-var fix_typography = (node) => {
-  const queue = [node];
-  while (queue.length > 0) {
-    const node_0 = queue.shift();
-    if (node_0 instanceof Element) {
-      node_0.childNodes.forEach((child_node) => {
-        if (child_node instanceof Text) {
-          queue.push(child_node);
-        } else if (child_node instanceof Element && !TAGS_TO_SKIP.includes(child_node.tagName)) {
-          queue.push(child_node);
-        }
-      });
-    } else if (node_0 instanceof Text) {
-      const node_value = node_0.nodeValue?.trim?.();
-      if (node_value != null) {
-        let previous_node = node_0;
-        node_value.split(/(\s|\(|„)([aiouwz—]\s)/gi).forEach((chunk, i) => {
-          i %= 3;
-          const current_node = i === 2 ? h("span", { style: "white-space:nowrap" }, chunk) : i === 1 ? document.createTextNode(chunk) : document.createTextNode(chunk.replace(/(\/(?=[^/\s])|\.(?=[^\s]))/g, "$1​"));
-          if (node_0.parentNode != null) {
-            node_0.parentNode.insertBefore(current_node, previous_node.nextSibling);
-          }
-          previous_node = current_node;
-        });
-        node_0.parentNode?.removeChild(node_0);
-      }
-    }
-  }
-};
-var _c = (node, prefix, result, splitter) => {
-  const queue = [[node, prefix]];
-  while (queue.length > 0) {
-    const [style_0, prefix_0] = queue.shift();
-    if (style_0 == null || prefix_0 == null) {
-      continue;
-    }
-    if (is_array(style_0)) {
-      result.push(prefix_0, prefix_0 !== "" ? "{" : "", style_0.join(";"), prefix_0 !== "" ? "}" : "");
-    } else {
-      const todo = [];
-      let attributes = [];
-      let attributes_pushed = false;
-      for (const key in style_0) {
-        const value = style_0[key];
-        if (is_string(value) || is_number(value)) {
-          if (!attributes_pushed) {
-            attributes_pushed = true;
-            attributes = [];
-            todo.push([attributes, prefix_0]);
-          }
-          const attribute = key.split(splitter)[0].replace(/_/g, "-").replace(/([A-Z])/g, (_, letter) => "-" + letter.toLowerCase());
-          attributes.push(`${attribute}:${value}`);
-        } else if (value != null) {
-          attributes_pushed = false;
-          const prefix_n = [];
-          const key_chunks = key.split(",");
-          prefix_0.split(",").forEach((prefix_chunk) => key_chunks.forEach((key_chunk) => prefix_n.push(prefix_chunk + key_chunk)));
-          todo.push([value, prefix_n.join()]);
-        }
-      }
-      queue.unshift(...todo);
-    }
-  }
-};
-var c = (root, splitter = "$$") => {
-  const chunks = [];
-  for (const key in root) {
-    const value = root[key];
-    if (value != null) {
-      if (key[0] === "@") {
-        chunks.push(key.split(splitter)[0] + "{");
-        _c(value, "", chunks, splitter);
-        chunks.push("}");
-      } else {
-        _c(value, key.split(splitter)[0], chunks, splitter);
-      }
-    }
-  }
-  return chunks.join("");
-};
-var rwd = (root, selector, cell_width_px, cell_height_px, ...specs) => {
-  const main = pro(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 : pro(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) {
-      [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`;
-  }
-};
-var escape_values = (escape_map, values) => values.map((value) => (value == null ? escape_map.get(value) : escape_map.get(value?.constructor))?.(value) ?? "");
-var escape = (escape_map, template, ...values) => String.raw(template, ...escape_values(escape_map, values));
+var nanolight_ts = /* @__PURE__ */ new_tokenizer((chunk, name) => name != null ? ["span", { class: name }, chunk] : chunk, [YELLOW, /".*?"/], [YELLOW, /'.*?'/], [YELLOW, /`[\s\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, "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, /[A-Z_$][A-Z0-9_$]+/], [PURPLE, /\d[\d_]*(\.[\d_]+)?(e[+-]?[\d_]+)?/], [BLUE, "any"], [BLUE, "bigint"], [BLUE, "boolean"], [BLUE, "eval"], [BLUE, "number"], [BLUE, "string"], [BLUE, "symbol"], [BLUE, "unknown"], [GREEN, /[$\w]+(?=\()/], [BLUE, /[A-Z][$\w]+/], [WHITE, /[$\w]+/]);
+// 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/pl_ural.ts
 var pl_ural = (singular, plural_2, plural_5, value) => {
   const abs_value = Math.abs(value);
   const abs_value_mod_10 = abs_value % 10;
   return value === 1 ? singular : (abs_value_mod_10 === 2 || abs_value_mod_10 === 3 || abs_value_mod_10 === 4) && abs_value !== 12 && abs_value !== 13 && abs_value !== 14 ? plural_2 : plural_5;
 };
-var ZEROS = "0".repeat(16);
+// src/nnn/uuid_v1.ts
+var ZEROS = /* @__PURE__ */ "0".repeat(16);
 var counter = 0;
 var uuid_v1 = (date = new Date, node = Math.random().toString(16).slice(2)) => {
   const time = ZEROS + (1e4 * (+date + 12219292800000)).toString(16);
   counter = counter + 1 & 16383;
   return time.slice(-8).concat("-", time.slice(-12, -8), -1, time.slice(-15, -12), "-", (8 | counter >> 12).toString(16), (ZEROS + (counter & 4095).toString(16)).slice(-3), "-", (ZEROS + node).slice(-12));
 };
-var js_on_parse = (handlers, text) => JSON.parse(text, (key, value) => {
-  if (is_record(value)) {
-    let is_second_key = false;
-    for (key in value) {
-      if (is_second_key) {
-        return value;
-      }
-      is_second_key = true;
-    }
-    const handler = handlers[key];
-    const params = value[key];
-    if (handler instanceof Function && is_array(params)) {
-      return handler(...params);
-    }
-  }
-  return value;
-});
-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";
-var has_own = (ref, key) => ref != null && Object.hasOwn(ref, key);
-var pro = (ref) => new Proxy(ref, {
-  get(target, key) {
-    return pro(target[key] ??= {});
-  }
-});
-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 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)));
 export {
   uuid_v1,
   svg_use,

package/package.json

@@ -38,5 +38,5 @@
   "name": "@jackens/nnn",
   "type": "module",
   "types": "nnn.d.ts",
-  "version": "2025.12.11"
+  "version": "2025.12.13"
 }

package/readme.md

@@ -490,13 +490,12 @@ If a `Node`, that node is modified in place.
 #### args
 
 Additional arguments processed as follows:
-- `Object`: Maps attributes/properties. Keys starting with `$` set element properties
-  (without the `$` prefix); other keys set attributes via `setAttribute`.
-  A value of `false` removes the attribute.
-- `null` / `undefined`: Ignored.
-- `Node`: Appended as a child.
-- `string` / `number`: Converted to a `Text` node and appended.
-- [`HArgs`](#HArgs) array: Processed recursively.
+- `Object`: maps attributes/properties. Keys starting with `$` set element properties (without the `$` prefix);
+  other keys set attributes via `setAttribute`. A value of `false` removes the attribute.
+- `null`/`undefined`: ignored.
+- `Node`: appended as a child.
+- `string`/`number`: converted to a `Text` node and appended.
+- [`HArgs`](#HArgs) array: processed recursively.
 
 #### Returns
 
@@ -895,8 +894,8 @@ For unmatched text between patterns, `metadata` is `undefined`.
 #### specs
 
 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.
+- `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
 
@@ -983,7 +982,7 @@ Polish has three plural forms depending on the number:
 
 #### singular
 
-The singular form (e.g., ”auto” for “car”).
+The singular form (e.g., “auto” for “car”).
 
 #### plural_2
 
@@ -1095,9 +1094,9 @@ The base cell height in pixels.
 #### 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.
+- `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.
 
 #### Usage Examples
 
@@ -1167,13 +1166,12 @@ If a `Node`, that node is modified in place.
 #### args
 
 Additional arguments processed as follows:
-- `Object`: Maps attributes/properties. Keys starting with `$` set element properties
-  (without the `$` prefix); other keys set attributes via `setAttributeNS`.
-  A value of `false` removes the attribute.
-- `null` / `undefined`: Ignored.
-- `Node`: Appended as a child.
-- `string` / `number`: Converted to a `Text` node and appended.
-- [`HArgs`](#HArgs) array: Processed recursively.
+- `Object`: maps attributes/properties. Keys starting with `$` set element properties (without the `$` prefix);
+  other keys set attributes via `setAttributeNS`. A value of `false` removes the attribute.
+- `null`/`undefined`: ignored.
+- `Node`: appended as a child.
+- `string`/`number`: converted to a `Text` node and appended.
+- [`HArgs`](#HArgs) array: processed recursively.
 
 #### Returns