react-cheminfo 0.4.1 → 0.6.0

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-cheminfo",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "license": "MIT",
   "description": "Assembled React components shared by the cheminfo sites: a Cite button and an ecosystem menu",
   "author": "Luc Patiny",

package/src/ecosystem/core/sites.ts

@@ -5,6 +5,7 @@ export type SiteId =
   | 'smiles'
   | 'chemcalc'
   | 'nmrium'
+  | 'derepflow'
   | 'surge'
   | 'tex'
   | 'lcao'
@@ -119,6 +120,16 @@ export const ECOSYSTEM_SITES: readonly EcosystemSite[] = [
     brandAlt: '#2b143e',
     mark: { plate: '#2b143e', accent: '#ea580c' },
   },
+  {
+    id: 'derepflow',
+    name: { lead: 'Derep', alt: 'Flow' },
+    host: 'derepflow.cheminfo.org',
+    repository: 'https://github.com/cheminfo/derepflow',
+    tagline: 'Identify the constituents of a mixture from its ¹³C spectrum.',
+    brand: '#be185d',
+    brandAlt: '#0f766e',
+    mark: { plate: '#be185d', accent: '#0d9488' },
+  },
   {
     id: 'surge',
     name: { lead: 'surge', alt: 'cheminfo', dot: true },

package/src/ecosystem/ui/glyphs.tsx

@@ -74,6 +74,25 @@ export const GLYPHS: Record<SiteId, (alt: string) => ReactNode> = {
       <path d="M23 24V18" stroke="#ffffff" />
     </g>
   ),
+  // Three peaks of a mixture over the funnel that narrows them to one compound,
+  // which is the dereplication this one does.
+  derepflow: (alt) => (
+    <>
+      <g stroke="#ffffff" strokeWidth="4" strokeLinecap="round" fill="none">
+        <path d="M7 15.6V9.4" />
+        <path d="M16 15.6V4.6" />
+        <path d="M25 15.6v-4.6" />
+      </g>
+      <path
+        d="M6.2 20.4 16 27 25.8 20.4"
+        stroke={alt}
+        strokeWidth="4"
+        strokeLinecap="round"
+        strokeLinejoin="round"
+        fill="none"
+      />
+    </>
+  ),
   // The official NMRium symbol, from `Logo.tsx` of the NMRium sources: the
   // orange half is theirs, and the half their logo sets in plum is set in white
   // here because the plate already is that plum.

package/src/orbital/ui/AtomicOrbitalCanvas.tsx

@@ -15,6 +15,7 @@ import { PHASE_PALETTES } from '../core/palette.ts';
 import type { AtomicSampler } from '../core/sample.ts';
 import { sampleInProcess } from '../core/sample.ts';
 
+import { DEFAULT_SPIN_SPEED } from './camera.ts';
 import type { OrbitalViewer } from './viewer.ts';
 import { createOrbitalViewer } from './viewer.ts';
 
@@ -44,6 +45,11 @@ export interface AtomicOrbitalCanvasProps {
    * @default false
    */
   spinning?: boolean;
+  /**
+   * How fast it turns, in molstar's own spin unit. Lower is slower.
+   * @default 0.3
+   */
+  spinSpeed?: number;
   /**
    * How the field is produced. Supply a worker-backed sampler to keep the main
    * thread free; the default runs in process.
@@ -77,6 +83,7 @@ export function AtomicOrbitalCanvas(
     palette = PHASE_PALETTES.textbook,
     resolution = DEFAULT_RESOLUTION,
     spinning = false,
+    spinSpeed = DEFAULT_SPIN_SPEED,
     sample = sampleInProcess,
     onNodeRadii,
     onError,
@@ -144,8 +151,8 @@ export function AtomicOrbitalCanvas(
   }, [atomicNumber, orbitalId, resolution, palette, sample, wanted]);
 
   useEffect(() => {
-    void viewerRef.current?.setSpin(spinning);
-  }, [spinning]);
+    void viewerRef.current?.setSpin(spinning, spinSpeed);
+  }, [spinning, spinSpeed]);
 
   return (
     <div ref={containerRef} style={CANVAS_STYLE}>