@jackens/nnn 2026.4.14 → 2026.8.24

package/nnn.d.ts

@@ -49,6 +49,94 @@ export type CRoot = Record<PropertyKey, CNode>;
  *   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;
+/**
+ * Creates a function that
+ * returns the appropriate noun form
+ * based on a numeric value using `Intl.PluralRules`.
+ *
+ * Different languages have different plural rules.
+ * The `Intl.PluralRules` API provides locale-aware
+ * plural category selection.
+ * Possible categories are:
+ *
+ * - `zero`: for zero items
+ *   (used in some languages like Arabic, Latvian)
+ * - `one`: for singular (e.g., 1 item)
+ * - `two`: for dual
+ *   (used in some languages like Arabic, Hebrew)
+ * - `few`: for small plurals (e.g., 2-4 in Polish)
+ * - `many`: for larger plurals (e.g., 5-21 in Polish)
+ * - `other`: fallback category (used by all languages)
+ *
+ * @param locale
+ *
+ * A BCP 47 language tag (e.g., `pl`, `en`).
+ *
+ * @param forms
+ *
+ * An object mapping plural categories to noun forms.
+ * Not all categories need to be provided;
+ * if a category is missing,
+ * the function falls back to `other`,
+ * then to an empty string.
+ *
+ * @returns
+ *
+ * A function that takes a numeric value
+ * and returns the appropriate noun form.
+ */
+export declare const createPluralRules: (locale: string, forms: Partial<Record<Intl.LDMLPluralRule, string>>) => (value: number) => string;
+/**
+ * A helper for building simple tokenizers
+ * (see also {@link nanolightTs}).
+ *
+ * @param decorator
+ *
+ * A function that wraps each matched chunk.
+ * It receives the matched text (`chunk`)
+ * and optionally the `metadata`
+ * associated with the pattern that produced the match.
+ * For unmatched text between patterns,
+ * `metadata` is `undefined`.
+ *
+ * @param specs
+ *
+ * An array of tuples `[metadata, pattern]` where:
+ * - `metadata`: arbitrary data (e.g., a CSS class name)
+ *   passed to `decorator` when the pattern matches.
+ * - `pattern`: a `string` or `RegExp`
+ *   to match against the input.
+ *
+ * @returns
+ *
+ * A tokenizer function that accepts a code string
+ * and returns an array of decorated tokens.
+ *
+ * @remarks
+ *
+ * 1. Matches starting at an earlier position
+ *    take precedence.
+ * 2. Among matches at the same position,
+ *    the longer one wins.
+ * 3. Among matches of the same position and length,
+ *    the one defined earlier wins.
+ */
+export declare const createTokenizer: <M, T>(decorator: (chunk: string, metadata?: M) => T, ...specs: [M, string | RegExp][]) => (code: string) => T[];
 /**
  * Parses a CSV string
  * into a two-dimensional array of strings.
@@ -315,7 +403,7 @@ export declare const jsOnParse: (handlers: Record<PropertyKey, Function>, text:
 export declare const monokai: CRoot;
 /**
  * A TypeScript/JavaScript syntax highlighting tokenizer
- * built using {@link newTokenizer}.
+ * built using {@link createTokenizer}.
  *
  * @param code
  *
@@ -327,94 +415,6 @@ export declare const monokai: CRoot;
  * suitable for rendering with {@link h}.
  */
 export declare const nanolightTs: (code: string) => HArgs1[];
-/**
- * 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 newEscape: (escapeFn: (value: any) => string) => (template: TemplateStringsArray, ...values: unknown[]) => string;
-/**
- * Creates a function that
- * returns the appropriate noun form
- * based on a numeric value using `Intl.PluralRules`.
- *
- * Different languages have different plural rules.
- * The `Intl.PluralRules` API provides locale-aware
- * plural category selection.
- * Possible categories are:
- *
- * - `zero`: for zero items
- *   (used in some languages like Arabic, Latvian)
- * - `one`: for singular (e.g., 1 item)
- * - `two`: for dual
- *   (used in some languages like Arabic, Hebrew)
- * - `few`: for small plurals (e.g., 2-4 in Polish)
- * - `many`: for larger plurals (e.g., 5-21 in Polish)
- * - `other`: fallback category (used by all languages)
- *
- * @param locale
- *
- * A BCP 47 language tag (e.g., `pl`, `en`).
- *
- * @param forms
- *
- * An object mapping plural categories to noun forms.
- * Not all categories need to be provided;
- * if a category is missing,
- * the function falls back to `other`,
- * then to an empty string.
- *
- * @returns
- *
- * A function that takes a numeric value
- * and returns the appropriate noun form.
- */
-export declare const newNounForm: (locale: string, forms: Partial<Record<Intl.LDMLPluralRule, string>>) => (value: number) => string;
-/**
- * A helper for building simple tokenizers
- * (see also {@link nanolightTs}).
- *
- * @param decorator
- *
- * A function that wraps each matched chunk.
- * It receives the matched text (`chunk`)
- * and optionally the `metadata`
- * associated with the pattern that produced the match.
- * For unmatched text between patterns,
- * `metadata` is `undefined`.
- *
- * @param specs
- *
- * An array of tuples `[metadata, pattern]` where:
- * - `metadata`: arbitrary data (e.g., a CSS class name)
- *   passed to `decorator` when the pattern matches.
- * - `pattern`: a `string` or `RegExp`
- *   to match against the input.
- *
- * @returns
- *
- * A tokenizer function that accepts a code string
- * and returns an array of decorated tokens.
- *
- * @remarks
- *
- * 1. Matches starting at an earlier position
- *    take precedence.
- * 2. Among matches at the same position,
- *    the longer one wins.
- * 3. Among matches of the same position and length,
- *    the one defined earlier wins.
- */
-export declare const newTokenizer: <M, T>(decorator: (chunk: string, metadata?: M) => T, ...specs: [M, string | RegExp][]) => (code: string) => T[];
 /**
  * Creates a new object excluding the specified keys
  * from the source object.

package/nnn.js

@@ -54,6 +54,49 @@ var c = (root, splitter = "$$") => {
   }
   return chunks.join("");
 };
+// src/nnn/createEscape.ts
+var createEscape = (escapeFn) => (template, ...values) => String.raw(template, ...values.map(escapeFn));
+// src/nnn/createPluralRules.ts
+var PLURAL_RULES = {};
+var createPluralRules = (locale, forms) => (value) => forms[(PLURAL_RULES[locale] ??= new Intl.PluralRules(locale)).select(value)] ?? forms.other ?? "";
+// src/nnn/createTokenizer.ts
+var createTokenizer = (decorator, ...specs) => (code) => {
+  const result = [];
+  while (code.length > 0) {
+    let bestMetadata;
+    let bestIndex = Infinity;
+    let bestChunk = "";
+    for (const [metadata, pattern] of specs) {
+      let index = -1;
+      let chunk = "";
+      if (isString(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 < bestIndex || index === bestIndex && chunk.length > bestChunk.length)) {
+        bestMetadata = metadata;
+        bestIndex = index;
+        bestChunk = chunk;
+      }
+    }
+    if (bestMetadata != null) {
+      if (bestIndex > 0) {
+        result.push(decorator(code.slice(0, bestIndex)));
+      }
+      result.push(decorator(bestChunk, bestMetadata));
+      code = code.slice(bestIndex + bestChunk.length);
+    } else {
+      result.push(decorator(code));
+      break;
+    }
+  }
+  return result;
+};
 // src/nnn/csvParse.ts
 var MAIN_PATTERN = /\n|(?<!")("(?:[^"]|"")*")(?!")/g;
 var csvParse = (csv, separator = ",") => {
@@ -210,13 +253,13 @@ 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(--identifier-1)" },
+    identifier_2: { color: "var(--identifier-2)" },
+    identifier_3: { color: "var(--identifier-3)" },
+    identifier_4: { color: "var(--identifier-4)" },
+    keyword_1: { color: "var(--keyword-1)" },
+    keyword_2: { color: "var(--keyword-2)" },
+    keyword_3: { color: "var(--keyword-3)" },
     number: { color: "var(--number)" },
     operator: { color: "var(--operator)" },
     punctuation: { color: "var(--punctuation)" },
@@ -241,45 +284,6 @@ var monokai = {
     }
   }
 };
-// src/nnn/newTokenizer.ts
-var newTokenizer = (decorator, ...specs) => (code) => {
-  const result = [];
-  while (code.length > 0) {
-    let bestMetadata;
-    let bestIndex = Infinity;
-    let bestChunk = "";
-    for (const [metadata, pattern] of specs) {
-      let index = -1;
-      let chunk = "";
-      if (isString(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 < bestIndex || index === bestIndex && chunk.length > bestChunk.length)) {
-        bestMetadata = metadata;
-        bestIndex = index;
-        bestChunk = chunk;
-      }
-    }
-    if (bestMetadata != null) {
-      if (bestIndex > 0) {
-        result.push(decorator(code.slice(0, bestIndex)));
-      }
-      result.push(decorator(bestChunk, bestMetadata));
-      code = code.slice(bestIndex + bestChunk.length);
-    } else {
-      result.push(decorator(code));
-      break;
-    }
-  }
-  return result;
-};
-
 // src/nnn/nanolightTs.ts
 var COMMENT = "comment";
 var IDENTIFIER_1 = "identifier-1";
@@ -293,12 +297,7 @@ var NUMBER = "number";
 var OPERATOR = "operator";
 var PUNCTUATION = "punctuation";
 var STRING = "string";
-var nanolightTs = /* @__PURE__ */ newTokenizer((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]);
-// src/nnn/newEscape.ts
-var newEscape = (escapeFn) => (template, ...values) => String.raw(template, ...values.map(escapeFn));
-// src/nnn/newNounForm.ts
-var PLURAL_RULES = {};
-var newNounForm = (locale, forms) => (value) => forms[(PLURAL_RULES[locale] ??= new Intl.PluralRules(locale)).select(value)] ?? forms.other ?? "";
+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]);
 // src/nnn/omit.ts
 var omit = (ref, keys) => Object.fromEntries(Object.entries(ref).filter(([key]) => !keys.includes(key)));
 // src/nnn/pick.ts
@@ -313,8 +312,8 @@ var rwd = (root, selector, cellWidthPx, cellHeightPx, ...specs) => {
   main.height = `${cellHeightPx}px`;
   specs.sort(([a], [b]) => a - b);
   for (let [maxWidth, width, height] of specs) {
-    const mediaSelector = `@media(min-width:${cellWidthPx * maxWidth}px)`;
-    const node = maxWidth === 1 ? main : (root[mediaSelector] ??= {})[selector] ??= {};
+    const atRule = `@media(min-width:${cellWidthPx * maxWidth}px)`;
+    const node = maxWidth === 1 ? main : (root[atRule] ??= {})[selector] ??= {};
     width ??= 1;
     height ??= 1;
     let gcd = 100 * width;
@@ -357,27 +356,27 @@ var _vivify = (parent, parentKey) => new Proxy(parent, {
 });
 var vivify = (ref) => _vivify({ _: ref }, "_");
 export {
-  vivify,
-  uuidV1,
-  svgUse,
-  s,
-  rwd,
-  pick,
-  omit,
-  newTokenizer,
-  newNounForm,
-  newEscape,
-  nanolightTs,
-  monokai,
-  jsOnParse,
-  isString,
-  isRecord,
-  isNumber,
-  isFiniteNumber,
-  isArray,
-  hasOwn,
-  h,
-  fixPlTypography,
+  c,
+  createEscape,
+  createPluralRules as createNounForm,
+  createTokenizer,
   csvParse,
-  c
+  fixPlTypography,
+  h,
+  hasOwn,
+  isArray,
+  isFiniteNumber,
+  isNumber,
+  isRecord,
+  isString,
+  jsOnParse,
+  monokai,
+  nanolightTs,
+  omit,
+  pick,
+  rwd,
+  s,
+  svgUse,
+  uuidV1,
+  vivify
 };

package/package.json

@@ -44,5 +44,5 @@
   "name": "@jackens/nnn",
   "type": "module",
   "types": "nnn.d.ts",
-  "version": "2026.4.14"
+  "version": "2026.8.24"
 }