@earendil-works/chord 1.5.0 → 1.5.1

package/dist/surfaces/registered.d.ts

@@ -0,0 +1,33 @@
+import type { Principal } from "../data/index.ts";
+import type { Facet } from "../host/index.ts";
+/** The global function a registered script calls: defined by the client before any plugin script runs. */
+export declare const REGISTER = "chordFacet";
+/** A built facet's function, as its script registers it. */
+export type FacetFunction = (require: (specifier: string) => unknown, module: {
+    exports: unknown;
+}, exports: unknown) => void;
+/** One registered script: its plugin, its digest and its function. */
+export type RegisteredScript = {
+    readonly plugin: string;
+    readonly digest: string;
+    readonly run: FacetFunction;
+};
+/** The modules a client's plugin scripts import, by specifier (the app's API modules for the kind, React, ...). */
+export type ClientModules = Readonly<Record<string, unknown>>;
+/**
+ * The text of a registered script for `plugin`'s facet built as `source` (one function expression, the build's
+ * wrapped CommonJS script) with `digest`. Its source map comment stays on its own line, before the closing call.
+ */
+export declare function registeredSource(plugin: string, digest: string, source: string): string;
+/**
+ * Runs `script`'s function and returns its facet (its default export). Its `require` answers `modules` only (the build
+ * kept nothing else external for a client kind); anything else throws naming the plugin. Throws what the script throws,
+ * and when its default export is no facet.
+ */
+export declare function evaluateRegistered<P extends Principal = Principal>(script: RegisteredScript, modules: ClientModules): Facet<P>;
+/**
+ * A host package as a CommonJS script imports it: an ESM namespace wrapped once with `__esModule` (so esbuild's interop
+ * reads its `default` for a default import, its names for named ones), any other value as it is.
+ */
+export declare function interop(value: unknown): unknown;
+//# sourceMappingURL=registered.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registered.d.ts","sourceRoot":"","sources":["../../src/surfaces/registered.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,0GAA0G;AAC1G,eAAO,MAAM,QAAQ,eAAe,CAAC;AAErC,4DAA4D;AAC5D,MAAM,MAAM,aAAa,GAAG,CAC3B,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,EACvC,MAAM,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,EAC5B,OAAO,EAAE,OAAO,KACZ,IAAI,CAAC;AAEV,sEAAsE;AACtE,MAAM,MAAM,gBAAgB,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAA;CAAE,CAAC;AAEjH,mHAAmH;AACnH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EACjE,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,aAAa,GACpB,KAAK,CAAC,CAAC,CAAC,CAiBV;AAKD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAU/C"}

package/dist/surfaces/registered.js

@@ -0,0 +1,51 @@
+// Plugin scripts that register themselves (slice 11 §1, §2, decision "Slice 11's points" (P2)): a facet's built script
+// served as `chordFacet("<plugin>", "<digest>", function (require, module, exports) { … })`, loaded with `<script src>`
+// (a page under a `'self'` CSP: no `eval`, no `new Function`) or run by the terminal's runtime; the client evaluates the
+// registered function with a `require` that answers only its host packages.
+/** The global function a registered script calls: defined by the client before any plugin script runs. */
+export const REGISTER = "chordFacet";
+/**
+ * The text of a registered script for `plugin`'s facet built as `source` (one function expression, the build's
+ * wrapped CommonJS script) with `digest`. Its source map comment stays on its own line, before the closing call.
+ */
+export function registeredSource(plugin, digest, source) {
+    return `${REGISTER}(${JSON.stringify(plugin)},${JSON.stringify(digest)},${source}\n);\n`;
+}
+/**
+ * Runs `script`'s function and returns its facet (its default export). Its `require` answers `modules` only (the build
+ * kept nothing else external for a client kind); anything else throws naming the plugin. Throws what the script throws,
+ * and when its default export is no facet.
+ */
+export function evaluateRegistered(script, modules) {
+    const where = `plugin "${script.plugin}"`;
+    const module = { exports: {} };
+    script.run((specifier) => {
+        if (Object.hasOwn(modules, specifier))
+            return interop(modules[specifier]);
+        throw new Error(`${where}: "${specifier}" is not one of this client's host packages`);
+    }, module, module.exports);
+    // A trust boundary: plugin code; its default export is checked to be a facet.
+    const facet = module.exports?.default;
+    if (typeof facet !== "object" || facet === null || typeof facet.setup !== "function") {
+        throw new Error(`${where}: its default export is not a facet (defineFacet)`);
+    }
+    return facet;
+}
+/** ESM namespaces wrapped for a CommonJS script, by namespace: one wrapper per namespace, held as long as it is. */
+const wrapped = new WeakMap();
+/**
+ * A host package as a CommonJS script imports it: an ESM namespace wrapped once with `__esModule` (so esbuild's interop
+ * reads its `default` for a default import, its names for named ones), any other value as it is.
+ */
+export function interop(value) {
+    if (typeof value !== "object" || value === null || Object.prototype.toString.call(value) !== "[object Module]") {
+        return value;
+    }
+    let made = wrapped.get(value);
+    if (made === undefined) {
+        made = { ...value, __esModule: true };
+        wrapped.set(value, made);
+    }
+    return made;
+}
+//# sourceMappingURL=registered.js.map

package/dist/surfaces/registered.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registered.js","sourceRoot":"","sources":["../../src/surfaces/registered.ts"],"names":[],"mappings":"AAAA,uHAAuH;AACvH,wHAAwH;AACxH,yHAAyH;AACzH,4EAA4E;AAK5E,0GAA0G;AAC1G,MAAM,CAAC,MAAM,QAAQ,GAAG,YAAY,CAAC;AAerC;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,MAAc,EAAE,MAAc;IAC9E,OAAO,GAAG,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,QAAQ,CAAC;AAC1F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CACjC,MAAwB,EACxB,OAAsB;IAEtB,MAAM,KAAK,GAAG,WAAW,MAAM,CAAC,MAAM,GAAG,CAAC;IAC1C,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,EAAa,EAAE,CAAC;IAC1C,MAAM,CAAC,GAAG,CACT,CAAC,SAAS,EAAE,EAAE;QACb,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,MAAM,SAAS,6CAA6C,CAAC,CAAC;IACvF,CAAC,EACD,MAAM,EACN,MAAM,CAAC,OAAO,CACd,CAAC;IACF,8EAA8E;IAC9E,MAAM,KAAK,GAAI,MAAM,CAAC,OAAiD,EAAE,OAAO,CAAC;IACjF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAQ,KAA6B,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAC/G,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,mDAAmD,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,KAAiB,CAAC;AAC1B,CAAC;AAED,oHAAoH;AACpH,MAAM,OAAO,GAAG,IAAI,OAAO,EAAkB,CAAC;AAE9C;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,iBAAiB,EAAE,CAAC;QAChH,OAAO,KAAK,CAAC;IACd,CAAC;IACD,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,GAAG,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC","sourcesContent":["// Plugin scripts that register themselves (slice 11 §1, §2, decision \"Slice 11's points\" (P2)): a facet's built script\n// served as `chordFacet(\"<plugin>\", \"<digest>\", function (require, module, exports) { … })`, loaded with `<script src>`\n// (a page under a `'self'` CSP: no `eval`, no `new Function`) or run by the terminal's runtime; the client evaluates the\n// registered function with a `require` that answers only its host packages.\n\nimport type { Principal } from \"../data/index.ts\";\nimport type { Facet } from \"../host/index.ts\";\n\n/** The global function a registered script calls: defined by the client before any plugin script runs. */\nexport const REGISTER = \"chordFacet\";\n\n/** A built facet's function, as its script registers it. */\nexport type FacetFunction = (\n\trequire: (specifier: string) => unknown,\n\tmodule: { exports: unknown },\n\texports: unknown,\n) => void;\n\n/** One registered script: its plugin, its digest and its function. */\nexport type RegisteredScript = { readonly plugin: string; readonly digest: string; readonly run: FacetFunction };\n\n/** The modules a client's plugin scripts import, by specifier (the app's API modules for the kind, React, ...). */\nexport type ClientModules = Readonly<Record<string, unknown>>;\n\n/**\n * The text of a registered script for `plugin`'s facet built as `source` (one function expression, the build's\n * wrapped CommonJS script) with `digest`. Its source map comment stays on its own line, before the closing call.\n */\nexport function registeredSource(plugin: string, digest: string, source: string): string {\n\treturn `${REGISTER}(${JSON.stringify(plugin)},${JSON.stringify(digest)},${source}\\n);\\n`;\n}\n\n/**\n * Runs `script`'s function and returns its facet (its default export). Its `require` answers `modules` only (the build\n * kept nothing else external for a client kind); anything else throws naming the plugin. Throws what the script throws,\n * and when its default export is no facet.\n */\nexport function evaluateRegistered<P extends Principal = Principal>(\n\tscript: RegisteredScript,\n\tmodules: ClientModules,\n): Facet<P> {\n\tconst where = `plugin \"${script.plugin}\"`;\n\tconst module = { exports: {} as unknown };\n\tscript.run(\n\t\t(specifier) => {\n\t\t\tif (Object.hasOwn(modules, specifier)) return interop(modules[specifier]);\n\t\t\tthrow new Error(`${where}: \"${specifier}\" is not one of this client's host packages`);\n\t\t},\n\t\tmodule,\n\t\tmodule.exports,\n\t);\n\t// A trust boundary: plugin code; its default export is checked to be a facet.\n\tconst facet = (module.exports as { readonly default?: unknown } | null)?.default;\n\tif (typeof facet !== \"object\" || facet === null || typeof (facet as { setup?: unknown }).setup !== \"function\") {\n\t\tthrow new Error(`${where}: its default export is not a facet (defineFacet)`);\n\t}\n\treturn facet as Facet<P>;\n}\n\n/** ESM namespaces wrapped for a CommonJS script, by namespace: one wrapper per namespace, held as long as it is. */\nconst wrapped = new WeakMap<object, object>();\n\n/**\n * A host package as a CommonJS script imports it: an ESM namespace wrapped once with `__esModule` (so esbuild's interop\n * reads its `default` for a default import, its names for named ones), any other value as it is.\n */\nexport function interop(value: unknown): unknown {\n\tif (typeof value !== \"object\" || value === null || Object.prototype.toString.call(value) !== \"[object Module]\") {\n\t\treturn value;\n\t}\n\tlet made = wrapped.get(value);\n\tif (made === undefined) {\n\t\tmade = { ...value, __esModule: true };\n\t\twrapped.set(value, made);\n\t}\n\treturn made;\n}\n"]}

package/dist/surfaces/scripts.d.ts

@@ -0,0 +1,84 @@
+import { type Static } from "../contracts/index.ts";
+/** One plugin's script of the set: its name, its script's digest and URL, its stylesheet's URL when it has one. */
+declare const ScriptEntry: import("../contracts/index.ts").Schema<{
+    name: string;
+    digest: string;
+    url: string;
+    css?: string | undefined;
+}>;
+/** One plugin's script of a set (see `ScriptEntry`). */
+export type ScriptEntry = Static<typeof ScriptEntry>;
+/**
+ * A client kind's current scripts: `base` (the base bundle's hash: a change reloads the client), `combined` (the URL of
+ * one file holding every plugin's script, what a fresh client loads), `plugins` (each one's script, in name order).
+ */
+export declare const ScriptSet: import("../contracts/index.ts").Schema<{
+    base: string;
+    combined: string;
+    plugins: {
+        name: string;
+        digest: string;
+        url: string;
+        css?: string | undefined;
+    }[];
+}>;
+/** A client kind's current scripts (see `ScriptSet`). */
+export type ScriptSet = Static<typeof ScriptSet>;
+/** The current web scripts (`ScriptSet`), served by the server's web surface to any principal that may load the app. */
+export declare const WebScripts: import("../contracts/contract.ts").Contract<{
+    kind: "remote";
+    name: "chord.web.scripts";
+    params: {};
+    history: [{
+        version: "1";
+        variants: {
+            readonly main: {
+                state: {
+                    readonly set: import("../contracts/index.ts").Schema<{
+                        base: string;
+                        combined: string;
+                        plugins: {
+                            name: string;
+                            digest: string;
+                            url: string;
+                            css?: string | undefined;
+                        }[];
+                    }>;
+                };
+                methods: Record<never, never>;
+            };
+        };
+        changes: never;
+    }];
+}>;
+/** The current terminal scripts (`ScriptSet`), served by the server's terminal surface as `WebScripts` is. */
+export declare const TuiScripts: import("../contracts/contract.ts").Contract<{
+    kind: "remote";
+    name: "chord.tui.scripts";
+    params: {};
+    history: [{
+        version: "1";
+        variants: {
+            readonly main: {
+                state: {
+                    readonly set: import("../contracts/index.ts").Schema<{
+                        base: string;
+                        combined: string;
+                        plugins: {
+                            name: string;
+                            digest: string;
+                            url: string;
+                            css?: string | undefined;
+                        }[];
+                    }>;
+                };
+                methods: Record<never, never>;
+            };
+        };
+        changes: never;
+    }];
+}>;
+/** The contract of a client kind's scripts, as clients hold it (`WebScripts`, `TuiScripts`). */
+export type ScriptsContract = typeof WebScripts | typeof TuiScripts;
+export {};
+//# sourceMappingURL=scripts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.d.ts","sourceRoot":"","sources":["../../src/surfaces/scripts.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmC,KAAK,MAAM,EAAO,MAAM,uBAAuB,CAAC;AAK1F,mHAAmH;AACnH,QAAA,MAAM,WAAW;;;;;EAAmE,CAAC;AAErF,wDAAwD;AACxD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,WAAW,CAAC,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;;;;EAAmE,CAAC;AAE1F,yDAAyD;AACzD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,SAAS,CAAC,CAAC;AAEjD,wHAAwH;AACxH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;EAAuC,CAAC;AAE/D,8GAA8G;AAC9G,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;EAAuC,CAAC;AAY/D,gGAAgG;AAChG,MAAM,MAAM,eAAe,GAAG,OAAO,UAAU,GAAG,OAAO,UAAU,CAAC"}

package/dist/surfaces/scripts.js

@@ -0,0 +1,28 @@
+// The current plugin scripts of a client kind (slice 11 §1, decision "Slice 11, P5"): what the server's surface serves
+// as a remote object every page and terminal holds. Its state is the set: the base bundle's hash, the combined file of
+// every plugin script, and each plugin's script (and stylesheet); a rollout shipping the kind publishes a new set, and
+// each client fetches what changed.
+import { arr, hostKind, obj, opt, remote, str } from "../contracts/index.js";
+/** The server's host kind as the surfaces place their objects: the app kit's server is `Server()`. */
+const Server = hostKind("server");
+/** One plugin's script of the set: its name, its script's digest and URL, its stylesheet's URL when it has one. */
+const ScriptEntry = obj({ name: str(), digest: str(), url: str(), css: opt(str()) });
+/**
+ * A client kind's current scripts: `base` (the base bundle's hash: a change reloads the client), `combined` (the URL of
+ * one file holding every plugin's script, what a fresh client loads), `plugins` (each one's script, in name order).
+ */
+export const ScriptSet = obj({ base: str(), combined: str(), plugins: arr(ScriptEntry) });
+/** The current web scripts (`ScriptSet`), served by the server's web surface to any principal that may load the app. */
+export const WebScripts = scriptsContract("chord.web.scripts");
+/** The current terminal scripts (`ScriptSet`), served by the server's terminal surface as `WebScripts` is. */
+export const TuiScripts = scriptsContract("chord.tui.scripts");
+/** The contract of a client kind's current scripts, named `name`: a remote object on the server, its state the set. */
+function scriptsContract(name) {
+    return remote(name, {
+        version: 1,
+        params: {},
+        hostAddress: () => Server(),
+        variants: { main: { state: { set: ScriptSet } } },
+    });
+}
+//# sourceMappingURL=scripts.js.map

package/dist/surfaces/scripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.js","sourceRoot":"","sources":["../../src/surfaces/scripts.ts"],"names":[],"mappings":"AAAA,uHAAuH;AACvH,uHAAuH;AACvH,uHAAuH;AACvH,oCAAoC;AAEpC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAe,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAE1F,sGAAsG;AACtG,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAElC,mHAAmH;AACnH,MAAM,WAAW,GAAG,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;AAKrF;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;AAK1F,wHAAwH;AACxH,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CAAC,mBAAmB,CAAC,CAAC;AAE/D,8GAA8G;AAC9G,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CAAC,mBAAmB,CAAC,CAAC;AAE/D,uHAAuH;AACvH,SAAS,eAAe,CAAyB,IAAO;IACvD,OAAO,MAAM,CAAC,IAAI,EAAE;QACnB,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,EAAE;QACV,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QAC3B,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE;KACjD,CAAC,CAAC;AACJ,CAAC","sourcesContent":["// The current plugin scripts of a client kind (slice 11 §1, decision \"Slice 11, P5\"): what the server's surface serves\n// as a remote object every page and terminal holds. Its state is the set: the base bundle's hash, the combined file of\n// every plugin script, and each plugin's script (and stylesheet); a rollout shipping the kind publishes a new set, and\n// each client fetches what changed.\n\nimport { arr, hostKind, obj, opt, remote, type Static, str } from \"../contracts/index.ts\";\n\n/** The server's host kind as the surfaces place their objects: the app kit's server is `Server()`. */\nconst Server = hostKind(\"server\");\n\n/** One plugin's script of the set: its name, its script's digest and URL, its stylesheet's URL when it has one. */\nconst ScriptEntry = obj({ name: str(), digest: str(), url: str(), css: opt(str()) });\n\n/** One plugin's script of a set (see `ScriptEntry`). */\nexport type ScriptEntry = Static<typeof ScriptEntry>;\n\n/**\n * A client kind's current scripts: `base` (the base bundle's hash: a change reloads the client), `combined` (the URL of\n * one file holding every plugin's script, what a fresh client loads), `plugins` (each one's script, in name order).\n */\nexport const ScriptSet = obj({ base: str(), combined: str(), plugins: arr(ScriptEntry) });\n\n/** A client kind's current scripts (see `ScriptSet`). */\nexport type ScriptSet = Static<typeof ScriptSet>;\n\n/** The current web scripts (`ScriptSet`), served by the server's web surface to any principal that may load the app. */\nexport const WebScripts = scriptsContract(\"chord.web.scripts\");\n\n/** The current terminal scripts (`ScriptSet`), served by the server's terminal surface as `WebScripts` is. */\nexport const TuiScripts = scriptsContract(\"chord.tui.scripts\");\n\n/** The contract of a client kind's current scripts, named `name`: a remote object on the server, its state the set. */\nfunction scriptsContract<const N extends string>(name: N) {\n\treturn remote(name, {\n\t\tversion: 1,\n\t\tparams: {},\n\t\thostAddress: () => Server(),\n\t\tvariants: { main: { state: { set: ScriptSet } } },\n\t});\n}\n\n/** The contract of a client kind's scripts, as clients hold it (`WebScripts`, `TuiScripts`). */\nexport type ScriptsContract = typeof WebScripts | typeof TuiScripts;\n"]}

package/dist/surfaces/theme-choice.d.ts

@@ -0,0 +1,31 @@
+import type { Principal } from "../data/index.ts";
+import type { Facet } from "../host/index.ts";
+/** The caller's theme choice, on the server: its pick, and `choose` to change it. */
+export declare const ThemeChoice: import("../contracts/contract.ts").Contract<{
+    kind: "remote";
+    name: "chord.themes.choice";
+    params: {};
+    history: [{
+        version: "1";
+        variants: {
+            readonly main: {
+                state: {
+                    readonly pick: import("../contracts/index.ts").Schema<{
+                        dark: string | null;
+                        light: string | null;
+                    }>;
+                };
+                methods: {
+                    readonly choose: import("../contracts/schema.ts").Method<import("../contracts/index.ts").Schema<{
+                        dark: string | null;
+                        light: string | null;
+                    }>, import("../contracts/schema.ts").NullSchema>;
+                };
+            };
+        };
+        changes: never;
+    }];
+}>;
+/** The kit's server facet for theme choices: the store of picks and each principal's `ThemeChoice`. */
+export declare function themeChoiceFacet<P extends Principal>(): Facet<P>;
+//# sourceMappingURL=theme-choice.d.ts.map

package/dist/surfaces/theme-choice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-choice.d.ts","sourceRoot":"","sources":["../../src/surfaces/theme-choice.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAU9C,qFAAqF;AACrF,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;EAAkD,CAAC;AAK3E,uGAAuG;AACvG,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,CAEhE"}

package/dist/surfaces/theme-choice.js

@@ -0,0 +1,18 @@
+// The user's theme choice (slice 11 §4b): one dark and one light theme id per principal, a preference the server keeps
+// (the kit serves it) and every page and terminal of that principal holds, so choosing a theme restyles them all at
+// once. An id is at most 128 characters (fix round 1: Opus M4, Fable L7).
+import { nul, obj, str, union } from "../contracts/index.js";
+import { preferenceContract, preferenceFacet } from "./preference.js";
+/** A theme id (at most 128 characters), or `null` for the first contributed theme of its mode. */
+const ThemeId = union([str({ max: 128 }), nul()]);
+/** A pick: a theme id per mode. */
+const Pick = obj({ dark: ThemeId, light: ThemeId });
+/** The caller's theme choice, on the server: its pick, and `choose` to change it. */
+export const ThemeChoice = preferenceContract("chord.themes.choice", Pick);
+/** No choice yet: the first contributed theme of each mode. */
+const NO_PICK = { dark: null, light: null };
+/** The kit's server facet for theme choices: the store of picks and each principal's `ThemeChoice`. */
+export function themeChoiceFacet() {
+    return preferenceFacet(ThemeChoice, "chord.themes.picks", Pick, NO_PICK);
+}
+//# sourceMappingURL=theme-choice.js.map

package/dist/surfaces/theme-choice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-choice.js","sourceRoot":"","sources":["../../src/surfaces/theme-choice.ts"],"names":[],"mappings":"AAAA,uHAAuH;AACvH,oHAAoH;AACpH,0EAA0E;AAE1E,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAG7D,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGtE,kGAAkG;AAClG,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AAElD,mCAAmC;AACnC,MAAM,IAAI,GAAG,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AAEpD,qFAAqF;AACrF,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC;AAE3E,+DAA+D;AAC/D,MAAM,OAAO,GAAc,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAEvD,uGAAuG;AACvG,MAAM,UAAU,gBAAgB;IAC/B,OAAO,eAAe,CAAI,WAAW,EAAE,oBAAoB,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7E,CAAC","sourcesContent":["// The user's theme choice (slice 11 §4b): one dark and one light theme id per principal, a preference the server keeps\n// (the kit serves it) and every page and terminal of that principal holds, so choosing a theme restyles them all at\n// once. An id is at most 128 characters (fix round 1: Opus M4, Fable L7).\n\nimport { nul, obj, str, union } from \"../contracts/index.ts\";\nimport type { Principal } from \"../data/index.ts\";\nimport type { Facet } from \"../host/index.ts\";\nimport { preferenceContract, preferenceFacet } from \"./preference.ts\";\nimport type { ThemePick } from \"./themes.ts\";\n\n/** A theme id (at most 128 characters), or `null` for the first contributed theme of its mode. */\nconst ThemeId = union([str({ max: 128 }), nul()]);\n\n/** A pick: a theme id per mode. */\nconst Pick = obj({ dark: ThemeId, light: ThemeId });\n\n/** The caller's theme choice, on the server: its pick, and `choose` to change it. */\nexport const ThemeChoice = preferenceContract(\"chord.themes.choice\", Pick);\n\n/** No choice yet: the first contributed theme of each mode. */\nconst NO_PICK: ThemePick = { dark: null, light: null };\n\n/** The kit's server facet for theme choices: the store of picks and each principal's `ThemeChoice`. */\nexport function themeChoiceFacet<P extends Principal>(): Facet<P> {\n\treturn preferenceFacet<P>(ThemeChoice, \"chord.themes.picks\", Pick, NO_PICK);\n}\n"]}

package/dist/surfaces/themes.d.ts

@@ -0,0 +1,43 @@
+import type { Principal } from "../data/index.ts";
+import { type Facet } from "../host/index.ts";
+import { type Registry } from "../registries/index.ts";
+/** The roles every theme names: the kit's base set. Apps add their own roles; themes fill at least these. */
+export declare const BASE_ROLES: readonly ["accent", "bg", "fg", "muted", "error", "warning", "success"];
+/** A base role. */
+export type BaseRole = (typeof BASE_ROLES)[number];
+/** A theme: an id, a name, its mode, a colour per role (CSS colours; `#rrggbb` for terminals), web and terminal extras. */
+export type Theme = {
+    readonly id: string;
+    readonly name: string;
+    readonly mode: "dark" | "light";
+    readonly colors: Readonly<Record<BaseRole, string>> & Readonly<Record<string, string>>;
+    /** More CSS variables on `:root`, by name without `--` (`radius`, `font`); URLs of the plugin's assets allowed. */
+    readonly web?: Readonly<Record<string, string>>;
+    /** Terminal colours by role, before `colors`: `#rrggbb` or an xterm 256-colour index (`"208"`). */
+    readonly tui?: Readonly<Record<string, string>>;
+};
+/** The themes plugins contribute, in plugin-name order; served on every client and on the server by the kit. */
+export declare const Themes: Registry<Theme, readonly Theme[]>;
+/** The kit's facet serving `Themes` on a host: the contributions as they are, in plugin-name order. */
+export declare function themesFacet<P extends Principal>(): Facet<P>;
+/** The theme used when no plugin contributed one of a mode: neutral colours. */
+export declare const FALLBACK_THEMES: Readonly<Record<Theme["mode"], Theme>>;
+/** The user's choice: a theme id for dark and one for light (`null`: the first contributed of that mode). */
+export type ThemePick = {
+    readonly dark: string | null;
+    readonly light: string | null;
+};
+/** The active theme for `mode`: the one `pick` names if contributed, else the first of that mode, else the fallback. */
+export declare function activeTheme(themes: readonly Theme[], pick: ThemePick, mode: Theme["mode"]): Theme;
+/** The CSS custom properties of `theme`: `--<role>` for every colour, then `--<name>` for each `web` extra. */
+export declare function themeVariables(theme: Theme): Readonly<Record<string, string>>;
+/** How many colours a terminal shows. */
+export type ColorDepth = "truecolor" | "256";
+/**
+ * The SGR parameters of `role`'s colour in `theme` for a terminal of `depth` (`38;2;r;g;b`, `38;5;n`; `48;…` for a
+ * background): the role's `tui` override first, else its colour, else the fallback theme's; a `#rrggbb` colour is the
+ * nearest of the 256 xterm colours on a 256-colour terminal. A role nobody defines, or a colour that is no `#rrggbb`,
+ * gives the terminal's default (`39`, `49`).
+ */
+export declare function terminalColor(theme: Theme, role: string, depth: ColorDepth, layer: "fg" | "bg"): string;
+//# sourceMappingURL=themes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"themes.d.ts","sourceRoot":"","sources":["../../src/surfaces/themes.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvE,6GAA6G;AAC7G,eAAO,MAAM,UAAU,YAAI,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAElG,mBAAmB;AACnB,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,2HAA2H;AAC3H,MAAM,MAAM,KAAK,GAAG;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvF,mHAAmH;IACnH,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,mGAAmG;IACnG,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAChD,CAAC;AAEF,gHAAgH;AAChH,eAAO,MAAM,MAAM,EAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,KAAK,EAAE,CAEnD,CAAC;AAEH,uGAAuG;AACvG,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,CAE3D;AAED,gFAAgF;AAChF,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CA6BlE,CAAC;AAEF,6GAA6G;AAC7G,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAExF,wHAAwH;AACxH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAIjG;AAED,+GAA+G;AAC/G,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAK7E;AAED,yCAAyC;AACzC,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,KAAK,CAAC;AAE7C;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CASvG"}

package/dist/surfaces/themes.js

@@ -0,0 +1,110 @@
+// Looks and themes (slice 11 §4b, decision "Looks and themes", `docs/theming/`): a theme is data in one registry,
+// `Themes`, that plugins contribute to on any host kind; a page writes the active theme as CSS custom properties on
+// `:root`, a terminal looks colours up by role. A theme names a colour for each role (the kit's base roles, and roles
+// an app adds), with `web` extras (more CSS variables: radii, fonts) and `tui` overrides (a colour per role for
+// terminals). The user picks one dark and one light theme (`ThemeChoice`); the system's mode chooses between them.
+import { defineFacet } from "../host/index.js";
+import { defineRegistry } from "../registries/index.js";
+/** The roles every theme names: the kit's base set. Apps add their own roles; themes fill at least these. */
+export const BASE_ROLES = ["accent", "bg", "fg", "muted", "error", "warning", "success"];
+/** The themes plugins contribute, in plugin-name order; served on every client and on the server by the kit. */
+export const Themes = defineRegistry("chord.themes", {
+    version: 1,
+});
+/** The kit's facet serving `Themes` on a host: the contributions as they are, in plugin-name order. */
+export function themesFacet() {
+    return defineFacet((host) => host.serve(Themes, { compose: (table) => table.map(({ value }) => value) }));
+}
+/** The theme used when no plugin contributed one of a mode: neutral colours. */
+export const FALLBACK_THEMES = {
+    dark: {
+        id: "chord.dark",
+        name: "Dark",
+        mode: "dark",
+        colors: {
+            accent: "#4c9aff",
+            bg: "#16181d",
+            fg: "#e6e6e6",
+            muted: "#8a8f98",
+            error: "#ff6b6b",
+            warning: "#f0b429",
+            success: "#3ecf8e",
+        },
+    },
+    light: {
+        id: "chord.light",
+        name: "Light",
+        mode: "light",
+        colors: {
+            accent: "#0b62d6",
+            bg: "#ffffff",
+            fg: "#1c1e21",
+            muted: "#6b7280",
+            error: "#c62828",
+            warning: "#b26a00",
+            success: "#1b7f4b",
+        },
+    },
+};
+/** The active theme for `mode`: the one `pick` names if contributed, else the first of that mode, else the fallback. */
+export function activeTheme(themes, pick, mode) {
+    const wanted = pick[mode];
+    const ofMode = themes.filter((theme) => theme.mode === mode);
+    return ofMode.find((theme) => theme.id === wanted) ?? ofMode[0] ?? FALLBACK_THEMES[mode];
+}
+/** The CSS custom properties of `theme`: `--<role>` for every colour, then `--<name>` for each `web` extra. */
+export function themeVariables(theme) {
+    const variables = {};
+    for (const [role, color] of Object.entries(theme.colors))
+        variables[`--${role}`] = color;
+    for (const [name, value] of Object.entries(theme.web ?? {}))
+        variables[`--${name}`] = value;
+    return variables;
+}
+/**
+ * The SGR parameters of `role`'s colour in `theme` for a terminal of `depth` (`38;2;r;g;b`, `38;5;n`; `48;…` for a
+ * background): the role's `tui` override first, else its colour, else the fallback theme's; a `#rrggbb` colour is the
+ * nearest of the 256 xterm colours on a 256-colour terminal. A role nobody defines, or a colour that is no `#rrggbb`,
+ * gives the terminal's default (`39`, `49`).
+ */
+export function terminalColor(theme, role, depth, layer) {
+    const fallback = FALLBACK_THEMES[theme.mode].colors;
+    const color = theme.tui?.[role] ?? theme.colors[role] ?? fallback[role];
+    const base = layer === "fg" ? "38" : "48";
+    if (color !== undefined && /^\d{1,3}$/.test(color) && Number(color) < 256)
+        return `${base};5;${color}`;
+    const rgb = color === undefined ? undefined : parseHex(color);
+    if (rgb === undefined)
+        return layer === "fg" ? "39" : "49";
+    if (depth === "truecolor")
+        return `${base};2;${rgb.join(";")}`;
+    return `${base};5;${nearest256(rgb)}`;
+}
+/** The red, green and blue of a `#rrggbb` colour. */
+function parseHex(color) {
+    const match = /^#([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})$/i.exec(color);
+    if (match === null)
+        return undefined;
+    return [Number.parseInt(match[1], 16), Number.parseInt(match[2], 16), Number.parseInt(match[3], 16)];
+}
+/** The levels of the xterm 6×6×6 colour cube. */
+const CUBE = [0, 95, 135, 175, 215, 255];
+/** The nearest xterm 256-colour index to `rgb`: the nearer of the colour cube's (16–231) and the grey ramp's (232–255). */
+function nearest256(rgb) {
+    const level = (value) => {
+        let best = 0;
+        for (let index = 1; index < CUBE.length; index++) {
+            if (Math.abs(CUBE[index] - value) < Math.abs(CUBE[best] - value))
+                best = index;
+        }
+        return best;
+    };
+    const [r, g, b] = rgb.map(level);
+    const cube = [CUBE[r], CUBE[g], CUBE[b]];
+    const average = (rgb[0] + rgb[1] + rgb[2]) / 3;
+    const grey = Math.max(0, Math.min(23, Math.round((average - 8) / 10)));
+    const greyValue = 8 + grey * 10;
+    const distance = (other) => (other[0] - rgb[0]) ** 2 + (other[1] - rgb[1]) ** 2 + (other[2] - rgb[2]) ** 2;
+    return distance([greyValue, greyValue, greyValue]) < distance(cube) ? 232 + grey : 16 + 36 * r + 6 * g + b;
+}
+//# sourceMappingURL=themes.js.map

package/dist/surfaces/themes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"themes.js","sourceRoot":"","sources":["../../src/surfaces/themes.ts"],"names":[],"mappings":"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","sourcesContent":["// Looks and themes (slice 11 §4b, decision \"Looks and themes\", `docs/theming/`): a theme is data in one registry,\n// `Themes`, that plugins contribute to on any host kind; a page writes the active theme as CSS custom properties on\n// `:root`, a terminal looks colours up by role. A theme names a colour for each role (the kit's base roles, and roles\n// an app adds), with `web` extras (more CSS variables: radii, fonts) and `tui` overrides (a colour per role for\n// terminals). The user picks one dark and one light theme (`ThemeChoice`); the system's mode chooses between them.\n\nimport type { Principal } from \"../data/index.ts\";\nimport { defineFacet, type Facet } from \"../host/index.ts\";\nimport { defineRegistry, type Registry } from \"../registries/index.ts\";\n\n/** The roles every theme names: the kit's base set. Apps add their own roles; themes fill at least these. */\nexport const BASE_ROLES = [\"accent\", \"bg\", \"fg\", \"muted\", \"error\", \"warning\", \"success\"] as const;\n\n/** A base role. */\nexport type BaseRole = (typeof BASE_ROLES)[number];\n\n/** A theme: an id, a name, its mode, a colour per role (CSS colours; `#rrggbb` for terminals), web and terminal extras. */\nexport type Theme = {\n\treadonly id: string;\n\treadonly name: string;\n\treadonly mode: \"dark\" | \"light\";\n\treadonly colors: Readonly<Record<BaseRole, string>> & Readonly<Record<string, string>>;\n\t/** More CSS variables on `:root`, by name without `--` (`radius`, `font`); URLs of the plugin's assets allowed. */\n\treadonly web?: Readonly<Record<string, string>>;\n\t/** Terminal colours by role, before `colors`: `#rrggbb` or an xterm 256-colour index (`\"208\"`). */\n\treadonly tui?: Readonly<Record<string, string>>;\n};\n\n/** The themes plugins contribute, in plugin-name order; served on every client and on the server by the kit. */\nexport const Themes: Registry<Theme, readonly Theme[]> = defineRegistry<Theme, readonly Theme[]>(\"chord.themes\", {\n\tversion: 1,\n});\n\n/** The kit's facet serving `Themes` on a host: the contributions as they are, in plugin-name order. */\nexport function themesFacet<P extends Principal>(): Facet<P> {\n\treturn defineFacet<P>((host) => host.serve(Themes, { compose: (table) => table.map(({ value }) => value) }));\n}\n\n/** The theme used when no plugin contributed one of a mode: neutral colours. */\nexport const FALLBACK_THEMES: Readonly<Record<Theme[\"mode\"], Theme>> = {\n\tdark: {\n\t\tid: \"chord.dark\",\n\t\tname: \"Dark\",\n\t\tmode: \"dark\",\n\t\tcolors: {\n\t\t\taccent: \"#4c9aff\",\n\t\t\tbg: \"#16181d\",\n\t\t\tfg: \"#e6e6e6\",\n\t\t\tmuted: \"#8a8f98\",\n\t\t\terror: \"#ff6b6b\",\n\t\t\twarning: \"#f0b429\",\n\t\t\tsuccess: \"#3ecf8e\",\n\t\t},\n\t},\n\tlight: {\n\t\tid: \"chord.light\",\n\t\tname: \"Light\",\n\t\tmode: \"light\",\n\t\tcolors: {\n\t\t\taccent: \"#0b62d6\",\n\t\t\tbg: \"#ffffff\",\n\t\t\tfg: \"#1c1e21\",\n\t\t\tmuted: \"#6b7280\",\n\t\t\terror: \"#c62828\",\n\t\t\twarning: \"#b26a00\",\n\t\t\tsuccess: \"#1b7f4b\",\n\t\t},\n\t},\n};\n\n/** The user's choice: a theme id for dark and one for light (`null`: the first contributed of that mode). */\nexport type ThemePick = { readonly dark: string | null; readonly light: string | null };\n\n/** The active theme for `mode`: the one `pick` names if contributed, else the first of that mode, else the fallback. */\nexport function activeTheme(themes: readonly Theme[], pick: ThemePick, mode: Theme[\"mode\"]): Theme {\n\tconst wanted = pick[mode];\n\tconst ofMode = themes.filter((theme) => theme.mode === mode);\n\treturn ofMode.find((theme) => theme.id === wanted) ?? ofMode[0] ?? FALLBACK_THEMES[mode];\n}\n\n/** The CSS custom properties of `theme`: `--<role>` for every colour, then `--<name>` for each `web` extra. */\nexport function themeVariables(theme: Theme): Readonly<Record<string, string>> {\n\tconst variables: Record<string, string> = {};\n\tfor (const [role, color] of Object.entries(theme.colors)) variables[`--${role}`] = color;\n\tfor (const [name, value] of Object.entries(theme.web ?? {})) variables[`--${name}`] = value;\n\treturn variables;\n}\n\n/** How many colours a terminal shows. */\nexport type ColorDepth = \"truecolor\" | \"256\";\n\n/**\n * The SGR parameters of `role`'s colour in `theme` for a terminal of `depth` (`38;2;r;g;b`, `38;5;n`; `48;…` for a\n * background): the role's `tui` override first, else its colour, else the fallback theme's; a `#rrggbb` colour is the\n * nearest of the 256 xterm colours on a 256-colour terminal. A role nobody defines, or a colour that is no `#rrggbb`,\n * gives the terminal's default (`39`, `49`).\n */\nexport function terminalColor(theme: Theme, role: string, depth: ColorDepth, layer: \"fg\" | \"bg\"): string {\n\tconst fallback = FALLBACK_THEMES[theme.mode].colors as Readonly<Record<string, string>>;\n\tconst color = theme.tui?.[role] ?? theme.colors[role] ?? fallback[role];\n\tconst base = layer === \"fg\" ? \"38\" : \"48\";\n\tif (color !== undefined && /^\\d{1,3}$/.test(color) && Number(color) < 256) return `${base};5;${color}`;\n\tconst rgb = color === undefined ? undefined : parseHex(color);\n\tif (rgb === undefined) return layer === \"fg\" ? \"39\" : \"49\";\n\tif (depth === \"truecolor\") return `${base};2;${rgb.join(\";\")}`;\n\treturn `${base};5;${nearest256(rgb)}`;\n}\n\n/** The red, green and blue of a `#rrggbb` colour. */\nfunction parseHex(color: string): readonly [number, number, number] | undefined {\n\tconst match = /^#([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})$/i.exec(color);\n\tif (match === null) return undefined;\n\treturn [Number.parseInt(match[1]!, 16), Number.parseInt(match[2]!, 16), Number.parseInt(match[3]!, 16)];\n}\n\n/** The levels of the xterm 6×6×6 colour cube. */\nconst CUBE = [0, 95, 135, 175, 215, 255];\n\n/** The nearest xterm 256-colour index to `rgb`: the nearer of the colour cube's (16–231) and the grey ramp's (232–255). */\nfunction nearest256(rgb: readonly [number, number, number]): number {\n\tconst level = (value: number): number => {\n\t\tlet best = 0;\n\t\tfor (let index = 1; index < CUBE.length; index++) {\n\t\t\tif (Math.abs(CUBE[index]! - value) < Math.abs(CUBE[best]! - value)) best = index;\n\t\t}\n\t\treturn best;\n\t};\n\tconst [r, g, b] = rgb.map(level) as [number, number, number];\n\tconst cube = [CUBE[r]!, CUBE[g]!, CUBE[b]!] as const;\n\tconst average = (rgb[0] + rgb[1] + rgb[2]) / 3;\n\tconst grey = Math.max(0, Math.min(23, Math.round((average - 8) / 10)));\n\tconst greyValue = 8 + grey * 10;\n\tconst distance = (other: readonly number[]): number =>\n\t\t(other[0]! - rgb[0]) ** 2 + (other[1]! - rgb[1]) ** 2 + (other[2]! - rgb[2]) ** 2;\n\treturn distance([greyValue, greyValue, greyValue]) < distance(cube) ? 232 + grey : 16 + 36 * r + 6 * g + b;\n}\n"]}

package/dist/surfaces/translations.d.ts

@@ -0,0 +1,29 @@
+import type { Principal } from "../data/index.ts";
+import { type Facet } from "../host/index.ts";
+import { type ComposeContext, type Registry, type RegistryTable, type TableItem } from "../registries/index.ts";
+import type { Catalog } from "./messages.ts";
+/** One catalog: the messages of `namespace` in `locale`; `override: true` replaces the plugin's own for that locale. */
+export type Translation = {
+    readonly namespace: string;
+    readonly locale: string;
+    /** Partial allowed: a missing key falls back (the locale's base, then the namespace's first catalog). */
+    readonly messages: Catalog;
+    readonly override?: true;
+};
+/** The composed catalogs: the one used per namespace and canonical locale, with its plugin; every locale offered. */
+export type TranslationIndex = {
+    readonly catalogs: ReadonlyMap<string, ReadonlyMap<string, TableItem<Translation>>>;
+    /** Every locale some catalog offers, canonical (`pt-BR`), sorted. */
+    readonly locales: readonly string[];
+};
+/** The catalogs plugins contribute, a list per contributor; served on the server, pages and terminals by the kit. */
+export declare const Translations: Registry<readonly Translation[], TranslationIndex>;
+/** No catalogs: what a host's language has before its `Translations` value arrives. */
+export declare const NO_TRANSLATIONS: TranslationIndex;
+/** The kit's facet serving `Translations` on a host. */
+export declare function translationsFacet<P extends Principal>(): Facet<P>;
+/** The index of `table`: per namespace and locale the winning catalog; conflicts and invalid locales reported. */
+export declare function composeTranslations(table: RegistryTable<readonly Translation[]>, { report }: ComposeContext): TranslationIndex;
+/** `locale` canonical (`pt-br` is `pt-BR`), or `undefined` when it is no language tag. */
+export declare function canonicalLocale(locale: string): string | undefined;
+//# sourceMappingURL=translations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../src/surfaces/translations.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EACN,KAAK,cAAc,EAEnB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,wHAAwH;AACxH,MAAM,MAAM,WAAW,GAAG;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yGAAyG;IACzG,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;CACzB,CAAC;AAEF,qHAAqH;AACrH,MAAM,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACpF,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,CAAC;AAEF,qHAAqH;AACrH,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,SAAS,WAAW,EAAE,EAAE,gBAAgB,CAGrC,CAAC;AAExC,uFAAuF;AACvF,eAAO,MAAM,eAAe,EAAE,gBAAuD,CAAC;AAEtF,wDAAwD;AACxD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,CAEjE;AAED,kHAAkH;AAClH,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,aAAa,CAAC,SAAS,WAAW,EAAE,CAAC,EAC5C,EAAE,MAAM,EAAE,EAAE,cAAc,GACxB,gBAAgB,CA4BlB;AAED,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMlE"}

package/dist/surfaces/translations.js

@@ -0,0 +1,57 @@
+// Languages as contributions (decision "Messages and languages in the app kit" (2), refined in the build): the
+// `Translations` registry, served on the server, pages and terminals by the kit. A contribution is a list of catalogs,
+// `{ namespace, locale, messages, override? }`: a plugin contributes its own catalogs (`t.translations`) from each
+// facet that renders, a translation plugin its catalogs for other plugins. The composed index has one catalog per
+// namespace and locale: the first by plugin name wins and the other is reported, except that `override: true` wins over
+// a catalog without it. Registries are per host, so catalogs (they hold functions) never cross links.
+import { defineFacet } from "../host/index.js";
+import { defineRegistry, } from "../registries/index.js";
+/** The catalogs plugins contribute, a list per contributor; served on the server, pages and terminals by the kit. */
+export const Translations = defineRegistry("chord.translations", { version: 1 });
+/** No catalogs: what a host's language has before its `Translations` value arrives. */
+export const NO_TRANSLATIONS = { catalogs: new Map(), locales: [] };
+/** The kit's facet serving `Translations` on a host. */
+export function translationsFacet() {
+    return defineFacet((host) => host.serve(Translations, { compose: composeTranslations }));
+}
+/** The index of `table`: per namespace and locale the winning catalog; conflicts and invalid locales reported. */
+export function composeTranslations(table, { report }) {
+    const catalogs = new Map();
+    const locales = new Set();
+    for (const { value, plugin } of table) {
+        for (const translation of value) {
+            const locale = canonicalLocale(translation.locale);
+            if (locale === undefined) {
+                report({ message: `"${translation.locale}" is no locale (${translation.namespace})`, plugins: [plugin] });
+                continue;
+            }
+            locales.add(locale);
+            let byLocale = catalogs.get(translation.namespace);
+            if (byLocale === undefined) {
+                byLocale = new Map();
+                catalogs.set(translation.namespace, byLocale);
+            }
+            const taken = byLocale.get(locale);
+            if (taken === undefined || (translation.override === true && taken.value.override !== true)) {
+                byLocale.set(locale, { value: translation, plugin });
+            }
+            else if ((translation.override === true) === (taken.value.override === true)) {
+                report({
+                    message: `${translation.namespace} in ${locale} is contributed twice`,
+                    plugins: [taken.plugin, plugin],
+                });
+            }
+        }
+    }
+    return { catalogs, locales: [...locales].sort() };
+}
+/** `locale` canonical (`pt-br` is `pt-BR`), or `undefined` when it is no language tag. */
+export function canonicalLocale(locale) {
+    try {
+        return Intl.getCanonicalLocales(locale)[0];
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=translations.js.map

package/dist/surfaces/translations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translations.js","sourceRoot":"","sources":["../../src/surfaces/translations.ts"],"names":[],"mappings":"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","sourcesContent":["// Languages as contributions (decision \"Messages and languages in the app kit\" (2), refined in the build): the\n// `Translations` registry, served on the server, pages and terminals by the kit. A contribution is a list of catalogs,\n// `{ namespace, locale, messages, override? }`: a plugin contributes its own catalogs (`t.translations`) from each\n// facet that renders, a translation plugin its catalogs for other plugins. The composed index has one catalog per\n// namespace and locale: the first by plugin name wins and the other is reported, except that `override: true` wins over\n// a catalog without it. Registries are per host, so catalogs (they hold functions) never cross links.\n\nimport type { Principal } from \"../data/index.ts\";\nimport { defineFacet, type Facet } from \"../host/index.ts\";\nimport {\n\ttype ComposeContext,\n\tdefineRegistry,\n\ttype Registry,\n\ttype RegistryTable,\n\ttype TableItem,\n} from \"../registries/index.ts\";\nimport type { Catalog } from \"./messages.ts\";\n\n/** One catalog: the messages of `namespace` in `locale`; `override: true` replaces the plugin's own for that locale. */\nexport type Translation = {\n\treadonly namespace: string;\n\treadonly locale: string;\n\t/** Partial allowed: a missing key falls back (the locale's base, then the namespace's first catalog). */\n\treadonly messages: Catalog;\n\treadonly override?: true;\n};\n\n/** The composed catalogs: the one used per namespace and canonical locale, with its plugin; every locale offered. */\nexport type TranslationIndex = {\n\treadonly catalogs: ReadonlyMap<string, ReadonlyMap<string, TableItem<Translation>>>;\n\t/** Every locale some catalog offers, canonical (`pt-BR`), sorted. */\n\treadonly locales: readonly string[];\n};\n\n/** The catalogs plugins contribute, a list per contributor; served on the server, pages and terminals by the kit. */\nexport const Translations: Registry<readonly Translation[], TranslationIndex> = defineRegistry<\n\treadonly Translation[],\n\tTranslationIndex\n>(\"chord.translations\", { version: 1 });\n\n/** No catalogs: what a host's language has before its `Translations` value arrives. */\nexport const NO_TRANSLATIONS: TranslationIndex = { catalogs: new Map(), locales: [] };\n\n/** The kit's facet serving `Translations` on a host. */\nexport function translationsFacet<P extends Principal>(): Facet<P> {\n\treturn defineFacet<P>((host) => host.serve(Translations, { compose: composeTranslations }));\n}\n\n/** The index of `table`: per namespace and locale the winning catalog; conflicts and invalid locales reported. */\nexport function composeTranslations(\n\ttable: RegistryTable<readonly Translation[]>,\n\t{ report }: ComposeContext,\n): TranslationIndex {\n\tconst catalogs = new Map<string, Map<string, TableItem<Translation>>>();\n\tconst locales = new Set<string>();\n\tfor (const { value, plugin } of table) {\n\t\tfor (const translation of value) {\n\t\t\tconst locale = canonicalLocale(translation.locale);\n\t\t\tif (locale === undefined) {\n\t\t\t\treport({ message: `\"${translation.locale}\" is no locale (${translation.namespace})`, plugins: [plugin] });\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tlocales.add(locale);\n\t\t\tlet byLocale = catalogs.get(translation.namespace);\n\t\t\tif (byLocale === undefined) {\n\t\t\t\tbyLocale = new Map();\n\t\t\t\tcatalogs.set(translation.namespace, byLocale);\n\t\t\t}\n\t\t\tconst taken = byLocale.get(locale);\n\t\t\tif (taken === undefined || (translation.override === true && taken.value.override !== true)) {\n\t\t\t\tbyLocale.set(locale, { value: translation, plugin });\n\t\t\t} else if ((translation.override === true) === (taken.value.override === true)) {\n\t\t\t\treport({\n\t\t\t\t\tmessage: `${translation.namespace} in ${locale} is contributed twice`,\n\t\t\t\t\tplugins: [taken.plugin, plugin],\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\treturn { catalogs, locales: [...locales].sort() };\n}\n\n/** `locale` canonical (`pt-br` is `pt-BR`), or `undefined` when it is no language tag. */\nexport function canonicalLocale(locale: string): string | undefined {\n\ttry {\n\t\treturn Intl.getCanonicalLocales(locale)[0];\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n"]}

package/dist/sync/batch.d.ts

@@ -0,0 +1,18 @@
+import type { ArchivePart } from "../store/archive.ts";
+import type { OutboxCommit } from "../store/outbox.ts";
+/** A body on the remote: its bytes in chunks, read once. */
+export type SyncBody = AsyncIterable<Uint8Array>;
+/** A batch body: `commits` as gzip-compressed JSON lines, read from `commits` only as the body is read. */
+export declare function encodeBatch(commits: Iterable<OutboxCommit> | AsyncIterable<OutboxCommit>): SyncBody;
+/** The commits of a batch body, in order, as they arrive. */
+export declare function decodeBatch(body: SyncBody): AsyncGenerator<OutboxCommit>;
+/** The commits of a batch body with the size of each line, for callers that bound what they hold. */
+export declare function decodeBatchLines(body: SyncBody): AsyncGenerator<{
+    readonly commit: OutboxCommit;
+    readonly bytes: number;
+}>;
+/** A snapshot body: a store archive (`store.export()`), one part per JSON line, gzip-compressed. */
+export declare function encodeSnapshot(parts: AsyncIterable<ArchivePart>): SyncBody;
+/** The parts of a snapshot body as they arrive, unchecked: `importStore()` checks them (a trust boundary). */
+export declare function decodeSnapshot(body: SyncBody): AsyncIterable<unknown>;
+//# sourceMappingURL=batch.d.ts.map

package/dist/sync/batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/sync/batch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,4DAA4D;AAC5D,MAAM,MAAM,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;AAKjD,2GAA2G;AAC3G,wBAAgB,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,aAAa,CAAC,YAAY,CAAC,GAAG,QAAQ,CAMnG;AAED,6DAA6D;AAC7D,wBAAuB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAAC,YAAY,CAAC,CAE/E;AAED,qGAAqG;AACrG,wBAAuB,gBAAgB,CACtC,IAAI,EAAE,QAAQ,GACZ,cAAc,CAAC;IAAE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ3E;AAED,oGAAoG;AACpG,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,QAAQ,CAE1E;AAED,8GAA8G;AAC9G,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,CAErE"}