@earendil-works/chord 1.5.0 → 1.5.1

package/dist/next/host/reference-keys.js

@@ -1,168 +0,0 @@
-// The keys a reference holds (slice 6a §12; decision "References are the only indirection" (4)): its key watches and
-// its factory's pins (`at(key)`) of its object's keyed members, one source per member and key shared by them, pinned on
-// the object's live instance (loaded, mapped to the reference's version). While the object still follows the instance a
-// key is pinned on (a swap's old instance, a restart's drain, a live failure's admitted commits) the key follows it on,
-// as members do. When the reference moves to a new instance or a new object it pins the key there again, keeping the
-// last value until that pin loads, then one frame; while it points at nothing the key keeps its last value (one
-// `failed` call when its target failed, none while it loads).
-import { awaitWithContext, BACKGROUND_CONTEXT } from "../../context/index.js";
-import { ChordError } from "../data/index.js";
-import { asChordError } from "../data/internal.js";
-import { ReferenceSource } from "./reference-source.js";
-/** A reference's held keys; every instance pin below them released exactly once. */
-export class ReferenceKeys {
-    #holder;
-    #entries = new Map();
-    constructor(holder) {
-        this.#holder = holder;
-    }
-    /**
-     * Holds `key` of keyed member `member`: its source once pinned and loaded on the live instance; `context` ends only
-     * this caller's wait. `release` (once) lets it go with its last holder.
-     */
-    async hold(member, key, context) {
-        const entry = this.#entry(member, key);
-        entry.holders++;
-        let released = false;
-        const release = () => {
-            if (released)
-                return;
-            released = true;
-            this.#release(entry);
-        };
-        try {
-            if (entry.pin === undefined)
-                await awaitWithContext(this.#pin(entry), context);
-        }
-        catch (error) {
-            release();
-            throw error;
-        }
-        return { source: entry.source, release };
-    }
-    /**
-     * Its reference's target changed, inside a batch: a key pins again on a new live instance (last value meanwhile);
-     * while the target is not live it follows the instance it is pinned on as long as the object does (a commit admitted
-     * there still shows), then keeps its last value (one `failed` call for a failure) and its pin goes.
-     */
-    follow(context) {
-        const target = this.#holder.target();
-        const instance = target?.instance;
-        const attachable = target?.attachable;
-        for (const byKey of this.#entries.values()) {
-            for (const entry of byKey.values()) {
-                if (instance !== undefined) {
-                    // A failed load shows on the key (`failed`); nobody waits on this pin.
-                    if (entry.instance !== instance)
-                        this.#pin(entry).catch(() => { });
-                    continue;
-                }
-                if (attachable !== undefined && entry.instance === attachable)
-                    continue;
-                const state = target?.state;
-                if (state?.kind === "failed")
-                    entry.source.fail(state.cause.error, context);
-                else
-                    entry.source.hold();
-                this.#unpin(entry);
-            }
-        }
-    }
-    /** Its reference left its object (`error`: why it waits), inside a batch: keys keep their last values, pins go. */
-    fail(error, context) {
-        for (const byKey of this.#entries.values()) {
-            for (const entry of byKey.values()) {
-                entry.source.fail(error, context);
-                this.#unpin(entry);
-            }
-        }
-    }
-    /** Its reference ended, inside a batch: every key ends with `error` and releases its pin. */
-    end(error) {
-        for (const byKey of this.#entries.values()) {
-            for (const entry of byKey.values()) {
-                entry.source.end(error);
-                this.#unpin(entry);
-            }
-        }
-        this.#entries.clear();
-    }
-    /** The entry of `member` and `key`, made by the first holder. */
-    #entry(member, key) {
-        let byKey = this.#entries.get(member);
-        if (byKey === undefined) {
-            byKey = new Map();
-            this.#entries.set(member, byKey);
-        }
-        let entry = byKey.get(key);
-        if (entry === undefined) {
-            const source = new ReferenceSource(this.#holder.batch, this.#holder);
-            entry = { member, key, source, holders: 0, instance: undefined, pin: undefined, loading: undefined };
-            byKey.set(key, entry);
-        }
-        return entry;
-    }
-    /**
-     * Pins `entry`'s key on the target's live instance (once per instance): the source keeps its last value meanwhile,
-     * follows the pin when it lands (one frame) and releases the previous one; a failed load shows as its failure.
-     */
-    #pin(entry) {
-        const { batch, version } = this.#holder;
-        const target = this.#holder.target();
-        const instance = target?.instance;
-        if (target === undefined || instance === undefined)
-            return Promise.reject(this.#holder.none());
-        if (entry.instance === instance && entry.loading !== undefined)
-            return entry.loading;
-        entry.instance = instance;
-        // No frames from the old instance while the new one loads the key.
-        entry.source.hold();
-        const loading = target.pinKey(entry.member, entry.key, version, BACKGROUND_CONTEXT).then((pin) => {
-            if (entry.instance !== instance || entry.holders === 0) {
-                pin.release();
-                return;
-            }
-            const previous = entry.pin;
-            entry.pin = pin;
-            batch.within(() => entry.source.bind(pin.source), BACKGROUND_CONTEXT);
-            previous?.release();
-        }, (error) => {
-            if (entry.instance === instance) {
-                entry.instance = undefined;
-                entry.loading = undefined;
-                const failure = asChordError(error, target.label);
-                batch.within(() => entry.source.fail(failure, BACKGROUND_CONTEXT), BACKGROUND_CONTEXT);
-            }
-            throw error;
-        });
-        entry.loading = loading;
-        return loading;
-    }
-    /** One holder of `entry` left; the last drops it and its pin. */
-    #release(entry) {
-        if (--entry.holders > 0)
-            return;
-        const byKey = this.#entries.get(entry.member);
-        if (byKey?.get(entry.key) !== entry)
-            return;
-        byKey.delete(entry.key);
-        if (byKey.size === 0)
-            this.#entries.delete(entry.member);
-        // Its source ends: it leaves the document, whose other holders would keep it and its reference (Astra, GC).
-        const released = new ChordError({ code: "released", message: `${entry.member}.at(${entry.key}): released` });
-        const end = () => entry.source.end(released);
-        if (entry.source.inUse)
-            this.#holder.batch.within(end, BACKGROUND_CONTEXT);
-        else
-            end();
-        this.#unpin(entry);
-    }
-    /** Releases the pin `entry` follows or awaits: it points at nothing until pinned again. */
-    #unpin(entry) {
-        entry.pin?.release();
-        entry.pin = undefined;
-        entry.instance = undefined;
-        entry.loading = undefined;
-    }
-}
-//# sourceMappingURL=reference-keys.js.map

package/dist/next/host/reference-keys.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"reference-keys.js","sourceRoot":"","sources":["../../../src/next/host/reference-keys.ts"],"names":[],"mappings":"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","sourcesContent":["// The keys a reference holds (slice 6a §12; decision \"References are the only indirection\" (4)): its key watches and\n// its factory's pins (`at(key)`) of its object's keyed members, one source per member and key shared by them, pinned on\n// the object's live instance (loaded, mapped to the reference's version). While the object still follows the instance a\n// key is pinned on (a swap's old instance, a restart's drain, a live failure's admitted commits) the key follows it on,\n// as members do. When the reference moves to a new instance or a new object it pins the key there again, keeping the\n// last value until that pin loads, then one frame; while it points at nothing the key keeps its last value (one\n// `failed` call when its target failed, none while it loads).\n\nimport { awaitWithContext, BACKGROUND_CONTEXT, type Context } from \"../../context/index.ts\";\nimport { ChordError } from \"../data/index.ts\";\nimport { asChordError } from \"../data/internal.ts\";\nimport type { Batch } from \"../state/internal.ts\";\nimport type { PinnedKey } from \"./attempt.ts\";\nimport type { Target } from \"./reference.ts\";\nimport { ReferenceSource } from \"./reference-source.ts\";\n\n/** What a reference's keys need of it. */\nexport interface KeyHolder {\n\treadonly batch: Batch;\n\t/** Its contract version: keys are mapped to it. */\n\treadonly version: number;\n\t/** The object it is bound to; `undefined` while unbound. */\n\ttarget(): Target | undefined;\n\t/** What a read throws while a key never had a value. */\n\tnone(): ChordError;\n}\n\n/** One key of one keyed member held by the reference: its source, its users, and the instance pin it follows. */\ntype KeyEntry = {\n\treadonly member: string;\n\treadonly key: string;\n\treadonly source: ReferenceSource;\n\tholders: number;\n\t/** The live instance its pin is (or is being) taken on; `undefined` while it points at nothing. */\n\tinstance: unknown;\n\t/** The pin it follows. */\n\tpin: PinnedKey | undefined;\n\t/** The pin in flight, settled once the source follows it. */\n\tloading: Promise<void> | undefined;\n};\n\n/** A reference's held keys; every instance pin below them released exactly once. */\nexport class ReferenceKeys {\n\treadonly #holder: KeyHolder;\n\treadonly #entries = new Map<string, Map<string, KeyEntry>>();\n\n\tconstructor(holder: KeyHolder) {\n\t\tthis.#holder = holder;\n\t}\n\n\t/**\n\t * Holds `key` of keyed member `member`: its source once pinned and loaded on the live instance; `context` ends only\n\t * this caller's wait. `release` (once) lets it go with its last holder.\n\t */\n\tasync hold(member: string, key: string, context: Context): Promise<PinnedKey> {\n\t\tconst entry = this.#entry(member, key);\n\t\tentry.holders++;\n\t\tlet released = false;\n\t\tconst release = (): void => {\n\t\t\tif (released) return;\n\t\t\treleased = true;\n\t\t\tthis.#release(entry);\n\t\t};\n\t\ttry {\n\t\t\tif (entry.pin === undefined) await awaitWithContext(this.#pin(entry), context);\n\t\t} catch (error) {\n\t\t\trelease();\n\t\t\tthrow error;\n\t\t}\n\t\treturn { source: entry.source, release };\n\t}\n\n\t/**\n\t * Its reference's target changed, inside a batch: a key pins again on a new live instance (last value meanwhile);\n\t * while the target is not live it follows the instance it is pinned on as long as the object does (a commit admitted\n\t * there still shows), then keeps its last value (one `failed` call for a failure) and its pin goes.\n\t */\n\tfollow(context: Context): void {\n\t\tconst target = this.#holder.target();\n\t\tconst instance = target?.instance;\n\t\tconst attachable = target?.attachable;\n\t\tfor (const byKey of this.#entries.values()) {\n\t\t\tfor (const entry of byKey.values()) {\n\t\t\t\tif (instance !== undefined) {\n\t\t\t\t\t// A failed load shows on the key (`failed`); nobody waits on this pin.\n\t\t\t\t\tif (entry.instance !== instance) this.#pin(entry).catch(() => {});\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tif (attachable !== undefined && entry.instance === attachable) continue;\n\t\t\t\tconst state = target?.state;\n\t\t\t\tif (state?.kind === \"failed\") entry.source.fail(state.cause.error, context);\n\t\t\t\telse entry.source.hold();\n\t\t\t\tthis.#unpin(entry);\n\t\t\t}\n\t\t}\n\t}\n\n\t/** Its reference left its object (`error`: why it waits), inside a batch: keys keep their last values, pins go. */\n\tfail(error: ChordError, context: Context): void {\n\t\tfor (const byKey of this.#entries.values()) {\n\t\t\tfor (const entry of byKey.values()) {\n\t\t\t\tentry.source.fail(error, context);\n\t\t\t\tthis.#unpin(entry);\n\t\t\t}\n\t\t}\n\t}\n\n\t/** Its reference ended, inside a batch: every key ends with `error` and releases its pin. */\n\tend(error: ChordError): void {\n\t\tfor (const byKey of this.#entries.values()) {\n\t\t\tfor (const entry of byKey.values()) {\n\t\t\t\tentry.source.end(error);\n\t\t\t\tthis.#unpin(entry);\n\t\t\t}\n\t\t}\n\t\tthis.#entries.clear();\n\t}\n\n\t/** The entry of `member` and `key`, made by the first holder. */\n\t#entry(member: string, key: string): KeyEntry {\n\t\tlet byKey = this.#entries.get(member);\n\t\tif (byKey === undefined) {\n\t\t\tbyKey = new Map();\n\t\t\tthis.#entries.set(member, byKey);\n\t\t}\n\t\tlet entry = byKey.get(key);\n\t\tif (entry === undefined) {\n\t\t\tconst source = new ReferenceSource(this.#holder.batch, this.#holder);\n\t\t\tentry = { member, key, source, holders: 0, instance: undefined, pin: undefined, loading: undefined };\n\t\t\tbyKey.set(key, entry);\n\t\t}\n\t\treturn entry;\n\t}\n\n\t/**\n\t * Pins `entry`'s key on the target's live instance (once per instance): the source keeps its last value meanwhile,\n\t * follows the pin when it lands (one frame) and releases the previous one; a failed load shows as its failure.\n\t */\n\t#pin(entry: KeyEntry): Promise<void> {\n\t\tconst { batch, version } = this.#holder;\n\t\tconst target = this.#holder.target();\n\t\tconst instance = target?.instance;\n\t\tif (target === undefined || instance === undefined) return Promise.reject(this.#holder.none());\n\t\tif (entry.instance === instance && entry.loading !== undefined) return entry.loading;\n\t\tentry.instance = instance;\n\t\t// No frames from the old instance while the new one loads the key.\n\t\tentry.source.hold();\n\t\tconst loading = target.pinKey(entry.member, entry.key, version, BACKGROUND_CONTEXT).then(\n\t\t\t(pin) => {\n\t\t\t\tif (entry.instance !== instance || entry.holders === 0) {\n\t\t\t\t\tpin.release();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst previous = entry.pin;\n\t\t\t\tentry.pin = pin;\n\t\t\t\tbatch.within(() => entry.source.bind(pin.source), BACKGROUND_CONTEXT);\n\t\t\t\tprevious?.release();\n\t\t\t},\n\t\t\t(error: unknown) => {\n\t\t\t\tif (entry.instance === instance) {\n\t\t\t\t\tentry.instance = undefined;\n\t\t\t\t\tentry.loading = undefined;\n\t\t\t\t\tconst failure = asChordError(error, target.label);\n\t\t\t\t\tbatch.within(() => entry.source.fail(failure, BACKGROUND_CONTEXT), BACKGROUND_CONTEXT);\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t},\n\t\t);\n\t\tentry.loading = loading;\n\t\treturn loading;\n\t}\n\n\t/** One holder of `entry` left; the last drops it and its pin. */\n\t#release(entry: KeyEntry): void {\n\t\tif (--entry.holders > 0) return;\n\t\tconst byKey = this.#entries.get(entry.member);\n\t\tif (byKey?.get(entry.key) !== entry) return;\n\t\tbyKey.delete(entry.key);\n\t\tif (byKey.size === 0) this.#entries.delete(entry.member);\n\t\t// Its source ends: it leaves the document, whose other holders would keep it and its reference (Astra, GC).\n\t\tconst released = new ChordError({ code: \"released\", message: `${entry.member}.at(${entry.key}): released` });\n\t\tconst end = (): void => entry.source.end(released);\n\t\tif (entry.source.inUse) this.#holder.batch.within(end, BACKGROUND_CONTEXT);\n\t\telse end();\n\t\tthis.#unpin(entry);\n\t}\n\n\t/** Releases the pin `entry` follows or awaits: it points at nothing until pinned again. */\n\t#unpin(entry: KeyEntry): void {\n\t\tentry.pin?.release();\n\t\tentry.pin = undefined;\n\t\tentry.instance = undefined;\n\t\tentry.loading = undefined;\n\t}\n}\n"]}

package/dist/next/host/reference-source.d.ts

@@ -1,65 +0,0 @@
-import type { Context } from "../../context/index.ts";
-import type { JsonValue } from "../../json.ts";
-import { Watch } from "../../watch.ts";
-import type { ChordError } from "../data/index.ts";
-import { type Batch, type Dependent, type DeriveSource, Source, type Subscriber, type WatchStart } from "../state/internal.ts";
-/** A reference owning its sources: what a read of one that never had a value throws. */
-export interface SourceOwner {
-    none(): ChordError;
-}
-/**
- * One member (or key) of one reference. Bound, it is a dependent of the instance's member (its own dependents are
- * marked with it); its watches and subscribers subscribe to that member itself, so the member's frames reach them as
- * they are, and a derive member stays lazy while nothing follows it; holding or moving moves them.
- */
-export declare class ReferenceSource extends Source implements Dependent {
-    #private;
-    constructor(batch: Batch, owner: SourceOwner);
-    /** Whether it never had a value (a watch waits for its reference's values first). */
-    get unbound(): boolean;
-    get value(): JsonValue;
-    /** What a new watch starts at: the bound member's start, the held value (after its failure), or the failure. */
-    start(): WatchStart;
-    /**
-     * A watch subscribed to the bound member itself (as `Source.openWatch` starts one: on a failed member at its last
-     * good value, the failure first).
-     */
-    openWatch(context: Context): Watch<JsonValue>;
-    /** Whether anything follows it: a watch, a subscriber or a derive (moving or ending it then needs a batch). */
-    get inUse(): boolean;
-    /** Whether a watch or a subscriber follows it (through the bound member). */
-    get watched(): boolean;
-    /** Feeds `subscriber` the bound member's frames (it subscribes there) and the moves' frames. */
-    subscribe(subscriber: Subscriber): void;
-    /** As `Source.unsubscribe`. */
-    unsubscribe(subscriber: Subscriber): void;
-    /** The bound member changed: its dependents are marked (its frames reach the subscribers directly). */
-    invalidate(): void;
-    /** The bound member's document was retired: its dependents carry the flag on. */
-    sourceRetired(visited: Set<Dependent>): void;
-    /**
-     * Follows `source`, an instance's member, inside a batch: watches get one frame from the last value (a full one
-     * after a failure); derives downstream are marked and recompute, a failed one included (self-healing).
-     */
-    bind(source: DeriveSource): void;
-    /** Its target loads (a restart, a retry, a new object not live yet): it keeps its last value, and tells nothing. */
-    hold(): void;
-    /**
-     * Its target failed (`error`: its cause's, a refused version's, a removed type's), inside a batch: it keeps its last
-     * value, its watches and subscribers get one failure call (once per failure) and stay open.
-     */
-    fail(error: ChordError, context: Context): void;
-    /**
-     * Its target's live variant lacks the member, inside a batch: reads throw `error`; watches and subscribers get one
-     * failure call and stay open (a later instance may bring the member back, as `[["r", value]]`).
-     */
-    vanish(error: ChordError, context: Context): void;
-    /**
-     * Its reference ended, inside a batch: reads throw `error`, watches end `ended`, and derives over it are marked
-     * (their next read throws it, no cached value stays).
-     */
-    end(error: ChordError): void;
-    /** Delivers a move's frame: the diff from the watches' value to the new member's. */
-    deliver(context: Context): void;
-}
-//# sourceMappingURL=reference-source.d.ts.map

package/dist/next/host/reference-source.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"reference-source.d.ts","sourceRoot":"","sources":["../../../src/next/host/reference-source.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAiC,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EACN,KAAK,KAAK,EACV,KAAK,SAAS,EACd,KAAK,YAAY,EAEjB,MAAM,EACN,KAAK,UAAU,EACf,KAAK,UAAU,EACf,MAAM,sBAAsB,CAAC;AAgB9B,wFAAwF;AACxF,MAAM,WAAW,WAAW;IAC3B,IAAI,IAAI,UAAU,CAAC;CACnB;AAOD;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,MAAO,YAAW,SAAS;;IAY/D,YAAY,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAG3C;IAED,qFAAqF;IACrF,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,KAAK,IAAI,SAAS,CAarB;IAED,gHAAgH;IAChH,KAAK,IAAI,UAAU,CAgBlB;IAED;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAU5C;IAED,+GAA+G;IAC/G,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,6EAA6E;IAC7E,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,gGAAgG;IAChG,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAKtC;IAED,+BAA+B;IAC/B,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAIxC;IAED,uGAAuG;IACvG,UAAU,IAAI,IAAI,CAEjB;IAED,iFAAiF;IACjF,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,IAAI,CAE3C;IAED;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAS/B;IAED,oHAAoH;IACpH,IAAI,IAAI,IAAI,CAQX;IAED;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAa9C;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAQhD;IAED;;;OAGG;IACH,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAS3B;IAED,qFAAqF;IACrF,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgB9B;CAyDD"}

package/dist/next/host/reference-source.js

@@ -1,285 +0,0 @@
-// A reference's member as consumers follow it (decision "References are the only indirection", §7): a consumer's
-// watches and derives over `ref.member` (or a key of a keyed member) attach here, and this passes them straight through
-// to the object instance's own document or derive (its watches and subscribers subscribe there: no extra hop on
-// commits, the commit's value and ops by reference). When the reference's target moves to a new instance (or a new
-// object of its identity), it moves them and sends one frame, a diff from the last value; while it points at nothing it
-// keeps the last value (a pointer, no copy), with one `failed` call when its target failed (none while it loads).
-import { diffRevisions } from "../../delta/index.js";
-import { Watch } from "../../watch.js";
-import { handedOut, Source, } from "../state/internal.js";
-const ENDED = { kind: "ended" };
-/** No failure told: a held value's `failure` while its target loads. */
-const NO_FAILURE = undefined;
-/**
- * One member (or key) of one reference. Bound, it is a dependent of the instance's member (its own dependents are
- * marked with it); its watches and subscribers subscribe to that member itself, so the member's frames reach them as
- * they are, and a derive member stays lazy while nothing follows it; holding or moving moves them.
- */
-export class ReferenceSource extends Source {
-    #state = { kind: "unbound" };
-    /**
-     * Its watches and subscribers, each subscribed to the bound member while bound; held, they get nothing. Made by the
-     * first.
-     */
-    #passed;
-    /** What its watches had at a re-bind (`undefined` for no value: they had a failure), until the re-bind's frame. */
-    #framed;
-    /** Its reference: what a read throws while it never had a value (its failure, `not_ready`, or `released`). */
-    #owner;
-    constructor(batch, owner) {
-        super(batch);
-        this.#owner = owner;
-    }
-    /** Whether it never had a value (a watch waits for its reference's values first). */
-    get unbound() {
-        return this.#state.kind === "unbound";
-    }
-    get value() {
-        const state = this.#state;
-        switch (state.kind) {
-            case "bound":
-                return state.source.value;
-            case "held":
-                // A derive over a failed reference's member computes on its last value too (owner, G2: A).
-                return state.value;
-            case "unbound":
-                throw this.#owner.none();
-            default:
-                throw state.error;
-        }
-    }
-    /** What a new watch starts at: the bound member's start, the held value (after its failure), or the failure. */
-    start() {
-        const state = this.#state;
-        switch (state.kind) {
-            case "bound":
-                return state.source instanceof Source ? state.source.start() : { kind: "value", value: state.source.value };
-            case "held":
-                return state.failure === NO_FAILURE
-                    ? { kind: "value", value: state.value }
-                    : { kind: "failed", error: state.failure, last: state.value };
-            case "failed":
-                return { kind: "failed", error: state.error, last: state.last };
-            case "unbound":
-                throw this.#owner.none();
-            case "ended":
-                throw state.error;
-        }
-    }
-    /**
-     * A watch subscribed to the bound member itself (as `Source.openWatch` starts one: on a failed member at its last
-     * good value, the failure first).
-     */
-    openWatch(context) {
-        this.batch.assertOutside("watch");
-        const start = this.start();
-        if (start.kind === "failed" && start.last === undefined)
-            throw start.error;
-        const value = start.kind === "value" ? start.value : start.last;
-        const watch = new Watch(value, () => this.unsubscribe(watch), this.batch.reportListener);
-        this.subscribe(watch);
-        if (context.abortSignal !== undefined)
-            watch.observeAbort(context.abortSignal);
-        if (start.kind === "failed")
-            watch.fail(handedOut(start.error), context);
-        return watch;
-    }
-    /** Whether anything follows it: a watch, a subscriber or a derive (moving or ending it then needs a batch). */
-    get inUse() {
-        return this.watched || this.dependents.size > 0;
-    }
-    /** Whether a watch or a subscriber follows it (through the bound member). */
-    get watched() {
-        return (this.#passed?.size ?? 0) > 0;
-    }
-    /** Feeds `subscriber` the bound member's frames (it subscribes there) and the moves' frames. */
-    subscribe(subscriber) {
-        this.#passed ??= new Set();
-        this.#passed.add(subscriber);
-        const state = this.#state;
-        if (state.kind === "bound" && state.source instanceof Source)
-            state.source.subscribe(subscriber);
-    }
-    /** As `Source.unsubscribe`. */
-    unsubscribe(subscriber) {
-        this.#passed?.delete(subscriber);
-        const state = this.#state;
-        if (state.kind === "bound" && state.source instanceof Source)
-            state.source.unsubscribe(subscriber);
-    }
-    /** The bound member changed: its dependents are marked (its frames reach the subscribers directly). */
-    invalidate() {
-        for (const dependent of this.dependents)
-            dependent.invalidate();
-    }
-    /** The bound member's document was retired: its dependents carry the flag on. */
-    sourceRetired(visited) {
-        for (const dependent of this.dependents)
-            dependent.sourceRetired(visited);
-    }
-    /**
-     * Follows `source`, an instance's member, inside a batch: watches get one frame from the last value (a full one
-     * after a failure); derives downstream are marked and recompute, a failed one included (self-healing).
-     */
-    bind(source) {
-        const state = this.#state;
-        if (state.kind === "ended" || (state.kind === "bound" && state.source === source))
-            return;
-        this.#leave();
-        if (this.watched)
-            this.#framed = { value: this.#shown() };
-        this.#state = { kind: "bound", source };
-        this.#hook(source);
-        // Marks the derives downstream: a failed one recomputes too (self-healing).
-        this.changed();
-    }
-    /** Its target loads (a restart, a retry, a new object not live yet): it keeps its last value, and tells nothing. */
-    hold() {
-        const state = this.#state;
-        if (state.kind === "held") {
-            // Its watches had the failure: the next value stays whole (`told`).
-            if (state.failure !== NO_FAILURE)
-                this.#state = { ...state, failure: NO_FAILURE };
-            return;
-        }
-        if (state.kind === "bound")
-            this.#keep(NO_FAILURE);
-    }
-    /**
-     * Its target failed (`error`: its cause's, a refused version's, a removed type's), inside a batch: it keeps its last
-     * value, its watches and subscribers get one failure call (once per failure) and stay open.
-     */
-    fail(error, context) {
-        // Kept: its stack made text now, so it keeps none of the failed instance's frames.
-        handedOut(error);
-        const state = this.#state;
-        if (state.kind === "held") {
-            if (state.failure !== NO_FAILURE)
-                return;
-            this.#state = { kind: "held", value: state.value, failure: error, told: true };
-        }
-        else if (state.kind === "bound") {
-            if (!this.#keep(error))
-                return;
-        }
-        else {
-            return;
-        }
-        this.#call({ kind: "failed", error }, context);
-    }
-    /**
-     * Its target's live variant lacks the member, inside a batch: reads throw `error`; watches and subscribers get one
-     * failure call and stay open (a later instance may bring the member back, as `[["r", value]]`).
-     */
-    vanish(error, context) {
-        const state = this.#state;
-        if (state.kind === "ended")
-            return;
-        const last = state.kind === "unbound" ? undefined : this.#lastGood();
-        this.#leave();
-        this.#state = { kind: "failed", error: handedOut(error), last };
-        this.#call({ kind: "failed", error }, context);
-        this.changed();
-    }
-    /**
-     * Its reference ended, inside a batch: reads throw `error`, watches end `ended`, and derives over it are marked
-     * (their next read throws it, no cached value stays).
-     */
-    end(error) {
-        this.#leave();
-        this.#state = { kind: "ended", error };
-        this.#framed = undefined;
-        // A copy: an ending watch unsubscribes itself.
-        const passed = this.#passed;
-        this.#passed = undefined;
-        if (passed !== undefined)
-            for (const subscriber of [...passed])
-                subscriber.end(ENDED);
-        for (const dependent of this.dependents)
-            dependent.invalidate();
-    }
-    /** Delivers a move's frame: the diff from the watches' value to the new member's. */
-    deliver(context) {
-        const framed = this.#framed;
-        this.#framed = undefined;
-        if (framed === undefined)
-            return;
-        let after;
-        try {
-            after = this.value;
-        }
-        catch (error) {
-            if (framed.value !== undefined)
-                this.#call({ kind: "failed", error: handedOut(error) }, context);
-            return;
-        }
-        const before = framed.value;
-        if (after === before)
-            return;
-        // After a failure (no value framed): whole, even when unchanged.
-        const ops = before === undefined ? [["r", after]] : diffRevisions(before, after);
-        if (ops.length > 0)
-            this.#call({ kind: "value", value: after, ops, retired: false }, context);
-    }
-    /**
-     * Stops following the bound member and keeps its value (`failure`: the failure it is held with); a member whose value
-     * throws becomes failed. Whether it holds a value.
-     */
-    #keep(failure) {
-        const state = this.#state;
-        const start = state.source instanceof Source ? state.source.start() : undefined;
-        this.#leave();
-        if (start === undefined || start.kind === "value") {
-            const value = start === undefined ? state.source.value : start.value;
-            this.#state = { kind: "held", value, failure, told: failure !== NO_FAILURE };
-            return true;
-        }
-        this.#state = { kind: "failed", error: handedOut(start.error), last: start.last };
-        return false;
-    }
-    /** A call of its own (a move's frame, a failure) to its watches and subscribers. */
-    #call(call, context) {
-        if (this.#passed !== undefined)
-            for (const subscriber of this.#passed)
-                subscriber.advance(call, context);
-    }
-    /**
-     * The value its watches have before a move; `undefined` when they had a failure since it (their next value is whole,
-     * `[["r", value]]`, even when unchanged).
-     */
-    #shown() {
-        const state = this.#state;
-        if (state.kind === "unbound" || (state.kind === "held" && state.told))
-            return undefined;
-        const start = this.start();
-        return start.kind === "value" ? start.value : undefined;
-    }
-    /** Its last good value, which watches opened while it is failed start at; `undefined` when it never had one. */
-    #lastGood() {
-        const start = this.start();
-        return start.kind === "value" ? start.value : start.last;
-    }
-    /** Starts reading `source`: its changes mark this source's dependents, its frames reach the subscribers. */
-    #hook(source) {
-        if (!(source instanceof Source))
-            return;
-        source.dependents.add(this);
-        if (this.#passed !== undefined)
-            for (const subscriber of this.#passed)
-                source.subscribe(subscriber);
-    }
-    /** Stops following the bound source, when bound: no more marks or frames from it. */
-    #leave() {
-        const state = this.#state;
-        if (state.kind !== "bound")
-            return;
-        const { source } = state;
-        if (!(source instanceof Source))
-            return;
-        source.dependents.delete(this);
-        if (this.#passed !== undefined)
-            for (const subscriber of this.#passed)
-                source.unsubscribe(subscriber);
-    }
-}
-//# sourceMappingURL=reference-source.js.map

package/dist/next/host/reference-source.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"reference-source.js","sourceRoot":"","sources":["../../../src/next/host/reference-source.ts"],"names":[],"mappings":"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","sourcesContent":["// A reference's member as consumers follow it (decision \"References are the only indirection\", §7): a consumer's\n// watches and derives over `ref.member` (or a key of a keyed member) attach here, and this passes them straight through\n// to the object instance's own document or derive (its watches and subscribers subscribe there: no extra hop on\n// commits, the commit's value and ops by reference). When the reference's target moves to a new instance (or a new\n// object of its identity), it moves them and sends one frame, a diff from the last value; while it points at nothing it\n// keeps the last value (a pointer, no copy), with one `failed` call when its target failed (none while it loads).\n\nimport type { Context } from \"../../context/index.ts\";\nimport { diffRevisions, type Op } from \"../../delta/index.ts\";\nimport type { JsonValue } from \"../../json.ts\";\nimport { Watch, type WatchCall, type WatchEnd } from \"../../watch.ts\";\nimport type { ChordError } from \"../data/index.ts\";\nimport {\n\ttype Batch,\n\ttype Dependent,\n\ttype DeriveSource,\n\thandedOut,\n\tSource,\n\ttype Subscriber,\n\ttype WatchStart,\n} from \"../state/internal.ts\";\n\n/**\n * Where a reference's source stands: never had a value (`unbound`: reads throw what its reference has instead),\n * following an instance's member, holding its last value while pointing at nothing (`failure` while its target is\n * failed: new watches start with it; `told`: its watches got a failure since that value, so the next is whole), failed\n * (a member its target's live variant lacks, or its compute threw when it was held: reads throw, `last` is the last\n * good value) or ended with its reference (nothing kept).\n */\ntype SourceState =\n\t| { readonly kind: \"unbound\" }\n\t| { readonly kind: \"bound\"; readonly source: DeriveSource }\n\t| { readonly kind: \"held\"; readonly value: JsonValue; readonly failure: unknown; readonly told: boolean }\n\t| { readonly kind: \"failed\"; readonly error: unknown; readonly last: JsonValue | undefined }\n\t| { readonly kind: \"ended\"; readonly error: ChordError };\n\n/** A reference owning its sources: what a read of one that never had a value throws. */\nexport interface SourceOwner {\n\tnone(): ChordError;\n}\n\nconst ENDED: WatchEnd = { kind: \"ended\" };\n\n/** No failure told: a held value's `failure` while its target loads. */\nconst NO_FAILURE = undefined;\n\n/**\n * One member (or key) of one reference. Bound, it is a dependent of the instance's member (its own dependents are\n * marked with it); its watches and subscribers subscribe to that member itself, so the member's frames reach them as\n * they are, and a derive member stays lazy while nothing follows it; holding or moving moves them.\n */\nexport class ReferenceSource extends Source implements Dependent {\n\t#state: SourceState = { kind: \"unbound\" };\n\t/**\n\t * Its watches and subscribers, each subscribed to the bound member while bound; held, they get nothing. Made by the\n\t * first.\n\t */\n\t#passed: Set<Subscriber> | undefined;\n\t/** What its watches had at a re-bind (`undefined` for no value: they had a failure), until the re-bind's frame. */\n\t#framed: { readonly value: JsonValue | undefined } | undefined;\n\t/** Its reference: what a read throws while it never had a value (its failure, `not_ready`, or `released`). */\n\treadonly #owner: SourceOwner;\n\n\tconstructor(batch: Batch, owner: SourceOwner) {\n\t\tsuper(batch);\n\t\tthis.#owner = owner;\n\t}\n\n\t/** Whether it never had a value (a watch waits for its reference's values first). */\n\tget unbound(): boolean {\n\t\treturn this.#state.kind === \"unbound\";\n\t}\n\n\tget value(): JsonValue {\n\t\tconst state = this.#state;\n\t\tswitch (state.kind) {\n\t\t\tcase \"bound\":\n\t\t\t\treturn state.source.value;\n\t\t\tcase \"held\":\n\t\t\t\t// A derive over a failed reference's member computes on its last value too (owner, G2: A).\n\t\t\t\treturn state.value;\n\t\t\tcase \"unbound\":\n\t\t\t\tthrow this.#owner.none();\n\t\t\tdefault:\n\t\t\t\tthrow state.error;\n\t\t}\n\t}\n\n\t/** What a new watch starts at: the bound member's start, the held value (after its failure), or the failure. */\n\tstart(): WatchStart {\n\t\tconst state = this.#state;\n\t\tswitch (state.kind) {\n\t\t\tcase \"bound\":\n\t\t\t\treturn state.source instanceof Source ? state.source.start() : { kind: \"value\", value: state.source.value };\n\t\t\tcase \"held\":\n\t\t\t\treturn state.failure === NO_FAILURE\n\t\t\t\t\t? { kind: \"value\", value: state.value }\n\t\t\t\t\t: { kind: \"failed\", error: state.failure, last: state.value };\n\t\t\tcase \"failed\":\n\t\t\t\treturn { kind: \"failed\", error: state.error, last: state.last };\n\t\t\tcase \"unbound\":\n\t\t\t\tthrow this.#owner.none();\n\t\t\tcase \"ended\":\n\t\t\t\tthrow state.error;\n\t\t}\n\t}\n\n\t/**\n\t * A watch subscribed to the bound member itself (as `Source.openWatch` starts one: on a failed member at its last\n\t * good value, the failure first).\n\t */\n\topenWatch(context: Context): Watch<JsonValue> {\n\t\tthis.batch.assertOutside(\"watch\");\n\t\tconst start = this.start();\n\t\tif (start.kind === \"failed\" && start.last === undefined) throw start.error;\n\t\tconst value = start.kind === \"value\" ? start.value : start.last!;\n\t\tconst watch: Watch<JsonValue> = new Watch(value, () => this.unsubscribe(watch), this.batch.reportListener);\n\t\tthis.subscribe(watch);\n\t\tif (context.abortSignal !== undefined) watch.observeAbort(context.abortSignal);\n\t\tif (start.kind === \"failed\") watch.fail(handedOut(start.error), context);\n\t\treturn watch;\n\t}\n\n\t/** Whether anything follows it: a watch, a subscriber or a derive (moving or ending it then needs a batch). */\n\tget inUse(): boolean {\n\t\treturn this.watched || this.dependents.size > 0;\n\t}\n\n\t/** Whether a watch or a subscriber follows it (through the bound member). */\n\tget watched(): boolean {\n\t\treturn (this.#passed?.size ?? 0) > 0;\n\t}\n\n\t/** Feeds `subscriber` the bound member's frames (it subscribes there) and the moves' frames. */\n\tsubscribe(subscriber: Subscriber): void {\n\t\tthis.#passed ??= new Set();\n\t\tthis.#passed.add(subscriber);\n\t\tconst state = this.#state;\n\t\tif (state.kind === \"bound\" && state.source instanceof Source) state.source.subscribe(subscriber);\n\t}\n\n\t/** As `Source.unsubscribe`. */\n\tunsubscribe(subscriber: Subscriber): void {\n\t\tthis.#passed?.delete(subscriber);\n\t\tconst state = this.#state;\n\t\tif (state.kind === \"bound\" && state.source instanceof Source) state.source.unsubscribe(subscriber);\n\t}\n\n\t/** The bound member changed: its dependents are marked (its frames reach the subscribers directly). */\n\tinvalidate(): void {\n\t\tfor (const dependent of this.dependents) dependent.invalidate();\n\t}\n\n\t/** The bound member's document was retired: its dependents carry the flag on. */\n\tsourceRetired(visited: Set<Dependent>): void {\n\t\tfor (const dependent of this.dependents) dependent.sourceRetired(visited);\n\t}\n\n\t/**\n\t * Follows `source`, an instance's member, inside a batch: watches get one frame from the last value (a full one\n\t * after a failure); derives downstream are marked and recompute, a failed one included (self-healing).\n\t */\n\tbind(source: DeriveSource): void {\n\t\tconst state = this.#state;\n\t\tif (state.kind === \"ended\" || (state.kind === \"bound\" && state.source === source)) return;\n\t\tthis.#leave();\n\t\tif (this.watched) this.#framed = { value: this.#shown() };\n\t\tthis.#state = { kind: \"bound\", source };\n\t\tthis.#hook(source);\n\t\t// Marks the derives downstream: a failed one recomputes too (self-healing).\n\t\tthis.changed();\n\t}\n\n\t/** Its target loads (a restart, a retry, a new object not live yet): it keeps its last value, and tells nothing. */\n\thold(): void {\n\t\tconst state = this.#state;\n\t\tif (state.kind === \"held\") {\n\t\t\t// Its watches had the failure: the next value stays whole (`told`).\n\t\t\tif (state.failure !== NO_FAILURE) this.#state = { ...state, failure: NO_FAILURE };\n\t\t\treturn;\n\t\t}\n\t\tif (state.kind === \"bound\") this.#keep(NO_FAILURE);\n\t}\n\n\t/**\n\t * Its target failed (`error`: its cause's, a refused version's, a removed type's), inside a batch: it keeps its last\n\t * value, its watches and subscribers get one failure call (once per failure) and stay open.\n\t */\n\tfail(error: ChordError, context: Context): void {\n\t\t// Kept: its stack made text now, so it keeps none of the failed instance's frames.\n\t\thandedOut(error);\n\t\tconst state = this.#state;\n\t\tif (state.kind === \"held\") {\n\t\t\tif (state.failure !== NO_FAILURE) return;\n\t\t\tthis.#state = { kind: \"held\", value: state.value, failure: error, told: true };\n\t\t} else if (state.kind === \"bound\") {\n\t\t\tif (!this.#keep(error)) return;\n\t\t} else {\n\t\t\treturn;\n\t\t}\n\t\tthis.#call({ kind: \"failed\", error }, context);\n\t}\n\n\t/**\n\t * Its target's live variant lacks the member, inside a batch: reads throw `error`; watches and subscribers get one\n\t * failure call and stay open (a later instance may bring the member back, as `[[\"r\", value]]`).\n\t */\n\tvanish(error: ChordError, context: Context): void {\n\t\tconst state = this.#state;\n\t\tif (state.kind === \"ended\") return;\n\t\tconst last = state.kind === \"unbound\" ? undefined : this.#lastGood();\n\t\tthis.#leave();\n\t\tthis.#state = { kind: \"failed\", error: handedOut(error), last };\n\t\tthis.#call({ kind: \"failed\", error }, context);\n\t\tthis.changed();\n\t}\n\n\t/**\n\t * Its reference ended, inside a batch: reads throw `error`, watches end `ended`, and derives over it are marked\n\t * (their next read throws it, no cached value stays).\n\t */\n\tend(error: ChordError): void {\n\t\tthis.#leave();\n\t\tthis.#state = { kind: \"ended\", error };\n\t\tthis.#framed = undefined;\n\t\t// A copy: an ending watch unsubscribes itself.\n\t\tconst passed = this.#passed;\n\t\tthis.#passed = undefined;\n\t\tif (passed !== undefined) for (const subscriber of [...passed]) subscriber.end(ENDED);\n\t\tfor (const dependent of this.dependents) dependent.invalidate();\n\t}\n\n\t/** Delivers a move's frame: the diff from the watches' value to the new member's. */\n\tdeliver(context: Context): void {\n\t\tconst framed = this.#framed;\n\t\tthis.#framed = undefined;\n\t\tif (framed === undefined) return;\n\t\tlet after: JsonValue;\n\t\ttry {\n\t\t\tafter = this.value;\n\t\t} catch (error) {\n\t\t\tif (framed.value !== undefined) this.#call({ kind: \"failed\", error: handedOut(error) }, context);\n\t\t\treturn;\n\t\t}\n\t\tconst before = framed.value;\n\t\tif (after === before) return;\n\t\t// After a failure (no value framed): whole, even when unchanged.\n\t\tconst ops: readonly Op[] = before === undefined ? [[\"r\", after]] : diffRevisions(before, after);\n\t\tif (ops.length > 0) this.#call({ kind: \"value\", value: after, ops, retired: false }, context);\n\t}\n\n\t/**\n\t * Stops following the bound member and keeps its value (`failure`: the failure it is held with); a member whose value\n\t * throws becomes failed. Whether it holds a value.\n\t */\n\t#keep(failure: unknown): boolean {\n\t\tconst state = this.#state as Extract<SourceState, { readonly kind: \"bound\" }>;\n\t\tconst start = state.source instanceof Source ? state.source.start() : undefined;\n\t\tthis.#leave();\n\t\tif (start === undefined || start.kind === \"value\") {\n\t\t\tconst value = start === undefined ? state.source.value : start.value;\n\t\t\tthis.#state = { kind: \"held\", value, failure, told: failure !== NO_FAILURE };\n\t\t\treturn true;\n\t\t}\n\t\tthis.#state = { kind: \"failed\", error: handedOut(start.error), last: start.last };\n\t\treturn false;\n\t}\n\n\t/** A call of its own (a move's frame, a failure) to its watches and subscribers. */\n\t#call(call: WatchCall<JsonValue>, context: Context): void {\n\t\tif (this.#passed !== undefined) for (const subscriber of this.#passed) subscriber.advance(call, context);\n\t}\n\n\t/**\n\t * The value its watches have before a move; `undefined` when they had a failure since it (their next value is whole,\n\t * `[[\"r\", value]]`, even when unchanged).\n\t */\n\t#shown(): JsonValue | undefined {\n\t\tconst state = this.#state;\n\t\tif (state.kind === \"unbound\" || (state.kind === \"held\" && state.told)) return undefined;\n\t\tconst start = this.start();\n\t\treturn start.kind === \"value\" ? start.value : undefined;\n\t}\n\n\t/** Its last good value, which watches opened while it is failed start at; `undefined` when it never had one. */\n\t#lastGood(): JsonValue | undefined {\n\t\tconst start = this.start();\n\t\treturn start.kind === \"value\" ? start.value : start.last;\n\t}\n\n\t/** Starts reading `source`: its changes mark this source's dependents, its frames reach the subscribers. */\n\t#hook(source: DeriveSource): void {\n\t\tif (!(source instanceof Source)) return;\n\t\tsource.dependents.add(this);\n\t\tif (this.#passed !== undefined) for (const subscriber of this.#passed) source.subscribe(subscriber);\n\t}\n\n\t/** Stops following the bound source, when bound: no more marks or frames from it. */\n\t#leave(): void {\n\t\tconst state = this.#state;\n\t\tif (state.kind !== \"bound\") return;\n\t\tconst { source } = state;\n\t\tif (!(source instanceof Source)) return;\n\t\tsource.dependents.delete(this);\n\t\tif (this.#passed !== undefined) for (const subscriber of this.#passed) source.unsubscribe(subscriber);\n\t}\n}\n"]}