react-cheminfo 0.19.0 → 0.21.0

package/src/about/ui/AboutVersion.tsx

@@ -1,41 +1,51 @@
 /**
- * Which release of a site a visitor has open, in the corner of its hero.
+ * Which build of a site a visitor has open, in the corner of its hero.
  *
  * A report of something going wrong is worth answering only when we know what
- * was running, and the version 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
+ * 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.
  */
 
 import type { CSSProperties, ReactElement } from 'react';
 
 import type { BuildInfo } from '../../build/core/buildInfo.ts';
-import { releasedVersion } from '../../build/core/buildInfo.ts';
+import {
+  buildLabel,
+  buildStamp,
+  buildSummary,
+  releasedVersion,
+} from '../../build/core/buildInfo.ts';
 import { githubSources } from '../core/repository.ts';
 
 export interface AboutVersionProps {
   /** What the build published about itself, or `undefined` when it published none. */
   build: BuildInfo | undefined;
-  /** Where the sources live, which is what the version links into. */
+  /** Where the sources live, which is what the badge links into. */
   repository: string;
   /** Whether a visitor can open that repository, and so whether it is linked. */
   publicRepository: boolean;
 }
 
 /**
- * The version badge, or nothing when there is no version worth showing.
+ * 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.
  * @param props - See {@link AboutVersionProps}.
- * @returns The badge, or `null`.
+ * @returns The badge, or `null` when the build says nothing worth showing.
  */
 export function AboutVersion(props: AboutVersionProps): ReactElement | null {
   const { build, repository, publicRepository } = props;
-  const version = releasedVersion(build);
-  if (version === undefined) return null;
-  const sources = publicRepository ? githubSources(repository) : undefined;
-  if (sources === undefined) {
+  const label = buildLabel(build);
+  if (build === undefined || label === undefined) return null;
+  const href = publicRepository ? addressOf(build, repository) : undefined;
+  const summary = buildSummary(build);
+  // 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)}`;
+  if (href === undefined) {
     return (
-      <span style={BADGE_STYLE} className="about-version">
-        {version}
+      <span style={BADGE_STYLE} className="about-version" title={summary}>
+        {badge}
       </span>
     );
   }
@@ -43,16 +53,34 @@ export function AboutVersion(props: AboutVersionProps): ReactElement | null {
   return (
     <a
       className="about-version"
-      href={`${sources}/releases/tag/v${version}`}
+      href={href}
+      title={summary}
       target="_blank"
       rel="noopener noreferrer"
       style={LINK_BADGE_STYLE}
     >
-      {version}
+      {badge}
     </a>
   );
 }
 
+/**
+ * What the badge opens: the release it names, or the commit it was built from.
+ * @param build - What the build published about itself.
+ * @param repository - Where the sources live.
+ * @returns The address, or `undefined` when nothing inside the repository can
+ * be addressed.
+ */
+function addressOf(build: BuildInfo, repository: string): string | undefined {
+  const sources = githubSources(repository);
+  if (sources === undefined) return undefined;
+  const version = releasedVersion(build);
+  if (version !== undefined) return `${sources}/releases/tag/v${version}`;
+  return build.commit === undefined
+    ? undefined
+    : `${sources}/commit/${build.commit}`;
+}
+
 const BADGE_STYLE = {
   flex: '0 0 auto',
   fontFamily: 'var(--font-mono, ui-monospace, monospace)',

package/src/build/core/buildInfo.ts

@@ -49,6 +49,48 @@ export function releasedVersion(
   return version;
 }
 
+/**
+ * What the build is called on the page: the release when there is one, and the
+ * commit when there is not.
+ *
+ * A site that has never been released still has to be identifiable in a
+ * report, and `0.0.0` identifies nothing while the commit it was built from
+ * identifies exactly one build.
+ * @param build - What the build published about itself, or `undefined`.
+ * @returns The label, or `undefined` when the build published neither.
+ */
+export function buildLabel(build: BuildInfo | undefined): string | undefined {
+  const version = releasedVersion(build);
+  if (version !== undefined) return version;
+  const commit = build?.commit;
+  return commit === undefined ? undefined : shortCommit(commit);
+}
+
+/**
+ * When the build was made, as it is read on the badge: the day and the minute.
+ *
+ * A build a reader is asked to quote is worth little without a date, and two
+ * builds of the same day are told apart by the minute. The seconds are left to
+ * the hover, where the whole record is.
+ * @param builtAt - The ISO instant the build wrote.
+ * @returns The instant, in UTC, e.g. `2026-09-16 09:41 UTC`.
+ */
+export function buildStamp(builtAt: string): string {
+  return `${builtAt.slice(0, MINUTE_LENGTH).replace('T', ' ')} UTC`;
+}
+
+/**
+ * The whole record in one line, for the hover of a badge that shows one part
+ * of it.
+ * @param build - What the build published about itself.
+ * @returns e.g. `Built 2026-09-16 09:41:07 UTC from commit a1b2c3d`.
+ */
+export function buildSummary(build: BuildInfo): string {
+  const built = `Built ${formatBuiltAt(build.builtAt)}`;
+  if (build.commit === undefined) return built;
+  return `${built} from commit ${shortCommit(build.commit)}`;
+}
+
 /**
  * The commit as it is written for a reader.
  * @param commit - The full hash.
@@ -69,4 +111,5 @@ export function formatBuiltAt(builtAt: string): string {
 }
 
 const SHORT_COMMIT_LENGTH = 7;
+const MINUTE_LENGTH = 16;
 const SECOND_LENGTH = 19;

package/src/build/core/index.ts

@@ -1,6 +1,9 @@
 export type { BuildInfo } from './buildInfo.ts';
 export {
   UNRELEASED_VERSION,
+  buildLabel,
+  buildStamp,
+  buildSummary,
   formatBuiltAt,
   releasedVersion,
   shortCommit,

package/src/chrome/ui/SiteHeader.tsx

@@ -2,7 +2,7 @@ import type { ReactElement, ReactNode } from 'react';
 import { Fragment } from 'react';
 
 import { siteById } from '../../ecosystem/core/lookup.ts';
-import type { SiteId } from '../../ecosystem/core/sites.ts';
+import type { SiteId, SiteRecord } from '../../ecosystem/core/sites.ts';
 import { Wordmark } from '../../ecosystem/ui/Wordmark.tsx';
 import { SiteMark } from '../../ecosystem/ui/marks.tsx';
 
@@ -12,8 +12,24 @@ import type { NavItem } from './navItem.ts';
 import { isModifiedClick } from './navItem.ts';
 
 export interface SiteHeaderProps {
-  /** The site the bar belongs to, which draws its mark and writes its name. */
-  siteId: SiteId;
+  /**
+   * The site the bar belongs to, which draws its mark and writes its name. One
+   * of `site` and `siteId` is required.
+   * @default undefined
+   */
+  siteId?: SiteId;
+  /**
+   * The same site, passed rather than named — for a site that is deliberately
+   * not one of `ECOSYSTEM_SITES`, and so is linked from no other site's menu.
+   * @default undefined
+   */
+  site?: SiteRecord;
+  /**
+   * The site's own mark, for a site the shared glyph set does not hold. It
+   * stands where `SiteMark` would, at the size the site draws it.
+   * @default undefined — the family's mark for that site
+   */
+  mark?: ReactNode;
   /** The pages, in the order the bar lists them. */
   nav: readonly NavItem[];
   /**
@@ -86,10 +102,13 @@ export interface SiteHeaderProps {
  * @param props - The site, its pages, its utilities, and whether the page is
  * framed in another site.
  * @returns The bar, or nothing at all on an embedded page.
+ * @throws {Error} When neither `site` nor `siteId` is given.
  */
 export function SiteHeader(props: SiteHeaderProps): ReactElement | null {
   const {
     siteId,
+    site: record,
+    mark,
     nav,
     activeId,
     actions,
@@ -104,7 +123,10 @@ export function SiteHeader(props: SiteHeaderProps): ReactElement | null {
 
   if (embedded) return null;
 
-  const site = siteById(siteId);
+  const site = record ?? (siteId === undefined ? undefined : siteById(siteId));
+  if (site === undefined) {
+    throw new Error('SiteHeader needs one of its `site` and `siteId` props');
+  }
 
   return (
     <header className="app-header no-print">
@@ -119,8 +141,8 @@ export function SiteHeader(props: SiteHeaderProps): ReactElement | null {
             onHome();
           }}
         >
-          <SiteMark siteId={siteId} size={markSize} />
-          <Wordmark siteId={siteId} />
+          {mark ?? <SiteMark site={site} size={markSize} />}
+          <Wordmark site={site} />
         </a>
         <nav className="app-header-nav">
           {nav.map((item) => (

package/src/ecosystem/core/index.ts

@@ -14,6 +14,7 @@ export type {
   SiteId,
   SiteMarkColors,
   SiteName,
+  SiteRecord,
 } from './sites.ts';
 export { ECOSYSTEM_SITES, siteUrl } from './sites.ts';
 export { siteTokensCss } from './tokens.ts';

package/src/ecosystem/core/lookup.ts

@@ -1,6 +1,6 @@
 import type { SiteGroup, SiteGroupId } from './groups.ts';
 import { SITE_GROUPS } from './groups.ts';
-import type { EcosystemSite, SiteId } from './sites.ts';
+import type { EcosystemSite, SiteId, SiteRecord } from './sites.ts';
 import { ECOSYSTEM_SITES } from './sites.ts';
 
 /** One topic and the sites written under it. */
@@ -62,7 +62,7 @@ export function siteById(id: SiteId): EcosystemSite {
  * @param site - The site being named.
  * @returns What the site is called, in one string.
  */
-export function siteDisplayName(site: EcosystemSite): string {
+export function siteDisplayName(site: SiteRecord): string {
   return site.name.dot === true
     ? site.host
     : `${site.name.lead}${site.name.alt}`;

package/src/ecosystem/core/nameColors.ts

@@ -1,6 +1,6 @@
 import { FAMILY_TOKEN_VALUES, TOKEN } from '../../tokens/core/familyTokens.ts';
 
-import type { EcosystemSite } from './types.ts';
+import type { SiteRecord } from './types.ts';
 
 /** The colour each half of a site's name is written in. */
 export interface SiteNameColors {
@@ -35,7 +35,7 @@ export interface SiteNameColorsOptions {
  * @returns The colour of each half, and of the dot between them.
  */
 export function siteNameColors(
-  site: EcosystemSite,
+  site: SiteRecord,
   options: SiteNameColorsOptions = {},
 ): SiteNameColors {
   const literal = options.colors === 'literal';

package/src/ecosystem/core/sites.ts

@@ -1,11 +1,12 @@
 // tokens-ok: file — every site's two colours are declared here.
-import type { EcosystemSite } from './types.ts';
+import type { EcosystemSite, SiteRecord } from './types.ts';
 
 export type {
   EcosystemSite,
   SiteId,
   SiteMarkColors,
   SiteName,
+  SiteRecord,
 } from './types.ts';
 
 /**
@@ -295,6 +296,6 @@ export const ECOSYSTEM_SITES: readonly EcosystemSite[] = [
  * @param site - The site being linked to.
  * @returns The URL to open.
  */
-export function siteUrl(site: EcosystemSite): string {
+export function siteUrl(site: SiteRecord): string {
   return `https://${site.host}/`;
 }

package/src/ecosystem/core/tokens.ts

@@ -1,6 +1,6 @@
 // tokens-ok: file — the block a site renders is written here.
 import { siteById } from './lookup.ts';
-import type { EcosystemSite, SiteId } from './sites.ts';
+import type { SiteId, SiteRecord } from './sites.ts';
 
 /**
  * The custom properties a site of the family sets on `:root`: the two colours
@@ -9,21 +9,22 @@ import type { EcosystemSite, SiteId } from './sites.ts';
  *
  * It is a complete rule rather than a list of declarations, so it drops into a
  * `<style>` of a prerendered page as it is.
- * @param id - The site whose palette is wanted.
+ * @param site - The site whose palette is wanted: its id, or the record of a
+ *   site that is not one of the family.
  * @returns The `:root` rule, ending in a newline.
  */
-export function siteTokensCss(id: SiteId): string {
-  const site = siteById(id);
-  const answering = answeringColor(site);
+export function siteTokensCss(site: SiteId | SiteRecord): string {
+  const record = typeof site === 'string' ? siteById(site) : site;
+  const answering = answeringColor(record);
   const declarations = [
-    `--brand: ${site.brand};`,
+    `--brand: ${record.brand};`,
     `--brand-alt: ${answering};`,
   ];
 
   // The answering colour of several sites is a yellow or an amber that sits
   // around 2:1 on white, so text set in it needs the darkened form instead.
-  if (site.brandAlt !== answering) {
-    declarations.push(`--brand-alt-text: ${site.brandAlt};`);
+  if (record.brandAlt !== answering) {
+    declarations.push(`--brand-alt-text: ${record.brandAlt};`);
   }
   declarations.push('--accent: var(--brand);');
 
@@ -32,6 +33,6 @@ export function siteTokensCss(id: SiteId): string {
 
 // The second colour as the site's mark draws it: on the accent element, unless
 // the mark inverts the pair and gives the plate the answering colour instead.
-function answeringColor(site: EcosystemSite): string {
+function answeringColor(site: SiteRecord): string {
   return site.mark.accent === site.brand ? site.mark.plate : site.mark.accent;
 }

package/src/ecosystem/core/types.ts

@@ -50,10 +50,14 @@ export interface SiteName {
   ink?: 'lead' | 'alt';
 }
 
-/** One site of the family: its name, address, topic and two colours. */
-export interface EcosystemSite {
-  /** The identifier every component and helper names the site by. */
-  id: SiteId;
+/**
+ * What the chrome draws a site from: its name, address and two colours. A site
+ * that is deliberately not one of the family writes its own, and passes it
+ * wherever a family site passes its id.
+ */
+export interface SiteRecord {
+  /** The identifier the site is named by. */
+  id: string;
   /** The name, split the way the site's own wordmark splits it. */
   name: SiteName;
   /** Where the site lives, written the way it is typed. */
@@ -70,11 +74,6 @@ export interface EcosystemSite {
   publicRepository?: boolean;
   /** One line on what the site does. */
   tagline: string;
-  /**
-   * The topic the site is written under, which is what decides where it sits
-   * in the menu and in the footer.
-   */
-  group: SiteGroupId;
   /**
    * The colour the name is written in — the first half, or the second when
    * `name.ink` leaves the first in the family's ink.
@@ -90,6 +89,17 @@ export interface EcosystemSite {
   mark: SiteMarkColors;
 }
 
+/** One site of the family: its record, and the topic it is listed under. */
+export interface EcosystemSite extends SiteRecord {
+  /** The identifier every component and helper names the site by. */
+  id: SiteId;
+  /**
+   * The topic the site is written under, which is what decides where it sits
+   * in the menu and in the footer.
+   */
+  group: SiteGroupId;
+}
+
 /** The colours a site's mark is drawn in. */
 export interface SiteMarkColors {
   /** The rounded square the mark is drawn on. */

package/src/ecosystem/ui/SiteTheme.tsx

@@ -1,12 +1,22 @@
 import type { ReactElement } from 'react';
 
-import type { SiteId } from '../core/sites.ts';
+import type { SiteId, SiteRecord } from '../core/sites.ts';
 import { siteTokensCss } from '../core/tokens.ts';
 
 /** What the site palette needs. */
 export interface SiteThemeProps {
-  /** The site whose palette the page takes. */
-  siteId: SiteId;
+  /**
+   * The site whose palette the page takes, named. One of `site` and `siteId`
+   * is required.
+   * @default undefined
+   */
+  siteId?: SiteId;
+  /**
+   * The same site, passed rather than named — for a site that is deliberately
+   * not one of `ECOSYSTEM_SITES`.
+   * @default undefined
+   */
+  site?: SiteRecord;
 }
 
 /**
@@ -18,7 +28,12 @@ export interface SiteThemeProps {
  * in a component.
  * @param props - The site whose palette is injected.
  * @returns The rule, as a style element that applies wherever it is rendered.
+ * @throws {Error} When neither `site` nor `siteId` is given.
  */
 export function SiteTheme(props: SiteThemeProps): ReactElement {
-  return <style>{siteTokensCss(props.siteId)}</style>;
+  const site = props.site ?? props.siteId;
+  if (site === undefined) {
+    throw new Error('SiteTheme needs one of its `site` and `siteId` props');
+  }
+  return <style>{siteTokensCss(site)}</style>;
 }

package/src/ecosystem/ui/Wordmark.tsx

@@ -3,7 +3,7 @@ import type { CSSProperties, ReactElement } from 'react';
 import { joinClassNames } from '../../shared/ui/joinClassNames.ts';
 import { siteById } from '../core/lookup.ts';
 import { siteNameColors } from '../core/nameColors.ts';
-import type { EcosystemSite, SiteId } from '../core/sites.ts';
+import type { SiteId, SiteRecord } from '../core/sites.ts';
 
 /** What a site's written name needs. */
 export interface WordmarkProps {
@@ -13,7 +13,7 @@ export interface WordmarkProps {
    * required.
    * @default undefined
    */
-  site?: EcosystemSite;
+  site?: SiteRecord;
   /**
    * The same site, named rather than passed, which is what a header knows.
    * @default undefined

package/src/ecosystem/ui/marks.tsx

@@ -1,7 +1,7 @@
-import type { CSSProperties, ReactElement } from 'react';
+import type { CSSProperties, ReactElement, ReactNode } from 'react';
 
 import { siteById } from '../core/lookup.ts';
-import type { EcosystemSite, SiteId } from '../core/sites.ts';
+import type { SiteId, SiteRecord } from '../core/sites.ts';
 
 import { GLYPHS } from './glyphs.tsx';
 
@@ -19,13 +19,21 @@ export interface SiteMarkProps {
    * and `siteId` is required.
    * @default undefined
    */
-  site?: EcosystemSite;
+  site?: SiteRecord;
   /**
    * The same site, named rather than passed, for a header that knows only
    * which site it is.
    * @default undefined
    */
   siteId?: SiteId;
+  /**
+   * What is drawn on the plate, in the same 32×32 box, given the colour its one
+   * answering element takes. It is how a site that is not one of the family,
+   * and so has no drawing in the shared set, still gets a mark of the family's
+   * shape.
+   * @default the family's drawing for that site
+   */
+  glyph?: (accent: string) => ReactNode;
   /**
    * Edge of the square the mark is drawn in, in pixels.
    * @default 28
@@ -57,13 +65,15 @@ export interface SiteMarkProps {
  * The little logo of one site of the family.
  * @param props - Which site, how big, and where its colours come from.
  * @returns The mark, as an inline SVG.
- * @throws {Error} When neither `site` nor `siteId` is given.
+ * @throws {Error} When neither `site` nor `siteId` is given, or when the site
+ *   is not one of the family and no `glyph` is.
  */
 export function SiteMark(props: SiteMarkProps): ReactElement {
   const {
     className,
     site,
     siteId,
+    glyph,
     size = 28,
     plate = true,
     colors = 'literal',
@@ -73,6 +83,10 @@ export function SiteMark(props: SiteMarkProps): ReactElement {
   if (drawn === undefined) {
     throw new Error('SiteMark needs one of its `site` and `siteId` props');
   }
+  const draw = glyph ?? familyGlyph(drawn.id);
+  if (draw === undefined) {
+    throw new Error(`SiteMark has no drawing for ${drawn.id}: pass its glyph`);
+  }
 
   const usesTokens = colors === 'tokens';
   const plateFill = usesTokens ? 'var(--brand)' : drawn.mark.plate;
@@ -100,7 +114,11 @@ export function SiteMark(props: SiteMarkProps): ReactElement {
           stroke={edge}
         />
       ) : null}
-      {GLYPHS[drawn.id](accent)}
+      {draw(accent)}
     </svg>
   );
 }
+
+function familyGlyph(id: string): ((accent: string) => ReactNode) | undefined {
+  return Object.hasOwn(GLYPHS, id) ? GLYPHS[id as SiteId] : undefined;
+}

package/src/seo/core/noscript.ts

@@ -167,7 +167,7 @@ function labelOf(route: NoscriptRoute): string {
 }
 
 function familyList(
-  current: SiteId,
+  current: string,
   ecosystem: boolean | NoscriptEcosystem | undefined,
 ): string {
   if (ecosystem === undefined || ecosystem === false) return '';

package/src/seo/core/pageMeta.ts

@@ -13,7 +13,7 @@
  */
 
 import { siteDisplayName } from '../../ecosystem/core/lookup.ts';
-import type { EcosystemSite, SiteId } from '../../ecosystem/core/sites.ts';
+import type { SiteId, SiteRecord } from '../../ecosystem/core/sites.ts';
 import { escapeAttribute, escapeText } from '../../share/core/escape.ts';
 
 import type { DocumentMeta } from './documentMeta.ts';
@@ -25,7 +25,7 @@ import { PAGE_HEAD_MARKER, fill } from './template.ts';
 /** Which site is being served, and what it answers. */
 export interface PageMetaOptions {
   /** The site, named or passed. */
-  site: EcosystemSite | SiteId;
+  site: SiteRecord | SiteId;
   /** Every address it answers, each with its title and description. */
   routes: readonly RouteMeta[];
   /**

package/src/seo/core/siteFiles.ts

@@ -10,7 +10,7 @@
  */
 
 import { siteById } from '../../ecosystem/core/lookup.ts';
-import type { EcosystemSite, SiteId } from '../../ecosystem/core/sites.ts';
+import type { SiteId, SiteRecord } from '../../ecosystem/core/sites.ts';
 import { trimTrailingSlash } from '../../router/core/address.ts';
 import { basePathOf } from '../../router/core/basePath.ts';
 import { escapeText } from '../../share/core/escape.ts';
@@ -25,7 +25,7 @@ const HTTP_ORIGIN = /^https?:\/\//i;
 /** What a crawler is told about the site as a whole. */
 export interface SiteFilesOptions {
   /** The site, named or passed. */
-  site: EcosystemSite | SiteId;
+  site: SiteRecord | SiteId;
   /** Every address it answers. */
   routes: readonly RouteMeta[];
   /**
@@ -71,7 +71,7 @@ ${entries}
  * @param site - The site, named or passed.
  * @returns Its record.
  */
-export function resolveSite(site: EcosystemSite | SiteId): EcosystemSite {
+export function resolveSite(site: SiteRecord | SiteId): SiteRecord {
   return typeof site === 'string' ? siteById(site) : site;
 }
 

package/src/seo/vite/ogCard.ts

@@ -11,8 +11,10 @@
  * a site must be able to import with none of the optional peers installed.
  */
 
+import type { ReactNode } from 'react';
+
 import { siteNameColors } from '../../ecosystem/core/nameColors.ts';
-import type { EcosystemSite, SiteId } from '../../ecosystem/core/sites.ts';
+import type { SiteId, SiteRecord } from '../../ecosystem/core/sites.ts';
 import { escapeText } from '../../share/core/escape.ts';
 import { FAMILY_TOKEN_VALUES } from '../../tokens/core/familyTokens.ts';
 import { resolveSite } from '../core/siteFiles.ts';
@@ -26,12 +28,18 @@ export const OG_HEIGHT = 630;
 /** What the card says, beyond the site's own name and mark. */
 export interface OgCardOptions {
   /** The site, named or passed. */
-  site: EcosystemSite | SiteId;
+  site: SiteRecord | SiteId;
   /**
    * The sentence under the name.
    * @default the site's tagline
    */
   description?: string;
+  /**
+   * The drawing on the mark's plate, for a site the shared glyph set does not
+   * hold — see `SiteMark`.
+   * @default the family's drawing for that site
+   */
+  glyph?: (accent: string) => ReactNode;
 }
 
 /**
@@ -58,7 +66,12 @@ export async function ogCardHtml(options: OgCardOptions): Promise<string> {
       import('../../ecosystem/ui/marks.tsx'),
     ]);
   const mark = renderToStaticMarkup(
-    createElement(SiteMark, { site, size: 132, colors: 'literal' }),
+    createElement(SiteMark, {
+      site,
+      glyph: options.glyph,
+      size: 132,
+      colors: 'literal',
+    }),
   );
   const dot = site.name.dot === true ? '<span class="dot">.</span>' : '';
 

package/src/seo/vite/prerender.ts

@@ -22,7 +22,7 @@ import { dirname, join, resolve } from 'node:path';
 
 import type { Logger, Plugin } from 'vite';
 
-import type { EcosystemSite, SiteId } from '../../ecosystem/core/sites.ts';
+import type { SiteId, SiteRecord } from '../../ecosystem/core/sites.ts';
 import { trimTrailingSlash } from '../../router/core/address.ts';
 import type { NoscriptText } from '../core/noscript.ts';
 import { noscriptIndex } from '../core/noscript.ts';
@@ -38,7 +38,7 @@ import { PAGE_BODY_MARKER, PAGE_HEAD_MARKER, fill } from '../core/template.ts';
 /** What the build needs to know to write the site's addresses. */
 export interface PrerenderOptions {
   /** The site, named or passed. */
-  site: EcosystemSite | SiteId;
+  site: SiteRecord | SiteId;
   /** Every address it answers, each with its title and description. */
   routes: readonly RouteMeta[];
   /**