@jackens/nnn 2025.12.23 → 2026.2.6

package/nnn.d.ts

@@ -126,7 +126,7 @@ export declare const new_escape: (escape_map: EscapeMap) => (template: TemplateS
  * The root DOM node to process. All descendant text nodes are corrected recursively,
  * except those inside `IFRAME`, `NOSCRIPT`, `PRE`, `SCRIPT`, `STYLE`, or `TEXTAREA` elements.
  */
-export declare const fix_typography: (node: Node) => void;
+export declare const fix_pl_typography: (node: Node) => void;
 /**
  * Single argument type for the {@link h} and {@link s} helpers.
  */
@@ -307,55 +307,32 @@ export declare const is_string: (arg: unknown) => arg is string;
  */
 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}.
- *
- * @param code
- *
- * The source code string to tokenize.
- *
- * @returns
- *
- * An array of {@link HArgs1} elements suitable for rendering with {@link h}.
- */
-export declare const nanolight_ts: (code: string) => HArgs1[];
-/**
- * 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.
+ * Creates a function that returns the appropriate noun form based on a numeric value using `Intl.PluralRules`.
  *
- * @param singular
+ * Different languages have different plural rules. The `Intl.PluralRules` API provides
+ * locale-aware plural category selection. Possible categories are:
  *
- * The singular form (e.g., “auto” for “car”).
+ * - `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 plural_2
+ * @param locale
  *
- * The form for 2, 3, 4 (e.g., “auta”).
+ * A BCP 47 language tag (e.g., "pl", "en").
  *
- * @param plural_5
+ * @param forms
  *
- * The form for 5+ (e.g., “aut”).
+ * 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 new_noun_form: (singular: string, plural_2: string, plural_5: string) => (value: number) => string;
+export declare const new_noun_form: (locale: string, forms: Partial<Record<Intl.LDMLPluralRule, string>>) => (value: number) => string;
 /**
  * Creates a new object containing only the specified keys from the source object.
  *
@@ -392,21 +369,6 @@ 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>;
-/**
- * A Proxy-based helper for auto-vivification of nested object structures.
- *
- * Accessing any property on the returned proxy automatically creates an empty object if the property does not exist,
- * allowing deep assignments without explicit null checks.
- *
- * @param ref
- *
- * The root object to wrap.
- *
- * @returns
- *
- * A proxy that auto-creates nested objects on property access.
- */
-export declare const pro: (ref: unknown) => any;
 /**
  * A helper for building simple tokenizers (see also {@link nanolight_ts}).
  *
@@ -433,6 +395,31 @@ export declare const pro: (ref: unknown) => any;
  * 3. Among matches of the same position and length, the one defined earlier wins.
  */
 export declare const new_tokenizer: <M, T>(decorator: (chunk: string, metadata?: M) => T, ...specs: [M, string | RegExp][]) => (code: string) => T[];
+/**
+ * A TypeScript/JavaScript syntax highlighting tokenizer built using {@link new_tokenizer}.
+ *
+ * @param code
+ *
+ * The source code string to tokenize.
+ *
+ * @returns
+ *
+ * An array of {@link HArgs1} elements suitable for rendering with {@link h}.
+ */
+export declare const nanolight_ts: (code: string) => HArgs1[];
+/**
+ * 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;
 /**
  * Generates a UUID v1 (time-based) identifier.
  *
@@ -450,3 +437,22 @@ export declare const new_tokenizer: <M, T>(decorator: (chunk: string, metadata?:
  * A UUID v1 `string` in the standard format `xxxxxxxx-xxxx-1xxx-xxxx-xxxxxxxxxxxx`.
  */
 export declare const uuid_v1: (date?: Date, node?: string) => string;
+/**
+ * A Proxy-based helper for auto-vivification of nested object structures.
+ *
+ * Accessing any property on the returned proxy automatically creates an empty object
+ * (or array for numeric keys) if the property does not exist,
+ * allowing deep assignments without explicit null checks.
+ *
+ * When a numeric key (like `[42]`) is accessed, the parent structure is
+ * automatically converted to an array if it isn’t one already.
+ *
+ * @param ref
+ *
+ * The root object to wrap.
+ *
+ * @returns
+ *
+ * A proxy that auto-creates nested objects/arrays on property access.
+ */
+export declare const vivify: (ref: unknown) => any;

package/nnn.js

@@ -5,12 +5,26 @@ var is_number = (arg) => typeof arg === "number";
 var is_record = (arg) => typeof arg === "object" && arg != null && !is_array(arg);
 var is_string = (arg) => typeof arg === "string";
 
-// src/nnn/pro.ts
-var pro = (ref) => new Proxy(ref, {
+// src/nnn/vivify.ts
+var ARRAY_INDEX_REGEXP = /^(0|[1-9]\d*)$/;
+var should_convert_target_to_array = (target, key, parent) => parent != null && typeof key === "string" && ARRAY_INDEX_REGEXP.test(key) && !is_array(target);
+var _vivify = (ref, parent, parentKey) => new Proxy(ref, {
   get(target, key) {
-    return pro(target[key] ??= {});
+    if (should_convert_target_to_array(target, key, parent)) {
+      target = parent[parentKey] = [];
+    }
+    target[key] ??= {};
+    return _vivify(target[key], target, key);
+  },
+  set(target, key, value) {
+    if (should_convert_target_to_array(target, key, parent)) {
+      target = parent[parentKey] = [];
+    }
+    target[key] = value;
+    return true;
   }
 });
+var vivify = (ref) => _vivify(ref);
 
 // src/nnn/c.ts
 var _c = (node, prefix, result, splitter) => {
@@ -65,7 +79,7 @@ var c = (root, splitter = "$$") => {
   return chunks.join("");
 };
 var rwd = (root, selector, cell_width_px, cell_height_px, ...specs) => {
-  const main = pro(root)[selector];
+  const main = vivify(root)[selector];
   main.boxSizing = "border-box";
   main.display = "block";
   main.float = "left";
@@ -73,7 +87,7 @@ var rwd = (root, selector, cell_width_px, cell_height_px, ...specs) => {
   main.height = `${cell_height_px}px`;
   specs.sort(([a], [b]) => a - b);
   for (let [max_width, width, height] of specs) {
-    const node = max_width === 1 ? main : pro(root)[`@media(min-width:${cell_width_px * max_width}px)`][selector];
+    const node = max_width === 1 ? main : vivify(root)[`@media(min-width:${cell_width_px * max_width}px)`][selector];
     width ??= 1;
     height ??= 1;
     let gcd = 100 * width;
@@ -158,9 +172,9 @@ var h = /* @__PURE__ */ _h();
 var s = /* @__PURE__ */ _h("http://www.w3.org/2000/svg");
 var svg_use = (id, ...args) => s("svg", ["use", { "xlink:href": "#" + id }], ...args);
 
-// src/nnn/fix_typography.ts
+// src/nnn/fix_pl_typography.ts
 var TAGS_TO_SKIP = ["IFRAME", "NOSCRIPT", "PRE", "SCRIPT", "STYLE", "TEXTAREA"];
-var fix_typography = (node) => {
+var fix_pl_typography = (node) => {
   const queue = [node];
   while (queue.length > 0) {
     const node_0 = queue.shift();
@@ -209,53 +223,14 @@ var js_on_parse = (handlers, text) => JSON.parse(text, (key, value) => {
   }
   return value;
 });
-// 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/new_noun_form.ts
+var new_noun_form = (locale, forms) => {
+  const plural_rules = new Intl.PluralRules(locale);
+  return (value) => forms[plural_rules.select(value)] ?? forms.other ?? "";
 };
+// 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/tokenizer.ts
 var new_tokenizer = (decorator, ...specs) => (code) => {
   const result = [];
@@ -294,8 +269,6 @@ var new_tokenizer = (decorator, ...specs) => (code) => {
   }
   return result;
 };
-
-// src/nnn/nanolight.ts
 var BLUE = "blue";
 var GREEN = "green";
 var GREY = "grey";
@@ -304,15 +277,52 @@ 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]*?`/], [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;
+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/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;
@@ -322,11 +332,11 @@ var uuid_v1 = (date = new Date, node = Math.random().toString(16).slice(2)) => {
   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));
 };
 export {
+  vivify,
   uuid_v1,
   svg_use,
   s,
   rwd,
-  pro,
   pick,
   omit,
   new_tokenizer,
@@ -342,7 +352,7 @@ export {
   is_array,
   has_own,
   h,
-  fix_typography,
+  fix_pl_typography,
   escape_values,
   csv_parse,
   c

package/package.json

@@ -2,6 +2,7 @@
   "author": "Jackens",
   "description": "Jackens’ JavaScript helpers.",
   "keywords": [
+    "autovivify",
     "c",
     "CSS-in-JS",
     "CSV parse",
@@ -34,12 +35,13 @@
     "tokenizer",
     "typography",
     "uuid",
-    "uuidv1"
+    "uuidv1",
+    "vivify"
   ],
   "license": "MIT",
   "main": "nnn.js",
   "name": "@jackens/nnn",
   "type": "module",
   "types": "nnn.d.ts",
-  "version": "2025.12.23"
+  "version": "2026.2.6"
 }

package/readme.md

@@ -5,25 +5,43 @@ A collection of Jackens’ JavaScript helper utilities.
 ## Installation
 
 ```sh
-bun i @jackens/nnn
-```
-
-or
-
-```sh
-npm i @jackens/nnn
+bun i @jackens/nnn # npm i @jackens/nnn
 ```
 
 ## Usage
 
 ```js
-import { «something» } from '@jackens/nnn'
-```
-
-or
-
-```js
-import { «something» } from './node_modules/@jackens/nnn/nnn.js'
+import {
+  CNode,
+  CRoot,
+  EscapeMap,
+  HArgs,
+  HArgs1,
+  c,
+  csv_parse,
+  escape_values,
+  fix_pl_typography,
+  h,
+  has_own,
+  is_array,
+  is_finite_number,
+  is_number,
+  is_record,
+  is_string,
+  js_on_parse,
+  monokai,
+  nanolight_ts,
+  new_escape,
+  new_noun_form,
+  new_tokenizer,
+  omit,
+  pick,
+  rwd,
+  s,
+  svg_use,
+  uuid_v1,
+  vivify
+} from '@jackens/nnn' // './node_modules/@jackens/nnn/nnn.js'
 ```
 
 ## Exports
@@ -36,8 +54,9 @@ import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 - [`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_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.
+- [`fix_pl_typography`](#fix_pl_typography): Applies Polish-specific typographic corrections to a DOM subtree.
 - [`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): Checks whether an object has the specified key as its own property.
 - [`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 (excludes `±Infinity` and `NaN`).
@@ -48,15 +67,16 @@ import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 - [`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_noun_form`](#new_noun_form): Creates a function that returns the appropriate noun form based on a numeric value using `Intl.PluralRules`.
 - [`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.
-- [`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
+  for creating and modifying `SVGElement`s (see also [`h`](#h)).
 - [`svg_use`](#svg_use): Shorthand for creating an SVG element with a `<use>` child referencing an icon by ID.
 - [`uuid_v1`](#uuid_v1): Generates a UUID v1 (time-based) identifier.
+- [`vivify`](#vivify): A Proxy-based helper for auto-vivification of nested object structures.
 
 ### CNode
 
@@ -389,10 +409,10 @@ The array of values to escape.
 
 An array of escaped strings.
 
-### fix_typography
+### fix_pl_typography
 
 ```ts
-const fix_typography: (node: Node) => void;
+const fix_pl_typography: (node: Node) => void;
 ```
 
 Applies Polish-specific typographic corrections to a DOM subtree.
@@ -411,7 +431,7 @@ except those inside `IFRAME`, `NOSCRIPT`, `PRE`, `SCRIPT`, `STYLE`, or `TEXTAREA
 ```ts
 const p = h('p', 'Pchnąć w tę łódź jeża lub ośm skrzyń fig (zob. https://pl.wikipedia.org/wiki/Pangram).')
 
-fix_typography(p)
+fix_pl_typography(p)
 
 expect(p.innerHTML).to.deep.equal(
   'Pchnąć <span style="white-space:nowrap">w </span>tę łódź jeża lub ośm skrzyń fig ' +
@@ -877,12 +897,12 @@ 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)]})`
+  WHERE column_name IN (${[true, null, undefined, 42, '42', "4'2", 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')`
+  WHERE column_name IN (b'1', NULL, NULL, 42, '42', '4''2', '1980-03-31 04:30:00')`
 
 expect(actual).to.deep.equal(expected)
 ```
@@ -890,27 +910,29 @@ 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;
+const new_noun_form: (locale: string, forms: Partial<Record<Intl.LDMLPluralRule, 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.
+Creates a function that returns the appropriate noun form based on a numeric value using `Intl.PluralRules`.
 
-#### singular
+Different languages have different plural rules. The `Intl.PluralRules` API provides
+locale-aware plural category selection. Possible categories are:
 
-The singular form (e.g., “auto” for “car”).
+- `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)
 
-#### plural_2
+#### locale
 
-The form for 2, 3, 4 (e.g., “auta”).
+A BCP 47 language tag (e.g., "pl", "en").
 
-#### plural_5
+#### forms
 
-The form for 5+ (e.g., “aut”).
+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
 
@@ -919,14 +941,14 @@ A function that takes a numeric value and returns the appropriate noun form.
 #### Usage Examples
 
 ```ts
-const auto = new_noun_form('auto', 'auta', 'aut')
+const auto = new_noun_form('pl', { one: 'auto', few: 'auta', other: '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')
+const car = new_noun_form('en', { one: 'car', other: 'cars' })
 
 expect(car(0)).to.deep.equal('cars')
 expect(car(1)).to.deep.equal('car')
@@ -1024,55 +1046,6 @@ const obj = { a: 42, b: '42', c: 17 }
 expect(pick(obj, ['a', 'b'])).to.deep.equal({ a: 42, b: '42' })
 ```
 
-### pro
-
-```ts
-const pro: (ref: unknown) => any;
-```
-
-A Proxy-based helper for auto-vivification of nested object structures.
-
-Accessing any property on the returned proxy automatically creates an empty object if the property does not exist,
-allowing deep assignments without explicit null checks.
-
-#### ref
-
-The root object to wrap.
-
-#### Returns
-
-A proxy that auto-creates nested objects on property access.
-
-#### Usage Examples
-
-```ts
-const ref = {}
-
-pro(ref).one.two[3][4] = 1234
-
-expect(ref).to.deep.equal({ one: { two: { 3: { 4: 1234 } } } })
-
-pro(ref).one.two.tree = 123
-
-expect(ref).to.deep.equal({ one: { two: { 3: { 4: 1234 }, tree: 123 } } })
-
-pro(ref).one.two = undefined
-
-expect(ref).to.deep.equal({ one: { two: undefined } })
-
-delete pro(ref).one.two
-
-expect(ref).to.deep.equal({ one: {} })
-
-pro(ref).one.two.three.four
-
-expect(ref).to.deep.equal({ one: { two: { three: { four: {} } } } })
-
-pro(ref).one.two.three.four = 1234
-
-expect(ref).to.deep.equal({ one: { two: { three: { four: 1234 } } } })
-```
-
 ### rwd
 
 ```ts
@@ -1271,6 +1244,67 @@ expect(uuid_v1(new Date(), '123456789').split('-')[4]).to.deep.equal('0001234567
 expect(uuid_v1(new Date(323325000000)).startsWith('c1399400-9a71-11bd')).to.be.true
 ```
 
+### vivify
+
+```ts
+const vivify: (ref: unknown) => any;
+```
+
+A Proxy-based helper for auto-vivification of nested object structures.
+
+Accessing any property on the returned proxy automatically creates an empty object
+(or array for numeric keys) if the property does not exist,
+allowing deep assignments without explicit null checks.
+
+When a numeric key (like `[42]`) is accessed, the parent structure is
+automatically converted to an array if it isn’t one already.
+
+#### ref
+
+The root object to wrap.
+
+#### Returns
+
+A proxy that auto-creates nested objects/arrays on property access.
+
+#### Usage Examples
+
+```ts
+const ref: any = {}
+
+vivify(ref).one.two[3][4] = 1234
+
+expect(ref).to.deep.equal({ one: { two: [, , , [, , , , 1234]] } })
+
+vivify(ref).one.two[3][5] = 12345
+
+expect(ref).to.deep.equal({ one: { two: [, , , [, , , , 1234, 12345]] } })
+
+vivify(ref).one.two[1] = 'one'
+
+expect(ref).to.deep.equal({ one: { two: [, 'one', , [, , , , 1234, 12345]] } })
+
+vivify(ref).one.two = 'tree'
+
+expect(ref).to.deep.equal({ one: { two: 'tree' } })
+
+vivify(ref).one.two = undefined
+
+expect(ref).to.deep.equal({ one: { two: undefined } })
+
+delete vivify(ref).one.two
+
+expect(ref).to.deep.equal({ one: {} })
+
+vivify(ref).one.two.three.four
+
+expect(ref).to.deep.equal({ one: { two: { three: { four: {} } } } })
+
+vivify(ref).one.two.three.four = 1234
+
+expect(ref).to.deep.equal({ one: { two: { three: { four: 1234 } } } })
+```
+
 ## License
 
 The MIT License (MIT)