@jackens/nnn 2025.11.11 → 2025.12.8

package/nnn.d.ts

@@ -1,42 +1,3 @@
-/** Argument type for the `c` helper. */
-export type CNode = {
-    [attribute_or_selector: string]: string | number | CNode | undefined;
-};
-/** Argument type for the `c` helper. */
-export type CRoot = Record<PropertyKey, CNode>;
-/**
- * A minimal JS-to-CSS (CSS‑in‑JS) helper.
- *
- * The `root` object describes a hierarchy of CSS rules.
- *
- * - 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: CRoot, splitter?: string) => string;
-/**
- * A responsive‑web‑design helper that generates CSS rules for a grid layout.
- *
- * - `root` and `selector` specify where to apply the generated rules (see `c`).
- * - `cell_width_px` and `cell_height_px` specify the base cell dimensions in pixels.
- * - Each entry in `specs` is a tuple of:
- *   - `max_width`: maximum number of cells in a row (viewport width breakpoint).
- *   - `width` (optional, default: `1`): number of cells occupied by the element.
- *   - `height` (optional, default: `1`): number of cells in height occupied by the element.
- */
-export declare const rwd: (root: CRoot, selector: string, cell_width_px: number, cell_height_px: number, ...specs: [number, number?, number?][]) => void;
-/** A tiny CSV parsing helper. */
-export declare const csv_parse: (csv: string, separator?: string) => string[][];
-/** Argument type accepted by the `escape_values` and `escape` helpers. */
-export type EscapeMap = Map<unknown, (value?: unknown) => string>;
-/** Escapes array `values` using the provided `escape_map`. */
-export declare const escape_values: (escape_map: EscapeMap, values: unknown[]) => string[];
-/** Escapes interpolated template `values` using the provided `escape_map`. */
-export declare const escape: (escape_map: EscapeMap, template: TemplateStringsArray, ...values: unknown[]) => string;
-/** Applies Polish‑specific typographic corrections. */
-export declare const fix_typography: (node: Node) => void;
 /** Argument type for the `h` and `s` helpers. */
 export type HArgs1 = Record<PropertyKey, unknown> | null | undefined | Node | string | number | HArgs;
 /** Argument type for the `h` and `s` helpers. */
@@ -81,18 +42,63 @@ export declare const s: {
 };
 /** Shorthand for: `s('svg', ['use', { 'xlink:href': '#' + id }], ...args)`. */
 export declare const svg_use: (id: string, ...args: HArgs1[]) => SVGSVGElement;
-/** A replacement to the `in` operator (not to be confused with `for-in`). */
-export declare const has_own: (ref: unknown, key: unknown) => boolean;
-/** Checks whether the argument is an array. */
-export declare const is_array: (arg: unknown) => arg is unknown[];
-/** Checks whether the argument is a finite number (excluding `±Infinity` and `NaN`). */
-export declare const is_finite_number: (arg: unknown) => arg is number;
-/** Checks whether the argument is a number. */
-export declare const is_number: (arg: unknown) => arg is number;
-/** Checks whether the argument is a plain object record. */
-export declare const is_record: (arg: unknown) => arg is Record<PropertyKey, unknown>;
-/** Checks whether the argument is a string. */
-export declare const is_string: (arg: unknown) => arg is string;
+/**
+ * Generic syntax highlighting helper (see also `nanolight_ts`).
+ *
+ * Each `config` argument is a mapping of CSS class names to arrays of string or RegExp patterns.
+ *
+ * - For any two patterns that match at different positions, the one matching earlier takes precedence.
+ * - For any two patterns that match at the same position, the longer one takes precedence.
+ * - For any two patterns that match at the same position and have the same length, the one defined earlier takes precedence.
+ */
+export declare const nanolight: (...configs: Record<string, (string | RegExp)[]>[]) => (code: string) => HArgs1[];
+/** TypeScript syntax highlighting helper (built on `nanolight`). */
+export declare const nanolight_ts: (code: string) => HArgs1[];
+/** Applies Polish‑specific typographic corrections. */
+export declare const fix_typography: (node: Node) => void;
+/** Argument type for the `c` helper. */
+export type CNode = {
+    [attribute_or_selector: string]: string | number | CNode | undefined;
+};
+/** Argument type for the `c` helper. */
+export type CRoot = Record<PropertyKey, CNode>;
+/**
+ * A minimal JS-to-CSS (CSS‑in‑JS) helper.
+ *
+ * The `root` object describes a hierarchy of CSS rules.
+ *
+ * - 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: CRoot, splitter?: string) => string;
+/**
+ * A responsive‑web‑design helper that generates CSS rules for a grid layout.
+ *
+ * - `root` and `selector` specify where to apply the generated rules (see `c`).
+ * - `cell_width_px` and `cell_height_px` specify the base cell dimensions in pixels.
+ * - Each entry in `specs` is a tuple of:
+ *   - `max_width`: maximum number of cells in a row (viewport width breakpoint).
+ *   - `width` (optional, default: `1`): number of cells occupied by the element.
+ *   - `height` (optional, default: `1`): number of cells in height occupied by the element.
+ */
+export declare const rwd: (root: CRoot, selector: string, cell_width_px: number, cell_height_px: number, ...specs: [number, number?, number?][]) => void;
+/** Argument type accepted by the `escape_values` and `escape` helpers. */
+export type EscapeMap = Map<unknown, (value?: unknown) => string>;
+/** Escapes array `values` using the provided `escape_map`. */
+export declare const escape_values: (escape_map: EscapeMap, values: unknown[]) => string[];
+/** Escapes interpolated template `values` using the provided `escape_map`. */
+export declare const escape: (escape_map: EscapeMap, template: TemplateStringsArray, ...values: unknown[]) => string;
+/** 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;
+/**
+ * Generates a UUID v1 (time-based) identifier.
+ *
+ * - 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;
 /**
  * `JSON.parse` with “JavaScript turned on”.
  *
@@ -109,21 +115,23 @@ export declare const is_string: (arg: unknown) => arg is string;
  * ```
  */
 export declare const js_on_parse: (handlers: Record<PropertyKey, Function>, text: string) => any;
-/** Generic syntax highlighting helper (see also `nanolight_js`). */
-export declare const nanolight: (pattern: RegExp, highlighters: ((chunk: string, index: number) => HArgs1)[], code: string) => HArgs1[];
-/** JavaScript syntax highlighting helper (built on `nanolight`). */
-export declare const nanolight_js: (code: string) => HArgs1[];
+/** Checks whether the argument is an array. */
+export declare const is_array: (arg: unknown) => arg is unknown[];
+/** Checks whether the argument is a finite number (excluding `±Infinity` and `NaN`). */
+export declare const is_finite_number: (arg: unknown) => arg is number;
+/** Checks whether the argument is a number. */
+export declare const is_number: (arg: unknown) => arg is number;
+/** Checks whether the argument is a plain object record. */
+export declare const is_record: (arg: unknown) => arg is Record<PropertyKey, unknown>;
+/** Checks whether the argument is a string. */
+export declare const is_string: (arg: unknown) => arg is string;
+/** A replacement to the `in` operator (not to be confused with `for-in`). */
+export declare const has_own: (ref: unknown, key: unknown) => boolean;
+/** 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 tiny CSV parsing helper. */
+export declare const csv_parse: (csv: string, separator?: string) => string[][];
 /** 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>;
 /** 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>;
-/** 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 `Proxy`-based helper that safely creates nested structures on access and allows deep assignment without guards. */
-export declare const pro: (ref: unknown) => any;
-/**
- * Generates a UUID v1 (time-based) identifier.
- *
- * - 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,4 +1,288 @@
 // src/nnn.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) => {
+    const node = is_string(tag_or_node) ? create_element(tag_or_node) : tag_or_node;
+    args.forEach((arg) => {
+      let child = null;
+      if (arg instanceof Node) {
+        child = arg;
+      } else if (is_array(arg)) {
+        child = h(...arg);
+      } else if (is_record(arg)) {
+        for (const name in arg) {
+          const value = arg[name];
+          if (name[0] === "$") {
+            const name1 = name.slice(1);
+            if (is_record(value)) {
+              node[name1] ??= {};
+              Object.assign(node[name1], value);
+            } else {
+              node[name1] = value;
+            }
+          } else if (node instanceof Element) {
+            const index_of_colon = name.indexOf(":");
+            if (index_of_colon >= 0) {
+              const ns_key = name.slice(0, index_of_colon);
+              if (ns_key === "xlink") {
+                const ns = "http://www.w3.org/1999/xlink";
+                const basename = name.slice(index_of_colon + 1);
+                if (value === true) {
+                  node.setAttributeNS(ns, basename, "");
+                } else if (value === false) {
+                  node.removeAttributeNS(ns, basename);
+                } else {
+                  node.setAttributeNS(ns, basename, "" + value);
+                }
+              }
+            } else {
+              if (value === true) {
+                node.setAttribute(name, "");
+              } else if (value === false) {
+                node.removeAttribute(name);
+              } else {
+                node.setAttribute(name, "" + value);
+              }
+            }
+          }
+        }
+      } else if (is_string(arg) || is_number(arg)) {
+        child = document.createTextNode(arg);
+      }
+      if (child != null) {
+        node.appendChild(child);
+      }
+    });
+    return node;
+  };
+  return h;
+};
+var h = _h();
+var s = _h("http://www.w3.org/2000/svg");
+var svg_use = (id, ...args) => s("svg", ["use", { "xlink:href": "#" + id }], ...args);
+var nanolight = (...configs) => (code) => {
+  const result = [];
+  while (code.length > 0) {
+    let best_name;
+    let best_index = Infinity;
+    let best_chunk = "";
+    for (const config of configs) {
+      for (const name in config) {
+        for (const pattern of config[name]) {
+          let index = -1;
+          let chunk = "";
+          if (is_string(pattern) && pattern.length > 0) {
+            index = code.indexOf(pattern);
+            chunk = code.slice(index, index + pattern.length);
+          }
+          if (pattern instanceof RegExp) {
+            const match = code.match(pattern);
+            index = match?.index ?? -1;
+            chunk = match?.[0] ?? "";
+          }
+          if (index >= 0 && chunk.length > 0 && (index < best_index || index === best_index && chunk.length > best_chunk.length)) {
+            best_name = name;
+            best_index = index;
+            best_chunk = chunk;
+          }
+        }
+      }
+    }
+    if (best_name != null) {
+      if (best_index > 0) {
+        result.push(code.slice(0, best_index));
+      }
+      result.push(["span", { class: best_name }, best_chunk]);
+      code = code.slice(best_index + best_chunk.length);
+    } else {
+      result.push(code);
+      break;
+    }
+  }
+  return result;
+};
+var nanolight_ts = nanolight({
+  yellow: [
+    /".*?"/,
+    /'.*?'/,
+    /`[\s\S]*?`/
+  ],
+  grey: [
+    "(",
+    ")",
+    ",",
+    ".",
+    ":",
+    ";",
+    "?",
+    "[",
+    "]",
+    "{",
+    "}",
+    /\/\*[\s\S]*?\*\//,
+    /\/\/.*?(?=\n)/
+  ],
+  red: [
+    "!",
+    "!=",
+    "!==",
+    "%",
+    "%=",
+    "&&",
+    "&&=",
+    "&",
+    "&=",
+    "*",
+    "**",
+    "**=",
+    "*=",
+    "+",
+    "++",
+    "+=",
+    "-",
+    "--",
+    "-=",
+    "/",
+    "/=",
+    ":",
+    "<",
+    "<<",
+    "<<=",
+    "<=",
+    "=",
+    "==",
+    "===",
+    "=>",
+    ">",
+    ">=",
+    ">>",
+    ">>=",
+    ">>>",
+    ">>>=",
+    "?",
+    "??",
+    "??=",
+    "^",
+    "^=",
+    "as",
+    "async",
+    "await",
+    "break",
+    "case",
+    "catch",
+    "class",
+    "const",
+    "continue",
+    "debugger",
+    "default",
+    "delete",
+    "do",
+    "else",
+    "export",
+    "extends",
+    "finally",
+    "for",
+    "from",
+    "function",
+    "function*",
+    "goto",
+    "if",
+    "import",
+    "in",
+    "instanceof",
+    "is",
+    "keyof",
+    "let",
+    "new",
+    "of",
+    "package",
+    "return",
+    "super",
+    "switch",
+    "this",
+    "throw",
+    "try",
+    "type",
+    "typeof",
+    "var",
+    "void",
+    "while",
+    "with",
+    "yield",
+    "yield*",
+    "|",
+    "|=",
+    "||",
+    "||=",
+    "~",
+    "~="
+  ],
+  purple: [
+    "false",
+    "Infinity",
+    "NaN",
+    "null",
+    "true",
+    "undefined",
+    /0b[01_]+/,
+    /0o[01234567_]+/,
+    /0x[\dabcdef_]+/,
+    /[A-Z_$][A-Z0-9_$]+/,
+    /\d[\d_]*(\.[\d_]+)?(e[+-]?[\d_]+)?/
+  ],
+  blue: [
+    "any",
+    "bigint",
+    "boolean",
+    "eval",
+    "number",
+    "string",
+    "symbol",
+    "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) {
@@ -72,110 +356,20 @@ var rwd = (root, selector, cell_width_px, cell_height_px, ...specs) => {
     node.height = `${cell_height_px * height}px`;
   }
 };
-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 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));
-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 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 _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) => {
-    const node = is_string(tag_or_node) ? create_element(tag_or_node) : tag_or_node;
-    args.forEach((arg) => {
-      let child = null;
-      if (arg instanceof Node) {
-        child = arg;
-      } else if (is_array(arg)) {
-        child = h(...arg);
-      } else if (is_record(arg)) {
-        for (const name in arg) {
-          const value = arg[name];
-          if (name[0] === "$") {
-            const name1 = name.slice(1);
-            if (is_record(value)) {
-              node[name1] ??= {};
-              Object.assign(node[name1], value);
-            } else {
-              node[name1] = value;
-            }
-          } else if (node instanceof Element) {
-            const index_of_colon = name.indexOf(":");
-            if (index_of_colon >= 0) {
-              const ns_key = name.slice(0, index_of_colon);
-              if (ns_key === "xlink") {
-                const ns = "http://www.w3.org/1999/xlink";
-                const basename = name.slice(index_of_colon + 1);
-                if (value === true) {
-                  node.setAttributeNS(ns, basename, "");
-                } else if (value === false) {
-                  node.removeAttributeNS(ns, basename);
-                } else {
-                  node.setAttributeNS(ns, basename, "" + value);
-                }
-              }
-            } else {
-              if (value === true) {
-                node.setAttribute(name, "");
-              } else if (value === false) {
-                node.removeAttribute(name);
-              } else {
-                node.setAttribute(name, "" + value);
-              }
-            }
-          }
-        }
-      } else if (is_string(arg) || is_number(arg)) {
-        child = document.createTextNode(arg);
-      }
-      if (child != null) {
-        node.appendChild(child);
-      }
-    });
-    return node;
-  };
-  return h;
+var ZEROS = "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 h = _h();
-var s = _h("http://www.w3.org/2000/svg");
-var svg_use = (id, ...args) => s("svg", ["use", { "xlink:href": "#" + id }], ...args);
-var has_own = (ref, key) => ref != null && Object.hasOwn(ref, key);
-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 js_on_parse = (handlers, text) => JSON.parse(text, (key, value) => {
   if (is_record(value)) {
     let is_second_key = false;
@@ -193,45 +387,24 @@ var js_on_parse = (handlers, text) => JSON.parse(text, (key, value) => {
   }
   return value;
 });
-var nanolight = (pattern, highlighters, code) => {
-  const result = [];
-  code.split(pattern).forEach((chunk, index) => {
-    if (chunk != null && chunk !== "") {
-      index %= highlighters.length;
-      result.push(highlighters[index](chunk, index));
-    }
-  });
-  return result;
-};
-var nanolight_js = nanolight.bind(0, /('.*?'|".*?"|`[\s\S]*?`)|(\/\/.*?\n|\/\*[\s\S]*?\*\/)|(any|bigint|break|boolean|case|catch|class|const|continue|debugger|default|delete|do|else|eval|export|extends|false|finally|for|from|function|goto|if|import|in|instanceof|is|keyof|let|NaN|new|number|null|package|return|string|super|switch|symbol|this|throw|true|try|type|typeof|undefined|unknown|var|void|while|with|yield)(?!\w)|([<>=.?:&|!^~*/%+-])|(0x[\dabcdef_]+|0o[01234567_]+|0b[01_]+|\d[\d_]*(?:\.[\d_]+)?(?:e[+-]?[\d_]+)?)|([$\w]+)(?=\()|([$\wąćęłńóśżźĄĆĘŁŃÓŚŻŹ]+)/, [
-  (chunk) => chunk,
-  (chunk) => ["span", { class: "string" }, chunk],
-  (chunk) => ["span", { class: "comment" }, chunk],
-  (chunk) => ["span", { class: "keyword" }, chunk],
-  (chunk) => ["span", { class: "operator" }, chunk],
-  (chunk) => ["span", { class: "number" }, chunk],
-  (chunk) => ["span", { class: "function" }, chunk],
-  (chunk) => ["span", { class: "literal" }, chunk]
-]);
-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)));
-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 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 ZEROS = "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 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,
@@ -241,7 +414,7 @@ export {
   pl_ural,
   pick,
   omit,
-  nanolight_js,
+  nanolight_ts,
   nanolight,
   js_on_parse,
   is_string,

package/package.json

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

package/readme.md

@@ -28,17 +28,17 @@ import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 
 ## Exports
 
-- [`CNode`](#CNode): Argument type for the `c` helper.
-- [`CRoot`](#CRoot): Argument type for the `c` helper.
-- [`EscapeMap`](#EscapeMap): Argument type accepted by the `escape_values` and `escape` helpers.
-- [`HArgs`](#HArgs): Argument type for the `h` and `s` helpers.
-- [`HArgs1`](#HArgs1): Argument type for the `h` and `s` helpers.
+- [`CNode`](#CNode): Argument type for the [`c`](#c) helper.
+- [`CRoot`](#CRoot): Argument type for the [`c`](#c) helper.
+- [`EscapeMap`](#EscapeMap): Argument type accepted by the [`escape_values`](#escape_values) and [`escape`](#escape) helpers.
+- [`HArgs`](#HArgs): Argument type for the [`h`](#h) and [`s`](#s) helpers.
+- [`HArgs1`](#HArgs1): Argument type for the [`h`](#h) and [`s`](#s) helpers.
 - [`c`](#c): A minimal JS-to-CSS (CSS‑in‑JS) helper.
 - [`csv_parse`](#csv_parse): A tiny CSV parsing helper.
 - [`escape`](#escape): Escapes interpolated template `values` using the provided `escape_map`.
 - [`escape_values`](#escape_values): Escapes array `values` using the provided `escape_map`.
 - [`fix_typography`](#fix_typography): Applies Polish‑specific typographic corrections.
-- [`h`](#h): A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `HTMLElement`s (see also `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): A replacement to the `in` operator (not to be confused with `for-in`).
 - [`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 (excluding `±Infinity` and `NaN`).
@@ -46,14 +46,14 @@ import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 - [`is_record`](#is_record): Checks whether the argument is a plain object record.
 - [`is_string`](#is_string): Checks whether the argument is a string.
 - [`js_on_parse`](#js_on_parse): `JSON.parse` with “JavaScript turned on”.
-- [`nanolight`](#nanolight): Generic syntax highlighting helper (see also `nanolight_js`).
-- [`nanolight_js`](#nanolight_js): JavaScript syntax highlighting helper (built on `nanolight`).
-- [`omit`](#omit): Runtime implementation of TypeScript’s `Omit` (see also `pick`).
-- [`pick`](#pick): Runtime implementation of TypeScript’s `Pick` (see also `omit`).
+- [`nanolight`](#nanolight): Generic syntax highlighting helper (see also [`nanolight_ts`](#nanolight_ts)).
+- [`nanolight_ts`](#nanolight_ts): TypeScript syntax highlighting helper (built on [`nanolight`](#nanolight)).
+- [`omit`](#omit): Runtime implementation of TypeScript’s `Omit` (see also [`pick`](#pick)).
+- [`pick`](#pick): Runtime implementation of TypeScript’s `Pick` (see also [`omit`](#omit)).
 - [`pl_ural`](#pl_ural): Chooses the appropriate Polish noun form based on a numeric value.
 - [`pro`](#pro): A `Proxy`-based helper that safely creates nested structures on access and allows deep assignment without guards.
 - [`rwd`](#rwd): A responsive‑web‑design helper that generates CSS rules for a grid layout.
-- [`s`](#s): A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `SVGElement`s (see also `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: `s('svg', ['use', { 'xlink:href': '#' + id }], ...args)`.
 - [`uuid_v1`](#uuid_v1): Generates a UUID v1 (time-based) identifier.
 
@@ -65,7 +65,7 @@ type CNode = {
 };
 ```
 
-Argument type for the `c` helper.
+Argument type for the [`c`](#c) helper.
 
 ### CRoot
 
@@ -73,7 +73,7 @@ Argument type for the `c` helper.
 type CRoot = Record<PropertyKey, CNode>;
 ```
 
-Argument type for the `c` helper.
+Argument type for the [`c`](#c) helper.
 
 ### EscapeMap
 
@@ -81,7 +81,7 @@ Argument type for the `c` helper.
 type EscapeMap = Map<unknown, (value?: unknown) => string>;
 ```
 
-Argument type accepted by the `escape_values` and `escape` helpers.
+Argument type accepted by the [`escape_values`](#escape_values) and [`escape`](#escape) helpers.
 
 ### HArgs
 
@@ -89,7 +89,7 @@ Argument type accepted by the `escape_values` and `escape` helpers.
 type HArgs = [string | Node, ...HArgs1[]];
 ```
 
-Argument type for the `h` and `s` helpers.
+Argument type for the [`h`](#h) and [`s`](#s) helpers.
 
 ### HArgs1
 
@@ -97,7 +97,7 @@ Argument type for the `h` and `s` helpers.
 type HArgs1 = Record<PropertyKey, unknown> | null | undefined | Node | string | number | HArgs;
 ```
 
-Argument type for the `h` and `s` helpers.
+Argument type for the [`h`](#h) and [`s`](#s) helpers.
 
 ### c
 
@@ -410,7 +410,7 @@ const h: {
 };
 ```
 
-A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `HTMLElement`s (see also `s`).
+A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `HTMLElement`s (see also [`s`](#s)).
 
 - 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.
@@ -584,7 +584,7 @@ expect(is_number(42)).to.be.true
 expect(is_number(Number(42))).to.be.true
 expect(is_number(new Number(42))).to.be.false
 expect(is_number(NaN)).to.be.true
-expect(is_finite_number(Infinity)).to.be.true
+expect(is_number(Infinity)).to.be.true
 ```
 
 ### is_record
@@ -696,39 +696,50 @@ expect(actual).to.deep.equal(expected)
 ### nanolight
 
 ```ts
-const nanolight: (pattern: RegExp, highlighters: ((chunk: string, index: number) => HArgs1)[], code: string) => HArgs1[];
+const nanolight: (...configs: Record<string, (string | RegExp)[]>[]) => (code: string) => HArgs1[];
 ```
 
-Generic syntax highlighting helper (see also `nanolight_js`).
+Generic syntax highlighting helper (see also [`nanolight_ts`](#nanolight_ts)).
 
-### nanolight_js
+Each `config` argument is a mapping of CSS class names to arrays of string or RegExp patterns.
+
+- For any two patterns that match at different positions, the one matching earlier takes precedence.
+- For any two patterns that match at the same position, the longer one takes precedence.
+- For any two patterns that match at the same position and have the same length, the one defined earlier takes precedence.
+
+### nanolight_ts
 
 ```ts
-const nanolight_js: (code: string) => HArgs1[];
+const nanolight_ts: (code: string) => HArgs1[];
 ```
 
-JavaScript syntax highlighting helper (built on `nanolight`).
+TypeScript syntax highlighting helper (built on [`nanolight`](#nanolight)).
 
 #### Usage Examples
 
 ```ts
 const code_js = "const answer_to_life_the_universe_and_everything = { 42: 42 }['42'] /* 42 */"
 
-expect(nanolight_js(code_js)).to.deep.equal([
-  ['span', { class: 'keyword' }, 'const'],
+expect(nanolight_ts(code_js)).to.deep.equal([
+  ['span', { class: 'red' }, 'const'],
+  ' ',
+  ['span', { class: 'white' }, 'answer_to_life_the_universe_and_everything'],
+  ' ',
+  ['span', { class: 'red' }, '='],
+  ' ',
+  ['span', { class: 'grey' }, '{'],
+  ' ',
+  ['span', { class: 'purple' }, '42'],
+  ['span', { class: 'grey' }, ':'],
   ' ',
-  ['span', { class: 'literal' }, 'answer_to_life_the_universe_and_everything'],
+  ['span', { class: 'purple' }, '42'],
   ' ',
-  ['span', { class: 'operator' }, '='],
-  ' { ',
-  ['span', { class: 'number' }, '42'],
-  ['span', { class: 'operator' }, ':'],
+  ['span', { class: 'grey' }, '}'],
+  ['span', { class: 'grey' }, '['],
+  ['span', { class: 'yellow' }, "'42'"],
+  ['span', { class: 'grey' }, ']'],
   ' ',
-  ['span', { class: 'number' }, '42'],
-  ' }[',
-  ['span', { class: 'string' }, "'42'"],
-  '] ',
-  ['span', { class: 'comment' }, '/* 42 */']
+  ['span', { class: 'grey' }, '/* 42 */']
 ])
 ```
 
@@ -738,7 +749,7 @@ expect(nanolight_js(code_js)).to.deep.equal([
 const omit: <T, K extends keyof T>(ref: T, keys: unknown[]) => Omit<T, K>;
 ```
 
-Runtime implementation of TypeScript’s `Omit` (see also `pick`).
+Runtime implementation of TypeScript’s `Omit` (see also [`pick`](#pick)).
 
 #### Usage Examples
 
@@ -754,7 +765,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>;
 ```
 
-Runtime implementation of TypeScript’s `Pick` (see also `omit`).
+Runtime implementation of TypeScript’s `Pick` (see also [`omit`](#omit)).
 
 #### Usage Examples
 
@@ -836,7 +847,7 @@ const rwd: (root: CRoot, selector: string, cell_width_px: number, cell_height_px
 
 A responsive‑web‑design helper that generates CSS rules for a grid layout.
 
-- `root` and `selector` specify where to apply the generated rules (see `c`).
+- `root` and `selector` specify where to apply the generated rules (see [`c`](#c)).
 - `cell_width_px` and `cell_height_px` specify the base cell dimensions in pixels.
 - Each entry in `specs` is a tuple of:
   - `max_width`: maximum number of cells in a row (viewport width breakpoint).
@@ -846,7 +857,7 @@ A responsive‑web‑design helper that generates CSS rules for a grid layout.
 #### Usage Examples
 
 ```ts
-const css: CRoot = {
+const style: CRoot = {
   body: {
     margin: 0
   },
@@ -858,9 +869,9 @@ const css: CRoot = {
   }
 }
 
-rwd(css, '.r6', 200, 50, [6], [3], [1, 1, 2])
+rwd(style, '.r6', 200, 50, [6], [3], [1, 1, 2])
 
-expect(css).to.deep.equal({
+expect(style).to.deep.equal({
   body: {
     margin: 0
   },
@@ -900,7 +911,7 @@ const s: {
 };
 ```
 
-A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `SVGElement`s (see also `h`).
+A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `SVGElement`s (see also [`h`](#h)).
 
 - 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.