synstate 2.0.2 → 3.0.1

package/README.md

@@ -9,7 +9,7 @@
 [![npm version](https://img.shields.io/npm/v/synstate.svg)](https://www.npmjs.com/package/synstate)
 [![npm downloads](https://img.shields.io/npm/dm/synstate.svg)](https://www.npmjs.com/package/synstate)
 [![License](https://img.shields.io/npm/l/synstate.svg)](https://github.com/noshiro-pf/mono/blob/main/libs/synstate/LICENSE)
-[![codecov](https://codecov.io/gh/noshiro-pf/mono/graph/badge.svg)](https://codecov.io/gh/noshiro-pf/mono)
+[![codecov](https://codecov.io/gh/noshiro-pf/mono/graph/badge.svg?component=synstate)](https://codecov.io/gh/noshiro-pf/mono)
 
 </p>
 
@@ -24,7 +24,7 @@
 - 🎯 **Simple State Management**: Easy-to-use `createState` and `createReducer` similar to React useState/useReducer for global state
 - ⚡ **High Performance**: Optimized for fast state updates and minimal re-renders
 - 🎨 **Type-Safe**: Full TypeScript support with precise type inference
-- 🚀 **Lightweight**: <!-- bundle-size:synstate -->~4.4 kB min+gzip<!-- /bundle-size:synstate --> with only one external runtime dependency ([ts-data-forge](https://www.npmjs.com/package/ts-data-forge))
+- 🚀 **Lightweight**: <!-- bundle-size:synstate -->~4.6 kB min+gzip<!-- /bundle-size:synstate --> with only one external runtime dependency ([ts-data-forge](https://www.npmjs.com/package/ts-data-forge))
 - 🌐 **Framework Agnostic**: Works with React, Vue, Svelte, or vanilla JavaScript
 - 🔄 **Reactive Updates**: Automatic propagation of state changes to all subscribers
 - 📡 **Event System**: Built-in `createValueEmitter`, `createEventEmitter` for event-driven architecture

package/dist/core/base/create-child-observable.d.mts

@@ -0,0 +1,65 @@
+import { type Optional, type Some } from 'ts-data-forge';
+import { type AsyncChildObservable, type InitializedSyncChildObservable, type NonEmptyUnknownList, type SyncChildObservable, type UpdateToken, type Wrap } from '../types/index.mjs';
+/**
+ * The internal tools a sync-child leaf factory (`map`, `filter`, `zip`, …)
+ * receives — the replacement for the `protected` methods a subclass of
+ * `SyncChildObservableClass` used to inherit.
+ */
+export type SyncChildObservableTools<A> = Readonly<{
+    /** Emits `nextValue` under `updateToken` and notifies subscribers. */
+    setNext: (nextValue: A, updateToken: UpdateToken) => void;
+    getSnapshot: () => Optional<A>;
+    /** Completes this observable (leaf teardown included). */
+    complete: () => void;
+}>;
+/**
+ * The internal tools an async-child leaf factory (`debounce`, `switchMap`, …)
+ * receives. Async children additionally start their own update propagation.
+ */
+export type AsyncChildObservableTools<A> = Readonly<{
+    /** Emits `nextValue` and propagates the update to all descendants. */
+    startUpdate: (nextValue: A) => void;
+}> & SyncChildObservableTools<A>;
+type ChildObservableConfigBase<P extends NonEmptyUnknownList> = Readonly<{
+    parents: Wrap<P>;
+    depth?: number;
+    /**
+     * Leaf teardown (clear timers, unsubscribe inner observables, …), run at
+     * the beginning of `complete()` — the closure replacement for
+     * `override complete() { teardown(); super.complete(); }`.
+     */
+    onComplete?: () => void;
+}>;
+export type ChildObservableConfig<A, P extends NonEmptyUnknownList> = ChildObservableConfigBase<P> & Readonly<{
+    initialValue: Optional<A>;
+}>;
+export type InitializedChildObservableConfig<A, P extends NonEmptyUnknownList> = ChildObservableConfigBase<P> & Readonly<{
+    initialValue: Some<A>;
+}>;
+/**
+ * Creates a sync-child observable — the classless replacement for extending
+ * `SyncChildObservableClass`.
+ *
+ * `createTryUpdate` receives the internal tools and returns the `tryUpdate`
+ * implementation (the former `override tryUpdate`). It runs during
+ * construction, before the observable is registered to its parents; leaf
+ * state can live either in the enclosing factory scope or inside the
+ * `createTryUpdate` closure.
+ */
+export declare const createSyncChildObservable: <A, P extends NonEmptyUnknownList>({ parents, depth, initialValue, onComplete, }: ChildObservableConfig<A, P>, createTryUpdate: (tools: SyncChildObservableTools<A>) => (updateToken: UpdateToken) => void) => SyncChildObservable<A, P>;
+/**
+ * Creates a sync-child observable that always holds a value.
+ *
+ * Runtime-wise this is exactly `createSyncChildObservable`; only the types of
+ * `getSnapshot` and `pipe` are narrowed, which is what the
+ * `InitializedSyncChildObservableClass` overrides existed for.
+ */
+export declare const createInitializedSyncChildObservable: <A, P extends NonEmptyUnknownList>(config: InitializedChildObservableConfig<A, P>, createTryUpdate: (tools: SyncChildObservableTools<A>) => (updateToken: UpdateToken) => void) => InitializedSyncChildObservable<A, P>;
+/**
+ * Creates an async-child observable — the classless replacement for extending
+ * `AsyncChildObservableClass`. See {@link createSyncChildObservable} for the
+ * `createTryUpdate` contract.
+ */
+export declare const createAsyncChildObservable: <A, P extends NonEmptyUnknownList>({ parents, depth, initialValue, onComplete, }: ChildObservableConfig<A, P>, createTryUpdate: (tools: AsyncChildObservableTools<A>) => (updateToken: UpdateToken) => void) => AsyncChildObservable<A, P>;
+export {};
+//# sourceMappingURL=create-child-observable.d.mts.map

package/dist/core/base/create-child-observable.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-child-observable.d.mts","sourceRoot":"","sources":["../../../src/core/base/create-child-observable.mts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,QAAQ,EAAE,KAAK,IAAI,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,EAGL,KAAK,oBAAoB,EAEzB,KAAK,8BAA8B,EACnC,KAAK,mBAAmB,EAGxB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,IAAI,EACV,MAAM,oBAAoB,CAAC;AAQ5B;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAAI,QAAQ,CAAC;IACjD,sEAAsE;IACtE,OAAO,EAAE,CAAC,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,WAAW,KAAK,IAAI,CAAC;IAE1D,WAAW,EAAE,MAAM,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE/B,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,yBAAyB,CAAC,CAAC,IAAI,QAAQ,CAAC;IAClD,sEAAsE;IACtE,WAAW,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,IAAI,CAAC;CACrC,CAAC,GACA,wBAAwB,CAAC,CAAC,CAAC,CAAC;AAE9B,KAAK,yBAAyB,CAAC,CAAC,SAAS,mBAAmB,IAAI,QAAQ,CAAC;IACvE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAEjB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,MAAM,qBAAqB,CAC/B,CAAC,EACD,CAAC,SAAS,mBAAmB,IAC3B,yBAAyB,CAAC,CAAC,CAAC,GAC9B,QAAQ,CAAC;IACP,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;CAC3B,CAAC,CAAC;AAEL,MAAM,MAAM,gCAAgC,CAC1C,CAAC,EACD,CAAC,SAAS,mBAAmB,IAC3B,yBAAyB,CAAC,CAAC,CAAC,GAC9B,QAAQ,CAAC;IACP,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;CACvB,CAAC,CAAC;AAEL;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,GAAI,CAAC,EAAE,CAAC,SAAS,mBAAmB,iDAMrE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,mBACb,CACf,KAAK,EAAE,wBAAwB,CAAC,CAAC,CAAC,KAC/B,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,KACtC,mBAAmB,CAAC,CAAC,EAAE,CAAC,CA0C1B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oCAAoC,GAC/C,CAAC,EACD,CAAC,SAAS,mBAAmB,UAErB,gCAAgC,CAAC,CAAC,EAAE,CAAC,CAAC,mBAC7B,CACf,KAAK,EAAE,wBAAwB,CAAC,CAAC,CAAC,KAC/B,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,KACtC,8BAA8B,CAAC,CAAC,EAAE,CAAC,CASrC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GAAI,CAAC,EAAE,CAAC,SAAS,mBAAmB,iDAMtE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,mBACb,CACf,KAAK,EAAE,yBAAyB,CAAC,CAAC,CAAC,KAChC,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,KACtC,oBAAoB,CAAC,CAAC,EAAE,CAAC,CA6C3B,CAAC"}

package/dist/core/base/create-child-observable.mjs

@@ -0,0 +1,181 @@
+import { Arr } from 'ts-data-forge';
+import { isChildObservable, isManagerObservable, } from '../types/index.mjs';
+import { maxDepth } from '../utils/index.mjs';
+import { assembleObservable, createManagerObservableParts, createObservableBaseHandle, } from './create-observable-base.mjs';
+
+
+
+
+
+
+
+
+
+
+export const createSyncChildObservable = ({ parents, depth = 1 + maxDepth(parents), initialValue, onComplete, }, createTryUpdate) => {
+    const handle = createObservableBaseHandle(initialValue);
+    const complete = () => {
+        onComplete?.();
+        handle.completeBase();
+
+        for (const par of parents) {
+            par.tryComplete();
+        }
+    };
+    const tryComplete = () => {
+        tryCompleteChild({
+            hasSubscriber: handle.hasSubscriber(),
+            hasActiveChild: handle.hasActiveChild(),
+            parents,
+            complete,
+        });
+    };
+    const tryUpdate = createTryUpdate({
+        setNext: handle.setNext,
+        getSnapshot: handle.getSnapshot,
+        complete,
+    });
+    const observable = assembleObservable({
+        kind: 'sync child',
+        depth,
+        handle,
+        tryUpdate,
+        tryComplete,
+        complete,
+        extra: { parents },
+    });
+    registerChild(observable, parents);
+    return observable;
+};
+
+
+
+
+
+
+
+export const createInitializedSyncChildObservable = (config, createTryUpdate) => {
+    const observable = createSyncChildObservable(config, createTryUpdate);
+    return (
+
+
+
+    observable);
+};
+
+
+
+
+
+export const createAsyncChildObservable = ({ parents, depth = 1 + maxDepth(parents), initialValue, onComplete, }, createTryUpdate) => {
+    const handle = createObservableBaseHandle(initialValue);
+    const { addDescendant, startUpdate } = createManagerObservableParts(handle);
+    const complete = () => {
+        onComplete?.();
+        handle.completeBase();
+
+        for (const par of parents) {
+            par.tryComplete();
+        }
+    };
+    const tryComplete = () => {
+        tryCompleteChild({
+            hasSubscriber: handle.hasSubscriber(),
+            hasActiveChild: handle.hasActiveChild(),
+            parents,
+            complete,
+        });
+    };
+    const tryUpdate = createTryUpdate({
+        setNext: handle.setNext,
+        getSnapshot: handle.getSnapshot,
+        complete,
+        startUpdate,
+    });
+    const observable = assembleObservable({
+        kind: 'async child',
+        depth,
+        handle,
+        tryUpdate,
+        tryComplete,
+        complete,
+        extra: { parents, addDescendant },
+    });
+    registerChild(observable, parents);
+    return observable;
+};
+
+
+
+
+
+
+
+const hasCircularDependencyFrom = (node, mut_visited, mut_inPath) => {
+    if (mut_inPath.has(node.id))
+        return true;
+    if (mut_visited.has(node.id))
+        return false;
+    mut_visited.add(node.id);
+    mut_inPath.add(node.id);
+    if (isChildObservable(node)) {
+        for (const parent of node.parents) {
+            if (hasCircularDependencyFrom(parent, mut_visited, mut_inPath)) {
+                return true;
+            }
+        }
+    }
+    mut_inPath.delete(node.id);
+    return false;
+};
+const detectCircularDependency = (child, parents) => {
+    const mut_visited = new Set();
+    const mut_inPath = new Set([child.id]);
+    for (const parent of parents) {
+        if (hasCircularDependencyFrom(parent, mut_visited, mut_inPath)) {
+            throw new Error('Circular dependency detected in observable graph: a child observable cannot be its own ancestor.');
+        }
+    }
+};
+
+
+
+
+
+
+const registerChild = (child, parents) => {
+    detectCircularDependency(child, parents);
+    for (const p of parents) {
+        p.addChild(child);
+    }
+
+    const mut_rest = Array.from(parents);
+    while (Arr.isNonEmpty(mut_rest)) {
+        const p = mut_rest.pop();
+        if (p === undefined)
+            break;
+        if (isManagerObservable(p)) {
+            p.addDescendant(child);
+        }
+        else {
+
+            mut_rest.push(...p.parents);
+        }
+    }
+};
+const tryCompleteChild = ({ hasSubscriber, hasActiveChild, parents, complete, }) => {
+
+    if (parents.every((r) => r.isCompleted)) {
+        complete();
+        return;
+    }
+
+    if (!hasSubscriber && !hasActiveChild) {
+        complete();
+    }
+
+    for (const par of parents) {
+        par.tryComplete();
+    }
+};
+//# sourceMappingURL=create-child-observable.mjs.map

package/dist/core/base/create-child-observable.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-child-observable.mjs","sourceRoot":"","sources":["../../../src/core/base/create-child-observable.mts"],"names":[],"mappings":"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"}

package/dist/core/base/create-observable-base.d.mts

@@ -0,0 +1,82 @@
+import { Optional } from 'ts-data-forge';
+import { type ReadonlyRecord } from 'ts-type-forge';
+import { type ChildObservable, type ObservableBase, type ObservableId, type ObservableKind, type Subscription, type UpdateToken } from '../types/index.mjs';
+/**
+ * The mutable core shared by every observable, expressed as closures instead of
+ * a base class.
+ *
+ * The returned handle is the "protected" surface of the former
+ * `ObservableBaseClass`: the layer factories (`createRootObservable`,
+ * `createSyncChildObservable`, `createAsyncChildObservable`) build the public
+ * object from it via {@link assembleObservable}, and leaf factories receive
+ * only the narrow tools they need. Neither the handle nor its type is exported
+ * from the package (`core/base/**` is excluded from index generation), so
+ * `setNext` and friends stay internal, as `protected` kept them before.
+ */
+export type ObservableBaseHandle<A> = Readonly<{
+    id: ObservableId;
+    addChild: <B>(child: ChildObservable<B>) => void;
+    getSnapshot: () => Optional<A>;
+    isCompleted: () => boolean;
+    updateToken: () => UpdateToken;
+    hasSubscriber: () => boolean;
+    hasChild: () => boolean;
+    hasActiveChild: () => boolean;
+    subscribe: (onNext: (v: A) => void, onComplete?: () => void) => Subscription;
+    /** Stores `nextValue` as the current value and notifies subscribers. */
+    setNext: (nextValue: A, updateToken: UpdateToken) => void;
+    /**
+     * The innermost part of `complete()` (what `ObservableBaseClass.complete`
+     * used to do): marks this observable completed exactly once, notifies and
+     * removes all subscribers, and propagates `tryComplete` to children. Layer
+     * factories wrap this with leaf teardown and propagation to parents.
+     */
+    completeBase: () => void;
+}>;
+export declare const createObservableBaseHandle: <A>(initialValue: Optional<A>) => ObservableBaseHandle<A>;
+/**
+ * The extra members every manager observable — a root or an async child — owns:
+ * the depth-ordered descendant list and the update propagation that walks it.
+ */
+export type ManagerObservableParts<A> = Readonly<{
+    addDescendant: <B>(child: ChildObservable<B>) => void;
+    /** Emits `nextValue` and propagates the update to all descendants. */
+    startUpdate: (nextValue: A) => void;
+}>;
+/**
+ * Builds the manager half of a root or async-child observable. Both start their
+ * own update propagation, so both keep a descendant set and a depth-ordered
+ * propagation list; this is the single implementation of that pair (the class
+ * version duplicated it across `RootObservableClass` and
+ * `AsyncChildObservableClass`).
+ */
+export declare const createManagerObservableParts: <A>(handle: ObservableBaseHandle<A>) => ManagerObservableParts<A>;
+/** Default `tryUpdate` for observables that never receive parent updates. */
+export declare const createTryUpdateNotImplemented: () => ((_updateToken: UpdateToken) => void);
+type AssembleObservableArgs<A, Kind extends ObservableKind, Extra extends ReadonlyRecord<string, unknown>> = Readonly<{
+    kind: Kind;
+    depth: number;
+    handle: ObservableBaseHandle<A>;
+    tryUpdate: (updateToken: UpdateToken) => void;
+    tryComplete: () => void;
+    complete: () => void;
+    /**
+     * Kind-specific public members (`parents`, `addDescendant`) and leaf
+     * extensions (`next`, `start`). They are merged here, in the one place the
+     * final object literal is created, because the public getters below must not
+     * be copied by a spread (spreading would freeze their current values).
+     */
+    extra: Extra;
+}>;
+/**
+ * Builds the public observable object from a base handle. This replaces the
+ * implicit assembly a `class` performs: state stays in the handle's closures,
+ * `isCompleted` / `updateToken` / `hasSubscriber` / `hasChild` become getters
+ * delegating to the handle, and the kind-specific behavior (`tryUpdate`,
+ * `tryComplete`, `complete`) is passed in already composed.
+ */
+export declare const assembleObservable: <A, Kind extends ObservableKind, Extra extends ReadonlyRecord<string, unknown>>({ kind, depth, handle, tryUpdate, tryComplete, complete, extra, }: AssembleObservableArgs<A, Kind, Extra>) => Extra & ObservableBase<A> & Readonly<{
+    kind: Kind;
+}>;
+export {};
+//# sourceMappingURL=create-observable-base.d.mts.map

package/dist/core/base/create-observable-base.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-observable-base.d.mts","sourceRoot":"","sources":["../../../src/core/base/create-observable-base.mts"],"names":[],"mappings":"AAAA,OAAO,EAAO,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,eAAe,EAGpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,cAAc,EAInB,KAAK,YAAY,EACjB,KAAK,WAAW,EAEjB,MAAM,oBAAoB,CAAC;AAS5B;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,QAAQ,CAAC;IAC7C,EAAE,EAAE,YAAY,CAAC;IAEjB,QAAQ,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAEjD,WAAW,EAAE,MAAM,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE/B,WAAW,EAAE,MAAM,OAAO,CAAC;IAE3B,WAAW,EAAE,MAAM,WAAW,CAAC;IAE/B,aAAa,EAAE,MAAM,OAAO,CAAC;IAE7B,QAAQ,EAAE,MAAM,OAAO,CAAC;IAExB,cAAc,EAAE,MAAM,OAAO,CAAC;IAE9B,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,IAAI,KAAK,YAAY,CAAC;IAE7E,wEAAwE;IACxE,OAAO,EAAE,CAAC,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,WAAW,KAAK,IAAI,CAAC;IAE1D;;;;;OAKG;IACH,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B,CAAC,CAAC;AAEH,eAAO,MAAM,0BAA0B,GAAI,CAAC,gBAC5B,QAAQ,CAAC,CAAC,CAAC,KACxB,oBAAoB,CAAC,CAAC,CAwHxB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI,QAAQ,CAAC;IAC/C,aAAa,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAEtD,sEAAsE;IACtE,WAAW,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,IAAI,CAAC;CACrC,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,GAAI,CAAC,UACpC,oBAAoB,CAAC,CAAC,CAAC,KAC9B,sBAAsB,CAAC,CAAC,CAiC1B,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,6BAA6B,QAAO,CAAC,CAChD,YAAY,EAAE,WAAW,KACtB,IAAI,CAA4B,CAAC;AAMtC,KAAK,sBAAsB,CACzB,CAAC,EACD,IAAI,SAAS,cAAc,EAC3B,KAAK,SAAS,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,IAC3C,QAAQ,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAChC,SAAS,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,CAAC;IAC9C,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB;;;;;OAKG;IACH,KAAK,EAAE,KAAK,CAAC;CACd,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC7B,CAAC,EACD,IAAI,SAAS,cAAc,EAC3B,KAAK,SAAS,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,qEAS5C,sBAAsB,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAG,KAAK,GAC/C,cAAc,CAAC,CAAC,CAAC,GACjB,QAAQ,CAAC;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAyDxB,CAAC"}

package/dist/core/base/create-observable-base.mjs

@@ -0,0 +1,156 @@
+import { Arr, Optional } from 'ts-data-forge';
+import { binarySearch, issueObservableId, issueSubscriberId, issueUpdateToken, toSubscriber, } from '../utils/index.mjs';
+export const createObservableBaseHandle = (initialValue) => {
+    const id = issueObservableId();
+    let mut_children = [];
+    const mut_subscribers = new Map();
+    let mut_currentValue = initialValue;
+    let mut_isCompleted = false;
+    let mut_updateToken = issueUpdateToken();
+    const addSubscriber = (s) => {
+
+        const subscriberId = issueSubscriberId();
+        mut_subscribers.set(subscriberId, s);
+        return subscriberId;
+    };
+    const removeSubscriber = (subscriberId) => {
+        mut_subscribers.delete(subscriberId);
+    };
+    const addChild = (child) => {
+        mut_children = Arr.toPushed(mut_children, child);
+    };
+    const getSnapshot = () => mut_currentValue;
+    const isCompleted = () => mut_isCompleted;
+    const updateToken = () => mut_updateToken;
+    const hasSubscriber = () => mut_subscribers.size > 0;
+    const hasChild = () => Arr.isNonEmpty(mut_children);
+    const hasActiveChild = () => mut_children.some((c) => !c.isCompleted);
+    const setNext = (nextValue, nextUpdateToken) => {
+        mut_updateToken = nextUpdateToken;
+        mut_currentValue = Optional.some(nextValue);
+        for (const s of mut_subscribers.values()) {
+            s.onNext(nextValue);
+        }
+    };
+    const completeBase = () => {
+        if (mut_isCompleted)
+            return;
+
+        mut_isCompleted = true;
+
+        for (const s of mut_subscribers.values()) {
+            s.onComplete();
+        }
+
+        mut_subscribers.clear();
+
+        for (const o of mut_children) {
+            o.tryComplete();
+        }
+    };
+    const subscribe = (onNext, onComplete) => {
+
+        const curr = getSnapshot();
+        if (Optional.isSome(curr)) {
+            onNext(curr.value);
+        }
+        if (mut_isCompleted) {
+            if (onComplete !== undefined) {
+                onComplete();
+            }
+            return { unsubscribe: () => { } };
+        }
+        const subscriberId = addSubscriber(toSubscriber(onNext, onComplete));
+        return {
+            unsubscribe: () => {
+                removeSubscriber(subscriberId);
+            },
+        };
+    };
+    return {
+        id,
+        addChild,
+        getSnapshot,
+        isCompleted,
+        updateToken,
+        hasSubscriber,
+        hasChild,
+        hasActiveChild,
+        subscribe,
+        setNext,
+        completeBase,
+    };
+};
+
+
+
+
+
+
+
+export const createManagerObservableParts = (handle) => {
+    let mut_propagationOrder = [];
+    const mut_descendantsIdSet = new Set();
+    const addDescendant = (child) => {
+        if (mut_descendantsIdSet.has(child.id))
+            return;
+        mut_descendantsIdSet.add(child.id);
+        const insertPos = binarySearch(mut_propagationOrder.map((a) => a.depth), child.depth);
+        mut_propagationOrder = Arr.toInserted(mut_propagationOrder, insertPos, child);
+    };
+    const startUpdate = (nextValue) => {
+        const updateToken = issueUpdateToken();
+        handle.setNext(nextValue, updateToken);
+        for (const p of mut_propagationOrder) {
+            p.tryUpdate(updateToken);
+        }
+    };
+    return { addDescendant, startUpdate };
+};
+
+export const createTryUpdateNotImplemented = () => tryUpdateNotImplemented;
+const tryUpdateNotImplemented = (_updateToken) => {
+    throw new Error('not implemented');
+};
+
+
+
+
+
+
+
+export const assembleObservable = ({ kind, depth, handle, tryUpdate, tryComplete, complete, extra, }) => {
+    function pipe(operator) {
+        return operator(
+
+        observable);
+    }
+    const observable = {
+        ...extra,
+        id: handle.id,
+        kind,
+        depth,
+        addChild: handle.addChild,
+        getSnapshot: handle.getSnapshot,
+        get isCompleted() {
+            return handle.isCompleted();
+        },
+        get updateToken() {
+            return handle.updateToken();
+        },
+        get hasSubscriber() {
+            return handle.hasSubscriber();
+        },
+        get hasChild() {
+            return handle.hasChild();
+        },
+        hasActiveChild: handle.hasActiveChild,
+        tryUpdate,
+        tryComplete,
+        complete,
+        subscribe: handle.subscribe,
+        pipe,
+    };
+    return observable;
+};
+//# sourceMappingURL=create-observable-base.mjs.map

package/dist/core/base/create-observable-base.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-observable-base.mjs","sourceRoot":"","sources":["../../../src/core/base/create-observable-base.mts"],"names":[],"mappings":"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"}

package/dist/core/base/create-root-observable.d.mts

@@ -0,0 +1,37 @@
+import { Optional } from 'ts-data-forge';
+import { type ReadonlyRecord } from 'ts-type-forge';
+import { type RootObservable } from '../types/index.mjs';
+/**
+ * The internal tools a root leaf factory (`source`, `timer`, `fromPromise`, …)
+ * receives — the replacement for the `protected` methods a subclass of
+ * `RootObservableClass` used to inherit.
+ */
+export type RootObservableTools<A> = Readonly<{
+    /** Emits `nextValue` and propagates the update to all descendants. */
+    startUpdate: (nextValue: A) => void;
+    isCompleted: () => boolean;
+    /** Completes this observable (leaf teardown included). */
+    complete: () => void;
+}>;
+export type RootObservableConfig<A> = Readonly<{
+    initialValue: Optional<A>;
+    /**
+     * Leaf teardown (clear timers, abort requests, …), run at the beginning of
+     * `complete()` — the closure replacement for
+     * `override complete() { teardown(); super.complete(); }`.
+     */
+    onComplete?: () => void;
+}>;
+/**
+ * Creates a root observable — the classless replacement for extending
+ * `RootObservableClass`.
+ *
+ * The optional `init` callback receives the internal tools and returns extra
+ * public members to merge into the observable (e.g. `next` for `source`,
+ * `start` for `timer`). `init` runs during construction; it may register
+ * asynchronous callbacks that use the tools, and may call `complete`
+ * synchronously, but the observable object itself does not exist yet at that
+ * point.
+ */
+export declare const createRootObservable: <A, Extension extends ReadonlyRecord<string, unknown> = ReadonlyRecord<never, never>>({ initialValue, onComplete }: RootObservableConfig<A>, init: (tools: RootObservableTools<A>) => Extension) => Extension & RootObservable<A>;
+//# sourceMappingURL=create-root-observable.d.mts.map

package/dist/core/base/create-root-observable.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-root-observable.d.mts","sourceRoot":"","sources":["../../../src/core/base/create-root-observable.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAQ3E;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,QAAQ,CAAC;IAC5C,sEAAsE;IACtE,WAAW,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,IAAI,CAAC;IAEpC,WAAW,EAAE,MAAM,OAAO,CAAC;IAE3B,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,QAAQ,CAAC;IAC7C,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE1B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAC/B,CAAC,EACD,SAAS,SAAS,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAChE,KAAK,EACL,KAAK,CACN,gCAE6B,oBAAoB,CAAC,CAAC,CAAC,QAC/C,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,SAAS,KACjD,SAAS,GAAG,cAAc,CAAC,CAAC,CAmC9B,CAAC"}

package/dist/core/base/create-root-observable.mjs

@@ -0,0 +1,50 @@
+
+
+import { assembleObservable, createManagerObservableParts, createObservableBaseHandle, createTryUpdateNotImplemented, } from './create-observable-base.mjs';
+
+
+
+
+
+
+
+
+
+
+
+export const createRootObservable = ({ initialValue, onComplete }, init) => {
+    const handle = createObservableBaseHandle(initialValue);
+    const { addDescendant, startUpdate } = createManagerObservableParts(handle);
+    const complete = () => {
+        onComplete?.();
+        handle.completeBase();
+    };
+    const tryComplete = () => {
+        if (!handle.hasSubscriber() && !handle.hasActiveChild()) {
+            complete();
+        }
+    };
+    const extension = init({
+        startUpdate,
+        isCompleted: handle.isCompleted,
+        complete,
+    });
+    return assembleObservable({
+        kind: 'root',
+        depth: 0,
+        handle,
+        tryUpdate: createTryUpdateNotImplemented,
+        tryComplete,
+        complete,
+        extra: {
+            ...extension,
+            addDescendant,
+        },
+    });
+};
+
+
+
+
+
+//# sourceMappingURL=create-root-observable.mjs.map

package/dist/core/base/create-root-observable.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-root-observable.mjs","sourceRoot":"","sources":["../../../src/core/base/create-root-observable.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAuB,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EACL,kBAAkB,EAClB,4BAA4B,EAC5B,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,8BAA8B,CAAC;AA4BtC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAOlC,EAAE,YAAY,EAAE,UAAU,EAA2B,EACrD,IAAkD,EACnB,EAAE;IACjC,MAAM,MAAM,GAAG,0BAA0B,CAAI,YAAY,CAAC,CAAC;IAE3D,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,4BAA4B,CAAC,MAAM,CAAC,CAAC;IAE5E,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,UAAU,EAAE,EAAE,CAAC;QAEf,MAAM,CAAC,YAAY,EAAE,CAAC;IACxB,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,GAAS,EAAE;QAC7B,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC;YACxD,QAAQ,EAAE,CAAC;QACb,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,SAAS,GAAc,IAAI,CAAC;QAChC,WAAW;QACX,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,QAAQ;KACT,CAAC,CAAC;IAEH,OAAO,kBAAkB,CAAC;QACxB,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,CAAC;QACR,MAAM;QACN,SAAS,EAAE,6BAA6B;QACxC,WAAW;QACX,QAAQ;QACR,KAAK,EAAE;YACL,GAAG,SAAS;YACZ,aAAa;SACd;KACF,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;IACrC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,MAAM,CACX,gBAAgB,CACd,oBAAoB,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CACrE,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/core/base/index.d.mts

@@ -0,0 +1,3 @@
+export * from './create-child-observable.mjs';
+export * from './create-root-observable.mjs';
+//# sourceMappingURL=index.d.mts.map

package/dist/core/base/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/core/base/index.mts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC"}

package/dist/core/base/index.mjs

@@ -0,0 +1,3 @@
+export * from './create-child-observable.mjs';
+export * from './create-root-observable.mjs';
+//# sourceMappingURL=index.mjs.map

package/dist/core/base/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/core/base/index.mts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC"}

package/dist/core/combine/combine.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"combine.d.mts","sourceRoot":"","sources":["../../../src/core/combine/combine.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAc,MAAM,eAAe,CAAC;AAI/D,OAAO,EAEL,KAAK,wBAAwB,EAI7B,KAAK,UAAU,EAIhB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,eAAO,MAAM,OAAO,GAAI,KAAK,CAAC,EAAE,SAAS,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,WAChE,EAAE,KACV,wBAAwB,CAAC,EAAE,CAIgB,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,aAAa,gBAAU,CAAC"}
+{"version":3,"file":"combine.d.mts","sourceRoot":"","sources":["../../../src/core/combine/combine.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAc,MAAM,eAAe,CAAC;AAI/D,OAAO,EAEL,KAAK,wBAAwB,EAI7B,KAAK,UAAU,EAGhB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,eAAO,MAAM,OAAO,GAAI,KAAK,CAAC,EAAE,SAAS,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,WAChE,EAAE,KACV,wBAAwB,CAAC,EAAE,CAE+C,CAAC;AAE9E;;;GAGG;AACH,eAAO,MAAM,aAAa,gBAAU,CAAC"}