@arcmantle/chronicle 0.0.4

package/dist/collection-adapters.d.ts

@@ -0,0 +1,29 @@
+export interface CollectionAdapterDeps {
+    getBatchFrames: (root: object) => {
+        marker: number;
+        id: string;
+    }[] | undefined;
+}
+/**
+ * Wrap Map mutating methods to record changes and notify listeners.
+ *
+ * @param target - The Map instance
+ * @param currentPath - The path to the Map
+ * @param rootObject - The root object
+ * @param deps - Dependencies (getBatchFrames)
+ * @param method - The method name being accessed
+ * @returns Wrapped method or undefined if not a mutating method
+ */
+export declare const adaptMapMethod: (target: Map<any, any>, currentPath: string[], rootObject: object, deps: CollectionAdapterDeps, method: string) => ((...args: any[]) => any) | undefined;
+/**
+ * Wrap Set mutating methods to record changes and notify listeners.
+ *
+ * @param target - The Set instance
+ * @param currentPath - The path to the Set
+ * @param rootObject - The root object
+ * @param deps - Dependencies (getBatchFrames)
+ * @param method - The method name being accessed
+ * @returns Wrapped method or undefined if not a mutating method
+ */
+export declare const adaptSetMethod: (target: Set<any>, currentPath: string[], rootObject: object, deps: CollectionAdapterDeps, method: string) => ((...args: any[]) => any) | undefined;
+//# sourceMappingURL=collection-adapters.d.ts.map

package/dist/collection-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-adapters.d.ts","sourceRoot":"","sources":["../src/collection-adapters.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,qBAAqB;IACrC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;KAAE,EAAE,GAAG,SAAS,CAAC;CAChF;AA+BD;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAC1B,QAAQ,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,EACrB,aAAa,MAAM,EAAE,EACrB,YAAY,MAAM,EAClB,MAAM,qBAAqB,EAC3B,QAAQ,MAAM,KACZ,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,GAAG,SA0E9B,CAAC;AAGF;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAC1B,QAAQ,GAAG,CAAC,GAAG,CAAC,EAChB,aAAa,MAAM,EAAE,EACrB,YAAY,MAAM,EAClB,MAAM,qBAAqB,EAC3B,QAAQ,MAAM,KACZ,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,GAAG,SAyE9B,CAAC"}

package/dist/collection-adapters.js

@@ -0,0 +1,184 @@
+import { computeActiveGroupId } from "./grouping.js";
+import { ensureHistory, getOptions, trimHistoryByGroups } from "./history.js";
+import { computeAffectedListeners } from "./listener-affinity.js";
+import { notifyListeners } from "./schedule-queue.js";
+import { clearRedoCache, isSuspended } from "./undo-redo.js";
+/**
+ * Create a history-and-notify callback for Map/Set mutations.
+ * This shared helper records the change and notifies listeners.
+ */
+const createRecordAndNotify = (rootObject, currentPath) => (rec, newValForListener, oldValForListener) => {
+    // Record in history (Map/Set records have collection/key metadata, so push directly)
+    if (!isSuspended(rootObject)) {
+        const history = ensureHistory(rootObject);
+        clearRedoCache(rootObject);
+        const cfg = getOptions(rootObject);
+        if (!cfg?.filter || cfg.filter(rec))
+            history.push(rec);
+        if (cfg && typeof cfg.maxHistory === 'number')
+            trimHistoryByGroups(history, cfg.maxHistory);
+    }
+    // Notify listeners
+    const affected = computeAffectedListeners(rootObject, currentPath);
+    if (affected.size > 0) {
+        const meta = { type: rec.type, existedBefore: rec.existedBefore, groupId: rec.groupId };
+        notifyListeners(rootObject, affected, [currentPath, newValForListener, oldValForListener, meta]);
+    }
+};
+/**
+ * Wrap Map mutating methods to record changes and notify listeners.
+ *
+ * @param target - The Map instance
+ * @param currentPath - The path to the Map
+ * @param rootObject - The root object
+ * @param deps - Dependencies (getBatchFrames)
+ * @param method - The method name being accessed
+ * @returns Wrapped method or undefined if not a mutating method
+ */
+export const adaptMapMethod = (target, currentPath, rootObject, deps, method) => {
+    const recordHistoryAndNotify = createRecordAndNotify(rootObject, currentPath);
+    if (method === 'set') {
+        return function (key, value) {
+            const m = target;
+            const had = m.has(key);
+            const oldV = had ? m.get(key) : undefined;
+            m.set(key, value);
+            const rec = {
+                path: currentPath.slice(),
+                type: 'set',
+                oldValue: oldV,
+                newValue: value,
+                timestamp: Date.now(),
+                existedBefore: had,
+                groupId: computeActiveGroupId(rootObject, deps.getBatchFrames),
+                collection: 'map',
+                key,
+            };
+            recordHistoryAndNotify(rec, value, oldV);
+            return this;
+        };
+    }
+    if (method === 'delete') {
+        return function (key) {
+            const m = target;
+            const had = m.has(key);
+            const oldV = had ? m.get(key) : undefined;
+            const res = m.delete(key);
+            if (had) {
+                const rec = {
+                    path: currentPath.slice(),
+                    type: 'delete',
+                    oldValue: oldV,
+                    newValue: undefined,
+                    timestamp: Date.now(),
+                    groupId: computeActiveGroupId(rootObject, deps.getBatchFrames),
+                    collection: 'map',
+                    key,
+                };
+                recordHistoryAndNotify(rec, undefined, oldV);
+            }
+            return res;
+        };
+    }
+    if (method === 'clear') {
+        return function () {
+            const m = target;
+            const entries = Array.from(m.entries());
+            const gid = computeActiveGroupId(rootObject, deps.getBatchFrames);
+            m.clear();
+            for (const [k, v] of entries) {
+                const rec = {
+                    path: currentPath.slice(),
+                    type: 'delete',
+                    oldValue: v,
+                    newValue: undefined,
+                    timestamp: Date.now(),
+                    groupId: gid,
+                    collection: 'map',
+                    key: k,
+                };
+                recordHistoryAndNotify(rec, undefined, v);
+            }
+        };
+    }
+    return undefined;
+};
+/**
+ * Wrap Set mutating methods to record changes and notify listeners.
+ *
+ * @param target - The Set instance
+ * @param currentPath - The path to the Set
+ * @param rootObject - The root object
+ * @param deps - Dependencies (getBatchFrames)
+ * @param method - The method name being accessed
+ * @returns Wrapped method or undefined if not a mutating method
+ */
+export const adaptSetMethod = (target, currentPath, rootObject, deps, method) => {
+    const recordHistoryAndNotify = createRecordAndNotify(rootObject, currentPath);
+    if (method === 'add') {
+        return function (value) {
+            const s = target;
+            const had = s.has(value);
+            s.add(value);
+            if (!had) {
+                const rec = {
+                    path: currentPath.slice(),
+                    type: 'set',
+                    oldValue: undefined,
+                    newValue: value,
+                    timestamp: Date.now(),
+                    existedBefore: false,
+                    groupId: computeActiveGroupId(rootObject, deps.getBatchFrames),
+                    collection: 'set',
+                    key: value,
+                };
+                recordHistoryAndNotify(rec, value, undefined);
+            }
+            return this; // chaining
+        };
+    }
+    if (method === 'delete') {
+        return function (value) {
+            const s = target;
+            const had = s.has(value);
+            const res = s.delete(value);
+            if (had) {
+                const rec = {
+                    path: currentPath.slice(),
+                    type: 'delete',
+                    oldValue: value,
+                    newValue: undefined,
+                    timestamp: Date.now(),
+                    groupId: computeActiveGroupId(rootObject, deps.getBatchFrames),
+                    collection: 'set',
+                    key: value,
+                };
+                recordHistoryAndNotify(rec, undefined, value);
+            }
+            return res; // boolean
+        };
+    }
+    if (method === 'clear') {
+        return function () {
+            const s = target;
+            const values = Array.from(s.values());
+            const gid = computeActiveGroupId(rootObject, deps.getBatchFrames);
+            s.clear();
+            for (const v of values) {
+                const rec = {
+                    path: currentPath.slice(),
+                    type: 'delete',
+                    oldValue: v,
+                    newValue: undefined,
+                    timestamp: Date.now(),
+                    groupId: gid,
+                    collection: 'set',
+                    key: v,
+                };
+                recordHistoryAndNotify(rec, undefined, v);
+            }
+        };
+    }
+    return undefined;
+};
+//# sourceMappingURL=collection-adapters.js.map

package/dist/collection-adapters.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,7 @@
+import type { ChronicleOptions } from './history.ts';
+export type ConfigureOptions = ChronicleOptions;
+/**
+ * Configure per-root observe behavior by merging options and managing mergeUngrouped window reset.
+ */
+export declare const configureRoot: (root: object, options: ConfigureOptions) => void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAIrD,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAGhD;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,EAAE,SAAS,gBAAgB,KAAG,IAKvE,CAAC"}

package/dist/config.js

@@ -0,0 +1,11 @@
+import { clearLastUngrouped, getOptions, setOptions } from "./history.js";
+/**
+ * Configure per-root observe behavior by merging options and managing mergeUngrouped window reset.
+ */
+export const configureRoot = (root, options) => {
+    const prev = getOptions(root) ?? {};
+    setOptions(root, { ...prev, ...options });
+    if (!options.mergeUngrouped)
+        clearLastUngrouped(root);
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM1E;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,OAAyB,EAAQ,EAAE;IAC9E,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACpC,UAAU,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,CAAC,cAAc;QAC1B,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC,CAAC"}

package/dist/grouping.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Compute the active group ID for a change.
+ *
+ * If inside a batch, uses the current batch frame's ID.
+ * Otherwise, if mergeUngrouped is enabled and within the merge window,
+ * reuses the last ungrouped ID. Otherwise generates a new group ID.
+ *
+ * @param root - The root object
+ * @param getBatchFrames - Function to get batch frames for the root
+ * @param nowProvider - Function to get current timestamp (defaults to Date.now)
+ * @returns The group ID to use for the current change
+ */
+export declare const computeActiveGroupId: (root: object, getBatchFrames: (root: object) => {
+    marker: number;
+    id: string;
+}[] | undefined, nowProvider?: () => number) => string;
+//# sourceMappingURL=grouping.d.ts.map

package/dist/grouping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grouping.d.ts","sourceRoot":"","sources":["../src/grouping.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,GAChC,MAAM,MAAM,EACZ,gBAAgB,CAAC,IAAI,EAAE,MAAM,KAAK;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;CAAE,EAAE,GAAG,SAAS,EAC/E,cAAa,MAAM,MAAiB,KAClC,MA2BF,CAAC"}

package/dist/grouping.js

@@ -0,0 +1,35 @@
+import { clearLastUngrouped, getLastUngrouped, getOptions, nextGroupId, setLastUngrouped } from "./history.js";
+/**
+ * Compute the active group ID for a change.
+ *
+ * If inside a batch, uses the current batch frame's ID.
+ * Otherwise, if mergeUngrouped is enabled and within the merge window,
+ * reuses the last ungrouped ID. Otherwise generates a new group ID.
+ *
+ * @param root - The root object
+ * @param getBatchFrames - Function to get batch frames for the root
+ * @param nowProvider - Function to get current timestamp (defaults to Date.now)
+ * @returns The group ID to use for the current change
+ */
+export const computeActiveGroupId = (root, getBatchFrames, nowProvider = Date.now) => {
+    const batchFrames = getBatchFrames(root);
+    if (batchFrames && batchFrames.length > 0)
+        return batchFrames[batchFrames.length - 1].id;
+    const opts = getOptions(root);
+    if (opts && opts.mergeUngrouped) {
+        const now = nowProvider();
+        const prev = getLastUngrouped(root);
+        const within = opts.mergeWindowMs == null
+            || (prev ? (now - prev.at) <= opts.mergeWindowMs : false);
+        if (prev && within) {
+            setLastUngrouped(root, { id: prev.id, at: now });
+            return prev.id;
+        }
+        const gid = nextGroupId(root);
+        setLastUngrouped(root, { id: gid, at: now });
+        return gid;
+    }
+    clearLastUngrouped(root);
+    return nextGroupId(root);
+};
+//# sourceMappingURL=grouping.js.map

package/dist/grouping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grouping.js","sourceRoot":"","sources":["../src/grouping.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAG/G;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CACnC,IAAY,EACZ,cAA+E,EAC/E,cAA4B,IAAI,CAAC,GAAG,EAC3B,EAAE;IACX,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;QACxC,OAAO,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,EAAE,CAAC;IAEhD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,IAAI,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI;eACrC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAE3D,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;YACpB,gBAAgB,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YAEjD,OAAO,IAAI,CAAC,EAAE,CAAC;QAChB,CAAC;QAED,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAC9B,gBAAgB,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QAE7C,OAAO,GAAG,CAAC;IACZ,CAAC;IAED,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAEzB,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC,CAAC"}

package/dist/history-recorder.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Record a 'set' operation in history with filtering, compaction, and trimming.
+ *
+ * Handles optional compaction of consecutive sets on the same path within the same group,
+ * avoiding compaction of array indices and length properties.
+ *
+ * @param root - The root object
+ * @param path - The path where the set occurred
+ * @param oldValue - The previous value
+ * @param newValue - The new value
+ * @param existedBefore - Whether the property existed before
+ * @param groupId - The group ID for this change
+ */
+export declare const recordSet: (root: object, path: string[], oldValue: any, newValue: any, existedBefore: boolean, groupId: string) => void;
+/**
+ * Record a 'delete' operation in history with filtering and trimming.
+ *
+ * @param root - The root object
+ * @param path - The path where the delete occurred
+ * @param oldValue - The value that was deleted
+ * @param groupId - The group ID for this change
+ */
+export declare const recordDelete: (root: object, path: string[], oldValue: any, groupId: string) => void;
+/**
+ * Record delete operations for array elements removed by length shrinkage.
+ *
+ * Used when array.length is decreased, synthesizing delete records for removed indices.
+ * Does not apply compaction or other optimizations - just records the deletes.
+ *
+ * @param root - The root object
+ * @param basePath - The path to the array (not including indices)
+ * @param removed - Array of {index, value} pairs that were removed
+ * @param groupId - The group ID for these changes
+ */
+export declare const recordArrayShrinkDeletes: (root: object, basePath: string[], removed: {
+    index: number;
+    value: any;
+}[], groupId: string) => void;
+//# sourceMappingURL=history-recorder.d.ts.map

package/dist/history-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-recorder.d.ts","sourceRoot":"","sources":["../src/history-recorder.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,SAAS,GACrB,MAAM,MAAM,EACZ,MAAM,MAAM,EAAE,EACd,UAAU,GAAG,EACb,UAAU,GAAG,EACb,eAAe,OAAO,EACtB,SAAS,MAAM,KACb,IA2CF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GACxB,MAAM,MAAM,EACZ,MAAM,MAAM,EAAE,EACd,UAAU,GAAG,EACb,SAAS,MAAM,KACb,IAuBF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,GACpC,MAAM,MAAM,EACZ,UAAU,MAAM,EAAE,EAClB,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC;CAAE,EAAE,EACzC,SAAS,MAAM,KACb,IAoBF,CAAC"}

package/dist/history-recorder.js

@@ -0,0 +1,112 @@
+import { ensureHistory, getOptions, trimHistoryByGroups } from "./history.js";
+import { clearRedoCache, isSuspended } from "./undo-redo.js";
+/**
+ * Record a 'set' operation in history with filtering, compaction, and trimming.
+ *
+ * Handles optional compaction of consecutive sets on the same path within the same group,
+ * avoiding compaction of array indices and length properties.
+ *
+ * @param root - The root object
+ * @param path - The path where the set occurred
+ * @param oldValue - The previous value
+ * @param newValue - The new value
+ * @param existedBefore - Whether the property existed before
+ * @param groupId - The group ID for this change
+ */
+export const recordSet = (root, path, oldValue, newValue, existedBefore, groupId) => {
+    if (isSuspended(root))
+        return;
+    const history = ensureHistory(root);
+    clearRedoCache(root);
+    const cfg = getOptions(root);
+    const rec = {
+        path: path.slice(),
+        type: 'set',
+        oldValue,
+        newValue,
+        timestamp: Date.now(),
+        existedBefore,
+        groupId,
+    };
+    if (!cfg?.filter || cfg.filter(rec))
+        history.push(rec);
+    // Optional compaction: merge consecutive sets on the same path within the same group
+    if (cfg && cfg.compactConsecutiveSamePath && history.length >= 2) {
+        const a = history[history.length - 2];
+        const b = history[history.length - 1];
+        const sameGroup = (a.groupId ?? `__g#${history.length - 2}`) === (b.groupId ?? `__g#${history.length - 1}`);
+        const samePath = a.path.length === b.path.length && a.path.every((seg, i) => seg === b.path[i]);
+        const isSetSet = a.type === 'set' && b.type === 'set';
+        // Avoid compacting array index updates and length changes
+        const lastSeg = b.path[b.path.length - 1];
+        const isArrayIndex = /^(?:0|[1-9]\d*)$/.test(lastSeg);
+        const isLengthProp = lastSeg === 'length';
+        if (sameGroup && samePath && isSetSet && !isArrayIndex && !isLengthProp) {
+            // Merge: keep 'a' with oldValue from original and update newValue/timestamp from 'b'; drop 'b'
+            a.newValue = b.newValue;
+            a.timestamp = b.timestamp;
+            history.pop();
+        }
+    }
+    // Enforce maxHistory by trimming whole groups from the front
+    if (cfg && typeof cfg.maxHistory === 'number')
+        trimHistoryByGroups(history, cfg.maxHistory);
+};
+/**
+ * Record a 'delete' operation in history with filtering and trimming.
+ *
+ * @param root - The root object
+ * @param path - The path where the delete occurred
+ * @param oldValue - The value that was deleted
+ * @param groupId - The group ID for this change
+ */
+export const recordDelete = (root, path, oldValue, groupId) => {
+    if (isSuspended(root))
+        return;
+    const history = ensureHistory(root);
+    clearRedoCache(root);
+    const cfg = getOptions(root);
+    const rec = {
+        path: path.slice(),
+        type: 'delete',
+        oldValue,
+        newValue: undefined,
+        timestamp: Date.now(),
+        groupId,
+    };
+    if (!cfg?.filter || cfg.filter(rec))
+        history.push(rec);
+    // Enforce maxHistory by trimming whole groups from the front
+    if (cfg && typeof cfg.maxHistory === 'number')
+        trimHistoryByGroups(history, cfg.maxHistory);
+};
+/**
+ * Record delete operations for array elements removed by length shrinkage.
+ *
+ * Used when array.length is decreased, synthesizing delete records for removed indices.
+ * Does not apply compaction or other optimizations - just records the deletes.
+ *
+ * @param root - The root object
+ * @param basePath - The path to the array (not including indices)
+ * @param removed - Array of {index, value} pairs that were removed
+ * @param groupId - The group ID for these changes
+ */
+export const recordArrayShrinkDeletes = (root, basePath, removed, groupId) => {
+    if (isSuspended(root) || removed.length === 0)
+        return;
+    const history = ensureHistory(root);
+    const cfg = getOptions(root);
+    for (const { index, value: oldVal } of removed) {
+        const rec = {
+            path: [...basePath, String(index)],
+            type: 'delete',
+            oldValue: oldVal,
+            newValue: undefined,
+            timestamp: Date.now(),
+            groupId,
+        };
+        if (!cfg?.filter || cfg.filter(rec))
+            history.push(rec);
+    }
+};
+//# sourceMappingURL=history-recorder.js.map

package/dist/history-recorder.js.map

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

package/dist/history.d.ts

@@ -0,0 +1,29 @@
+import type { ChangeRecord } from './types.ts';
+export interface ChronicleOptions {
+    mergeUngrouped?: boolean;
+    mergeWindowMs?: number;
+    compactConsecutiveSamePath?: boolean;
+    maxHistory?: number;
+    filter?: (record: ChangeRecord) => boolean;
+    clone?: (value: any) => any;
+    compare?: (a: any, b: any, path: string[]) => boolean;
+    diffFilter?: (path: string[]) => boolean | 'shallow';
+    cacheProxies?: boolean;
+}
+export declare const ensureHistory: (root: object) => ChangeRecord[];
+export declare const historyGet: (root: object) => ChangeRecord[] | undefined;
+export declare const historyDelete: (root: object) => void;
+export declare const trimHistoryByGroups: (history: ChangeRecord[], max: number) => void;
+export declare const nextGroupId: (root: object) => string;
+export declare const getOptions: (root: object) => ChronicleOptions;
+export declare const setOptions: (root: object, options: ChronicleOptions) => void;
+export declare const getLastUngrouped: (root: object) => {
+    id: string;
+    at: number;
+} | undefined;
+export declare const setLastUngrouped: (root: object, v: {
+    id: string;
+    at: number;
+}) => void;
+export declare const clearLastUngrouped: (root: object) => void;
+//# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAU/C,MAAM,WAAW,gBAAgB;IAChC,cAAc,CAAC,EAAc,OAAO,CAAC;IACrC,aAAa,CAAC,EAAe,MAAM,CAAC;IACpC,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,UAAU,CAAC,EAAkB,MAAM,CAAC;IACpC,MAAM,CAAC,EAAsB,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC;IAC/D,KAAK,CAAC,EAAuB,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC;IACjD,OAAO,CAAC,EAAqB,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;IACzE,UAAU,CAAC,EAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,GAAG,SAAS,CAAC;IACrE,YAAY,CAAC,EAAgB,OAAO,CAAC;CACrC;AAID,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,YAAY,EAQxD,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,YAAY,EAAE,GAAG,SAAmC,CAAC;AAC/F,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,IAAsC,CAAC;AAIpF,eAAO,MAAM,mBAAmB,GAAI,SAAS,YAAY,EAAE,EAAE,KAAK,MAAM,KAAG,IAqB1E,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MAK1C,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,gBAAgD,CAAC;AAC3F,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,EAAE,SAAS,gBAAgB,KAAG,IAA4C,CAAC;AAElH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;CAAE,GAAG,SAAoC,CAAC;AACnH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,EAAE,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;CAAE,KAAG,IAAuC,CAAC;AACxH,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,IAAuC,CAAC"}

package/dist/history.js

@@ -0,0 +1,47 @@
+// History records per root
+const historyCache = new WeakMap();
+// Group/merge state per root
+const groupCounter = new WeakMap();
+const lastUngrouped = new WeakMap();
+const optionsCache = new WeakMap();
+export const ensureHistory = (root) => {
+    let h = historyCache.get(root);
+    if (!h) {
+        h = [];
+        historyCache.set(root, h);
+    }
+    return h;
+};
+export const historyGet = (root) => historyCache.get(root);
+export const historyDelete = (root) => { historyCache.delete(root); };
+// Trim history by removing whole groups from the front until length <= max.
+// This keeps undoGroups coherent and avoids splitting groups.
+export const trimHistoryByGroups = (history, max) => {
+    if (!(typeof max === 'number') || max < 0)
+        return;
+    if (history.length <= max)
+        return;
+    let removeCount = 0;
+    let i = 0;
+    while (history.length - removeCount > max && i < history.length) {
+        const gid = history[i].groupId ?? `__g#${i}`;
+        let j = i;
+        while (j < history.length && (history[j].groupId ?? `__g#${j}`) === gid)
+            j++;
+        removeCount += (j - i);
+        i = j;
+    }
+    if (removeCount > 0)
+        history.splice(0, removeCount);
+};
+export const nextGroupId = (root) => {
+    const n = (groupCounter.get(root) ?? 0) + 1;
+    groupCounter.set(root, n);
+    return `g${n}`;
+};
+export const getOptions = (root) => optionsCache.get(root) ?? {};
+export const setOptions = (root, options) => { optionsCache.set(root, options); };
+export const getLastUngrouped = (root) => lastUngrouped.get(root);
+export const setLastUngrouped = (root, v) => { lastUngrouped.set(root, v); };
+export const clearLastUngrouped = (root) => { lastUngrouped.delete(root); };
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

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

package/dist/listener-affinity.d.ts

@@ -0,0 +1,16 @@
+import type { ChangeListener } from './types.ts';
+/**
+ * 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 declare const computeAffectedListeners: (root: object, path: string[]) => Set<ChangeListener>;
+//# sourceMappingURL=listener-affinity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"listener-affinity.d.ts","sourceRoot":"","sources":["../src/listener-affinity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,YAAY,CAAC;AAG/D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,EAAE,KAAG,GAAG,CAAC,cAAc,CAmDzF,CAAC"}