@earendil-works/chord 1.5.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/web/environment.d.ts

@@ -0,0 +1,4 @@
+import type { LoopEnvironment } from "../surfaces/index.ts";
+/** The browser page's loop environment. */
+export declare function pageEnvironment(): LoopEnvironment;
+//# sourceMappingURL=environment.d.ts.map

package/dist/web/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/web/environment.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,2CAA2C;AAC3C,wBAAgB,eAAe,IAAI,eAAe,CA4BjD"}

package/dist/web/environment.js

@@ -0,0 +1,37 @@
+/// <reference lib="dom" />
+// The page's environment for the connection loop (slice 11 §2, decision "Slice 11, P6"): the clock and timers, and
+// the wakes that mean the page may have been away: visible again, back online, restored from the back/forward cache,
+// or a network change (Chromium reports it; the old socket then looks fine until it is checked).
+/** The browser page's loop environment. */
+export function pageEnvironment() {
+    return {
+        now: () => Date.now(),
+        after: (ms, callback) => {
+            const timer = setTimeout(callback, ms);
+            return () => clearTimeout(timer);
+        },
+        online: () => navigator.onLine,
+        onWake: (listener) => {
+            const restored = (event) => {
+                if (event.persisted)
+                    listener();
+            };
+            const visible = () => {
+                if (document.visibilityState === "visible")
+                    listener();
+            };
+            const network = navigator.connection;
+            window.addEventListener("online", listener);
+            window.addEventListener("pageshow", restored);
+            document.addEventListener("visibilitychange", visible);
+            network?.addEventListener("change", listener);
+            return () => {
+                window.removeEventListener("online", listener);
+                window.removeEventListener("pageshow", restored);
+                document.removeEventListener("visibilitychange", visible);
+                network?.removeEventListener("change", listener);
+            };
+        },
+    };
+}
+//# sourceMappingURL=environment.js.map

package/dist/web/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/web/environment.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,mHAAmH;AACnH,qHAAqH;AACrH,iGAAiG;AAIjG,2CAA2C;AAC3C,MAAM,UAAU,eAAe;IAC9B,OAAO;QACN,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QACrB,KAAK,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE;YACvB,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACvC,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QACD,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM;QAC9B,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;YACpB,MAAM,QAAQ,GAAG,CAAC,KAA0B,EAAQ,EAAE;gBACrD,IAAI,KAAK,CAAC,SAAS;oBAAE,QAAQ,EAAE,CAAC;YACjC,CAAC,CAAC;YACF,MAAM,OAAO,GAAG,GAAS,EAAE;gBAC1B,IAAI,QAAQ,CAAC,eAAe,KAAK,SAAS;oBAAE,QAAQ,EAAE,CAAC;YACxD,CAAC,CAAC;YACF,MAAM,OAAO,GAAI,SAAmD,CAAC,UAAU,CAAC;YAChF,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC5C,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAC9C,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;YACvD,OAAO,EAAE,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC9C,OAAO,GAAG,EAAE;gBACX,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBAC/C,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;gBACjD,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;gBAC1D,OAAO,EAAE,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAClD,CAAC,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC","sourcesContent":["/// <reference lib=\"dom\" />\n// The page's environment for the connection loop (slice 11 §2, decision \"Slice 11, P6\"): the clock and timers, and\n// the wakes that mean the page may have been away: visible again, back online, restored from the back/forward cache,\n// or a network change (Chromium reports it; the old socket then looks fine until it is checked).\n\nimport type { LoopEnvironment } from \"../surfaces/index.ts\";\n\n/** The browser page's loop environment. */\nexport function pageEnvironment(): LoopEnvironment {\n\treturn {\n\t\tnow: () => Date.now(),\n\t\tafter: (ms, callback) => {\n\t\t\tconst timer = setTimeout(callback, ms);\n\t\t\treturn () => clearTimeout(timer);\n\t\t},\n\t\tonline: () => navigator.onLine,\n\t\tonWake: (listener) => {\n\t\t\tconst restored = (event: PageTransitionEvent): void => {\n\t\t\t\tif (event.persisted) listener();\n\t\t\t};\n\t\t\tconst visible = (): void => {\n\t\t\t\tif (document.visibilityState === \"visible\") listener();\n\t\t\t};\n\t\t\tconst network = (navigator as { readonly connection?: EventTarget }).connection;\n\t\t\twindow.addEventListener(\"online\", listener);\n\t\t\twindow.addEventListener(\"pageshow\", restored);\n\t\t\tdocument.addEventListener(\"visibilitychange\", visible);\n\t\t\tnetwork?.addEventListener(\"change\", listener);\n\t\t\treturn () => {\n\t\t\t\twindow.removeEventListener(\"online\", listener);\n\t\t\t\twindow.removeEventListener(\"pageshow\", restored);\n\t\t\t\tdocument.removeEventListener(\"visibilitychange\", visible);\n\t\t\t\tnetwork?.removeEventListener(\"change\", listener);\n\t\t\t};\n\t\t},\n\t};\n}\n"]}

package/dist/web/index.d.ts

@@ -0,0 +1,5 @@
+export { pageEnvironment } from "./environment.ts";
+export { followLanguage } from "./language.ts";
+export { type PageOptions, startPage } from "./page.ts";
+export { followThemes } from "./themes.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/web/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,KAAK,WAAW,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/web/index.js

@@ -0,0 +1,7 @@
+// Chord v2's web surface, the browser side (`@earendil-works/chord/web`; slice 11 §2): `startPage` in the app's web
+// entry, and the themes and the language it writes. The server side is `/surfaces`.
+export { pageEnvironment } from "./environment.js";
+export { followLanguage } from "./language.js";
+export { startPage } from "./page.js";
+export { followThemes } from "./themes.js";
+//# sourceMappingURL=index.js.map

package/dist/web/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,oFAAoF;AAEpF,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAoB,SAAS,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC","sourcesContent":["// Chord v2's web surface, the browser side (`@earendil-works/chord/web`; slice 11 §2): `startPage` in the app's web\n// entry, and the themes and the language it writes. The server side is `/surfaces`.\n\nexport { pageEnvironment } from \"./environment.ts\";\nexport { followLanguage } from \"./language.ts\";\nexport { type PageOptions, startPage } from \"./page.ts\";\nexport { followThemes } from \"./themes.ts\";\n"]}

package/dist/web/language.d.ts

@@ -0,0 +1,7 @@
+import type { Context } from "../context/index.ts";
+import type { Principal } from "../data/index.ts";
+import type { Host } from "../host/index.ts";
+import { type MessagesReport } from "../surfaces/index.ts";
+/** Follows the language on `host` and writes it on the root element until the returned stop; `report` gets reports. */
+export declare function followLanguage<P extends Principal>(host: Host<P>, report: (report: MessagesReport) => void, context: Context): Promise<() => void>;
+//# sourceMappingURL=language.d.ts.map

package/dist/web/language.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.d.ts","sourceRoot":"","sources":["../../src/web/language.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEjF,uHAAuH;AACvH,wBAAsB,cAAc,CAAC,CAAC,SAAS,SAAS,EACvD,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EACb,MAAM,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,EACxC,OAAO,EAAE,OAAO,GACd,OAAO,CAAC,MAAM,IAAI,CAAC,CAkBrB"}

package/dist/web/language.js

@@ -0,0 +1,21 @@
+/// <reference lib="dom" />
+// The page's language (decision "Messages and languages in the app kit" (3)): the active language followed from the
+// browser's `navigator.languages`, the user's `LocaleChoice` and the catalogs, written as `lang` and `dir` on the root
+// element (right to left through the app's logical CSS properties). Components re-render through `useMessages`; nothing
+// reloads.
+import { followActiveLanguage } from "../surfaces/index.js";
+/** Follows the language on `host` and writes it on the root element until the returned stop; `report` gets reports. */
+export async function followLanguage(host, report, context) {
+    const root = document.documentElement;
+    const follower = await followActiveLanguage(host, navigator.languages, (language) => {
+        root.lang = language.locale;
+        root.dir = language.dir;
+    }, report, context);
+    const devicechanged = () => follower.setDevice(navigator.languages);
+    addEventListener("languagechange", devicechanged);
+    return () => {
+        follower.stop();
+        removeEventListener("languagechange", devicechanged);
+    };
+}
+//# sourceMappingURL=language.js.map

package/dist/web/language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.js","sourceRoot":"","sources":["../../src/web/language.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,oHAAoH;AACpH,uHAAuH;AACvH,wHAAwH;AACxH,WAAW;AAKX,OAAO,EAAE,oBAAoB,EAAuB,MAAM,sBAAsB,CAAC;AAEjF,uHAAuH;AACvH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,IAAa,EACb,MAAwC,EACxC,OAAgB;IAEhB,MAAM,IAAI,GAAG,QAAQ,CAAC,eAAe,CAAC;IACtC,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAC1C,IAAI,EACJ,SAAS,CAAC,SAAS,EACnB,CAAC,QAAQ,EAAE,EAAE;QACZ,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC;IACzB,CAAC,EACD,MAAM,EACN,OAAO,CACP,CAAC;IACF,MAAM,aAAa,GAAG,GAAS,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAC1E,gBAAgB,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;IAClD,OAAO,GAAG,EAAE;QACX,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChB,mBAAmB,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;IACtD,CAAC,CAAC;AACH,CAAC","sourcesContent":["/// <reference lib=\"dom\" />\n// The page's language (decision \"Messages and languages in the app kit\" (3)): the active language followed from the\n// browser's `navigator.languages`, the user's `LocaleChoice` and the catalogs, written as `lang` and `dir` on the root\n// element (right to left through the app's logical CSS properties). Components re-render through `useMessages`; nothing\n// reloads.\n\nimport type { Context } from \"../context/index.ts\";\nimport type { Principal } from \"../data/index.ts\";\nimport type { Host } from \"../host/index.ts\";\nimport { followActiveLanguage, type MessagesReport } from \"../surfaces/index.ts\";\n\n/** Follows the language on `host` and writes it on the root element until the returned stop; `report` gets reports. */\nexport async function followLanguage<P extends Principal>(\n\thost: Host<P>,\n\treport: (report: MessagesReport) => void,\n\tcontext: Context,\n): Promise<() => void> {\n\tconst root = document.documentElement;\n\tconst follower = await followActiveLanguage(\n\t\thost,\n\t\tnavigator.languages,\n\t\t(language) => {\n\t\t\troot.lang = language.locale;\n\t\t\troot.dir = language.dir;\n\t\t},\n\t\treport,\n\t\tcontext,\n\t);\n\tconst devicechanged = (): void => follower.setDevice(navigator.languages);\n\taddEventListener(\"languagechange\", devicechanged);\n\treturn () => {\n\t\tfollower.stop();\n\t\tremoveEventListener(\"languagechange\", devicechanged);\n\t};\n}\n"]}

package/dist/web/page.d.ts

@@ -0,0 +1,29 @@
+import type { Principal } from "../data/index.ts";
+import type { PluginFacet } from "../host/index.ts";
+import { type WebSocketLike } from "../link/index.ts";
+import { type Client, type ClientError, type ClientModules, type ConnectionState } from "../surfaces/index.ts";
+/** What `startPage` takes. */
+export type PageOptions<P extends Principal> = {
+    /** Opens the page's socket to the server's links endpoint (`/chord`). */
+    readonly connect: () => WebSocketLike;
+    /** The modules the web plugins import, by specifier: the app's API modules for the web kind, React, ... */
+    readonly modules: ClientModules;
+    /** The app's own web facets. */
+    readonly core?: readonly PluginFacet<P>[];
+    /** Asked before each reconnect; `false` stops reconnecting (a guest's ended share). */
+    readonly canRetry?: () => Promise<boolean>;
+    readonly onConnection?: (state: ConnectionState) => void;
+    /** Renders the app with its host, once the plugins are loaded. */
+    readonly render: (host: Client<P>["host"]) => void;
+    /**
+     * Records the page's telemetry (decision "Telemetry from browser pages"): its spans (a click started with
+     * `host.root(fn, ctx, { trace })`, the calls under it, carriers on its calls) are kept in memory and sent to the
+     * server's telemetry object every few seconds and when the page is hidden. Off by default.
+     */
+    readonly telemetry?: boolean;
+    /** Plugins left out or kept old, a failed update, the host's errors, messages' reports: the console by default. */
+    readonly onError?: (error: ClientError) => void;
+};
+/** Starts the page; resolves with its client once rendered. */
+export declare function startPage<P extends Principal>(options: PageOptions<P>): Promise<Client<P>>;
+//# sourceMappingURL=page.d.ts.map

package/dist/web/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/web/page.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,kBAAkB,CAAC;AACrE,OAAO,EACN,KAAK,MAAM,EACX,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,eAAe,EAKpB,MAAM,sBAAsB,CAAC;AAQ9B,8BAA8B;AAC9B,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,SAAS,IAAI;IAC9C,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,aAAa,CAAC;IACtC,2GAA2G;IAC3G,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,gCAAgC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,uFAAuF;IACvF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IACzD,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACnD;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,mHAAmH;IACnH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CAChD,CAAC;AAKF,+DAA+D;AAC/D,wBAAsB,SAAS,CAAC,CAAC,SAAS,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAiDhG"}