synstate 3.3.0 → 4.0.0

package/src/utils/create-state.test.mts

@@ -1,20 +1,8 @@
 import { createState } from './create-state.mjs';
 
 describe(createState, () => {
-  test('passes on every update when no `equals` is given, equal or not', () => {
-    const [state, setState] = createState(0);
-
-    const seen = record(state);
-
-    setState(0);
-
-    assert.deepStrictEqual(seen, [0, 0]);
-  });
-
-  test('with `equals`, setState, updateState and resetState do not pass on a value equal to the current one', () => {
-    const [state, setState, { updateState, resetState }] = createState(0, {
-      equals: Object.is,
-    });
+  test('setState, updateState and resetState do not pass on a value `Object.is`-equal to the current one when no `equals` is given', () => {
+    const [state, setState, { updateState, resetState }] = createState(0);
 
     const seen = record(state);
 
@@ -34,6 +22,36 @@ describe(createState, () => {
     assert.deepStrictEqual(seen, [0, 1]);
   });
 
+  test('once the state is completed, setState, updateState and resetState return the current value', () => {
+    const [state, setState, { updateState, resetState, getSnapshot }] =
+      createState(0);
+
+    setState(1);
+
+    state.complete();
+
+    assert.strictEqual(setState(2), 1);
+
+    assert.strictEqual(
+      updateState((current) => current + 1),
+      1,
+    );
+
+    assert.strictEqual(resetState(), 1);
+
+    assert.strictEqual(getSnapshot(), 1);
+  });
+
+  test('passes on every update, equal or not, with `equals: () => false`', () => {
+    const [state, setState] = createState(0, { equals: () => false });
+
+    const seen = record(state);
+
+    setState(0);
+
+    assert.deepStrictEqual(seen, [0, 0]);
+  });
+
   // What `equals` is for: whatever reads the state, directly or through
   // anything derived from it, is told only of a real change, and an equal
   // value written over the current one leaves the object that is there.

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

@@ -1,65 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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;AAG9D,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,CA4E1B,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,CAgF3B,CAAC"}

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

@@ -1,267 +0,0 @@
-import { Arr } from 'ts-data-forge';
-import { panic } from 'ts-std-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);
-
-    let mut_self = undefined;
-    const autoComplete = onComplete !== undefined || parents.some((p) => p.autoComplete);
-    const dispose = () => {
-
-
-
-        if (handle.isCompleted()) {
-            return;
-        }
-        onComplete?.();
-        handle.completeBase();
-        if (mut_self !== undefined) {
-            unregisterChild(mut_self, parents);
-        }
-    };
-    const complete = () => {
-        if (handle.isCompleted()) {
-            return;
-        }
-        dispose();
-
-        for (const par of parents) {
-            par.tryComplete();
-        }
-    };
-    const tryComplete = () => {
-        if (handle.isCompleted()) {
-            return;
-        }
-        tryCompleteChild({
-            hasSubscriber: handle.hasSubscriber(),
-            hasActiveChild: handle.hasActiveChild(),
-            autoComplete,
-            parents,
-            complete,
-        });
-    };
-    const tryUpdate = createTryUpdate({
-        setNext: handle.setNext,
-        getSnapshot: handle.getSnapshot,
-        complete,
-    });
-    const observable = assembleObservable({
-        kind: 'sync child',
-        depth,
-        handle,
-        tryUpdate,
-        tryComplete,
-        complete,
-        dispose,
-        autoComplete,
-        extra: { parents },
-    });
-    registerChild(observable, parents);
-    mut_self = observable;
-    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, deleteDescendant, startUpdate } = createManagerObservableParts(handle);
-
-    let mut_self = undefined;
-    const autoComplete = onComplete !== undefined || parents.some((p) => p.autoComplete);
-    const dispose = () => {
-
-
-
-        if (handle.isCompleted()) {
-            return;
-        }
-        onComplete?.();
-        handle.completeBase();
-        if (mut_self !== undefined) {
-            unregisterChild(mut_self, parents);
-        }
-    };
-    const complete = () => {
-        if (handle.isCompleted()) {
-            return;
-        }
-        dispose();
-
-        for (const par of parents) {
-            par.tryComplete();
-        }
-    };
-    const tryComplete = () => {
-        if (handle.isCompleted()) {
-            return;
-        }
-        tryCompleteChild({
-            hasSubscriber: handle.hasSubscriber(),
-            hasActiveChild: handle.hasActiveChild(),
-            autoComplete,
-            parents,
-            complete,
-        });
-    };
-    const tryUpdate = createTryUpdate({
-        setNext: handle.setNext,
-        getSnapshot: handle.getSnapshot,
-        complete,
-        startUpdate,
-    });
-    const observable = assembleObservable({
-        kind: 'async child',
-        depth,
-        handle,
-        tryUpdate,
-        tryComplete,
-        complete,
-        dispose,
-        autoComplete,
-        extra: { parents, addDescendant, deleteDescendant },
-    });
-    registerChild(observable, parents);
-    mut_self = observable;
-    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)) {
-
-
-
-
-            panic('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 unregisterChild = (child, parents) => {
-    for (const p of parents) {
-        p.deleteChild(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.deleteDescendant(child);
-        }
-        else {
-            mut_rest.push(...p.parents);
-        }
-    }
-};
-const tryCompleteChild = ({ hasSubscriber, hasActiveChild, autoComplete, parents, complete, }) => {
-
-    if (parents.every((r) => r.isCompleted)) {
-        complete();
-        return;
-    }
-
-    if (autoComplete && !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

@@ -1 +0,0 @@
-{"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

@@ -1,147 +0,0 @@
-import { Optional } from 'ts-data-forge';
-import type { ReadonlyRecord } from 'ts-type-forge';
-import type { ChildObservable, ObservableBase, ObservableId, ObservableKind, Subscription, 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;
-    /**
-     * Registers the public object {@link assembleObservable} built from this
-     * handle, so that its four state flags (`isCompleted`, `updateToken`,
-     * `hasSubscriber`, `hasChild`) can be mirrored onto it as plain data
-     * properties.
-     *
-     * They used to be getters delegating to this handle's closures, and that
-     * costs more than it looks. Reading one was an accessor call plus a closure
-     * call where a field read would do — `updateToken` is read once per child
-     * per update, so the propagation path paid it on every step — and an object
-     * literal carrying accessors is far more expensive to create than one
-     * carrying data, which is most of what building a graph costs. Measured on
-     * one machine with `pnpm run benchmark`: the derived chain's 100,000 updates
-     * 16.7 ms -> 13.6 ms, and the cascaded diamond at N=20, whose measurement is
-     * dominated by graph construction, 587 ms -> 362 ms.
-     *
-     * Every write below therefore has to keep the mirror in step; that is the
-     * price of not reading through a closure on the hot path. It is paid in
-     * clarity too, and on purpose: `hasSubscriber` and `hasChild` are derived
-     * from `mut_subscribers` and `mut_children`, which a getter stated once and
-     * declaratively, whereas the mirror restates it at every write.
-     *
-     * Nor can the rarely read flags alone go back to getters while `updateToken`
-     * stays data. A single accessor in the literal is enough to lose nearly all
-     * of the gain: measured on Node 26 with the `...extra` spread followed by
-     * these properties, one getter among data properties made the literal about
-     * 10x slower to create than all data (four getters: about 15x) and gave
-     * every instance its own hidden class (`%HaveSameMap` false). Keep all four
-     * as data, or measure again before changing that.
-     */
-    attach: (writers: ObservableStateWriters) => void;
-    addChild: <B>(child: ChildObservable<B>) => void;
-    /**
-     * Forgets `child`, which a completed child calls on each of its parents so
-     * that nothing keeps a reference to it (#2134).
-     */
-    deleteChild: <B>(child: ChildObservable<B>) => void;
-    getSnapshot: () => Optional<A>;
-    isCompleted: () => boolean;
-    updateToken: () => UpdateToken;
-    hasSubscriber: () => 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;
-}>;
-/**
- * How the handle writes the four state flags onto the public object. The
- * writers are closures over that object rather than the object itself, because
- * a parameter this side could mutate has to be a mutable type, which
- * `@typescript-eslint/prefer-readonly-parameter-types` rejects — and the object
- * is `Readonly` to everyone else.
- */
-type ObservableStateWriters = Readonly<{
-    setIsCompleted: (value: boolean) => void;
-    setUpdateToken: (value: UpdateToken) => void;
-    setHasSubscriber: (value: boolean) => void;
-    setHasChild: (value: boolean) => 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;
-    /**
-     * Takes `child` out of the propagation order, which a completed child calls
-     * on every manager it registered to (#2134).
-     */
-    deleteDescendant: <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 depth-ordered propagation list; this
- * is the single implementation of it (the class version duplicated it across
- * `RootObservableClass` and `AsyncChildObservableClass`).
- *
- * The descendants are kept in one insertion-ordered set per depth, so adding
- * and removing one is O(1) apart from the first node of a new depth. The flat
- * array `startUpdate` walks is rebuilt only when an update finds it stale: it
- * used to be copied on every `addDescendant`, which made creating n nodes under
- * one root O(n²). Rebuilding at the start of an update also keeps the walk a
- * snapshot, as the copy-on-write array was — a node created or completed while
- * an update is propagating does not change which nodes that update visits.
- */
-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: Kind extends 'root' ? 0 : number;
-    handle: ObservableBaseHandle<A>;
-    tryUpdate: (updateToken: UpdateToken) => void;
-    tryComplete: () => void;
-    complete: () => void;
-    dispose: () => void;
-    autoComplete: boolean;
-    /**
-     * 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 handle keeps the state flags
-     * up to date on that object alone: a copy made by spreading it afterwards
-     * 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 data
- * properties the handle keeps in step through `attach`, 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, dispose, autoComplete, extra, }: AssembleObservableArgs<A, Kind, Extra>) => Extra & ObservableBase<A> & Readonly<{
-    kind: Kind;
-    depth: AssembleObservableArgs<A, Kind, Extra>['depth'];
-}>;
-export {};
-//# sourceMappingURL=create-observable-base.d.mts.map

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

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