@arcmantle/chronicle 0.0.4

package/dist/listener-affinity.js

@@ -0,0 +1,58 @@
+import { getListenerBucket, getNode } from "./listener-trie.js";
+/**
+ * Compute the set of listeners affected by a change at the given path.
+ *
+ * Collects listeners in this order:
+ * - Global listeners (onAny)
+ * - Down listeners on the path and all ancestors (listen for descendants)
+ * - Exact listeners at the exact path
+ * - Up listeners on all descendants (listen for ancestors)
+ *
+ * @param root - The root object
+ * @param path - The path where the change occurred
+ * @returns Set of all affected listeners
+ */
+export const computeAffectedListeners = (root, path) => {
+    const bucket = getListenerBucket(root);
+    const affected = new Set();
+    if (!bucket)
+        return affected;
+    // Global listeners
+    bucket.global.forEach(l => affected.add(l));
+    const rootNode = bucket.trie;
+    // Down listeners on ancestors (including root)
+    {
+        let node = rootNode;
+        if (node && node.modes.size > 0)
+            node.modes.get('down')?.forEach(l => affected.add(l));
+        for (const seg of path) {
+            node = node?.children.get(seg);
+            if (!node)
+                break;
+            node.modes.get('down')?.forEach(l => affected.add(l));
+        }
+    }
+    // Exact listeners at the path
+    {
+        const node = getNode(rootNode, path);
+        if (node)
+            node.modes.get('exact')?.forEach(l => affected.add(l));
+    }
+    // Up listeners on descendants (strictly deeper than path)
+    {
+        const start = getNode(rootNode, path);
+        if (start) {
+            for (const child of start.children.values()) {
+                const stack = [child];
+                while (stack.length) {
+                    const n = stack.pop();
+                    n.modes.get('up')?.forEach(l => affected.add(l));
+                    for (const c of n.children.values())
+                        stack.push(c);
+                }
+            }
+        }
+    }
+    return affected;
+};
+//# sourceMappingURL=listener-affinity.js.map

package/dist/listener-affinity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listener-affinity.js","sourceRoot":"","sources":["../src/listener-affinity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAIhE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,IAAY,EAAE,IAAc,EAAuB,EAAE;IAC7F,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAwB,IAAI,GAAG,EAAE,CAAC;IAEhD,IAAI,CAAC,MAAM;QACV,OAAO,QAAQ,CAAC;IAEjB,mBAAmB;IACnB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;IAE7B,+CAA+C;IAC/C,CAAC;QACA,IAAI,IAAI,GAA6B,QAAQ,CAAC;QAC9C,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAEvD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,GAAG,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,CAAC,IAAI;gBACR,MAAM;YAEP,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC;IACF,CAAC;IAED,8BAA8B;IAC9B,CAAC;QACA,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACrC,IAAI,IAAI;YACP,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,0DAA0D;IAC1D,CAAC;QACA,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACtC,IAAI,KAAK,EAAE,CAAC;YACX,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC7C,MAAM,KAAK,GAAmB,CAAE,KAAK,CAAE,CAAC;gBACxC,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;oBACrB,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;oBACvB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;oBACjD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE;wBAClC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,QAAQ,CAAC;AACjB,CAAC,CAAC"}

package/dist/listener-trie.d.ts

@@ -0,0 +1,10 @@
+import type { ChangeListener, ListenerBucket, PathMode, PathTrieNode } from './types.ts';
+export declare const getListenerBucket: (root: object) => ListenerBucket | undefined;
+export declare const ensureListenerBucket: (root: object) => ListenerBucket;
+export declare const cleanupListenerBucket: (root: object, bucket: ListenerBucket) => void;
+export declare const getOrCreateNode: (root: PathTrieNode, segs: string[]) => PathTrieNode;
+export declare const getNode: (root: PathTrieNode, segs: string[]) => PathTrieNode | undefined;
+export declare const prunePathIfEmpty: (root: PathTrieNode, segs: string[]) => void;
+export declare const addListenerToTrie: (root: PathTrieNode, segs: string[], mode: PathMode, listener: ChangeListener) => PathTrieNode;
+export declare const removeListenerFromTrie: (root: PathTrieNode, segs: string[], mode: PathMode, listener: ChangeListener) => void;
+//# sourceMappingURL=listener-trie.d.ts.map

package/dist/listener-trie.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listener-trie.d.ts","sourceRoot":"","sources":["../src/listener-trie.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAKzF,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,cAAc,GAAG,SAAoC,CAAC;AAEvG,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,cAYnD,CAAC;AAIF,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,EAAE,QAAQ,cAAc,KAAG,IAG5E,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,MAAM,YAAY,EAAE,MAAM,MAAM,EAAE,KAAG,YAapE,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,MAAM,YAAY,EAAE,MAAM,MAAM,EAAE,KAAG,YAAY,GAAG,SAS3E,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,MAAM,YAAY,EAAE,MAAM,MAAM,EAAE,KAAG,IAwBrE,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,MAAM,YAAY,EAAE,MAAM,MAAM,EAAE,EAAE,MAAM,QAAQ,EAAE,UAAU,cAAc,KAAG,YAOhH,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,MAAM,YAAY,EAAE,MAAM,MAAM,EAAE,EAAE,MAAM,QAAQ,EAAE,UAAU,cAAc,KAAG,IAarH,CAAC"}

package/dist/listener-trie.js

@@ -0,0 +1,83 @@
+// Per-root listener registry (global + trie)
+const listenerCache = new WeakMap();
+export const getListenerBucket = (root) => listenerCache.get(root);
+export const ensureListenerBucket = (root) => {
+    let bucket = listenerCache.get(root);
+    if (!bucket) {
+        bucket = {
+            global: new Set(),
+            trie: { children: new Map(), modes: new Map() },
+        };
+        listenerCache.set(root, bucket);
+    }
+    return bucket;
+};
+const isNodeEmpty = (node) => node.children.size === 0 && (node.modes.size === 0);
+export const cleanupListenerBucket = (root, bucket) => {
+    if (bucket.global.size === 0 && isNodeEmpty(bucket.trie))
+        listenerCache.delete(root);
+};
+export const getOrCreateNode = (root, segs) => {
+    let node = root;
+    for (const s of segs) {
+        let next = node.children.get(s);
+        if (!next) {
+            next = { children: new Map(), modes: new Map() };
+            node.children.set(s, next);
+        }
+        node = next;
+    }
+    return node;
+};
+export const getNode = (root, segs) => {
+    let node = root;
+    for (const s of segs) {
+        node = node?.children.get(s);
+        if (!node)
+            return undefined;
+    }
+    return node;
+};
+export const prunePathIfEmpty = (root, segs) => {
+    const stack = [];
+    let node = root;
+    for (const s of segs) {
+        if (!node)
+            return;
+        stack.push({ seg: s, node });
+        node = node.children.get(s);
+    }
+    // node is the target node
+    if (!node)
+        return;
+    // Walk back up pruning empty nodes
+    for (let i = segs.length - 1; i >= 0; i--) {
+        const parent = stack[i].node;
+        const seg = stack[i].seg;
+        const child = parent.children.get(seg);
+        if (child.children.size === 0 && child.modes.size === 0)
+            parent.children.delete(seg);
+        else
+            break;
+    }
+};
+export const addListenerToTrie = (root, segs, mode, listener) => {
+    const node = getOrCreateNode(root, segs);
+    const set = node.modes.get(mode) ?? new Set();
+    set.add(listener);
+    node.modes.set(mode, set);
+    return node;
+};
+export const removeListenerFromTrie = (root, segs, mode, listener) => {
+    const node = getNode(root, segs);
+    if (!node)
+        return;
+    const set = node.modes.get(mode);
+    if (set) {
+        set.delete(listener);
+        if (set.size === 0)
+            node.modes.delete(mode);
+    }
+    prunePathIfEmpty(root, segs);
+};
+//# sourceMappingURL=listener-trie.js.map

package/dist/listener-trie.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listener-trie.js","sourceRoot":"","sources":["../src/listener-trie.ts"],"names":[],"mappings":"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"}

package/dist/nameof.d.ts

@@ -0,0 +1,12 @@
+export type Nameof<T> = (m: T extends object ? T : any) => any;
+/**
+ * Returns either the last part of a objects path  \
+ * or dotted path if the fullPath flag is set to true.
+ */
+export declare const nameof: <const T>(expression: (instance: T) => any) => string;
+/**
+ * Returns a fresh array of path segments captured from the selector expression.
+ * The returned array is a new copy to avoid external mutations affecting internals.
+ */
+export declare const nameofSegments: <const T>(expression: (instance: T) => any) => string[];
+//# sourceMappingURL=nameof.d.ts.map

package/dist/nameof.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nameof.d.ts","sourceRoot":"","sources":["../src/nameof.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,CAAC,GAAG,GAAG,KAAK,GAAG,CAAC;AAG/D;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,GAAG,KAAG,MAKlE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,GAAG,KAAG,MAAM,EAKhF,CAAC"}

package/dist/nameof.js

@@ -0,0 +1,30 @@
+import { normalizePropertyKey } from "./symbol-id.js";
+// nameof property path is stored here for retrieval.
+const propertyThatWasAccessed = [];
+// Proxy objects to store the property path.
+const proxy = new Proxy({}, {
+    get: (_, prop) => {
+        // Normalize to stable id so bracket keys with dots and Symbols become stable segments
+        propertyThatWasAccessed.push(normalizePropertyKey(prop));
+        return proxy;
+    },
+});
+/**
+ * Returns either the last part of a objects path  \
+ * or dotted path if the fullPath flag is set to true.
+ */
+export const nameof = (expression) => {
+    propertyThatWasAccessed.length = 0;
+    expression(proxy);
+    return propertyThatWasAccessed.join('.');
+};
+/**
+ * Returns a fresh array of path segments captured from the selector expression.
+ * The returned array is a new copy to avoid external mutations affecting internals.
+ */
+export const nameofSegments = (expression) => {
+    propertyThatWasAccessed.length = 0;
+    expression(proxy);
+    return propertyThatWasAccessed.slice();
+};
+//# sourceMappingURL=nameof.js.map

package/dist/nameof.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nameof.js","sourceRoot":"","sources":["../src/nameof.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGtD,qDAAqD;AACrD,MAAM,uBAAuB,GAAa,EAAE,CAAC;AAG7C,4CAA4C;AAC5C,MAAM,KAAK,GAAQ,IAAI,KAAK,CAAC,EAAS,EAAE;IACvC,GAAG,EAAE,CAA8B,CAAM,EAAE,IAAO,EAAE,EAAE;QACrD,sFAAsF;QACtF,uBAAuB,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC;QAEzD,OAAO,KAAK,CAAC;IACd,CAAC;CACD,CAAC,CAAC;AAMH;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAU,UAAgC,EAAU,EAAE;IAC3E,uBAAuB,CAAC,MAAM,GAAG,CAAC,CAAC;IACnC,UAAU,CAAC,KAAK,CAAC,CAAC;IAElB,OAAO,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAU,UAAgC,EAAY,EAAE;IACrF,uBAAuB,CAAC,MAAM,GAAG,CAAC,CAAC;IACnC,UAAU,CAAC,KAAK,CAAC,CAAC;IAElB,OAAO,uBAAuB,CAAC,KAAK,EAAE,CAAC;AACxC,CAAC,CAAC"}

package/dist/path-key.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generate a cache key from path segments.
+ *
+ * Uses ASCII Unit Separator (0x1F) as delimiter, which cannot appear in normal
+ * string keys, ensuring unambiguous path separation.
+ *
+ * @param segments - Path segments
+ * @returns Cache key string
+ */
+export declare const pathKeyOf: (segments: string[]) => string;
+//# sourceMappingURL=path-key.d.ts.map

package/dist/path-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-key.d.ts","sourceRoot":"","sources":["../src/path-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,MAAM,EAAE,KAAG,MAA+B,CAAC"}

package/dist/path-key.js

@@ -0,0 +1,11 @@
+/**
+ * Generate a cache key from path segments.
+ *
+ * Uses ASCII Unit Separator (0x1F) as delimiter, which cannot appear in normal
+ * string keys, ensuring unambiguous path separation.
+ *
+ * @param segments - Path segments
+ * @returns Cache key string
+ */
+export const pathKeyOf = (segments) => segments.join('\x1f');
+//# sourceMappingURL=path-key.js.map

package/dist/path-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-key.js","sourceRoot":"","sources":["../src/path-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,QAAkB,EAAU,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC"}

package/dist/path.d.ts

@@ -0,0 +1,7 @@
+export declare const normalizeKey: (prop: PropertyKey) => string;
+export declare const isArrayIndexKey: (k: string) => boolean;
+export declare const getParentAndKey: (root: any, path: string[]) => [any, string] | null;
+export declare const setAtPath: (root: any, path: string[], value: any) => void;
+export declare const deleteAtPath: (root: any, path: string[]) => void;
+export declare const ensureParents: (root: any, path: string[]) => void;
+//# sourceMappingURL=path.d.ts.map

package/dist/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,YAAY,GAAI,MAAM,WAAW,KAAG,MAAoC,CAAC;AAEtF,eAAO,MAAM,eAAe,GAAI,GAAG,MAAM,KAAG,OAAqC,CAAC;AAElF,eAAO,MAAM,eAAe,GAAI,MAAM,GAAG,EAAE,MAAM,MAAM,EAAE,KAAG,CAAE,GAAG,EAAE,MAAM,CAAE,GAAG,IAe7E,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,MAAM,GAAG,EAAE,MAAM,MAAM,EAAE,EAAE,OAAO,GAAG,KAAG,IAOjE,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,MAAM,GAAG,EAAE,MAAM,MAAM,EAAE,KAAG,IAmBxD,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,MAAM,GAAG,EAAE,MAAM,MAAM,EAAE,KAAG,IAazD,CAAC"}

package/dist/path.js

@@ -0,0 +1,53 @@
+import { normalizePropertyKey } from "./symbol-id.js";
+// Normalize property key to a stable string segment (symbols -> sym#id)
+export const normalizeKey = (prop) => normalizePropertyKey(prop);
+export const isArrayIndexKey = (k) => /^(?:0|[1-9]\d*)$/.test(k);
+export const getParentAndKey = (root, path) => {
+    if (path.length === 0)
+        return null;
+    let parent = root;
+    for (const seg of path.slice(0, -1)) {
+        if (parent == null)
+            return null;
+        parent = parent[seg];
+    }
+    const last = path[path.length - 1];
+    return [parent, last];
+};
+export const setAtPath = (root, path, value) => {
+    const res = getParentAndKey(root, path);
+    if (!res)
+        return;
+    const [parent, key] = res;
+    Reflect.set(parent, key, value);
+};
+export const deleteAtPath = (root, path) => {
+    const res = getParentAndKey(root, path);
+    if (!res)
+        return;
+    const [parent, key] = res;
+    if (parent == null)
+        return;
+    // If deleting from an array, prefer splice to avoid holes and adjust length
+    if (Array.isArray(parent) && isArrayIndexKey(String(key))) {
+        const idx = Number(key);
+        if (Number.isInteger(idx))
+            parent.splice(idx, 1);
+        return;
+    }
+    Reflect.deleteProperty(parent, key);
+};
+export const ensureParents = (root, path) => {
+    let node = root;
+    for (let i = 0; i < path.length - 1; i++) {
+        const seg = path[i];
+        let next = node[seg];
+        if (next == null) {
+            const following = path[i + 1];
+            next = /^(?:0|[1-9]\d*)$/.test(following) ? [] : {};
+            node[seg] = next;
+        }
+        node = next;
+    }
+};
+//# sourceMappingURL=path.js.map

package/dist/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"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"}

package/dist/proxy-cache.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Get a cached proxy for the given root and path.
+ *
+ * @param root - The root object
+ * @param pathKey - The path key (from pathKeyOf)
+ * @returns The cached proxy, or undefined if not cached
+ */
+export declare const getCached: (root: object, pathKey: string) => any | undefined;
+/**
+ * Store a proxy in the cache for the given root and path.
+ *
+ * @param root - The root object
+ * @param pathKey - The path key (from pathKeyOf)
+ * @param proxy - The proxy to cache
+ */
+export declare const setCached: (root: object, pathKey: string, proxy: any) => void;
+/**
+ * Invalidate cached proxies at and below the given base path.
+ * Optionally also invalidates the parent path (for array shrinkage).
+ *
+ * @param root - The root object
+ * @param basePath - The base path to invalidate
+ * @param alsoParentArray - Whether to also invalidate the parent path
+ */
+export declare const invalidateAt: (root: object, basePath: string[], alsoParentArray?: boolean) => void;
+/**
+ * Clear all cached proxies for the given root.
+ *
+ * @param root - The root object
+ */
+export declare const clear: (root: object) => void;
+//# sourceMappingURL=proxy-cache.d.ts.map

package/dist/proxy-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-cache.d.ts","sourceRoot":"","sources":["../src/proxy-cache.ts"],"names":[],"mappings":"AAWA;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,KAAG,GAAG,GAAG,SAI/D,CAAC;AAGF;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,EAAE,OAAO,GAAG,KAAG,IAQrE,CAAC;AAGF;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,UAAU,MAAM,EAAE,EAAE,kBAAkB,OAAO,KAAG,IAsB1F,CAAC;AAGF;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,KAAG,IAIpC,CAAC"}

package/dist/proxy-cache.js

@@ -0,0 +1,72 @@
+import { getOptions } from "./history.js";
+import { pathKeyOf } from "./path-key.js";
+/**
+ * Per-root proxy cache: Map<pathKey, proxy>
+ * Enables stable proxy identity when cacheProxies option is enabled.
+ */
+const proxyCache = new WeakMap();
+/**
+ * Get a cached proxy for the given root and path.
+ *
+ * @param root - The root object
+ * @param pathKey - The path key (from pathKeyOf)
+ * @returns The cached proxy, or undefined if not cached
+ */
+export const getCached = (root, pathKey) => {
+    const perRoot = proxyCache.get(root);
+    return perRoot?.get(pathKey);
+};
+/**
+ * Store a proxy in the cache for the given root and path.
+ *
+ * @param root - The root object
+ * @param pathKey - The path key (from pathKeyOf)
+ * @param proxy - The proxy to cache
+ */
+export const setCached = (root, pathKey, proxy) => {
+    let perRoot = proxyCache.get(root);
+    if (!perRoot) {
+        perRoot = new Map();
+        proxyCache.set(root, perRoot);
+    }
+    perRoot.set(pathKey, proxy);
+};
+/**
+ * Invalidate cached proxies at and below the given base path.
+ * Optionally also invalidates the parent path (for array shrinkage).
+ *
+ * @param root - The root object
+ * @param basePath - The base path to invalidate
+ * @param alsoParentArray - Whether to also invalidate the parent path
+ */
+export const invalidateAt = (root, basePath, alsoParentArray) => {
+    const opts = getOptions(root);
+    if (!opts.cacheProxies)
+        return;
+    const perRoot = proxyCache.get(root);
+    if (!perRoot)
+        return;
+    const base = pathKeyOf(basePath);
+    for (const k of Array.from(perRoot.keys())) {
+        if (k === base || k.startsWith(base + '\x1f'))
+            perRoot.delete(k);
+    }
+    if (alsoParentArray) {
+        const parentKey = pathKeyOf(basePath.slice(0, -1));
+        for (const k of Array.from(perRoot.keys())) {
+            if (k === parentKey || k.startsWith(parentKey + '\x1f'))
+                perRoot.delete(k);
+        }
+    }
+};
+/**
+ * Clear all cached proxies for the given root.
+ *
+ * @param root - The root object
+ */
+export const clear = (root) => {
+    const perRoot = proxyCache.get(root);
+    if (perRoot)
+        perRoot.clear();
+};
+//# sourceMappingURL=proxy-cache.js.map

package/dist/proxy-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-cache.js","sourceRoot":"","sources":["../src/proxy-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG1C;;;GAGG;AACH,MAAM,UAAU,GAAsC,IAAI,OAAO,EAAE,CAAC;AAGpE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,OAAe,EAAmB,EAAE;IAC3E,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAErC,OAAO,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC,CAAC;AAGF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,OAAe,EAAE,KAAU,EAAQ,EAAE;IAC5E,IAAI,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,GAAG,IAAI,GAAG,EAAe,CAAC;QACjC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC7B,CAAC,CAAC;AAGF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,QAAkB,EAAE,eAAyB,EAAQ,EAAE;IACjG,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,IAAI,CAAC,YAAY;QACrB,OAAO;IAER,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO;QACX,OAAO;IAER,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG,MAAM,CAAC;YAC5C,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,eAAe,EAAE,CAAC;QACrB,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,GAAG,MAAM,CAAC;gBACtD,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACF,CAAC;AACF,CAAC,CAAC;AAGF;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,IAAY,EAAQ,EAAE;IAC3C,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,OAAO;QACV,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC,CAAC"}

package/dist/proxy-factory.d.ts

@@ -0,0 +1,17 @@
+import { clear as clearProxyCacheInternal, invalidateAt } from './proxy-cache.ts';
+export interface ProxyFactoryDeps {
+    getBatchFrames: (root: object) => {
+        marker: number;
+        id: string;
+    }[] | undefined;
+    setProxyRoot: (proxy: object, root: object) => void;
+}
+export interface ProxyFactory {
+    createProxy: <O extends object>(targetObject: O, path: string[] | undefined, rootObject: object) => O;
+    invalidateCacheAt: (root: object, basePath: string[], alsoParentArray?: boolean) => void;
+    clearProxyCache: (root: object) => void;
+}
+export declare const invalidateCacheAt: typeof invalidateAt;
+export declare const clearProxyCache: typeof clearProxyCacheInternal;
+export declare const createProxyFactory: (deps: ProxyFactoryDeps) => ProxyFactory;
+//# sourceMappingURL=proxy-factory.d.ts.map

package/dist/proxy-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-factory.d.ts","sourceRoot":"","sources":["../src/proxy-factory.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,IAAI,uBAAuB,EAAa,YAAY,EAAa,MAAM,kBAAkB,CAAC;AAKxG,MAAM,WAAW,gBAAgB;IAChC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;KAAE,EAAE,GAAG,SAAS,CAAC;IAChF,YAAY,EAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,YAAY;IAC5B,WAAW,EAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC,CAAC;IAC5G,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,eAAe,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACzF,eAAe,EAAI,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAGD,eAAO,MAAM,iBAAiB,EAAE,OAAO,YAA2B,CAAC;AACnE,eAAO,MAAM,eAAe,EAAE,OAAO,uBAAiD,CAAC;AAGvF,eAAO,MAAM,kBAAkB,GAAI,MAAM,gBAAgB,KAAG,YAyI3D,CAAC"}

package/dist/proxy-factory.js

@@ -0,0 +1,124 @@
+import { captureShrinkRemovals, deleteIndex, isArrayIndexDeletion } from "./array-mutations.js";
+import { adaptMapMethod, adaptSetMethod } from "./collection-adapters.js";
+import { computeActiveGroupId } from "./grouping.js";
+import { getOptions } from "./history.js";
+import { recordArrayShrinkDeletes, recordDelete, recordSet } from "./history-recorder.js";
+import { computeAffectedListeners } from "./listener-affinity.js";
+import { getListenerBucket } from "./listener-trie.js";
+import { normalizeKey } from "./path.js";
+import { pathKeyOf } from "./path-key.js";
+import { clear as clearProxyCacheInternal, getCached, invalidateAt, setCached } from "./proxy-cache.js";
+import { notifyListeners } from "./schedule-queue.js";
+export const invalidateCacheAt = invalidateAt;
+export const clearProxyCache = clearProxyCacheInternal;
+export const createProxyFactory = (deps) => {
+    const createProxy = (targetObject, path = [], rootObject) => {
+        const opts = getOptions(rootObject);
+        if (opts.cacheProxies) {
+            const pathKey = pathKeyOf(path);
+            const cached = getCached(rootObject, pathKey);
+            if (cached)
+                return cached;
+        }
+        const proxy = new Proxy(targetObject, {
+            get(target, prop) {
+                const result = Reflect.get(target, prop);
+                // Map/Set adapters: wrap mutating methods and bind non-mutators to raw target for brand checks
+                const isMap = target instanceof Map;
+                const isSet = target instanceof Set;
+                if ((isMap || isSet) && typeof result === 'function') {
+                    const method = String(prop);
+                    const currentPath = path.slice(); // collection lives at this path
+                    if (isMap) {
+                        const adapted = adaptMapMethod(target, currentPath, rootObject, deps, method);
+                        if (adapted)
+                            return adapted;
+                    }
+                    if (isSet) {
+                        const adapted = adaptSetMethod(target, currentPath, rootObject, deps, method);
+                        if (adapted)
+                            return adapted;
+                    }
+                    // For other methods, bind to raw target to satisfy brand checks
+                    return result.bind(target);
+                }
+                if (!result || typeof result !== 'object')
+                    return result;
+                const currentPath = [...path, normalizeKey(prop)];
+                return createProxy(result, currentPath, rootObject);
+            },
+            set(target, prop, value) {
+                const currentPath = [...path, normalizeKey(prop)];
+                const hadBefore = Reflect.has(target, prop);
+                const oldValue = Reflect.get(target, prop);
+                // Capture elements that will be removed if shrinking array length
+                let removedForLengthShrink = null;
+                if (Array.isArray(target)
+                    && normalizeKey(prop) === 'length'
+                    && typeof oldValue === 'number'
+                    && typeof value === 'number'
+                    && value < oldValue)
+                    removedForLengthShrink = captureShrinkRemovals(target, oldValue, value);
+                const result = Reflect.set(target, prop, value);
+                const bucket = getListenerBucket(rootObject);
+                const activeGroupId = computeActiveGroupId(rootObject, deps.getBatchFrames);
+                // Record change in history
+                recordSet(rootObject, currentPath, oldValue, value, hadBefore, activeGroupId);
+                // If we shrank array length, synthesize delete records for removed indices
+                if (removedForLengthShrink && removedForLengthShrink.length > 0)
+                    recordArrayShrinkDeletes(rootObject, path, removedForLengthShrink, activeGroupId);
+                // Invalidate proxy cache for this path; if shrinking array length, also invalidate the array base
+                const shrinkingArray = Array.isArray(target)
+                    && normalizeKey(prop) === 'length'
+                    && typeof oldValue === 'number'
+                    && typeof value === 'number'
+                    && value < oldValue;
+                invalidateAt(rootObject, currentPath, shrinkingArray);
+                if (bucket) {
+                    const affectedListeners = computeAffectedListeners(rootObject, currentPath);
+                    const meta = { type: 'set', existedBefore: hadBefore, groupId: activeGroupId };
+                    notifyListeners(rootObject, affectedListeners, [currentPath, value, oldValue, meta]);
+                }
+                return result;
+            },
+            deleteProperty(target, prop) {
+                const key = normalizeKey(prop);
+                const currentPath = [...path, key];
+                const oldValue = Reflect.get(target, prop);
+                const hadBefore = Reflect.has(target, prop);
+                let result;
+                // If deleting from an array by numeric index, use splice to avoid holes (parity with undo behavior)
+                if (isArrayIndexDeletion(target, key)) {
+                    const idx = Number(key);
+                    result = deleteIndex(rootObject, target, idx);
+                }
+                else {
+                    result = Reflect.deleteProperty(target, prop);
+                }
+                const bucket = getListenerBucket(rootObject);
+                const activeGroupId = computeActiveGroupId(rootObject, deps.getBatchFrames);
+                // Record change in history
+                recordDelete(rootObject, currentPath, oldValue, activeGroupId);
+                // Invalidate proxy cache for this path and, for array index splice case, also for the array base
+                const isArrayIndex = isArrayIndexDeletion(target, key);
+                invalidateAt(rootObject, currentPath, isArrayIndex);
+                // Notify listeners (deletes affect exact path only and descendants no longer exist)
+                if (bucket) {
+                    const affectedListeners = computeAffectedListeners(rootObject, currentPath);
+                    const meta = { type: 'delete', existedBefore: hadBefore, groupId: activeGroupId };
+                    notifyListeners(rootObject, affectedListeners, [currentPath, undefined, oldValue, meta]);
+                }
+                return result;
+            },
+        });
+        deps.setProxyRoot(proxy, rootObject);
+        // Store in cache if enabled
+        if (opts.cacheProxies) {
+            const pathKey = pathKeyOf(path);
+            setCached(rootObject, pathKey, proxy);
+        }
+        return proxy;
+    };
+    return { createProxy, invalidateCacheAt, clearProxyCache };
+};
+//# sourceMappingURL=proxy-factory.js.map

package/dist/proxy-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-factory.js","sourceRoot":"","sources":["../src/proxy-factory.ts"],"names":[],"mappings":"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"}

package/dist/schedule-queue.d.ts

@@ -0,0 +1,10 @@
+import type { ChangeListener, ChangeMeta, ListenerOptions } from './types.ts';
+export declare const notifyListeners: (root: object, listeners: Set<ChangeListener>, args: [string[], any, any, ChangeMeta | undefined]) => void;
+export declare const pause: (obj: object) => void;
+export declare const resume: (obj: object) => void;
+export declare const flush: (obj: object) => void;
+export declare const buildEffectiveListener: (listener: ChangeListener, options?: ListenerOptions) => {
+    effective: ChangeListener;
+    setUnsubscribe: (fn: () => void) => void;
+};
+//# sourceMappingURL=schedule-queue.d.ts.map

package/dist/schedule-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-queue.d.ts","sourceRoot":"","sources":["../src/schedule-queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAc,MAAM,YAAY,CAAC;AAiB1F,eAAO,MAAM,eAAe,GAC3B,MAAM,MAAM,EACZ,WAAW,GAAG,CAAC,cAAc,CAAC,EAC9B,MAAM,CAAE,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,UAAU,GAAG,SAAS,CAAE,KAClD,IAWF,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,KAAK,MAAM,KAAG,IAMnC,CAAC;AAEF,eAAO,MAAM,MAAM,GAAI,KAAK,MAAM,KAAG,IAUpC,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,KAAK,MAAM,KAAG,IAQnC,CAAC;AAGF,eAAO,MAAM,sBAAsB,GAClC,UAAU,cAAc,EACxB,UAAU,eAAe,KACvB;IAAE,SAAS,EAAE,cAAc,CAAC;IAAC,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CA2ExE,CAAC"}