react-cheminfo 0.53.0 → 0.55.0

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/locales/de.json

@@ -3,6 +3,8 @@
     "chrome.pages": "Seiten",
     "chrome.about": "Über",
     "chrome.aboutTitle": "Was diese Seite ist, worauf sie aufbaut und wie man sie zitiert",
+    "chrome.contact": "Kontakt",
+    "chrome.contactTitle": "Eine Frage, ein Problem, eine Idee? Schreiben Sie uns",
     "account.signIn": "Anmelden",
     "account.signOut": "Abmelden",
     "account.signedInAs": "Angemeldet als {name}",

package/lib/locales/en.json

@@ -3,6 +3,8 @@
     "chrome.pages": "Pages",
     "chrome.about": "About",
     "chrome.aboutTitle": "What this site is, what it is built on, and how to cite it",
+    "chrome.contact": "Contact",
+    "chrome.contactTitle": "A question, a problem or an idea? Write to us",
     "account.signIn": "Sign in",
     "account.signOut": "Sign out",
     "account.signedInAs": "Signed in as {name}",

package/lib/locales/es.json

@@ -3,6 +3,8 @@
     "chrome.pages": "Páginas",
     "chrome.about": "Acerca de",
     "chrome.aboutTitle": "Qué es este sitio, en qué se basa y cómo citarlo",
+    "chrome.contact": "Contacto",
+    "chrome.contactTitle": "¿Una pregunta, un problema, una idea? Escríbanos",
     "account.signIn": "Iniciar sesión",
     "account.signOut": "Cerrar sesión",
     "account.signedInAs": "Sesión iniciada como {name}",

package/lib/locales/fr.json

@@ -3,6 +3,8 @@
     "chrome.pages": "Pages",
     "chrome.about": "À propos",
     "chrome.aboutTitle": "Ce qu'est ce site, sur quoi il est bâti et comment le citer",
+    "chrome.contact": "Contact",
+    "chrome.contactTitle": "Une question, un problème, une idée ? Écrivez-nous",
     "account.signIn": "Se connecter",
     "account.signOut": "Se déconnecter",
     "account.signedInAs": "Connecté comme {name}",

package/lib/locales/it.json

@@ -3,6 +3,8 @@
     "chrome.pages": "Pagine",
     "chrome.about": "Informazioni",
     "chrome.aboutTitle": "Cosa è questo sito, su cosa si basa e come citarlo",
+    "chrome.contact": "Contatto",
+    "chrome.contactTitle": "Una domanda, un problema, un'idea? Scriveteci",
     "account.signIn": "Accedi",
     "account.signOut": "Esci",
     "account.signedInAs": "Accesso effettuato come {name}",

package/lib/ui.d.ts

@@ -4,6 +4,7 @@ export * from './capsule/ui/index.ts';
 export * from './chart/ui/index.ts';
 export * from './chrome/ui/index.ts';
 export * from './citation/ui/index.ts';
+export * from './contact/ui/index.ts';
 export * from './clipboard/ui/index.ts';
 export * from './color/ui/index.ts';
 export * from './confirm/ui/index.ts';

package/lib/ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AAKvC,YAAY,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,eAAe,GAChB,MAAM,oCAAoC,CAAC"}
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AAKvC,YAAY,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,eAAe,GAChB,MAAM,oCAAoC,CAAC"}

package/lib/ui.js

@@ -4,6 +4,7 @@ export * from "./capsule/ui/index.js";
 export * from "./chart/ui/index.js";
 export * from "./chrome/ui/index.js";
 export * from "./citation/ui/index.js";
+export * from "./contact/ui/index.js";
 export * from "./clipboard/ui/index.js";
 export * from "./color/ui/index.js";
 export * from "./confirm/ui/index.js";

package/lib/ui.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AAMvC,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAmC,CAAC;AAEnE,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,eAAe,GAChB,MAAM,oCAAoC,CAAC"}
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AAMvC,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAmC,CAAC;AAEnE,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,eAAe,GAChB,MAAM,oCAAoC,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.55.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/chrome/ui/SiteHeader.tsx

@@ -1,10 +1,13 @@
 import type { ReactElement, ReactNode } from 'react';
 import { Fragment } from 'react';
 
+import { contactFormUrl } from '../../contact/core/contactUrl.ts';
+import { ContactButton } from '../../contact/ui/ContactButton.tsx';
 import { siteById } from '../../ecosystem/core/lookup.ts';
 import type { SiteId, SiteRecord } from '../../ecosystem/core/sites.ts';
 import { Wordmark } from '../../ecosystem/ui/Wordmark.tsx';
 import { SiteMark } from '../../ecosystem/ui/marks.tsx';
+import { useLanguage } from '../../i18n/ui/useLanguage.ts';
 import { useChromeT } from '../../i18n/ui/useT.ts';
 
 import { NavLink } from './NavLink.tsx';
@@ -39,12 +42,28 @@ export interface SiteHeaderProps {
    */
   activeId?: string;
   /**
-   * The utilities pushed to the right edge — Cite, Tools, Share, sign in. They
+   * The utilities pushed to the right edge — About, Cite, Tools, the language,
+   * sign in; Share has a prop of its own, so it always comes last. They
    * arrive dressed as bar items, so a plain `nav-link` and a `CiteButton` read
    * alike beside each other.
    * @default undefined
    */
   actions?: ReactNode;
+  /**
+   * The Share entry, which closes the utilities on every site, after the
+   * Contact entry. A site passes its own when it wraps the shared `ShareButton`
+   * in a dialog of its own.
+   * @default undefined
+   */
+  share?: ReactNode;
+  /**
+   * The contact form the Contact entry opens, drawn after the site's utilities
+   * and just before Share, with
+   * `{site}` and `{page}` where the site and the page are written; `false`
+   * leaves the entry out. No entry is drawn while there is no form.
+   * @default the family's form in the language of the page (`CONTACT_FORM_URLS`)
+   */
+  contact?: string | false;
   /**
    * Draws one page the site's own way, for a bar whose entries need a tooltip
    * or a wrapper of their own.
@@ -113,6 +132,8 @@ export function SiteHeader(props: SiteHeaderProps): ReactElement | null {
     nav,
     activeId,
     actions,
+    share,
+    contact,
     renderNavItem,
     embedded = false,
     homeHref = '/',
@@ -122,6 +143,7 @@ export function SiteHeader(props: SiteHeaderProps): ReactElement | null {
     pagesLabel,
   } = props;
   const t = useChromeT();
+  const language = useLanguage();
 
   if (embedded) return null;
 
@@ -129,6 +151,8 @@ export function SiteHeader(props: SiteHeaderProps): ReactElement | null {
   if (site === undefined) {
     throw new Error('SiteHeader needs one of its `site` and `siteId` props');
   }
+  const contactForm =
+    contact === false ? '' : (contact ?? contactFormUrl(language));
 
   return (
     <header className="app-header no-print">
@@ -169,8 +193,16 @@ export function SiteHeader(props: SiteHeaderProps): ReactElement | null {
           </div>
         ) : null}
         <span className="spacer" />
-        {actions === undefined ? null : (
-          <div className="app-header-actions">{actions}</div>
+        {actions === undefined &&
+        share === undefined &&
+        contactForm === '' ? null : (
+          <div className="app-header-actions">
+            {actions}
+            {contactForm === '' ? null : (
+              <ContactButton siteId={site.id} formUrl={contactForm} />
+            )}
+            {share}
+          </div>
         )}
       </div>
     </header>

package/src/contact/core/contactUrl.ts

@@ -0,0 +1,53 @@
+import type { Language } from '../../i18n/core/languages.ts';
+
+/**
+ * Address of the contact form every site of the family opens, one per language the form
+ * is written in, with `{site}` and `{page}` where the site and the page are written. A
+ * language without a form of its own opens the English one; with no form at all, no
+ * Contact entry is drawn.
+ */
+export const CONTACT_FORM_URLS: Readonly<Partial<Record<Language, string>>> = {
+  en: 'https://docs.google.com/forms/d/e/1FAIpQLSd_1G3tUOEJh_qapmLn_xrybWa9Nu7B57bpYm76o4nwPKPWsg/viewform?usp=pp_url&entry.569380734={site}&entry.2103045774={page}',
+};
+
+/** What a contact address is filled with. */
+export interface ContactUrlOptions {
+  /** The site the message is about, written as its id. */
+  site: string;
+  /**
+   * The address of the page the reader was on.
+   * @default ''
+   */
+  page?: string;
+}
+
+/**
+ * The contact form in the language of the page, or the English one when the form is not
+ * written in that language.
+ * @param language - The language of the page.
+ * @param urls - The forms, by language.
+ * @returns The address of the form, or an empty string when there is none.
+ */
+export function contactFormUrl(
+  language: Language,
+  urls: Readonly<Partial<Record<Language, string>>> = CONTACT_FORM_URLS,
+): string {
+  return urls[language] ?? urls.en ?? '';
+}
+
+/**
+ * Fill the address of a contact form with the site and the page, both encoded, so the
+ * form opens knowing what the message is about.
+ * @param template - Address holding `{site}` and `{page}`.
+ * @param options - The site and the page.
+ * @returns The address to open.
+ */
+export function contactUrl(
+  template: string,
+  options: ContactUrlOptions,
+): string {
+  const { site, page = '' } = options;
+  return template
+    .replaceAll('{site}', encodeURIComponent(site))
+    .replaceAll('{page}', encodeURIComponent(page));
+}

package/src/contact/core/index.ts

@@ -0,0 +1,2 @@
+export type { ContactUrlOptions } from './contactUrl.ts';
+export { CONTACT_FORM_URLS, contactFormUrl, contactUrl } from './contactUrl.ts';