@earendil-works/chord 1.4.0 → 1.5.1

package/dist/tui/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/tui/runtime.ts"],"names":[],"mappings":"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","sourcesContent":["// `startTerminalRuntime` (slice 11 §4, decisions \"Slice 11, P8\" and \"P9\"): the terminal client inside the sandbox, in\n// the app's terminal entry (the base bundle the launcher downloaded). A client host like a page's: the plugin scripts\n// the launcher brought, loaded with the app's core facets and the kit's themes and translations; the language followed\n// from the user's pick and the system's locales the launcher read (scopes' messages redraw on a change); the link to\n// the server relayed by the launcher, kept by the same connection loop; `TuiScripts` followed to apply new plugin\n// scripts in place; a new base bundle hands over to the launcher, which starts the new one. The app gets the host, the\n// bridged terminal, the theme lookup and the launcher's actions.\n\nimport { BACKGROUND_CONTEXT } from \"../context/index.ts\";\nimport type { Principal } from \"../data/index.ts\";\nimport type { PluginFacet } from \"../host/index.ts\";\nimport {\n\ttype Client,\n\ttype ClientError,\n\ttype ClientModules,\n\ttype ConnectionState,\n\tFALLBACK_THEMES,\n\ttype FacetFunction,\n\tfollowActiveLanguage,\n\tfollowActiveTheme,\n\tREGISTER,\n\ttype RegisteredScript,\n\tstartClient,\n\tTuiScripts,\n\tthemesFacet,\n\ttranslationsFacet,\n} from \"../surfaces/index.ts\";\nimport { BRIDGE, type Bridge } from \"./bridge.ts\";\nimport { SandboxChannel } from \"./channel.ts\";\nimport { BridgeTerminal } from \"./terminal.ts\";\nimport { TerminalTheme } from \"./theme.ts\";\n\n/** What `startTerminalRuntime` takes. */\nexport type TerminalRuntimeOptions<P extends Principal> = {\n\t/** The modules the terminal plugins import, by specifier: the app's API modules for the kind, its components. */\n\treadonly modules: ClientModules;\n\t/** The app's own terminal facets. */\n\treadonly core?: readonly PluginFacet<P>[];\n\treadonly canRetry?: () => Promise<boolean>;\n\treadonly onConnection?: (state: ConnectionState) => void;\n\t/** Draws the app, once its plugins are loaded. */\n\treadonly render: (runtime: TerminalRuntime<P>) => void;\n\t/**\n\t * Plugins left out or kept old, a failed update, the host's errors, messages' reports; dropped by default (stderr\n\t * is the launcher's).\n\t */\n\treadonly onError?: (error: ClientError) => void;\n};\n\n/** A file the launcher read for the sandbox: its name (the path's last segment) and its bytes. */\nexport type AttachedFile = { readonly name: string; readonly bytes: Uint8Array };\n\n/** What the app's terminal code gets. */\nexport type TerminalRuntime<P extends Principal> = {\n\treadonly host: Client<P>[\"host\"];\n\treadonly terminal: BridgeTerminal;\n\treadonly theme: TerminalTheme;\n\t/** Asks the launcher to copy `text` to the machine's clipboard; it asks the user. Whether it was done. */\n\tcopy(text: string): Promise<boolean>;\n\t/** Asks the launcher to open `url` (http or https) in a browser; it asks the user. Whether it was done. */\n\topen(url: string): Promise<boolean>;\n\t/**\n\t * Asks the launcher for the file at `path` on the machine (at most 16 MiB); it asks the user. Its name and bytes, or\n\t * `undefined` when declined.\n\t */\n\tattach(path: string): Promise<AttachedFile | undefined>;\n\t/** Ends the terminal client with `code`. */\n\texit(code: number): void;\n};\n\n/** Starts the terminal client inside the sandbox; resolves with its runtime once rendered. */\nexport async function startTerminalRuntime<P extends Principal>(\n\toptions: TerminalRuntimeOptions<P>,\n): Promise<TerminalRuntime<P>> {\n\tconst channel = new SandboxChannel(takeBridge());\n\tconst { start } = channel;\n\tconst scripts = new SandboxScripts(channel);\n\tconst core: PluginFacet<P>[] = [\n\t\t{ name: \"chord.themes\", facet: themesFacet<P>() },\n\t\t{ name: \"chord.translations\", facet: translationsFacet<P>() },\n\t\t...(options.core ?? []),\n\t];\n\tconst onError = options.onError ?? (() => {});\n\tconst client = await startClient<P>({\n\t\tscripts: TuiScripts,\n\t\tbase: start.base,\n\t\tinitial: scripts.run(start.combined),\n\t\tmodules: options.modules,\n\t\tcore,\n\t\topen: (events) => channel.openSocket(events),\n\t\tfetchScript: async (entry) => {\n\t\t\tconst text = (await channel.request({ kind: \"fetch\", path: entry.url })) as string;\n\t\t\tconst registered = scripts\n\t\t\t\t.run(text)\n\t\t\t\t.find(({ plugin, digest }) => plugin === entry.name && digest === entry.digest);\n\t\t\tif (registered === undefined) throw new Error(`plugin \"${entry.name}\": ${entry.url} did not register`);\n\t\t\treturn registered;\n\t\t},\n\t\tserverBase: () =>\n\t\t\tchannel.request({ kind: \"base\" }).then(\n\t\t\t\t(base) => base as string,\n\t\t\t\t() => undefined,\n\t\t\t),\n\t\toutdated: () => channel.outdated(),\n\t\t...(options.canRetry === undefined ? {} : { canRetry: options.canRetry }),\n\t\t...(options.onConnection === undefined ? {} : { onConnection: options.onConnection }),\n\t\tenvironment: TERMINAL_ENVIRONMENT,\n\t\tonError,\n\t});\n\tconst theme = new TerminalTheme(FALLBACK_THEMES[start.mode], start.colors);\n\tawait followActiveTheme(client.host, start.mode, (active) => theme.set(active), BACKGROUND_CONTEXT);\n\tawait followActiveLanguage(\n\t\tclient.host,\n\t\tstart.locales,\n\t\t() => {},\n\t\t(report) => onError({ kind: \"messages\", report }),\n\t\tBACKGROUND_CONTEXT,\n\t);\n\tconst runtime: TerminalRuntime<P> = {\n\t\thost: client.host,\n\t\tterminal: new BridgeTerminal(channel),\n\t\ttheme,\n\t\tcopy: (text) => channel.request({ kind: \"copy\", text }).then(Boolean),\n\t\topen: (url) => channel.request({ kind: \"open\", url }).then(Boolean),\n\t\t// The launcher's reply: its own data, `null` when declined.\n\t\tattach: (path) =>\n\t\t\tchannel.request({ kind: \"attach\", path }).then((file) => (file as AttachedFile | null) ?? undefined),\n\t\texit: (code) => channel.exit(code),\n\t};\n\toptions.render(runtime);\n\treturn runtime;\n}\n\n/** The bridge the bootstrap left on `globalThis`, taken off it (plugin code never finds it there). */\nfunction takeBridge(): Bridge {\n\tconst scope = globalThis as Record<string, unknown>;\n\tconst bridge = scope[BRIDGE] as Bridge | undefined;\n\tif (bridge === undefined) throw new Error(\"startTerminalRuntime: not inside the terminal's sandbox (no bridge)\");\n\tdelete scope[BRIDGE];\n\treturn bridge;\n}\n\n/** A terminal has no page wakes: the loop retries on its backoff alone. */\nconst TERMINAL_ENVIRONMENT = {\n\tnow: () => Date.now(),\n\tafter: (ms: number, callback: () => void) => {\n\t\tconst timer = setTimeout(callback, ms);\n\t\treturn () => clearTimeout(timer);\n\t},\n\tonline: () => true,\n\tonWake: () => () => {},\n};\n\n/** Runs registered scripts' text in the sandbox and collects what registered (`chordFacet`). */\nclass SandboxScripts {\n\treadonly #channel: SandboxChannel;\n\t/** The scripts the text being run registers. */\n\t#collected: RegisteredScript[] = [];\n\n\tconstructor(channel: SandboxChannel) {\n\t\tthis.#channel = channel;\n\t\t(globalThis as Record<string, unknown>)[REGISTER] = (plugin: string, digest: string, run: FacetFunction) => {\n\t\t\tthis.#collected.push({ plugin, digest, run });\n\t\t};\n\t}\n\n\t/** Runs `text` (one or more registered scripts): what it registered. */\n\trun(text: string): RegisteredScript[] {\n\t\tthis.#collected = [];\n\t\tthis.#channel.evaluate(text, \"chord-plugins.js\");\n\t\treturn this.#collected;\n\t}\n}\n"]}

package/dist/tui/scope.d.ts

@@ -0,0 +1,46 @@
+import type { Contract, ParamsOf } from "../contracts/index.ts";
+import type { Principal } from "../data/index.ts";
+import type { Held, Host } from "../host/index.ts";
+import type { Registry } from "../registries/index.ts";
+import { type Messages, type Translator } from "../surfaces/index.ts";
+import { type PageState } from "../surfaces/page-state.ts";
+import type { NativeWatchable, Watchable } from "../watch.ts";
+/** Adds an optimistic action shown while `call` is in flight; returns `call` (see `TuiScope.optimistic`). */
+export type OptimisticAdd<A> = <R>(action: A, call: Promise<R>) => Promise<R>;
+/** A component's scope: what it holds and follows, until `dispose`. */
+export declare class TuiScope<P extends Principal = Principal> {
+    #private;
+    constructor(host: Host<P>, changed: () => void);
+    /** A reference to `Type` with `params`, held until `dispose`; its state changes call `changed`. */
+    hold<C extends Contract>(Type: C, params: ParamsOf<C>): Held<C>;
+    /**
+     * Follows `source` (a member, a derive, `ref.state`) until `dispose`: its changes call `changed`. Returns a reader of
+     * its current value (`undefined` while it has none: nothing throws in a redraw).
+     */
+    watch<T>(source: Watchable<T> | NativeWatchable<T>): () => T | undefined;
+    /** Registry `R`'s composed value, followed until `dispose`; a reader, `undefined` until it is usable. */
+    registry<C, V>(R: Registry<C, V>): () => V | undefined;
+    /**
+     * `read` with optimistic values, as React's `useOptimistic`: `add(action, call)` returns `call` and, until every call
+     * added so settled, the reader shows `reduce(current, action)` applied over `read`'s value for each action in flight,
+     * in order (without `reduce`, the last action is the value); then `read`'s again. `pending` says a call is in flight.
+     * Each change calls `changed`. A call over a link settles after the changes its answering host committed before
+     * answering (decision "A call's answer follows its state"), so the value shown next is the real one. A rejected
+     * call is its caller's to handle (React leaves it to the transition); its action goes as a resolved one's does.
+     */
+    optimistic<T>(read: () => T): readonly [read: () => T, add: OptimisticAdd<T>, pending: () => boolean];
+    optimistic<T, A>(read: () => T, reduce: (current: T, action: A) => T): readonly [read: () => T, add: OptimisticAdd<A>, pending: () => boolean];
+    /**
+     * The host's page state at `key`, kept for the terminal's life, not the scope's (a new key starts at `initial`); its
+     * changes call `changed` until `dispose`.
+     */
+    pageState<T>(key: string, initial: T): PageState<T>;
+    /**
+     * `messages` in the host's language as it is at each call (the first catalog before the host follows one); a change
+     * of the locale or a translation calls `changed` until `dispose`.
+     */
+    messages<N extends string, M>(messages: Messages<N, M>): Translator<N, M>;
+    /** Releases every reference and ends every watch; `changed` is not called after it. */
+    dispose(): void;
+}
+//# sourceMappingURL=scope.d.ts.map

package/dist/tui/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/tui/scope.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAiD,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACrH,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE9D,6GAA6G;AAC7G,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAE9E,uEAAuE;AACvE,qBAAa,QAAQ,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;;IAMpD,YAAY,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,IAAI,EAG7C;IAED,mGAAmG;IACnG,IAAI,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAK9D;IAED;;;OAGG;IACH,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,SAAS,CAmBvE;IAED,yGAAyG;IACzG,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,SAAS,CAUrD;IAED;;;;;;;OAOG;IACH,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC;IACtG,UAAU,CAAC,CAAC,EAAE,CAAC,EACd,IAAI,EAAE,MAAM,CAAC,EACb,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAClC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC;IAqC3E;;;OAGG;IACH,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAKlD;IAED;;;OAGG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAgBxE;IAED,uFAAuF;IACvF,OAAO,IAAI,IAAI,CAGd;CAMD"}

package/dist/tui/scope.js

@@ -0,0 +1,141 @@
+// `TuiScope` (slice 11 §4, decision "Slice 11, P9"; p2's `TuiScope`): a terminal component's Chord resources, the
+// counterpart of the React bindings for terminal UI libraries. It holds references, follows watchables and registries,
+// calls one `changed` callback (the app's redraw) on every change, and releases everything at `dispose`. Its page state
+// is the host's, shared by every scope (React's `usePageState`): a scope opened again after a plugin reload finds it.
+// Its messages render in the host's language, and a change of the locale or a translation redraws. A reader can show
+// an optimistic value while a call is pending (React's `useOptimistic`).
+// References wait and rebind by themselves (no retry loop, unlike p2's); no terminal library dependency.
+import { BACKGROUND_CONTEXT, withAbortSignal } from "../context/index.js";
+import { hostLanguage } from "../surfaces/index.js";
+import { pageState } from "../surfaces/page-state.js";
+/** A component's scope: what it holds and follows, until `dispose`. */
+export class TuiScope {
+    #host;
+    #changed;
+    #abort = new AbortController();
+    #releases = [];
+    constructor(host, changed) {
+        this.#host = host;
+        this.#changed = changed;
+    }
+    /** A reference to `Type` with `params`, held until `dispose`; its state changes call `changed`. */
+    hold(Type, params) {
+        const held = this.#host.hold(Type, params, this.#context());
+        this.#releases.push(() => held.release());
+        this.watch(held.state);
+        return held;
+    }
+    /**
+     * Follows `source` (a member, a derive, `ref.state`) until `dispose`: its changes call `changed`. Returns a reader of
+     * its current value (`undefined` while it has none: nothing throws in a redraw).
+     */
+    watch(source) {
+        source.watch(this.#context()).then((watch) => {
+            watch.start(async () => {
+                if (!this.#abort.signal.aborted)
+                    this.#changed();
+            });
+            // The value it acquired may be newer than what was drawn (a reference bound since): draw it.
+            if (!this.#abort.signal.aborted)
+                this.#changed();
+        }, 
+        // Disposed (or the source ended) before the watch started: nothing to follow.
+        () => { });
+        return () => {
+            try {
+                return source.value;
+            }
+            catch {
+                return undefined;
+            }
+        };
+    }
+    /** Registry `R`'s composed value, followed until `dispose`; a reader, `undefined` until it is usable. */
+    registry(R) {
+        let read = () => undefined;
+        this.#host.registry(R, this.#context()).then((value) => {
+            read = this.watch(value);
+            if (!this.#abort.signal.aborted)
+                this.#changed();
+        }, () => { });
+        return () => read();
+    }
+    optimistic(read, 
+    // Without `reduce` the first overload makes the action a `T`: the last one is the value.
+    reduce = (_current, action) => action) {
+        // Kept until every call settled, as React keeps the updates of transitions still in flight.
+        let actions = [];
+        let pending = 0;
+        const redraw = () => {
+            if (!this.#abort.signal.aborted)
+                this.#changed();
+        };
+        const settled = () => {
+            if (--pending === 0)
+                actions = [];
+            redraw();
+        };
+        const add = (action, call) => {
+            actions = [...actions, action];
+            pending++;
+            // Its caller handles a rejection of `call`; this only follows it.
+            call.then(settled, settled);
+            redraw();
+            return call;
+        };
+        // The value shown is computed again only when `read`'s value or the actions changed: a redraw reading it often
+        // gets the same value (by identity) until then.
+        let last;
+        const shown = () => {
+            const base = read();
+            if (pending === 0)
+                return base;
+            if (last?.base !== base || last.actions !== actions)
+                last = { base, actions, value: actions.reduce(reduce, base) };
+            return last.value;
+        };
+        return [shown, add, () => pending > 0];
+    }
+    /**
+     * The host's page state at `key`, kept for the terminal's life, not the scope's (a new key starts at `initial`); its
+     * changes call `changed` until `dispose`.
+     */
+    pageState(key, initial) {
+        const state = pageState(this.#host, key, initial);
+        // A closure of its own: two scopes may share one `changed`, and subscribers are a set of functions.
+        this.#releases.push(state.subscribe(() => this.#changed()));
+        return state;
+    }
+    /**
+     * `messages` in the host's language as it is at each call (the first catalog before the host follows one); a change
+     * of the locale or a translation calls `changed` until `dispose`.
+     */
+    messages(messages) {
+        const language = hostLanguage(this.#host);
+        this.#releases.push(language.subscribe(() => this.#changed()));
+        let bound;
+        const current = () => {
+            const now = language.read();
+            // A translator's overloads are one function's, keyed by the catalog's shape: called here as that function.
+            if (bound === undefined || bound.language !== now) {
+                bound = { language: now, t: messages.in(now) };
+            }
+            return bound.t;
+        };
+        const t = Object.assign((key, ...args) => current()(key, ...args), {
+            render: (message) => current().render(message),
+        });
+        return t;
+    }
+    /** Releases every reference and ends every watch; `changed` is not called after it. */
+    dispose() {
+        this.#abort.abort();
+        for (const release of this.#releases.splice(0))
+            release();
+    }
+    /** The context of the scope's work: aborted at `dispose`. */
+    #context() {
+        return withAbortSignal(this.#abort.signal, BACKGROUND_CONTEXT);
+    }
+}
+//# sourceMappingURL=scope.js.map

package/dist/tui/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/tui/scope.ts"],"names":[],"mappings":"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","sourcesContent":["// `TuiScope` (slice 11 §4, decision \"Slice 11, P9\"; p2's `TuiScope`): a terminal component's Chord resources, the\n// counterpart of the React bindings for terminal UI libraries. It holds references, follows watchables and registries,\n// calls one `changed` callback (the app's redraw) on every change, and releases everything at `dispose`. Its page state\n// is the host's, shared by every scope (React's `usePageState`): a scope opened again after a plugin reload finds it.\n// Its messages render in the host's language, and a change of the locale or a translation redraws. A reader can show\n// an optimistic value while a call is pending (React's `useOptimistic`).\n// References wait and rebind by themselves (no retry loop, unlike p2's); no terminal library dependency.\n\nimport { BACKGROUND_CONTEXT, withAbortSignal } from \"../context/index.ts\";\nimport type { Contract, ParamsOf } from \"../contracts/index.ts\";\nimport type { Principal } from \"../data/index.ts\";\nimport type { Held, Host } from \"../host/index.ts\";\nimport type { Registry } from \"../registries/index.ts\";\nimport { hostLanguage, type Language, type MessageData, type Messages, type Translator } from \"../surfaces/index.ts\";\nimport { type PageState, pageState } from \"../surfaces/page-state.ts\";\nimport type { NativeWatchable, Watchable } from \"../watch.ts\";\n\n/** Adds an optimistic action shown while `call` is in flight; returns `call` (see `TuiScope.optimistic`). */\nexport type OptimisticAdd<A> = <R>(action: A, call: Promise<R>) => Promise<R>;\n\n/** A component's scope: what it holds and follows, until `dispose`. */\nexport class TuiScope<P extends Principal = Principal> {\n\treadonly #host: Host<P>;\n\treadonly #changed: () => void;\n\treadonly #abort = new AbortController();\n\treadonly #releases: (() => void)[] = [];\n\n\tconstructor(host: Host<P>, changed: () => void) {\n\t\tthis.#host = host;\n\t\tthis.#changed = changed;\n\t}\n\n\t/** A reference to `Type` with `params`, held until `dispose`; its state changes call `changed`. */\n\thold<C extends Contract>(Type: C, params: ParamsOf<C>): Held<C> {\n\t\tconst held = this.#host.hold(Type, params, this.#context());\n\t\tthis.#releases.push(() => held.release());\n\t\tthis.watch(held.state);\n\t\treturn held;\n\t}\n\n\t/**\n\t * Follows `source` (a member, a derive, `ref.state`) until `dispose`: its changes call `changed`. Returns a reader of\n\t * its current value (`undefined` while it has none: nothing throws in a redraw).\n\t */\n\twatch<T>(source: Watchable<T> | NativeWatchable<T>): () => T | undefined {\n\t\tsource.watch(this.#context()).then(\n\t\t\t(watch) => {\n\t\t\t\t(watch.start as (listener: () => Promise<void>) => void)(async () => {\n\t\t\t\t\tif (!this.#abort.signal.aborted) this.#changed();\n\t\t\t\t});\n\t\t\t\t// The value it acquired may be newer than what was drawn (a reference bound since): draw it.\n\t\t\t\tif (!this.#abort.signal.aborted) this.#changed();\n\t\t\t},\n\t\t\t// Disposed (or the source ended) before the watch started: nothing to follow.\n\t\t\t() => {},\n\t\t);\n\t\treturn () => {\n\t\t\ttry {\n\t\t\t\treturn source.value;\n\t\t\t} catch {\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t};\n\t}\n\n\t/** Registry `R`'s composed value, followed until `dispose`; a reader, `undefined` until it is usable. */\n\tregistry<C, V>(R: Registry<C, V>): () => V | undefined {\n\t\tlet read: () => V | undefined = () => undefined;\n\t\tthis.#host.registry(R, this.#context()).then(\n\t\t\t(value) => {\n\t\t\t\tread = this.watch(value);\n\t\t\t\tif (!this.#abort.signal.aborted) this.#changed();\n\t\t\t},\n\t\t\t() => {},\n\t\t);\n\t\treturn () => read();\n\t}\n\n\t/**\n\t * `read` with optimistic values, as React's `useOptimistic`: `add(action, call)` returns `call` and, until every call\n\t * added so settled, the reader shows `reduce(current, action)` applied over `read`'s value for each action in flight,\n\t * in order (without `reduce`, the last action is the value); then `read`'s again. `pending` says a call is in flight.\n\t * Each change calls `changed`. A call over a link settles after the changes its answering host committed before\n\t * answering (decision \"A call's answer follows its state\"), so the value shown next is the real one. A rejected\n\t * call is its caller's to handle (React leaves it to the transition); its action goes as a resolved one's does.\n\t */\n\toptimistic<T>(read: () => T): readonly [read: () => T, add: OptimisticAdd<T>, pending: () => boolean];\n\toptimistic<T, A>(\n\t\tread: () => T,\n\t\treduce: (current: T, action: A) => T,\n\t): readonly [read: () => T, add: OptimisticAdd<A>, pending: () => boolean];\n\toptimistic<T, A>(\n\t\tread: () => T,\n\t\t// Without `reduce` the first overload makes the action a `T`: the last one is the value.\n\t\treduce: (current: T, action: A) => T = (_current, action) => action as unknown as T,\n\t): readonly [read: () => T, add: OptimisticAdd<A>, pending: () => boolean] {\n\t\t// Kept until every call settled, as React keeps the updates of transitions still in flight.\n\t\tlet actions: A[] = [];\n\t\tlet pending = 0;\n\t\tconst redraw = (): void => {\n\t\t\tif (!this.#abort.signal.aborted) this.#changed();\n\t\t};\n\t\tconst settled = (): void => {\n\t\t\tif (--pending === 0) actions = [];\n\t\t\tredraw();\n\t\t};\n\t\tconst add = <R>(action: A, call: Promise<R>): Promise<R> => {\n\t\t\tactions = [...actions, action];\n\t\t\tpending++;\n\t\t\t// Its caller handles a rejection of `call`; this only follows it.\n\t\t\tcall.then(settled, settled);\n\t\t\tredraw();\n\t\t\treturn call;\n\t\t};\n\t\t// The value shown is computed again only when `read`'s value or the actions changed: a redraw reading it often\n\t\t// gets the same value (by identity) until then.\n\t\tlet last: { base: T; actions: A[]; value: T } | undefined;\n\t\tconst shown = (): T => {\n\t\t\tconst base = read();\n\t\t\tif (pending === 0) return base;\n\t\t\tif (last?.base !== base || last.actions !== actions)\n\t\t\t\tlast = { base, actions, value: actions.reduce(reduce, base) };\n\t\t\treturn last.value;\n\t\t};\n\t\treturn [shown, add, () => pending > 0];\n\t}\n\n\t/**\n\t * The host's page state at `key`, kept for the terminal's life, not the scope's (a new key starts at `initial`); its\n\t * changes call `changed` until `dispose`.\n\t */\n\tpageState<T>(key: string, initial: T): PageState<T> {\n\t\tconst state = pageState(this.#host, key, initial);\n\t\t// A closure of its own: two scopes may share one `changed`, and subscribers are a set of functions.\n\t\tthis.#releases.push(state.subscribe(() => this.#changed()));\n\t\treturn state;\n\t}\n\n\t/**\n\t * `messages` in the host's language as it is at each call (the first catalog before the host follows one); a change\n\t * of the locale or a translation calls `changed` until `dispose`.\n\t */\n\tmessages<N extends string, M>(messages: Messages<N, M>): Translator<N, M> {\n\t\tconst language = hostLanguage(this.#host);\n\t\tthis.#releases.push(language.subscribe(() => this.#changed()));\n\t\tlet bound: { readonly language: Language | undefined; readonly t: PlainTranslator } | undefined;\n\t\tconst current = (): PlainTranslator => {\n\t\t\tconst now = language.read();\n\t\t\t// A translator's overloads are one function's, keyed by the catalog's shape: called here as that function.\n\t\t\tif (bound === undefined || bound.language !== now) {\n\t\t\t\tbound = { language: now, t: messages.in(now) as unknown as PlainTranslator };\n\t\t\t}\n\t\t\treturn bound.t;\n\t\t};\n\t\tconst t: PlainTranslator = Object.assign((key: string, ...args: unknown[]) => current()(key, ...args), {\n\t\t\trender: (message: MessageData) => current().render(message),\n\t\t});\n\t\treturn t as unknown as Translator<N, M>;\n\t}\n\n\t/** Releases every reference and ends every watch; `changed` is not called after it. */\n\tdispose(): void {\n\t\tthis.#abort.abort();\n\t\tfor (const release of this.#releases.splice(0)) release();\n\t}\n\n\t/** The context of the scope's work: aborted at `dispose`. */\n\t#context() {\n\t\treturn withAbortSignal(this.#abort.signal, BACKGROUND_CONTEXT);\n\t}\n}\n\n/** A translator as the function it is: any key, any arguments. */\ntype PlainTranslator = ((key: string, ...args: unknown[]) => string) & { render(message: MessageData): string };\n"]}

package/dist/tui/terminal.d.ts

@@ -0,0 +1,15 @@
+import type { SandboxChannel } from "./channel.ts";
+/** The bridged terminal. */
+export declare class BridgeTerminal {
+    #private;
+    constructor(channel: SandboxChannel);
+    get columns(): number;
+    get rows(): number;
+    /** Writes `data` (text and escape sequences) to the terminal. */
+    write(data: string): void;
+    /** Calls `listener` with each input (keys, pastes, as the terminal sends them) until the returned removal. */
+    onInput(listener: (data: string) => void): () => void;
+    /** Calls `listener` after each resize (the new size read from `columns` and `rows`) until the returned removal. */
+    onResize(listener: () => void): () => void;
+}
+//# sourceMappingURL=terminal.d.ts.map

package/dist/tui/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/tui/terminal.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,4BAA4B;AAC5B,qBAAa,cAAc;;IAK1B,YAAY,OAAO,EAAE,cAAc,EAQlC;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,iEAAiE;IACjE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAExB;IAED,8GAA8G;IAC9G,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAEpD;IAED,mHAAmH;IACnH,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAEzC;CACD"}

package/dist/tui/terminal.js

@@ -0,0 +1,37 @@
+// The terminal as the app's terminal code sees it inside the sandbox (slice 11 §4): its size, writing frames, and
+// input and resizes, all through the bridge; the launcher holds the real terminal. Library-agnostic: an app adapts it
+// to its terminal UI library (pi-tui's `Terminal` in a few lines).
+/** The bridged terminal. */
+export class BridgeTerminal {
+    #channel;
+    #columns;
+    #rows;
+    constructor(channel) {
+        this.#channel = channel;
+        this.#columns = channel.start.columns;
+        this.#rows = channel.start.rows;
+        channel.onResize((columns, rows) => {
+            this.#columns = columns;
+            this.#rows = rows;
+        });
+    }
+    get columns() {
+        return this.#columns;
+    }
+    get rows() {
+        return this.#rows;
+    }
+    /** Writes `data` (text and escape sequences) to the terminal. */
+    write(data) {
+        this.#channel.write(data);
+    }
+    /** Calls `listener` with each input (keys, pastes, as the terminal sends them) until the returned removal. */
+    onInput(listener) {
+        return this.#channel.onInput(listener);
+    }
+    /** Calls `listener` after each resize (the new size read from `columns` and `rows`) until the returned removal. */
+    onResize(listener) {
+        return this.#channel.onResize(() => listener());
+    }
+}
+//# sourceMappingURL=terminal.js.map

package/dist/tui/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../src/tui/terminal.ts"],"names":[],"mappings":"AAAA,kHAAkH;AAClH,sHAAsH;AACtH,mEAAmE;AAInE,4BAA4B;AAC5B,MAAM,OAAO,cAAc;IACjB,QAAQ,CAAiB;IAClC,QAAQ,CAAS;IACjB,KAAK,CAAS;IAEd,YAAY,OAAuB;QAClC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;QAChC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE;YAClC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;YACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,IAAY;QACjB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,8GAA8G;IAC9G,OAAO,CAAC,QAAgC;QACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,mHAAmH;IACnH,QAAQ,CAAC,QAAoB;QAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;CACD","sourcesContent":["// The terminal as the app's terminal code sees it inside the sandbox (slice 11 §4): its size, writing frames, and\n// input and resizes, all through the bridge; the launcher holds the real terminal. Library-agnostic: an app adapts it\n// to its terminal UI library (pi-tui's `Terminal` in a few lines).\n\nimport type { SandboxChannel } from \"./channel.ts\";\n\n/** The bridged terminal. */\nexport class BridgeTerminal {\n\treadonly #channel: SandboxChannel;\n\t#columns: number;\n\t#rows: number;\n\n\tconstructor(channel: SandboxChannel) {\n\t\tthis.#channel = channel;\n\t\tthis.#columns = channel.start.columns;\n\t\tthis.#rows = channel.start.rows;\n\t\tchannel.onResize((columns, rows) => {\n\t\t\tthis.#columns = columns;\n\t\t\tthis.#rows = rows;\n\t\t});\n\t}\n\n\tget columns(): number {\n\t\treturn this.#columns;\n\t}\n\n\tget rows(): number {\n\t\treturn this.#rows;\n\t}\n\n\t/** Writes `data` (text and escape sequences) to the terminal. */\n\twrite(data: string): void {\n\t\tthis.#channel.write(data);\n\t}\n\n\t/** Calls `listener` with each input (keys, pastes, as the terminal sends them) until the returned removal. */\n\tonInput(listener: (data: string) => void): () => void {\n\t\treturn this.#channel.onInput(listener);\n\t}\n\n\t/** Calls `listener` after each resize (the new size read from `columns` and `rows`) until the returned removal. */\n\tonResize(listener: () => void): () => void {\n\t\treturn this.#channel.onResize(() => listener());\n\t}\n}\n"]}

package/dist/tui/theme.d.ts

@@ -0,0 +1,17 @@
+import { type ColorDepth, type Theme } from "../surfaces/index.ts";
+/** Colours by role for the terminal. */
+export declare class TerminalTheme {
+    #private;
+    constructor(theme: Theme, depth: ColorDepth);
+    /** The active theme. */
+    get theme(): Theme;
+    /** `text` in `role`'s colour (the default colour after it). */
+    fg(role: string, text: string): string;
+    /** `text` on `role`'s colour as its background. */
+    bg(role: string, text: string): string;
+    /** Calls `listener` when the active theme changes (to redraw) until the returned removal. */
+    onChange(listener: () => void): () => void;
+    /** The active theme is now `theme`. */
+    set(theme: Theme): void;
+}
+//# sourceMappingURL=theme.d.ts.map

package/dist/tui/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/tui/theme.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,KAAK,EAAiB,MAAM,sBAAsB,CAAC;AAElF,wCAAwC;AACxC,qBAAa,aAAa;;IAKzB,YAAY,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAG1C;IAED,wBAAwB;IACxB,IAAI,KAAK,IAAI,KAAK,CAEjB;IAED,+DAA+D;IAC/D,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAErC;IAED,mDAAmD;IACnD,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAErC;IAED,6FAA6F;IAC7F,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAGzC;IAED,uCAAuC;IACvC,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAGtB;CACD"}

package/dist/tui/theme.js

@@ -0,0 +1,38 @@
+// The terminal's theme lookup (slice 11 §4b, decision "Looks and themes"): colours by role from the active theme, as
+// the terminal shows them (true colour, else the nearest of 256; a theme's `tui` overrides first). A plugin asks for a
+// role (`theme.fg("accent", "Notes")`), never writes raw colours; a new theme applies at the next redraw.
+import { terminalColor } from "../surfaces/index.js";
+/** Colours by role for the terminal. */
+export class TerminalTheme {
+    #depth;
+    #theme;
+    #listeners = new Set();
+    constructor(theme, depth) {
+        this.#theme = theme;
+        this.#depth = depth;
+    }
+    /** The active theme. */
+    get theme() {
+        return this.#theme;
+    }
+    /** `text` in `role`'s colour (the default colour after it). */
+    fg(role, text) {
+        return `\x1b[${terminalColor(this.#theme, role, this.#depth, "fg")}m${text}\x1b[39m`;
+    }
+    /** `text` on `role`'s colour as its background. */
+    bg(role, text) {
+        return `\x1b[${terminalColor(this.#theme, role, this.#depth, "bg")}m${text}\x1b[49m`;
+    }
+    /** Calls `listener` when the active theme changes (to redraw) until the returned removal. */
+    onChange(listener) {
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    }
+    /** The active theme is now `theme`. */
+    set(theme) {
+        this.#theme = theme;
+        for (const listener of this.#listeners)
+            listener();
+    }
+}
+//# sourceMappingURL=theme.js.map

package/dist/tui/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/tui/theme.ts"],"names":[],"mappings":"AAAA,qHAAqH;AACrH,uHAAuH;AACvH,0GAA0G;AAE1G,OAAO,EAA+B,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAElF,wCAAwC;AACxC,MAAM,OAAO,aAAa;IAChB,MAAM,CAAa;IAC5B,MAAM,CAAQ;IACL,UAAU,GAAG,IAAI,GAAG,EAAc,CAAC;IAE5C,YAAY,KAAY,EAAE,KAAiB;QAC1C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,wBAAwB;IACxB,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED,+DAA+D;IAC/D,EAAE,CAAC,IAAY,EAAE,IAAY;QAC5B,OAAO,QAAQ,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC;IACtF,CAAC;IAED,mDAAmD;IACnD,EAAE,CAAC,IAAY,EAAE,IAAY;QAC5B,OAAO,QAAQ,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC;IACtF,CAAC;IAED,6FAA6F;IAC7F,QAAQ,CAAC,QAAoB;QAC5B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,uCAAuC;IACvC,GAAG,CAAC,KAAY;QACf,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU;YAAE,QAAQ,EAAE,CAAC;IACpD,CAAC;CACD","sourcesContent":["// The terminal's theme lookup (slice 11 §4b, decision \"Looks and themes\"): colours by role from the active theme, as\n// the terminal shows them (true colour, else the nearest of 256; a theme's `tui` overrides first). A plugin asks for a\n// role (`theme.fg(\"accent\", \"Notes\")`), never writes raw colours; a new theme applies at the next redraw.\n\nimport { type ColorDepth, type Theme, terminalColor } from \"../surfaces/index.ts\";\n\n/** Colours by role for the terminal. */\nexport class TerminalTheme {\n\treadonly #depth: ColorDepth;\n\t#theme: Theme;\n\treadonly #listeners = new Set<() => void>();\n\n\tconstructor(theme: Theme, depth: ColorDepth) {\n\t\tthis.#theme = theme;\n\t\tthis.#depth = depth;\n\t}\n\n\t/** The active theme. */\n\tget theme(): Theme {\n\t\treturn this.#theme;\n\t}\n\n\t/** `text` in `role`'s colour (the default colour after it). */\n\tfg(role: string, text: string): string {\n\t\treturn `\\x1b[${terminalColor(this.#theme, role, this.#depth, \"fg\")}m${text}\\x1b[39m`;\n\t}\n\n\t/** `text` on `role`'s colour as its background. */\n\tbg(role: string, text: string): string {\n\t\treturn `\\x1b[${terminalColor(this.#theme, role, this.#depth, \"bg\")}m${text}\\x1b[49m`;\n\t}\n\n\t/** Calls `listener` when the active theme changes (to redraw) until the returned removal. */\n\tonChange(listener: () => void): () => void {\n\t\tthis.#listeners.add(listener);\n\t\treturn () => this.#listeners.delete(listener);\n\t}\n\n\t/** The active theme is now `theme`. */\n\tset(theme: Theme): void {\n\t\tthis.#theme = theme;\n\t\tfor (const listener of this.#listeners) listener();\n\t}\n}\n"]}

package/dist/watch.d.ts

@@ -0,0 +1,194 @@
+import { type Context } from "./context/index.ts";
+import { type Op } from "./delta/index.ts";
+/**
+ * Terminal result of one watch, tagged by `kind`. A watch ends only for good; a failure its source recovers from is a
+ * `failed` call (`WatchCall`), and the watch stays open.
+ *
+ * - `stopped`: `stop()` was called.
+ * - `aborted`: the context the watch was acquired with was aborted.
+ * - `ended`: the source closed (its owner ended or closed).
+ * - `listener_error`: the listener threw or rejected with `error`.
+ * - `failed`: the source failed for good with `error`.
+ */
+export type WatchEnd = {
+    readonly kind: "stopped" | "aborted" | "ended";
+} | {
+    readonly kind: "listener_error";
+    readonly error: Error;
+} | {
+    readonly kind: "failed";
+    readonly error: unknown;
+};
+/**
+ * One call of a JSON watch's listener, and one frame a source hands its watch, tagged by `kind`:
+ *
+ * - `value`: the newest value, the ops that turn the previous value into it, and whether the document the watch follows
+ *   was retired since the previous value call. A retirement does not end the watch: `value` is then what the address
+ *   shows after it (the source decides; a Durable document keeps the last value the watch was given, with no ops), and a
+ *   document created there later arrives as `[["r", value]]`, possibly in the same call.
+ * - `failed`: the source cannot compute its value now, with `error`; the watch stays open, and the next value arrives as
+ *   `[["r", value]]`. `WatchHandle.value` keeps the last value.
+ *
+ * Plain data: the frame's context is the listener's second argument, never part of the call.
+ */
+export type WatchCall<T> = {
+    readonly kind: "value";
+    readonly value: T;
+    readonly ops: readonly Op[];
+    readonly retired: boolean;
+} | {
+    readonly kind: "failed";
+    readonly error: unknown;
+};
+/** One call of a native watch's listener: the new value, or a failure its source may recover from, as in `WatchCall`. */
+export type NativeWatchCall<T> = {
+    readonly kind: "value";
+    readonly value: T;
+} | {
+    readonly kind: "failed";
+    readonly error: unknown;
+};
+/**
+ * Serialized observation of an immutable value: one listener call at a time; changes made meanwhile arrive folded into
+ * the next call.
+ */
+export interface WatchHandle<T> {
+    /** Acquisition revision before start; latest delivered immutable revision afterward (a `failed` call keeps it). */
+    readonly value: T;
+    /** Install the sole asynchronous listener. Never invokes it inline. */
+    start(listener: (call: WatchCall<T>, context: Context) => Promise<void>): void;
+    /** Idempotently stop future callbacks and return this watch's terminal result. */
+    stop(): Promise<WatchEnd>;
+    /** Settle when the watch terminates; an already-running callback remains caller-owned. */
+    readonly closed: Promise<WatchEnd>;
+}
+/**
+ * A value that changes and can be watched: documents, derives, members of references. Values are immutable by
+ * convention (JSON for state); each watch starts at the current value and then gets the changes, folded while its
+ * listener is busy.
+ */
+export interface Watchable<T> {
+    /** The current value. */
+    readonly value: T;
+    /** A watch holding the current value, then its changes; aborting the context ends it. */
+    watch(context: Context): Promise<WatchHandle<T>>;
+}
+/**
+ * An in-process value that changes and can be watched (it may hold anything, errors and functions included): a change
+ * is a new value by identity, delivered without ops.
+ */
+export interface NativeWatchable<T> {
+    /** The current value. */
+    readonly value: T;
+    /** A watch holding the current value, then one frame per new value; aborting the context ends it. */
+    watch(context: Context): Promise<NativeWatchHandle<T>>;
+}
+/**
+ * Serialized observation of an in-process value: as `WatchHandle`, but each new value is its own call, in order, without
+ * ops.
+ */
+export interface NativeWatchHandle<T> {
+    /** Acquisition value before start; latest delivered value afterward (a `failed` call keeps it). */
+    readonly value: T;
+    /** Install the sole asynchronous listener. Never invokes it inline. */
+    start(listener: (call: NativeWatchCall<T>, context: Context) => Promise<void>): void;
+    /** Idempotently stop future callbacks and return this watch's terminal result. */
+    stop(): Promise<WatchEnd>;
+    /** Settle when the watch terminates; an already-running callback remains caller-owned. */
+    readonly closed: Promise<WatchEnd>;
+}
+type Listener<C> = (call: C, context: Context) => Promise<void>;
+/** A failure call, as both call types have it. */
+type FailedCall = {
+    readonly kind: "failed";
+    readonly error: unknown;
+};
+/**
+ * The lifecycle both handles share: serialized delivery and termination. A source feeds it and ends it explicitly;
+ * termination drops every reference the watch holds into its source, so a stopped watch that is still referenced keeps
+ * nothing but its last value alive. Subclasses keep what is pending, each call apart from its frame's context, so the
+ * call a listener gets carries nothing but its data.
+ */
+declare abstract class WatchLifecycle<T, C extends {
+    readonly kind: "value";
+    readonly value: T;
+} | FailedCall> {
+    #private;
+    constructor(value: T, detach: () => void, report: (error: unknown) => void);
+    get value(): T;
+    get closed(): Promise<WatchEnd>;
+    start(listener: Listener<C>): void;
+    stop(): Promise<WatchEnd>;
+    /** End the watch `aborted` when `signal` aborts; installed once. */
+    observeAbort(signal: AbortSignal): void;
+    /** End the watch `aborted`: its acquisition context was aborted. */
+    abort(): void;
+    /**
+     * End the watch with `end` at once, dropping what is pending: the source closed (`ended`), or failed for good
+     * (`failed`). A failure the source may recover from is a `failed` call instead (`fail()`).
+     */
+    end(end: WatchEnd): void;
+    /**
+     * The source sends nothing more after its last frames, such as a retirement: take no more frames, deliver what is
+     * pending, then end `ended`, after the running call returns, if one runs. Until then the watch stays attached, so
+     * `end()`, `stop()`, an abort, and a throwing listener still end it first; a watch never started keeps what is
+     * pending until one of them or `start()`.
+     */
+    endAfterDelivery(): void;
+    /** Whether the watch still takes frames: it has not ended, and its source has not ended. */
+    protected get open(): boolean;
+    /** The context of the newest frame the next call covers, or undefined when nothing is pending. */
+    protected abstract get pendingContext(): Context | undefined;
+    /** Take the next call; called only while something is pending. */
+    protected abstract next(): C;
+    /** Drop everything pending and every reference into the source; called once, on termination. */
+    protected abstract release(): void;
+    /** Something became pending: deliver it once started, never inline. */
+    protected pending(): void;
+}
+/**
+ * The watch handle of a JSON source. Frames that arrive before `start()` or while the listener runs wait in one
+ * `PendingOps` queue; the next call gets the newest value, the folded ops of every frame since the previous call (or
+ * `[["r", newest]]` after the queue overflowed), `retired` when any of them was a retirement, and the newest frame's
+ * context. A frame delivered alone is passed on as the source made it. A failure (`fail()`) drops the pending frames and
+ * waits as one `failed` call; a value after it replaces it, and the first value call after a failure is `[["r",
+ * value]]`. `detach` unsubscribes it from its source on termination; `report` gets a listener's throw, which also ends
+ * the watch.
+ */
+export declare class Watch<T> extends WatchLifecycle<T, WatchCall<T>> implements WatchHandle<T> {
+    #private;
+    /**
+     * Queue the frame `call`. A value's ops turn the previous value into it, and `retired` says the document the watch
+     * follows was retired, which the next value call reports however many frames it folds; a failure is `fail()`.
+     */
+    advance(call: WatchCall<T>, context: Context): void;
+    /**
+     * Queue a failure the source may recover from: the pending frames are dropped (`value` keeps the last delivered
+     * value), the listener gets `{ kind: "failed", error }`, and the next value arrives as `[["r", value]]`.
+     */
+    fail(error: unknown, context: Context): void;
+    protected get pendingContext(): Context | undefined;
+    protected next(): WatchCall<T>;
+    protected release(): void;
+}
+/**
+ * The watch handle of a native source: every value in order, one call each; past 100 pending values they collapse to
+ * one, `replace()` or by default the newest value. A failure (`fail()`) drops the pending values and waits as one
+ * `failed` call; a value after it replaces it. `detach` and `report` as for `Watch`.
+ */
+export declare class NativeWatch<T> extends WatchLifecycle<T, NativeWatchCall<T>> implements NativeWatchHandle<T> {
+    #private;
+    constructor(value: T, detach: () => void, report: (error: unknown) => void, replace?: () => T);
+    /** Queue `value`, the source's new value; it replaces a pending failure. */
+    advance(value: T, context: Context): void;
+    /**
+     * Queue a failure the source may recover from: the pending values are dropped (`value` keeps the last delivered
+     * value), and the listener gets `{ kind: "failed", error }`.
+     */
+    fail(error: unknown, context: Context): void;
+    protected get pendingContext(): Context | undefined;
+    protected next(): NativeWatchCall<T>;
+    protected release(): void;
+}
+export {};
+//# sourceMappingURL=watch.d.ts.map

package/dist/watch.d.ts.map

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