@jackens/nnn 2026.9.7 → 2026.9.9

package/nnn.d.ts

@@ -242,53 +242,3 @@ export declare const rwd: (root: CNode, selector: string, cellWidthPx: number, c
  *   `xxxxxxxx-xxxx-1xxx-xxxx-xxxxxxxxxxxx`.
  */
 export declare const uuidV1: (date?: Date, node?: string) => string;
-/**
- * A Proxy-based helper for auto-vivification of nested
- * object structures.
- *
- * Accessing, assigning, or deleting any nested property on
- * the returned proxy automatically creates intermediate
- * objects (or arrays for numeric-string keys matching
- * `^(0|[1-9]\d*)$`) as needed, allowing deep operations
- * without explicit null checks.
- *
- * Intermediates of the last level in a get-only property
- * chain are NOT auto-created. For example,
- * `vivify(ref).one.two` will create `ref.one` as `{}`, but
- * will NOT create `ref.one.two`. Only when a deeper access,
- * assignment, or deletion occurs, e.g.
- *
- * ```ts
- * delete vivify(ref).one.two.three
- * ```
- *
- * or
- *
- * ```ts
- * vivify(ref).one.two.three = 4
- * ```
- *
- * Will `ref.one.two` be materialized.
- *
- * When traversal reaches a primitive value, no
- * auto-creation happens; the primitive’s own property is
- * returned instead (e.g. accessing `.toString.name` on a
- * number yields `'toString'` without modifying the
- * underlying structure).
- *
- * Deletion on a non-existing intermediate path will
- * auto-create intermediates up to the parent of the deleted
- * key, e.g.
- *
- * ```ts
- * delete vivify(ref).one.two.three
- * ```
- *
- * Will create `ref.one.two` as `{}` if it does not exist.
- *
- * @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

@@ -318,27 +318,6 @@ var uuidV1 = (date = new Date, node = Math.random().toString(16).slice(2)) => {
   counter = counter + 1 & 16383;
   return time.slice(-8).concat("-", time.slice(-12, -8), -1, time.slice(-15, -12), "-", (8 | counter >> 12).toString(16), (ZEROS + (counter & 4095).toString(16)).slice(-3), "-", (ZEROS + node).slice(-12));
 };
-// src/nnn/vivify.ts
-var ARRAY_INDEX_REGEXP = /^(0|[1-9]\d*)$/;
-var isObject = (ref) => typeof ref === "object";
-var getTarget = (parent, parentKey, key) => parent[parentKey] ??= typeof key === "string" && ARRAY_INDEX_REGEXP.test(key) ? [] : {};
-var _vivify = (parent, parentKey) => new Proxy(parent, {
-  get(_, key) {
-    const target = getTarget(parent, parentKey, key);
-    const value = target[key];
-    return typeof key === "string" && isObject(target) && (value == null || isObject(value)) ? _vivify(target, key) : value;
-  },
-  set(_, key, value) {
-    const target = getTarget(parent, parentKey, key);
-    target[key] = value;
-    return true;
-  },
-  deleteProperty(_, key) {
-    const target = getTarget(parent, parentKey, key);
-    return delete target[key];
-  }
-});
-var vivify = (ref) => _vivify({ _: ref }, "_");
 export {
   c,
   createEscape,
@@ -351,6 +330,5 @@ export {
   rwd,
   s,
   svgUse,
-  uuidV1,
-  vivify
+  uuidV1
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jackens/nnn",
-  "version": "2026.9.7",
+  "version": "2026.9.9",
   "description": "Jackens’ JavaScript helpers.",
   "keywords": [
     "CSS-in-JS",

package/readme.md

@@ -1,6 +1,6 @@
 # nnn
 
-A collection of Jackens’ JavaScript helper utilities (version: `2026.9.7`).
+A collection of Jackens’ JavaScript helper utilities (version: `2026.9.9`).
 
 ## Installation
 
@@ -33,7 +33,6 @@ import {
   s,
   svgUse,
   uuidV1,
-  vivify,
 } from '@jackens/nnn' // or './node_modules/@jackens/nnn/nnn.js'
 ```
 
@@ -83,9 +82,6 @@ import {
   child referencing an icon by ID.
 - [`uuidV1`](#uuidV1):
   Generates a UUID v1 (time-based) identifier.
-- [`vivify`](#vivify):
-  A Proxy-based helper for auto-vivification of nested
-  object structures.
 
 ### CNode
 
@@ -479,29 +475,31 @@ const escapeFn = (value: any): string =>
 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),
-  ]}
-)`
+  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'
-)`
+  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).toBe(expected)
 ```
@@ -1359,175 +1357,6 @@ expect(
 ).toBe(true)
 ```
 
-### vivify
-
-```ts
-const vivify: (ref: unknown) => any;
-```
-
-A Proxy-based helper for auto-vivification of nested
-object structures.
-
-Accessing, assigning, or deleting any nested property on
-the returned proxy automatically creates intermediate
-objects (or arrays for numeric-string keys matching
-`^(0|[1-9]\d*)$`) as needed, allowing deep operations
-without explicit null checks.
-
-Intermediates of the last level in a get-only property
-chain are NOT auto-created. For example,
-`vivify(ref).one.two` will create `ref.one` as `{}`, but
-will NOT create `ref.one.two`. Only when a deeper access,
-assignment, or deletion occurs, e.g.
-
-```ts
-delete vivify(ref).one.two.three
-```
-
-or
-
-```ts
-vivify(ref).one.two.three = 4
-```
-
-Will `ref.one.two` be materialized.
-
-When traversal reaches a primitive value, no
-auto-creation happens; the primitive’s own property is
-returned instead (e.g. accessing `.toString.name` on a
-number yields `'toString'` without modifying the
-underlying structure).
-
-Deletion on a non-existing intermediate path will
-auto-create intermediates up to the parent of the deleted
-key, e.g.
-
-```ts
-delete vivify(ref).one.two.three
-```
-
-Will create `ref.one.two` as `{}` if it does not exist.
-
-#### 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]
-
-expect(ref).toEqual({
-  one: {
-    two: [undefined, undefined, undefined, []],
-  },
-})
-
-vivify(ref).one.two[3][4] = 5
-
-expect(ref).toEqual({
-  one: {
-    two: [
-      undefined,
-      undefined,
-      undefined,
-      [undefined, undefined, undefined, undefined, 5],
-    ],
-  },
-})
-
-vivify(ref).one.two[3].length = 1
-
-expect(ref).toEqual({
-  one: {
-    two: [undefined, undefined, undefined, [undefined]],
-  },
-})
-
-vivify(ref).one.two[3] = 4
-
-expect(ref).toEqual({
-  one: {
-    two: [undefined, undefined, undefined, 4],
-  },
-})
-
-expect(vivify(ref).one.two.length).toBe(4)
-
-expect(ref).toEqual({
-  one: {
-    two: [undefined, undefined, undefined, 4],
-  },
-})
-
-vivify(ref).one.two = 3
-
-expect(ref).toEqual({ one: { two: 3 } })
-
-vivify(ref).one.two = undefined
-
-expect(ref).toEqual({ one: { two: undefined } })
-
-delete vivify(ref).one.two
-
-expect(ref).toEqual({ one: {} })
-
-expect(vivify(ref).one.toString instanceof Function).toBe(
-  true
-)
-
-expect(vivify(ref).one.toString.name).toBe('toString')
-
-expect(ref).toEqual({ one: {} })
-
-delete vivify(ref).one.two.three
-
-expect(ref).toEqual({ one: { two: {} } })
-
-vivify(ref).one.two.three.four
-
-expect(ref).toEqual({ one: { two: { three: {} } } })
-
-vivify(ref).one.two[3]
-
-expect(ref).toEqual({ one: { two: { three: {} } } })
-
-vivify(ref).one.two.three.four = 5
-
-expect(ref).toEqual({
-  one: { two: { three: { four: 5 } } },
-})
-
-expect(vivify(ref).one.two.three.four.toString.name).toBe(
-  'toString'
-)
-
-expect(ref).toEqual({
-  one: { two: { three: { four: 5 } } },
-})
-```
-
-```ts
-const u = undefined
-
-vivify(u).one.two = 3
-
-expect(u).toBeUndefined()
-
-const n = null
-
-delete vivify(n).one.two.three
-
-expect(n).toBeNull()
-```
-
 ## License
 
 The MIT License (MIT)