react-cheminfo 0.59.0 → 0.61.0

package/lib/server/staticSite.d.ts

@@ -0,0 +1,42 @@
+import type { FastifyInstance } from 'fastify';
+/** Options of {@link staticSite}. */
+export interface StaticSiteOptions {
+    /** The directory the build wrote, e.g. `dist`. */
+    root: string;
+    /**
+     * The analytics snippet, put at the end of the head of every page, as
+     * `TRACKING_SCRIPT` holds it.
+     * @default undefined - no snippet
+     */
+    trackingScript?: string;
+    /**
+     * Addresses the site does not have any more, and the one that does their
+     * work. The query is carried over, so a link handed out before the move
+     * keeps its configuration.
+     * @default {}
+     */
+    redirects?: Readonly<Record<string, string>>;
+    /**
+     * Address prefixes another plugin answers, such as the API, which never
+     * answer a page: an unknown address there is the API's own 404.
+     * @default ['/v1/']
+     */
+    reserved?: readonly string[];
+}
+/**
+ * Serve a site's build from Node, with the rules every static host of the
+ * family follows (static-web-server's `sws.toml`, Cloudflare Pages): a real
+ * file per address and no fallback page, `/titration` answered without a
+ * redirect, pages checked on every visit and hashed bundles kept for a year,
+ * the analytics snippet in every page, `404.html` for an address the site does
+ * not have, and `/health` for the deploy script.
+ *
+ * Register it next to the API; a build missing (a server started before the
+ * frontend was built) leaves the API alone:
+ *
+ *   await app.register(staticSite, { root: 'dist', trackingScript });
+ * @param fastify - The server.
+ * @param options - The build, the snippet and the retired addresses.
+ */
+export declare function staticSite(fastify: FastifyInstance, options: StaticSiteOptions): Promise<void>;
+//# sourceMappingURL=staticSite.d.ts.map

package/lib/server/staticSite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staticSite.d.ts","sourceRoot":"","sources":["../../src/server/staticSite.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EAIhB,MAAM,SAAS,CAAC;AAMjB,qCAAqC;AACrC,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAiBD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CA4Df"}

package/lib/server/staticSite.js

@@ -0,0 +1,114 @@
+import { readFile } from 'node:fs/promises';
+import { join, relative, resolve, sep } from 'node:path';
+import { injectTrackingScript } from "../seo/core/trackingScript.js";
+import { isHashedBundle, listSiteFiles, resolveAddress } from "./siteFiles.js";
+/** A page is checked on every visit: it names the bundles of its own build. */
+const PAGE_CACHE = 'no-cache';
+/** A bundle is named by its content, so it never changes under its name. */
+const BUNDLE_CACHE = 'public, max-age=31536000, immutable';
+/** Kept out of the API's documentation (`@fastify/swagger` reads `hide`). */
+const HIDDEN = { hide: true };
+/**
+ * Serve a site's build from Node, with the rules every static host of the
+ * family follows (static-web-server's `sws.toml`, Cloudflare Pages): a real
+ * file per address and no fallback page, `/titration` answered without a
+ * redirect, pages checked on every visit and hashed bundles kept for a year,
+ * the analytics snippet in every page, `404.html` for an address the site does
+ * not have, and `/health` for the deploy script.
+ *
+ * Register it next to the API; a build missing (a server started before the
+ * frontend was built) leaves the API alone:
+ *
+ *   await app.register(staticSite, { root: 'dist', trackingScript });
+ * @param fastify - The server.
+ * @param options - The build, the snippet and the retired addresses.
+ */
+export async function staticSite(fastify, options) {
+    const { trackingScript, redirects = {}, reserved = ['/v1/'] } = options;
+    const root = resolve(options.root);
+    fastify.get('/health', { logLevel: 'silent', schema: HIDDEN }, (_request, reply) => reply.send({ status: 'ok' }));
+    const files = await listSiteFiles(root);
+    if (files === undefined) {
+        fastify.log.warn({ root }, 'no built site: serving the API alone');
+        return;
+    }
+    const pages = await readPages(root, files, trackingScript);
+    // An optional peer, installed only by a site that has a server: importing
+    // react-cheminfo/server must not need it.
+    const { default: fastifyStatic } = await import('@fastify/static');
+    await fastify.register(fastifyStatic, {
+        root,
+        serve: false,
+        cacheControl: false,
+        setHeaders: (reply, path) => {
+            const file = relative(root, path).split(sep).join('/');
+            if (isHashedBundle(file)) {
+                reply.header('cache-control', BUNDLE_CACHE);
+                // A page framed by a sandboxed view may run under an opaque origin,
+                // and a module bundle is then fetched cross-origin.
+                reply.header('access-control-allow-origin', '*');
+            }
+            else {
+                reply.header('cache-control', PAGE_CACHE);
+            }
+        },
+    });
+    const answer = (request, reply) => {
+        const url = new URL(request.url, 'http://site');
+        const { pathname, search } = url;
+        if (reserved.some((prefix) => pathname.startsWith(prefix))) {
+            return reply.callNotFound();
+        }
+        const destination = redirects[pathname] ?? redirects[pathname.replace(/\/$/, '')];
+        if (destination !== undefined) {
+            return reply.redirect(`${destination}${search}`, 301);
+        }
+        const file = resolveAddress(files, pathname);
+        if (file === undefined) {
+            return sendPage(request, reply, pages.get('404.html'), 404);
+        }
+        const page = pages.get(file);
+        if (page)
+            return sendPage(request, reply, page, 200);
+        return reply.sendFile(file);
+    };
+    fastify.get('/', { schema: HIDDEN }, answer);
+    fastify.get('/*', { schema: HIDDEN }, answer);
+}
+/**
+ * Read every page of the build once, with the snippet in its head.
+ * @param root - The build.
+ * @param files - Its files.
+ * @param trackingScript - The snippet, if any.
+ * @returns The pages, by file.
+ */
+async function readPages(root, files, trackingScript) {
+    const htmlFiles = [...files].filter((file) => file.endsWith('.html'));
+    const pages = await Promise.all(htmlFiles.map(async (file) => {
+        const html = injectTrackingScript(await readFile(join(root, file), 'utf8'), trackingScript);
+        return [file, { html, etag: await etagOf(html) }];
+    }));
+    return new Map(pages);
+}
+function sendPage(request, reply, page, status) {
+    if (page === undefined) {
+        return reply
+            .code(status)
+            .type('text/plain; charset=utf-8')
+            .send('Not found');
+    }
+    reply.header('cache-control', PAGE_CACHE).header('etag', page.etag);
+    if (status === 200 && request.headers['if-none-match'] === page.etag) {
+        return reply.code(304).send();
+    }
+    return reply.code(status).type('text/html; charset=utf-8').send(page.html);
+}
+async function etagOf(text) {
+    const digest = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(text));
+    const bytes = new Uint8Array(digest).subarray(0, 12);
+    let hex = '';
+    for (const byte of bytes)
+        hex += byte.toString(16).padStart(2, '0');
+    return `"${hex}"`;
+}
+//# sourceMappingURL=staticSite.js.map

package/lib/server/staticSite.js.map

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

package/lib/server.d.ts

@@ -0,0 +1,4 @@
+export type { StaticSiteOptions } from './server/staticSite.ts';
+export { staticSite } from './server/staticSite.ts';
+export { isHashedBundle, listSiteFiles, resolveAddress, } from './server/siteFiles.ts';
+//# sourceMappingURL=server.d.ts.map

package/lib/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EACL,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAC"}

package/lib/server.js

@@ -0,0 +1,3 @@
+export { staticSite } from "./server/staticSite.js";
+export { isHashedBundle, listSiteFiles, resolveAddress, } from "./server/siteFiles.js";
+//# sourceMappingURL=server.js.map

package/lib/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EACL,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAC"}

package/lib/ui.d.ts

@@ -18,6 +18,7 @@ export * from './help/ui/index.ts';
 export * from './hooks/ui/index.ts';
 export * from './i18n/ui/index.ts';
 export * from './language/ui/index.ts';
+export * from './moleculesSources/ui/index.ts';
 export * from './moleculesToken/ui/index.ts';
 export * from './number/ui/index.ts';
 export * from './overlay/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,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,8BAA8B,CAAC;AAC7C,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,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,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

@@ -18,6 +18,7 @@ export * from "./help/ui/index.js";
 export * from "./hooks/ui/index.js";
 export * from "./i18n/ui/index.js";
 export * from "./language/ui/index.js";
+export * from "./moleculesSources/ui/index.js";
 export * from "./moleculesToken/ui/index.js";
 export * from "./number/ui/index.js";
 export * from "./overlay/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,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,8BAA8B,CAAC;AAC7C,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,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-cheminfo",
-  "version": "0.59.0",
+  "version": "0.61.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",
@@ -25,6 +25,7 @@
     "./molstar/*": "./lib/molstar/*/index.js",
     "./orbital": "./lib/orbital.js",
     "./pages": "./lib/pages.js",
+    "./server": "./lib/server.js",
     "./slides": "./lib/slides.js",
     "./spectra": "./lib/spectra.js",
     "./structure": "./lib/structure.js",
@@ -85,6 +86,7 @@
   },
   "devDependencies": {
     "@blueprintjs/core": "^6.18.0",
+    "@fastify/static": "^10.1.6",
     "@playwright/test": "^1.62.1",
     "@storybook/addon-docs": "^10.5.8",
     "@storybook/react-vite": "^10.5.8",
@@ -99,6 +101,7 @@
     "eslint": "^9.39.5",
     "eslint-config-cheminfo-react": "^20.1.0",
     "eslint-config-cheminfo-typescript": "^22.1.0",
+    "fastify": "^5.12.7",
     "jsdom": "^30.1.1",
     "ml-dataset-iris": "^1.2.1",
     "ml-pca": "^4.1.1",
@@ -119,6 +122,8 @@
   },
   "peerDependencies": {
     "@blueprintjs/core": "^6.18.0",
+    "@fastify/static": "^10.0.0",
+    "fastify": "^5.0.0",
     "ml-pca": "^4.1.1",
     "ml-signal-processing": "^2.2.2",
     "molstar": "^5.11.0",
@@ -139,6 +144,12 @@
   },
   "homepage": "https://github.com/cheminfo/react-cheminfo#readme",
   "peerDependenciesMeta": {
+    "@fastify/static": {
+      "optional": true
+    },
+    "fastify": {
+      "optional": true
+    },
     "ml-pca": {
       "optional": true
     },

package/src/about/ui/AboutBuildDetails.tsx

@@ -0,0 +1,45 @@
+import type { ReactElement } from 'react';
+
+import type { BuildInfo } from '../../build/core/buildInfo.ts';
+import { formatBuiltAt, shortCommit } from '../../build/core/buildInfo.ts';
+import { useChromeT } from '../../i18n/ui/useT.ts';
+
+/**
+ * What the badge of a release leaves to its hover: the commit it was built
+ * from, the instant to the second, and the chrome it was built against.
+ * @param props - The build and its released version.
+ * @param props.build - What the build published about itself.
+ * @param props.version - The release the badge names.
+ * @returns The card's contents.
+ */
+export function AboutBuildDetails(props: {
+  build: BuildInfo;
+  version: string;
+}): ReactElement {
+  const { build, version } = props;
+  const t = useChromeT();
+
+  return (
+    <>
+      <div className="build-tooltip__header">
+        {t('about.buildVersion', { version })}
+      </div>
+      <dl className="build-tooltip__rows">
+        <dt>{t('about.buildBuilt')}</dt>
+        <dd>{formatBuiltAt(build.builtAt)}</dd>
+        {build.commit === undefined ? null : (
+          <>
+            <dt>{t('about.buildCommit')}</dt>
+            <dd>{shortCommit(build.commit)}</dd>
+          </>
+        )}
+        {build.reactCheminfo === undefined ? null : (
+          <>
+            <dt>react-cheminfo</dt>
+            <dd>{build.reactCheminfo}</dd>
+          </>
+        )}
+      </dl>
+    </>
+  );
+}

package/src/about/ui/AboutPage.tsx

@@ -1,5 +1,6 @@
 import type { CSSProperties, ReactElement, ReactNode } from 'react';
 
+import { buildLabel } from '../../build/core/buildInfo.ts';
 import { CreditsList } from '../../credits/ui/CreditsList.tsx';
 import { Wordmark } from '../../ecosystem/ui/Wordmark.tsx';
 import { SiteMark } from '../../ecosystem/ui/marks.tsx';
@@ -7,10 +8,11 @@ import { useChromeT } from '../../i18n/ui/useT.ts';
 import type { AboutContent } from '../core/about.ts';
 import { resolveAbout } from '../core/about.ts';
 
-import { AboutBuild } from './AboutBuild.tsx';
 import { AboutCitations } from './AboutCitations.tsx';
 import { AboutProvidedBy } from './AboutProvidedBy.tsx';
 import { AboutSection } from './AboutSection.tsx';
+import type { AboutSignInProps } from './AboutSignIn.tsx';
+import { AboutSignIn } from './AboutSignIn.tsx';
 import { AboutVersion } from './AboutVersion.tsx';
 
 export interface AboutPageProps {
@@ -43,6 +45,13 @@ export interface AboutPageProps {
    * @default undefined
    */
   logo?: ReactNode;
+  /**
+   * Where the people who run the site sign in, drawn under the build badge in
+   * the corner of the hero. A site passes it while nobody is signed in, and
+   * leaves it out once somebody is: the account is then in the bar.
+   * @default undefined — the site has no account to sign in to
+   */
+  signIn?: AboutSignInProps;
 }
 
 /**
@@ -58,10 +67,12 @@ export interface AboutPageProps {
  * @throws {Error} When the record names a site or a credit that does not exist.
  */
 export function AboutPage(props: AboutPageProps): ReactElement {
-  const { content, className, children, logo, mark } = props;
+  const { content, className, children, logo, mark, signIn } = props;
   const t = useChromeT();
   const about = resolveAbout(content);
   const site = about.site;
+  const hasCorner =
+    buildLabel(about.build) !== undefined || signIn !== undefined;
 
   return (
     <div
@@ -83,7 +94,12 @@ export function AboutPage(props: AboutPageProps): ReactElement {
           </p>
           <p style={WHAT_STYLE}>{about.what}</p>
         </div>
-        <AboutVersion build={about.build} />
+        {hasCorner ? (
+          <div className="about-corner" style={CORNER_STYLE}>
+            <AboutVersion build={about.build} />
+            {signIn === undefined ? null : <AboutSignIn {...signIn} />}
+          </div>
+        ) : null}
       </header>
 
       {about.people.length === 0 && about.providedBy.length === 0 ? null : (
@@ -127,16 +143,6 @@ export function AboutPage(props: AboutPageProps): ReactElement {
           <AboutCitations works={about.cite} />
         </AboutSection>
       )}
-
-      {/*
-        The build the reader has open, last and under no heading: it is what a
-        report has to name, not something anybody came to the page to read.
-      */}
-      {about.build === undefined ? null : (
-        <AboutSection className="about-build">
-          <AboutBuild build={about.build} />
-        </AboutSection>
-      )}
     </div>
   );
 }
@@ -166,6 +172,14 @@ const HERO_STYLE = {
   lineHeight: 1.55,
 } as const satisfies CSSProperties;
 
+const CORNER_STYLE = {
+  display: 'flex',
+  flex: '0 0 auto',
+  flexDirection: 'column',
+  alignItems: 'flex-end',
+  gap: 2,
+} as const satisfies CSSProperties;
+
 const NAME_STYLE = {
   margin: 0,
   fontSize: 26,

package/src/about/ui/AboutSignIn.tsx

@@ -0,0 +1,63 @@
+import type { ReactElement } from 'react';
+
+import { isModifiedClick } from '../../chrome/ui/navItem.ts';
+import { useChromeT } from '../../i18n/ui/useT.ts';
+
+export interface AboutSignInProps {
+  /**
+   * The address signing in happens at. Writing it keeps the entry a real link,
+   * so a middle click opens a tab.
+   * @default undefined
+   */
+  href?: string;
+  /**
+   * What the site does when the entry is picked — route to that page, or open
+   * a credentials dialog for a site that has no page. A modified click is left
+   * to the browser.
+   * @default undefined
+   */
+  onSignIn?: () => void;
+  /**
+   * What the entry reads, for a site whose accounts are for one kind of person.
+   * @default the chrome's own word for it, in the language of the page
+   */
+  label?: string;
+}
+
+/**
+ * Where the people who run a site sign in: one quiet line under the build
+ * badge, in the corner of the About.
+ *
+ * A visitor has nothing to sign in to, so the bar carries no invitation; the
+ * About is the page the operators already know, and the corner is where they
+ * already look for the build they run.
+ * @param props - See {@link AboutSignInProps}.
+ * @returns The entry.
+ */
+export function AboutSignIn(props: AboutSignInProps): ReactElement {
+  const { href, onSignIn, label } = props;
+  const t = useChromeT();
+  const text = label ?? t('account.signIn');
+
+  if (href === undefined) {
+    return (
+      <button type="button" className="about-sign-in" onClick={onSignIn}>
+        {text}
+      </button>
+    );
+  }
+
+  return (
+    <a
+      className="about-sign-in"
+      href={href}
+      onClick={(event) => {
+        if (onSignIn === undefined || isModifiedClick(event)) return;
+        event.preventDefault();
+        onSignIn();
+      }}
+    >
+      {text}
+    </a>
+  );
+}

package/src/about/ui/AboutVersion.tsx

@@ -4,18 +4,22 @@
  * A report of something going wrong is worth answering only when we know what
  * was running, and that is the one thing an About page cannot say from a
  * hand-written record. It sits at the top of the page rather than at the
- * bottom because it is the one line a reader is asked to quote back.
+ * bottom because it is the one line a reader is asked to quote back, and it is
+ * said once: nothing further down the page repeats it.
  */
 
+import { Tooltip } from '@blueprintjs/core';
 import type { CSSProperties, ReactElement } from 'react';
 
 import type { BuildInfo } from '../../build/core/buildInfo.ts';
 import {
   buildLabel,
   buildStamp,
-  buildSummary,
+  releasedVersion,
 } from '../../build/core/buildInfo.ts';
 
+import { AboutBuildDetails } from './AboutBuildDetails.tsx';
+
 export interface AboutVersionProps {
   /** What the build published about itself, or `undefined` when it published none. */
   build: BuildInfo | undefined;
@@ -23,7 +27,8 @@ export interface AboutVersionProps {
 
 /**
  * The build badge: the release a site is serving, or the commit it was built
- * from while it has no release yet, and when it was made.
+ * from while it has no release yet, and when it was made. A release names its
+ * commit and the exact instant in the card its hover opens.
  * @param props - See {@link AboutVersionProps}.
  * @returns The badge, or `null` when the build says nothing worth showing.
  */
@@ -34,15 +39,28 @@ export function AboutVersion(props: AboutVersionProps): ReactElement | null {
   // The instant belongs on the badge rather than in its hover: a version
   // nobody can date says nothing about how old the page they read is.
   const badge = `${label} · ${buildStamp(build.builtAt)}`;
+  const version = releasedVersion(build);
+
+  if (version === undefined) {
+    return (
+      <span style={BADGE_STYLE} className="about-version">
+        {badge}
+      </span>
+    );
+  }
 
   return (
-    <span
-      style={BADGE_STYLE}
-      className="about-version"
-      title={buildSummary(build)}
+    <Tooltip
+      content={<AboutBuildDetails build={build} version={version} />}
+      // To the left, so the card never covers the way to sign in under it.
+      placement="left-start"
+      popoverClassName="help-tooltip build-tooltip"
+      hoverOpenDelay={150}
     >
-      {badge}
-    </span>
+      <span style={BADGE_STYLE} className="about-version" tabIndex={0}>
+        {badge}
+      </span>
+    </Tooltip>
   );
 }
 

package/src/about/ui/index.ts

@@ -1,5 +1,3 @@
-export type { AboutBuildProps } from './AboutBuild.tsx';
-export { AboutBuild } from './AboutBuild.tsx';
 export type { AboutVersionProps } from './AboutVersion.tsx';
 export { AboutVersion } from './AboutVersion.tsx';
 export type { AboutCitationsProps } from './AboutCitations.tsx';
@@ -10,3 +8,5 @@ export type { AboutProvidedByProps } from './AboutProvidedBy.tsx';
 export { AboutProvidedBy } from './AboutProvidedBy.tsx';
 export type { AboutSectionProps } from './AboutSection.tsx';
 export { AboutSection } from './AboutSection.tsx';
+export type { AboutSignInProps } from './AboutSignIn.tsx';
+export { AboutSignIn } from './AboutSignIn.tsx';

package/src/chrome/ui/NavEntry.tsx

@@ -0,0 +1,41 @@
+import type { ReactElement } from 'react';
+
+import { NavLink } from './NavLink.tsx';
+import { NavMenuButton } from './NavMenuButton.tsx';
+import type { NavItem } from './navItem.ts';
+
+/**
+ * One page of the bar: a link, or the menu it opens when the entry folds pages
+ * of its own. A menu stands where its pages would, among them and not among the
+ * utilities, because picking one of them changes what the page shows.
+ * @param props - The entry and the page on show.
+ * @param props.item - The entry.
+ * @param props.activeId - The page on show.
+ * @returns The entry.
+ */
+export function NavEntry(props: {
+  item: NavItem;
+  activeId: string | undefined;
+}): ReactElement {
+  const { item, activeId } = props;
+  if (item.items === undefined) {
+    return <NavLink item={item} active={item.id === activeId} />;
+  }
+
+  return (
+    <NavMenuButton
+      label={menuLabel(item)}
+      icon={typeof item.icon === 'string' ? item.icon : undefined}
+      items={item.items}
+      activeId={activeId}
+      placement="bottom-start"
+    />
+  );
+}
+
+// The trigger names itself to a screen reader, so an entry drawn as a glyph
+// alone says what it opens through its title rather than through its id.
+function menuLabel(item: NavItem): string {
+  if (typeof item.label === 'string') return item.label;
+  return item.title ?? item.id;
+}