@earendil-works/chord 1.4.0 → 1.5.1

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"}

package/dist/surfaces/loaded.js

@@ -0,0 +1,116 @@
+// A host's loaded plugins (slice 10 D11, slice 11 §2): the facet loaded for each plugin, and loads and reloads with
+// complete sets, the same on a server or worker (the plugins runtime, scripts evaluated with `vm`) and in a page or a
+// terminal (scripts that registered themselves). Unchanged plugins (the same digest) pass as the same facet objects,
+// removed ones are left out; a plugin whose script failed (its build, its evaluation) keeps its loaded facet (left out
+// at the first load) and is named to the host, so its closure rule and its report see it.
+import { isChordError } from "../data/index.js";
+/** A host's loaded plugins: its core facets, each plugin's loaded facet, and its reloads, one after another. */
+export class LoadedFacets {
+    #core;
+    #loaded;
+    #reloading = Promise.resolve();
+    constructor(core, loaded) {
+        this.#core = core;
+        this.#loaded = loaded;
+    }
+    /**
+     * 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 async load(host, core, entries, context) {
+        const prepared = entries.map((entry) => [entry.name, entry.prepare()]);
+        const failed = [];
+        const facets = [...core];
+        for (const [plugin, each] of prepared) {
+            if (each.kind === "failed")
+                failed.push({ plugin, error: each.error });
+            // Evaluated for this host's principal type: the facets are the app's (`Facet<P>` is invariant in `P`).
+            else
+                facets.push({ name: plugin, facet: each.facet });
+        }
+        const report = await host.load(facets, context);
+        const left = new Set(report.failed.map(({ plugin }) => plugin));
+        const loaded = new Map();
+        for (const [plugin, each] of prepared) {
+            if (each.kind === "facet" && !left.has(plugin))
+                loaded.set(plugin, each);
+        }
+        // The host's own facets, for its later reloads.
+        const kept = new LoadedFacets(core, loaded);
+        return { loaded: kept, report: { failed: [...failed, ...report.failed] } };
+    }
+    /**
+     * 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(host, entries, context) {
+        // One after another: a reload computing its set from a loaded map an earlier one is about to change would pass
+        // that plugin's old facet and roll it back.
+        const reload = this.#reloading.then(() => this.#reload(host, entries, context));
+        // The tail settles to nothing: a report kept as its value would keep a rejected facet's closure (its error).
+        this.#reloading = reload.then(() => { }, () => { });
+        return reload;
+    }
+    /** One reload of `host` with the complete set `entries`. */
+    async #reload(host, entries, context) {
+        const failed = [];
+        const next = new Map();
+        for (const entry of entries) {
+            const loaded = this.#loaded.get(entry.name);
+            if (entry.digest !== undefined && entry.digest === loaded?.digest) {
+                next.set(entry.name, loaded);
+                continue;
+            }
+            const prepared = entry.prepare();
+            if (prepared.kind === "facet") {
+                next.set(entry.name, prepared);
+                continue;
+            }
+            failed.push({ plugin: entry.name, error: prepared.error });
+            if (loaded !== undefined)
+                next.set(entry.name, loaded);
+        }
+        const facets = [...this.#core, ...[...next].map(([name, { facet }]) => ({ name, facet }))];
+        let report;
+        try {
+            // The host takes facets of its own principal type: they were loaded for it.
+            report = await host.reload(facets, context, { failed });
+        }
+        catch (error) {
+            // Aborted after its commit: the commit stands, and is what the host runs now.
+            const committed = committedOf(error);
+            if (committed !== undefined)
+                this.#adopt(next, committed.failed);
+            throw error;
+        }
+        this.#adopt(next, report.failed.map(({ plugin }) => plugin));
+        return report;
+    }
+    /**
+     * Adopts the set `next` a reload committed: a plugin the host kept old (`failed`) stays loaded as it was, an added one
+     * it left out is not loaded.
+     */
+    #adopt(next, failed) {
+        for (const plugin of failed) {
+            const loaded = this.#loaded.get(plugin);
+            if (loaded === undefined)
+                next.delete(plugin);
+            else
+                next.set(plugin, loaded);
+        }
+        this.#loaded.clear();
+        for (const [name, each] of next)
+            this.#loaded.set(name, each);
+    }
+}
+/** What the commit of a reload that rejected applied: an `aborted` error after its commit says (`details.committed`). */
+function committedOf(error) {
+    if (!isChordError(error, "aborted"))
+        return undefined;
+    const details = error.details;
+    // The kernel's own error: its `committed` is a `CommittedReload`.
+    return typeof details === "object" && details !== null ? details.committed : undefined;
+}
+//# sourceMappingURL=loaded.js.map

package/dist/surfaces/loaded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loaded.js","sourceRoot":"","sources":["../../src/surfaces/loaded.ts"],"names":[],"mappings":"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","sourcesContent":["// A host's loaded plugins (slice 10 D11, slice 11 §2): the facet loaded for each plugin, and loads and reloads with\n// complete sets, the same on a server or worker (the plugins runtime, scripts evaluated with `vm`) and in a page or a\n// terminal (scripts that registered themselves). Unchanged plugins (the same digest) pass as the same facet objects,\n// removed ones are left out; a plugin whose script failed (its build, its evaluation) keeps its loaded facet (left out\n// at the first load) and is named to the host, so its closure rule and its report see it.\n\nimport type { Context } from \"../context/index.ts\";\nimport { isChordError, type Principal } from \"../data/index.ts\";\nimport type {\n\tCommittedReload,\n\tFacet,\n\tHost,\n\tLoadReport,\n\tPluginFacet,\n\tPluginFailure,\n\tReloadReport,\n} from \"../host/index.ts\";\n\n/** A plugin's facet for a host, or why there is none: its script failed. */\nexport type Prepared =\n\t| { readonly kind: \"facet\"; readonly facet: Facet<Principal>; readonly digest: string }\n\t| { readonly kind: \"failed\"; readonly error: unknown };\n\n/**\n * One plugin of a complete set: its name, its script's digest (`undefined` when its build failed: nothing to compare)\n * and how to get its facet (evaluated only when the digest is new).\n */\nexport type SetEntry = { readonly name: string; readonly digest: string | undefined; prepare(): Prepared };\n\n/** A plugin's facet as the host loaded it, with its script's digest. */\ntype LoadedFacet = { readonly facet: Facet<Principal>; readonly digest: string };\n\n/** A host's loaded plugins: its core facets, each plugin's loaded facet, and its reloads, one after another. */\nexport class LoadedFacets {\n\treadonly #core: readonly PluginFacet<Principal>[];\n\treadonly #loaded: Map<string, LoadedFacet>;\n\t#reloading: Promise<void> = Promise.resolve();\n\n\tprivate constructor(core: readonly PluginFacet<Principal>[], loaded: Map<string, LoadedFacet>) {\n\t\tthis.#core = core;\n\t\tthis.#loaded = loaded;\n\t}\n\n\t/**\n\t * Prepares `entries` and loads them on `host` with `core` (the app's own facets): a plugin whose script failed is left\n\t * out and reported in the report's `failed`, with the host's own. The host's loaded plugins, and the report.\n\t */\n\tstatic async load<P extends Principal>(\n\t\thost: Host<P>,\n\t\tcore: readonly PluginFacet<P>[],\n\t\tentries: readonly SetEntry[],\n\t\tcontext: Context,\n\t): Promise<{ readonly loaded: LoadedFacets; readonly report: LoadReport }> {\n\t\tconst prepared = entries.map((entry) => [entry.name, entry.prepare()] as const);\n\t\tconst failed: PluginFailure[] = [];\n\t\tconst facets: PluginFacet<P>[] = [...core];\n\t\tfor (const [plugin, each] of prepared) {\n\t\t\tif (each.kind === \"failed\") failed.push({ plugin, error: each.error });\n\t\t\t// Evaluated for this host's principal type: the facets are the app's (`Facet<P>` is invariant in `P`).\n\t\t\telse facets.push({ name: plugin, facet: each.facet as unknown as Facet<P> });\n\t\t}\n\t\tconst report = await host.load(facets, context);\n\t\tconst left = new Set(report.failed.map(({ plugin }) => plugin));\n\t\tconst loaded = new Map<string, LoadedFacet>();\n\t\tfor (const [plugin, each] of prepared) {\n\t\t\tif (each.kind === \"facet\" && !left.has(plugin)) loaded.set(plugin, each);\n\t\t}\n\t\t// The host's own facets, for its later reloads.\n\t\tconst kept = new LoadedFacets(core as unknown as readonly PluginFacet<Principal>[], loaded);\n\t\treturn { loaded: kept, report: { failed: [...failed, ...report.failed] } };\n\t}\n\n\t/**\n\t * Reloads `host` with `entries`, the complete set now, after its earlier reloads: core facets and unchanged plugins as\n\t * the same objects, new scripts prepared, a plugin whose script failed passed as its loaded facet (an added one left\n\t * out; both named to the host's closure rule), plugins not in `entries` left out. What the host committed becomes\n\t * the loaded set, also when the reload rejects `aborted` after its commit.\n\t */\n\treload<P extends Principal>(host: Host<P>, entries: readonly SetEntry[], context: Context): Promise<ReloadReport> {\n\t\t// One after another: a reload computing its set from a loaded map an earlier one is about to change would pass\n\t\t// that plugin's old facet and roll it back.\n\t\tconst reload = this.#reloading.then(() => this.#reload(host, entries, context));\n\t\t// The tail settles to nothing: a report kept as its value would keep a rejected facet's closure (its error).\n\t\tthis.#reloading = reload.then(\n\t\t\t() => {},\n\t\t\t() => {},\n\t\t);\n\t\treturn reload;\n\t}\n\n\t/** One reload of `host` with the complete set `entries`. */\n\tasync #reload<P extends Principal>(\n\t\thost: Host<P>,\n\t\tentries: readonly SetEntry[],\n\t\tcontext: Context,\n\t): Promise<ReloadReport> {\n\t\tconst failed: PluginFailure[] = [];\n\t\tconst next = new Map<string, LoadedFacet>();\n\t\tfor (const entry of entries) {\n\t\t\tconst loaded = this.#loaded.get(entry.name);\n\t\t\tif (entry.digest !== undefined && entry.digest === loaded?.digest) {\n\t\t\t\tnext.set(entry.name, loaded);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst prepared = entry.prepare();\n\t\t\tif (prepared.kind === \"facet\") {\n\t\t\t\tnext.set(entry.name, prepared);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tfailed.push({ plugin: entry.name, error: prepared.error });\n\t\t\tif (loaded !== undefined) next.set(entry.name, loaded);\n\t\t}\n\t\tconst facets = [...this.#core, ...[...next].map(([name, { facet }]) => ({ name, facet }))];\n\t\tlet report: ReloadReport;\n\t\ttry {\n\t\t\t// The host takes facets of its own principal type: they were loaded for it.\n\t\t\treport = await host.reload(facets as unknown as readonly PluginFacet<P>[], context, { failed });\n\t\t} catch (error) {\n\t\t\t// Aborted after its commit: the commit stands, and is what the host runs now.\n\t\t\tconst committed = committedOf(error);\n\t\t\tif (committed !== undefined) this.#adopt(next, committed.failed);\n\t\t\tthrow error;\n\t\t}\n\t\tthis.#adopt(\n\t\t\tnext,\n\t\t\treport.failed.map(({ plugin }) => plugin),\n\t\t);\n\t\treturn report;\n\t}\n\n\t/**\n\t * Adopts the set `next` a reload committed: a plugin the host kept old (`failed`) stays loaded as it was, an added one\n\t * it left out is not loaded.\n\t */\n\t#adopt(next: Map<string, LoadedFacet>, failed: readonly string[]): void {\n\t\tfor (const plugin of failed) {\n\t\t\tconst loaded = this.#loaded.get(plugin);\n\t\t\tif (loaded === undefined) next.delete(plugin);\n\t\t\telse next.set(plugin, loaded);\n\t\t}\n\t\tthis.#loaded.clear();\n\t\tfor (const [name, each] of next) this.#loaded.set(name, each);\n\t}\n}\n\n/** What the commit of a reload that rejected applied: an `aborted` error after its commit says (`details.committed`). */\nfunction committedOf(error: unknown): CommittedReload | undefined {\n\tif (!isChordError(error, \"aborted\")) return undefined;\n\tconst details = error.details as { readonly committed?: CommittedReload } | null | undefined;\n\t// The kernel's own error: its `committed` is a `CommittedReload`.\n\treturn typeof details === \"object\" && details !== null ? details.committed : undefined;\n}\n"]}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"locale-choice.d.ts","sourceRoot":"","sources":["../../src/surfaces/locale-choice.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAM9C,sFAAsF;AACtF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;EAAkD,CAAC;AAE5E,yGAAyG;AACzG,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,CAEjE"}

package/dist/surfaces/locale-choice.js

@@ -0,0 +1,14 @@
+// The user's locale choice (decision "Messages and languages in the app kit" (3)): one locale per principal, a
+// preference the server keeps (the kit serves it) and every page and terminal of that principal holds, so choosing a
+// language re-renders them all at once, without a reload. `null` until the user chooses: the device's languages decide.
+import { nul, str, union } from "../contracts/index.js";
+import { preferenceContract, preferenceFacet } from "./preference.js";
+/** A language tag (`de`, `pt-BR`; at most 35 characters, BCP 47's practical bound), or `null`: the device's. */
+const Pick = union([str({ max: 35, pattern: "^[A-Za-z]{2,8}(-[A-Za-z0-9]{1,8})*$" }), nul()]);
+/** The caller's locale choice, on the server: its pick, and `choose` to change it. */
+export const LocaleChoice = preferenceContract("chord.locale.choice", Pick);
+/** The kit's server facet for locale choices: the store of picks and each principal's `LocaleChoice`. */
+export function localeChoiceFacet() {
+    return preferenceFacet(LocaleChoice, "chord.locale.picks", Pick, null);
+}
+//# sourceMappingURL=locale-choice.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"locale-choice.js","sourceRoot":"","sources":["../../src/surfaces/locale-choice.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,qHAAqH;AACrH,wHAAwH;AAExH,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEtE,gHAAgH;AAChH,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AAE9F,sFAAsF;AACtF,MAAM,CAAC,MAAM,YAAY,GAAG,kBAAkB,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC;AAE5E,yGAAyG;AACzG,MAAM,UAAU,iBAAiB;IAChC,OAAO,eAAe,CAAI,YAAY,EAAE,oBAAoB,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAC3E,CAAC","sourcesContent":["// The user's locale choice (decision \"Messages and languages in the app kit\" (3)): one locale per principal, a\n// preference the server keeps (the kit serves it) and every page and terminal of that principal holds, so choosing a\n// language re-renders them all at once, without a reload. `null` until the user chooses: the device's languages decide.\n\nimport { nul, 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\";\n\n/** A language tag (`de`, `pt-BR`; at most 35 characters, BCP 47's practical bound), or `null`: the device's. */\nconst Pick = union([str({ max: 35, pattern: \"^[A-Za-z]{2,8}(-[A-Za-z0-9]{1,8})*$\" }), nul()]);\n\n/** The caller's locale choice, on the server: its pick, and `choose` to change it. */\nexport const LocaleChoice = preferenceContract(\"chord.locale.choice\", Pick);\n\n/** The kit's server facet for locale choices: the store of picks and each principal's `LocaleChoice`. */\nexport function localeChoiceFacet<P extends Principal>(): Facet<P> {\n\treturn preferenceFacet<P>(LocaleChoice, \"chord.locale.picks\", Pick, null);\n}\n"]}

package/dist/surfaces/messages.d.ts

@@ -0,0 +1,67 @@
+import { type Language } from "./language.ts";
+import { type Translation } from "./translations.ts";
+/** A message's value: a text, or a function of its arguments returning one. */
+export type MessageValue = string | ((...args: never[]) => string);
+/** A catalog: the messages of one namespace in one language, by key. */
+export type Catalog = {
+    readonly [key: string]: MessageValue;
+};
+/** A catalog's shape as other catalogs must match it: its keys, strings as `string`, functions with their signatures. */
+export type CatalogShape<M> = {
+    readonly [K in keyof M]: M[K] extends string ? string : M[K];
+};
+/** The arguments of a message: its function's parameters, none for a text. */
+export type MessageArgs<V> = V extends (...args: infer A) => string ? A : [];
+/** A parameter of a message as data: plain JSON (a date as an ISO string or a number), so it crosses links. */
+export type MessageParam = string | number | boolean | null;
+/**
+ * A message as data: its namespace, its key and its parameters; typed by `t.message` (`MessageData<"notes", "saved">`),
+ * any namespace and key as `MessageSchema` carries it across a link. (`Message` is the link protocol's.)
+ */
+export type MessageData<N extends string = string, K extends string = string> = {
+    readonly namespace: N;
+    readonly key: K;
+    readonly params: MessageParam[];
+};
+/** The schema of a message as data, for contract members (`notice: union([MessageSchema, nul()])`). */
+export declare const MessageSchema: import("../contracts/index.ts").Schema<{
+    namespace: string;
+    key: string;
+    params: (string | number | boolean | null)[];
+}>;
+/** The keys of `M` whose arguments are all `MessageParam`s: those `t.message` can build. */
+export type DataKeys<M> = {
+    [K in keyof M & string]: MessageArgs<M[K]> extends readonly MessageParam[] ? K : never;
+}[keyof M & string];
+/** A message of namespace `N`, or one of any namespace (`string`, from a schema): another literal namespace is refused. */
+type OfNamespace<G extends MessageData, N extends string> = string extends G["namespace"] ? unknown : {
+    readonly namespace: N;
+};
+/** Renders the messages of namespace `N` with catalog shape `M` in one language. */
+export type Translator<N extends string, M> = {
+    /** The message `key` with its arguments. */
+    <K extends keyof M & string>(key: K, ...args: MessageArgs<M[K]>): string;
+    /** A message as data; a foreign namespace or an unknown key shows the key (and is reported). */
+    render<G extends MessageData>(message: G & OfNamespace<G, N>): string;
+};
+/** A plugin's messages: `t` itself (in the current language), its namespace, its catalogs as contributions, `message`. */
+export type Messages<N extends string, M> = Translator<N, M> & {
+    readonly namespace: N;
+    /** Its catalogs as `Translations` entries: a facet that renders contributes them. */
+    readonly translations: readonly Translation[];
+    /** The message `key` with its arguments as data, for state that clients render. */
+    message<K extends DataKeys<M>>(key: K, ...args: MessageArgs<M[K]>): MessageData<N, K>;
+    /** `t` in `language` (`undefined`: the first catalog). */
+    in(language: Language | undefined): Translator<N, M>;
+};
+/** The catalog shape of a plugin's messages: what a translation fills (`const fr: MessagesOf<typeof t> = {...}`). */
+export type MessagesOf<T> = T extends Messages<string, infer M> ? M : never;
+/**
+ * The messages of `namespace` (a name like a type's, `[a-z0-9@/._~-]`) in `catalogs` by locale; the first catalog
+ * defines the keys and signatures, the others match it.
+ */
+export declare function defineMessages<const N extends string, M extends Catalog>(namespace: N, catalogs: {
+    readonly [locale: string]: CatalogShape<M>;
+}): Messages<N, CatalogShape<M>>;
+export {};
+//# sourceMappingURL=messages.d.ts.map

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

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

package/dist/surfaces/messages.js

@@ -0,0 +1,112 @@
+// Messages in code (decision "Messages and languages in the app kit" (1), (4), refined in the build): a plugin defines
+// its texts once, per namespace, in a shared `messages.ts` every facet that renders imports: `defineMessages("notes", {
+// en: {...}, de: {...} })` returns a typed `t`. The first catalog defines the keys and their argument types; every
+// other catalog must have the same keys with the same signatures (a missing key, an unknown one or a wrong argument is
+// a type error); values are strings or functions (plurals, word order). `t` renders in a language: bound to a host's
+// (`useMessages`, `scope.messages`, `t.in`), or plain, in the render under way's, else in the first catalog.
+// `t.message` builds a message as data (`{ namespace, key, params }`) for state, notices and errors, which each client
+// renders with `t.render` in its own language, checked at runtime (it crossed a link).
+import { arr, bool, nul, num, obj, str, union } from "../contracts/index.js";
+import { checkName } from "../contracts/names.js";
+import { currentLanguage, inLanguage } from "./language.js";
+import { canonicalLocale } from "./translations.js";
+/** The schema of a message as data, for contract members (`notice: union([MessageSchema, nul()])`). */
+export const MessageSchema = obj({
+    namespace: str(),
+    key: str(),
+    params: arr(union([str(), num(), bool(), nul()])),
+});
+/**
+ * The messages of `namespace` (a name like a type's, `[a-z0-9@/._~-]`) in `catalogs` by locale; the first catalog
+ * defines the keys and signatures, the others match it.
+ */
+export function defineMessages(namespace, catalogs) {
+    // Declaration policy: a namespace is a name, a catalog's key a language tag (JavaScript callers reach both).
+    checkName(namespace, "A messages namespace");
+    const own = new Map();
+    for (const [locale, catalog] of Object.entries(catalogs)) {
+        const canonical = canonicalLocale(locale);
+        if (canonical === undefined)
+            throw new Error(`${namespace}: "${locale}" is no language tag`);
+        own.set(canonical, catalog);
+    }
+    const first = own.values().next().value;
+    if (first === undefined)
+        throw new Error(`${namespace}: defineMessages needs a catalog`);
+    const source = { namespace, own, first };
+    const translations = [...own].map(([locale, messages]) => ({ namespace, locale, messages }));
+    // The overloads `Messages` types are these functions', keyed by the catalog's shape.
+    return Object.assign(translator(source, currentLanguage), {
+        namespace,
+        translations,
+        message: (key, ...params) => ({ namespace, key, params }),
+        in: (language) => translator(source, () => language),
+    });
+}
+/** A translator of `source`'s messages in the language `language` reads at each call. */
+function translator(source, language) {
+    const t = (key, ...args) => renderKey(source, language(), key, args);
+    const render = (message) => renderData(source, language(), message);
+    // The overloads `Translator` types are this one function's, keyed by the catalog's shape.
+    return Object.assign(t, { render });
+}
+/**
+ * `key` of `source` in `language`: down its chain, at each locale the host's contributed catalog, then the plugin's own;
+ * else the first catalog.
+ */
+function renderKey(source, language, key, args) {
+    if (language === undefined)
+        return call(source.first[key], args);
+    return inLanguage(language, () => {
+        for (const [index, locale] of language.chain.entries()) {
+            const contributed = language.translations.catalogs.get(source.namespace)?.get(locale);
+            if (contributed !== undefined && Object.hasOwn(contributed.value.messages, key)) {
+                try {
+                    return found(language, source, key, index, call(contributed.value.messages[key], args));
+                }
+                catch (error) {
+                    // A contributed catalog is a plugin's code: reported, and the chain goes on (design §17).
+                    const { plugin } = contributed;
+                    language.report({ kind: "failed", namespace: source.namespace, locale, key, plugin, error });
+                }
+            }
+            const own = source.own.get(locale);
+            if (own !== undefined && own !== contributed?.value.messages && Object.hasOwn(own, key)) {
+                return found(language, source, key, index, call(own[key], args));
+            }
+        }
+        return found(language, source, key, language.chain.length, call(source.first[key], args));
+    });
+}
+/** `text`, found at `index` in `language`'s chain (its length: the first catalog), a fallback reported past the first. */
+function found(language, source, key, index, text) {
+    if (index > 0) {
+        const used = language.chain[index];
+        language.report({ kind: "fallback", namespace: source.namespace, locale: language.locale, key, used });
+    }
+    return text;
+}
+/** A message's text: the text, or the function called with `args` (typed by the catalog's signature). */
+function call(value, args) {
+    return typeof value === "string" ? value : value(...args);
+}
+/**
+ * A message as data in `language`. Checked first (wire input: the message crossed a link as state): another namespace,
+ * a key the first catalog lacks or params that are no list show the key, reported; so does a message that throws.
+ */
+function renderData(source, language, message) {
+    const { namespace, key, params } = message;
+    const known = namespace === source.namespace && Object.hasOwn(source.first, key) && Array.isArray(params);
+    if (!known) {
+        language?.report({ kind: "unknown", namespace, key, expected: source.namespace });
+        return key;
+    }
+    try {
+        return renderKey(source, language, key, params);
+    }
+    catch (error) {
+        language?.report({ kind: "failed", namespace, locale: language.locale, key, plugin: undefined, error });
+        return key;
+    }
+}
+//# sourceMappingURL=messages.js.map