@but212/atom-effect 0.12.0 → 0.13.0

package/dist/index.d.ts

@@ -333,9 +333,27 @@ export declare interface EffectOptions {
     onError?: (error: unknown) => void;
 }
 
+/** Internal atom interface for core library usage. */
+export declare interface IAtom {
+    /** Numerical ID for the node. */
+    readonly id: number;
+    /** Current version of the node's value. */
+    version: number;
+    /** Internal method to trigger subscriber notifications. */
+    _internalNotifySubscribers(): void;
+    /** Internal method to trigger recomputation. */
+    recompute?(): void;
+}
+
 /** Checks if the given object is a ReadonlyAtom. */
 export declare function isAtom(obj: unknown): obj is ReadonlyAtom;
 
+/** Internal scheduler interface to break circular dependencies. */
+export declare interface IScheduler<T> {
+    markDirty(atom: T): void;
+    scheduleNotify(atom: T): void;
+}
+
 /** Checks if the given object is a ComputedAtom. */
 export declare function isComputed(obj: unknown): obj is ComputedAtom;
 
@@ -368,6 +386,24 @@ export declare interface Poolable {
     reset(): void;
 }
 
+/** Statistics for pool usage and health. */
+export declare interface PoolStats {
+    /** Number of items acquired from the pool. */
+    acquired: number;
+    /** Number of items released back to the pool. */
+    released: number;
+    /** Details for items that could not be returned to the pool. */
+    rejected: {
+        frozen: number;
+        tooLarge: number;
+        poolFull: number;
+    };
+    /** Approximate number of items that have leaked (not released or rejected). */
+    leaked: number;
+    /** Current number of items available in the pool. */
+    poolSize: number;
+}
+
 /** Represents a read-only reactive atom. */
 export declare interface ReadonlyAtom<T = unknown> {
     /** The current value of the atom. Accessing this tracks it as a dependency. */

package/dist/index.mjs

@@ -29,7 +29,7 @@ const ee = {
 }, T = {
   SYNC: 1,
   NOTIFICATION_SCHEDULED: 2
-}, be = {
+}, ye = {
   /** Maximum number of pooled objects to prevent memory bloat */
   MAX_SIZE: 1e3,
   /** Number of objects to pre-allocate for performance-critical paths */
@@ -53,12 +53,12 @@ const ee = {
   MAX_FLUSH_ITERATIONS: 1e3,
   /** Minimum allowed value for max flush iterations */
   MIN_FLUSH_ITERATIONS: 10
-}, B = {
+}, j = {
   /** Maximum dependencies before warning about large dependency graphs */
   MAX_DEPENDENCIES: 1e3,
   /** Enable infinite loop detection warnings */
   WARN_INFINITE_LOOP: !0
-}, b = 1073741823, w = 1 << 19, l = typeof process < "u" && process.env && process.env.NODE_ENV !== "production", te = Object.freeze([]);
+}, b = 1073741823, te = 20, w = 1 << te - 1, l = typeof process < "u" && process.env && process.env.NODE_ENV !== "production", se = Object.freeze([]);
 class g extends Error {
   /**
    * Creates a new AtomError
@@ -152,8 +152,8 @@ const u = {
    * @remarks This prevents cascading failures from masking the original error.
    */
   CALLBACK_ERROR_IN_ERROR_HANDLER: "Error occurred during onError callback execution"
-}, M = /* @__PURE__ */ Symbol("debugName"), se = /* @__PURE__ */ Symbol("id"), V = /* @__PURE__ */ Symbol("type"), k = /* @__PURE__ */ Symbol("noDefaultValue");
-function ie(s) {
+}, M = /* @__PURE__ */ Symbol("debugName"), ie = /* @__PURE__ */ Symbol("id"), V = /* @__PURE__ */ Symbol("type"), k = /* @__PURE__ */ Symbol("noDefaultValue");
+function ne(s) {
   return "dependencies" in s && Array.isArray(s.dependencies);
 }
 let Q = 0;
@@ -161,7 +161,7 @@ function G(s, e, t) {
   if (s._visitedEpoch !== t) {
     if (s._visitedEpoch = t, s === e)
       throw new D("Indirect circular dependency detected");
-    if (ie(s)) {
+    if (ne(s)) {
       const i = s.dependencies;
       for (let n = 0; n < i.length; n++) {
         const r = i[n];
@@ -172,8 +172,8 @@ function G(s, e, t) {
 }
 const p = {
   enabled: typeof process < "u" && process.env?.NODE_ENV === "development",
-  maxDependencies: B.MAX_DEPENDENCIES,
-  warnInfiniteLoop: B.WARN_INFINITE_LOOP,
+  maxDependencies: j.MAX_DEPENDENCIES,
+  warnInfiniteLoop: j.WARN_INFINITE_LOOP,
   warn(s, e) {
     this.enabled && s && console.warn(`[Atom Effect] ${e}`);
   },
@@ -191,7 +191,7 @@ const p = {
     if (!this.enabled)
       return;
     const i = s;
-    i[M] = `${e}_${t}`, i[se] = t, i[V] = e;
+    i[M] = `${e}_${t}`, i[ie] = t, i[V] = e;
   },
   getDebugName(s) {
     if (s != null && M in s)
@@ -202,11 +202,11 @@ const p = {
       return s[V];
   }
 };
-let ne = 1;
-const re = () => ne++;
+let re = 1;
+const oe = () => re++;
 class Y {
   constructor() {
-    this.flags = 0, this.version = 0, this._lastSeenEpoch = -1, this.id = re() & b;
+    this.flags = 0, this.version = 0, this._lastSeenEpoch = -1, this.id = oe() & b;
   }
   /**
    * Rotates the phase by 1, automatically incrementing cycle on overflow.
@@ -315,26 +315,141 @@ class H extends Y {
         }
   }
 }
+class z {
+  constructor() {
+    this.pool = [], this.maxPoolSize = 50, this.maxReusableCapacity = 256, this.stats = l ? {
+      acquired: 0,
+      released: 0,
+      rejected: { frozen: 0, tooLarge: 0, poolFull: 0 }
+    } : null;
+  }
+  /** Acquires an array from the pool or creates a new one if the pool is empty. */
+  acquire() {
+    return l && this.stats && this.stats.acquired++, this.pool.pop() ?? [];
+  }
+  /**
+   * Releases an array back to the pool.
+   * Clears the array before storing it.
+   * @param arr - The array to release.
+   * @param emptyConst - Optional reference to a constant empty array to skip.
+   */
+  release(e, t) {
+    if (!(t && e === t)) {
+      if (Object.isFrozen(e)) {
+        l && this.stats && this.stats.rejected.frozen++;
+        return;
+      }
+      if (e.length > this.maxReusableCapacity) {
+        l && this.stats && this.stats.rejected.tooLarge++;
+        return;
+      }
+      if (this.pool.length >= this.maxPoolSize) {
+        l && this.stats && this.stats.rejected.poolFull++;
+        return;
+      }
+      e.length = 0, this.pool.push(e), l && this.stats && this.stats.released++;
+    }
+  }
+  /** Returns current stats for the pool (dev mode only). */
+  getStats() {
+    if (!l || !this.stats) return null;
+    const { acquired: e, released: t, rejected: i } = this.stats, n = i.frozen + i.tooLarge + i.poolFull;
+    return {
+      acquired: e,
+      released: t,
+      rejected: i,
+      leaked: e - t - n,
+      poolSize: this.pool.length
+    };
+  }
+  /** Resets the pool and its stats. */
+  reset() {
+    this.pool.length = 0, l && this.stats && (this.stats.acquired = 0, this.stats.released = 0, this.stats.rejected = { frozen: 0, tooLarge: 0, poolFull: 0 });
+  }
+}
+const _ = Object.freeze([]), f = Object.freeze([]), a = Object.freeze([]), S = new z(), C = new z(), d = new z();
+function he(s) {
+  return s !== null && typeof s == "object" && "value" in s && "subscribe" in s && typeof s.subscribe == "function";
+}
+function De(s) {
+  if (p.enabled && (s == null || typeof s == "object")) {
+    const e = p.getDebugType(s);
+    if (e)
+      return e === "computed";
+  }
+  return he(s) && "invalidate" in s && typeof s.invalidate == "function";
+}
+function Ie(s) {
+  return s !== null && typeof s == "object" && "dispose" in s && "run" in s && typeof s.dispose == "function" && typeof s.run == "function";
+}
+function $(s) {
+  return s != null && typeof s.then == "function";
+}
+function ue(s) {
+  return typeof s == "object" && s !== null;
+}
+function ce(s) {
+  return (typeof s == "object" || typeof s == "function") && s !== null && typeof s.addDependency == "function";
+}
+function _e(s) {
+  return typeof s == "function" && typeof s.addDependency != "function";
+}
+function ae(s) {
+  return ue(s) && typeof s.execute == "function";
+}
+function J(s, e, t, i) {
+  if (e) {
+    if (ce(e)) {
+      e.addDependency(s);
+      return;
+    }
+    if (_e(e)) {
+      const n = e;
+      t.indexOf(n) === -1 && t.push(n);
+      return;
+    }
+    ae(e) && i.indexOf(e) === -1 && i.push(e);
+  }
+}
+function le(s, e, t, i) {
+  if (e !== _ && t !== f)
+    for (let r = 0; r < e.length; r++) {
+      const o = e[r];
+      o && (o._tempUnsub = t[r]);
+    }
+  const n = C.acquire();
+  n.length = s.length;
+  for (let r = 0; r < s.length; r++) {
+    const o = s[r];
+    o && (o._tempUnsub ? (n[r] = o._tempUnsub, o._tempUnsub = void 0) : (p.checkCircular(o, i), n[r] = o.subscribe(i)));
+  }
+  if (e !== _)
+    for (let r = 0; r < e.length; r++) {
+      const o = e[r];
+      o?._tempUnsub && (o._tempUnsub(), o._tempUnsub = void 0);
+    }
+  return t !== f && C.release(t), n;
+}
 let x = 0;
-function $() {
+function W() {
   return x = x + 1 & b || 1, x;
 }
-function oe() {
+function fe() {
   return x;
 }
-let F = 0, z = 0, P = !1;
+let F = 0, B = 0, P = !1;
 function q() {
   return P ? (l && console.warn(
     "Warning: startFlush() called during flush - ignored to prevent infinite loop detection bypass"
-  ), !1) : (P = !0, F = F + 1 & b, z = 0, !0);
+  ), !1) : (P = !0, F = F + 1 & b, B = 0, !0);
 }
 function X() {
   P = !1;
 }
-function he() {
-  return P ? ++z : 0;
+function de() {
+  return P ? ++B : 0;
 }
-class ue {
+class pe {
   constructor() {
     this.queueA = [], this.queueB = [], this.queue = this.queueA, this.queueSize = 0, this.urgentQueueA = [], this.urgentQueueB = [], this.urgentQueue = this.urgentQueueA, this.urgentQueueSize = 0, this._epoch = 0, this.isProcessing = !1, this.isBatching = !1, this.batchDepth = 0, this.batchQueue = [], this.batchQueueSize = 0, this.isFlushingSync = !1, this.maxFlushIterations = I.MAX_FLUSH_ITERATIONS;
   }
@@ -487,18 +602,8 @@ class ue {
     this.maxFlushIterations = e;
   }
 }
-const N = new ue();
-function ye(s) {
-  if (typeof s != "function")
-    throw new g("Batch callback must be a function");
-  N.startBatch();
-  try {
-    return s();
-  } finally {
-    N.endBatch();
-  }
-}
-class ce {
+const N = new pe();
+class Ee {
   constructor() {
     this.current = null;
   }
@@ -525,8 +630,8 @@ class ce {
     return this.current;
   }
 }
-const m = new ce();
-function _e(s) {
+const m = new Ee();
+function ge(s) {
   if (typeof s != "function")
     throw new g("Untracked callback must be a function");
   const e = m.current;
@@ -537,122 +642,7 @@ function _e(s) {
     m.current = e;
   }
 }
-class j {
-  constructor() {
-    this.pool = [], this.maxPoolSize = 50, this.maxReusableCapacity = 256, this.stats = l ? {
-      acquired: 0,
-      released: 0,
-      rejected: { frozen: 0, tooLarge: 0, poolFull: 0 }
-    } : null;
-  }
-  /** Acquires an array from the pool or creates a new one if the pool is empty. */
-  acquire() {
-    return l && this.stats && this.stats.acquired++, this.pool.pop() ?? [];
-  }
-  /**
-   * Releases an array back to the pool.
-   * Clears the array before storing it.
-   * @param arr - The array to release.
-   * @param emptyConst - Optional reference to a constant empty array to skip.
-   */
-  release(e, t) {
-    if (!(t && e === t)) {
-      if (Object.isFrozen(e)) {
-        l && this.stats && this.stats.rejected.frozen++;
-        return;
-      }
-      if (e.length > this.maxReusableCapacity) {
-        l && this.stats && this.stats.rejected.tooLarge++;
-        return;
-      }
-      if (this.pool.length >= this.maxPoolSize) {
-        l && this.stats && this.stats.rejected.poolFull++;
-        return;
-      }
-      e.length = 0, this.pool.push(e), l && this.stats && this.stats.released++;
-    }
-  }
-  /** Returns current stats for the pool (dev mode only). */
-  getStats() {
-    if (!l || !this.stats) return null;
-    const { acquired: e, released: t, rejected: i } = this.stats, n = i.frozen + i.tooLarge + i.poolFull;
-    return {
-      acquired: e,
-      released: t,
-      rejected: i,
-      leaked: e - t - n,
-      poolSize: this.pool.length
-    };
-  }
-  /** Resets the pool and its stats. */
-  reset() {
-    this.pool.length = 0, l && this.stats && (this.stats.acquired = 0, this.stats.released = 0, this.stats.rejected = { frozen: 0, tooLarge: 0, poolFull: 0 });
-  }
-}
-const _ = Object.freeze([]), f = Object.freeze([]), a = Object.freeze([]), S = new j(), C = new j(), d = new j();
-function ae(s) {
-  return s !== null && typeof s == "object" && "value" in s && "subscribe" in s && typeof s.subscribe == "function";
-}
-function De(s) {
-  if (p.enabled && (s == null || typeof s == "object")) {
-    const e = p.getDebugType(s);
-    if (e)
-      return e === "computed";
-  }
-  return ae(s) && "invalidate" in s && typeof s.invalidate == "function";
-}
-function Ie(s) {
-  return s !== null && typeof s == "object" && "dispose" in s && "run" in s && typeof s.dispose == "function" && typeof s.run == "function";
-}
-function J(s) {
-  return s != null && typeof s.then == "function";
-}
-function le(s) {
-  return typeof s == "object" && s !== null;
-}
-function fe(s) {
-  return (typeof s == "object" || typeof s == "function") && s !== null && typeof s.addDependency == "function";
-}
-function de(s) {
-  return typeof s == "function" && typeof s.addDependency != "function";
-}
-function pe(s) {
-  return le(s) && typeof s.execute == "function";
-}
-function W(s, e, t, i) {
-  if (e) {
-    if (fe(e)) {
-      e.addDependency(s);
-      return;
-    }
-    if (de(e)) {
-      const n = e;
-      t.indexOf(n) === -1 && t.push(n);
-      return;
-    }
-    pe(e) && i.indexOf(e) === -1 && i.push(e);
-  }
-}
-function Ee(s, e, t, i) {
-  if (e !== _ && t !== f)
-    for (let r = 0; r < e.length; r++) {
-      const o = e[r];
-      o && (o._tempUnsub = t[r]);
-    }
-  const n = C.acquire();
-  n.length = s.length;
-  for (let r = 0; r < s.length; r++) {
-    const o = s[r];
-    o && (o._tempUnsub ? (n[r] = o._tempUnsub, o._tempUnsub = void 0) : (p.checkCircular(o, i), n[r] = o.subscribe(i)));
-  }
-  if (e !== _)
-    for (let r = 0; r < e.length; r++) {
-      const o = e[r];
-      o?._tempUnsub && (o._tempUnsub(), o._tempUnsub = void 0);
-    }
-  return t !== f && C.release(t), n;
-}
-class ge extends H {
+class Se extends H {
   constructor(e, t) {
     super(), this._fnSubs = null, this._objSubs = null, this._value = e, t && (this.flags |= T.SYNC), p.attachDebugInfo(this, "atom", this.id);
   }
@@ -667,7 +657,7 @@ class ge extends H {
    */
   get value() {
     const e = m.current;
-    return e && W(this, e, this._getFnSubs(), this._getObjSubs()), this._value;
+    return e && J(this, e, this._getFnSubs(), this._getObjSubs()), this._value;
   }
   /**
    * Sets a new value and schedules notifications if the value has changed.
@@ -700,7 +690,7 @@ class ge extends H {
   }
 }
 function Ce(s, e = {}) {
-  return new ge(s, e.sync ?? !1);
+  return new Se(s, e.sync ?? !1);
 }
 function A(s, e, t) {
   if (s instanceof TypeError)
@@ -782,8 +772,8 @@ class Z extends H {
   }
   get errors() {
     if (this._registerTracking(), !this.hasError)
-      return te;
-    const e = oe();
+      return se;
+    const e = fe();
     if (this._errorCacheEpoch === e && this._cachedErrors !== null)
       return this._cachedErrors;
     const t = /* @__PURE__ */ new Set();
@@ -880,7 +870,7 @@ class Z extends H {
     let t = !1;
     try {
       const i = m.run(this._trackable, this._fn);
-      this._commitDependencies(e), t = !0, J(i) ? this._handleAsyncComputation(i) : this._handleSyncResult(i);
+      this._commitDependencies(e), t = !0, $(i) ? this._handleAsyncComputation(i) : this._handleSyncResult(i);
     } catch (i) {
       if (!t)
         try {
@@ -894,14 +884,14 @@ class Z extends H {
     }
   }
   _prepareComputationContext() {
-    const e = this._dependencies, t = this._dependencyVersions, i = S.acquire(), n = d.acquire(), r = $(), o = { depCount: 0 }, c = (E) => {
+    const e = this._dependencies, t = this._dependencyVersions, i = S.acquire(), n = d.acquire(), r = W(), o = { depCount: 0 }, c = (E) => {
       E._lastSeenEpoch !== r && (E._lastSeenEpoch = r, o.depCount < i.length ? (i[o.depCount] = E, n[o.depCount] = E.version) : (i.push(E), n.push(E.version)), o.depCount++);
     }, R = this._trackable.addDependency;
     return this._trackable.addDependency = c, { prevDeps: e, prevVersions: t, nextDeps: i, nextVersions: n, originalAdd: R, state: o };
   }
   _commitDependencies(e) {
     const { nextDeps: t, nextVersions: i, state: n, prevDeps: r } = e;
-    t.length = n.depCount, i.length = n.depCount, this._unsubscribes = Ee(t, r, this._unsubscribes, this), this._dependencies = t, this._dependencyVersions = i;
+    t.length = n.depCount, i.length = n.depCount, this._unsubscribes = le(t, r, this._unsubscribes, this), this._dependencies = t, this._dependencyVersions = i;
   }
   _cleanupContext(e, t) {
     this._trackable.addDependency = e.originalAdd, t ? (e.prevDeps !== _ && S.release(e.prevDeps), e.prevVersions !== a && d.release(e.prevVersions)) : (S.release(e.nextDeps), d.release(e.nextVersions));
@@ -1021,14 +1011,14 @@ class Z extends H {
     this._isRecomputing() || this._isDirty() || (this._setDirty(), this._notifyJob());
   }
   _registerTracking() {
-    W(this, m.getCurrent(), this._getFnSubs(), this._getObjSubs());
+    J(this, m.getCurrent(), this._getFnSubs(), this._getObjSubs());
   }
 }
 Object.freeze(Z.prototype);
 function me(s, e = {}) {
   return new Z(s, e);
 }
-class Se extends Y {
+class be extends Y {
   /**
    * Creates a new EffectImpl instance.
    * @param fn - The effect function to run.
@@ -1063,7 +1053,7 @@ class Se extends Y {
       let r = !1;
       try {
         const o = m.run(this, this._fn);
-        this._commitEffect(n), r = !0, this._checkLoopWarnings(), J(o) ? o.then((c) => {
+        this._commitEffect(n), r = !0, this._checkLoopWarnings(), $(o) ? o.then((c) => {
           !this.isDisposed && typeof c == "function" && (this._cleanup = c);
         }).catch((c) => {
           this._handleExecutionError(c);
@@ -1082,7 +1072,7 @@ class Se extends Y {
    * @returns The prepared EffectExecutionContext.
    */
   _prepareEffectExecutionContext() {
-    const e = this._dependencies, t = this._dependencyVersions, i = this._unsubscribes, n = S.acquire(), r = d.acquire(), o = C.acquire(), c = $();
+    const e = this._dependencies, t = this._dependencyVersions, i = this._unsubscribes, n = S.acquire(), r = d.acquire(), o = C.acquire(), c = W();
     if (e !== _ && i !== f)
       for (let R = 0; R < e.length; R++) {
         const E = e[R];
@@ -1182,7 +1172,7 @@ class Se extends Y {
    * @throws {EffectError} If an infinite loop is detected.
    */
   _checkInfiniteLoop() {
-    if (this._lastFlushEpoch !== F && (this._lastFlushEpoch = F, this._executionsInEpoch = 0), this._executionsInEpoch++, this._executionsInEpoch > this._maxExecutionsPerFlush && this._throwInfiniteLoopError("per-effect"), he() > I.MAX_EXECUTIONS_PER_FLUSH && this._throwInfiniteLoopError("global"), this._executionCount++, this._history && this._maxExecutions > 0) {
+    if (this._lastFlushEpoch !== F && (this._lastFlushEpoch = F, this._executionsInEpoch = 0), this._executionsInEpoch++, this._executionsInEpoch > this._maxExecutionsPerFlush && this._throwInfiniteLoopError("per-effect"), de() > I.MAX_EXECUTIONS_PER_FLUSH && this._throwInfiniteLoopError("global"), this._executionCount++, this._history && this._maxExecutions > 0) {
       const e = Date.now(), t = this._historyPtr, i = this._historyCapacity;
       this._history[t] = e;
       const n = (t + 1) % i, r = this._history[n] ?? 0;
@@ -1197,7 +1187,7 @@ class Se extends Y {
   }
   _throwInfiniteLoopError(e) {
     const t = new y(
-      `Infinite loop detected (${e}): effect executed ${this._executionsInEpoch} times in current flush. Total executions in flush: ${z}`
+      `Infinite loop detected (${e}): effect executed ${this._executionsInEpoch} times in current flush. Total executions in flush: ${B}`
     );
     throw this.dispose(), console.error(t), t;
   }
@@ -1213,7 +1203,7 @@ class Se extends Y {
       if (t) {
         if ("value" in t)
           try {
-            _e(() => t.value);
+            ge(() => t.value);
           } catch {
             return !0;
           }
@@ -1251,27 +1241,37 @@ class Se extends Y {
 function Re(s, e = {}) {
   if (typeof s != "function")
     throw new y(u.EFFECT_MUST_BE_FUNCTION);
-  const t = new Se(s, e);
+  const t = new be(s, e);
   return t.execute(), t;
 }
+function Te(s) {
+  if (typeof s != "function")
+    throw new g("Batch callback must be a function");
+  N.startBatch();
+  try {
+    return s();
+  } finally {
+    N.endBatch();
+  }
+}
 export {
   v as AsyncState,
   g as AtomError,
   D as ComputedError,
-  B as DEBUG_CONFIG,
+  j as DEBUG_CONFIG,
   p as DEBUG_RUNTIME,
   y as EffectError,
-  be as POOL_CONFIG,
+  ye as POOL_CONFIG,
   I as SCHEDULER_CONFIG,
   U as SchedulerError,
   Ce as atom,
-  ye as batch,
+  Te as batch,
   me as computed,
   Re as effect,
-  ae as isAtom,
+  he as isAtom,
   De as isComputed,
   Ie as isEffect,
   N as scheduler,
-  _e as untracked
+  ge as untracked
 };
 //# sourceMappingURL=index.mjs.map