synstate 4.0.0 → 5.0.0

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

@@ -1 +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"}
+{"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;;;OAGG;IACH,SAAS,EAAE,WAAW,GAAG,SAAS,CAAC;IAEnC,YAAY,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,CAAC;CAClD,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;;;;;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.map

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

@@ -1,4 +1,5 @@
 import type { UpdateToken } from '../types/index.mjs';
+import type { ChildNode } from './observable-node.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
@@ -21,4 +22,29 @@ export declare const beginPropagation: (updateToken: UpdateToken) => void;
  * has ended.
  */
 export declare const endPropagation: () => void;
+/**
+ * Opens an update started by a node at `depth`, and returns its token. The
+ * token is the update's queue: a node that emits with it puts its children
+ * there, whichever copy of synstate the node belongs to, so that an update
+ * reaches every node its value reaches, and each once, in ascending depth.
+ * Close it with {@link closeUpdate}.
+ */
+export declare const openUpdate: (depth: number) => UpdateToken;
+/**
+ * How many updates of one copy may be open at once, one inside another. An
+ * update opens inside another only when a subscriber or projection writes to
+ * a root while the outer one is propagating; a chain of such writes this deep
+ * is a loop that would otherwise run until the stack overflows.
+ */
+export declare const maxUpdateNesting = 100;
+export declare const updateLoopMessage: `synstate: more than ${string} updates were nested, one started inside another: a subscriber or projection keeps writing to an observable whose update reaches it again. Make the write stop (a condition, or a value equal to the current one), or derive the value with map / combine.`;
+/** Visits every node the update has queued, shallowest first. */
+export declare const drainUpdate: (updateToken: UpdateToken) => void;
+/** Closes an update, emptying what an exception left in its buckets. */
+export declare const closeUpdate: (updateToken: UpdateToken) => void;
+/**
+ * Puts the children of a node that emitted with `updateToken` into that
+ * update's queue. The update may belong to another copy of synstate.
+ */
+export declare const enqueueChildren: (children: ReadonlySet<ChildNode>, updateToken: UpdateToken) => void;
 //# sourceMappingURL=propagation-state.d.mts.map

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

@@ -1 +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"}
+{"version":3,"file":"propagation-state.d.mts","sourceRoot":"","sources":["../../../src/core/class/propagation-state.mts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAiBvD;;;;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;AAcF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,UAAW,MAAM,KAAG,WAY1C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,eAAO,MAAM,iBAAiB,2RAC2R,CAAC;AAE1T,iEAAiE;AACjE,eAAO,MAAM,WAAW,gBAAiB,WAAW,KAAG,IAEtD,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,WAAW,gBAAiB,WAAW,KAAG,IAItD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,aAChB,WAAW,CAAC,SAAS,CAAC,eACnB,WAAW,KACvB,IAEF,CAAC"}

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

@@ -7,7 +7,12 @@
 
 
 
+
+
+
+
 import { Arr } from 'ts-data-forge';
+import { panic } from 'ts-std-forge';
 
 
 
@@ -63,4 +68,189 @@ export const endPropagation = () => {
         mut_afterPropagation.shift()?.();
     }
 };
+
+
+
+
+
+
+
+const mut_bucketSets = [];
+
+const mut_queueState = { level: 0 };
+
+
+
+
+
+
+
+export const openUpdate = (depth) => {
+    if (mut_queueState.level >= maxUpdateNesting) {
+
+
+
+
+        panic(updateLoopMessage);
+    }
+    mut_queueState.level += 1;
+    return toToken(new UpdateQueue(depth + 1, mut_queueState.level));
+};
+
+
+
+
+
+
+export const maxUpdateNesting = 100;
+export const updateLoopMessage = `synstate: more than ${maxUpdateNesting.toString()} updates were nested, one started inside another: a subscriber or projection keeps writing to an observable whose update reaches it again. Make the write stop (a condition, or a value equal to the current one), or derive the value with map / combine.`;
+
+export const drainUpdate = (updateToken) => {
+    toQueue(updateToken).drain();
+};
+
+export const closeUpdate = (updateToken) => {
+    toQueue(updateToken).close();
+    mut_queueState.level -= 1;
+};
+
+
+
+
+export const enqueueChildren = (children, updateToken) => {
+    toQueue(updateToken).enqueueChildren(children);
+};
+
+
+
+
+
+
+
+
+
+
+class UpdateQueue {
+    #base;
+
+
+    #mut_buckets;
+    #mut_size;
+    #mut_isOpen;
+    #mut_queuedDespiteMark;
+
+    constructor(base, level) {
+        this.#base = base;
+        const mut_buckets = mut_bucketSets[level - 1] ?? [];
+        mut_bucketSets[level - 1] = mut_buckets;
+        this.#mut_buckets = mut_buckets;
+        this.#mut_size = 0;
+        this.#mut_isOpen = true;
+        this.#mut_queuedDespiteMark = undefined;
+    }
+    #push(child) {
+        const index = child.depth - this.#base;
+        const mut_buckets = this.#mut_buckets;
+        while (mut_buckets.length <= index) {
+            mut_buckets.push({ nodes: [], length: 0 });
+        }
+        if (index >= this.#mut_size) {
+            this.#mut_size = index + 1;
+        }
+
+
+        const mut_bucket = mut_buckets[index];
+        const { nodes: mut_nodes, length } = mut_bucket;
+        if (length < mut_nodes.length) {
+            mut_nodes[length] = child;
+        }
+        else {
+            mut_nodes.push(child);
+        }
+        mut_bucket.length = length + 1;
+    }
+
+    get isOpen() {
+        return this.#mut_isOpen;
+    }
+    enqueueChildren(children) {
+        const ownMark = toToken(this);
+        for (const child of children) {
+            const mark = child.queuedFor;
+            if (mark === ownMark) {
+                continue;
+            }
+            if (mark !== undefined && toQueue(mark).isOpen) {
+
+
+                if (this.#mut_queuedDespiteMark === undefined) {
+                    this.#mut_queuedDespiteMark = new Set();
+                }
+                else if (this.#mut_queuedDespiteMark.has(child)) {
+                    continue;
+                }
+                this.#mut_queuedDespiteMark.add(child);
+            }
+            else {
+                child.setQueuedFor(ownMark);
+            }
+            this.#push(child);
+        }
+    }
+    drain() {
+        const token = toToken(this);
+        const mut_buckets = this.#mut_buckets;
+
+
+
+        for (let mut_index = 0; mut_index < this.#mut_size; mut_index += 1) {
+            const mut_bucket = mut_buckets[mut_index];
+            if (mut_bucket === undefined) {
+                continue;
+            }
+
+
+
+            const { nodes: mut_nodes, length } = mut_bucket;
+
+            for (let mut_slot = 0; mut_slot < length; mut_slot += 1) {
+                const node = mut_nodes[mut_slot];
+
+
+                mut_nodes[mut_slot] = undefined;
+                if (node !== undefined && !node.isCompleted) {
+                    node.tryUpdate(token);
+                }
+            }
+            mut_bucket.length = 0;
+        }
+        this.#mut_size = 0;
+    }
+    close() {
+        const mut_buckets = this.#mut_buckets;
+
+
+        for (let mut_index = 0; mut_index < this.#mut_size; mut_index += 1) {
+            const mut_bucket = mut_buckets[mut_index];
+            if (mut_bucket === undefined) {
+                continue;
+            }
+            mut_bucket.nodes.fill(undefined, 0, mut_bucket.length);
+            mut_bucket.length = 0;
+        }
+        this.#mut_size = 0;
+        this.#mut_isOpen = false;
+        this.#mut_queuedDespiteMark = undefined;
+    }
+}
+
+
+
+
+const toQueue = (updateToken) => 
+
+updateToken;
+const toToken = (queue) => 
+
+queue;
 //# sourceMappingURL=propagation-state.mjs.map

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

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

package/dist/core/create/empty.d.mts

@@ -0,0 +1,32 @@
+import type { RootObservable } from '../types/index.mjs';
+/**
+ * Creates an Observable that holds no value and is already completed, so it
+ * never passes anything on (almost equivalent to RxJS `EMPTY`). Useful inside
+ * `switchMap` for the branch that should follow nothing, where a `source()`
+ * would offer a `next` that nothing calls.
+ *
+ * @template A - The type of the values it would carry
+ * @returns An Observable with no value that is already completed
+ *
+ * @example
+ * ```ts
+ * const nothing$ = empty<number>();
+ *
+ * const valueHistory: number[] = [];
+ *
+ * nothing$.subscribe(
+ *   (value) => {
+ *     valueHistory.push(value);
+ *   },
+ *   () => {
+ *     // onComplete — called immediately since empty() completes right away
+ *   },
+ * );
+ *
+ * assert.deepStrictEqual(valueHistory, []);
+ *
+ * assert.strictEqual(nothing$.isCompleted, true);
+ * ```
+ */
+export declare const empty: <A>() => RootObservable<A>;
+//# sourceMappingURL=empty.d.mts.map

package/dist/core/create/empty.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty.d.mts","sourceRoot":"","sources":["../../../src/core/create/empty.mts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,OAAM,cAAc,CAAC,CAAC,CAQ5C,CAAC"}

package/dist/core/create/empty.mjs

@@ -0,0 +1,39 @@
+import { Optional } from 'ts-data-forge';
+import { RootObservableClass } from '../class/index.mjs';
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export const empty = () => {
+    const obs = new RootObservableClass({
+        initialValue: Optional.none,
+    });
+    obs.complete();
+    return obs;
+};
+//# sourceMappingURL=empty.mjs.map

package/dist/core/create/empty.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty.mjs","sourceRoot":"","sources":["../../../src/core/create/empty.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,GAA0B,EAAE;IAC/C,MAAM,GAAG,GAAG,IAAI,mBAAmB,CAAI;QACrC,YAAY,EAAE,QAAQ,CAAC,IAAI;KAC5B,CAAC,CAAC;IAEH,GAAG,CAAC,QAAQ,EAAE,CAAC;IAEf,OAAO,GAAG,CAAC;AACb,CAAC,CAAC"}

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

@@ -1,4 +1,5 @@
 export * from './counter.mjs';
+export * from './empty.mjs';
 export * from './from-abortable-promise.mjs';
 export * from './from-promise.mjs';
 export * from './from-subscribable.mjs';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/core/create/index.mts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/core/create/index.mts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/core/create/index.mjs

@@ -1,4 +1,5 @@
 export * from './counter.mjs';
+export * from './empty.mjs';
 export * from './from-abortable-promise.mjs';
 export * from './from-promise.mjs';
 export * from './from-subscribable.mjs';

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

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/core/create/index.mts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/core/create/index.mts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

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

@@ -1,6 +1,7 @@
 export * from './audit.mjs';
 export * from './debounce.mjs';
 export * from './filter.mjs';
+export * from './keep-equal-parts.mjs';
 export * from './map.mjs';
 export * from './merge-map.mjs';
 export * from './pairwise.mjs';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/core/operators/index.mts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/core/operators/index.mts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC"}

package/dist/core/operators/index.mjs

@@ -1,6 +1,7 @@
 export * from './audit.mjs';
 export * from './debounce.mjs';
 export * from './filter.mjs';
+export * from './keep-equal-parts.mjs';
 export * from './map.mjs';
 export * from './merge-map.mjs';
 export * from './pairwise.mjs';

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

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/core/operators/index.mts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/core/operators/index.mts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC"}

package/dist/core/operators/keep-equal-parts.d.mts

@@ -0,0 +1,85 @@
+import { type ReplaceEqualDeepOptions } from 'ts-data-forge';
+import type { KeepInitialValueOperator } from '../types/index.mjs';
+/**
+ * Passes on each value with every part deeply equal to the same part of the
+ * value passed on before replaced by that part, and skips a value deeply
+ * equal to it altogether (structural sharing). A reader of a part that did
+ * not change keeps the object it has, so `skipIfNoChange()` with `Object.is`
+ * stops it. Superset of `skipIfNoChange(fastDeepEqual)`.
+ *
+ * **Prefer keeping references where the value is written** — compare before
+ * `setState`, and skip it when nothing changed — so that nothing downstream
+ * has anything to undo. The `keepEqualParts` option of `createState` and
+ * `createReducer` does it for a state written whole, and `replaceEqualDeep`
+ * of ts-data-forge does it for any other write. This operator lets every
+ * update that changes nothing reach the source and everything up to it, and
+ * walks the whole value again on each one; reach for it when the source is
+ * not yours to change (a stream that arrives whole from outside).
+ *
+ * Array items are matched by index; pass `{ key }` to match them by key, an
+ * item for which `key` returns `undefined` being matched by index. Only plain
+ * objects and arrays are walked into; a `Map`, a `Set`, a `Date` or a class
+ * instance is compared and kept whole. The values must not be changed after
+ * they are passed on, because the parts kept are shared by later values.
+ *
+ * @template A - The type of values from the source
+ * @param options - `key`, to match array items by key rather than by index
+ * @returns An operator that keeps the parts that did not change
+ *
+ * @example
+ * ```ts
+ * type Board = DeepReadonly<{
+ *   title: string;
+ *   cards: { id: number; text: string }[];
+ * }>;
+ *
+ * // A stream that arrives whole from outside (a WebSocket, say), each
+ * // message a new object even when nothing changed. A state you write
+ * // yourself takes `createState(initial, { keepEqualParts: true })`
+ * // instead.
+ * const message$ = source<Board>();
+ *
+ * const board$ = message$.pipe(keepEqualParts());
+ *
+ * const firstCard$ = board$
+ *   .pipe(map((board) => board.cards[0]))
+ *   .pipe(skipIfNoChange());
+ *
+ * const boardHistory: Board[] = [];
+ *
+ * board$.subscribe((board) => {
+ *   boardHistory.push(board);
+ * });
+ *
+ * const firstCardHistory: unknown[] = [];
+ *
+ * firstCard$.subscribe((card) => {
+ *   firstCardHistory.push(card);
+ * });
+ *
+ * message$.next({ title: 'todo', cards: [{ id: 1, text: 'a' }] });
+ *
+ * // Equal to the last one: nothing is passed on.
+ * message$.next({ title: 'todo', cards: [{ id: 1, text: 'a' }] });
+ *
+ * assert.strictEqual(boardHistory.length, 1);
+ *
+ * // A card added: a new board, but the first card is the one passed on
+ * // before, so `firstCard$` is not told of it.
+ * message$.next({
+ *   title: 'todo',
+ *   cards: [
+ *     { id: 1, text: 'a' },
+ *     { id: 2, text: 'b' },
+ *   ],
+ * });
+ *
+ * assert.strictEqual(boardHistory.length, 2);
+ *
+ * assert.strictEqual(boardHistory[1]?.cards[0], boardHistory[0]?.cards[0]);
+ *
+ * assert.strictEqual(firstCardHistory.length, 1);
+ * ```
+ */
+export declare const keepEqualParts: <A>(options?: ReplaceEqualDeepOptions) => KeepInitialValueOperator<A, A>;
+//# sourceMappingURL=keep-equal-parts.d.mts.map

package/dist/core/operators/keep-equal-parts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keep-equal-parts.d.mts","sourceRoot":"","sources":["../../../src/core/operators/keep-equal-parts.mts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAEV,wBAAwB,EAGzB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgFG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,YACpB,uBAAuB,KAChC,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAMQ,CAAC"}

package/dist/core/operators/keep-equal-parts.mjs

@@ -0,0 +1,129 @@
+
+
+
+
+
+
+
+import { Optional, replaceEqualDeep, } from 'ts-data-forge';
+import { SyncChildObservableClass } from '../class/index.mjs';
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export const keepEqualParts = (options) => 
+
+((parentObservable) => new KeepEqualPartsObservableClass(parentObservable, options));
+class KeepEqualPartsObservableClass extends SyncChildObservableClass {
+    #options;
+    #mut_previousValue;
+    constructor(parentObservable, options) {
+        super({
+            parents: [parentObservable],
+            initialValue: parentObservable.getSnapshot(),
+        });
+        this.#mut_previousValue = parentObservable.getSnapshot();
+        this.#options = options;
+        this.attach();
+    }
+    tryUpdate(updateToken) {
+        const par = this.parents[0];
+        const sn = par.getSnapshot();
+        if (par.updateToken !== updateToken || Optional.isNone(sn)) {
+            return;
+        }
+        const prev = this.#mut_previousValue;
+        if (Optional.isNone(prev)) {
+            this.#mut_previousValue = sn;
+            this.setNext(sn.value, updateToken);
+            return;
+        }
+        const kept = replaceEqualDeep(prev.value, sn.value, this.#options);
+        if (Object.is(kept, prev.value)) {
+            return;
+        }
+
+        this.#mut_previousValue = Object.is(kept, sn.value)
+            ? sn
+            : Optional.some(kept);
+        this.setNext(kept, updateToken);
+    }
+}
+//# sourceMappingURL=keep-equal-parts.mjs.map

package/dist/core/operators/keep-equal-parts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"keep-equal-parts.mjs","sourceRoot":"","sources":["../../../src/core/operators/keep-equal-parts.mts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,6EAA6E;AAC7E,yCAAyC;AACzC,2CAA2C;AAC3C,gDAAgD;AAChD,0DAA0D;AAC1D,kEAAkE;AAClE,OAAO,EACL,QAAQ,EACR,gBAAgB,GAEjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAQ9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgFG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,OAAiC,EACD,EAAE;AAClC,4DAA4D;AAC5D,CAAC,CAAC,gBAAgB,EAAE,EAAE,CACpB,IAAI,6BAA6B,CAC/B,gBAAgB,EAChB,OAAO,CACR,CAAmC,CAAC;AAEzC,MAAM,6BACJ,SAAQ,wBAAyC;IAGxC,QAAQ,CAAsC;IACvD,kBAAkB,CAAc;IAEhC,YACE,gBAA+B,EAC/B,OAA4C;QAE5C,KAAK,CAAC;YACJ,OAAO,EAAE,CAAC,gBAAgB,CAAC;YAC3B,YAAY,EAAE,gBAAgB,CAAC,WAAW,EAAE;SAC7C,CAAC,CAAC;QAEH,IAAI,CAAC,kBAAkB,GAAG,gBAAgB,CAAC,WAAW,EAAE,CAAC;QAEzD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QAExB,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAEQ,SAAS,CAAC,WAAwB;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAE5B,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAE7B,IAAI,GAAG,CAAC,WAAW,KAAK,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YAC3D,OAAO,CAAC,cAAc;QACxB,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,kBAAkB,CAAC;QAErC,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;YAE7B,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;YAEpC,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEnE,IAAI,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO;QACT,CAAC;QAED,sDAAsD;QACtD,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC;YACjD,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAExB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/core/types/id.d.mts

@@ -1,3 +1,7 @@
-import type { Brand } from 'ts-type-forge';
-export type UpdateToken = Brand<symbol, 'update-token'>;
+import type { Brand, UnknownRecord } from 'ts-type-forge';
+/**
+ * Identifies one update. Opaque: an object issued per update, which is also
+ * that update's queue.
+ */
+export type UpdateToken = Brand<UnknownRecord, 'update-token'>;
 //# sourceMappingURL=id.d.mts.map

package/dist/core/types/id.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"id.d.mts","sourceRoot":"","sources":["../../../src/core/types/id.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC"}
+{"version":3,"file":"id.d.mts","sourceRoot":"","sources":["../../../src/core/types/id.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC"}

package/dist/core/types/observable-family.d.mts

@@ -59,6 +59,7 @@ export type SkipUntilOperatorObservable<A> = SyncChildObservable<A, readonly [A]
 export type WithCurrentValueFromOperatorObservable<A, B> = SyncChildObservable<readonly [A, B], readonly [A]>;
 export type WithBufferedFromOperatorObservable<A, B> = SyncChildObservable<readonly [A, readonly B[]], readonly [A]>;
 export type FilterOperatorObservable<A> = SyncChildObservable<A, readonly [A]>;
+export type KeepEqualPartsOperatorObservable<A> = SyncChildObservable<A, readonly [A]>;
 export type SkipIfNoChangeOperatorObservable<A> = SyncChildObservable<A, readonly [A]>;
 export type ThrottleOperatorObservable<A> = SyncChildObservable<A, readonly [A]>;
 export type AuditOperatorObservable<A> = AsyncChildObservable<A, readonly [A]>;