@ersbeth/picoflow 2.1.0 → 2.2.0

package/SKILL.md

@@ -59,7 +59,12 @@ callback) rather than needing manual `await`/try-catch inside a derivation.
 - **Creating a subscription inside another subscription's callback** — it re-creates one on every run
   and leaks. Combine into a single `subscribe()` whose data function reads all the needed primitives.
 - **A `subscribe()`/`.subscribe()` callback that calls `.set()` on a primitive it also reads** — infinite
-  loop.
+  loop. PicoFlow's own cycle guard stops it after 10 000 steps and reports it through `onFlushError()`
+  (see below) rather than crashing the process, but the loop is still a bug to fix, not something to rely
+  on the guard for.
+- **`subscribe(fn)` with no `onError`, and no global `onFlushError()` handler installed** — any exception
+  thrown inside `fn` is only logged via `console.error` by default; install `onFlushError((error) => ...)`
+  once at startup if the application needs to observe or report these instead of the default logging.
 - **Using `add()`/`update()` on `array`/`map` without checking preconditions** — `array.update(index, x)`
   throws if the index is out of bounds; `map.add(key, x)` throws if the key exists; `map.update(key, x)`
   throws if it doesn't. Check first (`.pick()`) or branch on it, don't assume.

package/dist/picoflow.js

@@ -1,5 +1,242 @@
 import { createResource, onMount, createEffect, resetErrorBoundaries, onCleanup } from 'solid-js';
 
+class Disposable {
+  _disposed = false;
+  get disposed() {
+    return this._disposed;
+  }
+}
+
+class ExecutionStack {
+  static _MAX_FLUSH_STEPS = 1e4;
+  static _pendingQueue = [];
+  static _effectQueue = [];
+  static _executionScheduled;
+  static _coalesceResetScheduled = false;
+  /** Routes any error escaping the flush loop; defaults to logging rather than crashing (A2-SEM-2, A2-SEC-1). */
+  static _onFlushError = (error) => console.error(error);
+  /**
+   * True once the current synchronous call stack has finished and microtasks have started.
+   * EffectNode uses this to treat microtask notifications (e.g. async resolve) differently
+   * from coalesced sync-batch notifications.
+   */
+  static _pastSyncTurn = false;
+  /** @internal Used by EffectNode to distinguish sync-batch from microtask notifications. */
+  static get pastSyncTurn() {
+    return ExecutionStack._pastSyncTurn;
+  }
+  /**
+   * @internal Runs after the current sync turn ends (queueMicrotask).
+   * Marks pastSyncTurn so the next coalesced effect notify can bump its epoch,
+   * and resets per-effect coalesce flags via onReset.
+   */
+  static scheduleCoalesceReset(onReset) {
+    if (ExecutionStack._coalesceResetScheduled) return;
+    ExecutionStack._coalesceResetScheduled = true;
+    queueMicrotask(() => {
+      ExecutionStack._pastSyncTurn = true;
+      ExecutionStack._coalesceResetScheduled = false;
+      onReset();
+    });
+  }
+  /** @internal Wired to the public `onFlushError()` API in `src/api/base/flowConfig.ts`. */
+  static setFlushErrorHandler(handler) {
+    ExecutionStack._onFlushError = handler;
+  }
+  static pushPending(node) {
+    ExecutionStack._beginSyncTurn();
+    ExecutionStack._scheduleExecution();
+    ExecutionStack._pendingQueue.push(node);
+  }
+  static pushEffect(effect) {
+    ExecutionStack._beginSyncTurn();
+    ExecutionStack._scheduleExecution();
+    ExecutionStack._effectQueue.push(effect);
+  }
+  static _beginSyncTurn() {
+    ExecutionStack._pastSyncTurn = false;
+  }
+  static _scheduleExecution() {
+    if (ExecutionStack._executionScheduled) return;
+    ExecutionStack._executionScheduled = new Promise((resolve) => {
+      setTimeout(() => {
+        ExecutionStack._executionScheduled = void 0;
+        ExecutionStack._execute();
+        resolve();
+      }, 0);
+    });
+  }
+  static _drain(queue) {
+    for (let i = 0; i < queue.length; i++) {
+      if (i >= ExecutionStack._MAX_FLUSH_STEPS) {
+        ExecutionStack._pendingQueue.length = 0;
+        ExecutionStack._effectQueue.length = 0;
+        ExecutionStack._onFlushError(new Error("[PicoFlow] Reactive update cycle exceeded maximum depth"));
+        return;
+      }
+      const node = queue[i];
+      try {
+        node?.execute();
+      } catch (error) {
+        ExecutionStack._onFlushError(error);
+      }
+    }
+    queue.length = 0;
+  }
+  static _execute() {
+    ExecutionStack._drain(ExecutionStack._pendingQueue);
+    ExecutionStack._drain(ExecutionStack._effectQueue);
+  }
+}
+
+class Node extends Disposable {
+  _dependencies = /* @__PURE__ */ new Set();
+  _dependents = /* @__PURE__ */ new Set();
+  _status = "resolved";
+  get status() {
+    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    return this._status;
+  }
+  set status(status) {
+    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    this._status = status;
+  }
+  registerDependency(dependency) {
+    if (this._disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    this._dependencies.add(dependency);
+    dependency.registerDependent(this);
+  }
+  unregisterDependency(dependency) {
+    if (this._disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    this._dependencies.delete(dependency);
+    dependency.unregisterDependent(this);
+  }
+  clearDependencies() {
+    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    this._dependencies.forEach((dependency) => {
+      dependency.unregisterDependent(this);
+    });
+    this._dependencies.clear();
+  }
+  registerDependent(dependent) {
+    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    this._dependents.add(dependent);
+  }
+  unregisterDependent(dependent) {
+    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    this._dependents.delete(dependent);
+  }
+  markDependencyDisposed() {
+  }
+  notifyDependents() {
+    if (this.disposed) return;
+    this._dependents.forEach((dependent) => {
+      dependent.notify();
+    });
+  }
+  watch(tracker) {
+    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    tracker.registerDependency(this);
+  }
+  trigger() {
+    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    this.notifyDependents();
+  }
+  dispose() {
+    if (this._disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    Array.from(this._dependents).forEach((dependant) => {
+      dependant.markDependencyDisposed();
+      dependant.unregisterDependency(this);
+      this.unregisterDependent(dependant);
+    });
+    Array.from(this._dependencies).forEach((dependency) => {
+      this.unregisterDependency(dependency);
+    });
+    this._disposed = true;
+  }
+}
+
+class Observable extends Disposable {
+  _dependents = /* @__PURE__ */ new Set();
+  _status = "resolved";
+  get status() {
+    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    return this._status;
+  }
+  set status(status) {
+    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    this._status = status;
+  }
+  registerDependent(dependent) {
+    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    this._dependents.add(dependent);
+  }
+  unregisterDependent(dependent) {
+    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    this._dependents.delete(dependent);
+  }
+  notifyDependents() {
+    if (this.disposed) return;
+    this._dependents.forEach((dependent) => {
+      dependent.notify();
+    });
+  }
+  watch(tracker) {
+    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    tracker.registerDependency(this);
+  }
+  trigger() {
+    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    this.notifyDependents();
+  }
+  dispose() {
+    if (this._disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    Array.from(this._dependents).forEach((dependant) => {
+      dependant.markDependencyDisposed();
+      dependant.unregisterDependency(this);
+      this.unregisterDependent(dependant);
+    });
+    this._disposed = true;
+  }
+}
+
+class Observer extends Disposable {
+  _dependencies = /* @__PURE__ */ new Set();
+  /** Set when a dependency disposed while this observer was queued; consumed by the next execute(). */
+  _dependencyDisposed = false;
+  markDependencyDisposed() {
+    this._dependencyDisposed = true;
+  }
+  registerDependency(dependency) {
+    if (this._disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    this._dependencies.add(dependency);
+    dependency.registerDependent(this);
+  }
+  unregisterDependency(dependency) {
+    if (this._disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    this._dependencies.delete(dependency);
+    dependency.unregisterDependent(this);
+  }
+  clearDependencies() {
+    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    this._dependencies.forEach((dependency) => {
+      dependency.unregisterDependent(this);
+    });
+    this._dependencies.clear();
+  }
+  dispose() {
+    if (this._disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    Array.from(this._dependencies).forEach((dependency) => {
+      this.unregisterDependency(dependency);
+    });
+    this._disposed = true;
+  }
+}
+
+function onFlushError(handler) {
+  ExecutionStack.setFlushErrorHandler(handler);
+}
+
 function isDisposable(obj) {
   return obj !== null && obj !== void 0 && typeof obj.dispose === "function";
 }
@@ -213,229 +450,6 @@ class SyncScheduler {
   }
 }
 
-class Disposable {
-  _disposed = false;
-  get disposed() {
-    return this._disposed;
-  }
-  dispose() {
-    if (this._disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    this._disposed = true;
-  }
-}
-
-class ExecutionStack {
-  static _MAX_FLUSH_STEPS = 1e4;
-  static _pendingQueue = [];
-  static _effectQueue = [];
-  static _executionScheduled;
-  static _coalesceResetScheduled = false;
-  /**
-   * True once the current synchronous call stack has finished and microtasks have started.
-   * EffectNode uses this to treat microtask notifications (e.g. async resolve) differently
-   * from coalesced sync-batch notifications.
-   */
-  static _pastSyncTurn = false;
-  /** @internal Used by EffectNode to distinguish sync-batch from microtask notifications. */
-  static get pastSyncTurn() {
-    return ExecutionStack._pastSyncTurn;
-  }
-  /**
-   * @internal Runs after the current sync turn ends (queueMicrotask).
-   * Marks pastSyncTurn so the next coalesced effect notify can bump its epoch,
-   * and resets per-effect coalesce flags via onReset.
-   */
-  static scheduleCoalesceReset(onReset) {
-    if (ExecutionStack._coalesceResetScheduled) return;
-    ExecutionStack._coalesceResetScheduled = true;
-    queueMicrotask(() => {
-      ExecutionStack._pastSyncTurn = true;
-      ExecutionStack._coalesceResetScheduled = false;
-      onReset();
-    });
-  }
-  static pushPending(node) {
-    ExecutionStack._beginSyncTurn();
-    ExecutionStack._scheduleExecution();
-    ExecutionStack._pendingQueue.push(node);
-  }
-  static pushEffect(effect) {
-    ExecutionStack._beginSyncTurn();
-    ExecutionStack._scheduleExecution();
-    ExecutionStack._effectQueue.push(effect);
-  }
-  static _beginSyncTurn() {
-    ExecutionStack._pastSyncTurn = false;
-  }
-  static _scheduleExecution() {
-    if (ExecutionStack._executionScheduled) return;
-    ExecutionStack._executionScheduled = new Promise((resolve) => {
-      setTimeout(() => {
-        ExecutionStack._executionScheduled = void 0;
-        ExecutionStack._execute();
-        resolve();
-      }, 0);
-    });
-  }
-  static _drain(queue) {
-    for (let i = 0; i < queue.length; i++) {
-      if (i >= ExecutionStack._MAX_FLUSH_STEPS) {
-        ExecutionStack._pendingQueue.length = 0;
-        ExecutionStack._effectQueue.length = 0;
-        throw new Error("[PicoFlow] Reactive update cycle exceeded maximum depth");
-      }
-      const node = queue[i];
-      node?.execute();
-    }
-    queue.length = 0;
-  }
-  static _execute() {
-    ExecutionStack._drain(ExecutionStack._pendingQueue);
-    ExecutionStack._drain(ExecutionStack._effectQueue);
-  }
-}
-
-class Node extends Disposable {
-  _dependencies = /* @__PURE__ */ new Set();
-  _dependents = /* @__PURE__ */ new Set();
-  _status = "resolved";
-  get status() {
-    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    return this._status;
-  }
-  set status(status) {
-    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    this._status = status;
-  }
-  registerDependency(dependency) {
-    if (this._disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    this._dependencies.add(dependency);
-    dependency.registerDependent(this);
-  }
-  unregisterDependency(dependency) {
-    if (this._disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    this._dependencies.delete(dependency);
-    dependency.unregisterDependent(this);
-  }
-  clearDependencies() {
-    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    this._dependencies.forEach((dependency) => {
-      dependency.unregisterDependent(this);
-    });
-    this._dependencies.clear();
-  }
-  registerDependent(dependent) {
-    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    this._dependents.add(dependent);
-  }
-  unregisterDependent(dependent) {
-    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    this._dependents.delete(dependent);
-  }
-  notifyDependents() {
-    if (this.disposed) return;
-    this._dependents.forEach((dependent) => {
-      dependent.notify();
-    });
-  }
-  watch(tracker) {
-    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    tracker.registerDependency(this);
-  }
-  trigger() {
-    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    this.notifyDependents();
-  }
-  notify() {
-    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    if (this.status === "dirty") return;
-    this.status = "dirty";
-    this.notifyDependents();
-  }
-  dispose() {
-    if (this._disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    Array.from(this._dependents).forEach((dependant) => {
-      dependant.unregisterDependency(this);
-      this.unregisterDependent(dependant);
-    });
-    Array.from(this._dependencies).forEach((dependency) => {
-      this.unregisterDependency(dependency);
-    });
-    this._disposed = true;
-  }
-}
-
-class Observable extends Disposable {
-  _dependents = /* @__PURE__ */ new Set();
-  _status = "resolved";
-  get status() {
-    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    return this._status;
-  }
-  set status(status) {
-    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    this._status = status;
-  }
-  registerDependent(dependent) {
-    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    this._dependents.add(dependent);
-  }
-  unregisterDependent(dependent) {
-    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    this._dependents.delete(dependent);
-  }
-  notifyDependents() {
-    if (this.disposed) return;
-    this._dependents.forEach((dependent) => {
-      dependent.notify();
-    });
-  }
-  watch(tracker) {
-    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    tracker.registerDependency(this);
-  }
-  trigger() {
-    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    this.notifyDependents();
-  }
-  dispose() {
-    if (this._disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    Array.from(this._dependents).forEach((dependant) => {
-      dependant.unregisterDependency(this);
-      this.unregisterDependent(dependant);
-    });
-    this._disposed = true;
-  }
-}
-
-class Observer extends Disposable {
-  _dependencies = /* @__PURE__ */ new Set();
-  registerDependency(dependency) {
-    if (this._disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    this._dependencies.add(dependency);
-    dependency.registerDependent(this);
-  }
-  unregisterDependency(dependency) {
-    if (this._disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    this._dependencies.delete(dependency);
-    dependency.unregisterDependent(this);
-  }
-  clearDependencies() {
-    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    this._dependencies.forEach((dependency) => {
-      dependency.unregisterDependent(this);
-    });
-    this._dependencies.clear();
-  }
-  dispose() {
-    if (this._disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    Array.from(this._dependencies).forEach((dependency) => {
-      this.unregisterDependency(dependency);
-    });
-    this._disposed = true;
-  }
-}
-
 class EffectNode extends Observer {
   _data;
   _onData;
@@ -482,6 +496,11 @@ class EffectNode extends Observer {
       this._executedEpoch = this._notifyEpoch;
       return;
     }
+    if (this._dependencyDisposed) {
+      this._dependencyDisposed = false;
+      this._executedEpoch = this._notifyEpoch;
+      return;
+    }
     const targetEpoch = this._notifyEpoch;
     while (this._executedEpoch < targetEpoch) {
       this._executedEpoch++;
@@ -489,6 +508,11 @@ class EffectNode extends Observer {
         this._executedEpoch = this._notifyEpoch;
         return;
       }
+      if (this._dependencyDisposed) {
+        this._dependencyDisposed = false;
+        this._executedEpoch = this._notifyEpoch;
+        return;
+      }
       try {
         this.clearDependencies();
         const data = this._data(this);
@@ -508,7 +532,9 @@ class EffectNode extends Observer {
   }
 }
 
+const PICOFLOW_VALUE_NODE = /* @__PURE__ */ Symbol.for("picoflow.node");
 class ValueNode extends Node {
+  [PICOFLOW_VALUE_NODE] = true;
   _value;
   _error;
   watch(tracker) {
@@ -889,7 +915,7 @@ class ArrayNode extends ValueSyncNode {
   }
   update(index, item) {
     if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    if (index < 0 || index >= this._value.length) {
+    if (index < 0 || index >= this._value.length || !Number.isInteger(index)) {
       throw new Error("[PicoFlow] Index out of bounds");
     }
     const previousValue = this._value[index];
@@ -1082,6 +1108,9 @@ function describeFlowInput(value) {
   }
   return typeof value;
 }
+function isValueNode(flow) {
+  return typeof flow === "object" && flow !== null && PICOFLOW_VALUE_NODE in flow;
+}
 function fromNode(node, options) {
   const [resource, { refetch }] = createResource(() => node.pick());
   let fx;
@@ -1122,7 +1151,7 @@ function fromGetter(getter) {
   return fromNode(derivation, { disposeNode: true });
 }
 function from(flow) {
-  if (flow instanceof ValueAsyncNode || flow instanceof ValueSyncNode) {
+  if (isValueNode(flow)) {
     return fromNode(flow);
   }
   if (typeof flow === "function") {
@@ -1131,4 +1160,4 @@ function from(flow) {
   throw new Error(`[PicoFlow] from(): expected a FlowValue or getter function, received ${describeFlowInput(flow)}`);
 }
 
-export { array, constant, constantAsync, derivation, derivationAsync, from, isDisposable, map, signal, state, stateAsync, subscribe, writableDerivation, writableDerivationAsync };
+export { array, constant, constantAsync, derivation, derivationAsync, from, isDisposable, map, onFlushError, signal, state, stateAsync, subscribe, writableDerivation, writableDerivationAsync };

package/dist/types/api/base/flowConfig.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Installs a global handler for errors that escape the reactive flush.
+ *
+ * All reactive work — recomputing derivations, running effects — happens inside an
+ * asynchronous flush. Without this hook, an error escaping the flush (an effect callback
+ * that throws with no `onError`, or a feedback loop between two effects) becomes an
+ * uncaught exception, which terminates a Node process. Installing a handler here makes
+ * that error catchable instead.
+ *
+ * Defaults to `console.error`. The handler replaces any previously installed handler —
+ * it is not additive.
+ *
+ * @param handler - Called with the error that escaped the flush.
+ *
+ * @public
+ */
+export declare function onFlushError(handler: (error: unknown) => void): void;
+//# sourceMappingURL=flowConfig.d.ts.map

package/dist/types/api/base/flowConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowConfig.d.ts","sourceRoot":"","sources":["../../../../src/api/base/flowConfig.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAEpE"}

package/dist/types/api/base/index.d.ts

@@ -1,3 +1,4 @@
+export * from './flowConfig.js';
 export * from './flowDisposable.js';
 export * from './flowObservable.js';
 export * from './flowSubscribable.js';

package/dist/types/api/base/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/base/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/base/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}

package/dist/types/base/disposable.d.ts

@@ -1,11 +1,11 @@
 import { FlowDisposable } from '../api/index.js';
 /**
  * Base implementation of the disposable pattern for reactive primitives.
- * Throws an error if disposed multiple times.
+ * Concrete subclasses implement `dispose()` and are expected to throw if disposed multiple times.
  */
-export declare class Disposable implements FlowDisposable {
+export declare abstract class Disposable implements FlowDisposable {
     protected _disposed: boolean;
     get disposed(): boolean;
-    dispose(): void;
+    abstract dispose(): void;
 }
 //# sourceMappingURL=disposable.d.ts.map

package/dist/types/base/disposable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"disposable.d.ts","sourceRoot":"","sources":["../../../src/base/disposable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;;GAGG;AACH,qBAAa,UAAW,YAAW,cAAc;IAC7C,SAAS,CAAC,SAAS,UAAS;IAE5B,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,OAAO,IAAI,IAAI;CAIlB"}
+{"version":3,"file":"disposable.d.ts","sourceRoot":"","sources":["../../../src/base/disposable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;;GAGG;AACH,8BAAsB,UAAW,YAAW,cAAc;IACtD,SAAS,CAAC,SAAS,UAAS;IAE5B,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,QAAQ,CAAC,OAAO,IAAI,IAAI;CAC3B"}

package/dist/types/base/executionStack.d.ts

@@ -11,6 +11,8 @@ export declare class ExecutionStack {
     private static readonly _effectQueue;
     private static _executionScheduled?;
     private static _coalesceResetScheduled;
+    /** Routes any error escaping the flush loop; defaults to logging rather than crashing (A2-SEM-2, A2-SEC-1). */
+    private static _onFlushError;
     /**
      * True once the current synchronous call stack has finished and microtasks have started.
      * EffectNode uses this to treat microtask notifications (e.g. async resolve) differently
@@ -25,6 +27,8 @@ export declare class ExecutionStack {
      * and resets per-effect coalesce flags via onReset.
      */
     static scheduleCoalesceReset(onReset: () => void): void;
+    /** @internal Wired to the public `onFlushError()` API in `src/api/base/flowConfig.ts`. */
+    static setFlushErrorHandler(handler: (error: unknown) => void): void;
     static pushPending(node: IObserver): void;
     static pushEffect(effect: IObserver): void;
     private static _beginSyncTurn;

package/dist/types/base/executionStack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executionStack.d.ts","sourceRoot":"","sources":["../../../src/base/executionStack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;GAKG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAmB;IACxD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAmB;IACvD,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAgB;IACnD,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAS;IAC/C;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa,CAAS;IAErC,2FAA2F;IAC3F,MAAM,KAAK,YAAY,IAAI,OAAO,CAEjC;IAED;;;;OAIG;IACH,MAAM,CAAC,qBAAqB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAUvD,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAMzC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAM1C,OAAO,CAAC,MAAM,CAAC,cAAc;IAK7B,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAWjC,OAAO,CAAC,MAAM,CAAC,MAAM;IAerB,OAAO,CAAC,MAAM,CAAC,QAAQ;CAI1B"}
+{"version":3,"file":"executionStack.d.ts","sourceRoot":"","sources":["../../../src/base/executionStack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;GAKG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAmB;IACxD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAmB;IACvD,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAgB;IACnD,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAS;IAC/C,+GAA+G;IAC/G,OAAO,CAAC,MAAM,CAAC,aAAa,CAA6D;IACzF;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa,CAAS;IAErC,2FAA2F;IAC3F,MAAM,KAAK,YAAY,IAAI,OAAO,CAEjC;IAED;;;;OAIG;IACH,MAAM,CAAC,qBAAqB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAUvD,0FAA0F;IAC1F,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAIpE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAMzC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAM1C,OAAO,CAAC,MAAM,CAAC,cAAc;IAK7B,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAWjC,OAAO,CAAC,MAAM,CAAC,MAAM;IAsBrB,OAAO,CAAC,MAAM,CAAC,QAAQ;CAI1B"}

package/dist/types/base/node.d.ts

@@ -16,11 +16,12 @@ export declare abstract class Node<T> extends Disposable implements IObservable<
     clearDependencies(): void;
     registerDependent(dependent: IObserver): void;
     unregisterDependent(dependent: IObserver): void;
+    markDependencyDisposed(): void;
     notifyDependents(): void;
     watch(tracker: FlowTracker): void;
     trigger(): void;
-    notify(): void;
     dispose(): void;
+    abstract notify(): void;
     abstract execute(): void;
     abstract subscribe(onValue: FlowOnDataListener<T>, onError?: FlowOnErrorListener, onPending?: FlowOnPendingListener): FlowEffect;
 }

package/dist/types/base/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/base/node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;GAEG;AACH,8BAAsB,IAAI,CAAC,CAAC,CAAE,SAAQ,UAAW,YAAW,WAAW,CAAC,CAAC,CAAC,EAAE,SAAS;IACjF,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,WAAW,CAAwB;IAC3C,SAAS,CAAC,OAAO,EAAE,gBAAgB,CAAc;IAEjD,IAAI,MAAM,IAAI,gBAAgB,CAG7B;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAGlC;IAED,kBAAkB,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAM1D,oBAAoB,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAM5D,iBAAiB,IAAI,IAAI;IAQzB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAK7C,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAK/C,gBAAgB,IAAI,IAAI;IAOxB,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAKjC,OAAO,IAAI,IAAI;IAKf,MAAM,IAAI,IAAI;IAOL,OAAO,IAAI,IAAI;IAaxB,QAAQ,CAAC,OAAO,IAAI,IAAI;IAExB,QAAQ,CAAC,SAAS,CACd,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE,mBAAmB,EAC7B,SAAS,CAAC,EAAE,qBAAqB,GAClC,UAAU;CAChB"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/base/node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;GAEG;AACH,8BAAsB,IAAI,CAAC,CAAC,CAAE,SAAQ,UAAW,YAAW,WAAW,CAAC,CAAC,CAAC,EAAE,SAAS;IACjF,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,WAAW,CAAwB;IAC3C,SAAS,CAAC,OAAO,EAAE,gBAAgB,CAAc;IAEjD,IAAI,MAAM,IAAI,gBAAgB,CAG7B;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAGlC;IAED,kBAAkB,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAM1D,oBAAoB,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAM5D,iBAAiB,IAAI,IAAI;IAQzB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAK7C,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAK/C,sBAAsB,IAAI,IAAI;IAM9B,gBAAgB,IAAI,IAAI;IAOxB,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAKjC,OAAO,IAAI,IAAI;IAKN,OAAO,IAAI,IAAI;IAcxB,QAAQ,CAAC,MAAM,IAAI,IAAI;IACvB,QAAQ,CAAC,OAAO,IAAI,IAAI;IAExB,QAAQ,CAAC,SAAS,CACd,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE,mBAAmB,EAC7B,SAAS,CAAC,EAAE,qBAAqB,GAClC,UAAU;CAChB"}

package/dist/types/base/observable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observable.d.ts","sourceRoot":"","sources":["../../../src/base/observable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IACrD,IAAI,MAAM,IAAI,gBAAgB,CAAC;IAC/B,IAAI,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE;IACrC,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAC9C,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAChD,gBAAgB,IAAI,IAAI,CAAC;IACzB,SAAS,CACL,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE,mBAAmB,EAC7B,SAAS,CAAC,EAAE,qBAAqB,GAClC,UAAU,CAAC;CACjB;AAED;;GAEG;AACH,8BAAsB,UAAU,CAAC,CAAC,CAAE,SAAQ,UAAW,YAAW,WAAW,CAAC,CAAC,CAAC;IAC5E,OAAO,CAAC,WAAW,CAAwB;IAC3C,SAAS,CAAC,OAAO,EAAE,gBAAgB,CAAc;IAEjD,IAAI,MAAM,IAAI,gBAAgB,CAG7B;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAGlC;IAED,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAK7C,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAK/C,gBAAgB,IAAI,IAAI;IAOxB,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAKjC,OAAO,IAAI,IAAI;IAKN,OAAO,IAAI,IAAI;IAUxB,QAAQ,CAAC,SAAS,CACd,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE,mBAAmB,EAC7B,SAAS,CAAC,EAAE,qBAAqB,GAClC,UAAU;CAChB"}
+{"version":3,"file":"observable.d.ts","sourceRoot":"","sources":["../../../src/base/observable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IACrD,IAAI,MAAM,IAAI,gBAAgB,CAAC;IAC/B,IAAI,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE;IACrC,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAC9C,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAChD,gBAAgB,IAAI,IAAI,CAAC;IACzB,SAAS,CACL,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE,mBAAmB,EAC7B,SAAS,CAAC,EAAE,qBAAqB,GAClC,UAAU,CAAC;CACjB;AAED;;GAEG;AACH,8BAAsB,UAAU,CAAC,CAAC,CAAE,SAAQ,UAAW,YAAW,WAAW,CAAC,CAAC,CAAC;IAC5E,OAAO,CAAC,WAAW,CAAwB;IAC3C,SAAS,CAAC,OAAO,EAAE,gBAAgB,CAAc;IAEjD,IAAI,MAAM,IAAI,gBAAgB,CAG7B;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAGlC;IAED,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAK7C,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAK/C,gBAAgB,IAAI,IAAI;IAOxB,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAKjC,OAAO,IAAI,IAAI;IAKN,OAAO,IAAI,IAAI;IAWxB,QAAQ,CAAC,SAAS,CACd,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE,mBAAmB,EAC7B,SAAS,CAAC,EAAE,qBAAqB,GAClC,UAAU;CAChB"}

package/dist/types/base/observer.d.ts

@@ -9,12 +9,21 @@ export interface IObserver {
     clearDependencies(): void;
     notify(): void;
     execute(): void;
+    /**
+     * Called by a dependency's `dispose()` on each of its remaining dependents, so an
+     * observer already queued for the next flush can skip that run instead of reading
+     * through the now-disposed dependency and throwing (A2-SEM-1).
+     */
+    markDependencyDisposed(): void;
 }
 /**
  * Base implementation managing dependency tracking for reactive observers.
  */
 export declare abstract class Observer extends Disposable implements IObserver {
     private _dependencies;
+    /** Set when a dependency disposed while this observer was queued; consumed by the next execute(). */
+    protected _dependencyDisposed: boolean;
+    markDependencyDisposed(): void;
     registerDependency(dependency: IObservable<unknown>): void;
     unregisterDependency(dependency: IObservable<unknown>): void;
     clearDependencies(): void;

package/dist/types/base/observer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../../../src/base/observer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,kBAAkB,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAC3D,oBAAoB,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,iBAAiB,IAAI,IAAI,CAAC;IAC1B,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,IAAI,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,8BAAsB,QAAS,SAAQ,UAAW,YAAW,SAAS;IAClE,OAAO,CAAC,aAAa,CAAmC;IAExD,kBAAkB,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAM1D,oBAAoB,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAM5D,iBAAiB,IAAI,IAAI;IAQhB,OAAO,IAAI,IAAI;IAQxB,QAAQ,CAAC,MAAM,IAAI,IAAI;IACvB,QAAQ,CAAC,OAAO,IAAI,IAAI;CAC3B"}
+{"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../../../src/base/observer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,kBAAkB,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAC3D,oBAAoB,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,iBAAiB,IAAI,IAAI,CAAC;IAC1B,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,IAAI,IAAI,CAAC;IAChB;;;;OAIG;IACH,sBAAsB,IAAI,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,8BAAsB,QAAS,SAAQ,UAAW,YAAW,SAAS;IAClE,OAAO,CAAC,aAAa,CAAmC;IACxD,qGAAqG;IACrG,SAAS,CAAC,mBAAmB,UAAS;IAEtC,sBAAsB,IAAI,IAAI;IAI9B,kBAAkB,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAM1D,oBAAoB,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAM5D,iBAAiB,IAAI,IAAI;IAQhB,OAAO,IAAI,IAAI;IAQxB,QAAQ,CAAC,MAAM,IAAI,IAAI;IACvB,QAAQ,CAAC,OAAO,IAAI,IAAI;CAC3B"}

package/dist/types/converters/solid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"solid.d.ts","sourceRoot":"","sources":["../../../src/converters/solid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoD,KAAK,QAAQ,EAAwB,MAAM,UAAU,CAAC;AACjH,OAAO,EAAmB,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAa,MAAM,iBAAiB,CAAC;AAoEhH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AACzD,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"solid.d.ts","sourceRoot":"","sources":["../../../src/converters/solid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoD,KAAK,QAAQ,EAAwB,MAAM,UAAU,CAAC;AACjH,OAAO,EAAmB,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAa,MAAM,iBAAiB,CAAC;AA8EhH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AACzD,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC"}

package/dist/types/nodes/effectNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"effectNode.d.ts","sourceRoot":"","sources":["../../../src/nodes/effectNode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAkB,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5D;;;;;;;;;;;GAWG;AACH,qBAAa,UAAU,CAAC,CAAC,CAAE,SAAQ,QAAS,YAAW,UAAU;IAC7D,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,QAAQ,CAAC,CAAsB;IACvC,OAAO,CAAC,UAAU,CAAC,CAAwB;IAC3C,wFAAwF;IACxF,OAAO,CAAC,OAAO,CAAS;IACxB,2FAA2F;IAC3F,OAAO,CAAC,qBAAqB,CAAS;IACtC,yEAAyE;IACzE,OAAO,CAAC,YAAY,CAAK;IACzB,8DAA8D;IAC9D,OAAO,CAAC,cAAc,CAAK;gBAGvB,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,EACxB,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC7B,OAAO,CAAC,EAAE,mBAAmB,EAC7B,SAAS,CAAC,EAAE,qBAAqB;IAYrC,MAAM,IAAI,IAAI;IAsBd,OAAO,IAAI,IAAI;CAgClB"}
+{"version":3,"file":"effectNode.d.ts","sourceRoot":"","sources":["../../../src/nodes/effectNode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAkB,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5D;;;;;;;;;;;GAWG;AACH,qBAAa,UAAU,CAAC,CAAC,CAAE,SAAQ,QAAS,YAAW,UAAU;IAC7D,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,QAAQ,CAAC,CAAsB;IACvC,OAAO,CAAC,UAAU,CAAC,CAAwB;IAC3C,wFAAwF;IACxF,OAAO,CAAC,OAAO,CAAS;IACxB,2FAA2F;IAC3F,OAAO,CAAC,qBAAqB,CAAS;IACtC,yEAAyE;IACzE,OAAO,CAAC,YAAY,CAAK;IACzB,8DAA8D;IAC9D,OAAO,CAAC,cAAc,CAAK;gBAGvB,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,EACxB,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC7B,OAAO,CAAC,EAAE,mBAAmB,EAC7B,SAAS,CAAC,EAAE,qBAAqB;IAYrC,MAAM,IAAI,IAAI;IAsBd,OAAO,IAAI,IAAI;CA6ClB"}

package/dist/types/nodes/valueNode.d.ts

@@ -1,11 +1,18 @@
 import { FlowEffect, FlowOnDataListener, FlowOnErrorListener, FlowOnPendingListener, FlowTracker, NotPromise } from '../api/index.js';
 import { Node } from '../base/index.js';
 import { Scheduler } from '../schedulers/index.js';
+/**
+ * Global-registry symbol branding a {@link ValueNode} instance, so `from()` can recognize a node
+ * built by a different copy of the library — where its class objects, and thus `instanceof`, differ.
+ * @internal
+ */
+export declare const PICOFLOW_VALUE_NODE: unique symbol;
 /**
  * Base class for reactive values that compute, cache, and propagate changes through the dependency graph.
  * @internal
  */
 export declare abstract class ValueNode<T> extends Node<T> {
+    readonly [PICOFLOW_VALUE_NODE] = true;
     protected abstract _scheduler: Scheduler;
     protected _value?: NotPromise<T>;
     protected _error?: unknown;

package/dist/types/nodes/valueNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"valueNode.d.ts","sourceRoot":"","sources":["../../../src/nodes/valueNode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACX,UAAU,EACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAkB,IAAI,EAAwC,MAAM,kBAAkB,CAAC;AAC9F,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGtE;;;GAGG;AACH,8BAAsB,SAAS,CAAC,CAAC,CAAE,SAAQ,IAAI,CAAC,CAAC,CAAC;IAC9C,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;IACzC,SAAS,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACjC,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAElB,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IA6BjC,MAAM,IAAI,IAAI;IAUd,OAAO,IAAI,IAAI;IAKxB,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,CAAC;IA8BtB,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC;IAkCxB,OAAO,IAAI,IAAI;IAUf,SAAS,CACL,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE,mBAAmB,EAC7B,SAAS,CAAC,EAAE,qBAAqB,GAClC,UAAU;CAKhB"}
+{"version":3,"file":"valueNode.d.ts","sourceRoot":"","sources":["../../../src/nodes/valueNode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACX,UAAU,EACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAkB,IAAI,EAAwC,MAAM,kBAAkB,CAAC;AAC9F,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGtE;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,eAA8B,CAAC;AAE/D;;;GAGG;AACH,8BAAsB,SAAS,CAAC,CAAC,CAAE,SAAQ,IAAI,CAAC,CAAC,CAAC;IAC9C,QAAQ,CAAC,CAAC,mBAAmB,CAAC,QAAQ;IACtC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;IACzC,SAAS,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACjC,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAElB,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IA6BjC,MAAM,IAAI,IAAI;IAUd,OAAO,IAAI,IAAI;IAKxB,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,CAAC;IA8BtB,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC;IAkCxB,OAAO,IAAI,IAAI;IAUf,SAAS,CACL,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE,mBAAmB,EAC7B,SAAS,CAAC,EAAE,qBAAqB,GAClC,UAAU;CAKhB"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ersbeth/picoflow",
-    "version": "2.1.0",
+    "version": "2.2.0",
     "description": "Minimal Dataflow library for TypeScript",
     "type": "module",
     "packageManager": "pnpm@11.9.0",
@@ -23,10 +23,11 @@
         "test:coverage": "pnpm exec vitest run --coverage",
         "test:browser": "pnpm exec vitest --config=vitest.browser.config.ts",
         "test:browser:coverage": "pnpm exec vitest run --config=vitest.browser.config.ts --coverage",
+        "test:coverage:merge": "rm -rf .vitest-reports && pnpm exec vitest run --coverage --reporter=blob --outputFile=.vitest-reports/node.json && pnpm exec vitest run --config=vitest.browser.config.ts --coverage --reporter=blob --outputFile=.vitest-reports/browser.json && pnpm exec vitest --mergeReports=.vitest-reports --coverage",
         "ci:check": "pnpm exec tsc --noEmit",
         "ci:lint": "pnpm exec biome check .",
-        "ci:test": "pnpm exec vitest run",
-        "ci:test:browser": "pnpm exec vitest run --config=vitest.browser.config.ts",
+        "ci:test": "pnpm exec vitest run --coverage",
+        "ci:test:browser": "pnpm exec vitest run --config=vitest.browser.config.ts --coverage",
         "ci:pack:smoke": "node tools/release/smoke-tarball.mjs",
         "ci:release:check": "node tools/release/check-release.mjs",
         "playwright:install": "playwright install --with-deps chromium",
@@ -69,7 +70,7 @@
     },
     "repository": {
         "type": "git",
-        "url": "git+ssh://git@gitlab.com/ersbeth-web/picoflow.git"
+        "url": "git+https://gitlab.com/ersbeth-web/picoflow.git"
     },
     "author": "Elisabeth Rousset",
     "license": "MIT",