synstate 3.3.0 → 4.0.0

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

@@ -0,0 +1,219 @@
+
+
+
+
+
+
+
+import { Optional } from 'ts-data-forge';
+import { unreachable } from 'ts-std-forge';
+import { getCurrentScopeInternals, notUpdatedYet, observableBrand, toSubscriber, } from '../utils/index.mjs';
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export class ObservableBaseClass {
+    #mut_snapshot;
+    #mut_isCompleted;
+    #mut_updateToken;
+    #mut_children;
+    #mut_subscribers;
+    #mut_scope;
+    kind;
+    depth;
+    constructor({ kind, depth, initialValue, }) {
+        this.kind = kind;
+        this.depth = depth;
+        this.#mut_snapshot = initialValue;
+        this.#mut_isCompleted = false;
+        this.#mut_updateToken = notUpdatedYet;
+        this.#mut_children = undefined;
+        this.#mut_subscribers = undefined;
+        this.#mut_scope = undefined;
+        this[observableBrand] = true;
+    }
+    getSnapshot() {
+        return this.#mut_snapshot;
+    }
+    get isCompleted() {
+        return this.#mut_isCompleted;
+    }
+    get updateToken() {
+        return this.#mut_updateToken;
+    }
+    get hasSubscriber() {
+        return (this.#mut_subscribers !== undefined && this.#mut_subscribers.size > 0);
+    }
+    get hasChild() {
+        return this.#mut_children !== undefined && this.#mut_children.size > 0;
+    }
+    hasActiveChild() {
+        if (this.#mut_children !== undefined) {
+            for (const c of this.#mut_children) {
+                if (!c.isCompleted) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    addChild(child) {
+
+
+        if (this.#mut_children === undefined) {
+            this.#mut_children = new Set([child]);
+        }
+        else {
+            this.#mut_children.add(child);
+        }
+    }
+    deleteChild(child) {
+        this.#mut_children?.delete(child);
+    }
+
+    setNext(nextValue, updateToken) {
+        this.#mut_updateToken = updateToken;
+        this.#mut_snapshot = Optional.some(nextValue);
+        if (this.#mut_subscribers !== undefined) {
+            for (const s of this.#mut_subscribers) {
+                s.onNext(nextValue);
+            }
+        }
+    }
+
+
+
+
+
+
+
+
+    tryUpdate(_updateToken) {
+        unreachable();
+    }
+
+
+
+
+
+
+    tryComplete() { }
+
+
+
+
+
+
+    complete() {
+        if (this.#mut_isCompleted) {
+            return;
+        }
+        this.flush();
+        this.dispose();
+    }
+
+
+
+
+    dispose() {
+
+
+        if (this.#mut_isCompleted) {
+            return;
+        }
+        this.teardown();
+        this.#mut_isCompleted = true;
+        if (this.#mut_scope !== undefined) {
+            this.#mut_scope.release();
+            this.#mut_scope = undefined;
+        }
+        if (this.#mut_subscribers !== undefined) {
+            for (const s of this.#mut_subscribers) {
+                s.onComplete();
+            }
+            this.#mut_subscribers.clear();
+        }
+
+
+        if (this.#mut_children !== undefined) {
+            for (const c of this.#mut_children) {
+                c.tryComplete();
+            }
+        }
+        this.detach();
+    }
+
+
+
+
+
+    flush() { }
+
+
+
+
+
+
+    teardown() { }
+
+
+    detach() { }
+
+
+
+
+
+    adoptIntoCurrentScope() {
+        const scope = getCurrentScopeInternals();
+        if (scope === undefined || this.#mut_isCompleted) {
+            return;
+        }
+        scope.adopt(this);
+        this.#mut_scope = scope;
+    }
+    pipe(operator) {
+        return operator(
+
+
+        this);
+    }
+    subscribe(onNext, onComplete) {
+
+        if (Optional.isSome(this.#mut_snapshot)) {
+            onNext(this.#mut_snapshot.value);
+        }
+        if (this.#mut_isCompleted) {
+            onComplete?.();
+            return noopSubscription;
+        }
+        const subscriber = toSubscriber(onNext, onComplete);
+        this.#mut_subscribers ??= new Set();
+        this.#mut_subscribers.add(subscriber);
+        return {
+            unsubscribe: () => {
+                this.#mut_subscribers?.delete(subscriber);
+            },
+        };
+    }
+}
+const noopSubscription = { unsubscribe: () => { } };
+//# sourceMappingURL=observable-base-class.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observable-base-class.mjs","sourceRoot":"","sources":["../../../src/core/class/observable-base-class.mts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,yDAAyD;AACzD,4EAA4E;AAC5E,2CAA2C;AAC3C,gDAAgD;AAChD,0DAA0D;AAC1D,kEAAkE;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAe3C,OAAO,EACL,wBAAwB,EACxB,aAAa,EACb,eAAe,EACf,YAAY,GAEb,MAAM,oBAAoB,CAAC;AAG5B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,mBAAmB;IAK9B,aAAa,CAAc;IAC3B,gBAAgB,CAAU;IAC1B,gBAAgB,CAAc;IAC9B,aAAa,CAAoC;IACjD,gBAAgB,CAAwC;IACxD,UAAU,CAA6B;IAC9B,IAAI,CAAO;IACX,KAAK,CAAQ;IAGtB,YAAY,EACV,IAAI,EACJ,KAAK,EACL,YAAY,GAKZ;QACA,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAEnB,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;QAElC,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;QAE9B,IAAI,CAAC,gBAAgB,GAAG,aAAa,CAAC;QAEtC,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;QAE/B,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;QAElC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAE5B,IAAI,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC;IAC/B,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,IAAI,aAAa;QACf,OAAO,CACL,IAAI,CAAC,gBAAgB,KAAK,SAAS,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,CACtE,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,aAAa,KAAK,SAAS,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,CAAC;IACzE,CAAC;IAED,cAAc;QACZ,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACrC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnC,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;oBACnB,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,QAAQ,CAAC,KAAgB;QACvB,yEAAyE;QACzE,4EAA4E;QAC5E,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACrC,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,WAAW,CAAC,KAAgB;QAC1B,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,wEAAwE;IAC9D,OAAO,CAAC,SAAY,EAAE,WAAwB;QACtD,IAAI,CAAC,gBAAgB,GAAG,WAAW,CAAC;QAEpC,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE9C,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACxC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACtC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,qEAAqE;IACrE,SAAS,CAAC,YAAyB;QACjC,WAAW,EAAE,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,qEAAqE;IACrE,WAAW,KAAU,CAAC;IAEtB;;;;;OAKG;IACH,QAAQ;QACN,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,EAAE,CAAC;QAEb,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,wEAAwE;QACxE,2EAA2E;QAC3E,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QAEhB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAE7B,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YAE1B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC9B,CAAC;QAED,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACxC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACtC,CAAC,CAAC,UAAU,EAAE,CAAC;YACjB,CAAC;YAED,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAChC,CAAC;QAED,0EAA0E;QAC1E,qCAAqC;QACrC,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACrC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnC,CAAC,CAAC,WAAW,EAAE,CAAC;YAClB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,qEAAqE;IAC3D,KAAK,KAAU,CAAC;IAE1B;;;;OAIG;IACH,qEAAqE;IAC3D,QAAQ,KAAU,CAAC;IAE7B,uEAAuE;IACvE,qEAAqE;IAC3D,MAAM,KAAU,CAAC;IAE3B;;;;OAIG;IACO,qBAAqB;QAC7B,MAAM,KAAK,GAAG,wBAAwB,EAAE,CAAC;QAEzC,IAAI,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACjD,OAAO;QACT,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAWD,IAAI,CAAI,QAAwB;QAC9B,OAAO,QAAQ;QACb,sEAAsE;QACtE,4DAA4D;QAC5D,IAA2C,CAC5C,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,MAAsB,EAAE,UAAuB;QACvD,aAAa;QACb,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,UAAU,EAAE,EAAE,CAAC;YAEf,OAAO,gBAAgB,CAAC;QAC1B,CAAC;QAED,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAEpD,IAAI,CAAC,gBAAgB,KAAK,IAAI,GAAG,EAAE,CAAC;QAEpC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAEtC,OAAO;YACL,WAAW,EAAE,GAAG,EAAE;gBAChB,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;YAC5C,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AAED,MAAM,gBAAgB,GAAiB,EAAE,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC,EAAW,CAAC"}

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

@@ -0,0 +1,40 @@
+import type { Observable, ObservableBase, UpdateToken } from '../types/index.mjs';
+/**
+ * The members the nodes of the graph call on one another, which the public
+ * types leave out (#2117). Every observable is an instance of
+ * `ObservableBaseClass` — of this copy of synstate or of another — and has
+ * them.
+ */
+type NodeInternals = Readonly<{
+    hasSubscriber: boolean;
+    hasChild: boolean;
+    hasActiveChild: () => boolean;
+    tryUpdate: (updateToken: UpdateToken) => void;
+    tryComplete: () => void;
+    addChild: (child: ChildNode) => void;
+    deleteChild: (child: ChildNode) => void;
+    /**
+     * The managers this node's own descendants register to: itself for a
+     * manager, its parents' for a sync child, shared with its parent when it
+     * has one. Cached so that creating a child does not walk its ancestors.
+     */
+    managers: readonly ManagerNode[];
+}>;
+/** An observable, as the other nodes of the graph see it. */
+export type ObservableNode<A = unknown> = NodeInternals & Observable<A>;
+export type ChildNode = NodeInternals & ObservableBase<unknown> & Readonly<{
+    parents: readonly Observable<unknown>[];
+}>;
+export type ManagerNode = NodeInternals & ObservableBase<unknown> & Readonly<{
+    addDescendant: (child: ChildNode) => void;
+    deleteDescendant: (child: ChildNode) => void;
+}>;
+/**
+ * The one place a public observable is seen as the node it is. Every
+ * observable is built by a synstate class, and the public types carry a
+ * brand an object literal cannot supply, so this holds for every value of
+ * those types.
+ */
+export declare const toNode: <A>(observable: Observable<A>) => ObservableNode<A>;
+export {};
+//# sourceMappingURL=observable-node.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observable-node.d.mts","sourceRoot":"","sources":["../../../src/core/class/observable-node.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,WAAW,EACZ,MAAM,oBAAoB,CAAC;AAE5B;;;;;GAKG;AACH,KAAK,aAAa,GAAG,QAAQ,CAAC;IAC5B,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,OAAO,CAAC;IAC9B,SAAS,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,CAAC;IAC9C,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACrC,WAAW,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAExC;;;;OAIG;IACH,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;CAClC,CAAC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,IAAI,aAAa,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;AAExE,MAAM,MAAM,SAAS,GAAG,aAAa,GACnC,cAAc,CAAC,OAAO,CAAC,GACvB,QAAQ,CAAC;IACP,OAAO,EAAE,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;CACzC,CAAC,CAAC;AAEL,MAAM,MAAM,WAAW,GAAG,aAAa,GACrC,cAAc,CAAC,OAAO,CAAC,GACvB,QAAQ,CAAC;IACP,aAAa,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC1C,gBAAgB,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CAC9C,CAAC,CAAC;AAEL;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,cAAe,UAAU,CAAC,CAAC,CAAC,KAAG,cAAc,CAAC,CAAC,CAEtC,CAAC"}

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

@@ -0,0 +1,10 @@
+
+
+
+
+
+
+export const toNode = (observable) => 
+
+observable;
+//# sourceMappingURL=observable-node.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observable-node.mjs","sourceRoot":"","sources":["../../../src/core/class/observable-node.mts"],"names":[],"mappings":"AA6CA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAK,UAAyB,EAAqB,EAAE;AACzE,4DAA4D;AAC5D,UAA+B,CAAC"}

package/dist/core/class/propagation-state.d.mts

@@ -0,0 +1,24 @@
+import type { UpdateToken } from '../types/index.mjs';
+/**
+ * Whether some observable's update is propagating right now. A root written
+ * to while one is, is written to from inside a subscriber or a projection
+ * (#2336).
+ */
+export declare const isPropagating: () => boolean;
+/** The token of the outermost update propagating now, if any. */
+export declare const outermostUpdateToken: () => UpdateToken | undefined;
+/**
+ * Runs `task` once the update now propagating has reached every descendant, or
+ * at once when none is. A child that completes itself in its `tryUpdate`
+ * completes its children with it, before they have seen the value it has just
+ * passed on (`take`).
+ */
+export declare const runAfterPropagation: (task: () => void) => void;
+/** Brackets one `startUpdate`; see {@link endPropagation}. */
+export declare const beginPropagation: (updateToken: UpdateToken) => void;
+/**
+ * Ends one `startUpdate`, and runs the deferred work once the outermost one
+ * has ended.
+ */
+export declare const endPropagation: () => void;
+//# sourceMappingURL=propagation-state.d.mts.map

package/dist/core/class/propagation-state.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propagation-state.d.mts","sourceRoot":"","sources":["../../../src/core/class/propagation-state.mts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAiBtD;;;;GAIG;AACH,eAAO,MAAM,aAAa,QAAO,OAAoC,CAAC;AAEtE,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,QAAO,WAAW,GAAG,SACtB,CAAC;AAEjC;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,SAAU,MAAM,IAAI,KAAG,IAMtD,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB,gBAAiB,WAAW,KAAG,IAM3D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAO,IAcjC,CAAC"}

package/dist/core/class/propagation-state.mjs

@@ -0,0 +1,66 @@
+
+
+
+
+
+
+
+
+
+import { Arr } from 'ts-data-forge';
+
+
+
+
+const mut_propagation = { depth: 0, outermostToken: undefined };
+
+
+
+
+const mut_afterPropagation = [];
+
+
+
+
+
+export const isPropagating = () => mut_propagation.depth > 0;
+
+export const outermostUpdateToken = () => mut_propagation.outermostToken;
+
+
+
+
+
+
+export const runAfterPropagation = (task) => {
+    if (isPropagating()) {
+        mut_afterPropagation.push(task);
+    }
+    else {
+        task();
+    }
+};
+
+export const beginPropagation = (updateToken) => {
+    if (mut_propagation.depth === 0) {
+        mut_propagation.outermostToken = updateToken;
+    }
+    mut_propagation.depth += 1;
+};
+
+
+
+
+export const endPropagation = () => {
+    mut_propagation.depth -= 1;
+    if (mut_propagation.depth > 0) {
+        return;
+    }
+    mut_propagation.outermostToken = undefined;
+
+
+    while (Arr.isNonEmpty(mut_afterPropagation)) {
+        mut_afterPropagation.shift()?.();
+    }
+};
+//# sourceMappingURL=propagation-state.mjs.map

package/dist/core/class/propagation-state.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"propagation-state.mjs","sourceRoot":"","sources":["../../../src/core/class/propagation-state.mts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAGpC;;;GAGG;AACH,MAAM,eAAe,GAGjB,EAAE,KAAK,EAAE,CAAC,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC;AAE5C;;;GAGG;AACH,MAAM,oBAAoB,GAAmB,EAAE,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAY,EAAE,CAAC,eAAe,CAAC,KAAK,GAAG,CAAC,CAAC;AAEtE,iEAAiE;AACjE,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAA4B,EAAE,CAChE,eAAe,CAAC,cAAc,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAgB,EAAQ,EAAE;IAC5D,IAAI,aAAa,EAAE,EAAE,CAAC;QACpB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,IAAI,EAAE,CAAC;IACT,CAAC;AACH,CAAC,CAAC;AAEF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,WAAwB,EAAQ,EAAE;IACjE,IAAI,eAAe,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QAChC,eAAe,CAAC,cAAc,GAAG,WAAW,CAAC;IAC/C,CAAC;IAED,eAAe,CAAC,KAAK,IAAI,CAAC,CAAC;AAC7B,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAS,EAAE;IACvC,eAAe,CAAC,KAAK,IAAI,CAAC,CAAC;IAE3B,IAAI,eAAe,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO;IACT,CAAC;IAED,eAAe,CAAC,cAAc,GAAG,SAAS,CAAC;IAE3C,0EAA0E;IAC1E,2CAA2C;IAC3C,OAAO,GAAG,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC5C,oBAAoB,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC;IACnC,CAAC;AACH,CAAC,CAAC"}

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

@@ -0,0 +1,23 @@
+import { Optional } from 'ts-data-forge';
+import { type RootObservable } from '../types/index.mjs';
+import { ManagerObservableClass } from './manager-observable-class.mjs';
+export declare class RootObservableClass<A> extends ManagerObservableClass<A, 'root', 0> implements RootObservable<A> {
+    #private;
+    constructor({ initialValue, }: Readonly<{
+        initialValue: Optional<A>;
+    }>);
+    /**
+     * Emits `nextValue` and propagates the update to all descendants, warning
+     * once when it is a write from inside another update.
+     */
+    protected startUpdate(nextValue: A): void;
+}
+/**
+ * Shown once per root observable, the first time it is written to (`next`,
+ * `setState`, `dispatch`, …) while another update is still propagating —
+ * from a subscriber or a projection. The write still propagates immediately,
+ * as it always has; the warning is there because the pattern is wrong, not
+ * because anything was refused.
+ */
+export declare const writeDuringPropagationWarning = "synstate: an observable was written to (next / setState / dispatch) while an update was propagating, so subscribers can see intermediate states. Derive the value with map / combine instead of writing from a subscriber or a projection.";
+//# sourceMappingURL=root-observable-class.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"root-observable-class.d.mts","sourceRoot":"","sources":["../../../src/core/class/root-observable-class.mts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAGxE,qBAAa,mBAAmB,CAAC,CAAC,CAChC,SAAQ,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAC3C,YAAW,cAAc,CAAC,CAAC,CAAC;;IAY5B,YAAY,EACV,YAAY,GACb,EAAE,QAAQ,CAAC;QACV,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;KAC3B,CAAC,EAYD;IAED;;;OAGG;IACH,UAAmB,WAAW,CAAC,SAAS,EAAE,CAAC,GAAG,IAAI,CAYjD;CACF;AAED;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,+OACoM,CAAC"}

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

@@ -0,0 +1,58 @@
+
+
+
+
+
+
+import { ManagerObservableClass } from './manager-observable-class.mjs';
+import { isPropagating, outermostUpdateToken } from './propagation-state.mjs';
+export class RootObservableClass extends ManagerObservableClass {
+
+
+
+
+
+
+
+    #createdDuring;
+    #mut_hasWarned;
+    constructor({ initialValue, }) {
+        super({
+            kind: 'root',
+            depth: 0,
+            initialValue,
+        });
+        this.#createdDuring = outermostUpdateToken();
+        this.#mut_hasWarned = false;
+        this.adoptIntoCurrentScope();
+    }
+
+
+
+
+    startUpdate(nextValue) {
+        if (!this.#mut_hasWarned &&
+            isPropagating() &&
+            outermostUpdateToken() !== this.#createdDuring) {
+            this.#mut_hasWarned = true;
+            console.warn(writeDuringPropagationWarning);
+        }
+        super.startUpdate(nextValue);
+    }
+}
+
+
+
+
+
+
+
+export const writeDuringPropagationWarning = 'synstate: an observable was written to (next / setState / dispatch) while an update was propagating, so subscribers can see intermediate states. Derive the value with map / combine instead of writing from a subscriber or a projection.';
+
+
+
+
+
+
+
+//# sourceMappingURL=root-observable-class.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"root-observable-class.mjs","sourceRoot":"","sources":["../../../src/core/class/root-observable-class.mts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,gDAAgD;AAChD,0DAA0D;AAC1D,kEAAkE;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,gBAAgB,GAGjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE9E,MAAM,OAAO,mBACX,SAAQ,sBAAoC;IAG5C;;;;;;OAMG;IACM,cAAc,CAA0B;IACjD,cAAc,CAAU;IAExB,YAAY,EACV,YAAY,GAGZ;QACA,KAAK,CAAC;YACJ,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,CAAC;YACR,YAAY;SACb,CAAC,CAAC;QAEH,IAAI,CAAC,cAAc,GAAG,oBAAoB,EAAE,CAAC;QAE7C,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;QAE5B,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACgB,WAAW,CAAC,SAAY;QACzC,IACE,CAAC,IAAI,CAAC,cAAc;YACpB,aAAa,EAAE;YACf,oBAAoB,EAAE,KAAK,IAAI,CAAC,cAAc,EAC9C,CAAC;YACD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAE3B,OAAO,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC9C,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,6BAA6B,GACxC,4OAA4O,CAAC;AAE/O,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;IACrC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,MAAM,CACX,gBAAgB,CACd,IAAI,mBAAmB,CAAC;YACtB,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;SAC/B,CAAC,CACH,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,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,KAAK,EAAE,aAAa,EAAS,MAAM,eAAe,CAAC;AAI1D,OAAO,KAAK,EAEV,wBAAwB,EAIxB,UAAU,EAGX,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"}
+{"version":3,"file":"combine.d.mts","sourceRoot":"","sources":["../../../src/core/combine/combine.mts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAS,MAAM,eAAe,CAAC;AAI1D,OAAO,KAAK,EAEV,wBAAwB,EAIxB,UAAU,EAIX,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"}

package/dist/core/combine/combine.mjs

@@ -1,5 +1,11 @@
+
+
+
+
+
+
 import { Arr, Optional } from 'ts-data-forge';
-import { createSyncChildObservable } from '../base/index.mjs';
+import { SyncChildObservableClass } from '../class/index.mjs';
 
 
 
@@ -61,14 +67,15 @@ import { createSyncChildObservable } from '../base/index.mjs';
 
 export const combine = (parents) => 
 
-createCombineObservable(parents);
+new CombineObservableClass(parents);
 
 
 
 
 export const combineLatest = combine;
-const createCombineObservable = (parents) => {
-    const parentsValues = Arr.map(parents, (p) => p.getSnapshot());
+class CombineObservableClass extends SyncChildObservableClass {
+    constructor(parents) {
+        const parentsValues = Arr.map(parents, (p) => p.getSnapshot());
 
 
 
@@ -77,13 +84,17 @@ const createCombineObservable = (parents) => {
 
 
 
-    const initialValue = Arr.every(parentsValues, Optional.isSome)
-        ? Optional.some(Arr.map(parentsValues, (c) => c.value))
-        : Optional.none;
-    return createSyncChildObservable({
-        parents,
-        initialValue,
-    }, ({ setNext }) => (updateToken) => {
+        const initialValue = Arr.every(parentsValues, Optional.isSome)
+            ? Optional.some(Arr.map(parentsValues, (c) => c.value))
+            : Optional.none;
+        super({
+            parents,
+            initialValue,
+        });
+        this.attach();
+    }
+    tryUpdate(updateToken) {
+        const parents = this.parents;
         if (parents.every((o) => o.updateToken !== updateToken)) {
             return;
         }
@@ -95,9 +106,9 @@ const createCombineObservable = (parents) => {
             return;
         }
         const nextValue = Arr.map(parentValues, (a) => a.value);
-        setNext(nextValue, updateToken);
-    });
-};
+        this.setNext(nextValue, updateToken);
+    }
+}
 
 
 

package/dist/core/combine/combine.mjs.map

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

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

@@ -47,9 +47,6 @@ import type { MergeObservableRefined, Observable } from '../types/index.mjs';
  *
  * assert.deepStrictEqual(valueHistory, ['c1', 'k1', 'c2', 'k2']);
  * ```
- *
- * @note To improve code readability, consider using `createState` instead of `merge`,
- * subscribing to `parents` and calling `setState` within it.
  */
 export declare const merge: <const OS extends NonEmptyTuple<Observable<unknown>>>(parents: OS) => MergeObservableRefined<OS>;
 //# sourceMappingURL=merge.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"merge.d.mts","sourceRoot":"","sources":["../../../src/core/combine/merge.mts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,eAAe,CAAC;AAGjE,OAAO,KAAK,EAEV,sBAAsB,EAEtB,UAAU,EAGX,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,CAAC,EAAE,SAAS,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,WAC9D,EAAE,KACV,sBAAsB,CAAC,EAAE,CAEkC,CAAC"}
+{"version":3,"file":"merge.d.mts","sourceRoot":"","sources":["../../../src/core/combine/merge.mts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,eAAe,CAAC;AAGjE,OAAO,KAAK,EAEV,sBAAsB,EAEtB,UAAU,EAIX,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,CAAC,EAAE,SAAS,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,WAC9D,EAAE,KACV,sBAAsB,CAAC,EAAE,CAEqC,CAAC"}

package/dist/core/combine/merge.mjs

@@ -1,11 +1,14 @@
-import { Optional } from 'ts-data-forge';
-import { createSyncChildObservable } from '../base/index.mjs';
 
 
 
 
 
 
+import { Optional } from 'ts-data-forge';
+import { SyncChildObservableClass } from '../class/index.mjs';
+
+
+
 
 
 
@@ -54,20 +57,26 @@ import { createSyncChildObservable } from '../base/index.mjs';
 
 export const merge = (parents) => 
 
-createMergeObservable(parents);
-const createMergeObservable = (parents) => createSyncChildObservable({
-    parents,
-    initialValue: Optional.none,
-}, ({ setNext }) => (updateToken) => {
-    const parentToUse = parents.find((o) => o.updateToken === updateToken && Optional.isSome(o.getSnapshot()));
-    if (parentToUse === undefined) {
-        return;
+new MergeObservableClass(parents);
+class MergeObservableClass extends SyncChildObservableClass {
+    constructor(parents) {
+        super({
+            parents,
+            initialValue: Optional.none,
+        });
+        this.attach();
     }
-    const nextValue = 
-
-    Optional.unwrap(parentToUse.getSnapshot());
-    setNext(nextValue, updateToken);
-});
+    tryUpdate(updateToken) {
+        const parentToUse = this.parents.find((o) => o.updateToken === updateToken && Optional.isSome(o.getSnapshot()));
+        if (parentToUse === undefined) {
+            return;
+        }
+        const nextValue = 
+
+        Optional.unwrap(parentToUse.getSnapshot());
+        this.setNext(nextValue, updateToken);
+    }
+}
 
 
 

package/dist/core/combine/merge.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"merge.mjs","sourceRoot":"","sources":["../../../src/core/combine/merge.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAU7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CACnB,OAAW,EACiB,EAAE;AAC9B,4DAA4D;AAC5D,qBAAqB,CAAC,OAAO,CAA+B,CAAC;AAE/D,MAAM,qBAAqB,GAAG,CAC5B,OAAgB,EACI,EAAE,CACtB,yBAAyB,CACvB;IACE,OAAO;IACP,YAAY,EAAE,QAAQ,CAAC,IAAI;CAC5B,EACD,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CACd,CAAC,WAAW,EAAE,EAAE;IACd,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAC9B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,WAAW,KAAK,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CACpE,CAAC;IAEF,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO;IACT,CAAC;IAED,MAAM,SAAS;IACb,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,CAAoB,CAAC;IAEhE,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAClC,CAAC,CACJ,CAAC;AAEJ,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;IACrC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;QACrB,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ;IAC7B,CAAC,CAAC,CAAC;IAEH,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAErB,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAEvB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAE3B,UAAU,CAAkD,IAAI,CAAC,CAAC;AACpE,CAAC"}
+{"version":3,"file":"merge.mjs","sourceRoot":"","sources":["../../../src/core/combine/merge.mts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,6EAA6E;AAC7E,yCAAyC;AACzC,2CAA2C;AAC3C,gDAAgD;AAChD,0DAA0D;AAC1D,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAW7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CACnB,OAAW,EACiB,EAAE;AAC9B,4DAA4D;AAC5D,IAAI,oBAAoB,CAAC,OAAO,CAA+B,CAAC;AAElE,MAAM,oBACJ,SAAQ,wBAA4C;IAGpD,YAAY,OAAgB;QAC1B,KAAK,CAAC;YACJ,OAAO;YACP,YAAY,EAAE,QAAQ,CAAC,IAAI;SAC5B,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAEQ,SAAS,CAAC,WAAwB;QACzC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CACnC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CACzE,CAAC;QAEF,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,MAAM,SAAS;QACb,4DAA4D;QAC5D,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,CAAoB,CAAC;QAEhE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACvC,CAAC;CACF;AAED,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;IACrC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;QACrB,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ;IAC7B,CAAC,CAAC,CAAC;IAEH,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAErB,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAEvB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAE3B,UAAU,CAAkD,IAAI,CAAC,CAAC;AACpE,CAAC"}