synstate 3.4.0 → 4.1.0

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

@@ -0,0 +1,183 @@
+
+
+
+
+import { Arr } from 'ts-data-forge';
+import { unreachable } from 'ts-std-forge';
+import { AsyncChildObservableClass, SyncChildObservableClass, } from './child-observable-class.mjs';
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export const createSyncChildObservable = (config, init) => new CustomSyncChildObservableClass(config, init);
+
+
+
+
+
+
+export const createInitializedSyncChildObservable = (config, init) => 
+
+
+
+new CustomSyncChildObservableClass(config, init);
+
+
+
+
+
+
+
+
+export const createAsyncChildObservable = (config, init) => new CustomAsyncChildObservableClass(config, init);
+
+
+
+
+export const createTryUpdateNotImplemented = () => tryUpdateNotImplemented;
+const tryUpdateNotImplemented = () => {
+    unreachable();
+};
+
+class CustomSyncChildObservableClass extends SyncChildObservableClass {
+    #mut_teardowns;
+    #hooks;
+    constructor(config, init) {
+        super(config);
+        this.#mut_teardowns = undefined;
+        this.#hooks = toHooks(init({
+            setNext: (nextValue, updateToken) => {
+                this.setNext(nextValue, updateToken);
+            },
+            getSnapshot: () => this.getSnapshot(),
+            complete: () => {
+                this.complete();
+            },
+            completeAfterPropagation: () => {
+                this.completeAfterPropagation();
+            },
+            onComplete: (teardown) => {
+                if (this.isCompleted) {
+                    teardown();
+                }
+                else {
+                    this.#mut_teardowns = Arr.toPushed(this.#mut_teardowns ?? [], teardown);
+                }
+            },
+        }));
+        this.attach();
+    }
+    tryUpdate(updateToken) {
+        this.#hooks.tryUpdate(updateToken);
+    }
+    canEmitNoMore() {
+        return this.#hooks.canEmitNoMore?.() === true;
+    }
+    teardown() {
+        for (const teardown of this.#mut_teardowns ?? []) {
+            teardown();
+        }
+    }
+}
+class CustomAsyncChildObservableClass extends AsyncChildObservableClass {
+    #mut_teardowns;
+    #hooks;
+    constructor(config, init) {
+        super(config);
+        this.#mut_teardowns = undefined;
+        this.#hooks = toHooks(init({
+            setNext: (nextValue, updateToken) => {
+                this.setNext(nextValue, updateToken);
+            },
+            startUpdate: (nextValue) => {
+                this.startUpdate(nextValue);
+            },
+            getSnapshot: () => this.getSnapshot(),
+            complete: () => {
+                this.complete();
+            },
+            completeAfterPropagation: () => {
+                this.completeAfterPropagation();
+            },
+            onComplete: (teardown) => {
+                if (this.isCompleted) {
+                    teardown();
+                }
+                else {
+                    this.#mut_teardowns = Arr.toPushed(this.#mut_teardowns ?? [], teardown);
+                }
+            },
+        }));
+        this.attach();
+    }
+    tryUpdate(updateToken) {
+        this.#hooks.tryUpdate(updateToken);
+    }
+    canEmitNoMore() {
+        return this.#hooks.canEmitNoMore?.() === true;
+    }
+    flush() {
+        this.#hooks.flush?.();
+    }
+    teardown() {
+        for (const teardown of this.#mut_teardowns ?? []) {
+            teardown();
+        }
+    }
+}
+
+const toHooks = (returned) => typeof returned === 'function'
+    ? { tryUpdate: returned }
+    : returned;
+//# sourceMappingURL=create-child-observable.mjs.map

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

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

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

@@ -0,0 +1,37 @@
+import { type Optional } from 'ts-data-forge';
+import type { ReadonlyRecord } from 'ts-type-forge';
+import type { RootObservable } from '../types/index.mjs';
+/**
+ * The tools a custom root's `init` receives: the `protected` methods a
+ * subclass of `RootObservableClass` inherits.
+ */
+export type RootObservableTools<A> = Readonly<{
+    /** Emits `nextValue` and propagates the update to all descendants. */
+    startUpdate: (nextValue: A) => void;
+    getSnapshot: () => Optional<A>;
+    isCompleted: () => boolean;
+    /** Completes this observable (leaf teardown included). */
+    complete: () => void;
+    /**
+     * Registers a teardown (clear timers, abort requests, remove listeners, …)
+     * to run at the beginning of `complete()`, in the order registered. Called
+     * from `init`, it lets the teardown close over what `init` creates.
+     * Registered once the observable has completed — `init` may complete it
+     * synchronously first — the teardown runs at once.
+     */
+    onComplete: (teardown: () => void) => void;
+}>;
+export type RootObservableConfig<A> = Readonly<{
+    initialValue: Optional<A>;
+}>;
+/**
+ * Creates a root observable, for a custom creator written without a class
+ * of its own.
+ *
+ * `init` runs during construction, receives the tools, and returns extra
+ * public members to merge into the observable (e.g. `next` for a source,
+ * `start` for a timer). It may register asynchronous callbacks that use the
+ * tools, and may call `complete` synchronously.
+ */
+export declare const createRootObservable: <A, Extension extends ReadonlyRecord<string, unknown> = ReadonlyRecord<never, never>>({ initialValue }: RootObservableConfig<A>, init: (tools: RootObservableTools<A>) => Extension) => Extension & RootObservable<A>;
+//# sourceMappingURL=create-root-observable.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-root-observable.d.mts","sourceRoot":"","sources":["../../../src/core/class/create-root-observable.mts"],"names":[],"mappings":"AAIA,OAAO,EAAO,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD;;;GAGG;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,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE/B,WAAW,EAAE,MAAM,OAAO,CAAC;IAE3B,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,IAAI,CAAC;IAErB;;;;;;OAMG;IACH,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CAC5C,CAAC,CAAC;AAEH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,QAAQ,CAAC;IAC7C,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;CAC3B,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAC/B,CAAC,EAGD,SAAS,SAAS,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAChE,KAAK,EACL,KAAK,CACN,oBAEiB,oBAAoB,CAAC,CAAC,CAAC,QACnC,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,SAAS,KACjD,SAAS,GAAG,cAAc,CAAC,CAAC,CAIV,CAAC"}

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

@@ -0,0 +1,52 @@
+
+
+
+
+import { Arr } from 'ts-data-forge';
+import { RootObservableClass } from './root-observable-class.mjs';
+
+
+
+
+
+
+
+
+
+export const createRootObservable = ({ initialValue }, init) => 
+
+
+new CustomRootObservableClass(initialValue, init);
+
+class CustomRootObservableClass extends RootObservableClass {
+    #mut_teardowns;
+    constructor(initialValue, init) {
+        super({ initialValue });
+        this.#mut_teardowns = undefined;
+        const extension = init({
+            startUpdate: (nextValue) => {
+                this.startUpdate(nextValue);
+            },
+            getSnapshot: () => this.getSnapshot(),
+            isCompleted: () => this.isCompleted,
+            complete: () => {
+                this.complete();
+            },
+            onComplete: (teardown) => {
+                if (this.isCompleted) {
+                    teardown();
+                }
+                else {
+                    this.#mut_teardowns = Arr.toPushed(this.#mut_teardowns ?? [], teardown);
+                }
+            },
+        });
+        Object.assign(this, extension);
+    }
+    teardown() {
+        for (const teardown of this.#mut_teardowns ?? []) {
+            teardown();
+        }
+    }
+}
+//# sourceMappingURL=create-root-observable.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-root-observable.mjs","sourceRoot":"","sources":["../../../src/core/class/create-root-observable.mts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,gDAAgD;AAChD,0DAA0D;AAC1D,kEAAkE;AAClE,OAAO,EAAE,GAAG,EAAiB,MAAM,eAAe,CAAC;AAGnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AA+BlE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CASlC,EAAE,YAAY,EAA2B,EACzC,IAAkD,EACnB,EAAE;AACjC,8DAA8D;AAC9D,4DAA4D;AAC5D,IAAI,yBAAyB,CAAC,YAAY,EAAE,IAAI,CAC7B,CAAC;AAEtB,oBAAoB;AAEpB,MAAM,yBAA6B,SAAQ,mBAAsB;IAC/D,cAAc,CAAsC;IAEpD,YACE,YAAyB,EACzB,IAAwE;QAExE,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;QAExB,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAEhC,MAAM,SAAS,GAAG,IAAI,CAAC;YACrB,WAAW,EAAE,CAAC,SAAS,EAAE,EAAE;gBACzB,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;YAC9B,CAAC;YACD,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE;YACrC,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW;YACnC,QAAQ,EAAE,GAAG,EAAE;gBACb,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,CAAC;YACD,UAAU,EAAE,CAAC,QAAQ,EAAE,EAAE;gBACvB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;oBACrB,QAAQ,EAAE,CAAC;gBACb,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC,QAAQ,CAChC,IAAI,CAAC,cAAc,IAAI,EAAE,EACzB,QAAQ,CACT,CAAC;gBACJ,CAAC;YACH,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACjC,CAAC;IAEkB,QAAQ;QACzB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,cAAc,IAAI,EAAE,EAAE,CAAC;YACjD,QAAQ,EAAE,CAAC;QACb,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,9 @@
+export * from './child-observable-class.mjs';
+export * from './create-child-observable.mjs';
+export * from './create-root-observable.mjs';
+export * from './manager-observable-class.mjs';
+export * from './observable-base-class.mjs';
+export * from './observable-node.mjs';
+export * from './propagation-state.mjs';
+export * from './root-observable-class.mjs';
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/core/class/index.mts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC"}

package/dist/core/class/index.mjs

@@ -0,0 +1,9 @@
+export * from './child-observable-class.mjs';
+export * from './create-child-observable.mjs';
+export * from './create-root-observable.mjs';
+export * from './manager-observable-class.mjs';
+export * from './observable-base-class.mjs';
+export * from './observable-node.mjs';
+export * from './propagation-state.mjs';
+export * from './root-observable-class.mjs';
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/core/class/index.mts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC"}

package/dist/core/class/manager-observable-class.d.mts

@@ -0,0 +1,26 @@
+import type { Optional } from 'ts-data-forge';
+import type { ManagerObservableKind } from '../types/index.mjs';
+import { ObservableBaseClass } from './observable-base-class.mjs';
+import type { ChildNode, ManagerNode } from './observable-node.mjs';
+/**
+ * The base of the observables that start updates of their own: a root, and
+ * an async child (`debounce`, `switchMap`), which emits later than its
+ * parents do. Every descendant registers to the managers it is reached from,
+ * and an update reaches them in ascending depth, so that each sees its
+ * parents' values of that update (no glitch).
+ */
+export declare class ManagerObservableClass<A, Kind extends ManagerObservableKind, Depth extends number> extends ObservableBaseClass<A, Kind, Depth> {
+    #private;
+    /** The managers this node's descendants register to: itself. */
+    readonly managers: readonly ManagerNode[];
+    constructor(config: Readonly<{
+        kind: Kind;
+        depth: Depth;
+        initialValue: Optional<A>;
+    }>);
+    addDescendant(child: ChildNode): void;
+    deleteDescendant(child: ChildNode): void;
+    /** Emits `nextValue` and propagates it to the descendants. */
+    protected startUpdate(nextValue: A): void;
+}
+//# sourceMappingURL=manager-observable-class.d.mts.map

package/dist/core/class/manager-observable-class.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager-observable-class.d.mts","sourceRoot":"","sources":["../../../src/core/class/manager-observable-class.mts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,KAAK,EAAE,qBAAqB,EAAe,MAAM,oBAAoB,CAAC;AAE7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpE;;;;;;GAMG;AACH,qBAAa,sBAAsB,CACjC,CAAC,EACD,IAAI,SAAS,qBAAqB,EAClC,KAAK,SAAS,MAAM,CACpB,SAAQ,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC;;IA4B3C,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAE1C,YACE,MAAM,EAAE,QAAQ,CAAC;QACf,IAAI,EAAE,IAAI,CAAC;QACX,KAAK,EAAE,KAAK,CAAC;QACb,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;KAC3B,CAAC,EAWH;IAmBD,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAyBpC;IAED,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAGvC;IAED,8DAA8D;IAC9D,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,GAAG,IAAI,CA0CxC;CACF"}

package/dist/core/class/manager-observable-class.mjs

@@ -0,0 +1,116 @@
+import { issueUpdateToken } from '../utils/index.mjs';
+import { ObservableBaseClass } from './observable-base-class.mjs';
+import { beginPropagation, endPropagation } from './propagation-state.mjs';
+
+
+
+
+
+
+
+export class ManagerObservableClass extends ObservableBaseClass {
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+    #mut_propagationOrder;
+
+    #mut_isPropagating;
+
+
+
+
+
+
+    #mut_joinedDuringUpdate;
+
+    managers;
+    constructor(config) {
+        super(config);
+        this.managers = [this];
+        this.#mut_propagationOrder = [];
+        this.#mut_isPropagating = false;
+        this.#mut_joinedDuringUpdate = undefined;
+    }
+
+
+
+
+    #propagate(updateToken) {
+        for (const bucket of this.#mut_propagationOrder) {
+            if (bucket !== undefined) {
+                for (const c of bucket) {
+
+                    if (this.#mut_joinedDuringUpdate?.has(c) !== true) {
+                        c.tryUpdate(updateToken);
+                    }
+                }
+            }
+        }
+    }
+    addDescendant(child) {
+        const descendants = this.#mut_propagationOrder;
+        const index = child.depth - this.depth - 1;
+        const mut_bucket = descendants[index];
+        if (mut_bucket === undefined) {
+
+
+            this.#mut_propagationOrder = Array.from({ length: Math.max(descendants.length, index + 1) }, (_, i) => (i === index ? new Set([child]) : descendants[i]));
+        }
+        else {
+            mut_bucket.add(child);
+        }
+        if (!this.#mut_isPropagating) {
+            return;
+        }
+        this.#mut_joinedDuringUpdate ??= new Set();
+        this.#mut_joinedDuringUpdate.add(child);
+    }
+    deleteDescendant(child) {
+
+        this.#mut_propagationOrder[child.depth - this.depth - 1]?.delete(child);
+    }
+
+    startUpdate(nextValue) {
+        const updateToken = issueUpdateToken();
+
+
+        const wasPropagating = this.#mut_isPropagating;
+        const joinedBefore = this.#mut_joinedDuringUpdate;
+        this.#mut_isPropagating = true;
+        this.#mut_joinedDuringUpdate = undefined;
+        beginPropagation(updateToken);
+
+
+
+
+        try {
+            this.setNext(nextValue, updateToken);
+            this.#propagate(updateToken);
+        }
+        finally {
+
+            const joinedNow = this.#mut_joinedDuringUpdate;
+            this.#mut_isPropagating = wasPropagating;
+            this.#mut_joinedDuringUpdate = joinedBefore;
+            if (wasPropagating && joinedNow !== undefined) {
+                this.#mut_joinedDuringUpdate ??= new Set();
+                for (const c of joinedNow) {
+                    this.#mut_joinedDuringUpdate.add(c);
+                }
+            }
+            endPropagation();
+        }
+    }
+}
+//# sourceMappingURL=manager-observable-class.mjs.map

package/dist/core/class/manager-observable-class.mjs.map

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

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

@@ -0,0 +1,97 @@
+import { Optional } from 'ts-data-forge';
+import type { DropInitialValueOperator, InitializedObservable, KeepInitialValueOperator, Observable, ObservableBase, ObservableKind, Subscription, UpdateToken, WithInitialValueOperator } from '../types/index.mjs';
+import { observableBrand } from '../utils/index.mjs';
+import type { ChildNode } from './observable-node.mjs';
+/**
+ * The base of every observable, and the reason an observable is a class.
+ *
+ * A node is created for every derived value of a UI, so creating one has to
+ * be cheap, and most of its cost was its methods: each observable used to be
+ * a set of closures made for it, a dozen or more per node (#2421). Sharing
+ * the methods among all nodes removes that cost, and a shared method has to
+ * read the node it is called on from `this`. Once `this` is unavoidable, a
+ * class is the plainest way to say it: the methods live once on the
+ * prototype, `this` is typed, a creator or operator is a subclass that
+ * overrides `tryUpdate` (and `flush` / `teardown` where it holds something),
+ * and assigning every field in the constructor gives the nodes of one class
+ * one shape for V8. The collections (`children`, subscribers) are made when
+ * the first one arrives.
+ *
+ * The methods read the observable they are called on, so taking one off it
+ * (`const { subscribe } = obs$`) is not supported.
+ *
+ * A node reaches another node only through its methods and its public
+ * fields, never through a `#private` one: the other node may be an instance
+ * of another copy of synstate in the same program, whose classes are not
+ * these.
+ */
+export declare class ObservableBaseClass<A, Kind extends ObservableKind, Depth extends number> implements ObservableBase<A> {
+    #private;
+    readonly kind: Kind;
+    readonly depth: Depth;
+    readonly [observableBrand]: true;
+    constructor({ kind, depth, initialValue, }: Readonly<{
+        kind: Kind;
+        depth: Depth;
+        initialValue: Optional<A>;
+    }>);
+    getSnapshot(): Optional<A>;
+    get isCompleted(): boolean;
+    get updateToken(): UpdateToken;
+    get hasSubscriber(): boolean;
+    get hasChild(): boolean;
+    hasActiveChild(): boolean;
+    addChild(child: ChildNode): void;
+    deleteChild(child: ChildNode): void;
+    /** Stores `nextValue` as the current value and notifies subscribers. */
+    protected setNext(nextValue: A, updateToken: UpdateToken): void;
+    /**
+     * Called with the token of every update that reaches this observable; a
+     * parent that did not emit in that update has a different `updateToken`.
+     * Every observable that can receive a parent update overrides it, and an
+     * observable with no parents never gets one, so reaching this is the
+     * invariant breaking (Sumi D-48).
+     */
+    tryUpdate(_updateToken: UpdateToken): void;
+    /**
+     * Called by a parent that has completed. A root has no parents, and a child
+     * completing never completes it (#2133), so only its own `complete()` ends
+     * it.
+     */
+    tryComplete(): void;
+    /**
+     * Completes the observable: an async child first passes on what it still
+     * holds (`flush`), then it is disposed. Completing never reaches the
+     * parents: an upstream observable may be shared, and only whoever owns it
+     * decides when it ends (#2133).
+     */
+    complete(): void;
+    /**
+     * Completes the observable without passing on anything it still holds,
+     * runs its teardown, and takes it out of the graph.
+     */
+    dispose(): void;
+    /**
+     * Passes on what the observable still holds, at the beginning of
+     * `complete()` and never in `dispose()` (`debounce`'s pending value).
+     */
+    protected flush(): void;
+    /**
+     * Releases what the observable holds (timers, subscriptions, inner
+     * observables), once, when it completes or is disposed, before its
+     * subscribers hear of it.
+     */
+    protected teardown(): void;
+    /** Takes a completed child out of its parents' and managers' lists. */
+    protected detach(): void;
+    /**
+     * Joins the scope whose `run` is executing (`createScope`), if any. A node
+     * that completed while it was built (`just`, a child of completed parents)
+     * has nothing left to release.
+     */
+    protected adoptIntoCurrentScope(): void;
+    pipe<B>(operator: WithInitialValueOperator<A, B>): InitializedObservable<B>;
+    pipe<B>(operator: DropInitialValueOperator<A, B> | KeepInitialValueOperator<A, B>): Observable<B>;
+    subscribe(onNext: (v: A) => void, onComplete?: () => void): Subscription;
+}
+//# sourceMappingURL=observable-base-class.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observable-base-class.d.mts","sourceRoot":"","sources":["../../../src/core/class/observable-base-class.mts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACrB,wBAAwB,EACxB,UAAU,EACV,cAAc,EACd,cAAc,EAGd,YAAY,EACZ,WAAW,EACX,wBAAwB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,eAAe,EAGhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,mBAAmB,CAC9B,CAAC,EACD,IAAI,SAAS,cAAc,EAC3B,KAAK,SAAS,MAAM,CACpB,YAAW,cAAc,CAAC,CAAC,CAAC;;IAO5B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,SAAiB,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC;IAEzC,YAAY,EACV,IAAI,EACJ,KAAK,EACL,YAAY,GACb,EAAE,QAAQ,CAAC;QACV,IAAI,EAAE,IAAI,CAAC;QACX,KAAK,EAAE,KAAK,CAAC;QACb,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;KAC3B,CAAC,EAkBD;IAED,WAAW,IAAI,QAAQ,CAAC,CAAC,CAAC,CAEzB;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,WAAW,IAAI,WAAW,CAE7B;IAED,IAAI,aAAa,IAAI,OAAO,CAI3B;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,cAAc,IAAI,OAAO,CAUxB;IAED,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAQ/B;IAED,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAElC;IAED,wEAAwE;IACxE,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAU9D;IAED;;;;;;OAMG;IAEH,SAAS,CAAC,YAAY,EAAE,WAAW,GAAG,IAAI,CAEzC;IAED;;;;OAIG;IAEH,WAAW,IAAI,IAAI,CAAG;IAEtB;;;;;OAKG;IACH,QAAQ,IAAI,IAAI,CAQf;IAED;;;OAGG;IACH,OAAO,IAAI,IAAI,CAkCd;IAED;;;OAGG;IAEH,SAAS,CAAC,KAAK,IAAI,IAAI,CAAG;IAE1B;;;;OAIG;IAEH,SAAS,CAAC,QAAQ,IAAI,IAAI,CAAG;IAE7B,uEAAuE;IAEvE,SAAS,CAAC,MAAM,IAAI,IAAI,CAAG;IAE3B;;;;OAIG;IACH,SAAS,CAAC,qBAAqB,IAAI,IAAI,CAUtC;IAKD,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAE5E,IAAI,CAAC,CAAC,EACJ,QAAQ,EAAE,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,GACxE,UAAU,CAAC,CAAC,CAAC,CAAC;IAUjB,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,IAAI,GAAG,YAAY,CAuBvE;CACF"}