@earendil-works/chord 1.5.0 → 1.5.1

package/dist/surfaces/connection.d.ts

@@ -0,0 +1,49 @@
+/** The first retry pause after a failed or short-lived connection: 250 ms, doubling from there. */
+export declare const RETRY_INITIAL_MS = 250;
+/** The longest retry pause: 5 s (and the pause while offline). */
+export declare const RETRY_MAX_MS = 5000;
+/** A connection that stayed open this long counted as working: the next retry starts at the initial pause again. */
+export declare const STABLE_MS = 10000;
+/** A socket not open after this long is given up (browsers have no handshake timeout). */
+export declare const CONNECT_TIMEOUT_MS = 20000;
+/** The server's heartbeat pings every 15 s: an open socket silent for longer than this is presumed dead on a wake. */
+export declare const STALE_MS = 25000;
+/** After a wake, messages held while the client was frozen get this long to arrive before the socket is judged. */
+export declare const WAKE_GRACE_MS = 1000;
+/** The connection as the app shows it: an attempt under way, open, or waiting for the next attempt. */
+export type ConnectionState = "connecting" | "connected" | "waiting";
+/** What one socket reports to the loop. */
+export interface SocketEvents {
+    opened(): void;
+    /** Any frame: the server's pings keep an open socket from looking silent. */
+    received(): void;
+}
+/** One attempt's connection as the loop sees it: it closes once, and closing it ends it at once. */
+export interface LoopLink {
+    onClose(listener: () => void): void;
+    close(): void;
+}
+/** What the loop runs in: the clock, timers, whether the device is online, and its wake events. */
+export interface LoopEnvironment {
+    now(): number;
+    /** Runs `callback` after `ms`; returns its cancel. */
+    after(ms: number, callback: () => void): () => void;
+    /** `false` when the device is known to be offline. */
+    online(): boolean;
+    /** Calls `listener` when the client may have been away (visible again, online, network changed); returns its removal. */
+    onWake(listener: () => void): () => void;
+}
+/** What the loop takes. */
+export type LoopOptions = {
+    /** Opens one socket and its link; the socket reports to `events`. */
+    readonly open: (events: SocketEvents) => LoopLink;
+    readonly onState: (state: ConnectionState) => void;
+    /** Asked after every close; `false` stops the loop. A rejection counts as `true` (unreachable, try again). */
+    readonly canRetry: () => Promise<boolean>;
+    readonly environment: LoopEnvironment;
+};
+/** Keeps a client connected until `stop`. */
+export declare function keepConnected(options: LoopOptions): {
+    stop(): void;
+};
+//# sourceMappingURL=connection.d.ts.map

package/dist/surfaces/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/surfaces/connection.ts"],"names":[],"mappings":"AAOA,mGAAmG;AACnG,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,kEAAkE;AAClE,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,oHAAoH;AACpH,eAAO,MAAM,SAAS,QAAS,CAAC;AAEhC,0FAA0F;AAC1F,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,sHAAsH;AACtH,eAAO,MAAM,QAAQ,QAAS,CAAC;AAE/B,mHAAmH;AACnH,eAAO,MAAM,aAAa,OAAO,CAAC;AAElC,uGAAuG;AACvG,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,CAAC;AAErE,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC5B,MAAM,IAAI,IAAI,CAAC;IACf,6EAA6E;IAC7E,QAAQ,IAAI,IAAI,CAAC;CACjB;AAED,oGAAoG;AACpG,MAAM,WAAW,QAAQ;IACxB,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACpC,KAAK,IAAI,IAAI,CAAC;CACd;AAED,mGAAmG;AACnG,MAAM,WAAW,eAAe;IAC/B,GAAG,IAAI,MAAM,CAAC;IACd,sDAAsD;IACtD,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACpD,sDAAsD;IACtD,MAAM,IAAI,OAAO,CAAC;IAClB,yHAAyH;IACzH,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CACzC;AAED,2BAA2B;AAC3B,MAAM,MAAM,WAAW,GAAG;IACzB,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,QAAQ,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IACnD,8GAA8G;IAC9G,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;CACtC,CAAC;AAEF,6CAA6C;AAC7C,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG;IAAE,IAAI,IAAI,IAAI,CAAA;CAAE,CAIpE"}

package/dist/surfaces/connection.js

@@ -0,0 +1,142 @@
+// The connection loop (slice 11 §2, decision "Slice 11, P6"; p2's `keepConnected`): a client keeps one link to the
+// server and replaces it when it ends. After a drop it reconnects after a growing pause (250 ms doubling to 5 s; a
+// connection that stayed open 10 s resets it), at once on a wake (visible again, back online, network changed); it
+// replaces an open socket silent past the server's ping interval on a wake, gives up a socket not open after 20 s, and
+// stops when the app's `canRetry` says no (an outdated client, a guest's ended share). The environment (time, timers,
+// wakes) is given, so the same loop runs in a page and in a terminal's sandbox.
+/** The first retry pause after a failed or short-lived connection: 250 ms, doubling from there. */
+export const RETRY_INITIAL_MS = 250;
+/** The longest retry pause: 5 s (and the pause while offline). */
+export const RETRY_MAX_MS = 5000;
+/** A connection that stayed open this long counted as working: the next retry starts at the initial pause again. */
+export const STABLE_MS = 10_000;
+/** A socket not open after this long is given up (browsers have no handshake timeout). */
+export const CONNECT_TIMEOUT_MS = 20_000;
+/** The server's heartbeat pings every 15 s: an open socket silent for longer than this is presumed dead on a wake. */
+export const STALE_MS = 25_000;
+/** After a wake, messages held while the client was frozen get this long to arrive before the socket is judged. */
+export const WAKE_GRACE_MS = 1000;
+/** Keeps a client connected until `stop`. */
+export function keepConnected(options) {
+    const loop = new Loop(options);
+    loop.connect();
+    return { stop: () => loop.stop() };
+}
+class Loop {
+    #options;
+    #env;
+    #removeWake;
+    #failures = 0;
+    #current;
+    #cancelRetry;
+    #cancelStaleCheck;
+    /** Between a close and `canRetry`'s answer; a wake meanwhile retries at once. */
+    #deciding = false;
+    #wokeWhileDeciding = false;
+    #stopped = false;
+    constructor(options) {
+        this.#options = options;
+        this.#env = options.environment;
+        this.#removeWake = this.#env.onWake(() => this.#wake());
+    }
+    /** Starts an attempt. */
+    connect() {
+        this.#cancelRetry = undefined;
+        const env = this.#env;
+        const attempt = {
+            link: undefined,
+            startedAt: env.now(),
+            openedAt: undefined,
+            lastFrame: env.now(),
+            cancelTimeout: () => { },
+        };
+        this.#current = attempt;
+        this.#options.onState("connecting");
+        const link = this.#options.open({
+            opened: () => {
+                if (this.#current !== attempt)
+                    return;
+                attempt.openedAt = attempt.lastFrame = env.now();
+                attempt.cancelTimeout();
+                this.#options.onState("connected");
+            },
+            received: () => {
+                attempt.lastFrame = env.now();
+            },
+        });
+        attempt.link = link;
+        attempt.cancelTimeout = env.after(CONNECT_TIMEOUT_MS, () => {
+            if (attempt.openedAt === undefined)
+                link.close();
+        });
+        link.onClose(() => this.#closed(attempt));
+    }
+    /** Stops the loop and closes the current link. */
+    stop() {
+        if (this.#stopped)
+            return;
+        this.#stopped = true;
+        this.#removeWake();
+        this.#cancelRetry?.();
+        this.#cancelRetry = undefined;
+        this.#current?.link?.close();
+    }
+    /** `attempt`'s link closed: asks `canRetry`, then schedules the next attempt. */
+    #closed(attempt) {
+        if (this.#current !== attempt)
+            return;
+        this.#current = undefined;
+        attempt.cancelTimeout();
+        this.#cancelStaleCheck?.();
+        this.#cancelStaleCheck = undefined;
+        if (this.#stopped)
+            return;
+        this.#options.onState("waiting");
+        const { openedAt } = attempt;
+        if (openedAt !== undefined && this.#env.now() - openedAt >= STABLE_MS)
+            this.#failures = 0;
+        this.#deciding = true;
+        this.#wokeWhileDeciding = false;
+        const decided = (retry) => {
+            this.#deciding = false;
+            if (retry)
+                this.#schedule(this.#wokeWhileDeciding);
+        };
+        this.#options.canRetry().then(decided, () => decided(true));
+    }
+    /** Schedules the next attempt: at once (`now`), else after the backoff (offline: the longest pause). */
+    #schedule(now) {
+        if (this.#stopped)
+            return;
+        const backoff = Math.min(RETRY_MAX_MS, RETRY_INITIAL_MS * 2 ** this.#failures);
+        this.#failures += 1;
+        // Offline an attempt fails at once; the `online` wake retries sooner than this.
+        const delay = now ? 0 : this.#env.online() ? backoff : RETRY_MAX_MS;
+        this.#cancelRetry = this.#env.after(delay, () => this.connect());
+    }
+    /** A wake: a pending retry runs now; an open socket silent too long is replaced once its overdue ping is checked. */
+    #wake() {
+        if (this.#cancelRetry !== undefined) {
+            this.#cancelRetry();
+            this.connect();
+            return;
+        }
+        if (this.#deciding) {
+            this.#wokeWhileDeciding = true;
+            return;
+        }
+        const attempt = this.#current;
+        // A connecting attempt has its own timeout.
+        if (attempt?.openedAt === undefined)
+            return;
+        this.#cancelStaleCheck?.();
+        // After a network change the socket looks fine until the server's next ping is missing: check when it is due.
+        const due = Math.max(WAKE_GRACE_MS, attempt.lastFrame + STALE_MS + 1 - this.#env.now());
+        this.#cancelStaleCheck = this.#env.after(due, () => {
+            this.#cancelStaleCheck = undefined;
+            if (this.#current === attempt && this.#env.now() - attempt.lastFrame > STALE_MS)
+                attempt.link?.close();
+        });
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/surfaces/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/surfaces/connection.ts"],"names":[],"mappings":"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","sourcesContent":["// The connection loop (slice 11 §2, decision \"Slice 11, P6\"; p2's `keepConnected`): a client keeps one link to the\n// server and replaces it when it ends. After a drop it reconnects after a growing pause (250 ms doubling to 5 s; a\n// connection that stayed open 10 s resets it), at once on a wake (visible again, back online, network changed); it\n// replaces an open socket silent past the server's ping interval on a wake, gives up a socket not open after 20 s, and\n// stops when the app's `canRetry` says no (an outdated client, a guest's ended share). The environment (time, timers,\n// wakes) is given, so the same loop runs in a page and in a terminal's sandbox.\n\n/** The first retry pause after a failed or short-lived connection: 250 ms, doubling from there. */\nexport const RETRY_INITIAL_MS = 250;\n\n/** The longest retry pause: 5 s (and the pause while offline). */\nexport const RETRY_MAX_MS = 5000;\n\n/** A connection that stayed open this long counted as working: the next retry starts at the initial pause again. */\nexport const STABLE_MS = 10_000;\n\n/** A socket not open after this long is given up (browsers have no handshake timeout). */\nexport const CONNECT_TIMEOUT_MS = 20_000;\n\n/** The server's heartbeat pings every 15 s: an open socket silent for longer than this is presumed dead on a wake. */\nexport const STALE_MS = 25_000;\n\n/** After a wake, messages held while the client was frozen get this long to arrive before the socket is judged. */\nexport const WAKE_GRACE_MS = 1000;\n\n/** The connection as the app shows it: an attempt under way, open, or waiting for the next attempt. */\nexport type ConnectionState = \"connecting\" | \"connected\" | \"waiting\";\n\n/** What one socket reports to the loop. */\nexport interface SocketEvents {\n\topened(): void;\n\t/** Any frame: the server's pings keep an open socket from looking silent. */\n\treceived(): void;\n}\n\n/** One attempt's connection as the loop sees it: it closes once, and closing it ends it at once. */\nexport interface LoopLink {\n\tonClose(listener: () => void): void;\n\tclose(): void;\n}\n\n/** What the loop runs in: the clock, timers, whether the device is online, and its wake events. */\nexport interface LoopEnvironment {\n\tnow(): number;\n\t/** Runs `callback` after `ms`; returns its cancel. */\n\tafter(ms: number, callback: () => void): () => void;\n\t/** `false` when the device is known to be offline. */\n\tonline(): boolean;\n\t/** Calls `listener` when the client may have been away (visible again, online, network changed); returns its removal. */\n\tonWake(listener: () => void): () => void;\n}\n\n/** What the loop takes. */\nexport type LoopOptions = {\n\t/** Opens one socket and its link; the socket reports to `events`. */\n\treadonly open: (events: SocketEvents) => LoopLink;\n\treadonly onState: (state: ConnectionState) => void;\n\t/** Asked after every close; `false` stops the loop. A rejection counts as `true` (unreachable, try again). */\n\treadonly canRetry: () => Promise<boolean>;\n\treadonly environment: LoopEnvironment;\n};\n\n/** Keeps a client connected until `stop`. */\nexport function keepConnected(options: LoopOptions): { stop(): void } {\n\tconst loop = new Loop(options);\n\tloop.connect();\n\treturn { stop: () => loop.stop() };\n}\n\n/** One attempt: its link, when it started and opened, its last frame, its timeout's cancel. */\ntype Attempt = {\n\tlink: LoopLink | undefined;\n\treadonly startedAt: number;\n\topenedAt: number | undefined;\n\tlastFrame: number;\n\tcancelTimeout: () => void;\n};\n\nclass Loop {\n\treadonly #options: LoopOptions;\n\treadonly #env: LoopEnvironment;\n\treadonly #removeWake: () => void;\n\t#failures = 0;\n\t#current: Attempt | undefined;\n\t#cancelRetry: (() => void) | undefined;\n\t#cancelStaleCheck: (() => void) | undefined;\n\t/** Between a close and `canRetry`'s answer; a wake meanwhile retries at once. */\n\t#deciding = false;\n\t#wokeWhileDeciding = false;\n\t#stopped = false;\n\n\tconstructor(options: LoopOptions) {\n\t\tthis.#options = options;\n\t\tthis.#env = options.environment;\n\t\tthis.#removeWake = this.#env.onWake(() => this.#wake());\n\t}\n\n\t/** Starts an attempt. */\n\tconnect(): void {\n\t\tthis.#cancelRetry = undefined;\n\t\tconst env = this.#env;\n\t\tconst attempt: Attempt = {\n\t\t\tlink: undefined,\n\t\t\tstartedAt: env.now(),\n\t\t\topenedAt: undefined,\n\t\t\tlastFrame: env.now(),\n\t\t\tcancelTimeout: () => {},\n\t\t};\n\t\tthis.#current = attempt;\n\t\tthis.#options.onState(\"connecting\");\n\t\tconst link = this.#options.open({\n\t\t\topened: () => {\n\t\t\t\tif (this.#current !== attempt) return;\n\t\t\t\tattempt.openedAt = attempt.lastFrame = env.now();\n\t\t\t\tattempt.cancelTimeout();\n\t\t\t\tthis.#options.onState(\"connected\");\n\t\t\t},\n\t\t\treceived: () => {\n\t\t\t\tattempt.lastFrame = env.now();\n\t\t\t},\n\t\t});\n\t\tattempt.link = link;\n\t\tattempt.cancelTimeout = env.after(CONNECT_TIMEOUT_MS, () => {\n\t\t\tif (attempt.openedAt === undefined) link.close();\n\t\t});\n\t\tlink.onClose(() => this.#closed(attempt));\n\t}\n\n\t/** Stops the loop and closes the current link. */\n\tstop(): void {\n\t\tif (this.#stopped) return;\n\t\tthis.#stopped = true;\n\t\tthis.#removeWake();\n\t\tthis.#cancelRetry?.();\n\t\tthis.#cancelRetry = undefined;\n\t\tthis.#current?.link?.close();\n\t}\n\n\t/** `attempt`'s link closed: asks `canRetry`, then schedules the next attempt. */\n\t#closed(attempt: Attempt): void {\n\t\tif (this.#current !== attempt) return;\n\t\tthis.#current = undefined;\n\t\tattempt.cancelTimeout();\n\t\tthis.#cancelStaleCheck?.();\n\t\tthis.#cancelStaleCheck = undefined;\n\t\tif (this.#stopped) return;\n\t\tthis.#options.onState(\"waiting\");\n\t\tconst { openedAt } = attempt;\n\t\tif (openedAt !== undefined && this.#env.now() - openedAt >= STABLE_MS) this.#failures = 0;\n\t\tthis.#deciding = true;\n\t\tthis.#wokeWhileDeciding = false;\n\t\tconst decided = (retry: boolean): void => {\n\t\t\tthis.#deciding = false;\n\t\t\tif (retry) this.#schedule(this.#wokeWhileDeciding);\n\t\t};\n\t\tthis.#options.canRetry().then(decided, () => decided(true));\n\t}\n\n\t/** Schedules the next attempt: at once (`now`), else after the backoff (offline: the longest pause). */\n\t#schedule(now: boolean): void {\n\t\tif (this.#stopped) return;\n\t\tconst backoff = Math.min(RETRY_MAX_MS, RETRY_INITIAL_MS * 2 ** this.#failures);\n\t\tthis.#failures += 1;\n\t\t// Offline an attempt fails at once; the `online` wake retries sooner than this.\n\t\tconst delay = now ? 0 : this.#env.online() ? backoff : RETRY_MAX_MS;\n\t\tthis.#cancelRetry = this.#env.after(delay, () => this.connect());\n\t}\n\n\t/** A wake: a pending retry runs now; an open socket silent too long is replaced once its overdue ping is checked. */\n\t#wake(): void {\n\t\tif (this.#cancelRetry !== undefined) {\n\t\t\tthis.#cancelRetry();\n\t\t\tthis.connect();\n\t\t\treturn;\n\t\t}\n\t\tif (this.#deciding) {\n\t\t\tthis.#wokeWhileDeciding = true;\n\t\t\treturn;\n\t\t}\n\t\tconst attempt = this.#current;\n\t\t// A connecting attempt has its own timeout.\n\t\tif (attempt?.openedAt === undefined) return;\n\t\tthis.#cancelStaleCheck?.();\n\t\t// After a network change the socket looks fine until the server's next ping is missing: check when it is due.\n\t\tconst due = Math.max(WAKE_GRACE_MS, attempt.lastFrame + STALE_MS + 1 - this.#env.now());\n\t\tthis.#cancelStaleCheck = this.#env.after(due, () => {\n\t\t\tthis.#cancelStaleCheck = undefined;\n\t\t\tif (this.#current === attempt && this.#env.now() - attempt.lastFrame > STALE_MS) attempt.link?.close();\n\t\t});\n\t}\n}\n"]}

package/dist/surfaces/format.d.ts

@@ -0,0 +1,5 @@
+/** A time (a `Date`, milliseconds, or an ISO string as messages carry it) in the current locale; `14:05` by default. */
+export declare function formatTime(at: Date | number | string, options?: Intl.DateTimeFormatOptions): string;
+/** A number in the current locale (`1.234,5` in German). */
+export declare function formatNumber(value: number, options?: Intl.NumberFormatOptions): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/surfaces/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/surfaces/format.ts"],"names":[],"mappings":"AAMA,wHAAwH;AACxH,wBAAgB,UAAU,CAAC,EAAE,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,GAAG,MAAM,CAOnG;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAOtF"}

package/dist/surfaces/format.js

@@ -0,0 +1,37 @@
+// Dates, times and numbers in the viewer's locale (decision "Messages and languages in the app kit" (1)): `Intl` with
+// the current language's locale, so a message function's `formatTime(at)` follows the language it renders in. Outside a
+// render the platform's default locale applies. A language's default formatters are made once, kept as long as it is.
+import { currentLanguage } from "./language.js";
+/** A time (a `Date`, milliseconds, or an ISO string as messages carry it) in the current locale; `14:05` by default. */
+export function formatTime(at, options) {
+    const language = currentLanguage();
+    const format = options === undefined && language !== undefined
+        ? formattersOf(language).time
+        : new Intl.DateTimeFormat(language?.locale, options ?? TIME);
+    return format.format(new Date(at));
+}
+/** A number in the current locale (`1.234,5` in German). */
+export function formatNumber(value, options) {
+    const language = currentLanguage();
+    const format = options === undefined && language !== undefined
+        ? formattersOf(language).number
+        : new Intl.NumberFormat(language?.locale, options);
+    return format.format(value);
+}
+/** `formatTime`'s default: hours and minutes. */
+const TIME = { timeStyle: "short" };
+/** The default formatters of each language, made at its first use: a formatter costs far more than a format. */
+const FORMATTERS = new WeakMap();
+/** `language`'s default formatters. */
+function formattersOf(language) {
+    let formatters = FORMATTERS.get(language);
+    if (formatters === undefined) {
+        formatters = {
+            time: new Intl.DateTimeFormat(language.locale, TIME),
+            number: new Intl.NumberFormat(language.locale),
+        };
+        FORMATTERS.set(language, formatters);
+    }
+    return formatters;
+}
+//# sourceMappingURL=format.js.map

package/dist/surfaces/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/surfaces/format.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,wHAAwH;AACxH,sHAAsH;AAEtH,OAAO,EAAE,eAAe,EAAiB,MAAM,eAAe,CAAC;AAE/D,wHAAwH;AACxH,MAAM,UAAU,UAAU,CAAC,EAA0B,EAAE,OAAoC;IAC1F,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,MAAM,MAAM,GACX,OAAO,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS;QAC9C,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,IAAI;QAC7B,CAAC,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC,CAAC;IAC/D,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,OAAkC;IAC7E,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,MAAM,MAAM,GACX,OAAO,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS;QAC9C,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,MAAM;QAC/B,CAAC,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,iDAAiD;AACjD,MAAM,IAAI,GAA+B,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AAKhE,gHAAgH;AAChH,MAAM,UAAU,GAAG,IAAI,OAAO,EAAwB,CAAC;AAEvD,uCAAuC;AACvC,SAAS,YAAY,CAAC,QAAkB;IACvC,IAAI,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC9B,UAAU,GAAG;YACZ,IAAI,EAAE,IAAI,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;YACpD,MAAM,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;SAC9C,CAAC;QACF,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,UAAU,CAAC;AACnB,CAAC","sourcesContent":["// Dates, times and numbers in the viewer's locale (decision \"Messages and languages in the app kit\" (1)): `Intl` with\n// the current language's locale, so a message function's `formatTime(at)` follows the language it renders in. Outside a\n// render the platform's default locale applies. A language's default formatters are made once, kept as long as it is.\n\nimport { currentLanguage, type Language } from \"./language.ts\";\n\n/** A time (a `Date`, milliseconds, or an ISO string as messages carry it) in the current locale; `14:05` by default. */\nexport function formatTime(at: Date | number | string, options?: Intl.DateTimeFormatOptions): string {\n\tconst language = currentLanguage();\n\tconst format =\n\t\toptions === undefined && language !== undefined\n\t\t\t? formattersOf(language).time\n\t\t\t: new Intl.DateTimeFormat(language?.locale, options ?? TIME);\n\treturn format.format(new Date(at));\n}\n\n/** A number in the current locale (`1.234,5` in German). */\nexport function formatNumber(value: number, options?: Intl.NumberFormatOptions): string {\n\tconst language = currentLanguage();\n\tconst format =\n\t\toptions === undefined && language !== undefined\n\t\t\t? formattersOf(language).number\n\t\t\t: new Intl.NumberFormat(language?.locale, options);\n\treturn format.format(value);\n}\n\n/** `formatTime`'s default: hours and minutes. */\nconst TIME: Intl.DateTimeFormatOptions = { timeStyle: \"short\" };\n\n/** A language's default formatters. */\ntype Formatters = { readonly time: Intl.DateTimeFormat; readonly number: Intl.NumberFormat };\n\n/** The default formatters of each language, made at its first use: a formatter costs far more than a format. */\nconst FORMATTERS = new WeakMap<Language, Formatters>();\n\n/** `language`'s default formatters. */\nfunction formattersOf(language: Language): Formatters {\n\tlet formatters = FORMATTERS.get(language);\n\tif (formatters === undefined) {\n\t\tformatters = {\n\t\t\ttime: new Intl.DateTimeFormat(language.locale, TIME),\n\t\t\tnumber: new Intl.NumberFormat(language.locale),\n\t\t};\n\t\tFORMATTERS.set(language, formatters);\n\t}\n\treturn formatters;\n}\n"]}

package/dist/surfaces/index.d.ts

@@ -0,0 +1,15 @@
+export { followActiveLanguage, hostLanguage, type LanguageFollower } from "./active-language.ts";
+export { followActiveTheme, type ThemeFollower } from "./active-theme.ts";
+export { type Client, type ClientError, type ClientOptions, type ClientStyles, startClient, } from "./client.ts";
+export { type ConnectionState, keepConnected, type LoopEnvironment, type LoopLink, type LoopOptions, type SocketEvents, } from "./connection.ts";
+export { formatNumber, formatTime } from "./format.ts";
+export { createLanguage, type Language, type MessagesReport } from "./language.ts";
+export { LoadedFacets, type Prepared, type SetEntry } from "./loaded.ts";
+export { LocaleChoice, localeChoiceFacet } from "./locale-choice.ts";
+export { type Catalog, type CatalogShape, type DataKeys, defineMessages, type MessageArgs, type MessageData, type MessageParam, MessageSchema, type Messages, type MessagesOf, type MessageValue, type Translator, } from "./messages.ts";
+export { type ClientModules, evaluateRegistered, type FacetFunction, REGISTER, type RegisteredScript, registeredSource, } from "./registered.ts";
+export { type ScriptEntry, ScriptSet, type ScriptsContract, TuiScripts, WebScripts } from "./scripts.ts";
+export { ThemeChoice, themeChoiceFacet } from "./theme-choice.ts";
+export { activeTheme, BASE_ROLES, type BaseRole, type ColorDepth, FALLBACK_THEMES, type Theme, type ThemePick, Themes, terminalColor, themesFacet, themeVariables, } from "./themes.ts";
+export { type Translation, type TranslationIndex, Translations, translationsFacet, } from "./translations.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/surfaces/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EACN,KAAK,MAAM,EACX,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,WAAW,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,KAAK,eAAe,EACpB,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,YAAY,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EACN,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,aAAa,EACb,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,UAAU,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,KAAK,aAAa,EAClB,kBAAkB,EAClB,KAAK,aAAa,EAClB,QAAQ,EACR,KAAK,gBAAgB,EACrB,gBAAgB,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,WAAW,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACzG,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EACN,WAAW,EACX,UAAU,EACV,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,eAAe,EACf,KAAK,KAAK,EACV,KAAK,SAAS,EACd,MAAM,EACN,aAAa,EACb,WAAW,EACX,cAAc,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,YAAY,EACZ,iBAAiB,GACjB,MAAM,mBAAmB,CAAC"}

package/dist/surfaces/index.js

@@ -0,0 +1,18 @@
+// The client surfaces' portable part (slice 11): the scripts objects a server serves and clients hold, plugin scripts
+// that register themselves, a client host kept connected and current, a host's loaded plugins, themes, and messages and
+// languages.
+export { followActiveLanguage, hostLanguage } from "./active-language.js";
+export { followActiveTheme } from "./active-theme.js";
+export { startClient, } from "./client.js";
+export { keepConnected, } from "./connection.js";
+export { formatNumber, formatTime } from "./format.js";
+export { createLanguage } from "./language.js";
+export { LoadedFacets } from "./loaded.js";
+export { LocaleChoice, localeChoiceFacet } from "./locale-choice.js";
+export { defineMessages, MessageSchema, } from "./messages.js";
+export { evaluateRegistered, REGISTER, registeredSource, } from "./registered.js";
+export { ScriptSet, TuiScripts, WebScripts } from "./scripts.js";
+export { ThemeChoice, themeChoiceFacet } from "./theme-choice.js";
+export { activeTheme, BASE_ROLES, FALLBACK_THEMES, Themes, terminalColor, themesFacet, themeVariables, } from "./themes.js";
+export { Translations, translationsFacet, } from "./translations.js";
+//# sourceMappingURL=index.js.map

package/dist/surfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/surfaces/index.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,wHAAwH;AACxH,aAAa;AAEb,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAyB,MAAM,sBAAsB,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAsB,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAKN,WAAW,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EAEN,aAAa,GAKb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,cAAc,EAAsC,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,YAAY,EAAgC,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAIN,cAAc,EAId,aAAa,GAKb,MAAM,eAAe,CAAC;AACvB,OAAO,EAEN,kBAAkB,EAElB,QAAQ,EAER,gBAAgB,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAoB,SAAS,EAAwB,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACzG,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EACN,WAAW,EACX,UAAU,EAGV,eAAe,EAGf,MAAM,EACN,aAAa,EACb,WAAW,EACX,cAAc,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAGN,YAAY,EACZ,iBAAiB,GACjB,MAAM,mBAAmB,CAAC","sourcesContent":["// The client surfaces' portable part (slice 11): the scripts objects a server serves and clients hold, plugin scripts\n// that register themselves, a client host kept connected and current, a host's loaded plugins, themes, and messages and\n// languages.\n\nexport { followActiveLanguage, hostLanguage, type LanguageFollower } from \"./active-language.ts\";\nexport { followActiveTheme, type ThemeFollower } from \"./active-theme.ts\";\nexport {\n\ttype Client,\n\ttype ClientError,\n\ttype ClientOptions,\n\ttype ClientStyles,\n\tstartClient,\n} from \"./client.ts\";\nexport {\n\ttype ConnectionState,\n\tkeepConnected,\n\ttype LoopEnvironment,\n\ttype LoopLink,\n\ttype LoopOptions,\n\ttype SocketEvents,\n} from \"./connection.ts\";\nexport { formatNumber, formatTime } from \"./format.ts\";\nexport { createLanguage, type Language, type MessagesReport } from \"./language.ts\";\nexport { LoadedFacets, type Prepared, type SetEntry } from \"./loaded.ts\";\nexport { LocaleChoice, localeChoiceFacet } from \"./locale-choice.ts\";\nexport {\n\ttype Catalog,\n\ttype CatalogShape,\n\ttype DataKeys,\n\tdefineMessages,\n\ttype MessageArgs,\n\ttype MessageData,\n\ttype MessageParam,\n\tMessageSchema,\n\ttype Messages,\n\ttype MessagesOf,\n\ttype MessageValue,\n\ttype Translator,\n} from \"./messages.ts\";\nexport {\n\ttype ClientModules,\n\tevaluateRegistered,\n\ttype FacetFunction,\n\tREGISTER,\n\ttype RegisteredScript,\n\tregisteredSource,\n} from \"./registered.ts\";\nexport { type ScriptEntry, ScriptSet, type ScriptsContract, TuiScripts, WebScripts } from \"./scripts.ts\";\nexport { ThemeChoice, themeChoiceFacet } from \"./theme-choice.ts\";\nexport {\n\tactiveTheme,\n\tBASE_ROLES,\n\ttype BaseRole,\n\ttype ColorDepth,\n\tFALLBACK_THEMES,\n\ttype Theme,\n\ttype ThemePick,\n\tThemes,\n\tterminalColor,\n\tthemesFacet,\n\tthemeVariables,\n} from \"./themes.ts\";\nexport {\n\ttype Translation,\n\ttype TranslationIndex,\n\tTranslations,\n\ttranslationsFacet,\n} from \"./translations.ts\";\n"]}

package/dist/surfaces/language.d.ts

@@ -0,0 +1,53 @@
+import { type TranslationIndex } from "./translations.ts";
+/** A locale to render in: its direction, its fallback chain, the host's catalogs and the reports' destination. */
+export type Language = {
+    /** A canonical language tag (`de`, `pt-BR`). */
+    readonly locale: string;
+    readonly dir: "ltr" | "rtl";
+    /** The locales tried in order before a namespace's first catalog: `pt-BR`, `pt`. */
+    readonly chain: readonly string[];
+    readonly translations: TranslationIndex;
+    readonly report: (report: MessagesReport) => void;
+};
+/** What rendering reports: a key found only further down the chain, a contributed message that threw, a foreign message. */
+export type MessagesReport = {
+    readonly kind: "fallback";
+    readonly namespace: string;
+    readonly locale: string;
+    readonly key: string;
+    /** The locale whose catalog had the key; `undefined`: the namespace's first catalog. */
+    readonly used: string | undefined;
+} | {
+    readonly kind: "failed";
+    readonly namespace: string;
+    readonly locale: string;
+    readonly key: string;
+    /** The contributing plugin; `undefined`: the namespace's own catalogs (a message from a link that does not fit). */
+    readonly plugin: string | undefined;
+    readonly error: unknown;
+}
+/** `t.render` got a message of another namespace or a key the catalogs do not have: it shows the key. */
+ | {
+    readonly kind: "unknown";
+    readonly namespace: string;
+    readonly key: string;
+    readonly expected: string;
+};
+/** The language `locale` (canonical) with the host's `translations`; `report` gets every report as it happens. */
+export declare function createLanguage(locale: string, translations: TranslationIndex, report: (report: MessagesReport) => void): Language;
+/** Runs `render` with `language` as the current language (synchronous: the language is gone when it returns). */
+export declare function inLanguage<T>(language: Language | undefined, render: () => T): T;
+/** The current language: the render under way's, `undefined` outside one. */
+export declare function currentLanguage(): Language | undefined;
+/**
+ * The locale to use: the user's `pick` when a catalog offers it (or its base), else the first of the device's
+ * `preferred` some catalog offers, else English (the source of truth) when offered, else the first offered, else `en`.
+ */
+export declare function resolveLocale(pick: string | null, preferred: readonly string[], offered: readonly string[]): string;
+/**
+ * The first of `preferred` that `offered` (canonical tags) has: itself, one of its bases (`de-CH` for `de-CH-1996`, then
+ * `de`), or another of its language (`de-DE` for `de-AT`); `undefined` when none matches. Invalid tags are skipped
+ * (the device's list is the platform's data).
+ */
+export declare function matchLocale(preferred: readonly string[], offered: readonly string[]): string | undefined;
+//# sourceMappingURL=language.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"language.d.ts","sourceRoot":"","sources":["../../src/surfaces/language.ts"],"names":[],"mappings":"AAOA,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE3E,kHAAkH;AAClH,MAAM,MAAM,QAAQ,GAAG;IACtB,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,KAAK,GAAG,KAAK,CAAC;IAC5B,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;CAClD,CAAC;AAEF,4HAA4H;AAC5H,MAAM,MAAM,cAAc,GACvB;IACA,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,GACD;IACA,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,oHAAoH;IACpH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACvB;AACH,yGAAyG;GACvG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7G,kHAAkH;AAClH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,gBAAgB,EAC9B,MAAM,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,GACtC,QAAQ,CAEV;AAKD,iHAAiH;AACjH,wBAAgB,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAQhF;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,IAAI,QAAQ,GAAG,SAAS,CAEtD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAMnH;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAWxG"}

package/dist/surfaces/language.js

@@ -0,0 +1,74 @@
+// A language and rendering in it (decision "Messages and languages in the app kit" (1), (3), refined in the build): a
+// `Language` is a locale with its text direction, the host's composed catalogs and where fallbacks are reported. A
+// render is synchronous, and while one runs its language is the current one: a message function's own `formatTime` or a
+// plain `t(...)` it calls renders in it. Outside a render there is no current language (a server, a test, a log line):
+// `t` renders the first catalog. No module-wide setting (the current language exists only while a render runs): one
+// process runs many hosts, and a server renders per recipient.
+import { canonicalLocale } from "./translations.js";
+/** The language `locale` (canonical) with the host's `translations`; `report` gets every report as it happens. */
+export function createLanguage(locale, translations, report) {
+    return { locale, dir: directionOf(locale), chain: chainOf(locale), translations, report };
+}
+/** The language of the render under way; `undefined` outside one. */
+let rendering;
+/** Runs `render` with `language` as the current language (synchronous: the language is gone when it returns). */
+export function inLanguage(language, render) {
+    const outer = rendering;
+    rendering = language;
+    try {
+        return render();
+    }
+    finally {
+        rendering = outer;
+    }
+}
+/** The current language: the render under way's, `undefined` outside one. */
+export function currentLanguage() {
+    return rendering;
+}
+/**
+ * The locale to use: the user's `pick` when a catalog offers it (or its base), else the first of the device's
+ * `preferred` some catalog offers, else English (the source of truth) when offered, else the first offered, else `en`.
+ */
+export function resolveLocale(pick, preferred, offered) {
+    return (matchLocale(pick === null ? [] : [pick], offered) ??
+        matchLocale(preferred, offered) ??
+        (offered.includes("en") ? "en" : (offered[0] ?? "en")));
+}
+/**
+ * The first of `preferred` that `offered` (canonical tags) has: itself, one of its bases (`de-CH` for `de-CH-1996`, then
+ * `de`), or another of its language (`de-DE` for `de-AT`); `undefined` when none matches. Invalid tags are skipped
+ * (the device's list is the platform's data).
+ */
+export function matchLocale(preferred, offered) {
+    for (const wanted of preferred) {
+        const locale = canonicalLocale(wanted);
+        if (locale === undefined)
+            continue;
+        const exact = chainOf(locale).find((each) => offered.includes(each));
+        if (exact !== undefined)
+            return exact;
+        const language = baseLanguage(locale);
+        const related = offered.find((each) => baseLanguage(each) === language);
+        if (related !== undefined)
+            return related;
+    }
+    return undefined;
+}
+/** `locale` and its bases, longest first: `zh-Hant-TW`, `zh-Hant`, `zh`. */
+function chainOf(locale) {
+    const parts = locale.split("-");
+    return parts.map((_, index) => parts.slice(0, parts.length - index).join("-"));
+}
+/** The language subtag of a canonical tag (`pt` of `pt-BR`). */
+function baseLanguage(locale) {
+    return locale.split("-")[0];
+}
+/** The scripts written right to left (ISO 15924), as `Intl.Locale` maximizes a tag's script. */
+const RTL_SCRIPTS = new Set(["Adlm", "Arab", "Hebr", "Mand", "Nkoo", "Rohg", "Samr", "Syrc", "Thaa", "Yezi"]);
+/** The text direction of `locale`: right to left when its likely script is (Arabic for `ar`, `ur`, `fa`). */
+function directionOf(locale) {
+    const script = new Intl.Locale(locale).maximize().script;
+    return script !== undefined && RTL_SCRIPTS.has(script) ? "rtl" : "ltr";
+}
+//# sourceMappingURL=language.js.map

package/dist/surfaces/language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.js","sourceRoot":"","sources":["../../src/surfaces/language.ts"],"names":[],"mappings":"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","sourcesContent":["// A language and rendering in it (decision \"Messages and languages in the app kit\" (1), (3), refined in the build): a\n// `Language` is a locale with its text direction, the host's composed catalogs and where fallbacks are reported. A\n// render is synchronous, and while one runs its language is the current one: a message function's own `formatTime` or a\n// plain `t(...)` it calls renders in it. Outside a render there is no current language (a server, a test, a log line):\n// `t` renders the first catalog. No module-wide setting (the current language exists only while a render runs): one\n// process runs many hosts, and a server renders per recipient.\n\nimport { canonicalLocale, type TranslationIndex } from \"./translations.ts\";\n\n/** A locale to render in: its direction, its fallback chain, the host's catalogs and the reports' destination. */\nexport type Language = {\n\t/** A canonical language tag (`de`, `pt-BR`). */\n\treadonly locale: string;\n\treadonly dir: \"ltr\" | \"rtl\";\n\t/** The locales tried in order before a namespace's first catalog: `pt-BR`, `pt`. */\n\treadonly chain: readonly string[];\n\treadonly translations: TranslationIndex;\n\treadonly report: (report: MessagesReport) => void;\n};\n\n/** What rendering reports: a key found only further down the chain, a contributed message that threw, a foreign message. */\nexport type MessagesReport =\n\t| {\n\t\t\treadonly kind: \"fallback\";\n\t\t\treadonly namespace: string;\n\t\t\treadonly locale: string;\n\t\t\treadonly key: string;\n\t\t\t/** The locale whose catalog had the key; `undefined`: the namespace's first catalog. */\n\t\t\treadonly used: string | undefined;\n\t  }\n\t| {\n\t\t\treadonly kind: \"failed\";\n\t\t\treadonly namespace: string;\n\t\t\treadonly locale: string;\n\t\t\treadonly key: string;\n\t\t\t/** The contributing plugin; `undefined`: the namespace's own catalogs (a message from a link that does not fit). */\n\t\t\treadonly plugin: string | undefined;\n\t\t\treadonly error: unknown;\n\t  }\n\t/** `t.render` got a message of another namespace or a key the catalogs do not have: it shows the key. */\n\t| { readonly kind: \"unknown\"; readonly namespace: string; readonly key: string; readonly expected: string };\n\n/** The language `locale` (canonical) with the host's `translations`; `report` gets every report as it happens. */\nexport function createLanguage(\n\tlocale: string,\n\ttranslations: TranslationIndex,\n\treport: (report: MessagesReport) => void,\n): Language {\n\treturn { locale, dir: directionOf(locale), chain: chainOf(locale), translations, report };\n}\n\n/** The language of the render under way; `undefined` outside one. */\nlet rendering: Language | undefined;\n\n/** Runs `render` with `language` as the current language (synchronous: the language is gone when it returns). */\nexport function inLanguage<T>(language: Language | undefined, render: () => T): T {\n\tconst outer = rendering;\n\trendering = language;\n\ttry {\n\t\treturn render();\n\t} finally {\n\t\trendering = outer;\n\t}\n}\n\n/** The current language: the render under way's, `undefined` outside one. */\nexport function currentLanguage(): Language | undefined {\n\treturn rendering;\n}\n\n/**\n * The locale to use: the user's `pick` when a catalog offers it (or its base), else the first of the device's\n * `preferred` some catalog offers, else English (the source of truth) when offered, else the first offered, else `en`.\n */\nexport function resolveLocale(pick: string | null, preferred: readonly string[], offered: readonly string[]): string {\n\treturn (\n\t\tmatchLocale(pick === null ? [] : [pick], offered) ??\n\t\tmatchLocale(preferred, offered) ??\n\t\t(offered.includes(\"en\") ? \"en\" : (offered[0] ?? \"en\"))\n\t);\n}\n\n/**\n * The first of `preferred` that `offered` (canonical tags) has: itself, one of its bases (`de-CH` for `de-CH-1996`, then\n * `de`), or another of its language (`de-DE` for `de-AT`); `undefined` when none matches. Invalid tags are skipped\n * (the device's list is the platform's data).\n */\nexport function matchLocale(preferred: readonly string[], offered: readonly string[]): string | undefined {\n\tfor (const wanted of preferred) {\n\t\tconst locale = canonicalLocale(wanted);\n\t\tif (locale === undefined) continue;\n\t\tconst exact = chainOf(locale).find((each) => offered.includes(each));\n\t\tif (exact !== undefined) return exact;\n\t\tconst language = baseLanguage(locale);\n\t\tconst related = offered.find((each) => baseLanguage(each) === language);\n\t\tif (related !== undefined) return related;\n\t}\n\treturn undefined;\n}\n\n/** `locale` and its bases, longest first: `zh-Hant-TW`, `zh-Hant`, `zh`. */\nfunction chainOf(locale: string): readonly string[] {\n\tconst parts = locale.split(\"-\");\n\treturn parts.map((_, index) => parts.slice(0, parts.length - index).join(\"-\"));\n}\n\n/** The language subtag of a canonical tag (`pt` of `pt-BR`). */\nfunction baseLanguage(locale: string): string {\n\treturn locale.split(\"-\")[0]!;\n}\n\n/** The scripts written right to left (ISO 15924), as `Intl.Locale` maximizes a tag's script. */\nconst RTL_SCRIPTS = new Set([\"Adlm\", \"Arab\", \"Hebr\", \"Mand\", \"Nkoo\", \"Rohg\", \"Samr\", \"Syrc\", \"Thaa\", \"Yezi\"]);\n\n/** The text direction of `locale`: right to left when its likely script is (Arabic for `ar`, `ur`, `fa`). */\nfunction directionOf(locale: string): Language[\"dir\"] {\n\tconst script = new Intl.Locale(locale).maximize().script;\n\treturn script !== undefined && RTL_SCRIPTS.has(script) ? \"rtl\" : \"ltr\";\n}\n"]}

package/dist/surfaces/loaded.d.ts

@@ -0,0 +1,42 @@
+import type { Context } from "../context/index.ts";
+import { type Principal } from "../data/index.ts";
+import type { Facet, Host, LoadReport, PluginFacet, ReloadReport } from "../host/index.ts";
+/** A plugin's facet for a host, or why there is none: its script failed. */
+export type Prepared = {
+    readonly kind: "facet";
+    readonly facet: Facet<Principal>;
+    readonly digest: string;
+} | {
+    readonly kind: "failed";
+    readonly error: unknown;
+};
+/**
+ * One plugin of a complete set: its name, its script's digest (`undefined` when its build failed: nothing to compare)
+ * and how to get its facet (evaluated only when the digest is new).
+ */
+export type SetEntry = {
+    readonly name: string;
+    readonly digest: string | undefined;
+    prepare(): Prepared;
+};
+/** A host's loaded plugins: its core facets, each plugin's loaded facet, and its reloads, one after another. */
+export declare class LoadedFacets {
+    #private;
+    private constructor();
+    /**
+     * Prepares `entries` and loads them on `host` with `core` (the app's own facets): a plugin whose script failed is left
+     * out and reported in the report's `failed`, with the host's own. The host's loaded plugins, and the report.
+     */
+    static load<P extends Principal>(host: Host<P>, core: readonly PluginFacet<P>[], entries: readonly SetEntry[], context: Context): Promise<{
+        readonly loaded: LoadedFacets;
+        readonly report: LoadReport;
+    }>;
+    /**
+     * Reloads `host` with `entries`, the complete set now, after its earlier reloads: core facets and unchanged plugins as
+     * the same objects, new scripts prepared, a plugin whose script failed passed as its loaded facet (an added one left
+     * out; both named to the host's closure rule), plugins not in `entries` left out. What the host committed becomes
+     * the loaded set, also when the reload rejects `aborted` after its commit.
+     */
+    reload<P extends Principal>(host: Host<P>, entries: readonly SetEntry[], context: Context): Promise<ReloadReport>;
+}
+//# sourceMappingURL=loaded.d.ts.map

package/dist/surfaces/loaded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loaded.d.ts","sourceRoot":"","sources":["../../src/surfaces/loaded.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAEX,KAAK,EACL,IAAI,EACJ,UAAU,EACV,WAAW,EAEX,YAAY,EACZ,MAAM,kBAAkB,CAAC;AAE1B,4EAA4E;AAC5E,MAAM,MAAM,QAAQ,GACjB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrF;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAExD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,OAAO,IAAI,QAAQ,CAAA;CAAE,CAAC;AAK3G,gHAAgH;AAChH,qBAAa,YAAY;;IAKxB,OAAO,eAGN;IAED;;;OAGG;IACH,OAAa,IAAI,CAAC,CAAC,SAAS,SAAS,EACpC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EACb,IAAI,EAAE,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,EAC/B,OAAO,EAAE,SAAS,QAAQ,EAAE,EAC5B,OAAO,EAAE,OAAO,GACd,OAAO,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;KAAE,CAAC,CAkBzE;IAED;;;;;OAKG;IACH,MAAM,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAUhH;CAuDD"}