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

package/dist/lib/signal/graph/debounced.cjs

@@ -26,7 +26,7 @@ __export(debounced_exports, {
 module.exports = __toCommonJS(debounced_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];
@@ -168,6 +168,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;
@@ -183,8 +184,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) {
@@ -228,7 +244,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);
     }
   }
@@ -242,7 +258,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);
     }
   }
@@ -281,6 +297,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;
@@ -398,14 +418,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) {
@@ -422,6 +442,7 @@ var EffectNode = class {
     this.disposed = true;
     reportReactiveDispose(this.computed);
     this.watcher.unwatch(this.computed);
+    this.computed.dispose();
     disposeOwner(this.owner);
   }
 };
@@ -456,13 +477,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/graph/debounced.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/graph/derived.cjs

@@ -27,7 +27,7 @@ __export(derived_exports, {
 module.exports = __toCommonJS(derived_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];
@@ -169,6 +169,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;
@@ -184,8 +185,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) {
@@ -229,7 +245,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);
     }
   }
@@ -243,7 +259,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);
     }
   }
@@ -282,6 +298,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;
@@ -382,14 +402,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) {
@@ -406,6 +426,7 @@ var EffectNode = class {
     this.disposed = true;
     reportReactiveDispose(this.computed);
     this.watcher.unwatch(this.computed);
+    this.computed.dispose();
     disposeOwner(this.owner);
   }
 };
@@ -440,13 +461,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/graph/derived.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;
@@ -354,14 +374,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) {
@@ -378,6 +398,7 @@ var EffectNode = class {
     this.disposed = true;
     reportReactiveDispose(this.computed);
     this.watcher.unwatch(this.computed);
+    this.computed.dispose();
     disposeOwner(this.owner);
   }
 };
@@ -412,13 +433,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/graph/detect.cjs

@@ -32,7 +32,7 @@ __export(detect_exports, {
 });
 module.exports = __toCommonJS(detect_exports);
 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");

package/dist/lib/signal/graph/detect.mjs

@@ -1,6 +1,6 @@
 // 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");

package/dist/lib/signal/graph/error-boundary.cjs

@@ -27,7 +27,7 @@ __export(error_boundary_exports, {
 module.exports = __toCommonJS(error_boundary_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];
@@ -280,13 +280,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/graph/error-boundary.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];
@@ -252,13 +252,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/graph/index.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;
@@ -29,7 +29,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_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];
@@ -155,6 +155,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;
@@ -170,8 +171,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) {
@@ -215,7 +231,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);
     }
   }
@@ -229,7 +245,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);
     }
   }
@@ -268,6 +284,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;

package/dist/lib/signal/graph/index.mjs

@@ -1,7 +1,7 @@
-/*! @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 */
 
 // 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];
@@ -127,6 +127,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;
@@ -142,8 +143,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) {
@@ -187,7 +203,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);
     }
   }
@@ -201,7 +217,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);
     }
   }
@@ -240,6 +256,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;