@ersbeth/picoflow 2.0.3 → 2.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Elisabeth Rousset
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -4,6 +4,10 @@
 
 > **Upgrading from v1.x?** See the [Upgrade Guide](https://ersbeth-web.gitlab.io/picoflow/guide/advanced/migration-v2.html) for migration instructions.
 
+## Requirements
+
+The schedulers use `Promise.withResolvers()`, so picoflow needs **Node ≥ 22**, or Chrome ≥ 119, Safari ≥ 17.4, Firefox ≥ 121 in the browser. There is no fallback: on an older runtime the failure is immediate, on the first primitive you create.
+
 ## Installation
 
 ```bash
@@ -21,6 +25,17 @@ yarn add @ersbeth/picoflow
 
 For comprehensive guides and API documentation, visit the [official website](https://ersbeth-web.gitlab.io/picoflow/)
 
+## Development
+
+```bash
+pnpm install
+pnpm playwright:install   # once — downloads Chromium for the browser tests
+pnpm test                 # watch Node tests
+pnpm test:browser         # watch browser tests
+```
+
+See [`CONTRIBUTING.md`](CONTRIBUTING.md) for the full setup, the conventions and the release procedure. Known issues and their status are tracked in [`audits/FINDINGS.md`](audits/FINDINGS.md); planned breaking changes in [`ROADMAP.md`](ROADMAP.md); vulnerability reporting in [`SECURITY.md`](SECURITY.md).
+
 ## AI Coding Agents
 
 Picoflow ships a [`SKILL.md`](SKILL.md) with the npm package, matching the exact version you have

package/dist/picoflow.js

@@ -7,7 +7,7 @@ function isDisposable(obj) {
 class PendingError extends Error {
   pendingPromise;
   constructor(promise) {
-    super("[PicoFlow] PendingResolver pending");
+    super("[PicoFlow] Computation is pending");
     this.name = "PendingError";
     this.pendingPromise = promise;
   }
@@ -36,8 +36,8 @@ class AsyncResolver {
     return this._finished;
   }
   compute() {
-    if (this._finished) throw new Error("[Picoflow] PendingResolver: Can't restart a settled resolver");
-    if (this._aborted) throw new Error("[Picoflow] PendingResolver: Can't restart an aborted resolver");
+    if (this._finished) throw new Error("[PicoFlow] AsyncResolver: Can't restart a settled resolver");
+    if (this._aborted) throw new Error("[PicoFlow] AsyncResolver: Can't restart an aborted resolver");
     this._iteration++;
     const currentIteration = this._iteration;
     this._compute().then((value) => {
@@ -51,8 +51,8 @@ class AsyncResolver {
     });
   }
   overwrite(promise) {
-    if (this._finished) throw new Error("[Picoflow] PendingResolver: Can't overwrite a settled resolver");
-    if (this._aborted) throw new Error("[Picoflow] PendingResolver: Can't overwrite an aborted resolver");
+    if (this._finished) throw new Error("[PicoFlow] AsyncResolver: Can't overwrite a settled resolver");
+    if (this._aborted) throw new Error("[PicoFlow] AsyncResolver: Can't overwrite an aborted resolver");
     this._iteration++;
     const currentIteration = this._iteration;
     promise.then((value) => {
@@ -81,7 +81,7 @@ class AsyncScheduler {
     this._onResolve = onResolve;
     this._onReject = onReject;
     this._resolver = new AsyncResolver(compute);
-    this._resolver.computed.then(this._onResolve).catch(this._onReject).finally(() => this._settled.resolve());
+    this._attachHandlers(this._resolver);
   }
   get settled() {
     if (this._disposed) throw new Error("[PicoFlow] ComputationScheduler is disposed");
@@ -95,7 +95,7 @@ class AsyncScheduler {
     if (this._resolver.finished) {
       this._resolver = new AsyncResolver(this._compute);
       this._settled = Promise.withResolvers();
-      this._resolver.computed.then(this._onResolve).catch(this._onReject).finally(() => this._settled.resolve());
+      this._attachHandlers(this._resolver);
     }
     this._resolver.overwrite(promise);
   }
@@ -104,10 +104,19 @@ class AsyncScheduler {
     if (this._resolver.finished) {
       this._resolver = new AsyncResolver(this._compute);
       this._settled = Promise.withResolvers();
-      this._resolver.computed.then(this._onResolve).catch(this._onReject).finally(() => this._settled.resolve());
+      this._attachHandlers(this._resolver);
     }
     this._resolver.compute();
   }
+  _attachHandlers(resolver) {
+    resolver.computed.then((value) => {
+      if (this._disposed) return;
+      this._onResolve(value);
+    }).catch((error) => {
+      if (this._disposed) return;
+      this._onReject(error);
+    }).finally(() => this._settled.resolve());
+  }
   dispose() {
     this._resolver.abort();
     this._disposed = true;
@@ -116,7 +125,6 @@ class AsyncScheduler {
 
 class SyncResolver {
   _compute;
-  _iteration = 0;
   _aborted = false;
   _finished = false;
   _onValue;
@@ -133,18 +141,16 @@ class SyncResolver {
     return this._finished;
   }
   compute() {
-    if (this._finished) throw new Error("[Picoflow] PendingResolver: Can't restart a settled resolver");
-    if (this._aborted) throw new Error("[Picoflow] PendingResolver: Can't restart an aborted resolver");
-    this._iteration++;
-    const currentIteration = this._iteration;
+    if (this._finished) throw new Error("[PicoFlow] SyncResolver: Can't restart a settled resolver");
+    if (this._aborted) throw new Error("[PicoFlow] SyncResolver: Can't restart an aborted resolver");
     try {
       const value = this._compute();
-      if (this._iteration === currentIteration && !this._aborted) {
+      if (!this._finished && !this._aborted) {
         this._finished = true;
         this._onValue(value);
       }
     } catch (error) {
-      if (this._iteration === currentIteration && !this._aborted) {
+      if (!this._finished && !this._aborted) {
         if (!(error instanceof PendingError)) {
           this._finished = true;
           this._onError(error);
@@ -153,17 +159,12 @@ class SyncResolver {
     }
   }
   overwrite(value) {
-    if (this._finished) throw new Error("[Picoflow] PendingResolver: Can't overwrite a settled resolver");
-    if (this._aborted) throw new Error("[Picoflow] PendingResolver: Can't overwrite an aborted resolver");
-    this._iteration++;
-    const currentIteration = this._iteration;
-    if (this._iteration === currentIteration && !this._aborted) {
-      this._finished = true;
-      this._onValue(value);
-    }
+    if (this._finished) throw new Error("[PicoFlow] SyncResolver: Can't overwrite a settled resolver");
+    if (this._aborted) throw new Error("[PicoFlow] SyncResolver: Can't overwrite an aborted resolver");
+    this._finished = true;
+    this._onValue(value);
   }
   abort() {
-    this._iteration++;
     this._aborted = true;
   }
 }
@@ -224,17 +225,48 @@ class Disposable {
 }
 
 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) => {
@@ -245,15 +277,21 @@ class ExecutionStack {
       }, 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._pendingQueue.forEach((node) => {
-      node.execute();
-    });
-    ExecutionStack._pendingQueue.length = 0;
-    ExecutionStack._effectQueue.forEach((effect) => {
-      effect.execute();
-    });
-    ExecutionStack._effectQueue.length = 0;
+    ExecutionStack._drain(ExecutionStack._pendingQueue);
+    ExecutionStack._drain(ExecutionStack._effectQueue);
   }
 }
 
@@ -403,32 +441,67 @@ class EffectNode extends Observer {
   _onData;
   _onError;
   _onPending;
+  /** True while this effect is already waiting in the effect queue for the next flush. */
+  _queued = false;
+  /** Guards the single coalesced bump of _notifyEpoch while _queued during one sync turn. */
+  _coalescedWhileQueued = false;
+  /** Monotonic count of notifications that must eventually be executed. */
+  _notifyEpoch = 0;
+  /** How many notification epochs have been executed so far. */
+  _executedEpoch = 0;
   constructor(data, onData, onError, onPending) {
     super();
     this._data = data;
     this._onData = onData;
     this._onError = onError;
     this._onPending = onPending;
+    this._notifyEpoch = 1;
     this.execute();
   }
   notify() {
     if (this._disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    if (this._queued) {
+      if (!this._coalescedWhileQueued) {
+        this._coalescedWhileQueued = true;
+        if (ExecutionStack.pastSyncTurn) {
+          this._notifyEpoch++;
+        }
+      }
+      return;
+    }
+    this._notifyEpoch++;
+    this._queued = true;
+    ExecutionStack.scheduleCoalesceReset(() => {
+      this._coalescedWhileQueued = false;
+    });
     ExecutionStack.pushEffect(this);
   }
   execute() {
-    try {
-      if (this._disposed) throw new Error("[PicoFlow] Primitive is disposed");
-      this.clearDependencies();
-      const data = this._data(this);
-      this._onData(data);
-    } catch (error) {
-      if (error instanceof PendingError) {
-        this._onPending?.();
-      } else {
-        if (this._onError) {
-          this._onError(error instanceof Error ? error : new Error(String(error)));
+    this._queued = false;
+    if (this._disposed) {
+      this._executedEpoch = this._notifyEpoch;
+      return;
+    }
+    const targetEpoch = this._notifyEpoch;
+    while (this._executedEpoch < targetEpoch) {
+      this._executedEpoch++;
+      if (this._disposed) {
+        this._executedEpoch = this._notifyEpoch;
+        return;
+      }
+      try {
+        this.clearDependencies();
+        const data = this._data(this);
+        this._onData(data);
+      } catch (error) {
+        if (error instanceof PendingError) {
+          this._onPending?.();
         } else {
-          throw error;
+          if (this._onError) {
+            this._onError(error instanceof Error ? error : new Error(String(error)));
+          } else {
+            throw error;
+          }
         }
       }
     }
@@ -570,12 +643,14 @@ class ValueAsyncNode extends ValueNode {
     );
   }
   _onResolve(value) {
+    if (this.disposed) return;
     this.status = "resolved";
     this._value = value;
     this._error = void 0;
     this.notifyDependents();
   }
   _onReject(error) {
+    if (this.disposed) return;
     this.status = "error";
     this._error = error;
     this.notifyDependents();
@@ -724,11 +799,66 @@ class ValueSyncNode extends ValueNode {
   }
 }
 
+class ActionNode extends ValueSyncNode {
+  _slots = /* @__PURE__ */ new Set();
+  _enqueueForSubscribers(action) {
+    for (const slot of this._slots) {
+      slot.queue.push(action);
+    }
+  }
+  set(valueOrUpdater) {
+    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    if (typeof valueOrUpdater === "function") {
+      const updater = valueOrUpdater;
+      const nextValue2 = updater(this._value);
+      if (this.status === "resolved" && nextValue2 === this._value) return;
+      this._enqueueForSubscribers(nextValue2);
+      super.set(updater);
+      return;
+    }
+    const nextValue = valueOrUpdater;
+    if (this.status === "resolved" && nextValue === this._value) return;
+    this._enqueueForSubscribers(nextValue);
+    super.set(nextValue);
+  }
+  subscribe(onValue, onError, onPending) {
+    if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    const slot = { queue: [] };
+    this._slots.add(slot);
+    const effect = new EffectNode(
+      (tracker) => {
+        this.watch(tracker);
+        if (slot.queue.length === 0) {
+          return [this.get(tracker)];
+        }
+        return slot.queue.splice(0);
+      },
+      (actions) => {
+        for (const action of actions) {
+          onValue(action);
+        }
+      },
+      onError,
+      onPending
+    );
+    const originalDispose = effect.dispose.bind(effect);
+    effect.dispose = () => {
+      this._slots.delete(slot);
+      originalDispose();
+    };
+    return effect;
+  }
+  dispose() {
+    this._slots.clear();
+    super.dispose();
+  }
+}
+
 class ArrayNode extends ValueSyncNode {
   $lastAction;
   constructor(value = []) {
     super(value);
-    this.$lastAction = new ValueSyncNode({
+    this.$lastAction = new ActionNode({
       type: "set",
       setItems: value,
       clearedItems: []
@@ -781,6 +911,7 @@ class ArrayNode extends ValueSyncNode {
   }
   pop() {
     if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    if (this._value.length === 0) return void 0;
     const item = this._value.pop();
     this.notifyDependents();
     this.$lastAction.set({ type: "pop", removedItem: item });
@@ -794,6 +925,7 @@ class ArrayNode extends ValueSyncNode {
   }
   shift() {
     if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    if (this._value.length === 0) return void 0;
     const item = this._value.shift();
     this.notifyDependents();
     this.$lastAction.set({ type: "shift", removedItem: item });
@@ -822,9 +954,9 @@ class ArrayNode extends ValueSyncNode {
   }
   dispose() {
     super.dispose();
-    this._value.forEach((item) => {
-      if (item instanceof Disposable) item.dispose();
-    });
+    if (!this.$lastAction.disposed) {
+      this.$lastAction.dispose();
+    }
     this._value = [];
   }
 }
@@ -837,7 +969,7 @@ class MapNode extends ValueSyncNode {
   $lastAction;
   constructor(value = /* @__PURE__ */ new Map()) {
     super(value);
-    this.$lastAction = new ValueSyncNode({
+    this.$lastAction = new ActionNode({
       type: "set",
       setMap: value,
       clearedMap: /* @__PURE__ */ new Map()
@@ -845,8 +977,7 @@ class MapNode extends ValueSyncNode {
   }
   add(key, value) {
     if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
-    const previousValue = this._value.get(key);
-    if (previousValue) {
+    if (this._value.has(key)) {
       throw new Error("[PicoFlow] Key already exists");
     }
     this._value.set(key, value);
@@ -855,8 +986,8 @@ class MapNode extends ValueSyncNode {
   }
   update(key, value) {
     if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    if (!this._value.has(key)) throw new Error("[PicoFlow] Key does not exist");
     const previousValue = this._value.get(key);
-    if (!previousValue) throw new Error("[PicoFlow] Key does not exist");
     this._value.set(key, value);
     this.notifyDependents();
     this.$lastAction.set({
@@ -869,8 +1000,8 @@ class MapNode extends ValueSyncNode {
   }
   delete(key) {
     if (this.disposed) throw new Error("[PicoFlow] Primitive is disposed");
+    if (!this._value.has(key)) throw new Error("[PicoFlow] Key does not exist");
     const value = this._value.get(key);
-    if (value === void 0) throw new Error("[PicoFlow] Key does not exist");
     this._value.delete(key);
     this.notifyDependents();
     this.$lastAction.set({ type: "delete", key, removedValue: value });
@@ -897,9 +1028,9 @@ class MapNode extends ValueSyncNode {
   }
   dispose() {
     super.dispose();
-    this._value.forEach((item) => {
-      if (item instanceof Disposable) item.dispose();
-    });
+    if (!this.$lastAction.disposed) {
+      this.$lastAction.dispose();
+    }
     this._value.clear();
   }
 }
@@ -943,7 +1074,15 @@ function writableDerivation(compute) {
   return new ValueSyncNode(compute);
 }
 
-function fromNode(node) {
+function describeFlowInput(value) {
+  if (value === null) return "null";
+  if (typeof value === "object") {
+    const name = value.constructor?.name;
+    return name ? `object (${name})` : "object";
+  }
+  return typeof value;
+}
+function fromNode(node, options) {
   const [resource, { refetch }] = createResource(() => node.pick());
   let fx;
   onMount(() => {
@@ -968,14 +1107,19 @@ function fromNode(node) {
     resource.error ?? resource();
     resetErrorBoundaries();
   });
-  onCleanup(() => fx.dispose());
+  onCleanup(() => {
+    fx.dispose();
+    if (options?.disposeNode && !node.disposed) {
+      node.dispose();
+    }
+  });
   return resource;
 }
 function fromGetter(getter) {
   const derivation = new ValueSyncNode((t) => {
     return getter(t);
   });
-  return fromNode(derivation);
+  return fromNode(derivation, { disposeNode: true });
 }
 function from(flow) {
   if (flow instanceof ValueAsyncNode || flow instanceof ValueSyncNode) {
@@ -984,7 +1128,7 @@ function from(flow) {
   if (typeof flow === "function") {
     return fromGetter(flow);
   }
-  throw new Error("Invalid flow type");
+  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 };

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

@@ -1,6 +1,6 @@
-import { FlowDisposable } from './flowDisposable';
-import { FlowSubscribable } from './flowSubscribable';
-import { FlowTracker } from './flowTracker';
+import { FlowDisposable } from './flowDisposable.js';
+import { FlowSubscribable } from './flowSubscribable.js';
+import { FlowTracker } from './flowTracker.js';
 /**
  * Contract for reactive primitives that emit changes and notify their dependents in the reactivity graph.
  * @public

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

@@ -1 +1 @@
-{"version":3,"file":"flowObservable.d.ts","sourceRoot":"","sources":["../../../../src/api/base/flowObservable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC1E;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAElC;;;;;;OAMG;IACH,OAAO,IAAI,IAAI,CAAC;CACnB"}
+{"version":3,"file":"flowObservable.d.ts","sourceRoot":"","sources":["../../../../src/api/base/flowObservable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC1E;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAElC;;;;;;OAMG;IACH,OAAO,IAAI,IAAI,CAAC;CACnB"}

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

@@ -1,5 +1,5 @@
-import { FlowEffect } from '../nodes/flowEffect';
-import { FlowTracker } from './flowTracker';
+import { FlowEffect } from '../nodes/flowEffect.js';
+import { FlowTracker } from './flowTracker.js';
 /**
  * Function that tracks reactive dependencies and returns data.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"flowSubscribable.d.ts","sourceRoot":"","sources":["../../../../src/api/base/flowSubscribable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,WAAW,KAAK,CAAC,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAEtD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,IAAI,CAAC;AAE/C;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IAC/B;;;;;;;;;;;;OAYG;IACH,SAAS,CACL,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC7B,OAAO,CAAC,EAAE,mBAAmB,EAC7B,SAAS,CAAC,EAAE,qBAAqB,GAClC,UAAU,CAAC;CACjB"}
+{"version":3,"file":"flowSubscribable.d.ts","sourceRoot":"","sources":["../../../../src/api/base/flowSubscribable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,WAAW,KAAK,CAAC,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAEtD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,IAAI,CAAC;AAE/C;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IAC/B;;;;;;;;;;;;OAYG;IACH,SAAS,CACL,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC7B,OAAO,CAAC,EAAE,mBAAmB,EAC7B,SAAS,CAAC,EAAE,qBAAqB,GAClC,UAAU,CAAC;CACjB"}

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

@@ -1,4 +1,4 @@
-import { FlowDisposable } from './flowDisposable';
+import { FlowDisposable } from './flowDisposable.js';
 /**
  * Contract for reactive computations that track dependencies and react to changes in the reactivity graph.
  * @public

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

@@ -1 +1 @@
-{"version":3,"file":"flowTracker.d.ts","sourceRoot":"","sources":["../../../../src/api/base/flowTracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,cAAc;CAAG"}
+{"version":3,"file":"flowTracker.d.ts","sourceRoot":"","sources":["../../../../src/api/base/flowTracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,cAAc;CAAG"}

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

@@ -1,5 +1,5 @@
-export * from './flowDisposable';
-export * from './flowObservable';
-export * from './flowSubscribable';
-export * from './flowTracker';
+export * from './flowDisposable.js';
+export * from './flowObservable.js';
+export * from './flowSubscribable.js';
+export * from './flowTracker.js';
 //# sourceMappingURL=index.d.ts.map

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,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC"}
+{"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"}

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

@@ -1,3 +1,3 @@
-export * from './base';
-export * from './nodes';
+export * from './base/index.js';
+export * from './nodes/index.js';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/api/nodes/async/flowConstantAsync.d.ts

@@ -1,4 +1,4 @@
-import { FlowValue } from '../flowValue';
+import { FlowValue } from '../flowValue.js';
 /** Function that initializes a value asynchronously. */
 export type InitFunctionAsync<T> = () => Promise<T>;
 /**

package/dist/types/api/nodes/async/flowConstantAsync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flowConstantAsync.d.ts","sourceRoot":"","sources":["../../../../../src/api/nodes/async/flowConstantAsync.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,wDAAwD;AACxD,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;CAAG;AAE7D;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;AAC1E,wBAAgB,aAAa,CAAC,CAAC,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"flowConstantAsync.d.ts","sourceRoot":"","sources":["../../../../../src/api/nodes/async/flowConstantAsync.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,wDAAwD;AACxD,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;CAAG;AAE7D;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;AAC1E,wBAAgB,aAAa,CAAC,CAAC,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC"}

package/dist/types/api/nodes/async/flowDerivationAsync.d.ts

@@ -1,6 +1,6 @@
-import { FlowTracker } from '../../base';
-import { FlowValue } from '../flowValue';
-import { NotPromise } from '../utils';
+import { FlowTracker } from '../../base/index.js';
+import { FlowValue } from '../flowValue.js';
+import { NotPromise } from '../utils.js';
 /** Function that derives a value asynchronously from dependencies and optionally the previous value. */
 export type DerivationFunctionAsync<T> = (tracker: FlowTracker, previous?: NotPromise<T> | undefined) => Promise<T>;
 /**

package/dist/types/api/nodes/async/flowDerivationAsync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flowDerivationAsync.d.ts","sourceRoot":"","sources":["../../../../../src/api/nodes/async/flowDerivationAsync.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,wGAAwG;AACxG,MAAM,MAAM,uBAAuB,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IACxD;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAE9F"}
+{"version":3,"file":"flowDerivationAsync.d.ts","sourceRoot":"","sources":["../../../../../src/api/nodes/async/flowDerivationAsync.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,wGAAwG;AACxG,MAAM,MAAM,uBAAuB,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IACxD;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAE9F"}

package/dist/types/api/nodes/async/flowStateAsync.d.ts

@@ -1,6 +1,6 @@
-import { FlowValue } from '../flowValue';
-import { NotPromise } from '../utils';
-import { InitFunctionAsync } from './flowConstantAsync';
+import { FlowValue } from '../flowValue.js';
+import { NotPromise } from '../utils.js';
+import { InitFunctionAsync } from './flowConstantAsync.js';
 /** Function that updates a value asynchronously based on the previous value. */
 export type UpdateFunctionAsync<T> = (previous: NotPromise<T> | undefined) => Promise<T>;
 /**

package/dist/types/api/nodes/async/flowStateAsync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flowStateAsync.d.ts","sourceRoot":"","sources":["../../../../../src/api/nodes/async/flowStateAsync.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,gFAAgF;AAChF,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEzF;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IACnD;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/B,GAAG,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CAC9C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;AACpE,wBAAgB,UAAU,CAAC,CAAC,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"flowStateAsync.d.ts","sourceRoot":"","sources":["../../../../../src/api/nodes/async/flowStateAsync.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,gFAAgF;AAChF,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEzF;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IACnD;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/B,GAAG,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CAC9C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;AACpE,wBAAgB,UAAU,CAAC,CAAC,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC"}