@ersbeth/picoflow 1.1.2 → 2.0.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/nodes/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

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

@@ -0,0 +1,19 @@
+import { FlowMap, FlowMapAction, NotPromise, UpdateFunction } from '../api';
+import { ValueSyncNode } from './valueSyncNode';
+/**
+ * Internal implementation of reactive map with mutation tracking.
+ * @internal
+ */
+export declare class MapNode<K, V> extends ValueSyncNode<Map<K, V>> implements FlowMap<K, V> {
+    $lastAction: ValueSyncNode<FlowMapAction<K, V>>;
+    protected _value: Map<K, V>;
+    constructor(value?: Map<K, V>);
+    add(key: K, value: V): void;
+    update(key: K, value: V): V;
+    delete(key: K): V;
+    set(map: NotPromise<Map<K, V>>): Map<K, V>;
+    set(updater: UpdateFunction<Map<K, V>>): Map<K, V>;
+    clear(): Map<K, V>;
+    dispose(): void;
+}
+//# sourceMappingURL=mapNode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapNode.d.ts","sourceRoot":"","sources":["../../../src/nodes/mapNode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAEjF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;GAGG;AACH,qBAAa,OAAO,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAE,YAAW,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACzE,WAAW,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvD,UAAkB,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAExB,KAAK,GAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAa;IASxC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;IAiBpB,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC;IAuB3B,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC;IAkBR,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1C,GAAG,CAAC,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAoB3D,KAAK,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAiBT,OAAO,IAAI,IAAI;CAO3B"}

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

@@ -0,0 +1,10 @@
+import { FlowEffect, FlowOnDataListener, FlowOnErrorListener, FlowOnPendingListener, FlowSignal } from '../api';
+import { Observable } from '../base';
+/**
+ * Manual trigger that notifies subscribers without carrying data.
+ * @internal
+ */
+export declare class SignalNode extends Observable<void> implements FlowSignal {
+    subscribe(onTrigger: FlowOnDataListener<void>, onError?: FlowOnErrorListener, onPending?: FlowOnPendingListener): FlowEffect;
+}
+//# sourceMappingURL=signalNode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signalNode.d.ts","sourceRoot":"","sources":["../../../src/nodes/signalNode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACrH,OAAO,EAAE,UAAU,EAAiB,MAAM,SAAS,CAAC;AAGpD;;;GAGG;AACH,qBAAa,UAAW,SAAQ,UAAU,CAAC,IAAI,CAAE,YAAW,UAAU;IAClE,SAAS,CACL,SAAS,EAAE,kBAAkB,CAAC,IAAI,CAAC,EACnC,OAAO,CAAC,EAAE,mBAAmB,EAC7B,SAAS,CAAC,EAAE,qBAAqB,GAClC,UAAU;CAKhB"}

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

@@ -0,0 +1,23 @@
+import { DerivationFunctionAsync, InitFunctionAsync, NotPromise, UpdateFunctionAsync } from '../api';
+import { AsyncScheduler } from '../schedulers';
+import { ValueNode } from './valueNode';
+/**
+ * Function that computes a value asynchronously (either initialization or derivation).
+ * @internal
+ */
+export type ComputeFunctionAsync<T> = InitFunctionAsync<T> | DerivationFunctionAsync<T>;
+/**
+ * Asynchronous reactive value that resolves promises and propagates results when settled.
+ * @internal
+ */
+export declare class ValueAsyncNode<T extends NotPromise<unknown>> extends ValueNode<T> {
+    protected _scheduler: AsyncScheduler<T>;
+    private _compute;
+    constructor(promiseOrCompute: Promise<T> | ComputeFunctionAsync<T>);
+    private _onResolve;
+    private _onReject;
+    set(promise: Promise<T>): void;
+    set(updater: UpdateFunctionAsync<T>): void;
+    refresh(): void;
+}
+//# sourceMappingURL=valueAsyncNode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"valueAsyncNode.d.ts","sourceRoot":"","sources":["../../../src/nodes/valueAsyncNode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAC1G,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;GAGG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,GAAG,uBAAuB,CAAC,CAAC,CAAC,CAAC;AACxF;;;GAGG;AACH,qBAAa,cAAc,CAAC,CAAC,SAAS,UAAU,CAAC,OAAO,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IAC3E,SAAS,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,QAAQ,CAAmB;gBAEvB,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC;IAiBlE,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,SAAS;IAMjB,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAC9B,GAAG,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,IAAI;IAgC1C,OAAO,IAAI,IAAI;CAIlB"}

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

@@ -0,0 +1,20 @@
+import { FlowEffect, FlowOnDataListener, FlowOnErrorListener, FlowOnPendingListener, FlowTracker, NotPromise } from '../api';
+import { Node } from '../base';
+import { Scheduler } from '../schedulers';
+/**
+ * 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> {
+    protected abstract _scheduler: Scheduler;
+    protected _value?: NotPromise<T>;
+    protected _error?: unknown;
+    watch(tracker: FlowTracker): void;
+    notify(): void;
+    dispose(): void;
+    get(tracker: FlowTracker): T;
+    pick(): Promise<T>;
+    execute(): void;
+    subscribe(onValue: FlowOnDataListener<T>, onError?: FlowOnErrorListener, onPending?: FlowOnPendingListener): FlowEffect;
+}
+//# sourceMappingURL=valueNode.d.ts.map

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

@@ -0,0 +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,QAAQ,CAAC;AAChB,OAAO,EAAkB,IAAI,EAAwC,MAAM,SAAS,CAAC;AACrF,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAG7D;;;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;IASf,SAAS,CACL,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE,mBAAmB,EAC7B,SAAS,CAAC,EAAE,qBAAqB,GAClC,UAAU;CAKhB"}

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

@@ -0,0 +1,23 @@
+import { DerivationFunction, InitFunction, NotPromise, UpdateFunction } from '../api';
+import { SyncScheduler } from '../schedulers';
+import { ValueNode } from './valueNode';
+/**
+ * Function that computes a value (either initialization or derivation).
+ * @internal
+ */
+export type ComputeFunction<T> = InitFunction<T> | DerivationFunction<T>;
+/**
+ * Synchronous reactive value that computes immediately without async scheduling.
+ * @internal
+ */
+export declare class ValueSyncNode<T extends NotPromise<unknown>> extends ValueNode<T> {
+    protected _scheduler: SyncScheduler<T>;
+    private _compute;
+    constructor(valueOrCompute: NotPromise<T> | ComputeFunction<T>);
+    private _onResolve;
+    private _onReject;
+    set(value: NotPromise<T>): void;
+    set(updater: UpdateFunction<T>): void;
+    refresh(): void;
+}
+//# sourceMappingURL=valueSyncNode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"valueSyncNode.d.ts","sourceRoot":"","sources":["../../../src/nodes/valueSyncNode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;AAEzE;;;GAGG;AACH,qBAAa,aAAa,CAAC,CAAC,SAAS,UAAU,CAAC,OAAO,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IAC1E,SAAS,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACvC,OAAO,CAAC,QAAQ,CAAU;gBAEd,cAAc,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAuB9D,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,SAAS;IAKjB,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;IAC/B,GAAG,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAiDrC,OAAO,IAAI,IAAI;CAsBlB"}

package/dist/types/schedulers/asyncResolver.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Manages asynchronous computation lifecycle with iteration tracking to prevent race conditions.
+ * @internal
+ */
+export declare class AsyncResolver<T> {
+    private readonly _compute;
+    private readonly _computed;
+    private _iteration;
+    private _aborted;
+    private _finished;
+    constructor(compute: () => Promise<T>);
+    get computed(): Promise<T>;
+    get aborted(): boolean;
+    get finished(): boolean;
+    compute(): void;
+    overwrite(promise: Promise<T>): void;
+    abort(): void;
+}
+//# sourceMappingURL=asyncResolver.d.ts.map

package/dist/types/schedulers/asyncResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncResolver.d.ts","sourceRoot":"","sources":["../../../src/schedulers/asyncResolver.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,aAAa,CAAC,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC;IAYrC,IAAI,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,CAEzB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,OAAO,IAAI,IAAI;IAmBf,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAiBpC,KAAK,IAAI,IAAI;CAIhB"}

package/dist/types/schedulers/asyncScheduler.d.ts

@@ -0,0 +1,20 @@
+import { Scheduler } from './scheduler';
+/**
+ * Scheduler that manages asynchronous computation lifecycle with resolver instances.
+ * @internal
+ */
+export declare class AsyncScheduler<T> implements Scheduler {
+    private readonly _compute;
+    private _resolver;
+    private _onResolve;
+    private _onReject;
+    private _settled;
+    private _disposed;
+    constructor(compute: () => Promise<T>, onResolve: (value: T) => void, onReject: (error: unknown) => void);
+    get settled(): Promise<void>;
+    get disposed(): boolean;
+    overwrite(promise: Promise<T>): void;
+    compute(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=asyncScheduler.d.ts.map

package/dist/types/schedulers/asyncScheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncScheduler.d.ts","sourceRoot":"","sources":["../../../src/schedulers/asyncScheduler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;GAGG;AACH,qBAAa,cAAc,CAAC,CAAC,CAAE,YAAW,SAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;IAWxG,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAapC,OAAO,IAAI,IAAI;IAaf,OAAO,IAAI,IAAI;CAIlB"}

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

@@ -0,0 +1,5 @@
+export * from './asyncScheduler';
+export * from './pendingError';
+export * from './scheduler';
+export * from './syncScheduler';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schedulers/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/types/schedulers/pendingError.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Error thrown when an async computation is pending, encapsulating its promise for cascading dependencies.
+ * @internal
+ */
+export declare class PendingError extends Error {
+    readonly pendingPromise: Promise<unknown>;
+    constructor(promise: Promise<unknown>);
+}
+//# sourceMappingURL=pendingError.d.ts.map

package/dist/types/schedulers/pendingError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pendingError.d.ts","sourceRoot":"","sources":["../../../src/schedulers/pendingError.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACnC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;gBAE9B,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;CAKxC"}

package/dist/types/schedulers/scheduler.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Contract for schedulers that coordinate reactive computations and their lifecycle.
+ * @internal
+ */
+export interface Scheduler {
+    compute(): void;
+    dispose(): void;
+    settled: Promise<void>;
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/types/schedulers/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../../src/schedulers/scheduler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,SAAS;IACtB,OAAO,IAAI,IAAI,CAAC;IAChB,OAAO,IAAI,IAAI,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/dist/types/schedulers/syncResolver.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Manages synchronous computation lifecycle with iteration tracking to prevent race conditions.
+ * @internal
+ */
+export declare class SyncResolver<T> {
+    private readonly _compute;
+    private _iteration;
+    private _aborted;
+    private _finished;
+    private _onValue;
+    private _onError;
+    constructor(compute: () => T, onValue: (value: T) => void, onError: (error: unknown) => void);
+    get aborted(): boolean;
+    get finished(): boolean;
+    compute(): void;
+    overwrite(value: T): void;
+    abort(): void;
+}
+//# sourceMappingURL=syncResolver.d.ts.map

package/dist/types/schedulers/syncResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncResolver.d.ts","sourceRoot":"","sources":["../../../src/schedulers/syncResolver.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,YAAY,CAAC,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,QAAQ,CAA2B;gBAE/B,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;IAM5F,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,OAAO,IAAI,IAAI;IAsBf,SAAS,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAazB,KAAK,IAAI,IAAI;CAIhB"}

package/dist/types/schedulers/syncScheduler.d.ts

@@ -0,0 +1,19 @@
+import { Scheduler } from './scheduler';
+/**
+ * Scheduler that manages synchronous computation lifecycle with resolver instances.
+ * @internal
+ */
+export declare class SyncScheduler<T> implements Scheduler {
+    private readonly _compute;
+    private _resolver;
+    private _onResolve;
+    private _onReject;
+    private _settled;
+    private _disposed;
+    constructor(compute: () => T, onResolve: (value: T) => void, onReject: (error: unknown) => void);
+    get settled(): Promise<void>;
+    overwrite(value: T): void;
+    compute(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=syncScheduler.d.ts.map

package/dist/types/schedulers/syncScheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncScheduler.d.ts","sourceRoot":"","sources":["../../../src/schedulers/syncScheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C;;;GAGG;AACH,qBAAa,aAAa,CAAC,CAAC,CAAE,YAAW,SAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;IAa/F,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;IAED,SAAS,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IASzB,OAAO,IAAI,IAAI;IASf,OAAO,IAAI,IAAI;CAIlB"}

package/docs/.vitepress/config.mts

@@ -3,108 +3,143 @@ import { withMermaid } from "vitepress-plugin-mermaid";
 import typedocSidebar from "../api/typedoc-sidebar.json";
 
 export default withMermaid(
-	defineConfig({
-		title: "PicoFlow",
-		description: "Lightweight reactive dataflow library for TypeScript",
-		base: "/picoflow/",
+    defineConfig({
+        title: "PicoFlow",
+        description: "Lightweight reactive dataflow library for TypeScript",
+        base: "/picoflow/",
 
-		mermaid: {},
+        mermaid: {},
 
-		head: [["link", { rel: "icon", type: "image/svg+xml", href: "/logo.svg" }]],
+        head: [["link", { rel: "icon", type: "image/svg+xml", href: "/logo.svg" }]],
 
-		themeConfig: {
-			logo: "/logo.svg",
+        themeConfig: {
+            logo: "/logo.svg",
 
-			nav: [
-				{ text: "Guide", link: "/guide/introduction/getting-started" },
-				{ text: "Examples", link: "/examples/patterns" },
-				{ text: "API Reference", link: "/api/" },
-			],
+            nav: [
+                { text: "Guide", link: "/guide/introduction/getting-started" },
+                // { text: "Examples", link: "/examples/patterns" },
+                { text: "API Reference", link: "/api/" },
+            ],
 
-			sidebar: {
-				"/guide/": [
-					{
-						text: "Introduction",
-						items: [
-							{
-								text: "Getting Started",
-								link: "/guide/introduction/getting-started",
-							},
-							{ text: "Conventions", link: "/guide/introduction/conventions" },
-							{ text: "Concepts", link: "/guide/introduction/concepts" },
-							{ text: "Lifecycle", link: "/guide/introduction/lifecycle" },
-						],
-					},
-					{
-						text: "Primitives",
-						items: [
-							{ text: "Overview", link: "/guide/primitives/overview" },
-							{ text: "Signals", link: "/guide/primitives/signal" },
-							{ text: "States", link: "/guide/primitives/state" },
-							{ text: "Derivations", link: "/guide/primitives/derivations" },
-							{ text: "Effects", link: "/guide/primitives/effects" },
-							// { text: "Resources", link: "/guide/primitives/resources" },
-							// { text: "Streams", link: "/guide/primitives/streams" },
-							{ text: "Maps", link: "/guide/primitives/map" },
-							{ text: "Arrays", link: "/guide/primitives/array" },
-							// { text: "Constants", link: "/guide/primitives/constant" },
-						],
-					},
-					{
-						text: "Advanced",
-						items: [
-							{
-								text: "Disposal",
-								link: "/guide/advanced/disposal",
-							},
-							{
-								text: "Use with SolidJS",
-								link: "/guide/advanced/solidjs",
-							},
-							{
-								text: "Upgrade from v0.x",
-								link: "/guide/advanced/upgrading",
-							},
-						],
-					},
-				],
+            sidebar: {
+                "/guide/": [
+                    {
+                        text: "Introduction",
+                        items: [
+                            {
+                                text: "Getting Started",
+                                link: "/guide/introduction/getting-started",
+                            },
+                            {
+                                text: "Conventions",
+                                link: "/guide/introduction/conventions",
+                            },
+                            {
+                                text: "Concepts",
+                                link: "/guide/introduction/concepts",
+                            },
+                        ],
+                    },
+                    {
+                        text: "Primitives",
+                        items: [
+                            {
+                                text: "Overview",
+                                link: "/guide/primitives/overview",
+                            },
+                            {
+                                text: "Signals",
+                                link: "/guide/primitives/signal",
+                            },
+                            { text: "Constants", link: "/guide/primitives/constant" },
 
-				"/examples/": [
-					{
-						text: "Examples",
-						items: [
-							{ text: "Common Patterns", link: "/examples/patterns" },
-							{ text: "Code Examples", link: "/examples/examples" },
-						],
-					},
-				],
+                            { text: "States", link: "/guide/primitives/state" },
+                            {
+                                text: "Derivations",
+                                link: "/guide/primitives/derivations",
+                            },
+                            { text: "Maps", link: "/guide/primitives/map" },
+                            { text: "Arrays", link: "/guide/primitives/array" },
+                            {
+                                text: "Side Effects",
+                                link: "/guide/primitives/effects",
+                            },
+                        ],
+                    },
+                    {
+                        text: "Advanced",
+                        items: [
+                            {
+                                text: "Use with SolidJS",
+                                link: "/guide/advanced/solidjs",
+                            },
+                            {
+                                text: "Upgrade to v2",
+                                link: "/guide/advanced/migration-v2",
+                            },
+                            {
+                                text: "Upgrade to v1",
+                                link: "/guide/advanced/migration-v1",
+                            },
+                            // {
+                            //     text: "Lifecycle",
+                            //     link: "/guide/introduction/lifecycle",
+                            // },
+                            // {
+                            //     text: "Disposal",
+                            //     link: "/guide/advanced/disposal",
+                            // },
+                            // {
+                            //     text: "Architecture",
+                            //     link: "/guide/advanced/architecture",
+                            // },
+                        ],
+                    },
+                ],
 
-				"/api/": [
-					{
-						text: "API Reference",
-						items: typedocSidebar,
-					},
-				],
-			},
+                // "/examples/": [
+                //     {
+                //         text: "Examples",
+                //         items: [
+                //             {
+                //                 text: "Common Patterns",
+                //                 link: "/examples/patterns",
+                //             },
+                //             {
+                //                 text: "Code Examples",
+                //                 link: "/examples/examples",
+                //             },
+                //         ],
+                //     },
+                // ],
 
-			socialLinks: [
-				{ icon: "gitlab", link: "https://gitlab.com/ersbeth-web/picoflow" },
-			],
+                "/api/": [
+                    {
+                        text: "API Reference",
+                        items: typedocSidebar,
+                    },
+                ],
+            },
 
-			search: {
-				provider: "local",
-			},
+            socialLinks: [
+                {
+                    icon: "gitlab",
+                    link: "https://gitlab.com/ersbeth-web/picoflow",
+                },
+            ],
 
-			editLink: {
-				pattern:
-					"https://gitlab.com/ersbeth-web/picoflow/-/edit/main/docs/:path",
-				text: "Edit this page on GitLab",
-			},
+            search: {
+                provider: "local",
+            },
 
-			footer: {
-				copyright:
-					"Copyright ©2025 <a href='https://gitlab.com/ersbeth/'>Ersbeth</a>",
-			},
-		},
-	}),
+            editLink: {
+                pattern: "https://gitlab.com/ersbeth-web/picoflow/-/edit/main/docs/:path",
+                text: "Edit this page on GitLab",
+            },
+
+            footer: {
+                copyright: "Copyright ©2025 <a href='https://gitlab.com/ersbeth/'>Ersbeth</a>",
+            },
+        },
+    }),
 );

package/docs/api/functions/array.md

@@ -6,53 +6,30 @@
 function array<T>(initial?): FlowArray<T>;
 ```
 
-Defined in: [creators.ts:393](https://gitlab.com/ersbeth-web/picoflow/-/blob/a6cd2e5702b60b87a8efe22e2fe7d2ce3b0ccca4/src/creators.ts#L393)
+Defined in: [api/nodes/collections/flowArray.ts:153](https://gitlab.com/ersbeth-web/picoflow/-/blob/4e864254f0eac72524c3be40b9e41d799a16e020/src/api/nodes/collections/flowArray.ts#L153)
 
-Creates a new reactive array with mutation methods and fine-grained action tracking.
+Creates a reactive array with mutation methods and fine-grained action tracking.
+
+The array starts with the provided initial items (or empty if none provided). All mutation methods
+(push, pop, splice, etc.) notify dependents and emit detailed action information to `$lastAction`.
+Use the array itself for coarse-grained reactivity, or subscribe to `$lastAction` for fine-grained
+reactivity to specific mutation types. Useful for reactive lists, collections, or any data that
+needs array-like operations with automatic change propagation.
 
 ## Type Parameters
 
-| Type Parameter | Description |
-| ------ | ------ |
-| `T` | The type of the array elements. |
+| Type Parameter |
+| ------ |
+| `T` |
 
 ## Parameters
 
 | Parameter | Type | Description |
 | ------ | ------ | ------ |
-| `initial?` | `T`[] | An optional array of initial values. |
+| `initial?` | `T`[] | Optional initial array of items |
 
 ## Returns
 
-[`FlowArray`](/api/classes/FlowArray.md)\<`T`\>
-
-A new instance of [FlowArray](/api/classes/FlowArray.md).
-
-## Remarks
-
-A reactive array provides array-like mutation methods (push, pop, shift, unshift, splice)
-and tracks the last operation performed via `$lastAction`. This enables both whole-array
-reactivity and fine-grained tracking of specific mutations.
-
-The array automatically disposes disposable items when they are removed (if they implement
-the FlowDisposable interface).
+[`FlowArray`](/api/interfaces/FlowArray.md)\<`T`\>
 
-## Example
-
-```typescript
-const $items = array([1, 2, 3]);
-
-// Track the whole array
-effect((t) => {
-  console.log('Items:', $items.get(t));
-});
-
-// Track the last action
-effect((t) => {
-  const action = $items.$lastAction.get(t);
-  console.log('Action:', action.type);
-});
-
-$items.push(4); // Logs action: "push"
-$items.pop();   // Logs action: "pop"
-```
+A FlowArray with reactive mutation methods

package/docs/api/functions/constant.md

@@ -3,43 +3,31 @@
 # Function: constant()
 
 ```ts
-function constant<T>(value): FlowConstant<T>;
+function constant<T>(initializer): FlowConstant<T>;
 ```
 
-Defined in: [creators.ts:69](https://gitlab.com/ersbeth-web/picoflow/-/blob/a6cd2e5702b60b87a8efe22e2fe7d2ce3b0ccca4/src/creators.ts#L69)
+Defined in: [api/nodes/sync/flowConstant.ts:31](https://gitlab.com/ersbeth-web/picoflow/-/blob/4e864254f0eac72524c3be40b9e41d799a16e020/src/api/nodes/sync/flowConstant.ts#L31)
 
-Creates a new reactive constant.
+Creates a constant reactive value that initializes lazily and never recomputes.
+
+The initializer function runs once on first access, and the result is cached permanently.
+Unlike state or derivations, constants never react to changes - they represent immutable values
+in the reactive graph. Useful for expensive one-time computations or static configuration.
 
 ## Type Parameters
 
-| Type Parameter | Description |
-| ------ | ------ |
-| `T` | The type of the constant value. |
+| Type Parameter |
+| ------ |
+| `T` |
 
 ## Parameters
 
 | Parameter | Type | Description |
 | ------ | ------ | ------ |
-| `value` | `T` \| () => `T` | The value or a function that returns the value (for lazy initialization). |
+| `initializer` | [`InitFunction`](/api/type-aliases/InitFunction.md)\<`T`\> | Function that computes the constant value on first access |
 
 ## Returns
 
-[`FlowConstant`](/api/classes/FlowConstant.md)\<`T`\>
-
-A new instance of [FlowConstant](/api/classes/FlowConstant.md).
-
-## Remarks
-
-A constant is an immutable reactive value that never changes after initialization.
-It can be initialized eagerly (direct value) or lazily (function). Use constants for
-configuration, computed-once values, or expensive initialization that should only run once.
+[`FlowConstant`](/api/interfaces/FlowConstant.md)\<`T`\>
 
-## Example
-
-```typescript
-// Eager initialization
-const $config = constant({ apiUrl: 'https://api.example.com' });
-
-// Lazy initialization
-const $computed = constant(() => expensiveCalculation());
-```
+A FlowConstant that provides read-only access to the cached value