react-cheminfo 0.53.0 → 0.54.0

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

@@ -5,6 +5,8 @@ export { DEFAULT_LANGUAGE, LANGUAGES, LANGUAGE_LABELS, isLanguage, } from './lan
 export type { LooseKey, MessageCatalogOptions, MessagesLoader, TranslateOptions, } from './messageCatalog.ts';
 export { MessageCatalog } from './messageCatalog.ts';
 export type { MessageValues } from './messageValues.ts';
+export type { Translate } from './translate.ts';
+export { catalogTranslate } from './translate.ts';
 export type { ProsePiece } from './prose.ts';
 export { splitProse } from './prose.ts';
 export type { MessageSession } from './session.ts';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/i18n/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,QAAQ,EACR,qBAAqB,EACrB,cAAc,EACd,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/i18n/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,QAAQ,EACR,qBAAqB,EACrB,cAAc,EACd,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/lib/i18n/core/index.js

@@ -1,6 +1,7 @@
 export { CHROME_CATALOG, CHROME_CATALOG_ID } from "./chromeCatalog.js";
 export { DEFAULT_LANGUAGE, LANGUAGES, LANGUAGE_LABELS, isLanguage, } from "./languages.js";
 export { MessageCatalog } from "./messageCatalog.js";
+export { catalogTranslate } from "./translate.js";
 export { splitProse } from "./prose.js";
 export { messageSession, messagesVersion, setMessageSession, subscribeToMessages, } from "./session.js";
 export { loadCatalogs } from "./translateSetup.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/i18n/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvE,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,UAAU,GACX,MAAM,gBAAgB,CAAC;AAOxB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/i18n/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvE,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,UAAU,GACX,MAAM,gBAAgB,CAAC;AAOxB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

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

@@ -90,6 +90,16 @@ export declare class MessageCatalog<TKey extends string = string> {
      * @returns The text.
      */
     translate(key: LooseKey<TKey>, language: Language, options?: TranslateOptions): string;
+    /**
+     * Whether the catalog declares a key at all.
+     *
+     * English is the list of keys, so this is what a loop walking a numbered
+     * family of messages — `how.limits.p1`, `p2`, … — stops on, and what tells a
+     * page a section was never written from one left untranslated.
+     * @param key - Key to look for.
+     * @returns True when English carries it.
+     */
+    declares(key: string): boolean;
     /**
      * The messages of a language, once they are in memory.
      * @param language - Language asked for.

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

@@ -1 +1 @@
-{"version":3,"file":"messageCatalog.d.ts","sourceRoot":"","sources":["../../../src/i18n/core/messageCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAG/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,iFAAiF;AACjF,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,CAAC,IAAI,SAAS,MAAM,IACtC,IAAI,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAEzC,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,iCAAiC;AACjC,MAAM,WAAW,qBAAqB,CAAC,IAAI,SAAS,MAAM;IACxD;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7B;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAAC,CAAC,CAAC;CACrE;AAED;;;GAGG;AACH,qBAAa,cAAc,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM;;IACtD,+CAA+C;IAC/C,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,SAAgB,MAAM,EAAE,aAAa,CAAC;IAMtC;;;OAGG;gBACgB,OAAO,EAAE,qBAAqB,CAAC,IAAI,CAAC;IAevD;;;OAGG;IACH,IAAW,SAAS,IAAI,QAAQ,EAAE,CAEjC;IAED;;;;;;OAMG;IACI,SAAS,CACd,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,EACnB,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,gBAAqB,GAC7B,MAAM;IAkBT;;;;OAIG;IACI,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAI7C;;;;OAIG;IACU,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAyBxD;;;;;OAKG;IACI,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;CAI1C"}
+{"version":3,"file":"messageCatalog.d.ts","sourceRoot":"","sources":["../../../src/i18n/core/messageCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAG/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,iFAAiF;AACjF,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,CAAC,IAAI,SAAS,MAAM,IACtC,IAAI,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAEzC,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,iCAAiC;AACjC,MAAM,WAAW,qBAAqB,CAAC,IAAI,SAAS,MAAM;IACxD;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7B;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAAC,CAAC,CAAC;CACrE;AAED;;;GAGG;AACH,qBAAa,cAAc,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM;;IACtD,+CAA+C;IAC/C,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,SAAgB,MAAM,EAAE,aAAa,CAAC;IAMtC;;;OAGG;gBACgB,OAAO,EAAE,qBAAqB,CAAC,IAAI,CAAC;IAevD;;;OAGG;IACH,IAAW,SAAS,IAAI,QAAQ,EAAE,CAEjC;IAED;;;;;;OAMG;IACI,SAAS,CACd,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,EACnB,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,gBAAqB,GAC7B,MAAM;IAkBT;;;;;;;;OAQG;IACI,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIrC;;;;OAIG;IACI,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAI7C;;;;OAIG;IACU,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAyBxD;;;;;OAKG;IACI,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;CAI1C"}

package/lib/i18n/core/messageCatalog.js

@@ -77,6 +77,18 @@ export class MessageCatalog {
             fallback;
         return fill(message, values);
     }
+    /**
+     * Whether the catalog declares a key at all.
+     *
+     * English is the list of keys, so this is what a loop walking a numbered
+     * family of messages — `how.limits.p1`, `p2`, … — stops on, and what tells a
+     * page a section was never written from one left untranslated.
+     * @param key - Key to look for.
+     * @returns True when English carries it.
+     */
+    declares(key) {
+        return ownMessage(this.source.messages, key) !== undefined;
+    }
     /**
      * The messages of a language, once they are in memory.
      * @param language - Language asked for.

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

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

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

@@ -0,0 +1,35 @@
+/**
+ * The formatter a catalog's text is read through, outside React.
+ *
+ * `useT` is this function with the page's language and a redraw wired to it;
+ * the build and a site's own tests need the same shape without either, so it
+ * lives here rather than in the hook. A site never writes its own: four of
+ * them had, each with a slightly different fallback.
+ */
+import type { Language } from './languages.ts';
+import type { LooseKey, MessageCatalog } from './messageCatalog.ts';
+import type { MessageValues } from './messageValues.ts';
+/**
+ * What text is read 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;
+};
+/**
+ * A catalog's formatter, in one language.
+ *
+ * In a component this is `useT`, which also redraws when the language or a
+ * translator's edit changes it. Here it is for the places a hook cannot go:
+ * the build writing a head per address per language, a test asserting on the
+ * text a page shows, a label computed in a module helper.
+ * @param catalog - The catalog to read, typed by its English keys.
+ * @param language - The language to read it in.
+ * @returns See {@link Translate}.
+ */
+export declare function catalogTranslate<TKey extends string>(catalog: MessageCatalog<TKey>, language: Language): Translate<TKey>;
+//# sourceMappingURL=translate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../../../src/i18n/core/translate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;;;;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;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,MAAM,EAClD,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,EAC7B,QAAQ,EAAE,QAAQ,GACjB,SAAS,CAAC,IAAI,CAAC,CAQjB"}

package/lib/i18n/core/translate.js

@@ -0,0 +1,27 @@
+/**
+ * The formatter a catalog's text is read through, outside React.
+ *
+ * `useT` is this function with the page's language and a redraw wired to it;
+ * the build and a site's own tests need the same shape without either, so it
+ * lives here rather than in the hook. A site never writes its own: four of
+ * them had, each with a slightly different fallback.
+ */
+/**
+ * A catalog's formatter, in one language.
+ *
+ * In a component this is `useT`, which also redraws when the language or a
+ * translator's edit changes it. Here it is for the places a hook cannot go:
+ * the build writing a head per address per language, a test asserting on the
+ * text a page shows, a label computed in a module helper.
+ * @param catalog - The catalog to read, typed by its English keys.
+ * @param language - The language to read it in.
+ * @returns See {@link Translate}.
+ */
+export function catalogTranslate(catalog, language) {
+    // `or` is a property of the function itself, so the two are built together
+    // rather than assigned onto a value a render may already have read.
+    const translate = (key, values) => catalog.translate(key, language, { values });
+    translate.or = (key, fallback, values) => catalog.translate(key, language, { fallback, values });
+    return translate;
+}
+//# sourceMappingURL=translate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"translate.js","sourceRoot":"","sources":["../../../src/i18n/core/translate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqBH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAA6B,EAC7B,QAAkB;IAElB,2EAA2E;IAC3E,oEAAoE;IACpE,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"}

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

@@ -1,17 +1,7 @@
 import type { ChromeKey } from '../core/chromeCatalog.ts';
-import type { Language, LooseKey, MessageValues, TranslateOptions } from '../core/index.ts';
+import type { Language, LooseKey, Translate, 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;
-};
+export type { Translate } from '../core/index.ts';
 /**
  * The formatter of a catalog's text, in the language the page is written in.
  *

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

@@ -1 +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"}
+{"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,SAAS,EACT,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAMhE,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;;;;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

@@ -1,4 +1,5 @@
 import { CHROME_CATALOG } from "../core/chromeCatalog.js";
+import { catalogTranslate } from "../core/index.js";
 import { useLanguage, useMessagesVersion } from "./useLanguage.js";
 /**
  * The formatter of a catalog's text, in the language the page is written in.
@@ -13,14 +14,7 @@ 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;
+    return catalogTranslate(catalog, language);
 }
 /**
  * The formatter of this library's own text — the header, the Tools menu, the

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

@@ -1 +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"}
+{"version":3,"file":"useT.js","sourceRoot":"","sources":["../../../src/i18n/ui/useT.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAO1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAMnE;;;;;;;;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,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC7C,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"}

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

@@ -0,0 +1,3 @@
+export type { LocaleCatalogOptions, LocaleCatalogSource, } from './localeCatalog.ts';
+export { readLocaleCatalog } from './localeCatalog.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/i18n/vite/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/lib/i18n/vite/index.js

@@ -0,0 +1,2 @@
+export { readLocaleCatalog } from "./localeCatalog.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/i18n/vite/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/lib/i18n/vite/localeCatalog.d.ts

@@ -0,0 +1,70 @@
+/**
+ * A site's catalogs as the build reads them: all of them, off disk, at once.
+ *
+ * The page and the build want opposite things from the same files. A browser
+ * fetches one language — the one being read — so `en.json` is part of the
+ * bundle and the others are `import()`ed when a visitor asks, which is what
+ * keeps a site nobody reads in German from downloading the German. The build
+ * writes a head per address per language in one pass, so it wants every
+ * language, synchronously, before the first route table is asked for.
+ *
+ * Reading them rather than fetching them is what makes that possible. The
+ * page's loaders are written bare — `import('../locales/fr.json')` with no
+ * `with { type: 'json' }` — because the dev server serves a JSON file as a
+ * JavaScript module and a browser refuses a chunk it was promised JSON for.
+ * Node demands the attribute, so it cannot run those loaders: a build that
+ * awaited them had to be async and still only worked by keeping a second,
+ * eagerly imported copy of every catalog beside the first. `readFileSync` has
+ * no attribute, so there is nothing to work around.
+ *
+ * The identity comes from the page's own catalog, never re-typed here: pass
+ * `SITE_CATALOG.source` and the two provably name the same files.
+ */
+import { MessageCatalog } from '../core/index.ts';
+/**
+ * Which catalog to read, which is the page catalog's own `source`.
+ *
+ * `MessageCatalog` publishes it for the translate overlay, and it already
+ * carries the three things a reader needs. Hand it over rather than writing
+ * them twice: a build that names its own directory is a build that can come to
+ * disagree with the page about which files the site is translated in.
+ */
+export interface LocaleCatalogSource {
+    /**
+     * The name the page knows the catalog by, which is the site's host, e.g.
+     * `surge.cheminfo.org`. A translator's edit is routed back to the right
+     * repository with it, so the build and the page must agree on it.
+     */
+    id: string;
+    /** The GitHub repository the files live in, written `owner/repo`. */
+    repository: string;
+    /** The directory holding the locale files, relative to the repository root. */
+    directory: string;
+}
+/** Where the directory is looked for. */
+export interface LocaleCatalogOptions {
+    /**
+     * What the source's relative `directory` is resolved against. The default is
+     * the working directory, which is the repository root for both callers: a
+     * Vite config and a vitest run.
+     * @default process.cwd()
+     */
+    root?: string;
+}
+/**
+ * Every language a site is written in, read off disk into one catalog.
+ *
+ * For the build and for a site's own tests, never for the page: it reads the
+ * filesystem, and the translations it holds are tens of kilobytes a first
+ * visit must not pay for. Read one language out of it with `catalogTranslate`.
+ *
+ * A language whose file is absent is left out, which the catalog already reads
+ * as English — a half-translated site serves the pages it has rather than
+ * failing the build. A missing English file is a misconfiguration and throws:
+ * every key and every fallback is declared there.
+ * @param source - The page catalog's own `source`. See {@link LocaleCatalogSource}.
+ * @param options - See {@link LocaleCatalogOptions}.
+ * @returns The catalog, every language it carries already in memory.
+ */
+export declare function readLocaleCatalog<TKey extends string = string>(source: LocaleCatalogSource, options?: LocaleCatalogOptions): MessageCatalog<TKey>;
+//# sourceMappingURL=localeCatalog.d.ts.map

package/lib/i18n/vite/localeCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localeCatalog.d.ts","sourceRoot":"","sources":["../../../src/i18n/vite/localeCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH,OAAO,EAA+B,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE/E;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5D,MAAM,EAAE,mBAAmB,EAC3B,OAAO,GAAE,oBAAyB,GACjC,cAAc,CAAC,IAAI,CAAC,CAsBtB"}

package/lib/i18n/vite/localeCatalog.js

@@ -0,0 +1,80 @@
+/**
+ * A site's catalogs as the build reads them: all of them, off disk, at once.
+ *
+ * The page and the build want opposite things from the same files. A browser
+ * fetches one language — the one being read — so `en.json` is part of the
+ * bundle and the others are `import()`ed when a visitor asks, which is what
+ * keeps a site nobody reads in German from downloading the German. The build
+ * writes a head per address per language in one pass, so it wants every
+ * language, synchronously, before the first route table is asked for.
+ *
+ * Reading them rather than fetching them is what makes that possible. The
+ * page's loaders are written bare — `import('../locales/fr.json')` with no
+ * `with { type: 'json' }` — because the dev server serves a JSON file as a
+ * JavaScript module and a browser refuses a chunk it was promised JSON for.
+ * Node demands the attribute, so it cannot run those loaders: a build that
+ * awaited them had to be async and still only worked by keeping a second,
+ * eagerly imported copy of every catalog beside the first. `readFileSync` has
+ * no attribute, so there is nothing to work around.
+ *
+ * The identity comes from the page's own catalog, never re-typed here: pass
+ * `SITE_CATALOG.source` and the two provably name the same files.
+ */
+import { readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { DEFAULT_LANGUAGE, LANGUAGES, MessageCatalog } from "../core/index.js";
+/**
+ * Every language a site is written in, read off disk into one catalog.
+ *
+ * For the build and for a site's own tests, never for the page: it reads the
+ * filesystem, and the translations it holds are tens of kilobytes a first
+ * visit must not pay for. Read one language out of it with `catalogTranslate`.
+ *
+ * A language whose file is absent is left out, which the catalog already reads
+ * as English — a half-translated site serves the pages it has rather than
+ * failing the build. A missing English file is a misconfiguration and throws:
+ * every key and every fallback is declared there.
+ * @param source - The page catalog's own `source`. See {@link LocaleCatalogSource}.
+ * @param options - See {@link LocaleCatalogOptions}.
+ * @returns The catalog, every language it carries already in memory.
+ */
+export function readLocaleCatalog(source, options = {}) {
+    const { id, repository, directory } = source;
+    const folder = resolve(options.root ?? process.cwd(), directory);
+    const english = readMessages(folder, DEFAULT_LANGUAGE);
+    if (english === undefined) {
+        throw new Error(`no ${DEFAULT_LANGUAGE}.json in ${folder}: a catalog declares its keys and its fallbacks there`);
+    }
+    const translations = {};
+    for (const language of LANGUAGES) {
+        if (language === DEFAULT_LANGUAGE)
+            continue;
+        const messages = readMessages(folder, language);
+        if (messages !== undefined)
+            translations[language] = messages;
+    }
+    return new MessageCatalog({
+        id,
+        repository,
+        directory,
+        source: english,
+        translations,
+    });
+}
+/**
+ * One language's messages, read off disk.
+ * @param folder - The resolved directory holding the locale files.
+ * @param language - The language whose file to read.
+ * @returns Its messages, or `undefined` when the site does not carry it.
+ */
+function readMessages(folder, language) {
+    let text;
+    try {
+        text = readFileSync(join(folder, `${language}.json`), 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+    return JSON.parse(text);
+}
+//# sourceMappingURL=localeCatalog.js.map

package/lib/i18n/vite/localeCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localeCatalog.js","sourceRoot":"","sources":["../../../src/i18n/vite/localeCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG1C,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAkC/E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAA2B,EAC3B,UAAgC,EAAE;IAElC,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACvD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,MAAM,gBAAgB,YAAY,MAAM,uDAAuD,CAChG,CAAC;IACJ,CAAC;IACD,MAAM,YAAY,GAAsD,EAAE,CAAC;IAC3E,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,QAAQ,KAAK,gBAAgB;YAAE,SAAS;QAC5C,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAChD,IAAI,QAAQ,KAAK,SAAS;YAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;IAChE,CAAC;IACD,OAAO,IAAI,cAAc,CAAO;QAC9B,EAAE;QACF,UAAU;QACV,SAAS;QACT,MAAM,EAAE,OAAO;QACf,YAAY;KACb,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CACnB,MAAc,EACd,QAAkB;IAElB,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,QAAQ,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAA2B,CAAC;AACpD,CAAC"}

package/lib/vite.d.ts

@@ -1,4 +1,5 @@
 export * from './build/vite/index.ts';
+export * from './i18n/vite/index.ts';
 export * from './seo/vite/index.ts';
 export * from './slides/vite/index.ts';
 //# sourceMappingURL=vite.d.ts.map

package/lib/vite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC"}

package/lib/vite.js

@@ -1,4 +1,5 @@
 export * from "./build/vite/index.js";
+export * from "./i18n/vite/index.js";
 export * from "./seo/vite/index.js";
 export * from "./slides/vite/index.js";
 //# sourceMappingURL=vite.js.map

package/lib/vite.js.map

@@ -1 +1 @@
-{"version":3,"file":"vite.js","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-cheminfo",
-  "version": "0.53.0",
+  "version": "0.54.0",
   "license": "MIT",
   "description": "React components, hooks and framework-free helpers shared by the cheminfo sites: site chrome, citations, sharing, routing, pedagogy, charts, and the structure, orbital and 3D molecule viewers",
   "author": "Luc Patiny",

package/src/i18n/core/index.ts

@@ -15,6 +15,8 @@ export type {
 } from './messageCatalog.ts';
 export { MessageCatalog } from './messageCatalog.ts';
 export type { MessageValues } from './messageValues.ts';
+export type { Translate } from './translate.ts';
+export { catalogTranslate } from './translate.ts';
 export type { ProsePiece } from './prose.ts';
 export { splitProse } from './prose.ts';
 export type { MessageSession } from './session.ts';

package/src/i18n/core/messageCatalog.ts

@@ -141,6 +141,19 @@ export class MessageCatalog<TKey extends string = string> {
     return fill(message, values);
   }
 
+  /**
+   * Whether the catalog declares a key at all.
+   *
+   * English is the list of keys, so this is what a loop walking a numbered
+   * family of messages — `how.limits.p1`, `p2`, … — stops on, and what tells a
+   * page a section was never written from one left untranslated.
+   * @param key - Key to look for.
+   * @returns True when English carries it.
+   */
+  public declares(key: string): boolean {
+    return ownMessage(this.source.messages, key) !== undefined;
+  }
+
   /**
    * The messages of a language, once they are in memory.
    * @param language - Language asked for.

package/src/i18n/core/translate.ts

@@ -0,0 +1,51 @@
+/**
+ * The formatter a catalog's text is read through, outside React.
+ *
+ * `useT` is this function with the page's language and a redraw wired to it;
+ * the build and a site's own tests need the same shape without either, so it
+ * lives here rather than in the hook. A site never writes its own: four of
+ * them had, each with a slightly different fallback.
+ */
+
+import type { Language } from './languages.ts';
+import type { LooseKey, MessageCatalog } from './messageCatalog.ts';
+import type { MessageValues } from './messageValues.ts';
+
+/**
+ * What text is read 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;
+};
+
+/**
+ * A catalog's formatter, in one language.
+ *
+ * In a component this is `useT`, which also redraws when the language or a
+ * translator's edit changes it. Here it is for the places a hook cannot go:
+ * the build writing a head per address per language, a test asserting on the
+ * text a page shows, a label computed in a module helper.
+ * @param catalog - The catalog to read, typed by its English keys.
+ * @param language - The language to read it in.
+ * @returns See {@link Translate}.
+ */
+export function catalogTranslate<TKey extends string>(
+  catalog: MessageCatalog<TKey>,
+  language: Language,
+): Translate<TKey> {
+  // `or` is a property of the function itself, so the two are built together
+  // rather than assigned onto a value a render may already have read.
+  const translate = (key: LooseKey<TKey>, values?: MessageValues) =>
+    catalog.translate(key, language, { values });
+  translate.or = (key: string, fallback: string, values?: MessageValues) =>
+    catalog.translate(key, language, { fallback, values });
+  return translate;
+}

package/src/i18n/ui/useT.ts

@@ -3,27 +3,17 @@ import { CHROME_CATALOG } from '../core/chromeCatalog.ts';
 import type {
   Language,
   LooseKey,
-  MessageValues,
+  Translate,
   TranslateOptions,
 } from '../core/index.ts';
+import { catalogTranslate } from '../core/index.ts';
 import type { MessageCatalog } from '../core/messageCatalog.ts';
 
 import { useLanguage, useMessagesVersion } from './useLanguage.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's own shape belongs to the catalog, not to the hook, and a site
+// reads it from either entry point.
+export type { Translate } from '../core/index.ts';
 
 /**
  * The formatter of a catalog's text, in the language the page is written in.
@@ -40,20 +30,7 @@ export function useT<TKey extends string>(
   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<TKey extends string>(
-  catalog: MessageCatalog<TKey>,
-  language: Language,
-): Translate<TKey> {
-  const translate = (key: LooseKey<TKey>, values?: MessageValues) =>
-    catalog.translate(key, language, { values });
-  translate.or = (key: string, fallback: string, values?: MessageValues) =>
-    catalog.translate(key, language, { fallback, values });
-  return translate;
+  return catalogTranslate(catalog, language);
 }
 
 /**

package/src/i18n/vite/index.ts

@@ -0,0 +1,5 @@
+export type {
+  LocaleCatalogOptions,
+  LocaleCatalogSource,
+} from './localeCatalog.ts';
+export { readLocaleCatalog } from './localeCatalog.ts';

package/src/i18n/vite/localeCatalog.ts

@@ -0,0 +1,121 @@
+/**
+ * A site's catalogs as the build reads them: all of them, off disk, at once.
+ *
+ * The page and the build want opposite things from the same files. A browser
+ * fetches one language — the one being read — so `en.json` is part of the
+ * bundle and the others are `import()`ed when a visitor asks, which is what
+ * keeps a site nobody reads in German from downloading the German. The build
+ * writes a head per address per language in one pass, so it wants every
+ * language, synchronously, before the first route table is asked for.
+ *
+ * Reading them rather than fetching them is what makes that possible. The
+ * page's loaders are written bare — `import('../locales/fr.json')` with no
+ * `with { type: 'json' }` — because the dev server serves a JSON file as a
+ * JavaScript module and a browser refuses a chunk it was promised JSON for.
+ * Node demands the attribute, so it cannot run those loaders: a build that
+ * awaited them had to be async and still only worked by keeping a second,
+ * eagerly imported copy of every catalog beside the first. `readFileSync` has
+ * no attribute, so there is nothing to work around.
+ *
+ * The identity comes from the page's own catalog, never re-typed here: pass
+ * `SITE_CATALOG.source` and the two provably name the same files.
+ */
+
+import { readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+
+import type { Language } from '../core/index.ts';
+import { DEFAULT_LANGUAGE, LANGUAGES, MessageCatalog } from '../core/index.ts';
+
+/**
+ * Which catalog to read, which is the page catalog's own `source`.
+ *
+ * `MessageCatalog` publishes it for the translate overlay, and it already
+ * carries the three things a reader needs. Hand it over rather than writing
+ * them twice: a build that names its own directory is a build that can come to
+ * disagree with the page about which files the site is translated in.
+ */
+export interface LocaleCatalogSource {
+  /**
+   * The name the page knows the catalog by, which is the site's host, e.g.
+   * `surge.cheminfo.org`. A translator's edit is routed back to the right
+   * repository with it, so the build and the page must agree on it.
+   */
+  id: string;
+  /** The GitHub repository the files live in, written `owner/repo`. */
+  repository: string;
+  /** The directory holding the locale files, relative to the repository root. */
+  directory: string;
+}
+
+/** Where the directory is looked for. */
+export interface LocaleCatalogOptions {
+  /**
+   * What the source's relative `directory` is resolved against. The default is
+   * the working directory, which is the repository root for both callers: a
+   * Vite config and a vitest run.
+   * @default process.cwd()
+   */
+  root?: string;
+}
+
+/**
+ * Every language a site is written in, read off disk into one catalog.
+ *
+ * For the build and for a site's own tests, never for the page: it reads the
+ * filesystem, and the translations it holds are tens of kilobytes a first
+ * visit must not pay for. Read one language out of it with `catalogTranslate`.
+ *
+ * A language whose file is absent is left out, which the catalog already reads
+ * as English — a half-translated site serves the pages it has rather than
+ * failing the build. A missing English file is a misconfiguration and throws:
+ * every key and every fallback is declared there.
+ * @param source - The page catalog's own `source`. See {@link LocaleCatalogSource}.
+ * @param options - See {@link LocaleCatalogOptions}.
+ * @returns The catalog, every language it carries already in memory.
+ */
+export function readLocaleCatalog<TKey extends string = string>(
+  source: LocaleCatalogSource,
+  options: LocaleCatalogOptions = {},
+): MessageCatalog<TKey> {
+  const { id, repository, directory } = source;
+  const folder = resolve(options.root ?? process.cwd(), directory);
+  const english = readMessages(folder, DEFAULT_LANGUAGE);
+  if (english === undefined) {
+    throw new Error(
+      `no ${DEFAULT_LANGUAGE}.json in ${folder}: a catalog declares its keys and its fallbacks there`,
+    );
+  }
+  const translations: Partial<Record<Language, Record<string, string>>> = {};
+  for (const language of LANGUAGES) {
+    if (language === DEFAULT_LANGUAGE) continue;
+    const messages = readMessages(folder, language);
+    if (messages !== undefined) translations[language] = messages;
+  }
+  return new MessageCatalog<TKey>({
+    id,
+    repository,
+    directory,
+    source: english,
+    translations,
+  });
+}
+
+/**
+ * One language's messages, read off disk.
+ * @param folder - The resolved directory holding the locale files.
+ * @param language - The language whose file to read.
+ * @returns Its messages, or `undefined` when the site does not carry it.
+ */
+function readMessages(
+  folder: string,
+  language: Language,
+): Record<string, string> | undefined {
+  let text: string;
+  try {
+    text = readFileSync(join(folder, `${language}.json`), 'utf8');
+  } catch {
+    return undefined;
+  }
+  return JSON.parse(text) as Record<string, string>;
+}

package/src/vite.ts

@@ -1,3 +1,4 @@
 export * from './build/vite/index.ts';
+export * from './i18n/vite/index.ts';
 export * from './seo/vite/index.ts';
 export * from './slides/vite/index.ts';