react-cheminfo 0.52.0 → 0.54.0

package/lib/share/ui/ShareLinkBar.js

@@ -17,17 +17,17 @@ import { useChromeT } from "../../i18n/ui/useT.js";
  * @returns The bar.
  */
 export function ShareLinkBar(props) {
-    const { url, frame, onCopied } = props;
+    const { url, frame, onCopied, disabled = false } = props;
     const t = useChromeT();
     return (_jsxs("div", { className: "share-linkbar", children: [_jsx(HelpTooltip, { content: {
                     title: t('share.copyLinkHelpTitle'),
                     body: t('share.copyLinkHelp'),
-                }, children: _jsx(CopyButton, { content: url, label: t('share.copyLink'), title: "", onCopied: onCopied }) }), _jsx(HelpTooltip, { content: {
+                }, children: _jsx(CopyButton, { content: url, label: t('share.copyLink'), title: "", disabled: disabled, onCopied: onCopied }) }), _jsx(HelpTooltip, { content: {
                     title: t('share.openInNewTabHelpTitle'),
                     body: t('share.openInNewTabHelp'),
-                }, children: _jsx(AnchorButton, { icon: "share", text: t('share.openInNewTab'), href: url, target: "_blank", rel: "noopener noreferrer" }) }), _jsx(HelpTooltip, { content: {
+                }, children: _jsx(AnchorButton, { icon: "share", text: t('share.openInNewTab'), href: url, disabled: disabled, target: "_blank", rel: "noopener noreferrer" }) }), _jsx(HelpTooltip, { content: {
                     title: t('share.copyIframeHelpTitle'),
                     body: t('share.copyIframeHelp'),
-                }, children: _jsx(CopyButton, { content: frame, icon: "code", label: t('share.copyIframe'), title: "", onCopied: onCopied }) })] }));
+                }, children: _jsx(CopyButton, { content: frame, icon: "code", label: t('share.copyIframe'), title: "", disabled: disabled, onCopied: onCopied }) })] }));
 }
 //# sourceMappingURL=ShareLinkBar.js.map

package/lib/share/ui/ShareLinkBar.js.map

@@ -1 +1 @@
-{"version":3,"file":"ShareLinkBar.js","sourceRoot":"","sources":["../../../src/share/ui/ShareLinkBar.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAcnD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IACvC,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;IAEvB,OAAO,CACL,eAAK,SAAS,EAAC,eAAe,aAC5B,KAAC,WAAW,IACV,OAAO,EAAE;oBACP,KAAK,EAAE,CAAC,CAAC,yBAAyB,CAAC;oBACnC,IAAI,EAAE,CAAC,CAAC,oBAAoB,CAAC;iBAC9B,YAED,KAAC,UAAU,IACT,OAAO,EAAE,GAAG,EACZ,KAAK,EAAE,CAAC,CAAC,gBAAgB,CAAC,EAC1B,KAAK,EAAC,EAAE,EACR,QAAQ,EAAE,QAAQ,GAClB,GACU,EACd,KAAC,WAAW,IACV,OAAO,EAAE;oBACP,KAAK,EAAE,CAAC,CAAC,6BAA6B,CAAC;oBACvC,IAAI,EAAE,CAAC,CAAC,wBAAwB,CAAC;iBAClC,YAED,KAAC,YAAY,IACX,IAAI,EAAC,OAAO,EACZ,IAAI,EAAE,CAAC,CAAC,oBAAoB,CAAC,EAC7B,IAAI,EAAE,GAAG,EACT,MAAM,EAAC,QAAQ,EACf,GAAG,EAAC,qBAAqB,GACzB,GACU,EACd,KAAC,WAAW,IACV,OAAO,EAAE;oBACP,KAAK,EAAE,CAAC,CAAC,2BAA2B,CAAC;oBACrC,IAAI,EAAE,CAAC,CAAC,sBAAsB,CAAC;iBAChC,YAED,KAAC,UAAU,IACT,OAAO,EAAE,KAAK,EACd,IAAI,EAAC,MAAM,EACX,KAAK,EAAE,CAAC,CAAC,kBAAkB,CAAC,EAC5B,KAAK,EAAC,EAAE,EACR,QAAQ,EAAE,QAAQ,GAClB,GACU,IACV,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ShareLinkBar.js","sourceRoot":"","sources":["../../../src/share/ui/ShareLinkBar.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAmBnD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC;IACzD,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;IAEvB,OAAO,CACL,eAAK,SAAS,EAAC,eAAe,aAC5B,KAAC,WAAW,IACV,OAAO,EAAE;oBACP,KAAK,EAAE,CAAC,CAAC,yBAAyB,CAAC;oBACnC,IAAI,EAAE,CAAC,CAAC,oBAAoB,CAAC;iBAC9B,YAED,KAAC,UAAU,IACT,OAAO,EAAE,GAAG,EACZ,KAAK,EAAE,CAAC,CAAC,gBAAgB,CAAC,EAC1B,KAAK,EAAC,EAAE,EACR,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,GAClB,GACU,EACd,KAAC,WAAW,IACV,OAAO,EAAE;oBACP,KAAK,EAAE,CAAC,CAAC,6BAA6B,CAAC;oBACvC,IAAI,EAAE,CAAC,CAAC,wBAAwB,CAAC;iBAClC,YAED,KAAC,YAAY,IACX,IAAI,EAAC,OAAO,EACZ,IAAI,EAAE,CAAC,CAAC,oBAAoB,CAAC,EAC7B,IAAI,EAAE,GAAG,EACT,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAC,QAAQ,EACf,GAAG,EAAC,qBAAqB,GACzB,GACU,EACd,KAAC,WAAW,IACV,OAAO,EAAE;oBACP,KAAK,EAAE,CAAC,CAAC,2BAA2B,CAAC;oBACrC,IAAI,EAAE,CAAC,CAAC,sBAAsB,CAAC;iBAChC,YAED,KAAC,UAAU,IACT,OAAO,EAAE,KAAK,EACd,IAAI,EAAC,MAAM,EACX,KAAK,EAAE,CAAC,CAAC,kBAAkB,CAAC,EAC5B,KAAK,EAAC,EAAE,EACR,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,GAClB,GACU,IACV,CACP,CAAC;AACJ,CAAC"}

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

@@ -3,6 +3,8 @@ export { HiddenPartsProvider } from './HiddenPartsProvider.tsx';
 export { useIsHidden } from './hiddenParts.ts';
 export type { PagePartProps } from './PagePart.tsx';
 export { PagePart } from './PagePart.tsx';
+export type { SealedLinkRefusedProps } from './SealedLinkRefused.tsx';
+export { SealedLinkRefused } from './SealedLinkRefused.tsx';
 export type { ShareButtonProps, ShareButtonVariant } from './ShareButton.tsx';
 export { ShareButton } from './ShareButton.tsx';
 export type { ShareDialogProps } from './ShareDialog.tsx';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/share/ui/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/share/ui/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/share/ui/index.js

@@ -1,6 +1,7 @@
 export { HiddenPartsProvider } from "./HiddenPartsProvider.js";
 export { useIsHidden } from "./hiddenParts.js";
 export { PagePart } from "./PagePart.js";
+export { SealedLinkRefused } from "./SealedLinkRefused.js";
 export { ShareButton } from "./ShareButton.js";
 export { ShareDialog } from "./ShareDialog.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/share/ui/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA2B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAgB,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAmB,CAAC;AAGhD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/share/ui/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA2B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAgB,CAAC;AAE1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAyB,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAmB,CAAC;AAGhD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAmB,CAAC"}

package/lib/share/ui/useSealedUrl.d.ts

@@ -0,0 +1,17 @@
+/** The link the dialog hands out, and whether it may be handed out yet. */
+export interface SealedUrl {
+    /** The link: sealed when asked and ready, else the share link itself. */
+    link: string;
+    /** False while the link is being sealed, when only the plain one exists. */
+    ready: boolean;
+}
+/**
+ * The link the dialog hands out: the share link itself, or its sealed form.
+ * Sealing is asynchronous, so a sealed link is not ready at once, and a link
+ * sealed for an older draft is never answered for the current one.
+ * @param url - The share link.
+ * @param sealed - Whether to hand out its sealed form.
+ * @returns The link, and whether it is ready.
+ */
+export declare function useSealedUrl(url: string, sealed: boolean): SealedUrl;
+//# sourceMappingURL=useSealedUrl.d.ts.map

package/lib/share/ui/useSealedUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSealedUrl.d.ts","sourceRoot":"","sources":["../../../src/share/ui/useSealedUrl.ts"],"names":[],"mappings":"AAIA,2EAA2E;AAC3E,MAAM,WAAW,SAAS;IACxB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,CAmBpE"}

package/lib/share/ui/useSealedUrl.js

@@ -0,0 +1,31 @@
+import { useEffect, useState } from 'react';
+import { sealShareUrl } from "../core/index.js";
+/**
+ * The link the dialog hands out: the share link itself, or its sealed form.
+ * Sealing is asynchronous, so a sealed link is not ready at once, and a link
+ * sealed for an older draft is never answered for the current one.
+ * @param url - The share link.
+ * @param sealed - Whether to hand out its sealed form.
+ * @returns The link, and whether it is ready.
+ */
+export function useSealedUrl(url, sealed) {
+    const [result, setResult] = useState(null);
+    useEffect(() => {
+        if (!sealed)
+            return;
+        let current = true;
+        void sealShareUrl(url).then((to) => {
+            if (current)
+                setResult({ from: url, to });
+        });
+        return () => {
+            current = false;
+        };
+    }, [url, sealed]);
+    if (!sealed)
+        return { link: url, ready: true };
+    if (result?.from === url)
+        return { link: result.to, ready: true };
+    return { link: url, ready: false };
+}
+//# sourceMappingURL=useSealedUrl.js.map

package/lib/share/ui/useSealedUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSealedUrl.js","sourceRoot":"","sources":["../../../src/share/ui/useSealedUrl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAUhD;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,MAAe;IACvD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAClC,IAAI,CACL,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,KAAK,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE;YACjC,IAAI,OAAO;gBAAE,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACV,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IAElB,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC/C,IAAI,MAAM,EAAE,IAAI,KAAK,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAClE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACrC,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.52.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/language/ui/siteLanguageContext.ts

@@ -1,5 +1,6 @@
 import { createContext, use } from 'react';
 
+import { pageLocation } from '../../router/core/pageAddress.ts';
 import { readLanguageParam } from '../core/languageParam.ts';
 
 /** What a site declares the page is being read in. */
@@ -16,5 +17,5 @@ export const SiteLanguageContext = createContext<string | undefined>(undefined);
 export function useSiteLanguage(): string | undefined {
   const declared = use(SiteLanguageContext);
   if (declared !== undefined) return declared;
-  return readLanguageParam(globalThis.location?.search ?? '');
+  return readLanguageParam(pageLocation()?.search ?? '');
 }

package/src/locales/de.json

@@ -54,6 +54,8 @@
   "share.layout": "Darstellung",
   "share.embed": "In eine andere Seite einbetten",
   "share.embedHint": "Lässt Kopfzeile und Navigation der Website weg, damit die Seite in einer Seite von Ihnen sitzt.",
+  "share.protect": "Diesen Link schützen",
+  "share.protectHint": "Die Klasse kann weder lesen noch ändern, was der Link einstellt, und die Adresse der Seite bleibt fest. Die Seite wird eingebettet.",
   "share.on": "Ein",
   "share.off": "Aus",
   "share.showOnPage": "Auf der Seite zeigen",
@@ -76,6 +78,9 @@
   "share.copyIframe": "Iframe kopieren",
   "share.copyIframeHelpTitle": "Die Seite in Ihre einbauen",
   "share.copyIframeHelp": "Ein HTML-Schnipsel, das dort eingefügt wird, wo das HTML Ihrer Seite bearbeitet wird: das Werkzeug läuft dann darin.",
+  "seal.refusedTitle": "Dieser Link lässt sich nicht öffnen",
+  "seal.refusedBody": "Er wurde nach dem Erstellen verändert oder ist unvollständig, daher wurde nichts geöffnet. Bitten Sie erneut um den Link.",
+  "seal.openWithout": "Das Werkzeug ohne den Link öffnen",
   "cite.button": "Zitieren",
   "cite.copyReferenceAs": "Literaturangabe kopieren als",
   "cite.pleaseCiteBoth": "Bitte zitieren Sie beide Arbeiten",

package/src/locales/en.json

@@ -54,6 +54,8 @@
   "share.layout": "Layout",
   "share.embed": "Embed in another page",
   "share.embedHint": "Drops the site header and its navigation, so the page sits inside a page of your own.",
+  "share.protect": "Protect this link",
+  "share.protectHint": "The class can neither read nor change what the link sets up, and the page's address stays fixed. The page is embedded.",
   "share.on": "On",
   "share.off": "Off",
   "share.showOnPage": "Show on the page",
@@ -76,6 +78,9 @@
   "share.copyIframe": "Copy the iframe",
   "share.copyIframeHelpTitle": "Put the page inside yours",
   "share.copyIframeHelp": "A snippet of HTML to paste where your own page's HTML is edited: the tool then runs inside it.",
+  "seal.refusedTitle": "This link cannot be opened",
+  "seal.refusedBody": "It was changed after it was made, or it is incomplete, so nothing was opened. Ask for the link again.",
+  "seal.openWithout": "Open the tool without it",
   "cite.button": "Cite",
   "cite.copyReferenceAs": "Copy the reference as",
   "cite.pleaseCiteBoth": "Please cite both works",

package/src/locales/es.json

@@ -54,6 +54,8 @@
   "share.layout": "Disposición",
   "share.embed": "Incrustar en otra página",
   "share.embedHint": "Quita la cabecera del sitio y su navegación, para que la página quede dentro de una página suya.",
+  "share.protect": "Proteger este enlace",
+  "share.protectHint": "La clase no puede leer ni cambiar lo que configura el enlace, y la dirección de la página queda fija. La página se integra.",
   "share.on": "Sí",
   "share.off": "No",
   "share.showOnPage": "Mostrar en la página",
@@ -76,6 +78,9 @@
   "share.copyIframe": "Copiar el iframe",
   "share.copyIframeHelpTitle": "Poner la página dentro de la tuya",
   "share.copyIframeHelp": "Un fragmento de HTML para pegar donde se edita el HTML de tu página: la herramienta funciona dentro de él.",
+  "seal.refusedTitle": "Este enlace no se puede abrir",
+  "seal.refusedBody": "Se modificó después de crearse, o está incompleto, así que no se abrió nada. Pide el enlace de nuevo.",
+  "seal.openWithout": "Abrir la herramienta sin el enlace",
   "cite.button": "Citar",
   "cite.copyReferenceAs": "Copiar la referencia como",
   "cite.pleaseCiteBoth": "Por favor, cite ambos trabajos",

package/src/locales/fr.json

@@ -54,6 +54,8 @@
   "share.layout": "Disposition",
   "share.embed": "Intégrer dans une autre page",
   "share.embedHint": "Retire l'en-tête du site et sa navigation, pour que la page prenne place dans une page à vous.",
+  "share.protect": "Protéger ce lien",
+  "share.protectHint": "La classe ne peut ni lire ni modifier ce que le lien règle, et l'adresse de la page reste fixe. La page est intégrée.",
   "share.on": "Oui",
   "share.off": "Non",
   "share.showOnPage": "Afficher sur la page",
@@ -76,6 +78,9 @@
   "share.copyIframe": "Copier l'iframe",
   "share.copyIframeHelpTitle": "Mettre la page dans la vôtre",
   "share.copyIframeHelp": "Un extrait de HTML à coller là où le HTML de votre page s'édite : l'outil s'exécute alors à l'intérieur.",
+  "seal.refusedTitle": "Ce lien ne peut pas être ouvert",
+  "seal.refusedBody": "Il a été modifié après sa création, ou il est incomplet : rien n'a été ouvert. Demandez à nouveau le lien.",
+  "seal.openWithout": "Ouvrir l'outil sans ce lien",
   "cite.button": "Citer",
   "cite.copyReferenceAs": "Copier la référence en",
   "cite.pleaseCiteBoth": "Merci de citer les deux travaux",

package/src/locales/it.json

@@ -54,6 +54,8 @@
   "share.layout": "Disposizione",
   "share.embed": "Incorporare in un'altra pagina",
   "share.embedHint": "Toglie l'intestazione del sito e la sua navigazione, così la pagina sta dentro una pagina propria.",
+  "share.protect": "Proteggi questo link",
+  "share.protectHint": "La classe non può né leggere né modificare ciò che il link imposta, e l'indirizzo della pagina resta fisso. La pagina viene incorporata.",
   "share.on": "Sì",
   "share.off": "No",
   "share.showOnPage": "Mostra nella pagina",
@@ -76,6 +78,9 @@
   "share.copyIframe": "Copia l'iframe",
   "share.copyIframeHelpTitle": "Mettere la pagina dentro la tua",
   "share.copyIframeHelp": "Un frammento di HTML da incollare dove si modifica l'HTML della tua pagina: lo strumento funziona al suo interno.",
+  "seal.refusedTitle": "Questo link non può essere aperto",
+  "seal.refusedBody": "È stato modificato dopo la creazione, o è incompleto, quindi non si è aperto nulla. Chiedi di nuovo il link.",
+  "seal.openWithout": "Apri lo strumento senza il link",
   "cite.button": "Cita",
   "cite.copyReferenceAs": "Copia il riferimento come",
   "cite.pleaseCiteBoth": "Si prega di citare entrambi i lavori",

package/src/router/core/history.ts

@@ -2,13 +2,15 @@
  * The tab router bound to the browser: read the address on screen, write a new
  * one through the History API, and hear every move.
  *
- * The router itself stays pure. Everything here reads `globalThis.location` and
- * writes `globalThis.history`, and does nothing where neither exists, so a
- * prerender script can import a module that uses it.
+ * The router itself stays pure. Everything here reads and writes the address
+ * through `pageLocation` and `pageHistory` — the browser's, or the one a sealed
+ * link holds in memory — and does nothing where neither exists, so a prerender
+ * script can import a module that uses it.
  */
 
 import { EMBED_PARAM, HIDE_PARAM } from '../../share/core/config.ts';
 
+import { pageHistory, pageLocation } from './pageAddress.ts';
 import type { QueryEntry } from './query.ts';
 import { formatQueryEntries } from './query.ts';
 import type { TabRoute, TabRouteInput, TabRouter } from './tabRouter.ts';
@@ -34,7 +36,7 @@ export function readRoute<Tab extends string>(
   const address = currentAddress();
   const adopted = router.legacyAddress(address);
   if (adopted === null) return router.parse(address);
-  const history = browserHistory();
+  const history = pageHistory();
   history?.replaceState(history.state, '', adopted);
   globalThis.dispatchEvent?.(new Event(ROUTE_CHANGE_EVENT));
   return router.parse(adopted);
@@ -78,8 +80,8 @@ export function writeRoute<Tab extends string>(
 ): string {
   const current = currentAddress();
   const address = withKeptParams(router, route, current, options.keep ?? []);
-  const location = browserLocation();
-  const history = browserHistory();
+  const location = pageLocation();
+  const history = pageHistory();
   if (location === undefined || history === undefined) return address;
 
   const shown =
@@ -126,7 +128,7 @@ export function subscribeToRoute<Tab extends string>(
  * @returns It, or `/` where there is no browser.
  */
 export function currentAddress(): string {
-  const location = browserLocation();
+  const location = pageLocation();
   if (location === undefined) return '/';
   return `${location.pathname}${location.search}${location.hash}`;
 }
@@ -150,11 +152,3 @@ function withKeptParams<Tab extends string>(
   const separator = target.includes('?') ? '&' : '?';
   return `${target}${separator}${formatQueryEntries(kept)}`;
 }
-
-function browserLocation(): Location | undefined {
-  return globalThis.location;
-}
-
-function browserHistory(): History | undefined {
-  return globalThis.history;
-}

package/src/router/core/index.ts

@@ -18,6 +18,14 @@ export type {
   LegacyHashOptions,
 } from './legacyHash.ts';
 export { adoptLegacyHashAddress, pathFromLegacyHash } from './legacyHash.ts';
+export type { PageHistory, PageLocation } from './pageAddress.ts';
+export {
+  holdPageAddress,
+  isPageAddressHeld,
+  pageHistory,
+  pageLocation,
+  releasePageAddress,
+} from './pageAddress.ts';
 export type { QueryEntry, QueryStringOptions } from './query.ts';
 export {
   firstQueryValues,