@jackens/nnn 2025.12.13 → 2025.12.23

package/nnn.d.ts

@@ -62,7 +62,6 @@ export declare const c: (root: CRoot, splitter?: string) => string;
  * - `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.
  *
@@ -81,11 +80,10 @@ export declare const rwd: (root: CRoot, selector: string, cell_width_px: number,
  * A 2D array where each inner array represents a row of fields.
  */
 export declare const csv_parse: (csv: string, separator?: string) => string[][];
-
 /**
  * A map from value constructors (or `null`/`undefined`) to escape functions.
  *
- * Used by {@link escape_values} and {@link escape}.
+ * Used by {@link escape_values} and {@link new_escape}.
  */
 export type EscapeMap = Map<unknown, (value?: unknown) => string>;
 /**
@@ -105,26 +103,17 @@ export type EscapeMap = Map<unknown, (value?: unknown) => string>;
  */
 export declare const escape_values: (escape_map: EscapeMap, values: unknown[]) => string[];
 /**
- * Escapes interpolated values in a tagged template literal using the provided escape map.
+ * Creates a tag function for escaping interpolated values in template literals.
  *
  * @param escape_map
  *
  * A map where keys are constructors and values are escape functions.
  *
- * @param template
- *
- * The template strings array from the tagged template.
- *
- * @param values
- *
- * The interpolated values to escape.
- *
  * @returns
  *
- * The resulting string with all interpolated values escaped.
+ * A tag function that escapes interpolated values using the provided escape map.
  */
-export declare const escape: (escape_map: EscapeMap, template: TemplateStringsArray, ...values: unknown[]) => string;
-
+export declare const new_escape: (escape_map: EscapeMap) => (template: TemplateStringsArray, ...values: unknown[]) => string;
 /**
  * Applies Polish-specific typographic corrections to a DOM subtree.
  *
@@ -138,7 +127,6 @@ export declare const escape: (escape_map: EscapeMap, template: TemplateStringsAr
  * 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.
  */
@@ -221,7 +209,6 @@ export declare const s: {
  * An `SVGSVGElement` containing a `<use>` element.
  */
 export declare const svg_use: (id: string, ...args: HArgs1[]) => SVGSVGElement;
-
 /**
  * Checks whether an object has the specified key as its own property.
  *
@@ -240,7 +227,6 @@ export declare const svg_use: (id: string, ...args: HArgs1[]) => SVGSVGElement;
  * `true` if `ref` is not nullish and has `key` as an own property, `false` otherwise.
  */
 export declare const has_own: (ref: unknown, key: unknown) => boolean;
-
 /**
  * Checks whether the argument is an array.
  *
@@ -301,7 +287,6 @@ 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;
-
 /**
  * Parses JSON with support for handler-based value transformation (“JavaScript ON”).
  *
@@ -321,7 +306,19 @@ export declare const is_string: (arg: unknown) => arg is string;
  * The parsed value with handler substitutions applied.
  */
 export declare const js_on_parse: (handlers: Record<PropertyKey, Function>, text: string) => any;
-
+/**
+ * A Monokai-inspired color scheme for use with the {@link c} helper and {@link nanolight_ts} tokenizer.
+ *
+ * Defines CSS custom properties for eight colors (`--black`, `--blue`, `--green`, `--grey`,
+ * `--purple`, `--red`, `--white`, `--yellow`) with both light and dark mode variants.
+ *
+ * @remarks
+ *
+ * - In light mode, `--black` is a light background and `--white` is dark text.
+ * - In dark mode (via `prefers-color-scheme: dark`), the palette inverts to a dark background with light text.
+ * - Includes base styles for `body`, `pre` and `code>span.*` (syntax highlighting).
+ */
+export declare const monokai: CRoot;
 /**
  * A TypeScript/JavaScript syntax highlighting tokenizer built using {@link new_tokenizer}.
  *
@@ -331,37 +328,34 @@ export declare const js_on_parse: (handlers: Record<PropertyKey, Function>, text
  *
  * @returns
  *
- * An array of {@link HArgs1} elements suitable for rendering with {@link h} or {@link s}.
+ * An array of {@link HArgs1} elements suitable for rendering with {@link h}.
  */
 export declare const nanolight_ts: (code: string) => HArgs1[];
-
 /**
- * A helper for building simple tokenizers (see also {@link nanolight_ts}).
+ * Creates a function that returns the appropriate Polish noun form based on a numeric value.
  *
- * @param decorator
+ * 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.
  *
- * 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 singular
  *
- * @param specs
+ * The singular form (e.g., “auto” for “car”).
  *
- * 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.
+ * @param plural_2
  *
- * @returns
+ * The form for 2, 3, 4 (e.g., “auta”).
  *
- * A tokenizer function that accepts a code string and returns an array of decorated tokens.
+ * @param plural_5
  *
- * @remarks
+ * The form for 5+ (e.g., “aut”).
  *
- * 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.
+ * @returns
+ *
+ * A function that takes a numeric value and returns the appropriate noun form.
  */
-export declare const new_tokenizer: <M, T>(decorator: (chunk: string, metadata?: M) => T, ...specs: [M, string | RegExp][]) => (code: string) => T[];
-
+export declare const new_noun_form: (singular: string, plural_2: string, plural_5: string) => (value: number) => string;
 /**
  * Creates a new object containing only the specified keys from the source object.
  *
@@ -398,53 +392,47 @@ 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
+ * A Proxy-based helper for auto-vivification of nested object structures.
  *
- * The form for 5+ (e.g., “aut”).
+ * 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 value
+ * @param ref
  *
- * The numeric value to evaluate.
+ * The root object to wrap.
  *
  * @returns
  *
- * The appropriate noun form for the given value.
+ * A proxy that auto-creates nested objects on property access.
  */
-export declare const pl_ural: (singular: string, plural_2: string, plural_5: string, value: number) => string;
-
+export declare const pro: (ref: unknown) => any;
 /**
- * A Proxy-based helper for auto-vivification of nested object structures.
+ * A helper for building simple tokenizers (see also {@link nanolight_ts}).
  *
- * 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 decorator
  *
- * @param ref
+ * 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`.
  *
- * The root object to wrap.
+ * @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 proxy that auto-creates nested objects on property access.
+ * 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 pro: (ref: unknown) => any;
-
+export declare const new_tokenizer: <M, T>(decorator: (chunk: string, metadata?: M) => T, ...specs: [M, string | RegExp][]) => (code: string) => T[];
 /**
  * Generates a UUID v1 (time-based) identifier.
  *

package/nnn.js

@@ -94,7 +94,7 @@ var csv_parse = (csv, separator = ",") => {
 };
 // 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));
+var new_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);
@@ -209,7 +209,54 @@ var js_on_parse = (handlers, text) => JSON.parse(text, (key, value) => {
   }
   return value;
 });
-// src/nnn/new_tokenizer.ts
+// src/nnn/monokai.ts
+var monokai = {
+  ":root": {
+    __black: "$faf4f2",
+    __blue: "#1c8ca8",
+    __green: "#269d69",
+    __grey: "#918c8e",
+    __purple: "#7058be",
+    __red: "#e14775",
+    __white: "#29242a",
+    __yellow: "#cc7a0a"
+  },
+  body$$monokai: {
+    backgroundColor: "var(--black)",
+    color: "var(--white)"
+  },
+  "code>span.": {
+    black: { color: "var(--black)" },
+    blue: { color: "var(--blue)" },
+    green: { color: "var(--green)" },
+    grey: { color: "var(--grey)" },
+    purple: { color: "var(--purple)" },
+    red: { color: "var(--red)" },
+    white: { color: "var(--white)" },
+    yellow: { color: "var(--yellow)" }
+  },
+  pre: {
+    margin: 0,
+    overflow: "visible",
+    " code": {
+      fontFamily: '"Source Code Pro"',
+      padding: 0
+    }
+  },
+  "@media only screen and (prefers-color-scheme: dark)": {
+    ":root": {
+      __black: "#2d2a2e",
+      __blue: "#66d9ef",
+      __green: "#a9dc76",
+      __grey: "#727072",
+      __purple: "#ae81ff",
+      __red: "#ff6188",
+      __white: "#fcfcfa",
+      __yellow: "#ffd866"
+    }
+  }
+};
+// src/nnn/tokenizer.ts
 var new_tokenizer = (decorator, ...specs) => (code) => {
   const result = [];
   while (code.length > 0) {
@@ -256,16 +303,16 @@ var PURPLE = "purple";
 var RED = "red";
 var WHITE = "white";
 var YELLOW = "yellow";
-var nanolight_ts = /* @__PURE__ */ new_tokenizer((chunk, name) => name != null ? ["span", { class: name }, chunk] : chunk, [YELLOW, /".*?"/], [YELLOW, /'.*?'/], [YELLOW, /`[\s\S]*?`/], [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) => {
+var nanolight_ts = /* @__PURE__ */ new_tokenizer((chunk, name) => name != null ? ["span", { class: name }, chunk] : chunk, [YELLOW, /".*?"/], [YELLOW, /'.*?'/], [YELLOW, /`[\s\S]*?`/], [RED, "?"], [RED, /(?<=\s):/], [GREY, "("], [GREY, ")"], [GREY, ","], [GREY, "."], [GREY, ":"], [GREY, ";"], [GREY, "?."], [GREY, "["], [GREY, "]"], [GREY, "{"], [GREY, "}"], [GREY, /\/\*[\s\S]*?\*\//], [GREY, /(?<!\\)\/\/.*?(?=\n)/], [RED, "!"], [RED, "!="], [RED, "!=="], [RED, "%"], [RED, "%="], [RED, "&&"], [RED, "&&="], [RED, "&"], [RED, "&="], [RED, "*"], [RED, "**"], [RED, "**="], [RED, "*="], [RED, "+"], [RED, "++"], [RED, "+="], [RED, "-"], [RED, "--"], [RED, "-="], [RED, "..."], [RED, "/"], [RED, "/="], [RED, ":"], [RED, "<"], [RED, "<<"], [RED, "<<="], [RED, "<="], [RED, "="], [RED, "=="], [RED, "==="], [RED, "=>"], [RED, ">"], [RED, ">="], [RED, ">>"], [RED, ">>="], [RED, ">>>"], [RED, ">>>="], [RED, "?"], [RED, "??"], [RED, "??="], [RED, "^"], [RED, "^="], [RED, "as"], [RED, "async"], [RED, "await"], [RED, "break"], [RED, "case"], [RED, "catch"], [RED, "class"], [RED, "const"], [RED, "continue"], [RED, "debugger"], [RED, "default"], [RED, "delete"], [RED, "do"], [RED, "else"], [RED, "export"], [RED, "extends"], [RED, "finally"], [RED, "for"], [RED, "from"], [RED, "function"], [RED, "function*"], [RED, "goto"], [RED, "if"], [RED, "import"], [RED, "in"], [RED, "instanceof"], [RED, "is"], [RED, "keyof"], [RED, "let"], [RED, "new"], [RED, "of"], [RED, "package"], [RED, "return"], [RED, "super"], [RED, "switch"], [RED, "this"], [RED, "throw"], [RED, "try"], [RED, "type"], [RED, "typeof"], [RED, "var"], [RED, "void"], [RED, "while"], [RED, "with"], [RED, "yield"], [RED, "yield*"], [RED, "|"], [RED, "|="], [RED, "||"], [RED, "||="], [RED, "~"], [RED, "~="], [PURPLE, "false"], [PURPLE, "Infinity"], [PURPLE, "NaN"], [PURPLE, "null"], [PURPLE, "true"], [PURPLE, "undefined"], [PURPLE, /0b[01_]+/], [PURPLE, /0o[01234567_]+/], [PURPLE, /0x[\dabcdef_]+/], [PURPLE, /[\p{Lu}_$][\p{Lu}\d_$]+/u], [PURPLE, /\d[\d_]*(\.[\d_]+)?(e[+-]?[\d_]+)?/], [BLUE, "any"], [BLUE, "bigint"], [BLUE, "boolean"], [BLUE, "eval"], [BLUE, "number"], [BLUE, "string"], [BLUE, "symbol"], [BLUE, "unknown"], [GREEN, /[\p{L}_$][\p{L}\d_$]+(?=\()/u], [BLUE, /\p{Lu}[\p{L}\d_$]+/u], [WHITE, /[\p{L}_$][\p{L}\d_$]+/u]);
+// src/nnn/noun_form.ts
+var new_noun_form = (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;
 };
+// 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/uuid_v1.ts
 var ZEROS = /* @__PURE__ */ "0".repeat(16);
 var counter = 0;
@@ -280,11 +327,13 @@ export {
   s,
   rwd,
   pro,
-  pl_ural,
   pick,
   omit,
   new_tokenizer,
+  new_noun_form,
+  new_escape,
   nanolight_ts,
+  monokai,
   js_on_parse,
   is_string,
   is_record,
@@ -295,7 +344,6 @@ export {
   h,
   fix_typography,
   escape_values,
-  escape,
   csv_parse,
   c
 };

package/package.json

@@ -4,8 +4,7 @@
   "keywords": [
     "c",
     "CSS-in-JS",
-    "CSV",
-    "csv_parse",
+    "CSV parse",
     "DOM",
     "escape",
     "h",
@@ -20,15 +19,19 @@
     "is_record",
     "is_string",
     "JS-to-CSS",
-    "JSON",
     "js_on_parse",
+    "JSON",
+    "Monokai",
     "nanolight",
     "nnn",
+    "noun form",
     "omit",
     "pick",
-    "RWD",
     "Responsive Web Design",
+    "RWD",
     "SVG",
+    "tokenize",
+    "tokenizer",
     "typography",
     "uuid",
     "uuidv1"
@@ -38,5 +41,5 @@
   "name": "@jackens/nnn",
   "type": "module",
   "types": "nnn.d.ts",
-  "version": "2025.12.13"
+  "version": "2025.12.23"
 }

package/readme.md

@@ -35,7 +35,6 @@ import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 - [`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.
 - [`csv_parse`](#csv_parse): Parses a CSV string into a two-dimensional array of strings.
-- [`escape`](#escape): Escapes interpolated values in a tagged template literal using the provided escape map.
 - [`escape_values`](#escape_values): Escapes an array of values using the provided escape map.
 - [`fix_typography`](#fix_typography): Applies Polish-specific typographic corrections to a DOM subtree.
 - [`h`](#h): A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper
@@ -46,11 +45,13 @@ import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 - [`is_record`](#is_record): Checks whether the argument is a plain object (not `null` and not an array).
 - [`is_string`](#is_string): Checks whether the argument is a string.
 - [`js_on_parse`](#js_on_parse): Parses JSON with support for handler-based value transformation (“JavaScript ON”).
+- [`monokai`](#monokai): A Monokai-inspired color scheme for use with the [`c`](#c) helper and [`nanolight_ts`](#nanolight_ts) tokenizer.
 - [`nanolight_ts`](#nanolight_ts): A TypeScript/JavaScript syntax highlighting tokenizer built using [`new_tokenizer`](#new_tokenizer).
+- [`new_escape`](#new_escape): Creates a tag function for escaping interpolated values in template literals.
+- [`new_noun_form`](#new_noun_form): Creates a function that returns the appropriate Polish noun form based on a numeric value.
 - [`new_tokenizer`](#new_tokenizer): A helper for building simple tokenizers (see also [`nanolight_ts`](#nanolight_ts)).
 - [`omit`](#omit): Creates a new object excluding the specified keys from the source object.
 - [`pick`](#pick): Creates a new object containing only the specified keys from the source object.
-- [`pl_ural`](#pl_ural): Returns the appropriate Polish noun form based on a numeric value.
 - [`pro`](#pro): A Proxy-based helper for auto-vivification of nested object structures.
 - [`rwd`](#rwd): A responsive web design helper that generates CSS rules for a grid-like layout.
 - [`s`](#s): A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper
@@ -83,7 +84,7 @@ type EscapeMap = Map<unknown, (value?: unknown) => string>;
 
 A map from value constructors (or `null`/`undefined`) to escape functions.
 
-Used by [`escape_values`](#escape_values) and [`escape`](#escape).
+Used by [`escape_values`](#escape_values) and [`new_escape`](#new_escape).
 
 ### HArgs
 
@@ -368,58 +369,6 @@ expect(csv_parse(text)).to.deep.equal([
 ])
 ```
 
-### escape
-
-```ts
-const escape: (escape_map: EscapeMap, template: TemplateStringsArray, ...values: unknown[]) => string;
-```
-
-Escapes interpolated values in a tagged template literal using the provided escape map.
-
-#### escape_map
-
-A map where keys are constructors and values are escape functions.
-
-#### template
-
-The template strings array from the tagged template.
-
-#### values
-
-The interpolated values to escape.
-
-#### Returns
-
-The resulting string with all interpolated values escaped.
-
-#### Usage Examples
-
-```ts
-const escape_map: EscapeMap = new Map([
-  [null, () => 'NULL'],
-  [undefined, () => 'NULL'],
-  [Array, (values: unknown[]) => escape_values(escape_map, values).join(', ')],
-  [Boolean, (value: boolean) => `b'${+value}'`],
-  [Date, (value: Date) => `'${value.toISOString().replace(/^(.+)T(.+)\..*$/, '$1 $2')}'`],
-  [Number, (value: number) => `${value}`],
-  [String, (value: string) => `'${value.replace(/'/g, "''")}'`]
-])
-
-const sql = escape.bind(null, escape_map)
-
-const actual = sql`
-  SELECT *
-  FROM table_name
-  WHERE column_name IN (${[true, null, undefined, 42, '42', "4'2", /42/, new Date(323325000000)]})`
-
-const expected = `
-  SELECT *
-  FROM table_name
-  WHERE column_name IN (b'1', NULL, NULL, 42, '42', '4''2', NULL, '1980-03-31 04:30:00')`
-
-expect(actual).to.deep.equal(expected)
-```
-
 ### escape_values
 
 ```ts
@@ -833,6 +782,23 @@ const expected = [
 expect(actual).to.deep.equal(expected)
 ```
 
+### monokai
+
+```ts
+const monokai: CRoot;
+```
+
+A Monokai-inspired color scheme for use with the [`c`](#c) helper and [`nanolight_ts`](#nanolight_ts) tokenizer.
+
+Defines CSS custom properties for eight colors (`--black`, `--blue`, `--green`, `--grey`,
+`--purple`, `--red`, `--white`, `--yellow`) with both light and dark mode variants.
+
+#### Remarks
+
+- In light mode, `--black` is a light background and `--white` is dark text.
+- In dark mode (via `prefers-color-scheme: dark`), the palette inverts to a dark background with light text.
+- Includes base styles for `body`, `pre` and `code>span.*` (syntax highlighting).
+
 ### nanolight_ts
 
 ```ts
@@ -847,7 +813,7 @@ The source code string to tokenize.
 
 #### Returns
 
-An array of [`HArgs1`](#HArgs1) elements suitable for rendering with [`h`](#h) or [`s`](#s).
+An array of [`HArgs1`](#HArgs1) elements suitable for rendering with [`h`](#h).
 
 #### Usage Examples
 
@@ -877,6 +843,97 @@ expect(nanolight_ts(code_js)).to.deep.equal([
 ])
 ```
 
+### new_escape
+
+```ts
+const new_escape: (escape_map: EscapeMap) => (template: TemplateStringsArray, ...values: unknown[]) => string;
+```
+
+Creates a tag function for escaping interpolated values in template literals.
+
+#### escape_map
+
+A map where keys are constructors and values are escape functions.
+
+#### Returns
+
+A tag function that escapes interpolated values using the provided escape map.
+
+#### Usage Examples
+
+```ts
+const escape_map: EscapeMap = new Map([
+  [null, () => 'NULL'],
+  [undefined, () => 'NULL'],
+  [Array, (values: unknown[]) => escape_values(escape_map, values).join(', ')],
+  [Boolean, (value: boolean) => `b'${+value}'`],
+  [Date, (value: Date) => `'${value.toISOString().replace(/^(.+)T(.+)\..*$/, '$1 $2')}'`],
+  [Number, (value: number) => `${value}`],
+  [String, (value: string) => `'${value.replace(/'/g, "''")}'`]
+])
+
+const sql = new_escape(escape_map)
+
+const actual = sql`
+  SELECT *
+  FROM table_name
+  WHERE column_name IN (${[true, null, undefined, 42, '42', "4'2", /42/, new Date(323325000000)]})`
+
+const expected = `
+  SELECT *
+  FROM table_name
+  WHERE column_name IN (b'1', NULL, NULL, 42, '42', '4''2', NULL, '1980-03-31 04:30:00')`
+
+expect(actual).to.deep.equal(expected)
+```
+
+### new_noun_form
+
+```ts
+const new_noun_form: (singular: string, plural_2: string, plural_5: string) => (value: number) => string;
+```
+
+Creates a function that 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.
+
+#### singular
+
+The singular form (e.g., “auto” for “car”).
+
+#### plural_2
+
+The form for 2, 3, 4 (e.g., “auta”).
+
+#### plural_5
+
+The form for 5+ (e.g., “aut”).
+
+#### Returns
+
+A function that takes a numeric value and returns the appropriate noun form.
+
+#### Usage Examples
+
+```ts
+const auto = new_noun_form('auto', 'auta', 'aut')
+
+expect(auto(0)).to.deep.equal('aut')
+expect(auto(1)).to.deep.equal('auto')
+expect(auto(17)).to.deep.equal('aut')
+expect(auto(42)).to.deep.equal('auta')
+
+const car = new_noun_form('car', 'cars', 'cars')
+
+expect(car(0)).to.deep.equal('cars')
+expect(car(1)).to.deep.equal('car')
+expect(car(17)).to.deep.equal('cars')
+expect(car(42)).to.deep.equal('cars')
+```
+
 ### new_tokenizer
 
 ```ts
@@ -967,57 +1024,6 @@ const obj = { a: 42, b: '42', c: 17 }
 expect(pick(obj, ['a', 'b'])).to.deep.equal({ a: 42, b: '42' })
 ```
 
-### pl_ural
-
-```ts
-const pl_ural: (singular: string, plural_2: string, plural_5: string, value: number) => string;
-```
-
-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.
-
-#### singular
-
-The singular form (e.g., “auto” for “car”).
-
-#### plural_2
-
-The form for 2, 3, 4 (e.g., “auta”).
-
-#### plural_5
-
-The form for 5+ (e.g., “aut”).
-
-#### value
-
-The numeric value to evaluate.
-
-#### Returns
-
-The appropriate noun form for the given value.
-
-#### Usage Examples
-
-```ts
-const auto = pl_ural.bind(null, 'auto', 'auta', 'aut')
-
-expect(auto(0)).to.deep.equal('aut')
-expect(auto(1)).to.deep.equal('auto')
-expect(auto(17)).to.deep.equal('aut')
-expect(auto(42)).to.deep.equal('auta')
-
-const car = pl_ural.bind(null, 'car', 'cars', 'cars')
-
-expect(car(0)).to.deep.equal('cars')
-expect(car(1)).to.deep.equal('car')
-expect(car(17)).to.deep.equal('cars')
-expect(car(42)).to.deep.equal('cars')
-```
-
 ### pro
 
 ```ts