@fluixi/reactive 1.0.0-alpha.104 → 1.0.0-alpha.106

package/dist/lib/signal/resource-api.cjs

@@ -25,7 +25,7 @@ __export(resource_api_exports, {
 module.exports = __toCommonJS(resource_api_exports);
 
 // src/version.generated.ts
-var VERSION = "1.0.0-alpha.104";
+var VERSION = "1.0.0-alpha.106";
 
 // src/lib/signal/graph/state.ts
 var MAJOR = VERSION.split(".")[0];
@@ -167,6 +167,7 @@ var Computed = class extends Source {
     super();
     this._threw = false;
     this._initialized = false;
+    this._disposed = false;
     this.state = DIRTY;
     /** Nodes this computation read on its last run. Rebuilt on every run. */
     this.sources = null;
@@ -182,8 +183,23 @@ var Computed = class extends Source {
     if (this._threw) throw this._error;
     return this._value;
   }
+  /**
+   * Unlink from every source, for good. Without this, a source outlives the
+   * computation and keeps it (and everything its function captured) reachable
+   * through its observers set: a disposed list row stayed in memory that way.
+   * The last value stays readable; the node simply never updates again.
+   */
+  dispose() {
+    if (this._disposed) return;
+    this._disposed = true;
+    if (this.sources) {
+      for (const s of this.sources) s.observers?.delete(this);
+      this.sources = null;
+    }
+  }
   /** Settle, if CHECK, verify sources; if DIRTY (or never run), recompute. */
   updateIfNecessary() {
+    if (this._disposed) return;
     if (this.state === CHECK) {
       if (this.sources) {
         for (const s of this.sources) {
@@ -227,7 +243,7 @@ var Computed = class extends Source {
     reportReactiveRun(this);
     if (changed) {
       this.version++;
-      if (this.observers) for (const o of [...this.observers]) o.markDirty(DIRTY);
+      if (this.observers) for (const o of this.observers) o.markDirty(DIRTY);
       notifyWatchers(this);
     }
   }
@@ -241,7 +257,7 @@ var Computed = class extends Source {
     const wasClean = this.state === CLEAN;
     this.state = level;
     if (wasClean) {
-      if (this.observers) for (const o of [...this.observers]) o.markDirty(CHECK);
+      if (this.observers) for (const o of this.observers) o.markDirty(CHECK);
       notifyWatchers(this);
     }
   }
@@ -280,6 +296,10 @@ var Watcher = class {
     this._pending.clear();
     return out;
   }
+  /** Drain pending without the array, for callers that only need it empty. */
+  clearPending() {
+    this._pending.clear();
+  }
   /** @internal, a watched node became non-clean. Edge-triggered: notify once. */
   _notify(node) {
     if (!this._watched.has(node) || this._pending.has(node)) return;
@@ -397,14 +417,14 @@ var EffectNode = class {
         if (typeof r === "function") (this.owner.cleanups ??= []).push(r);
       });
     });
-    reportReactiveNode({ kind: "effect", node: this.computed, handle: this, internal: !report, ...name ? { name } : {} });
+    if (isObserved()) reportReactiveNode({ kind: "effect", node: this.computed, handle: this, internal: !report, ...name ? { name } : {} });
     this.watcher = new Watcher(() => enqueue(this));
     this.run();
     this.watcher.watch(this.computed);
   }
   run() {
     if (this.disposed) return;
-    this.watcher.getPending();
+    this.watcher.clearPending();
     try {
       this.computed.get();
     } catch (e) {
@@ -421,6 +441,7 @@ var EffectNode = class {
     this.disposed = true;
     reportReactiveDispose(this.computed);
     this.watcher.unwatch(this.computed);
+    this.computed.dispose();
     disposeOwner(this.owner);
   }
 };
@@ -455,13 +476,15 @@ function createSignal(value, options) {
     },
     enumerable: false
   });
-  reportReactiveNode({
-    kind: "signal",
-    node: state,
-    handle: read,
-    name: options?.name,
-    set: write
-  });
+  if (isObserved()) {
+    reportReactiveNode({
+      kind: "signal",
+      node: state,
+      handle: read,
+      name: options?.name,
+      set: write
+    });
+  }
   if (isObserved()) onCleanup(() => reportReactiveDispose(state));
   return [read, write];
 }

package/dist/lib/signal/resource-api.mjs

@@ -1,5 +1,5 @@
 // src/version.generated.ts
-var VERSION = "1.0.0-alpha.104";
+var VERSION = "1.0.0-alpha.106";
 
 // src/lib/signal/graph/state.ts
 var MAJOR = VERSION.split(".")[0];
@@ -141,6 +141,7 @@ var Computed = class extends Source {
     super();
     this._threw = false;
     this._initialized = false;
+    this._disposed = false;
     this.state = DIRTY;
     /** Nodes this computation read on its last run. Rebuilt on every run. */
     this.sources = null;
@@ -156,8 +157,23 @@ var Computed = class extends Source {
     if (this._threw) throw this._error;
     return this._value;
   }
+  /**
+   * Unlink from every source, for good. Without this, a source outlives the
+   * computation and keeps it (and everything its function captured) reachable
+   * through its observers set: a disposed list row stayed in memory that way.
+   * The last value stays readable; the node simply never updates again.
+   */
+  dispose() {
+    if (this._disposed) return;
+    this._disposed = true;
+    if (this.sources) {
+      for (const s of this.sources) s.observers?.delete(this);
+      this.sources = null;
+    }
+  }
   /** Settle, if CHECK, verify sources; if DIRTY (or never run), recompute. */
   updateIfNecessary() {
+    if (this._disposed) return;
     if (this.state === CHECK) {
       if (this.sources) {
         for (const s of this.sources) {
@@ -201,7 +217,7 @@ var Computed = class extends Source {
     reportReactiveRun(this);
     if (changed) {
       this.version++;
-      if (this.observers) for (const o of [...this.observers]) o.markDirty(DIRTY);
+      if (this.observers) for (const o of this.observers) o.markDirty(DIRTY);
       notifyWatchers(this);
     }
   }
@@ -215,7 +231,7 @@ var Computed = class extends Source {
     const wasClean = this.state === CLEAN;
     this.state = level;
     if (wasClean) {
-      if (this.observers) for (const o of [...this.observers]) o.markDirty(CHECK);
+      if (this.observers) for (const o of this.observers) o.markDirty(CHECK);
       notifyWatchers(this);
     }
   }
@@ -254,6 +270,10 @@ var Watcher = class {
     this._pending.clear();
     return out;
   }
+  /** Drain pending without the array, for callers that only need it empty. */
+  clearPending() {
+    this._pending.clear();
+  }
   /** @internal, a watched node became non-clean. Edge-triggered: notify once. */
   _notify(node) {
     if (!this._watched.has(node) || this._pending.has(node)) return;
@@ -371,14 +391,14 @@ var EffectNode = class {
         if (typeof r === "function") (this.owner.cleanups ??= []).push(r);
       });
     });
-    reportReactiveNode({ kind: "effect", node: this.computed, handle: this, internal: !report, ...name ? { name } : {} });
+    if (isObserved()) reportReactiveNode({ kind: "effect", node: this.computed, handle: this, internal: !report, ...name ? { name } : {} });
     this.watcher = new Watcher(() => enqueue(this));
     this.run();
     this.watcher.watch(this.computed);
   }
   run() {
     if (this.disposed) return;
-    this.watcher.getPending();
+    this.watcher.clearPending();
     try {
       this.computed.get();
     } catch (e) {
@@ -395,6 +415,7 @@ var EffectNode = class {
     this.disposed = true;
     reportReactiveDispose(this.computed);
     this.watcher.unwatch(this.computed);
+    this.computed.dispose();
     disposeOwner(this.owner);
   }
 };
@@ -429,13 +450,15 @@ function createSignal(value, options) {
     },
     enumerable: false
   });
-  reportReactiveNode({
-    kind: "signal",
-    node: state,
-    handle: read,
-    name: options?.name,
-    set: write
-  });
+  if (isObserved()) {
+    reportReactiveNode({
+      kind: "signal",
+      node: state,
+      handle: read,
+      name: options?.name,
+      set: write
+    });
+  }
   if (isObserved()) onCleanup(() => reportReactiveDispose(state));
   return [read, write];
 }

package/dist/lib/signal/signal.cjs

@@ -434,7 +434,7 @@ var Observable = class extends Subscription {
 
 // src/lib/signal/graph/detect.ts
 var __BROWSER_PROD__ = typeof window === "undefined" ? false : window.__FLUIXI_PROD__ === true;
-var __DEV__ = typeof process === "undefined" ? __BROWSER_PROD__ : false;
+var __DEV__ = typeof process === "undefined" ? __BROWSER_PROD__ : process.env.NODE_ENV !== "production";
 var $SIGNAL = /* @__PURE__ */ Symbol.for("signal");
 var $MEMO = /* @__PURE__ */ Symbol.for("memo");
 var $RESOURCE = /* @__PURE__ */ Symbol.for("resource");
@@ -468,7 +468,7 @@ function makeArrayFlat(values) {
 }
 
 // src/version.generated.ts
-var VERSION = "1.0.0-alpha.104";
+var VERSION = "1.0.0-alpha.106";
 
 // src/lib/signal/graph/state.ts
 var MAJOR = VERSION.split(".")[0];
@@ -610,6 +610,7 @@ var Computed = class extends Source {
     super();
     this._threw = false;
     this._initialized = false;
+    this._disposed = false;
     this.state = DIRTY;
     /** Nodes this computation read on its last run. Rebuilt on every run. */
     this.sources = null;
@@ -625,8 +626,23 @@ var Computed = class extends Source {
     if (this._threw) throw this._error;
     return this._value;
   }
+  /**
+   * Unlink from every source, for good. Without this, a source outlives the
+   * computation and keeps it (and everything its function captured) reachable
+   * through its observers set: a disposed list row stayed in memory that way.
+   * The last value stays readable; the node simply never updates again.
+   */
+  dispose() {
+    if (this._disposed) return;
+    this._disposed = true;
+    if (this.sources) {
+      for (const s of this.sources) s.observers?.delete(this);
+      this.sources = null;
+    }
+  }
   /** Settle, if CHECK, verify sources; if DIRTY (or never run), recompute. */
   updateIfNecessary() {
+    if (this._disposed) return;
     if (this.state === CHECK) {
       if (this.sources) {
         for (const s of this.sources) {
@@ -670,7 +686,7 @@ var Computed = class extends Source {
     reportReactiveRun(this);
     if (changed) {
       this.version++;
-      if (this.observers) for (const o of [...this.observers]) o.markDirty(DIRTY);
+      if (this.observers) for (const o of this.observers) o.markDirty(DIRTY);
       notifyWatchers(this);
     }
   }
@@ -684,7 +700,7 @@ var Computed = class extends Source {
     const wasClean = this.state === CLEAN;
     this.state = level;
     if (wasClean) {
-      if (this.observers) for (const o of [...this.observers]) o.markDirty(CHECK);
+      if (this.observers) for (const o of this.observers) o.markDirty(CHECK);
       notifyWatchers(this);
     }
   }
@@ -723,6 +739,10 @@ var Watcher = class {
     this._pending.clear();
     return out;
   }
+  /** Drain pending without the array, for callers that only need it empty. */
+  clearPending() {
+    this._pending.clear();
+  }
   /** @internal, a watched node became non-clean. Edge-triggered: notify once. */
   _notify(node) {
     if (!this._watched.has(node) || this._pending.has(node)) return;
@@ -833,14 +853,14 @@ var EffectNode = class {
         if (typeof r === "function") (this.owner.cleanups ??= []).push(r);
       });
     });
-    reportReactiveNode({ kind: "effect", node: this.computed, handle: this, internal: !report, ...name ? { name } : {} });
+    if (isObserved()) reportReactiveNode({ kind: "effect", node: this.computed, handle: this, internal: !report, ...name ? { name } : {} });
     this.watcher = new Watcher(() => enqueue(this));
     this.run();
     this.watcher.watch(this.computed);
   }
   run() {
     if (this.disposed) return;
-    this.watcher.getPending();
+    this.watcher.clearPending();
     try {
       this.computed.get();
     } catch (e) {
@@ -857,6 +877,7 @@ var EffectNode = class {
     this.disposed = true;
     reportReactiveDispose(this.computed);
     this.watcher.unwatch(this.computed);
+    this.computed.dispose();
     disposeOwner(this.owner);
   }
 };
@@ -895,13 +916,15 @@ function createSignal(value, options) {
     },
     enumerable: false
   });
-  reportReactiveNode({
-    kind: "signal",
-    node: state,
-    handle: read,
-    name: options?.name,
-    set: write
-  });
+  if (isObserved()) {
+    reportReactiveNode({
+      kind: "signal",
+      node: state,
+      handle: read,
+      name: options?.name,
+      set: write
+    });
+  }
   if (isObserved()) onCleanup(() => reportReactiveDispose(state));
   return [read, write];
 }
@@ -925,8 +948,11 @@ function createMemo(fn, value, options) {
   const read = (() => c.get());
   Object.defineProperty(read, $SIGNAL2, { value: true, enumerable: true });
   Object.defineProperty(read, $MEMO2, { value: true, enumerable: true });
-  reportReactiveNode({ kind: "memo", node: c, handle: read, name: options?.name });
-  if (isObserved()) onCleanup(() => reportReactiveDispose(c));
+  if (isObserved()) reportReactiveNode({ kind: "memo", node: c, handle: read, name: options?.name });
+  onCleanup(() => {
+    c.dispose();
+    if (isObserved()) reportReactiveDispose(c);
+  });
   return read;
 }
 function createEffect(fn, value, options) {

package/dist/lib/signal/signal.mjs

@@ -356,7 +356,7 @@ var Observable = class extends Subscription {
 
 // src/lib/signal/graph/detect.ts
 var __BROWSER_PROD__ = typeof window === "undefined" ? false : window.__FLUIXI_PROD__ === true;
-var __DEV__ = typeof process === "undefined" ? __BROWSER_PROD__ : false;
+var __DEV__ = typeof process === "undefined" ? __BROWSER_PROD__ : process.env.NODE_ENV !== "production";
 var $SIGNAL = /* @__PURE__ */ Symbol.for("signal");
 var $MEMO = /* @__PURE__ */ Symbol.for("memo");
 var $RESOURCE = /* @__PURE__ */ Symbol.for("resource");
@@ -390,7 +390,7 @@ function makeArrayFlat(values) {
 }
 
 // src/version.generated.ts
-var VERSION = "1.0.0-alpha.104";
+var VERSION = "1.0.0-alpha.106";
 
 // src/lib/signal/graph/state.ts
 var MAJOR = VERSION.split(".")[0];
@@ -532,6 +532,7 @@ var Computed = class extends Source {
     super();
     this._threw = false;
     this._initialized = false;
+    this._disposed = false;
     this.state = DIRTY;
     /** Nodes this computation read on its last run. Rebuilt on every run. */
     this.sources = null;
@@ -547,8 +548,23 @@ var Computed = class extends Source {
     if (this._threw) throw this._error;
     return this._value;
   }
+  /**
+   * Unlink from every source, for good. Without this, a source outlives the
+   * computation and keeps it (and everything its function captured) reachable
+   * through its observers set: a disposed list row stayed in memory that way.
+   * The last value stays readable; the node simply never updates again.
+   */
+  dispose() {
+    if (this._disposed) return;
+    this._disposed = true;
+    if (this.sources) {
+      for (const s of this.sources) s.observers?.delete(this);
+      this.sources = null;
+    }
+  }
   /** Settle, if CHECK, verify sources; if DIRTY (or never run), recompute. */
   updateIfNecessary() {
+    if (this._disposed) return;
     if (this.state === CHECK) {
       if (this.sources) {
         for (const s of this.sources) {
@@ -592,7 +608,7 @@ var Computed = class extends Source {
     reportReactiveRun(this);
     if (changed) {
       this.version++;
-      if (this.observers) for (const o of [...this.observers]) o.markDirty(DIRTY);
+      if (this.observers) for (const o of this.observers) o.markDirty(DIRTY);
       notifyWatchers(this);
     }
   }
@@ -606,7 +622,7 @@ var Computed = class extends Source {
     const wasClean = this.state === CLEAN;
     this.state = level;
     if (wasClean) {
-      if (this.observers) for (const o of [...this.observers]) o.markDirty(CHECK);
+      if (this.observers) for (const o of this.observers) o.markDirty(CHECK);
       notifyWatchers(this);
     }
   }
@@ -645,6 +661,10 @@ var Watcher = class {
     this._pending.clear();
     return out;
   }
+  /** Drain pending without the array, for callers that only need it empty. */
+  clearPending() {
+    this._pending.clear();
+  }
   /** @internal, a watched node became non-clean. Edge-triggered: notify once. */
   _notify(node) {
     if (!this._watched.has(node) || this._pending.has(node)) return;
@@ -755,14 +775,14 @@ var EffectNode = class {
         if (typeof r === "function") (this.owner.cleanups ??= []).push(r);
       });
     });
-    reportReactiveNode({ kind: "effect", node: this.computed, handle: this, internal: !report, ...name ? { name } : {} });
+    if (isObserved()) reportReactiveNode({ kind: "effect", node: this.computed, handle: this, internal: !report, ...name ? { name } : {} });
     this.watcher = new Watcher(() => enqueue(this));
     this.run();
     this.watcher.watch(this.computed);
   }
   run() {
     if (this.disposed) return;
-    this.watcher.getPending();
+    this.watcher.clearPending();
     try {
       this.computed.get();
     } catch (e) {
@@ -779,6 +799,7 @@ var EffectNode = class {
     this.disposed = true;
     reportReactiveDispose(this.computed);
     this.watcher.unwatch(this.computed);
+    this.computed.dispose();
     disposeOwner(this.owner);
   }
 };
@@ -817,13 +838,15 @@ function createSignal(value, options) {
     },
     enumerable: false
   });
-  reportReactiveNode({
-    kind: "signal",
-    node: state,
-    handle: read,
-    name: options?.name,
-    set: write
-  });
+  if (isObserved()) {
+    reportReactiveNode({
+      kind: "signal",
+      node: state,
+      handle: read,
+      name: options?.name,
+      set: write
+    });
+  }
   if (isObserved()) onCleanup(() => reportReactiveDispose(state));
   return [read, write];
 }
@@ -847,8 +870,11 @@ function createMemo(fn, value, options) {
   const read = (() => c.get());
   Object.defineProperty(read, $SIGNAL2, { value: true, enumerable: true });
   Object.defineProperty(read, $MEMO2, { value: true, enumerable: true });
-  reportReactiveNode({ kind: "memo", node: c, handle: read, name: options?.name });
-  if (isObserved()) onCleanup(() => reportReactiveDispose(c));
+  if (isObserved()) reportReactiveNode({ kind: "memo", node: c, handle: read, name: options?.name });
+  onCleanup(() => {
+    c.dispose();
+    if (isObserved()) reportReactiveDispose(c);
+  });
   return read;
 }
 function createEffect(fn, value, options) {

package/dist/lib/signal/utilities.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/reactive v1.0.0-alpha.104 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/reactive v1.0.0-alpha.106 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -45,7 +45,7 @@ __export(utilities_exports, {
 module.exports = __toCommonJS(utilities_exports);
 
 // src/version.generated.ts
-var VERSION = "1.0.0-alpha.104";
+var VERSION = "1.0.0-alpha.106";
 
 // src/lib/signal/graph/state.ts
 var MAJOR = VERSION.split(".")[0];
@@ -187,6 +187,7 @@ var Computed = class extends Source {
     super();
     this._threw = false;
     this._initialized = false;
+    this._disposed = false;
     this.state = DIRTY;
     /** Nodes this computation read on its last run. Rebuilt on every run. */
     this.sources = null;
@@ -202,8 +203,23 @@ var Computed = class extends Source {
     if (this._threw) throw this._error;
     return this._value;
   }
+  /**
+   * Unlink from every source, for good. Without this, a source outlives the
+   * computation and keeps it (and everything its function captured) reachable
+   * through its observers set: a disposed list row stayed in memory that way.
+   * The last value stays readable; the node simply never updates again.
+   */
+  dispose() {
+    if (this._disposed) return;
+    this._disposed = true;
+    if (this.sources) {
+      for (const s of this.sources) s.observers?.delete(this);
+      this.sources = null;
+    }
+  }
   /** Settle, if CHECK, verify sources; if DIRTY (or never run), recompute. */
   updateIfNecessary() {
+    if (this._disposed) return;
     if (this.state === CHECK) {
       if (this.sources) {
         for (const s of this.sources) {
@@ -247,7 +263,7 @@ var Computed = class extends Source {
     reportReactiveRun(this);
     if (changed) {
       this.version++;
-      if (this.observers) for (const o of [...this.observers]) o.markDirty(DIRTY);
+      if (this.observers) for (const o of this.observers) o.markDirty(DIRTY);
       notifyWatchers(this);
     }
   }
@@ -261,7 +277,7 @@ var Computed = class extends Source {
     const wasClean = this.state === CLEAN;
     this.state = level;
     if (wasClean) {
-      if (this.observers) for (const o of [...this.observers]) o.markDirty(CHECK);
+      if (this.observers) for (const o of this.observers) o.markDirty(CHECK);
       notifyWatchers(this);
     }
   }
@@ -300,6 +316,10 @@ var Watcher = class {
     this._pending.clear();
     return out;
   }
+  /** Drain pending without the array, for callers that only need it empty. */
+  clearPending() {
+    this._pending.clear();
+  }
   /** @internal, a watched node became non-clean. Edge-triggered: notify once. */
   _notify(node) {
     if (!this._watched.has(node) || this._pending.has(node)) return;
@@ -410,14 +430,14 @@ var EffectNode = class {
         if (typeof r === "function") (this.owner.cleanups ??= []).push(r);
       });
     });
-    reportReactiveNode({ kind: "effect", node: this.computed, handle: this, internal: !report, ...name ? { name } : {} });
+    if (isObserved()) reportReactiveNode({ kind: "effect", node: this.computed, handle: this, internal: !report, ...name ? { name } : {} });
     this.watcher = new Watcher(() => enqueue(this));
     this.run();
     this.watcher.watch(this.computed);
   }
   run() {
     if (this.disposed) return;
-    this.watcher.getPending();
+    this.watcher.clearPending();
     try {
       this.computed.get();
     } catch (e) {
@@ -434,6 +454,7 @@ var EffectNode = class {
     this.disposed = true;
     reportReactiveDispose(this.computed);
     this.watcher.unwatch(this.computed);
+    this.computed.dispose();
     disposeOwner(this.owner);
   }
 };
@@ -472,13 +493,15 @@ function createSignal(value, options) {
     },
     enumerable: false
   });
-  reportReactiveNode({
-    kind: "signal",
-    node: state,
-    handle: read,
-    name: options?.name,
-    set: write
-  });
+  if (isObserved()) {
+    reportReactiveNode({
+      kind: "signal",
+      node: state,
+      handle: read,
+      name: options?.name,
+      set: write
+    });
+  }
   if (isObserved()) onCleanup(() => reportReactiveDispose(state));
   return [read, write];
 }
@@ -502,8 +525,11 @@ function createMemo(fn, value, options) {
   const read = (() => c.get());
   Object.defineProperty(read, $SIGNAL, { value: true, enumerable: true });
   Object.defineProperty(read, $MEMO, { value: true, enumerable: true });
-  reportReactiveNode({ kind: "memo", node: c, handle: read, name: options?.name });
-  if (isObserved()) onCleanup(() => reportReactiveDispose(c));
+  if (isObserved()) reportReactiveNode({ kind: "memo", node: c, handle: read, name: options?.name });
+  onCleanup(() => {
+    c.dispose();
+    if (isObserved()) reportReactiveDispose(c);
+  });
   return read;
 }
 function createEffect(fn, value, options) {