@iterant/site-runtime 3.7.0 → 3.8.1

package/src/fonts/catalog.json

@@ -0,0 +1,361 @@
+{
+  "note": "The Google Fonts families every Iterant site may name. `class` is the face class the mockup analyzer reports; `cssVariable` is --font-<slug>, derived with fontCssVariable(). Subsets are latin + latin-ext everywhere. This file is the source of truth other packages mirror; catalog.ts reads it.",
+  "families": [
+    {
+      "family": "Fraunces",
+      "class": "serif"
+    },
+    {
+      "family": "Playfair Display",
+      "class": "serif"
+    },
+    {
+      "family": "Instrument Serif",
+      "class": "serif"
+    },
+    {
+      "family": "Source Serif 4",
+      "class": "serif"
+    },
+    {
+      "family": "Lora",
+      "class": "serif"
+    },
+    {
+      "family": "Newsreader",
+      "class": "serif"
+    },
+    {
+      "family": "EB Garamond",
+      "class": "serif"
+    },
+    {
+      "family": "Cormorant Garamond",
+      "class": "serif"
+    },
+    {
+      "family": "Libre Baskerville",
+      "class": "serif"
+    },
+    {
+      "family": "Merriweather",
+      "class": "serif"
+    },
+    {
+      "family": "Crimson Pro",
+      "class": "serif"
+    },
+    {
+      "family": "Literata",
+      "class": "serif"
+    },
+    {
+      "family": "DM Serif Display",
+      "class": "serif"
+    },
+    {
+      "family": "DM Serif Text",
+      "class": "serif"
+    },
+    {
+      "family": "Spectral",
+      "class": "serif"
+    },
+    {
+      "family": "Libre Caslon Text",
+      "class": "serif"
+    },
+    {
+      "family": "Bodoni Moda",
+      "class": "serif"
+    },
+    {
+      "family": "Gloock",
+      "class": "serif"
+    },
+    {
+      "family": "Young Serif",
+      "class": "serif"
+    },
+    {
+      "family": "Petrona",
+      "class": "serif"
+    },
+    {
+      "family": "Cinzel",
+      "class": "serif"
+    },
+    {
+      "family": "Marcellus",
+      "class": "serif"
+    },
+    {
+      "family": "Italiana",
+      "class": "serif"
+    },
+    {
+      "family": "Abril Fatface",
+      "class": "display"
+    },
+    {
+      "family": "Bitter",
+      "class": "slab"
+    },
+    {
+      "family": "Roboto Slab",
+      "class": "slab"
+    },
+    {
+      "family": "Zilla Slab",
+      "class": "slab"
+    },
+    {
+      "family": "Arvo",
+      "class": "slab"
+    },
+    {
+      "family": "Inter",
+      "class": "sans"
+    },
+    {
+      "family": "Inter Tight",
+      "class": "sans"
+    },
+    {
+      "family": "Manrope",
+      "class": "sans"
+    },
+    {
+      "family": "DM Sans",
+      "class": "sans"
+    },
+    {
+      "family": "Plus Jakarta Sans",
+      "class": "sans"
+    },
+    {
+      "family": "Figtree",
+      "class": "sans"
+    },
+    {
+      "family": "Outfit",
+      "class": "sans"
+    },
+    {
+      "family": "Onest",
+      "class": "sans"
+    },
+    {
+      "family": "Geist",
+      "class": "sans"
+    },
+    {
+      "family": "Schibsted Grotesk",
+      "class": "sans"
+    },
+    {
+      "family": "Instrument Sans",
+      "class": "sans"
+    },
+    {
+      "family": "Space Grotesk",
+      "class": "sans"
+    },
+    {
+      "family": "Bricolage Grotesque",
+      "class": "sans"
+    },
+    {
+      "family": "Work Sans",
+      "class": "sans"
+    },
+    {
+      "family": "Public Sans",
+      "class": "sans"
+    },
+    {
+      "family": "IBM Plex Sans",
+      "class": "sans"
+    },
+    {
+      "family": "Source Sans 3",
+      "class": "sans"
+    },
+    {
+      "family": "Nunito Sans",
+      "class": "sans"
+    },
+    {
+      "family": "Poppins",
+      "class": "sans"
+    },
+    {
+      "family": "Montserrat",
+      "class": "sans"
+    },
+    {
+      "family": "Raleway",
+      "class": "sans"
+    },
+    {
+      "family": "Lato",
+      "class": "sans"
+    },
+    {
+      "family": "Rubik",
+      "class": "sans"
+    },
+    {
+      "family": "Karla",
+      "class": "sans"
+    },
+    {
+      "family": "Archivo",
+      "class": "sans"
+    },
+    {
+      "family": "Barlow",
+      "class": "sans"
+    },
+    {
+      "family": "Sora",
+      "class": "sans"
+    },
+    {
+      "family": "Urbanist",
+      "class": "sans"
+    },
+    {
+      "family": "Albert Sans",
+      "class": "sans"
+    },
+    {
+      "family": "Hanken Grotesk",
+      "class": "sans"
+    },
+    {
+      "family": "Host Grotesk",
+      "class": "sans"
+    },
+    {
+      "family": "Red Hat Display",
+      "class": "sans"
+    },
+    {
+      "family": "Red Hat Text",
+      "class": "sans"
+    },
+    {
+      "family": "Epilogue",
+      "class": "sans"
+    },
+    {
+      "family": "Jost",
+      "class": "sans"
+    },
+    {
+      "family": "Mulish",
+      "class": "sans"
+    },
+    {
+      "family": "Be Vietnam Pro",
+      "class": "sans"
+    },
+    {
+      "family": "Lexend",
+      "class": "sans"
+    },
+    {
+      "family": "Familjen Grotesk",
+      "class": "sans"
+    },
+    {
+      "family": "Chivo",
+      "class": "sans"
+    },
+    {
+      "family": "Roboto Flex",
+      "class": "sans"
+    },
+    {
+      "family": "Open Sans",
+      "class": "sans"
+    },
+    {
+      "family": "Nunito",
+      "class": "rounded"
+    },
+    {
+      "family": "Quicksand",
+      "class": "rounded"
+    },
+    {
+      "family": "Varela Round",
+      "class": "rounded"
+    },
+    {
+      "family": "Archivo Narrow",
+      "class": "condensed"
+    },
+    {
+      "family": "Barlow Condensed",
+      "class": "condensed"
+    },
+    {
+      "family": "Oswald",
+      "class": "condensed"
+    },
+    {
+      "family": "Bebas Neue",
+      "class": "display"
+    },
+    {
+      "family": "Anton",
+      "class": "display"
+    },
+    {
+      "family": "Archivo Black",
+      "class": "display"
+    },
+    {
+      "family": "Syne",
+      "class": "display"
+    },
+    {
+      "family": "Unbounded",
+      "class": "display"
+    },
+    {
+      "family": "Caveat",
+      "class": "handwritten"
+    },
+    {
+      "family": "IBM Plex Mono",
+      "class": "mono"
+    },
+    {
+      "family": "JetBrains Mono",
+      "class": "mono"
+    },
+    {
+      "family": "Space Mono",
+      "class": "mono"
+    },
+    {
+      "family": "DM Mono",
+      "class": "mono"
+    },
+    {
+      "family": "Fira Code",
+      "class": "mono"
+    },
+    {
+      "family": "Geist Mono",
+      "class": "mono"
+    },
+    {
+      "family": "Roboto Mono",
+      "class": "mono"
+    }
+  ]
+}

package/src/fonts/catalog.ts

@@ -0,0 +1,88 @@
+import catalog from "./catalog.json";
+
+// The font catalog: the Google Fonts families an Iterant site may name, and the
+// CSS variable each one is served under. `catalog.json` beside this file is the
+// source of truth other packages mirror (the agent picks family names out of
+// it); this module is the typed reader plus the two helpers the platform and
+// the layout both need.
+//
+// A family is NOT loaded because it is in the catalog. The preset declares only
+// the families a site names (`iterantStarter({ fonts })`) and the layout renders
+// `<Font>` only for those, because Astro resolves every declared family at dev
+// boot and downloads every one of its files at build. See the preset.
+
+/** The face class the mockup analyzer reports for a family. */
+export type FontClass =
+  | "serif"
+  | "sans"
+  | "slab"
+  | "mono"
+  | "display"
+  | "rounded"
+  | "condensed"
+  | "handwritten";
+
+export interface FontCatalogEntry {
+  /** The Google Fonts family name, exactly as the provider spells it. */
+  family: string;
+  class: FontClass;
+}
+
+/** Every family a site may name, in catalog order. */
+export const FONT_CATALOG = catalog.families as readonly FontCatalogEntry[];
+
+/**
+ * The CSS variable a family is served under: the family name lowercased with
+ * spaces hyphenated, under a `--font-` prefix (`Playfair Display` →
+ * `--font-playfair-display`). The preset registers this name with Astro and the
+ * layout renders `<Font>` by it, so the two can only agree through this
+ * function.
+ */
+export function fontCssVariable(family: string): `--font-${string}` {
+  return `--font-${family.trim().toLowerCase().replace(/\s+/g, "-")}`;
+}
+
+/**
+ * The catalog entry for a family name, or undefined for a name the catalog does
+ * not carry. Callers skip what they cannot resolve: Astro's `<Font>` throws on a
+ * CSS variable no family registered, so an unknown name must never reach it.
+ */
+export function findFontFamily(family: string): FontCatalogEntry | undefined {
+  return FONT_CATALOG.find((entry) => entry.family === family);
+}
+
+/**
+ * The heading default for each face class: what the platform reaches for when a
+ * mockup reports a class and nothing has named a family yet. One per class, so
+ * every class a mockup can report resolves.
+ */
+export const DEFAULT_HEADING_FAMILY_BY_CLASS: Readonly<
+  Record<FontClass, string>
+> = {
+  serif: "Fraunces",
+  sans: "Schibsted Grotesk",
+  slab: "Bitter",
+  rounded: "Nunito",
+  condensed: "Barlow Condensed",
+  display: "Syne",
+  handwritten: "Caveat",
+  mono: "IBM Plex Mono",
+};
+
+/** The body defaults, paired with any of the heading defaults above. */
+export const DEFAULT_BODY_FAMILIES: readonly string[] = [
+  "Instrument Sans",
+  "Inter Tight",
+  "Nunito Sans",
+];
+
+/**
+ * The families the preset declares whether or not a site names any: the eleven
+ * above. They are declared so the common path needs no astro.config edit and no
+ * dev-server restart to reach a face the platform just picked. Naming a family
+ * in SITE_CONFIG.fonts ADDS to this set; it does not replace it.
+ */
+export const DEFAULT_FONT_FAMILIES: readonly string[] = [
+  ...Object.values(DEFAULT_HEADING_FAMILY_BY_CLASS),
+  ...DEFAULT_BODY_FAMILIES,
+];

package/src/index.ts

@@ -7,6 +7,7 @@
 // Astro-bound surfaces have their own entries: `/content` (collections),
 // `/layout`, `/seo`, `/routes`, `/sitemap`, `/config`, `/integrations/*`.
 export * from "./content/schema";
+export * from "./fonts/catalog";
 export * from "./layouts/layout-core";
 export * from "./lib/bespoke-pages";
 export * from "./lib/chrome-schemas";

package/src/integrations/dev-restart-state.mjs

@@ -0,0 +1,46 @@
+// @ts-check
+
+// Dev-only: is an in-place Astro restart in flight? (3.8.1)
+//
+// Astro replaces its Vite server in place when a watched file changes
+// (`src/site-config.ts`, `package.json`), and for that stretch the port still
+// accepts connections while the server behind it is being torn down and built
+// again. A request that was already running is answered 500 `fetch failed`:
+// the Cloudflare vite plugin's miniflare went down under it.
+//
+// preview-error-shell reads this flag before it fetches /under-construction
+// back through that same port for its cache. A fetch aimed into the gap buys
+// nothing (it can only fail or hang) and it reaches back into the plugin at
+// the moment it is least able to answer, which is how the 3.8.0 shell wedged
+// the dev server for a whole 120s probe window in Docker.
+//
+// The window opens in `dev-server-signals` at `astro:config:setup` on the
+// restarted server, the same moment it emits
+// `{"event":"restart","phase":"config"}`, and closes when that server's socket
+// starts listening, the moment of `{"event":"ready","restart":true}`.
+//
+// State, not a timer: nothing here schedules work or holds a handle, and the
+// two integrations share one module instance because the preset imports both
+// from this package. A restart that never lands would otherwise leave the flag
+// up for the rest of the session and strand the cache empty, so the flag is
+// read with a bound on how long a restart can plausibly be in flight rather
+// than trusted forever. A dev boot on a cold cache is around 11s.
+
+const RESTART_WINDOW_MS = 30_000;
+
+let startedAt = 0;
+
+/** The restarted server is being built. Called once per in-place restart. */
+export function beginRestart() {
+  startedAt = Date.now();
+}
+
+/** The restarted server is listening, so a self-fetch can be answered again. */
+export function endRestart() {
+  startedAt = 0;
+}
+
+/** @returns {boolean} */
+export function restartInFlight() {
+  return startedAt !== 0 && Date.now() - startedAt < RESTART_WINDOW_MS;
+}