mutts 1.0.4 → 1.0.5

package/dist/chunks/{index-79Kk8D6e.esm.js → index-qiWwozOc.esm.js}

@@ -352,6 +352,10 @@ const prototypeForwarding = Symbol('prototype-forwarding');
  * Symbol representing all properties in reactive tracking
  */
 const allProps = Symbol('all-props');
+/**
+ * Symbol for accessing projection information on reactive objects
+ */
+const projectionInfo = Symbol('projection-info');
 // Symbol to mark functions with their root function
 const rootFunction = Symbol('root-function');
 /**
@@ -426,6 +430,12 @@ const options = {
      * @default 100
      */
     maxEffectChain: 100,
+    /**
+     * Maximum number of times an effect can be triggered by the same cause in a single batch
+     * Used to detect aggressive re-computation or infinite loops
+     * @default 10
+     */
+    maxTriggerPerBatch: 10,
     /**
      * Debug purpose: maximum effect reaction (like call stack max depth)
      * Used to prevent infinite loops
@@ -1258,6 +1268,50 @@ function formatRoots(roots, limit = 20) {
     const end = names.slice(-10);
     return `${start.join(' → ')} ... (${names.length - 15} more) ... ${end.join(' → ')}`;
 }
+// Nested map structure for efficient counting and batch cleanup
+// batchId -> effect root -> obj -> prop -> count
+let activationRegistry;
+const activationLog = new Array(100);
+function getActivationLog() {
+    return activationLog;
+}
+function recordActivation(effect, obj, evolution, prop) {
+    const root = getRoot(effect);
+    if (!activationRegistry)
+        return;
+    let effectData = activationRegistry.get(root);
+    if (!effectData) {
+        effectData = new Map();
+        activationRegistry.set(root, effectData);
+    }
+    let objData = effectData.get(obj);
+    if (!objData) {
+        objData = new Map();
+        effectData.set(obj, objData);
+    }
+    const count = (objData.get(prop) ?? 0) + 1;
+    objData.set(prop, count);
+    // Keep a limited history for diagnostics
+    activationLog.unshift({
+        effect,
+        obj,
+        evolution,
+        prop,
+    });
+    activationLog.pop();
+    if (count >= options.maxTriggerPerBatch) {
+        const effectName = root?.name || 'anonymous';
+        const message = `Aggressive trigger detected: effect "${effectName}" triggered ${count} times in the batch by the same cause.`;
+        if (options.maxEffectReaction === 'throw') {
+            throw new ReactiveError(message, {
+                code: ReactiveErrorCode.MaxReactionExceeded,
+                count,
+                effect: effectName,
+            });
+        }
+        options.warn(`[reactive] ${message}`);
+    }
+}
 /**
  * Registers a debug callback that is called when the current effect is triggered by a dependency change
  *
@@ -1547,6 +1601,9 @@ function cleanupEffectFromGraph(effect) {
 // Track currently executing effects to prevent re-execution
 // These are all the effects triggered under `activeEffect`
 let batchQueue;
+function hasBatched(effect) {
+    return batchQueue?.all.has(getRoot(effect));
+}
 const batchCleanups = new Set();
 /**
  * Computes and caches in-degrees for all effects in the batch
@@ -1972,6 +2029,10 @@ function batch(effect, immediate) {
     }
     else {
         // New batch - initialize
+        if (!activationRegistry)
+            activationRegistry = new Map();
+        else
+            throw new Error('Batch already in progress');
         options.beginChain(roots);
         batchQueue = {
             all: new Map(),
@@ -2050,6 +2111,7 @@ function batch(effect, immediate) {
                 return firstReturn.value;
             }
             finally {
+                activationRegistry = undefined;
                 batchQueue = undefined;
                 options.endChain();
             }
@@ -2120,6 +2182,7 @@ function batch(effect, immediate) {
                 return firstReturn.value;
             }
             finally {
+                activationRegistry = undefined;
                 batchQueue = undefined;
                 options.endChain();
             }
@@ -2489,7 +2552,11 @@ function collectEffects(obj, evolution, effects, objectWatchers, ...keyChains) {
                         options.skipRunningEffect(effect, runningChain);
                         continue;
                     }
-                    effects.add(effect);
+                    if (!effects.has(effect)) {
+                        effects.add(effect);
+                        if (!hasBatched(effect))
+                            recordActivation(effect, obj, evolution, key);
+                    }
                     const trackers = effectTrackers.get(effect);
                     recordTriggerLink(sourceEffect, effect, obj, key, evolution);
                     if (trackers) {
@@ -2557,6 +2624,7 @@ function touchedOpaque(obj, evolution, prop) {
             continue;
         }
         effects.add(effect);
+        recordActivation(effect, obj, evolution, prop);
         const trackers = effectTrackers.get(effect);
         recordTriggerLink(sourceEffect, effect, obj, prop, evolution);
         if (trackers) {
@@ -3345,7 +3413,6 @@ function* makeReactiveEntriesIterator(iterator) {
 const native$2 = Symbol('native');
 const isArray = Array.isArray;
 Array.isArray = ((value) => isArray(value) ||
-    // biome-ignore lint/suspicious/useIsArray: We are defining it
     (value &&
         typeof value === 'object' &&
         prototypeForwarding in value &&
@@ -4241,6 +4308,17 @@ function register(keyFn, initial) {
     return new RegisterClass(keyFn, initial);
 }
 
+/**
+ * Maps projection effects (item effects) to their projection context
+ */
+const effectProjectionMetadata = new WeakMap();
+/**
+ * Returns the projection context of the currently running effect, if any.
+ */
+function getActiveProjection() {
+    const active = getActiveEffect();
+    return active ? effectProjectionMetadata.get(active) : undefined;
+}
 function defineAccessValue(access) {
     Object.defineProperty(access, 'value', {
         get: access.get,
@@ -4249,7 +4327,15 @@ function defineAccessValue(access) {
         enumerable: true,
     });
 }
-function makeCleanup(target, effectMap, onDispose) {
+function makeCleanup(target, effectMap, onDispose, metadata) {
+    if (metadata) {
+        Object.defineProperty(target, projectionInfo, {
+            value: metadata,
+            writable: false,
+            enumerable: false,
+            configurable: true,
+        });
+    }
     return cleanedBy(target, () => {
         onDispose();
         for (const stop of effectMap.values())
@@ -4272,6 +4358,8 @@ function projectArray(source, apply) {
             Reflect.deleteProperty(target, index);
         }
     }
+    const parent = getActiveProjection();
+    const depth = parent ? parent.depth + 1 : 0;
     const cleanupLength = effect(function projectArrayLengthEffect({ ascend }) {
         const length = observedSource.length;
         normalizeTargetLength(length);
@@ -4294,6 +4382,14 @@ function projectArray(source, apply) {
                     const produced = apply(accessBase, target);
                     target[index] = produced;
                 });
+                setEffectName(stop, `project[${depth}]:${index}`);
+                effectProjectionMetadata.set(stop, {
+                    source: observedSource,
+                    key: index,
+                    target,
+                    depth,
+                    parent,
+                });
                 indexEffects.set(i, stop);
             });
         }
@@ -4301,7 +4397,13 @@ function projectArray(source, apply) {
             if (index >= length)
                 disposeIndex(index);
     });
-    return makeCleanup(target, indexEffects, () => cleanupLength());
+    return makeCleanup(target, indexEffects, () => cleanupLength(), {
+        source: observedSource,
+        target,
+        apply,
+        depth,
+        parent,
+    });
 }
 function projectRegister(source, apply) {
     const observedSource = reactive(source);
@@ -4316,6 +4418,8 @@ function projectRegister(source, apply) {
             target.delete(key);
         }
     }
+    const parent = getActiveProjection();
+    const depth = parent ? parent.depth + 1 : 0;
     const cleanupKeys = effect(function projectRegisterEffect({ ascend }) {
         const keys = new Set();
         for (const key of observedSource.mapKeys())
@@ -4340,6 +4444,14 @@ function projectRegister(source, apply) {
                     const produced = apply(accessBase, target);
                     target.set(key, produced);
                 });
+                setEffectName(stop, `project[${depth}]:${String(key)}`);
+                effectProjectionMetadata.set(stop, {
+                    source: observedSource,
+                    key,
+                    target,
+                    depth,
+                    parent,
+                });
                 keyEffects.set(key, stop);
             });
         }
@@ -4347,7 +4459,13 @@ function projectRegister(source, apply) {
             if (!keys.has(key))
                 disposeKey(key);
     });
-    return makeCleanup(target, keyEffects, () => cleanupKeys());
+    return makeCleanup(target, keyEffects, () => cleanupKeys(), {
+        source: observedSource,
+        target,
+        apply,
+        depth,
+        parent,
+    });
 }
 function projectRecord(source, apply) {
     const observedSource = reactive(source);
@@ -4361,6 +4479,8 @@ function projectRecord(source, apply) {
             Reflect.deleteProperty(target, key);
         }
     }
+    const parent = getActiveProjection();
+    const depth = parent ? parent.depth + 1 : 0;
     const cleanupKeys = effect(function projectRecordEffect({ ascend }) {
         const keys = new Set();
         for (const key in observedSource)
@@ -4386,6 +4506,14 @@ function projectRecord(source, apply) {
                     const produced = apply(accessBase, target);
                     target[sourceKey] = produced;
                 });
+                setEffectName(stop, `project[${depth}]:${String(key)}`);
+                effectProjectionMetadata.set(stop, {
+                    source: observedSource,
+                    key,
+                    target,
+                    depth,
+                    parent,
+                });
                 keyEffects.set(key, stop);
             });
         }
@@ -4393,7 +4521,13 @@ function projectRecord(source, apply) {
             if (!keys.has(key))
                 disposeKey(key);
     });
-    return makeCleanup(target, keyEffects, () => cleanupKeys());
+    return makeCleanup(target, keyEffects, () => cleanupKeys(), {
+        source: observedSource,
+        target,
+        apply,
+        depth,
+        parent,
+    });
 }
 function projectMap(source, apply) {
     const observedSource = reactive(source);
@@ -4408,6 +4542,8 @@ function projectMap(source, apply) {
             target.delete(key);
         }
     }
+    const parent = getActiveProjection();
+    const depth = parent ? parent.depth + 1 : 0;
     const cleanupKeys = effect(function projectMapEffect({ ascend }) {
         const keys = new Set();
         for (const key of observedSource.keys())
@@ -4432,6 +4568,14 @@ function projectMap(source, apply) {
                     const produced = apply(accessBase, target);
                     target.set(key, produced);
                 });
+                setEffectName(stop, `project[${depth}]:${String(key)}`);
+                effectProjectionMetadata.set(stop, {
+                    source: observedSource,
+                    key,
+                    target,
+                    depth,
+                    parent,
+                });
                 keyEffects.set(key, stop);
             });
         }
@@ -4439,7 +4583,13 @@ function projectMap(source, apply) {
             if (!keys.has(key))
                 disposeKey(key);
     });
-    return makeCleanup(target, keyEffects, () => cleanupKeys());
+    return makeCleanup(target, keyEffects, () => cleanupKeys(), {
+        source: observedSource,
+        target,
+        apply,
+        depth,
+        parent,
+    });
 }
 function projectCore(source, apply) {
     if (Array.isArray(source))
@@ -4587,7 +4737,7 @@ class ReactiveWeakMap {
         Object.defineProperties(this, {
             [native$1]: { value: original },
             [prototypeForwarding]: { value: original },
-            content: { value: Symbol('content') },
+            content: { value: Symbol('WeakMapContent') },
             [Symbol.toStringTag]: { value: 'ReactiveWeakMap' },
         });
     }
@@ -4627,7 +4777,7 @@ class ReactiveMap {
         Object.defineProperties(this, {
             [native$1]: { value: original },
             [prototypeForwarding]: { value: original },
-            content: { value: Symbol('content') },
+            content: { value: Symbol('MapContent') },
             [Symbol.toStringTag]: { value: 'ReactiveMap' },
         });
     }
@@ -4722,7 +4872,7 @@ class ReactiveWeakSet {
         Object.defineProperties(this, {
             [native]: { value: original },
             [prototypeForwarding]: { value: original },
-            content: { value: Symbol('content') },
+            content: { value: Symbol('WeakSetContent') },
             [Symbol.toStringTag]: { value: 'ReactiveWeakSet' },
         });
     }
@@ -4757,7 +4907,7 @@ class ReactiveSet {
         Object.defineProperties(this, {
             [native]: { value: original },
             [prototypeForwarding]: { value: original },
-            content: { value: Symbol('content') },
+            content: { value: Symbol('SetContent') },
             [Symbol.toStringTag]: { value: 'ReactiveSet' },
         });
     }
@@ -4853,5 +5003,5 @@ const profileInfo = {
     nonReactiveObjects,
 };
 
-export { derived as A, unreactive as B, watch as C, mapped as D, reduced as E, memoize as F, immutables as G, isNonReactive as H, IterableWeakMap as I, registerNativeReactivity as J, project as K, isReactive as L, ReactiveBase as M, reactive as N, unwrap as O, organize as P, organized as Q, ReadOnlyError as R, Register as S, register as T, options as U, ReactiveError as V, isZoneEnabled as W, setZoneEnabled as X, IterableWeakSet as a, touched1 as b, buildReactivityGraph as c, registerObjectForDebug as d, enableDevTools as e, setObjectName as f, getState as g, deepWatch as h, isDevtoolsEnabled as i, addBatchCleanup as j, atomic as k, batch as l, mixin as m, biDi as n, defer as o, profileInfo as p, effect as q, registerEffectForDebug as r, setEffectName as s, touched as t, getActiveEffect as u, root as v, trackEffect as w, untracked as x, cleanedBy as y, cleanup as z };
-//# sourceMappingURL=index-79Kk8D6e.esm.js.map
+export { cleanup as A, derived as B, unreactive as C, watch as D, mapped as E, reduced as F, memoize as G, immutables as H, IterableWeakMap as I, isNonReactive as J, registerNativeReactivity as K, getActiveProjection as L, project as M, isReactive as N, ReactiveBase as O, reactive as P, unwrap as Q, ReadOnlyError as R, organize as S, organized as T, Register as U, register as V, options as W, ReactiveError as X, isZoneEnabled as Y, setZoneEnabled as Z, IterableWeakSet as a, touched1 as b, buildReactivityGraph as c, registerObjectForDebug as d, enableDevTools as e, setObjectName as f, getState as g, deepWatch as h, isDevtoolsEnabled as i, addBatchCleanup as j, atomic as k, batch as l, mixin as m, biDi as n, defer as o, profileInfo as p, effect as q, registerEffectForDebug as r, setEffectName as s, touched as t, getActivationLog as u, getActiveEffect as v, root as w, trackEffect as x, untracked as y, cleanedBy as z };
+//# sourceMappingURL=index-qiWwozOc.esm.js.map