react-cheminfo 0.4.1 → 0.7.0

package/lib/seo/core/startDocumentMeta.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Keep the tab and the canonical link in step with the page on screen.
+ *
+ * The server, or the build that wrote one file per address, already titled the
+ * page it handed out; this is what a move inside the app changes, and what a
+ * crawler that renders the page reads afterwards. Every site did the same three
+ * things around it — read the address it is on, look it up in its route table,
+ * write the head — so all three live here, and a site says only where its
+ * address is read and how a change to it is noticed.
+ */
+import type { PageMetaOptions } from './pageMeta.ts';
+/** Where a site's address is read, and how a change to it is noticed. */
+export interface StartDocumentMetaOptions extends Omit<PageMetaOptions, 'url' | 'image'> {
+    /**
+     * The address on screen, query string included: a path, or the absolute
+     * address read off the page. It is read again on every write, so a `follow`
+     * that tracks what it reads — a signals `effect` — notices the next page.
+     */
+    url: () => string;
+    /**
+     * How a change of page is noticed: `effect` from `@preact/signals-react`
+     * follows whichever signals `url` reads and hands back the function that
+     * stops it. Left out, the head is written once, which is what a site calling
+     * this from its own `popstate` handler wants.
+     * @default undefined — the head is written once
+     */
+    follow?: (write: () => void) => () => void;
+}
+/**
+ * Write the head of the page on screen, and keep it in step as the page
+ * changes.
+ *
+ * Nothing happens where there is no document — a prerender script, a unit test
+ * of the route table — so this is safe to call from a module either of them
+ * imports.
+ * @param options - The site, its routes, where its address is read and how a
+ * change to it is noticed.
+ * @returns The function that stops following, which does nothing when nothing
+ * was followed.
+ * @throws {Error} When the site answers no route, or names an origin that is
+ * not an absolute address.
+ */
+export declare function startDocumentMeta(options: StartDocumentMetaOptions): () => void;
+//# sourceMappingURL=startDocumentMeta.d.ts.map

package/lib/seo/core/startDocumentMeta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startDocumentMeta.d.ts","sourceRoot":"","sources":["../../../src/seo/core/startDocumentMeta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD,yEAAyE;AACzE,MAAM,WAAW,wBAAyB,SAAQ,IAAI,CACpD,eAAe,EACf,KAAK,GAAG,OAAO,CAChB;IACC;;;;OAIG;IACH,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CAC5C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,MAAM,IAAI,CAeZ"}

package/lib/seo/core/startDocumentMeta.js

@@ -0,0 +1,47 @@
+/**
+ * Keep the tab and the canonical link in step with the page on screen.
+ *
+ * The server, or the build that wrote one file per address, already titled the
+ * page it handed out; this is what a move inside the app changes, and what a
+ * crawler that renders the page reads afterwards. Every site did the same three
+ * things around it — read the address it is on, look it up in its route table,
+ * write the head — so all three live here, and a site says only where its
+ * address is read and how a change to it is noticed.
+ */
+import { writeDocumentMeta } from "./documentMeta.js";
+import { pageDocumentMeta } from "./pageMeta.js";
+/**
+ * Write the head of the page on screen, and keep it in step as the page
+ * changes.
+ *
+ * Nothing happens where there is no document — a prerender script, a unit test
+ * of the route table — so this is safe to call from a module either of them
+ * imports.
+ * @param options - The site, its routes, where its address is read and how a
+ * change to it is noticed.
+ * @returns The function that stops following, which does nothing when nothing
+ * was followed.
+ * @throws {Error} When the site answers no route, or names an origin that is
+ * not an absolute address.
+ */
+export function startDocumentMeta(options) {
+    if (typeof document === 'undefined')
+        return stopNothing;
+    const write = () => {
+        writeDocumentMeta(pageDocumentMeta({
+            site: options.site,
+            routes: options.routes,
+            url: options.url(),
+            origin: options.origin,
+        }));
+    };
+    return (options.follow ?? writeOnce)(write);
+}
+function writeOnce(write) {
+    write();
+    return stopNothing;
+}
+function stopNothing() {
+    // Nothing was followed, so there is nothing to stop.
+}
+//# sourceMappingURL=startDocumentMeta.js.map

package/lib/seo/core/startDocumentMeta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startDocumentMeta.js","sourceRoot":"","sources":["../../../src/seo/core/startDocumentMeta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAuBjD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAiC;IAEjC,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,WAAW,CAAC;IAExD,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,iBAAiB,CACf,gBAAgB,CAAC;YACf,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CACH,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,SAAS,CAAC,KAAiB;IAClC,KAAK,EAAE,CAAC;IACR,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,WAAW;IAClB,qDAAqD;AACvD,CAAC"}

package/lib/seo/core/structuredData.d.ts

@@ -0,0 +1,48 @@
+/**
+ * One `application/ld+json` block describing the tool.
+ *
+ * It is the same on every page of a site — what varies per page is the head —
+ * so it is written into the built page once rather than per route.
+ */
+import type { SiteFilesOptions } from './siteFiles.ts';
+/** What the structured-data block says the tool is. */
+export interface StructuredDataOptions extends SiteFilesOptions {
+    /**
+     * The schema.org application category.
+     * @default 'EducationalApplication'
+     */
+    category?: string;
+    /**
+     * What the tool needs to run.
+     * @default 'Any modern browser'
+     */
+    operatingSystem?: string;
+    /**
+     * What the tool does, in the words a search result is read in. A site whose
+     * indexed sentence says more than the line its tile in the family menu
+     * carries writes it here.
+     * @default the site's tagline
+     */
+    description?: string;
+    /**
+     * What a browser has to offer for the tool to run. Ours run in the page.
+     * @default 'Requires JavaScript'
+     */
+    browserRequirements?: string;
+    /**
+     * The currency the price is quoted in. The price is zero either way, but the
+     * pair has to agree with the audience the site is read by.
+     * @default 'EUR'
+     */
+    currency?: string;
+}
+/**
+ * The structured-data block, ready to put in the head.
+ *
+ * It always says the tool is free: the price is zero, and a block that leaves
+ * that implicit is one a rich result declines to show.
+ * @param options - The site, and what kind of application it is.
+ * @returns The script tag.
+ */
+export declare function structuredDataScript(options: StructuredDataOptions): string;
+//# sourceMappingURL=structuredData.d.ts.map

package/lib/seo/core/structuredData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structuredData.d.ts","sourceRoot":"","sources":["../../../src/seo/core/structuredData.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAMvD,uDAAuD;AACvD,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAwB3E"}

package/lib/seo/core/structuredData.js

@@ -0,0 +1,41 @@
+/**
+ * One `application/ld+json` block describing the tool.
+ *
+ * It is the same on every page of a site — what varies per page is the head —
+ * so it is written into the built page once rather than per route.
+ */
+import { siteDisplayName } from "../../ecosystem/core/lookup.js";
+import { originOf, resolveSite } from "./siteFiles.js";
+/** The sequence that must not appear raw inside a script element. */
+const SCRIPT_SAFE_LESS_THAN = String.raw `\u003c`;
+/**
+ * The structured-data block, ready to put in the head.
+ *
+ * It always says the tool is free: the price is zero, and a block that leaves
+ * that implicit is one a rich result declines to show.
+ * @param options - The site, and what kind of application it is.
+ * @returns The script tag.
+ */
+export function structuredDataScript(options) {
+    const site = resolveSite(options.site);
+    const data = {
+        '@context': 'https://schema.org',
+        '@type': 'WebApplication',
+        name: siteDisplayName(site),
+        url: `${originOf(options)}/`,
+        description: options.description ?? site.tagline,
+        applicationCategory: options.category ?? 'EducationalApplication',
+        operatingSystem: options.operatingSystem ?? 'Any modern browser',
+        browserRequirements: options.browserRequirements ?? 'Requires JavaScript',
+        offers: {
+            '@type': 'Offer',
+            price: '0',
+            priceCurrency: options.currency ?? 'EUR',
+        },
+        isAccessibleForFree: true,
+        publisher: { '@type': 'Organization', name: 'cheminfo' },
+    };
+    const json = JSON.stringify(data, null, 2).replaceAll('<', SCRIPT_SAFE_LESS_THAN);
+    return `<script type="application/ld+json">\n${json}\n</script>`;
+}
+//# sourceMappingURL=structuredData.js.map

package/lib/seo/core/structuredData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structuredData.js","sourceRoot":"","sources":["../../../src/seo/core/structuredData.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEvD,qEAAqE;AACrE,MAAM,qBAAqB,GAAG,MAAM,CAAC,GAAG,CAAA,QAAQ,CAAC;AAkCjD;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA8B;IACjE,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG;QACX,UAAU,EAAE,oBAAoB;QAChC,OAAO,EAAE,gBAAgB;QACzB,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;QAC3B,GAAG,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG;QAC5B,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO;QAChD,mBAAmB,EAAE,OAAO,CAAC,QAAQ,IAAI,wBAAwB;QACjE,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,oBAAoB;QAChE,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,IAAI,qBAAqB;QACzE,MAAM,EAAE;YACN,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,GAAG;YACV,aAAa,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;SACzC;QACD,mBAAmB,EAAE,IAAI;QACzB,SAAS,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,EAAE;KACzD,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,CACnD,GAAG,EACH,qBAAqB,CACtB,CAAC;IACF,OAAO,wCAAwC,IAAI,aAAa,CAAC;AACnE,CAAC"}

package/lib/seo/core/template.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Where a built page lets its head and its body be written.
+ *
+ * Every address of a site needs its own title, description, canonical and card,
+ * and a static build ships one `index.html`. Rather than look for the tags a
+ * page already carries and operate on them, the template says where they go:
+ * two comments, replaced by what the build or the server writes for the address
+ * being answered.
+ *
+ * ```html
+ * <head>
+ *   <meta charset="utf-8" />
+ *   <link rel="icon" href="%BASE_URL%favicon.svg" />
+ *   <!--cheminfo:head-->
+ * </head>
+ * <body>
+ *   <div id="root"></div>
+ *   <!--cheminfo:body-->
+ * </body>
+ * ```
+ *
+ * The template carries no title and no description of its own, so nothing can
+ * be duplicated and nothing has to be taken back out. Nothing is parsed and
+ * nothing is searched for but the marker, so what the rest of the page holds — a
+ * byte order mark, an implicit head, a `</head>` its prose displays or a script
+ * quotes, an unterminated comment — cannot reach the result.
+ */
+/** Where the head a crawler reads is written. */
+export declare const PAGE_HEAD_MARKER = "<!--cheminfo:head-->";
+/** Where the crawl path a visitor with no JavaScript reads is written. */
+export declare const PAGE_BODY_MARKER = "<!--cheminfo:body-->";
+/**
+ * Write content in the place the template kept for it.
+ *
+ * The marker is consumed, so a page is always filled from the template and
+ * never from a filled page: applying this twice throws rather than writing a
+ * second head, which is why idempotence is not something the caller has to
+ * defend.
+ * @param html - The template.
+ * @param marker - {@link PAGE_HEAD_MARKER} or {@link PAGE_BODY_MARKER}.
+ * @param content - The markup to write, taken as written: no `$&`, `$1` or
+ * `$<name>` is expanded.
+ * @returns The page.
+ * @throws {Error} When the template carries no such marker, rather than
+ * silently shipping a page with no head.
+ */
+export declare function fill(html: string, marker: string, content: string): string;
+//# sourceMappingURL=template.d.ts.map

package/lib/seo/core/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../src/seo/core/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,iDAAiD;AACjD,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AAEvD,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AAEvD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAI1E"}

package/lib/seo/core/template.js

@@ -0,0 +1,53 @@
+/**
+ * Where a built page lets its head and its body be written.
+ *
+ * Every address of a site needs its own title, description, canonical and card,
+ * and a static build ships one `index.html`. Rather than look for the tags a
+ * page already carries and operate on them, the template says where they go:
+ * two comments, replaced by what the build or the server writes for the address
+ * being answered.
+ *
+ * ```html
+ * <head>
+ *   <meta charset="utf-8" />
+ *   <link rel="icon" href="%BASE_URL%favicon.svg" />
+ *   <!--cheminfo:head-->
+ * </head>
+ * <body>
+ *   <div id="root"></div>
+ *   <!--cheminfo:body-->
+ * </body>
+ * ```
+ *
+ * The template carries no title and no description of its own, so nothing can
+ * be duplicated and nothing has to be taken back out. Nothing is parsed and
+ * nothing is searched for but the marker, so what the rest of the page holds — a
+ * byte order mark, an implicit head, a `</head>` its prose displays or a script
+ * quotes, an unterminated comment — cannot reach the result.
+ */
+/** Where the head a crawler reads is written. */
+export const PAGE_HEAD_MARKER = '<!--cheminfo:head-->';
+/** Where the crawl path a visitor with no JavaScript reads is written. */
+export const PAGE_BODY_MARKER = '<!--cheminfo:body-->';
+/**
+ * Write content in the place the template kept for it.
+ *
+ * The marker is consumed, so a page is always filled from the template and
+ * never from a filled page: applying this twice throws rather than writing a
+ * second head, which is why idempotence is not something the caller has to
+ * defend.
+ * @param html - The template.
+ * @param marker - {@link PAGE_HEAD_MARKER} or {@link PAGE_BODY_MARKER}.
+ * @param content - The markup to write, taken as written: no `$&`, `$1` or
+ * `$<name>` is expanded.
+ * @returns The page.
+ * @throws {Error} When the template carries no such marker, rather than
+ * silently shipping a page with no head.
+ */
+export function fill(html, marker, content) {
+    const at = html.indexOf(marker);
+    if (at === -1)
+        throw new Error(`the page carries no ${marker}`);
+    return html.slice(0, at) + content + html.slice(at + marker.length);
+}
+//# sourceMappingURL=template.js.map

package/lib/seo/core/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../src/seo/core/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,iDAAiD;AACjD,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEvD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEvD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,MAAc,EAAE,OAAe;IAChE,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,KAAK,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,MAAM,EAAE,CAAC,CAAC;IAChE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;AACtE,CAAC"}

package/lib/seo/vite/ogCard.d.ts

@@ -4,6 +4,10 @@
  * The card is the site's own mark, its two colours and its name, all read from
  * its record — so it is generated rather than hand-drawn. A mark redrawn in the
  * card is a mark that drifts from the one the site shows.
+ *
+ * React is reached for only when a card is actually drawn, and never at module
+ * load: this module sits in the same entry point as the prerender plugin, which
+ * a site must be able to import with none of the optional peers installed.
  */
 import type { EcosystemSite, SiteId } from '../../ecosystem/core/sites.ts';
 /** The width every card is drawn at. */
@@ -26,8 +30,12 @@ export interface OgCardOptions {
  * Screenshot it at {@link OG_WIDTH} × {@link OG_HEIGHT} — a headless browser is
  * the only thing here that can rasterise it, and every site already has one for
  * its end-to-end tests.
+ *
+ * Drawing the mark is the one thing here that needs React, so React is loaded
+ * on the call rather than by the module. The card is drawn by a build script
+ * that already awaits a browser, so the await costs it nothing.
  * @param options - Which site, and what it says.
  * @returns A complete HTML document.
  */
-export declare function ogCardHtml(options: OgCardOptions): string;
+export declare function ogCardHtml(options: OgCardOptions): Promise<string>;
 //# sourceMappingURL=ogCard.d.ts.map

package/lib/seo/vite/ogCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ogCard.d.ts","sourceRoot":"","sources":["../../../src/seo/vite/ogCard.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAI3E,wCAAwC;AACxC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAE7B,yCAAyC;AACzC,eAAO,MAAM,SAAS,MAAM,CAAC;AAE7B,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC;IAC7B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAiDzD"}
+{"version":3,"file":"ogCard.d.ts","sourceRoot":"","sources":["../../../src/seo/vite/ogCard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAG3E,wCAAwC;AACxC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAE7B,yCAAyC;AACzC,eAAO,MAAM,SAAS,MAAM,CAAC;AAE7B,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC;IAC7B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAuDxE"}

package/lib/seo/vite/ogCard.js

@@ -4,11 +4,12 @@
  * The card is the site's own mark, its two colours and its name, all read from
  * its record — so it is generated rather than hand-drawn. A mark redrawn in the
  * card is a mark that drifts from the one the site shows.
+ *
+ * React is reached for only when a card is actually drawn, and never at module
+ * load: this module sits in the same entry point as the prerender plugin, which
+ * a site must be able to import with none of the optional peers installed.
  */
-import { createElement } from 'react';
-import { renderToStaticMarkup } from 'react-dom/server';
 import { siteById } from "../../ecosystem/core/lookup.js";
-import { SiteMark } from "../../ecosystem/ui/marks.js";
 import { escapeText } from "../../share/core/escape.js";
 /** The width every card is drawn at. */
 export const OG_WIDTH = 1200;
@@ -20,12 +21,21 @@ export const OG_HEIGHT = 630;
  * Screenshot it at {@link OG_WIDTH} × {@link OG_HEIGHT} — a headless browser is
  * the only thing here that can rasterise it, and every site already has one for
  * its end-to-end tests.
+ *
+ * Drawing the mark is the one thing here that needs React, so React is loaded
+ * on the call rather than by the module. The card is drawn by a build script
+ * that already awaits a browser, so the await costs it nothing.
  * @param options - Which site, and what it says.
  * @returns A complete HTML document.
  */
-export function ogCardHtml(options) {
+export async function ogCardHtml(options) {
     const site = typeof options.site === 'string' ? siteById(options.site) : options.site;
     const description = options.description ?? site.tagline;
+    const [{ createElement }, { renderToStaticMarkup }, { SiteMark }] = await Promise.all([
+        import('react'),
+        import('react-dom/server'),
+        import("../../ecosystem/ui/marks.js"),
+    ]);
     const mark = renderToStaticMarkup(createElement(SiteMark, { site, size: 132, colors: 'literal' }));
     const dot = site.name.dot === true ? '<span class="dot">.</span>' : '';
     return `<!doctype html>

package/lib/seo/vite/ogCard.js.map

@@ -1 +1 @@
-{"version":3,"file":"ogCard.js","sourceRoot":"","sources":["../../../src/seo/vite/ogCard.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE1D,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA8B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,wCAAwC;AACxC,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC;AAE7B,yCAAyC;AACzC,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAa7B;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,OAAsB;IAC/C,MAAM,IAAI,GACR,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3E,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,CAAC;IACxD,MAAM,IAAI,GAAG,oBAAoB,CAC/B,aAAa,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAChE,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvE,OAAO;;;;;;;;iBAQQ,QAAQ;kBACP,SAAS;;;;;;;;;;;uBAWJ,IAAI,CAAC,KAAK;sBACX,IAAI,CAAC,QAAQ;;;;;;;sBAOb,IAAI,CAAC,QAAQ;;;;;MAK7B,IAAI;6BACmB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,qBAAqB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;;SAEzG,UAAU,CAAC,WAAW,CAAC;;;CAG/B,CAAC;AACF,CAAC"}
+{"version":3,"file":"ogCard.js","sourceRoot":"","sources":["../../../src/seo/vite/ogCard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,wCAAwC;AACxC,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC;AAE7B,yCAAyC;AACzC,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAa7B;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAsB;IACrD,MAAM,IAAI,GACR,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3E,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,CAAC;IACxD,MAAM,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,oBAAoB,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,GAC/D,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,MAAM,CAAC,OAAO,CAAC;QACf,MAAM,CAAC,kBAAkB,CAAC;QAC1B,MAAM,CAAC,6BAA8B,CAAC;KACvC,CAAC,CAAC;IACL,MAAM,IAAI,GAAG,oBAAoB,CAC/B,aAAa,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAChE,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvE,OAAO;;;;;;;;iBAQQ,QAAQ;kBACP,SAAS;;;;;;;;;;;uBAWJ,IAAI,CAAC,KAAK;sBACX,IAAI,CAAC,QAAQ;;;;;;;sBAOb,IAAI,CAAC,QAAQ;;;;;MAK7B,IAAI;6BACmB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,qBAAqB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;;SAEzG,UAAU,CAAC,WAAW,CAAC;;;CAG/B,CAAC;AACF,CAAC"}

package/lib/seo/vite/prerender.d.ts

@@ -6,6 +6,11 @@
  * crawler gets whatever came off the wire. Without this every address carries
  * the same title and a search engine folds the whole site into one result.
  *
+ * The build's `index.html` is the template: it declares where its head and its
+ * crawl path go with `<!--cheminfo:head-->` and `<!--cheminfo:body-->`, and
+ * every file written here is filled from it. The dev server is filled the same
+ * way, from the home route, so what a developer opens is what the build ships.
+ *
  * These files are also what makes the server's catch-all fallback unnecessary.
  * Every address the tool answers is on disk, so an address that is *not* on
  * disk is genuinely not a page and must 404 rather than serving the tool under
@@ -13,6 +18,8 @@
  */
 import type { Plugin } from 'vite';
 import type { EcosystemSite, SiteId } from '../../ecosystem/core/sites.ts';
+import type { NoscriptText } from '../core/noscript.ts';
+import type { RobotsDisallow } from '../core/robots.ts';
 import type { RouteMeta } from '../core/routes.ts';
 /** What the build needs to know to write the site's addresses. */
 export interface PrerenderOptions {
@@ -21,16 +28,20 @@ export interface PrerenderOptions {
     /** Every address it answers, each with its title and description. */
     routes: readonly RouteMeta[];
     /**
-     * Origin every absolute address is built on.
+     * Where the site is served, mount path included. Every absolute address is
+     * built on it, and `robots.txt` and the `noscript` index write their paths
+     * under its mount. The files on disk are laid out from the build's own root
+     * either way: it is the server that puts them under the mount.
      * @default `https://<the site's host>`
      */
     origin?: string;
     /**
-     * Address prefixes `robots.txt` keeps out of the index, e.g. `/v1/`. Set to
-     * `false` to write no `robots.txt` at all, for a site that ships its own.
+     * Addresses `robots.txt` keeps out of the index, e.g. `/v1/`, each optionally
+     * with the sentence saying why. Set to `false` to write no `robots.txt` at
+     * all, for a site that ships its own.
      * @default []
      */
-    robots?: false | readonly string[];
+    robots?: false | ReadonlyArray<string | RobotsDisallow>;
     /**
      * The schema.org category of the structured-data block, or `false` to write
      * none.
@@ -43,16 +54,36 @@ export interface PrerenderOptions {
      */
     operatingSystem?: string;
     /**
-     * Whether the built page carries a `noscript` index of the addresses. It is
-     * the only crawl path through a site whose body is an empty root element.
+     * What the tool does, in the structured-data block.
+     * @default the site's tagline
+     */
+    description?: string;
+    /**
+     * What a browser has to offer for the tool to run.
+     * @default 'Requires JavaScript'
+     */
+    browserRequirements?: string;
+    /**
+     * The currency the zero price is quoted in.
+     * @default 'EUR'
+     */
+    currency?: string;
+    /**
+     * Whether the built page carries a `noscript` index of the addresses, what it
+     * says, which pages it lists and how it writes their addresses. It is the
+     * only crawl path through a site whose body is an empty root element, so
+     * `false` leaves one without any — and is also what lets a template ship no
+     * `<!--cheminfo:body-->` at all.
      * @default true
      */
-    noscript?: boolean;
+    noscript?: boolean | NoscriptText;
 }
 /**
  * Prerender every routed address of a cheminfo site.
  * @param options - The site, its routes, and what a crawler is told.
  * @returns The Vite plugin.
+ * @throws {Error} When the route table names an address twice or names one that
+ * is not a path, or when the origin is not an absolute address.
  */
 export declare function cheminfoPrerender(options: PrerenderOptions): Plugin;
 //# sourceMappingURL=prerender.d.ts.map

package/lib/seo/vite/prerender.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prerender.d.ts","sourceRoot":"","sources":["../../../src/seo/vite/prerender.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,MAAM,CAAC;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAE3E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAQnD,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC;IAC7B,qEAAqE;IACrE,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,SAAS,MAAM,EAAE,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC1B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CA+EnE"}
+{"version":3,"file":"prerender.d.ts","sourceRoot":"","sources":["../../../src/seo/vite/prerender.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,MAAM,CAAC;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAMnD,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC;IAC7B,qEAAqE;IACrE,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,aAAa,CAAC,MAAM,GAAG,cAAc,CAAC,CAAC;IACxD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC1B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CA6EnE"}

package/lib/seo/vite/prerender.js

@@ -6,6 +6,11 @@
  * crawler gets whatever came off the wire. Without this every address carries
  * the same title and a search engine folds the whole site into one result.
  *
+ * The build's `index.html` is the template: it declares where its head and its
+ * crawl path go with `<!--cheminfo:head-->` and `<!--cheminfo:body-->`, and
+ * every file written here is filled from it. The dev server is filled the same
+ * way, from the home route, so what a developer opens is what the build ships.
+ *
  * These files are also what makes the server's catch-all fallback unnecessary.
  * Every address the tool answers is on disk, so an address that is *not* on
  * disk is genuinely not a page and must 404 rather than serving the tool under
@@ -13,52 +18,67 @@
  */
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
-import { injectPageMeta, insertBeforeHeadEnd } from "../core/pageMeta.js";
-import { noscriptIndex, robotsTxt, sitemapXml, structuredDataScript, } from "../core/siteFiles.js";
+import { noscriptIndex } from "../core/noscript.js";
+import { pageHeadTags } from "../core/pageMeta.js";
+import { robotsTxt } from "../core/robots.js";
+import { assertRoutes, homeRoute, trimTrailingSlash } from "../core/routes.js";
+import { sitemapXml } from "../core/siteFiles.js";
+import { structuredDataScript } from "../core/structuredData.js";
+import { PAGE_BODY_MARKER, PAGE_HEAD_MARKER, fill } from "../core/template.js";
 /**
  * Prerender every routed address of a cheminfo site.
  * @param options - The site, its routes, and what a crawler is told.
  * @returns The Vite plugin.
+ * @throws {Error} When the route table names an address twice or names one that
+ * is not a path, or when the origin is not an absolute address.
  */
 export function cheminfoPrerender(options) {
-    const { site, routes, origin, robots = [], category, operatingSystem, noscript = true, } = options;
+    const { site, routes, origin, robots = [] } = options;
+    assertRoutes(routes);
+    const structuredData = structuredDataOf(options);
+    const crawlPath = crawlPathOf(options);
     let out = 'dist';
+    let serve = false;
     let logger = null;
+    const page = (template, url) => {
+        const head = fill(template, PAGE_HEAD_MARKER, `${pageHeadTags({ site, routes, origin, url })}${structuredData}`);
+        return crawlPath === '' ? head : fill(head, PAGE_BODY_MARKER, crawlPath);
+    };
     return {
         name: 'cheminfo:prerender',
-        apply: 'build',
         configResolved(config) {
+            serve = config.command === 'serve';
             out = resolve(config.root, config.build.outDir);
             logger = config.logger;
         },
+        // A dev run has no build to prerender, so the page vite serves is filled
+        // from the home route rather than shipped with its markers showing.
         transformIndexHtml: {
             order: 'post',
-            handler(html) {
-                let page = html;
-                if (category !== false) {
-                    page = insertBeforeHeadEnd(page, structuredDataScript({
-                        site,
-                        routes,
-                        origin,
-                        category,
-                        operatingSystem,
-                    }));
-                }
-                if (noscript) {
-                    page = insertBeforeBodyEnd(page, noscriptIndex({ site, routes, origin }));
-                }
-                return page;
-            },
+            handler: (html) => serve ? page(html, homeRoute(routes).path) : html,
         },
         closeBundle() {
-            const index = readFileSync(join(out, 'index.html'), 'utf8');
+            if (serve)
+                return;
+            const template = readFileSync(join(out, 'index.html'), 'utf8');
+            const write = (url, file) => {
+                mkdirSync(dirname(file), { recursive: true });
+                writeFileSync(file, page(template, url));
+            };
+            let root = false;
             for (const route of routes) {
-                const file = route.path === '/'
+                const address = trimTrailingSlash(route.path);
+                if (address === '/')
+                    root = true;
+                write(route.path, address === '/'
                     ? join(out, 'index.html')
-                    : join(out, route.path.slice(1), 'index.html');
-                mkdirSync(dirname(file), { recursive: true });
-                writeFileSync(file, injectPageMeta(index, { site, routes, origin, url: route.path }));
+                    : join(out, address.slice(1), 'index.html'));
             }
+            // The file a static server hands out for the mount itself. A table naming
+            // no root would otherwise leave the template vite built, and ship a site
+            // whose front page carries its markers instead of a head.
+            if (!root)
+                write(homeRoute(routes).path, join(out, 'index.html'));
             writeFileSync(join(out, 'sitemap.xml'), sitemapXml({ site, routes, origin }));
             if (robots !== false) {
                 writeFileSync(join(out, 'robots.txt'), robotsTxt({ site, routes, origin }, robots));
@@ -67,10 +87,28 @@ export function cheminfoPrerender(options) {
         },
     };
 }
-function insertBeforeBodyEnd(html, addition) {
-    const body = html.lastIndexOf('</body>');
-    if (body === -1)
-        return `${html}\n${addition}\n`;
-    return `${html.slice(0, body)}${addition}\n${html.slice(body)}`;
+function structuredDataOf(options) {
+    const { category, ...rest } = options;
+    if (category === false)
+        return '';
+    const { site, routes, origin } = rest;
+    const { operatingSystem, description, browserRequirements, currency } = rest;
+    return `\n${structuredDataScript({
+        site,
+        routes,
+        origin,
+        category,
+        operatingSystem,
+        description,
+        browserRequirements,
+        currency,
+    })}`;
+}
+function crawlPathOf(options) {
+    const { site, routes, origin, noscript = true } = options;
+    if (noscript === false)
+        return '';
+    const { routes: listed, ...prose } = noscript === true ? {} : noscript;
+    return noscriptIndex({ site, origin, ...prose, routes: listed ?? routes });
 }
 //# sourceMappingURL=prerender.js.map