react-cheminfo 0.25.0 → 0.26.0

package/lib/i18n/core/messageCatalog.js

@@ -0,0 +1,135 @@
+/**
+ * One directory of messages, and the reading of it.
+ *
+ * A catalog is `en.json` — the source of truth — with one file per language
+ * beside it. English is part of the page, because it is what every missing
+ * message falls back to; the others are fetched when a visitor asks for them,
+ * so a site nobody reads in German never downloads the German.
+ *
+ * Only the plain `{name}` argument of ICU MessageFormat is filled here. A
+ * plural or a select needs the formatter itself, which is 40 kB an ordinary
+ * visit must not pay for — `check-messages` refuses one in a catalog, and the
+ * page is written with a key per branch instead.
+ */
+import { ownMessage } from "../../translate/core/catalog.js";
+import { DEFAULT_LANGUAGE } from "./languages.js";
+import { messageSession, notifyMessages } from "./session.js";
+/**
+ * The messages of one repository, read in whichever language the page is
+ * written in.
+ */
+export class MessageCatalog {
+    /** The name the page knows this catalog by. */
+    id;
+    /** What a translator's session and the overlay need to place an edit. */
+    source;
+    #loaded = new Map();
+    #loaders = new Map();
+    #pending = new Map();
+    /**
+     * Declare a catalog.
+     * @param options - See {@link MessageCatalogOptions}.
+     */
+    constructor(options) {
+        const { id, repository, directory, source, translations = {} } = options;
+        this.id = id;
+        this.source = { id, repository, directory, messages: source };
+        this.#loaded.set(DEFAULT_LANGUAGE, source);
+        for (const [language, messages] of Object.entries(translations)) {
+            if (messages === undefined)
+                continue;
+            if (typeof messages === 'function') {
+                this.#loaders.set(language, messages);
+            }
+            else {
+                this.#loaded.set(language, messages);
+            }
+        }
+    }
+    /**
+     * The languages this catalog carries, whether or not they are in memory.
+     * @returns The languages, English first.
+     */
+    get languages() {
+        return [...new Set([...this.#loaded.keys(), ...this.#loaders.keys()])];
+    }
+    /**
+     * The text a key carries in one language.
+     * @param key - Key to read.
+     * @param language - Language to read it in.
+     * @param options - See {@link TranslateOptions}.
+     * @returns The text.
+     */
+    translate(key, language, options = {}) {
+        const { fallback = key, values } = options;
+        const english = this.source.messages;
+        const session = messageSession();
+        if (session !== null) {
+            // A key the catalog does not declare is not the translator's to edit:
+            // marking it would offer them a message that lives nowhere.
+            if (ownMessage(english, key) === undefined)
+                return fill(fallback, values);
+            return session.format(this.id, key, values);
+        }
+        const translated = this.#loaded.get(language);
+        const message = (translated === undefined ? undefined : ownMessage(translated, key)) ??
+            ownMessage(english, key) ??
+            fallback;
+        return fill(message, values);
+    }
+    /**
+     * The messages of a language, once they are in memory.
+     * @param language - Language asked for.
+     * @returns The messages, or an empty catalog while they are still coming.
+     */
+    messages(language) {
+        return this.#loaded.get(language) ?? {};
+    }
+    /**
+     * Fetch a language's messages, if they are not in memory already.
+     * @param language - Language to read next.
+     * @returns Its messages.
+     */
+    async load(language) {
+        const loaded = this.#loaded.get(language);
+        if (loaded !== undefined)
+            return loaded;
+        const pending = this.#pending.get(language);
+        if (pending !== undefined)
+            return pending;
+        const loader = this.#loaders.get(language);
+        if (loader === undefined)
+            return {};
+        const fetching = loader().then((module) => {
+            this.#loaded.set(language, module.default);
+            this.#pending.delete(language);
+            notifyMessages();
+            return module.default;
+        }, () => {
+            // A language that cannot be fetched is a page in English, never a
+            // page of raw keys: forget the attempt so a later render retries.
+            this.#pending.delete(language);
+            return {};
+        });
+        this.#pending.set(language, fetching);
+        return fetching;
+    }
+    /**
+     * Start fetching a language without waiting for it. Safe to call on every
+     * render: a language already in memory, or already on its way, costs
+     * nothing.
+     * @param language - Language the page is about to be written in.
+     */
+    prefetch(language) {
+        if (this.#loaded.has(language) || this.#pending.has(language))
+            return;
+        void this.load(language);
+    }
+}
+const PLACEHOLDER = /\{(?<name>\w+)\}/g;
+function fill(message, values) {
+    if (values === undefined)
+        return message;
+    return message.replaceAll(PLACEHOLDER, (match, name) => Object.hasOwn(values, name) ? String(values[name]) : match);
+}
+//# sourceMappingURL=messageCatalog.js.map

package/lib/i18n/core/messageCatalog.js.map

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

package/lib/i18n/core/messageValues.d.ts

@@ -0,0 +1,3 @@
+/** What a message's `{placeholder}`s stand for. */
+export type MessageValues = Record<string, string | number>;
+//# sourceMappingURL=messageValues.d.ts.map

package/lib/i18n/core/messageValues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageValues.d.ts","sourceRoot":"","sources":["../../../src/i18n/core/messageValues.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC"}

package/lib/i18n/core/messageValues.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=messageValues.js.map

package/lib/i18n/core/messageValues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageValues.js","sourceRoot":"","sources":["../../../src/i18n/core/messageValues.ts"],"names":[],"mappings":""}

package/lib/i18n/core/session.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Where the page formats its messages from, and who is told when that changes.
+ *
+ * Ordinarily a message is read straight out of a catalog. While a translator
+ * has the page open, every message goes through their session instead — marked
+ * invisibly so the overlay can find it in the DOM, and answered with whatever
+ * they have typed rather than with what was published. Both the session and a
+ * language arriving late are changes the page has to redraw for, so they share
+ * one version counter and one set of listeners.
+ */
+import type { MessageValues } from './messageValues.ts';
+/**
+ * What a page in translate mode formats through — satisfied by
+ * `TranslateSession` from `react-cheminfo/translate`, which is never imported
+ * here: an ordinary visit must not load the ICU formatter behind it.
+ */
+export interface MessageSession {
+    /** The message of a catalog, formatted and marked. */
+    format: (catalogId: string, key: string, values?: MessageValues) => string;
+    /** Be told whenever an edit is typed; returns the function that stops it. */
+    subscribe?: (listener: () => void) => () => void;
+}
+/**
+ * Format every message through a translator's session from now on.
+ *
+ * While one is set it is the session's locale the page is written in, not the
+ * visitor's preference, and every message carries the marker the overlay finds
+ * it by.
+ * @param active - The session, or `null` to go back to the catalogs.
+ */
+export declare function setMessageSession(active: MessageSession | null): void;
+/**
+ * The session the page formats through, if a translator has it open.
+ * @returns The session, or `null`.
+ */
+export declare function messageSession(): MessageSession | null;
+/**
+ * How many times the text of the page has changed — a session set or dropped,
+ * an edit typed, a language finished loading.
+ * @returns The count, which only ever grows.
+ */
+export declare function messagesVersion(): number;
+/**
+ * Be told whenever the text of the page changes.
+ * @param listener - Called after each change.
+ * @returns The function that stops it.
+ */
+export declare function subscribeToMessages(listener: () => void): () => void;
+/** Say that the text of the page has changed. Never part of the public API. */
+export declare function notifyMessages(): void;
+//# sourceMappingURL=session.d.ts.map

package/lib/i18n/core/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/i18n/core/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,KAAK,MAAM,CAAC;IAC3E,6EAA6E;IAC7E,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CAClD;AAOD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAQrE;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,cAAc,GAAG,IAAI,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAKpE;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,IAAI,IAAI,CAGrC"}

package/lib/i18n/core/session.js

@@ -0,0 +1,64 @@
+/**
+ * Where the page formats its messages from, and who is told when that changes.
+ *
+ * Ordinarily a message is read straight out of a catalog. While a translator
+ * has the page open, every message goes through their session instead — marked
+ * invisibly so the overlay can find it in the DOM, and answered with whatever
+ * they have typed rather than with what was published. Both the session and a
+ * language arriving late are changes the page has to redraw for, so they share
+ * one version counter and one set of listeners.
+ */
+let session = null;
+let stopListening = null;
+let version = 0;
+const listeners = new Set();
+/**
+ * Format every message through a translator's session from now on.
+ *
+ * While one is set it is the session's locale the page is written in, not the
+ * visitor's preference, and every message carries the marker the overlay finds
+ * it by.
+ * @param active - The session, or `null` to go back to the catalogs.
+ */
+export function setMessageSession(active) {
+    stopListening?.();
+    stopListening = null;
+    session = active;
+    if (active?.subscribe !== undefined) {
+        stopListening = active.subscribe(notifyMessages);
+    }
+    notifyMessages();
+}
+/**
+ * The session the page formats through, if a translator has it open.
+ * @returns The session, or `null`.
+ */
+export function messageSession() {
+    return session;
+}
+/**
+ * How many times the text of the page has changed — a session set or dropped,
+ * an edit typed, a language finished loading.
+ * @returns The count, which only ever grows.
+ */
+export function messagesVersion() {
+    return version;
+}
+/**
+ * Be told whenever the text of the page changes.
+ * @param listener - Called after each change.
+ * @returns The function that stops it.
+ */
+export function subscribeToMessages(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+/** Say that the text of the page has changed. Never part of the public API. */
+export function notifyMessages() {
+    version++;
+    for (const listener of listeners)
+        listener();
+}
+//# sourceMappingURL=session.js.map

package/lib/i18n/core/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/i18n/core/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgBH,IAAI,OAAO,GAA0B,IAAI,CAAC;AAC1C,IAAI,aAAa,GAAwB,IAAI,CAAC;AAC9C,IAAI,OAAO,GAAG,CAAC,CAAC;AAChB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;AAExC;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA6B;IAC7D,aAAa,EAAE,EAAE,CAAC;IAClB,aAAa,GAAG,IAAI,CAAC;IACrB,OAAO,GAAG,MAAM,CAAC;IACjB,IAAI,MAAM,EAAE,SAAS,KAAK,SAAS,EAAE,CAAC;QACpC,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IACnD,CAAC;IACD,cAAc,EAAE,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAoB;IACtD,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,cAAc;IAC5B,OAAO,EAAE,CAAC;IACV,KAAK,MAAM,QAAQ,IAAI,SAAS;QAAE,QAAQ,EAAE,CAAC;AAC/C,CAAC"}

package/lib/i18n/core/translateSetup.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Handing a page's catalogs to a translator.
+ *
+ * `startTranslating` wants the catalogs and, beside them, whatever of the
+ * target language is already published — that is what tells the overlay which
+ * messages are still missing. The published messages of a language are exactly
+ * what a catalog fetches on demand, so they are gathered here rather than
+ * re-imported by every site.
+ */
+import type { CatalogSource, Messages } from '../../translate/core/catalog.ts';
+import type { MessageCatalog } from './messageCatalog.ts';
+/** What `startTranslating` is handed. */
+export interface LoadedCatalogs {
+    /** The catalogs, as the session registers them. */
+    catalogs: CatalogSource[];
+    /** What is already published in the locale, by catalog id. */
+    translations: Record<string, Messages>;
+}
+/**
+ * Fetch what each catalog already publishes in a locale.
+ * @param catalogs - The catalogs the page renders from.
+ * @param locale - The locale being translated into, which may well be one the
+ * family does not speak yet — then nothing is published and every message is
+ * offered as missing.
+ * @returns See {@link LoadedCatalogs}.
+ */
+export declare function loadCatalogs(catalogs: ReadonlyArray<MessageCatalog<string>>, locale: string): Promise<LoadedCatalogs>;
+//# sourceMappingURL=translateSetup.d.ts.map

package/lib/i18n/core/translateSetup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translateSetup.d.ts","sourceRoot":"","sources":["../../../src/i18n/core/translateSetup.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAG/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACxC;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,aAAa,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAC/C,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CAYzB"}

package/lib/i18n/core/translateSetup.js

@@ -0,0 +1,30 @@
+/**
+ * Handing a page's catalogs to a translator.
+ *
+ * `startTranslating` wants the catalogs and, beside them, whatever of the
+ * target language is already published — that is what tells the overlay which
+ * messages are still missing. The published messages of a language are exactly
+ * what a catalog fetches on demand, so they are gathered here rather than
+ * re-imported by every site.
+ */
+import { isLanguage } from "./languages.js";
+/**
+ * Fetch what each catalog already publishes in a locale.
+ * @param catalogs - The catalogs the page renders from.
+ * @param locale - The locale being translated into, which may well be one the
+ * family does not speak yet — then nothing is published and every message is
+ * offered as missing.
+ * @returns See {@link LoadedCatalogs}.
+ */
+export async function loadCatalogs(catalogs, locale) {
+    const language = isLanguage(locale) ? locale : undefined;
+    const translations = {};
+    if (language !== undefined) {
+        const loaded = await Promise.all(catalogs.map(async (catalog) => catalog.load(language)));
+        for (const [index, catalog] of catalogs.entries()) {
+            translations[catalog.id] = loaded[index] ?? {};
+        }
+    }
+    return { catalogs: catalogs.map((catalog) => catalog.source), translations };
+}
+//# sourceMappingURL=translateSetup.js.map

package/lib/i18n/core/translateSetup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translateSetup.js","sourceRoot":"","sources":["../../../src/i18n/core/translateSetup.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAW5C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAA+C,EAC/C,MAAc;IAEd,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACzD,MAAM,YAAY,GAA6B,EAAE,CAAC;IAClD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CACxD,CAAC;QACF,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YAClD,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACjD,CAAC;IACH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;AAC/E,CAAC"}

package/lib/i18n/ui/LanguageSelect.d.ts

@@ -0,0 +1,37 @@
+import type { ReactElement } from 'react';
+import type { Language } from '../core/languages.ts';
+/** Props of {@link LanguageSelect}. */
+export interface LanguageSelectProps {
+    /** The language the site is written in. */
+    value: Language;
+    /** Called with the language picked. */
+    onChange: (language: Language) => void;
+    /**
+     * The languages on offer, for a site that is not written in all four yet.
+     * @default LANGUAGES
+     */
+    languages?: readonly Language[];
+    /**
+     * Whether the bar has run out of room, so the row collapses to the language
+     * in force and a click advances to the next.
+     * @default false
+     */
+    compact?: boolean;
+    /**
+     * `data-testid` of the row; each button carries it suffixed by its tag.
+     * @default 'language-select'
+     */
+    testId?: string;
+}
+/**
+ * The language switch of the site header: the tags themselves, the one in
+ * force pressed.
+ *
+ * A language names itself — `FR` in the bar, `Français` behind it — because a
+ * reader looking for their own language would have to know English to find it
+ * written any other way.
+ * @param props - See {@link LanguageSelectProps}.
+ * @returns The row.
+ */
+export declare function LanguageSelect(props: LanguageSelectProps): ReactElement;
+//# sourceMappingURL=LanguageSelect.d.ts.map

package/lib/i18n/ui/LanguageSelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LanguageSelect.d.ts","sourceRoot":"","sources":["../../../src/i18n/ui/LanguageSelect.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAI1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAKrD,uCAAuC;AACvC,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,KAAK,EAAE,QAAQ,CAAC;IAChB,uCAAuC;IACvC,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IACvC;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAChC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CAoBvE"}

package/lib/i18n/ui/LanguageSelect.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { HeaderToggle } from "../../chrome/ui/HeaderToggle.js";
+import { LANGUAGES, LANGUAGE_LABELS } from "../core/languages.js";
+import { useChromeT } from "./useT.js";
+/**
+ * The language switch of the site header: the tags themselves, the one in
+ * force pressed.
+ *
+ * A language names itself — `FR` in the bar, `Français` behind it — because a
+ * reader looking for their own language would have to know English to find it
+ * written any other way.
+ * @param props - See {@link LanguageSelectProps}.
+ * @returns The row.
+ */
+export function LanguageSelect(props) {
+    const { value, onChange, languages = LANGUAGES, compact = false, testId = 'language-select', } = props;
+    const t = useChromeT();
+    return (_jsx(HeaderToggle, { label: t('language.label'), options: languages.map(toOption), value: value, onChange: onChange, compact: compact, testId: testId }));
+}
+function toOption(language) {
+    return {
+        value: language,
+        label: language.toUpperCase(),
+        title: LANGUAGE_LABELS[language],
+    };
+}
+//# sourceMappingURL=LanguageSelect.js.map

package/lib/i18n/ui/LanguageSelect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LanguageSelect.js","sourceRoot":"","sources":["../../../src/i18n/ui/LanguageSelect.tsx"],"names":[],"mappings":";AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAkC,CAAC;AAEhE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AA0BvC;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,MAAM,EACJ,KAAK,EACL,QAAQ,EACR,SAAS,GAAG,SAAS,EACrB,OAAO,GAAG,KAAK,EACf,MAAM,GAAG,iBAAiB,GAC3B,GAAG,KAAK,CAAC;IACV,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;IAEvB,OAAO,CACL,KAAC,YAAY,IACX,KAAK,EAAE,CAAC,CAAC,gBAAgB,CAAC,EAC1B,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAChC,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GACd,CACH,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,QAAkB;IAClC,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,QAAQ,CAAC,WAAW,EAAE;QAC7B,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC;KACjC,CAAC;AACJ,CAAC"}

package/lib/i18n/ui/index.d.ts

@@ -0,0 +1,6 @@
+export type { LanguageSelectProps } from './LanguageSelect.tsx';
+export { LanguageSelect } from './LanguageSelect.tsx';
+export { useIsTranslating, useLanguage, useMessagesVersion, } from './useLanguage.ts';
+export type { Translate } from './useT.ts';
+export { translateMessage, useChromeT, useT } from './useT.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/i18n/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/i18n/ui/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/lib/i18n/ui/index.js

@@ -0,0 +1,4 @@
+export { LanguageSelect } from "./LanguageSelect.js";
+export { useIsTranslating, useLanguage, useMessagesVersion, } from "./useLanguage.js";
+export { translateMessage, useChromeT, useT } from "./useT.js";
+//# sourceMappingURL=index.js.map

package/lib/i18n/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/i18n/ui/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAsB,CAAC;AACtD,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/lib/i18n/ui/useLanguage.d.ts

@@ -0,0 +1,23 @@
+import type { Language } from '../core/languages.ts';
+/**
+ * The language the page is written in.
+ *
+ * It is what the site declared with `SiteLanguage`, or what the address names
+ * when the site declared nothing — the same value every link out of the page
+ * carries, so the chrome is never written in a language the links deny.
+ * @returns The language.
+ */
+export declare function useLanguage(): Language;
+/**
+ * Redraw whenever the text of the page changes — a language finished loading,
+ * a translator typed an edit, a session was set or dropped.
+ * @returns The version the page was drawn at.
+ */
+export declare function useMessagesVersion(): number;
+/**
+ * Whether a translator has the page open, in which case the language switch
+ * says nothing about what is on show.
+ * @returns True in translate mode.
+ */
+export declare function useIsTranslating(): boolean;
+//# sourceMappingURL=useLanguage.d.ts.map

package/lib/i18n/ui/useLanguage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLanguage.d.ts","sourceRoot":"","sources":["../../../src/i18n/ui/useLanguage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAQrD;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAKtC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAM3C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C"}

package/lib/i18n/ui/useLanguage.js

@@ -0,0 +1,36 @@
+import { useSyncExternalStore } from 'react';
+import { useSiteLanguage } from "../../language/ui/siteLanguageContext.js";
+import { DEFAULT_LANGUAGE, isLanguage } from "../core/languages.js";
+import { messageSession, messagesVersion, subscribeToMessages, } from "../core/session.js";
+/**
+ * The language the page is written in.
+ *
+ * It is what the site declared with `SiteLanguage`, or what the address names
+ * when the site declared nothing — the same value every link out of the page
+ * carries, so the chrome is never written in a language the links deny.
+ * @returns The language.
+ */
+export function useLanguage() {
+    const declared = useSiteLanguage();
+    return declared !== undefined && isLanguage(declared)
+        ? declared
+        : DEFAULT_LANGUAGE;
+}
+/**
+ * Redraw whenever the text of the page changes — a language finished loading,
+ * a translator typed an edit, a session was set or dropped.
+ * @returns The version the page was drawn at.
+ */
+export function useMessagesVersion() {
+    return useSyncExternalStore(subscribeToMessages, messagesVersion, messagesVersion);
+}
+/**
+ * Whether a translator has the page open, in which case the language switch
+ * says nothing about what is on show.
+ * @returns True in translate mode.
+ */
+export function useIsTranslating() {
+    useMessagesVersion();
+    return messageSession() !== null;
+}
+//# sourceMappingURL=useLanguage.js.map

package/lib/i18n/ui/useLanguage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLanguage.js","sourceRoot":"","sources":["../../../src/i18n/ui/useLanguage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAE3E,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EACL,cAAc,EACd,eAAe,EACf,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,OAAO,QAAQ,KAAK,SAAS,IAAI,UAAU,CAAC,QAAQ,CAAC;QACnD,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,gBAAgB,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,oBAAoB,CACzB,mBAAmB,EACnB,eAAe,EACf,eAAe,CAChB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,kBAAkB,EAAE,CAAC;IACrB,OAAO,cAAc,EAAE,KAAK,IAAI,CAAC;AACnC,CAAC"}

package/lib/i18n/ui/useT.d.ts

@@ -0,0 +1,47 @@
+import type { ChromeKey } from '../core/chromeCatalog.ts';
+import type { Language, LooseKey, MessageValues, TranslateOptions } from '../core/index.ts';
+import type { MessageCatalog } from '../core/messageCatalog.ts';
+/**
+ * What a component reads its text with.
+ *
+ * `t(key)` is a key the catalog declares, checked at compile time.
+ * `t.or(key, fallback)` is a key built from the data — a site's id, an
+ * element's symbol — which the catalog may not have caught up with yet; it
+ * reads as the fallback rather than as a raw key.
+ */
+export type Translate<TKey extends string> = ((key: LooseKey<TKey>, values?: MessageValues) => string) & {
+    or: (key: string, fallback: string, values?: MessageValues) => string;
+};
+/**
+ * The formatter of a catalog's text, in the language the page is written in.
+ *
+ * It is meant to be called while rendering, never kept in a module constant:
+ * the language and a translator's edits both change under the page, and only a
+ * render picks them up.
+ * @param catalog - The catalog to read, typed by its English keys.
+ * @returns See {@link Translate}.
+ */
+export declare function useT<TKey extends string>(catalog: MessageCatalog<TKey>): Translate<TKey>;
+/**
+ * The formatter of this library's own text — the header, the Tools menu, the
+ * share dialog, the About page.
+ *
+ * A site reads it for a word it shows beside the chrome's own, so `Share` and
+ * `Cite` are written the same way everywhere.
+ * @returns `t(key, values)`, typed by the chrome's English catalog.
+ */
+export declare function useChromeT(): Translate<ChromeKey>;
+/**
+ * One message of a catalog, outside a component.
+ *
+ * Only for the rare place a hook cannot go — a label computed in a module
+ * helper, a message thrown from a worker. A component uses {@link useT}, which
+ * redraws when the language does.
+ * @param catalog - The catalog to read.
+ * @param key - Key to read.
+ * @param language - Language to read it in.
+ * @param options - See `TranslateOptions`.
+ * @returns The text.
+ */
+export declare function translateMessage<TKey extends string>(catalog: MessageCatalog<TKey>, key: LooseKey<TKey>, language: Language, options?: TranslateOptions): string;
+//# sourceMappingURL=useT.d.ts.map

package/lib/i18n/ui/useT.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useT.d.ts","sourceRoot":"","sources":["../../../src/i18n/ui/useT.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,CAAC,IAAI,SAAS,MAAM,IAAI,CAAC,CAC5C,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,EACnB,MAAM,CAAC,EAAE,aAAa,KACnB,MAAM,CAAC,GAAG;IACb,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,KAAK,MAAM,CAAC;CACvE,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,IAAI,SAAS,MAAM,EACtC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAC5B,SAAS,CAAC,IAAI,CAAC,CAKjB;AAeD;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,SAAS,CAAC,SAAS,CAAC,CAEjD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,MAAM,EAClD,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,EAC7B,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,EACnB,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,gBAAgB,GACzB,MAAM,CAER"}

package/lib/i18n/ui/useT.js

@@ -0,0 +1,51 @@
+import { CHROME_CATALOG } from "../core/chromeCatalog.js";
+import { useLanguage, useMessagesVersion } from "./useLanguage.js";
+/**
+ * The formatter of a catalog's text, in the language the page is written in.
+ *
+ * It is meant to be called while rendering, never kept in a module constant:
+ * the language and a translator's edits both change under the page, and only a
+ * render picks them up.
+ * @param catalog - The catalog to read, typed by its English keys.
+ * @returns See {@link Translate}.
+ */
+export function useT(catalog) {
+    const language = useLanguage();
+    useMessagesVersion();
+    catalog.prefetch(language);
+    return translator(catalog, language);
+}
+// Built outside the hook, because the `or` form is a property of the function
+// itself and a render may not write to a value it has just read.
+function translator(catalog, language) {
+    const translate = (key, values) => catalog.translate(key, language, { values });
+    translate.or = (key, fallback, values) => catalog.translate(key, language, { fallback, values });
+    return translate;
+}
+/**
+ * The formatter of this library's own text — the header, the Tools menu, the
+ * share dialog, the About page.
+ *
+ * A site reads it for a word it shows beside the chrome's own, so `Share` and
+ * `Cite` are written the same way everywhere.
+ * @returns `t(key, values)`, typed by the chrome's English catalog.
+ */
+export function useChromeT() {
+    return useT(CHROME_CATALOG);
+}
+/**
+ * One message of a catalog, outside a component.
+ *
+ * Only for the rare place a hook cannot go — a label computed in a module
+ * helper, a message thrown from a worker. A component uses {@link useT}, which
+ * redraws when the language does.
+ * @param catalog - The catalog to read.
+ * @param key - Key to read.
+ * @param language - Language to read it in.
+ * @param options - See `TranslateOptions`.
+ * @returns The text.
+ */
+export function translateMessage(catalog, key, language, options) {
+    return catalog.translate(key, language, options);
+}
+//# sourceMappingURL=useT.js.map

package/lib/i18n/ui/useT.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useT.js","sourceRoot":"","sources":["../../../src/i18n/ui/useT.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAS1D,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAiBnE;;;;;;;;GAQG;AACH,MAAM,UAAU,IAAI,CAClB,OAA6B;IAE7B,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,kBAAkB,EAAE,CAAC;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3B,OAAO,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,8EAA8E;AAC9E,iEAAiE;AACjE,SAAS,UAAU,CACjB,OAA6B,EAC7B,QAAkB;IAElB,MAAM,SAAS,GAAG,CAAC,GAAmB,EAAE,MAAsB,EAAE,EAAE,CAChE,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/C,SAAS,CAAC,EAAE,GAAG,CAAC,GAAW,EAAE,QAAgB,EAAE,MAAsB,EAAE,EAAE,CACvE,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACzD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,cAAc,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAA6B,EAC7B,GAAmB,EACnB,QAAkB,EAClB,OAA0B;IAE1B,OAAO,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC"}