@jackens/nnn 2026.8.31 → 2026.9.1

package/nnn.d.ts

@@ -1,69 +1,3 @@
-/**
- * Represents a CSS rule node for the {@link c} helper.
- * Keys are CSS properties or nested selectors.
- */
-export type CNode = {
-    [attributeOrSelector: string]: string | number | CNode | undefined;
-};
-/**
- * Represents the root CSS object for the {@link c} helper.
- * Keys are top-level selectors or at-rules.
- */
-export type CRoot = Record<PropertyKey, CNode>;
-/**
- * A minimal CSS-in-JS helper
- * that converts a JavaScript object hierarchy
- * into a CSS string.
- *
- * @param root
- *
- * An object describing CSS rules.
- * Keys are selectors or at-rules;
- * values are either CSS property values
- * or nested rule objects.
- *
- * @param splitter
- *
- * A delimiter used to create unique keys (default: `'$$'`).
- * The substring from `splitter` to the end of a key
- * is ignored (e.g., `src$$1` → `src`).
- *
- * @returns
- *
- * A CSS string representing the compiled rules.
- *
- * @remarks
- *
- * - Keys whose values are primitives (`string` | `number`)
- *   are treated as CSS properties.
- * - In property keys, uppercase letters
- *   become lowercase with a `-` prefix
- *   (e.g., `fontFamily` → `font-family`);
- *   underscores become hyphens
- *   (e.g., `font_family` → `font-family`).
- * - Comma-separated selector keys
- *   expand into multiple selectors
- *   (e.g., `{ div: { '.a,.b': { margin: 1 } } }` →
- *   `div.a,div.b{margin:1}`).
- * - Top-level keys starting with `@` (at-rules)
- *   are not concatenated with child selectors.
- */
-export declare const c: (root: CRoot, splitter?: string) => string;
-/**
- * Creates a tag function
- * for escaping interpolated values in template literals.
- *
- * @param escapeFn
- *
- * A function that takes a value
- * and returns its escaped string representation.
- *
- * @returns
- *
- * A tag function that escapes interpolated values
- * using the provided escape map.
- */
-export declare const createEscape: (escapeFn: (value: any) => string) => (template: TemplateStringsArray, ...values: unknown[]) => string;
 /**
  * A helper for building simple tokenizers
  * (see also {@link nanolightTs}).
@@ -363,7 +297,7 @@ export declare const jsOnParse: (handlers: Record<PropertyKey, Function>, text:
  * for use with the {@link c} helper
  * and {@link nanolightTs} tokenizer.
  */
-export declare const monokai: CRoot;
+export declare const monokai: CNode;
 /**
  * A TypeScript/JavaScript syntax highlighting tokenizer
  * built using {@link createTokenizer}.
@@ -450,7 +384,7 @@ export declare const pick: <T, K extends keyof T>(ref: T, keys: unknown[]) => Pi
  * - `height` (optional, default `1`):
  *   number of vertical cells the element spans.
  */
-export declare const rwd: (root: CRoot, selector: string, cellWidthPx: number, cellHeightPx: number, ...specs: [number, number?, number?][]) => void;
+export declare const rwd: (root: CNode, selector: string, cellWidthPx: number, cellHeightPx: number, ...specs: [number, number?, number?][]) => void;
 /**
  * Generates a UUID v1 (time-based) identifier.
  *

package/nnn.js

@@ -7,56 +7,56 @@ var isRecord = (arg) => typeof arg === "object" && arg != null && !isArray(arg);
 
 // src/nnn/c.ts
 var DEFAULT_SPLITTER = "$$";
-var getName = (key, splitter = DEFAULT_SPLITTER) => key.split(splitter)[0].replace(/_/g, "-").replace(/([A-Z])/g, (_, letter) => "-" + letter.toLowerCase());
-var _c = (node, prefix, result, splitter) => {
-  const queue = [[node, prefix]];
-  while (queue.length > 0) {
-    const [style0, prefix0] = queue.shift();
-    if (isArray(style0)) {
-      result.push(prefix0, prefix0 !== "" ? "{" : "", style0.join(";"), prefix0 !== "" ? "}" : "");
-    } else {
-      const todo = [];
-      let attributes = [];
-      let attributesPushed = false;
-      for (const key in style0) {
-        const value = style0[key];
-        const name = getName(key, splitter);
-        if (isString(value) || isNumber(value)) {
-          if (!attributesPushed) {
-            attributesPushed = true;
-            attributes = [];
-            todo.push([attributes, prefix0]);
-          }
-          attributes.push(`${name}:${value}`);
-        } else if (value != null) {
-          attributesPushed = false;
-          const prefixN = [];
-          const nameChunks = name.split(",");
-          prefix0.split(",").forEach((prefixChunk) => nameChunks.forEach((nameChunk) => prefixN.push(prefixChunk + nameChunk)));
-          todo.push([value, prefixN.join()]);
-        }
-      }
-      queue.unshift(...todo);
+var combinePrefixAndName = (prefix, name) => {
+  const prefixes = prefix === "" ? [""] : prefix.split(",");
+  const names = name.split(",");
+  const combined = [];
+  for (const p of prefixes) {
+    for (const n of names) {
+      combined.push(p + n);
     }
   }
+  return combined.join(",");
 };
-var c = (root, splitter = DEFAULT_SPLITTER) => {
-  const chunks = [];
-  for (const key in root) {
-    const value = root[key];
-    const name = getName(key, splitter);
-    if (value != null) {
-      if (key[0] === "@") {
-        chunks.push(name + "{");
-        _c(value, "", chunks, splitter);
-        chunks.push("}");
+var _c = (node, splitter = DEFAULT_SPLITTER, prefix = "", flatten = false) => {
+  const out = [];
+  let buffer = [];
+  const flush = () => {
+    if (buffer.length === 0) {
+      return;
+    }
+    out.push(prefix === "" ? buffer.join(";") : `${prefix}{${buffer.join(";")}}`);
+    buffer = [];
+  };
+  for (const [rawKey, value] of Object.entries(node)) {
+    if (value == null) {
+      continue;
+    }
+    const splitterIndex = rawKey.indexOf(splitter);
+    const name = splitterIndex < 0 ? rawKey : rawKey.slice(0, splitterIndex);
+    if (isNumber(value) || isString(value)) {
+      if (flatten) {
+        out.push(`${prefix + name}:${value}`);
       } else {
-        _c(value, name, chunks, splitter);
+        buffer.push(`${name}:${value}`);
       }
+      continue;
+    }
+    if (flatten) {
+      out.push(_c(value, splitter, prefix + name, true));
+      continue;
+    }
+    flush();
+    if (prefix === "" && (name === ":root" || name[0] === "@")) {
+      out.push(`${name}{${_c(value, splitter, "", name === ":root")}}`);
+    } else {
+      out.push(_c(value, splitter, combinePrefixAndName(prefix, name), false));
     }
   }
-  return chunks.join("");
+  flush();
+  return out.join(flatten ? ";" : "");
 };
+var c = (node, splitter = DEFAULT_SPLITTER) => _c(node, splitter);
 // src/nnn/createEscape.ts
 var createEscape = (escapeFn) => (template, ...values) => String.raw(template, ...values.map(escapeFn));
 // src/nnn/createTokenizer.ts
@@ -201,51 +201,38 @@ var fixPlTypography = (node) => {
 };
 // src/nnn/hasOwn.ts
 var hasOwn = (ref, key) => ref != null && Object.hasOwn(ref, key);
-// src/nnn/jsOnParse.ts
-var jsOnParse = (handlers, text) => JSON.parse(text, (key, value) => {
-  if (isRecord(value)) {
-    let isSecondKey = false;
-    for (key in value) {
-      if (isSecondKey) {
-        return value;
-      }
-      isSecondKey = true;
-    }
-    const handler = handlers[key];
-    const params = value[key];
-    if (handler instanceof Function && isArray(params)) {
-      return handler(...params);
-    }
-  }
-  return value;
-});
 // src/nnn/monokai.ts
-var darkKey = "@media only screen and (prefers-color-scheme: dark)" + "$$monokai";
 var monokai = {
   ":root$$monokai": {
-    __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"
+    "--": {
+      bg: "#faf4f2",
+      fg: "#29242a",
+      comment: "#918c8e",
+      identifier: {
+        1: "#7058be",
+        2: "#269d69",
+        3: "#1c8ca8",
+        4: "#29242a"
+      },
+      keyword: {
+        1: "#e14775",
+        2: "#7058be",
+        3: "#1c8ca8"
+      },
+      number: "#7058be",
+      operator: "#e14775",
+      punctuation: "#918c8e",
+      string: "#cc7a0a"
+    }
   },
   pre$$monokai: {
-    backgroundColor: "var(--bg)",
+    "background-color": "var(--bg)",
     color: "var(--fg)",
     margin: 0,
     padding: "1em",
     overflow: "visible",
     " code": {
-      fontFamily: '"Source Code Pro"',
+      "font-family": '"Source Code Pro"',
       padding: 0
     }
   },
@@ -253,51 +240,61 @@ var monokai = {
     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)" },
+    identifier: {
+      1: { color: "var(--identifier1)" },
+      2: { color: "var(--identifier2)" },
+      3: { color: "var(--identifier3)" },
+      4: { color: "var(--identifier4)" }
+    },
+    keyword: {
+      1: { color: "var(--keyword1)" },
+      2: { color: "var(--keyword2)" },
+      3: { color: "var(--keyword3)" }
+    },
     number: { color: "var(--number)" },
     operator: { color: "var(--operator)" },
     punctuation: { color: "var(--punctuation)" },
     string: { color: "var(--string)" }
   },
-  [darkKey]: {
+  "@media only screen and (prefers-color-scheme: dark)$$monokai": {
     ":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"
+      "--": {
+        bg: "#2d2a2e",
+        fg: "#fcfcfa",
+        comment: "#727072",
+        identifier: {
+          1: "#ae81ff",
+          2: "#a9dc76",
+          3: "#66d9ef",
+          4: "#fcfcfa"
+        },
+        keyword: {
+          1: "#ff6188",
+          2: "#ae81ff",
+          3: "#66d9ef"
+        },
+        number: "#ae81ff",
+        operator: "#ff6188",
+        punctuation: "#727072",
+        string: "#ffd866"
+      }
     }
   }
 };
 // src/nnn/nanolightTs.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 IDENTIFIER1 = "identifier1";
+var IDENTIFIER2 = "identifier2";
+var IDENTIFIER3 = "identifier3";
+var IDENTIFIER4 = "identifier4";
+var KEYWORD1 = "keyword1";
+var KEYWORD2 = "keyword2";
+var KEYWORD3 = "keyword3";
 var NUMBER = "number";
 var OPERATOR = "operator";
 var PUNCTUATION = "punctuation";
 var STRING = "string";
-var nanolightTs = /* @__PURE__ */ createTokenizer((chunk, name) => name != null ? ["span", { class: name }, chunk] : chunk, [COMMENT, /\/\*.*?\*\//s], [COMMENT, /(?<!\\)\/\/.*?(?=\n)/], [STRING, /".*?"/], [STRING, /'.*?'/], [STRING, /`.*?`/s], [STRING, /\/[^\s]*[^\\]\/[dgimsuvy]*/], [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]);
+var nanolightTs = /* @__PURE__ */ createTokenizer((chunk, name) => name != null ? ["span", { class: name }, chunk] : chunk, [COMMENT, /\/\*.*?\*\//s], [COMMENT, /(?<!\\)\/\/.*?(?=\n)/], [STRING, /".*?"/], [STRING, /'.*?'/], [STRING, /`.*?`/s], [STRING, /\/[^\s]*[^\\]\/[dgimsuvy]*/], [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, "}"], [KEYWORD1, "as"], [KEYWORD1, "async"], [KEYWORD1, "await"], [KEYWORD1, "break"], [KEYWORD1, "case"], [KEYWORD1, "catch"], [KEYWORD1, "class"], [KEYWORD1, "const"], [KEYWORD1, "continue"], [KEYWORD1, "debugger"], [KEYWORD1, "default"], [KEYWORD1, "delete"], [KEYWORD1, "do"], [KEYWORD1, "else"], [KEYWORD1, "export"], [KEYWORD1, "extends"], [KEYWORD1, "finally"], [KEYWORD1, "for"], [KEYWORD1, "from"], [KEYWORD1, "function"], [KEYWORD1, "function*"], [KEYWORD1, "goto"], [KEYWORD1, "if"], [KEYWORD1, "import"], [KEYWORD1, "in"], [KEYWORD1, "instanceof"], [KEYWORD1, "is"], [KEYWORD1, "keyof"], [KEYWORD1, "let"], [KEYWORD1, "new"], [KEYWORD1, "of"], [KEYWORD1, "package"], [KEYWORD1, "return"], [KEYWORD1, "super"], [KEYWORD1, "switch"], [KEYWORD1, "this"], [KEYWORD1, "throw"], [KEYWORD1, "try"], [KEYWORD1, "type"], [KEYWORD1, "typeof"], [KEYWORD1, "var"], [KEYWORD1, "void"], [KEYWORD1, "while"], [KEYWORD1, "with"], [KEYWORD1, "yield"], [KEYWORD1, "yield*"], [KEYWORD2, "false"], [KEYWORD2, "Infinity"], [KEYWORD2, "NaN"], [KEYWORD2, "null"], [KEYWORD2, "true"], [KEYWORD2, "undefined"], [KEYWORD3, "any"], [KEYWORD3, "bigint"], [KEYWORD3, "boolean"], [KEYWORD3, "eval"], [KEYWORD3, "number"], [KEYWORD3, "string"], [KEYWORD3, "symbol"], [KEYWORD3, "unknown"], [IDENTIFIER1, /[\p{Lu}_$][\p{Lu}\d_$]*/u], [IDENTIFIER2, /[\p{L}_$][\p{L}\d_$]*(?=[(`])/u], [IDENTIFIER3, /\p{Lu}[\p{L}\d_$]*/u], [IDENTIFIER4, /[\p{L}_$][\p{L}\d_$]*/u]);
 // src/nnn/omit.ts
 var omit = (ref, keys) => Object.fromEntries(Object.entries(ref).filter(([key]) => !keys.includes(key)));
 // src/nnn/pick.ts
@@ -368,7 +365,6 @@ export {
   isNumber,
   isRecord,
   isString,
-  jsOnParse,
   monokai,
   nanolightTs,
   omit,

package/package.json

@@ -20,8 +20,6 @@
     "isRecord",
     "isString",
     "JS-to-CSS",
-    "jsOnParse",
-    "JSON",
     "Monokai",
     "nanolight",
     "nnn",
@@ -43,5 +41,5 @@
   "name": "@jackens/nnn",
   "type": "module",
   "types": "nnn.d.ts",
-  "version": "2026.8.31"
+  "version": "2026.9.1"
 }

package/readme.md

@@ -1,6 +1,6 @@
 # nnn
 
-A collection of Jackens’ JavaScript helper utilities (version: `2026.8.31`).
+A collection of Jackens’ JavaScript helper utilities (version: `2026.9.1`).
 
 ## Installation
 
@@ -18,8 +18,6 @@ npm i @jackens/nnn
 
 ```js
 import {
-  c,
-  createEscape,
   createTokenizer,
   csvParse,
   fixPlTypography,
@@ -46,23 +44,12 @@ import {
 
 ## Exports
 
-- [`CNode`](#CNode):
-  Represents a CSS rule node for the [`c`](#c) helper.
-- [`CRoot`](#CRoot):
-  Represents the root CSS object for the [`c`](#c) helper.
 - [`HArgs`](#HArgs):
   Tuple argument type for the [`h`](#h) and [`s`](#s)
   helpers.
 - [`HArgs1`](#HArgs1):
   Single argument type for the [`h`](#h) and [`s`](#s)
   helpers.
-- [`c`](#c):
-  A minimal CSS-in-JS helper
-  that converts a JavaScript object hierarchy
-  into a CSS string.
-- [`createEscape`](#createEscape):
-  Creates a tag function
-  for escaping interpolated values in template literals.
 - [`createTokenizer`](#createTokenizer):
   A helper for building simple tokenizers
   (see also [`nanolightTs`](#nanolightTs)).
@@ -99,7 +86,7 @@ import {
   handler-based value transformation (“JavaScript ON”).
 - [`monokai`](#monokai):
   A Monokai-inspired color scheme
-  for use with the [`c`](#c) helper
+  for use with the {@link c} helper
   and [`nanolightTs`](#nanolightTs) tokenizer.
 - [`nanolightTs`](#nanolightTs):
   A TypeScript/JavaScript syntax highlighting tokenizer
@@ -126,26 +113,6 @@ import {
   A Proxy-based helper for auto-vivification
   of nested object structures.
 
-### CNode
-
-```ts
-type CNode = {
-    [attributeOrSelector: string]: string | number | CNode | undefined;
-};
-```
-
-Represents a CSS rule node for the [`c`](#c) helper.
-Keys are CSS properties or nested selectors.
-
-### CRoot
-
-```ts
-type CRoot = Record<PropertyKey, CNode>;
-```
-
-Represents the root CSS object for the [`c`](#c) helper.
-Keys are top-level selectors or at-rules.
-
 ### HArgs
 
 ```ts
@@ -164,303 +131,6 @@ type HArgs1 = Record<PropertyKey, unknown> | null | undefined | Node | string |
 Single argument type for the [`h`](#h) and [`s`](#s)
 helpers.
 
-### c
-
-```ts
-const c: (root: CRoot, splitter?: string) => string;
-```
-
-A minimal CSS-in-JS helper
-that converts a JavaScript object hierarchy
-into a CSS string.
-
-#### root
-
-An object describing CSS rules.
-Keys are selectors or at-rules;
-values are either CSS property values
-or nested rule objects.
-
-#### splitter
-
-A delimiter used to create unique keys (default: `'$$'`).
-The substring from `splitter` to the end of a key
-is ignored (e.g., `src$$1` → `src`).
-
-#### Returns
-
-A CSS string representing the compiled rules.
-
-#### Remarks
-
-- Keys whose values are primitives (`string` | `number`)
-  are treated as CSS properties.
-- In property keys, uppercase letters
-  become lowercase with a `-` prefix
-  (e.g., `fontFamily` → `font-family`);
-  underscores become hyphens
-  (e.g., `font_family` → `font-family`).
-- Comma-separated selector keys
-  expand into multiple selectors
-  (e.g., `{ div: { '.a,.b': { margin: 1 } } }` →
-  `div.a,div.b{margin:1}`).
-- Top-level keys starting with `@` (at-rules)
-  are not concatenated with child selectors.
-
-#### Usage Examples
-
-```ts
-const actual1 = c({
-  a: {
-    color: 'red',
-    margin: 1,
-    '.c': { margin: 2, padding: 2 },
-    padding: 1,
-  },
-})
-
-const expected1 = `
-a{
-  color:red;
-  margin:1
-}
-a.c{
-  margin:2;
-  padding:2
-}
-a{
-  padding:1
-}`.replace(/\n\s*/g, '')
-
-expect(actual1).to.equal(expected1)
-
-const actual2 = c({
-  a: {
-    '.b': {
-      color: 'red',
-      margin: 1,
-      '.c': { margin: 2, padding: 2 },
-      padding: 1,
-    },
-  },
-})
-
-const expected2 = `
-a.b{
-  color:red;
-  margin:1
-}
-a.b.c{
-  margin:2;
-  padding:2
-}
-a.b{
-  padding:1
-}`.replace(/\n\s*/g, '')
-
-expect(actual2).to.equal(expected2)
-
-const actual3 = c({
-  '@font-face$$1': {
-    fontFamily: 'Jackens',
-    src$$1: 'url(otf/jackens.otf)',
-    src$$2:
-      "url(otf/jackens.otf) format('opentype')," +
-      "url(svg/jackens.svg) format('svg')",
-    font_weight: 'normal',
-    'font-style': 'normal',
-  },
-  '@font-face$$2': {
-    font_family: 'C64',
-    src: 'url(fonts/C64_Pro_Mono-STYLE.woff)',
-  },
-  '@keyframes spin': {
-    '0%': { transform: 'rotate(0deg)' },
-    '100%': { transform: 'rotate(360deg)' },
-  },
-  div: {
-    border: 'solid red 1px',
-    '.c1': { 'background-color': '#000' },
-    ' .c1': { background_color: 'black' },
-    '.c2': { backgroundColor: 'rgb(0,0,0)' },
-  },
-  '@media(min-width:200px)': {
-    div: { margin: 0, padding: 0 },
-    span: { color: '#000' },
-  },
-})
-
-const expected3 = `
-@font-face{
-  font-family:Jackens;
-  src:url(otf/jackens.otf);
-  src:url(otf/jackens.otf) format('opentype'),url(svg/jackens.svg) format('svg');
-  font-weight:normal;
-  font-style:normal
-}
-@font-face{
-  font-family:C64;
-  src:url(fonts/C64_Pro_Mono-STYLE.woff)
-}
-@keyframes spin{
-  0%{
-    transform:rotate(0deg)
-  }
-  100%{
-    transform:rotate(360deg)
-  }
-}
-div{
-  border:solid red 1px
-}
-div.c1{
-  background-color:#000
-}
-div .c1{
-  background-color:black
-}
-div.c2{
-  background-color:rgb(0,0,0)
-}
-@media(min-width:200px){
-  div{
-    margin:0;
-    padding:0
-  }
-  span{
-    color:#000
-  }
-}`.replace(/\n\s*/g, '')
-
-expect(actual3).to.equal(expected3)
-
-const actual4 = c({
-  a: {
-    '.b,.c': {
-      margin: 1,
-      '.d': {
-        margin: 2,
-      },
-    },
-  },
-})
-
-const expected4 = `
-a.b,a.c{
-  margin:1
-}
-a.b.d,a.c.d{
-  margin:2
-}`.replace(/\n\s*/g, '')
-
-expect(actual4).to.equal(expected4)
-
-const actual5 = c({
-  '.b,.c': {
-    margin: 1,
-    '.d': {
-      margin: 2,
-    },
-  },
-})
-
-const expected5 = `
-.b,.c{
-  margin:1
-}
-.b.d,.c.d{
-  margin:2
-}`.replace(/\n\s*/g, '')
-
-expect(actual5).to.equal(expected5)
-
-const actual6 = c({
-  '.a,.b': {
-    margin: 1,
-    '.c,.d': {
-      margin: 2,
-    },
-  },
-})
-
-const expected6 = `
-.a,.b{
-  margin:1
-}
-.a.c,.a.d,.b.c,.b.d{
-  margin:2
-}`.replace(/\n\s*/g, '')
-
-expect(actual6).to.equal(expected6)
-```
-
-### createEscape
-
-```ts
-const createEscape: (escapeFn: (value: any) => string) => (template: TemplateStringsArray, ...values: unknown[]) => string;
-```
-
-Creates a tag function
-for escaping interpolated values in template literals.
-
-#### escapeFn
-
-A function that takes a value
-and returns its escaped string representation.
-
-#### Returns
-
-A tag function that escapes interpolated values
-using the provided escape map.
-
-#### Usage Examples
-
-```ts
-const escapeFn = (value: any): string =>
-  isArray(value)
-    ? value.map(escapeFn).join(', ')
-    : value === true || value === false
-      ? `b'${+value}'`
-      : value instanceof Date
-        ? `'${value
-            .toISOString()
-            .replace(/^(.+)T(.+)\..*$/, '$1 $2')}'`
-        : isFiniteNumber(value)
-          ? `${value}`
-          : isString(value)
-            ? `'${value.replace(/'/g, "''")}'`
-            : 'NULL'
-
-const sql = createEscape(escapeFn)
-
-const actual = sql`
-  SELECT *
-  FROM table_name
-  WHERE column_name IN (
-    ${[
-      true,
-      null,
-      undefined,
-      NaN,
-      Infinity,
-      42,
-      '42',
-      "4'2",
-      /42/,
-      new Date(323325000000),
-    ]}
-  )`
-
-const expected = `
-  SELECT *
-  FROM table_name
-  WHERE column_name IN (
-    b'1', NULL, NULL, NULL, NULL, 42, '42', '4''2', NULL, '1980-03-31 04:30:00'
-  )`
-
-expect(actual).to.equal(expected)
-```
-
 ### createTokenizer
 
 ```ts
@@ -483,9 +153,9 @@ For unmatched text between patterns,
 
 An array of tuples `[metadata, pattern]` where:
 - `metadata`: arbitrary data (e.g., a CSS class name)
-  passed to `decorator` when the pattern matches.
+passed to `decorator` when the pattern matches.
 - `pattern`: a `string` or `RegExp`
-  to match against the input.
+to match against the input.
 
 #### Returns
 
@@ -495,11 +165,11 @@ and returns an array of decorated tokens.
 #### Remarks
 
 1. Matches starting at an earlier position
-   take precedence.
+ take precedence.
 2. Among matches at the same position,
-   the longer one wins.
+ the longer one wins.
 3. Among matches of the same position and length,
-   the one defined earlier wins.
+ the one defined earlier wins.
 
 #### Usage Examples
 
@@ -725,14 +395,14 @@ If a `Node`, that node is modified in place.
 
 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.
+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.
+and appended.
 - [`HArgs`](#HArgs) array: processed recursively.
 
 #### Returns
@@ -1137,93 +807,14 @@ The JSON string to parse.
 
 The parsed value with handler substitutions applied.
 
-#### Usage Examples
-
-```ts
-const handlers = {
-  $add: (a: number, b: number) => a + b,
-  $hello: (name: string) => `Hello ${name}!`,
-  $foo: () => 'bar',
-}
-
-const actual1 = jsOnParse(
-  handlers,
-  `[
-  {
-    "$add": [1, 2]
-  },
-  {
-    "$hello": ["World"]
-  },
-  {
-    "nested": {
-      "$hello": ["nested World"]
-    },
-    "one": 1,
-    "two": 2
-  },
-  {
-    "$foo": []
-  },
-  {
-    "$foo": ["The parent object does not have exactly one property!"],
-    "one": 1,
-    "two": 2
-  }
-]`
-)
-
-expect(actual1).to.deep.equal([
-  3,
-  'Hello World!',
-  {
-    nested: 'Hello nested World!',
-    one: 1,
-    two: 2,
-  },
-  'bar',
-  {
-    $foo: [
-      'The parent object does not have ' +
-        'exactly one property!',
-    ],
-    one: 1,
-    two: 2,
-  },
-])
-
-const actual2 = jsOnParse(
-  { $notFunc: 'handler not being a function' } as any,
-  '{"$notFunc": [1, 2]}'
-)
-
-expect(actual2).to.deep.equal({ $notFunc: [1, 2] })
-
-const actual3 = jsOnParse(
-  handlers,
-  '{"$unknown_handler_key": [1, 2]}'
-)
-
-expect(actual3).to.deep.equal({
-  $unknown_handler_key: [1, 2],
-})
-
-const actual4 = jsOnParse(
-  handlers,
-  '{"$add": {"not": "array"}}'
-)
-
-expect(actual4).to.deep.equal({ $add: { not: 'array' } })
-```
-
 ### monokai
 
 ```ts
-const monokai: CRoot;
+const monokai: CNode;
 ```
 
 A Monokai-inspired color scheme
-for use with the [`c`](#c) helper
+for use with the {@link c} helper
 and [`nanolightTs`](#nanolightTs) tokenizer.
 
 ### nanolightTs
@@ -1252,11 +843,11 @@ const codeJs =
   "{ 42: 42 }['42'] /* 42 */"
 
 expect(nanolightTs(codeJs)).to.deep.equal([
-  ['span', { class: 'keyword-1' }, 'const'],
+  ['span', { class: 'keyword1' }, 'const'],
   ' ',
   [
     'span',
-    { class: 'identifier-4' },
+    { class: 'identifier4' },
     'answerToLifeTheUniverseAndEverything',
   ],
   ' ',
@@ -1350,7 +941,7 @@ expect(pick(ref, ['a', 'b'])).to.deep.equal({
 ### rwd
 
 ```ts
-const rwd: (root: CRoot, selector: string, cellWidthPx: number, cellHeightPx: number, ...specs: [number, number?, number?][]) => void;
+const rwd: (root: CNode, selector: string, cellWidthPx: number, cellHeightPx: number, ...specs: [number, number?, number?][]) => void;
 ```
 
 A responsive web design helper
@@ -1358,7 +949,7 @@ that generates CSS rules for a grid-like layout.
 
 #### root
 
-The CSS root object to populate (see [`c`](#c)).
+The CSS root object to populate (see {@link c}).
 
 #### selector
 
@@ -1376,16 +967,16 @@ The base cell height in pixels.
 
 An array of breakpoint specifications, each a tuple of:
 - `maxWidth`: maximum number of cells per row
-  (defines the viewport breakpoint).
+(defines the viewport breakpoint).
 - `width` (optional, default `1`):
-  number of horizontal cells the element spans.
+number of horizontal cells the element spans.
 - `height` (optional, default `1`):
-  number of vertical cells the element spans.
+number of vertical cells the element spans.
 
 #### Usage Examples
 
 ```ts
-const style: CRoot = {
+const style: CNode = {
   body: {
     margin: 0,
   },
@@ -1453,14 +1044,14 @@ If a `Node`, that node is modified in place.
 
 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.
+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.
+and appended.
 - [`HArgs`](#HArgs) array: processed recursively.
 
 #### Returns