@integr8-media/config 1.0.0 → 1.2.0

package/dist/cli-DIsoGTED.mjs

@@ -0,0 +1,2644 @@
+import { t as ConfigError } from "./configError-Cap5gwBB.mjs";
+import { createRequire } from "node:module";
+import { createReadStream, existsSync } from "node:fs";
+import { cp, mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
+import { dirname, extname, isAbsolute, join, resolve, sep } from "node:path";
+import { pathToFileURL } from "node:url";
+import ts from "typescript";
+import { spawn } from "node:child_process";
+import { createServer } from "node:http";
+import { brotliCompressSync, constants } from "node:zlib";
+// src/registrySite/siteCss.ts
+/** Styles shared by every page: the integr8-media.com look. */
+const SITE_CSS = `
+    :root {
+      --bg: #07060b;
+      --soft: #100e18;
+      --raise: #15121f;
+      --fg: #f4f2ff;
+      --muted: #9a96b0;
+      --line: rgba(255, 255, 255, 0.08);
+      --line-strong: rgba(255, 255, 255, 0.16);
+      --violet: #7c5cff;
+      --cyan: #22d3ee;
+      --lime: #c6ff3d;
+      --pink: #ff4fd8;
+      --font-sans: "Inter Variable", "Inter", ui-sans-serif, system-ui, sans-serif;
+      --font-display: "Unbounded", "Inter Variable", "Inter", ui-sans-serif, system-ui, sans-serif;
+      --font-mono: "JetBrains Mono Variable", "JetBrains Mono", ui-monospace, SFMono-Regular, Menlo, monospace;
+      color-scheme: dark;
+    }
+    *, *::before, *::after { box-sizing: border-box; }
+    [hidden] { display: none !important; }
+    html { scroll-behavior: smooth; scroll-padding-top: 5rem; }
+    body { margin: 0; background: var(--bg); color: var(--fg); font: 16px/1.6 var(--font-sans); -webkit-font-smoothing: antialiased; overflow-x: hidden; }
+    ::selection { background: var(--lime); color: #07060b; }
+    a { color: inherit; }
+    :focus-visible { outline: 2px solid var(--violet); outline-offset: 3px; }
+    h1, h2, h3, h4 { font-family: var(--font-display); font-weight: 600; line-height: 1.15; margin: 0; letter-spacing: -0.01em; }
+    p { margin: 0; }
+    code, pre { font-family: var(--font-mono); font-size: 0.875rem; }
+    .sr-only { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; }
+    .skip { position: absolute; left: 1rem; top: -4rem; z-index: 60; padding: 0.5rem 1rem; border-radius: 999px; background: var(--lime); color: #07060b; font-weight: 600; }
+    .skip:focus { top: 1rem; }
+    .wrap { width: 100%; max-width: 76rem; margin: 0 auto; padding: 0 1rem; }
+    @media (min-width: 48rem) { .wrap { padding: 0 2rem; } }
+
+    /* Film grain and background glow, as on integr8-media.com. */
+    .grain { position: fixed; inset: 0; z-index: 50; pointer-events: none; opacity: 0.06; mix-blend-mode: overlay;
+      background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='160' height='160'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.8' numOctaves='3' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)'/%3E%3C/svg%3E"); }
+    .glow { position: absolute; inset: 0 0 auto; height: 44rem; z-index: -1; pointer-events: none;
+      background: radial-gradient(40rem 22rem at 18% 8%, rgba(124, 92, 255, 0.28), transparent 70%),
+                  radial-gradient(34rem 20rem at 85% 18%, rgba(34, 211, 238, 0.16), transparent 70%),
+                  radial-gradient(30rem 16rem at 55% 60%, rgba(198, 255, 61, 0.07), transparent 70%); }
+    .gradient { background: linear-gradient(90deg, var(--violet), var(--cyan), var(--lime)); -webkit-background-clip: text; background-clip: text; color: transparent; -webkit-text-fill-color: transparent; }
+
+    /* Header */
+    .nav { position: sticky; top: 0; z-index: 40; border-bottom: 1px solid var(--line); background: rgba(7, 6, 11, 0.72); backdrop-filter: blur(14px); -webkit-backdrop-filter: blur(14px); }
+    .nav .wrap { display: flex; align-items: center; gap: 1.5rem; height: 4rem; }
+    .brand { display: flex; align-items: center; gap: 0.6rem; text-decoration: none; font-family: var(--font-display); font-weight: 600; font-size: 1.05rem; }
+    .brand-mark { display: grid; place-items: center; width: 2rem; height: 2rem; border-radius: 0.6rem; background: linear-gradient(135deg, var(--violet), var(--cyan)); color: #07060b; font-size: 0.75rem; font-weight: 800; }
+    .brand .slash { color: var(--lime); margin: 0 0.15rem; }
+    .nav nav { display: flex; align-items: center; gap: 1.25rem; margin-left: auto; font-size: 0.925rem; }
+    .nav nav a { text-decoration: none; color: var(--muted); transition: color 0.2s; }
+    .nav nav a:hover { color: var(--fg); }
+    @media (max-width: 40rem) { .nav-hide { display: none; } }
+
+    /* Buttons */
+    .btn { display: inline-flex; align-items: center; justify-content: center; gap: 0.5rem; min-height: 3rem; padding: 0 1.5rem; border-radius: 999px; font-weight: 600; text-decoration: none; border: 1px solid transparent; transition: transform 0.2s, background 0.2s, border-color 0.2s; }
+    .btn:hover { transform: translateY(-1px); }
+    .btn.primary { background: var(--lime); color: #07060b; }
+    .btn.ghost { border-color: var(--line-strong); color: var(--fg); background: rgba(255, 255, 255, 0.03); }
+    .btn.ghost:hover { border-color: var(--violet); }
+    .pill-sm { display: inline-flex; align-items: center; min-height: 2rem; padding: 0 0.85rem; border-radius: 999px; border: 1px solid transparent; background: var(--lime); color: #07060b; font: 600 0.8rem var(--font-sans); text-decoration: none; cursor: pointer; }
+    .pill-sm.ghost { background: transparent; color: var(--fg); border-color: var(--line-strong); }
+    .pill-sm.ghost:hover { border-color: var(--violet); }
+    .chip { display: inline-flex; align-items: center; gap: 0.4rem; min-height: 2.25rem; padding: 0 0.9rem; border-radius: 999px; border: 1px solid var(--line-strong); background: transparent; color: var(--muted); font: 500 0.85rem var(--font-sans); cursor: pointer; transition: all 0.2s; }
+    .chip span { color: inherit; opacity: 0.6; font-size: 0.75rem; }
+    .chip:hover { color: var(--fg); border-color: var(--violet); }
+    .chip[aria-pressed="true"] { background: var(--violet); border-color: var(--violet); color: #fff; }
+    .chips { display: flex; flex-wrap: wrap; gap: 0.5rem; }
+
+    /* Hero */
+    .hero { position: relative; padding: 5rem 0 4rem; }
+    @media (min-width: 48rem) { .hero { padding: 7.5rem 0 5.5rem; } }
+    .eyebrow { display: inline-flex; align-items: center; gap: 0.5rem; color: var(--muted); font: 500 0.8rem var(--font-mono); text-transform: uppercase; letter-spacing: 0.12em; }
+    .eyebrow::before { content: ""; width: 0.5rem; height: 0.5rem; border-radius: 999px; background: var(--lime); box-shadow: 0 0 12px var(--lime); }
+    .hero h1 { margin-top: 1.25rem; font-size: clamp(2.4rem, 7vw, 5rem); font-weight: 800; max-width: 15ch; }
+    .lead { color: var(--muted); font-size: 1.1rem; max-width: 42rem; }
+    .hero .lead { margin-top: 1.5rem; font-size: clamp(1.05rem, 2vw, 1.25rem); }
+    .cta { display: flex; flex-wrap: wrap; gap: 0.75rem; margin-top: 2.25rem; }
+    .hero .cmd { margin-top: 2rem; max-width: 46rem; }
+    .stats { display: flex; flex-wrap: wrap; gap: 2.5rem; margin: 3.5rem 0 0; padding: 0; list-style: none; }
+    .stats strong { display: block; font: 700 2rem/1 var(--font-display); }
+    .stats span { color: var(--muted); font-size: 0.875rem; }
+
+    /* Command lines and code */
+    .cmd { display: flex; align-items: center; gap: 0.5rem; min-width: 0; padding: 0.4rem 0.4rem 0.4rem 1rem; border: 1px solid var(--line-strong); border-radius: 999px; background: rgba(255, 255, 255, 0.03); }
+    .cmd code { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; color: var(--fg); }
+    .cmd code::before { content: "$ "; color: var(--lime); }
+    .copy { flex: none; min-height: 2.25rem; padding: 0 1rem; border-radius: 999px; border: 1px solid var(--line-strong); background: var(--raise); color: var(--fg); font: 600 0.8rem var(--font-sans); cursor: pointer; transition: all 0.2s; }
+    .copy:hover { border-color: var(--violet); }
+    .copy[data-copied] { background: var(--lime); border-color: var(--lime); color: #07060b; }
+    .code { position: relative; margin-top: 1rem; border: 1px solid var(--line); border-radius: 1rem; background: rgba(0, 0, 0, 0.35); min-width: 0; }
+    .code pre { margin: 0; padding: 1rem 1.25rem; overflow-x: auto; color: #d9d5f5; }
+    .code-caption { padding: 0.6rem 6rem 0.6rem 1.25rem; border-bottom: 1px solid var(--line); color: var(--muted); font: 500 0.8rem var(--font-mono); overflow-wrap: anywhere; }
+    .code .copy { position: absolute; top: 0.45rem; right: 0.5rem; min-height: 2rem; }
+
+    /* Sections */
+    .section { padding: 4.5rem 0; border-top: 1px solid var(--line); }
+    .section-head { max-width: 46rem; margin-bottom: 2.5rem; }
+    .section-head h2 { margin-top: 1rem; font-size: clamp(1.8rem, 4.5vw, 3rem); }
+    .section-head .lead { margin-top: 1rem; }
+
+    /* Steps */
+    .steps { display: grid; gap: 1rem; grid-template-columns: repeat(auto-fit, minmax(min(100%, 20rem), 1fr)); margin: 0; padding: 0; list-style: none; counter-reset: step; }
+    .step { position: relative; display: flex; flex-direction: column; gap: 0.75rem; padding: 1.5rem; border: 1px solid var(--line); border-radius: 2rem; background: var(--soft); min-width: 0; }
+    .step::before { counter-increment: step; content: "0" counter(step); font: 700 0.85rem var(--font-mono); color: var(--lime); }
+    .step h3 { font-size: 1.15rem; }
+    .step p { color: var(--muted); font-size: 0.95rem; }
+    .step .cmd { margin-top: auto; }
+    .extras { display: grid; gap: 1rem; grid-template-columns: repeat(auto-fit, minmax(min(100%, 26rem), 1fr)); margin-top: 1rem; }
+    .extra { padding: 1.5rem; border: 1px solid var(--line); border-radius: 2rem; background: var(--soft); min-width: 0; }
+    .extra h3 { font-size: 1.05rem; }
+    .extra p { margin-top: 0.5rem; color: var(--muted); font-size: 0.95rem; }
+
+    /* Live preview */
+    .viewer { border: 1px solid var(--line-strong); border-radius: 2rem; overflow: hidden; background: var(--soft); }
+    .viewer-bar { display: flex; flex-wrap: wrap; align-items: center; gap: 0.75rem; padding: 0.9rem; border-bottom: 1px solid var(--line); }
+    .viewer-bar .field { flex: 1 1 16rem; min-width: 0; }
+    .viewer-bar .open-full { margin-left: auto; }
+    select, input[type="search"] { width: 100%; min-height: 2.5rem; padding: 0 1rem; border-radius: 999px; border: 1px solid var(--line-strong); background: var(--bg); color: var(--fg); font: 500 0.9rem var(--font-sans); }
+    select:focus-visible, input[type="search"]:focus-visible { outline: 2px solid var(--violet); outline-offset: 1px; }
+    .viewer iframe { display: block; width: 100%; height: min(72vh, 42rem); border: 0; background: var(--bg); }
+    /* Full screen: the viewer covers the window; its bar keeps the close button. */
+    .viewer.is-expanded { position: fixed; inset: 0; z-index: 70; display: flex; flex-direction: column; border: 0; border-radius: 0; }
+    .viewer.is-expanded iframe { flex: 1; height: auto; }
+    body.viewer-open { overflow: hidden; }
+    .note { padding: 1rem 1.25rem; color: var(--muted); }
+
+    /* Component list */
+    .toolbar { display: flex; flex-direction: column; gap: 1rem; margin-bottom: 2rem; }
+    .search { max-width: 28rem; }
+    .group + .group { margin-top: 3rem; }
+    .group h3 { font-size: 1.25rem; margin-bottom: 1.25rem; }
+    .cards { display: grid; gap: 1rem; grid-template-columns: repeat(auto-fill, minmax(min(100%, 17rem), 1fr)); margin: 0; padding: 0; list-style: none; }
+    .card { position: relative; display: flex; flex-direction: column; gap: 0.75rem; padding: 1.25rem; border: 1px solid var(--line); border-radius: 1.25rem; background: var(--soft); transition: border-color 0.2s, transform 0.2s; min-width: 0; }
+    .card:hover { border-color: rgba(124, 92, 255, 0.55); transform: translateY(-2px); }
+    .card-head { display: flex; align-items: center; justify-content: space-between; gap: 0.5rem; }
+    .card h4 { font-size: 0.95rem; overflow-wrap: anywhere; }
+    .card h4 a { text-decoration: none; }
+    .card h4 a:hover { color: var(--lime); }
+    .card p { flex: 1; color: var(--muted); font-size: 0.875rem; }
+    .tag { flex: none; padding: 0.15rem 0.55rem; border-radius: 999px; border: 1px solid var(--line-strong); color: var(--muted); font: 500 0.7rem var(--font-mono); }
+    .card-actions { display: flex; flex-wrap: wrap; gap: 0.4rem; }
+    .card .copy { min-height: 2rem; background: var(--lime); color: #07060b; border-color: var(--lime); }
+    .empty { padding: 3rem 0; text-align: center; color: var(--muted); }
+
+    /* Item pages: sidebar + article */
+    .docs { display: grid; gap: 2rem; padding-top: 2rem; padding-bottom: 4rem; }
+    @media (min-width: 64rem) {
+      .docs { grid-template-columns: 15rem minmax(0, 1fr); gap: 3rem; padding-top: 3rem; }
+      .sidebar { position: sticky; top: 5rem; align-self: start; max-height: calc(100vh - 6rem); overflow-y: auto; padding-right: 0.5rem; }
+      .side-nav[open] > summary { display: none; }
+    }
+    .side-nav { border: 1px solid var(--line); border-radius: 1.25rem; background: var(--soft); padding: 0.25rem 1rem; }
+    @media (min-width: 64rem) { .side-nav[open] { border: 0; background: none; padding: 0; } }
+    .side-nav summary { cursor: pointer; padding: 0.75rem 0; font-weight: 600; }
+    .side-nav h2 { margin: 1.25rem 0 0.4rem; color: var(--muted); font: 600 0.72rem var(--font-mono); text-transform: uppercase; letter-spacing: 0.12em; }
+    .side-nav ul { margin: 0; padding: 0; list-style: none; }
+    .side-nav a { display: block; padding: 0.3rem 0.75rem; border-radius: 0.6rem; color: var(--muted); text-decoration: none; font-size: 0.9rem; overflow-wrap: anywhere; }
+    .side-nav a:hover { color: var(--fg); background: rgba(255, 255, 255, 0.04); }
+    .side-nav a[aria-current="page"] { color: var(--fg); background: rgba(124, 92, 255, 0.18); box-shadow: inset 2px 0 0 var(--violet); }
+    .doc { min-width: 0; }
+    .crumbs { display: flex; flex-wrap: wrap; gap: 0.5rem; color: var(--muted); font-size: 0.875rem; }
+    .crumbs a { text-decoration: none; }
+    .crumbs a:hover { color: var(--fg); }
+    .doc-head { position: relative; margin-top: 1rem; padding-bottom: 2rem; }
+    .doc-head .tags { display: flex; flex-wrap: wrap; gap: 0.4rem; }
+    .doc-head h1 { margin-top: 0.75rem; font-size: clamp(2rem, 5vw, 3.25rem); overflow-wrap: anywhere; }
+    .doc-head .lead { margin-top: 1rem; }
+    .doc-head .cmd { margin-top: 1.5rem; max-width: 46rem; }
+    .toc { display: flex; flex-wrap: wrap; gap: 0.5rem; margin-top: 1.5rem; }
+    .toc a { padding: 0.25rem 0.75rem; border: 1px solid var(--line); border-radius: 999px; color: var(--muted); font-size: 0.8rem; text-decoration: none; }
+    .toc a:hover { color: var(--fg); border-color: var(--violet); }
+    .doc-section { padding: 2.5rem 0 0; }
+    .doc-section > h2 { font-size: 1.5rem; margin-bottom: 1rem; }
+    .doc-section > p, .prose p { color: var(--muted); }
+    .prose { display: flex; flex-direction: column; gap: 0.75rem; }
+    .prose ul { margin: 0; padding-left: 1.25rem; color: var(--muted); }
+    .prose code, .doc-section p code, td code, .facts code { padding: 0.1em 0.35em; border-radius: 0.35rem; background: rgba(255, 255, 255, 0.06); color: var(--fg); overflow-wrap: anywhere; }
+    .prose a, .doc-section a:not(.pill-sm):not(.chip) { color: var(--fg); text-decoration-color: var(--violet); text-underline-offset: 3px; }
+    .facts { display: grid; gap: 0.75rem; margin: 1.25rem 0 0; padding: 0; list-style: none; }
+    .facts li { display: flex; flex-wrap: wrap; align-items: baseline; gap: 0.4rem; color: var(--muted); font-size: 0.925rem; }
+    .facts strong { color: var(--fg); font-weight: 600; margin-right: 0.25rem; }
+    .api { margin-top: 1.5rem; padding: 1.5rem; border: 1px solid var(--line); border-radius: 1.5rem; background: var(--soft); min-width: 0; }
+    .api-head { display: flex; flex-wrap: wrap; align-items: center; gap: 0.6rem; margin-bottom: 0.75rem; }
+    .api-head h3 { font: 600 1.05rem var(--font-mono); overflow-wrap: anywhere; }
+    .api-head .deprecated { border-color: #ff5470; color: #ff5470; }
+    .api h4 { margin: 1.25rem 0 0.5rem; color: var(--muted); font: 600 0.72rem var(--font-mono); text-transform: uppercase; letter-spacing: 0.12em; }
+    .sig { margin: 0.75rem 0 0; padding: 0.75rem 1rem; border-radius: 0.75rem; background: rgba(0, 0, 0, 0.35); overflow-x: auto; color: #d9d5f5; white-space: pre-wrap; overflow-wrap: anywhere; }
+    .table-wrap { overflow-x: auto; border: 1px solid var(--line); border-radius: 1rem; }
+    table { width: 100%; border-collapse: collapse; font-size: 0.875rem; }
+    th, td { padding: 0.65rem 0.85rem; text-align: left; vertical-align: top; border-bottom: 1px solid var(--line); }
+    tr:last-child td { border-bottom: 0; }
+    th { color: var(--muted); font: 600 0.72rem var(--font-mono); text-transform: uppercase; letter-spacing: 0.08em; background: rgba(255, 255, 255, 0.02); }
+    td:first-child { white-space: nowrap; }
+    td:first-child code { color: var(--lime); }
+    td .muted { color: var(--muted); }
+    details.source { margin-top: 1rem; border: 1px solid var(--line); border-radius: 1rem; background: var(--soft); }
+    details.source > summary { cursor: pointer; padding: 0.9rem 1.25rem; font-weight: 600; }
+    details.source .code { margin: 0 1rem 1rem; }
+    details.source pre { max-height: 36rem; }
+    .pager { display: grid; gap: 1rem; grid-template-columns: repeat(auto-fit, minmax(min(100%, 14rem), 1fr)); margin-top: 3.5rem; }
+    .pager a { display: flex; flex-direction: column; gap: 0.25rem; padding: 1rem 1.25rem; border: 1px solid var(--line); border-radius: 1.25rem; text-decoration: none; }
+    .pager a:hover { border-color: var(--violet); }
+    .pager span { color: var(--muted); font-size: 0.8rem; }
+    .pager .next { text-align: right; }
+
+    /* Footer */
+    footer { border-top: 1px solid var(--line); padding: 2.5rem 0 3rem; color: var(--muted); font-size: 0.875rem; }
+    footer .wrap { display: flex; flex-wrap: wrap; justify-content: space-between; gap: 1rem; }
+
+    @media (prefers-reduced-motion: reduce) {
+      html { scroll-behavior: auto; }
+      *, *::before, *::after { transition-duration: 0.01ms !important; }
+      .btn:hover, .card:hover { transform: none; }
+    }
+`;
+// src/registrySite/layout.ts
+/** Short labels for registry types. */
+const TYPE_LABELS = {
+	"registry:ui": "component",
+	"registry:hook": "hook",
+	"registry:lib": "helper",
+	"registry:item": "setup"
+};
+/** Escapes text for HTML content and attribute values. */
+function escapeHtml(text) {
+	return String(text).replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&#39;");
+}
+/** The short label of a registry type: `registry:ui` → `component`. */
+function typeLabel(type) {
+	return TYPE_LABELS[type] ?? String(type).replace("registry:", "");
+}
+function labelOfId(id) {
+	const spaced = id.replace(/[-_]+/g, " ").trim();
+	return spaced.charAt(0).toUpperCase() + spaced.slice(1);
+}
+/**
+* Groups registry items by their first category, in the order of `categories`. Items without a
+* known category go last, under "Other". Without `categories`, the groups are the categories
+* found in the items, in order of first appearance (labelled from their ids).
+*
+* @param items - Registry items.
+* @param categories - Ordered `[id, label]` pairs, from the site config.
+* @returns Only the groups that have items.
+*/
+function groupItems(items, categories) {
+	const found = /* @__PURE__ */ new Set();
+	for (const item of items) {
+		const category = item.categories?.[0];
+		if (category) found.add(category);
+	}
+	const entries = categories ?? [...found].map((id) => [id, labelOfId(id)]);
+	const groups = new Map(entries.map(([id, label]) => [id, {
+		id,
+		label,
+		items: []
+	}]));
+	const other = {
+		id: "other",
+		label: "Other",
+		items: []
+	};
+	for (const item of items) {
+		const category = item.categories?.[0];
+		((category === void 0 ? void 0 : groups.get(category)) ?? other).items.push(item);
+	}
+	return [...groups.values(), other].filter((group) => group.items.length > 0);
+}
+/** A command line with a copy button. `display` defaults to the command itself. */
+function commandBlock(command, label, display = command) {
+	return `<div class="cmd">
+          <code>${escapeHtml(display)}</code>
+          <button type="button" class="copy" data-copy="${escapeHtml(command)}" aria-label="${escapeHtml(label)}">Copy</button>
+        </div>`;
+}
+/** A code sample with a copy button and an optional caption (for example a file path). */
+function codeBlock(code, label, caption) {
+	return `<div class="code">
+          ${caption ? `<div class="code-caption">${escapeHtml(caption)}</div>` : ""}
+          <button type="button" class="copy" data-copy="${escapeHtml(code)}" aria-label="${escapeHtml(label)}">Copy</button>
+          <pre><code>${escapeHtml(code)}</code></pre>
+        </div>`;
+}
+/** `{@link X}` and `{@link X | label}` → inline code (`X`) or the label. */
+function replaceLinks(text) {
+	return String(text).replace(/\{@link(?:code|plain)?\s+([^}|\s]+)(?:\s*\|\s*([^}]+))?\s*\}/g, (_all, target, label) => label ? label.trim() : `\`${target}\``);
+}
+/**
+* Inline Markdown: `code`, **bold** and [links](url). Inline code that names a documented
+* export becomes a link to it, through `linkFor`.
+*
+* @param text - Markdown text on one line.
+* @param options - `linkFor`, to link documented exports.
+* @returns HTML.
+*/
+function inlineMarkdown(text, options = {}) {
+	return replaceLinks(text).split(/(`[^`\n]+`)/).map((part) => {
+		if (part.startsWith("`") && part.endsWith("`") && part.length > 1) {
+			const code = part.slice(1, -1);
+			const href = options.linkFor?.(code.replace(/\(\)$/, ""));
+			const html = `<code>${escapeHtml(code)}</code>`;
+			return href ? `<a href="${escapeHtml(href)}">${html}</a>` : html;
+		}
+		return escapeHtml(part).replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>").replace(/\[([^\]]+)\]\(((?:https?:\/\/|\.|\/|#)[^)\s]*)\)/g, (_all, label, href) => `<a href="${href}">${label}</a>`);
+	}).join("");
+}
+/**
+* Block Markdown for TSDoc text: paragraphs, `-` lists and fenced code blocks.
+*
+* @param markdown - Markdown text.
+* @param options - `linkFor`, to link documented exports.
+* @returns HTML.
+*/
+function renderMarkdown(markdown, options = {}) {
+	const lines = String(markdown ?? "").replace(/\r/g, "").split("\n");
+	const out = [];
+	let paragraph = [];
+	let list = [];
+	const flushParagraph = () => {
+		if (paragraph.length > 0) {
+			out.push(`<p>${inlineMarkdown(paragraph.join(" "), options)}</p>`);
+			paragraph = [];
+		}
+	};
+	const flushList = () => {
+		if (list.length > 0) {
+			out.push(`<ul>${list.map((item) => `<li>${inlineMarkdown(item, options)}</li>`).join("")}</ul>`);
+			list = [];
+		}
+	};
+	for (let index = 0; index < lines.length; index++) {
+		const line = lines[index] ?? "";
+		if (/^\s*```\s*([\w-]*)/.test(line)) {
+			flushParagraph();
+			flushList();
+			const code = [];
+			index++;
+			while (index < lines.length && !/^\s*```/.test(lines[index] ?? "")) {
+				code.push(lines[index] ?? "");
+				index++;
+			}
+			out.push(codeBlock(code.join("\n"), "Copy the example"));
+			continue;
+		}
+		const bullet = /^\s*[-*]\s+(.*)$/.exec(line);
+		if (bullet) {
+			flushParagraph();
+			list.push(bullet[1] ?? "");
+		} else if (line.trim() === "") {
+			flushParagraph();
+			flushList();
+		} else if (list.length > 0 && /^\s+/.test(line)) {
+			const last = list.length - 1;
+			list[last] = `${list[last] ?? ""} ${line.trim()}`;
+		} else {
+			flushList();
+			paragraph.push(line.trim());
+		}
+	}
+	flushParagraph();
+	flushList();
+	return out.join("\n");
+}
+/** Copy buttons: any element with `data-copy` copies that text and says so. */
+const COPY_SCRIPT = `
+    (function () {
+      var status = document.getElementById('copy-status');
+      document.addEventListener('click', function (event) {
+        var button = event.target.closest('[data-copy]');
+        if (!button || button.hasAttribute('data-copied')) return;
+        var text = button.getAttribute('data-copy');
+        var done = function () {
+          var label = button.textContent;
+          button.setAttribute('data-copied', '');
+          button.textContent = 'Copied';
+          status.textContent = 'Copied to the clipboard.';
+          setTimeout(function () {
+            button.removeAttribute('data-copied');
+            button.textContent = label;
+          }, 1600);
+        };
+        if (navigator.clipboard) navigator.clipboard.writeText(text).then(done, function () {});
+      });
+    })();
+`;
+/**
+* Full-screen preview: a `[data-expand]` button makes its `.viewer` cover the window and
+* turns into "Close full screen". Escape closes it too.
+*/
+const VIEWER_SCRIPT = `
+    (function () {
+      function setExpanded(viewer, expanded) {
+        viewer.classList.toggle('is-expanded', expanded);
+        document.body.classList.toggle('viewer-open', expanded);
+        var button = viewer.querySelector('[data-expand]');
+        if (!button) return;
+        button.setAttribute('aria-pressed', String(expanded));
+        button.textContent = expanded ? 'Close full screen' : 'Full screen';
+        button.focus();
+      }
+      document.addEventListener('click', function (event) {
+        var button = event.target.closest('[data-expand]');
+        if (!button) return;
+        var viewer = button.closest('.viewer');
+        if (viewer) setExpanded(viewer, !viewer.classList.contains('is-expanded'));
+      });
+      document.addEventListener('keydown', function (event) {
+        if (event.key !== 'Escape') return;
+        var open = document.querySelector('.viewer.is-expanded');
+        if (open) setExpanded(open, false);
+      });
+    })();
+`;
+/**
+* The URL of a story in the embedded playground.
+*
+* @param playground - Playground folder (relative to the page, ends with `/`).
+* @param story - The Ladle story id.
+* @param theme - The preview theme id; leave out when the site has no theme switcher.
+* @returns The iframe `src` (not HTML-escaped).
+*/
+function storyUrl(playground, story, theme) {
+	const themeParam = theme ? `&integr8Theme=${encodeURIComponent(theme)}` : "";
+	return `${playground}?story=${encodeURIComponent(story)}${themeParam}&mode=preview&integr8Embed=1`;
+}
+/** The theme buttons of a live preview, the first one pressed. Empty without themes. */
+function themeButtons(themes, indent) {
+	if (themes.length === 0) return "";
+	return `<div class="chips" role="group" aria-label="Preview theme">
+${indent}${themes.map(([name, label], position) => `<button type="button" class="chip" data-theme="${escapeHtml(name)}" aria-pressed="${position === 0}">${escapeHtml(label)}</button>`).join(`\n${indent}`)}
+${indent.slice(2)}</div>`;
+}
+/**
+* The page shell shared by every page.
+*
+* @param options - Title, brand, links, body and script of the page.
+* @returns The full HTML document.
+*/
+function renderShell(options) {
+	const root = options.root ?? "";
+	const home = root || "./";
+	const { brand } = options;
+	const fonts = options.fontsHref ? `<link rel="stylesheet" href="${escapeHtml(root + options.fontsHref)}">` : "";
+	const repository = options.repositoryUrl ? `<a class="nav-hide" href="${escapeHtml(options.repositoryUrl)}">GitHub</a>` : "";
+	const playground = options.playgroundHref ? `<a class="nav-hide" href="${escapeHtml(root + options.playgroundHref)}">Playground</a>` : "";
+	return `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>${escapeHtml(options.title)}</title>
+  <meta name="description" content="${escapeHtml(options.description)}">
+  <meta name="theme-color" content="#07060b">
+  ${fonts}
+  <style>${SITE_CSS}</style>
+</head>
+<body>
+  <a class="skip" href="#main">Skip to content</a>
+  <div class="grain" aria-hidden="true"></div>
+
+  <header class="nav">
+    <div class="wrap">
+      <a class="brand" href="${escapeHtml(home)}" aria-label="${escapeHtml(brand.name)} home"><span class="brand-mark" aria-hidden="true">${escapeHtml(brand.mark)}</span><span>integr8<span class="slash">/</span>${escapeHtml(brand.slug)}</span></a>
+      <nav aria-label="Main">
+        <a class="nav-hide" href="${escapeHtml(root)}#start">Get started</a>
+        <a class="nav-hide" href="${escapeHtml(root)}#components">Components</a>
+        ${playground}
+        ${repository}
+      </nav>
+    </div>
+  </header>
+
+  ${options.body}
+
+  <footer>
+    <div class="wrap">
+      <span>${escapeHtml(options.footerNote)}</span>
+      <span>Built for <a href="https://integr8-media.com">integr8-media.com</a></span>
+    </div>
+  </footer>
+
+  <p id="copy-status" class="sr-only" aria-live="polite"></p>
+
+  <script>${COPY_SCRIPT}${VIEWER_SCRIPT}${options.script ?? ""}<\/script>
+</body>
+</html>
+`;
+}
+/**
+* Fills `{registryUrl}`, `{uiRegistryUrl}`, `{version}` and `{packageName}` in a setup text.
+* Any other `{...}` is kept (a `components.json` sample contains `{name}`).
+*
+* @param text - The template.
+* @param values - The values by placeholder name.
+* @returns The text with the known placeholders replaced.
+*/
+function fillTemplate(text, values) {
+	return text.replace(/\{(\w+)\}/g, (all, key) => Object.hasOwn(values, key) ? values[key] ?? all : all);
+}
+// src/registrySite/registryNames.ts
+/** `DataTableColumnHeader` → `data-table-column-header`, `floatingStyles` → `floating-styles`. */
+function toKebabCase(name) {
+	return name.replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/([A-Z])([A-Z][a-z])/g, "$1-$2").toLowerCase();
+}
+/** The `@/...` import path of a file inside a shadcn project. */
+function aliasFor(file) {
+	const withoutExtension = file.replace(/\.(tsx?|mjs|js)$/, "");
+	if (withoutExtension.startsWith("ui/")) return `@/components/${withoutExtension}`;
+	return `@/${withoutExtension}`;
+}
+/** Item name from a registry dependency URL: `https://x/r/button.json` → `button`. */
+function itemNameFromUrl(url) {
+	return /([^/]+)\.json$/.exec(url)?.[1] ?? url;
+}
+/**
+* The slash-terminated path a site is served from: `''` and `/` → `/`, `ui` → `/ui/`.
+*
+* @param path - A path such as `/ui/` or the `SITE_BASE_PATH` variable.
+* @returns A path that starts and ends with `/`.
+*/
+function normalizeSitePath(path) {
+	const trimmed = (path ?? "").trim().replace(/^\/+|\/+$/g, "");
+	return trimmed === "" ? "/" : `/${trimmed}/`;
+}
+/**
+* The `--base` the Ladle playground must be built with so that its assets load from where the
+* site serves it: `<site path>playground/`.
+*
+* @param sitePath - The path the site is served from (`/` locally, `/repo/` on GitHub Pages).
+* @returns For example `/playground/` or `/integr8-ui/playground/`.
+*/
+function playgroundBase(sitePath) {
+	return `${normalizeSitePath(sitePath)}playground/`;
+}
+// src/registrySite/sourceDocs.ts
+/**
+* Splits a raw doc comment into its summary and tags. Tags inside fenced code blocks are left
+* alone.
+*
+* @param raw - The comment text, from `/**` to the closing marker.
+* @returns The summary and the tags.
+*/
+function parseDocComment(raw) {
+	const lines = raw.replace(/^\/\*\*/, "").replace(/\*\/$/, "").replace(/\r/g, "").split("\n").map((line) => line.replace(/^\s*\*? ?/, ""));
+	const summary = [];
+	const tags = [];
+	let inFence = false;
+	for (const line of lines) {
+		if (/^\s*```/.test(line)) inFence = !inFence;
+		const match = inFence ? null : /^@(\w+)\s?(.*)$/.exec(line);
+		const last = tags.at(-1);
+		if (match) tags.push({
+			tag: match[1] ?? "",
+			text: match[2] ?? ""
+		});
+		else if (last) last.text += `\n${line}`;
+		else summary.push(line);
+	}
+	for (const tag of tags) tag.text = tag.text.trim();
+	return {
+		summary: summary.join("\n").trim(),
+		tags
+	};
+}
+/** The `/** ... *\/` comment right above a node, parsed. Empty when there is none. */
+function leadingDoc(node, sourceFile) {
+	const text = sourceFile.getFullText();
+	const last = (ts.getLeadingCommentRanges(text, node.getFullStart()) ?? []).filter((range) => text.startsWith("/**", range.pos)).at(-1);
+	if (!last) return {
+		summary: "",
+		tags: []
+	};
+	return parseDocComment(text.slice(last.pos, last.end));
+}
+/** Source text of a node with whitespace collapsed. */
+function textOf(node, sourceFile) {
+	return node ? node.getText(sourceFile).replace(/\s+/g, " ").trim() : "";
+}
+const tagsNamed = (doc, name) => doc.tags.filter((tag) => tag.tag === name).map((tag) => tag.text);
+const hasTag = (doc, name) => doc.tags.some((tag) => tag.tag === name);
+/** `@example` text as Markdown: wrapped in a tsx fence unless it already has one. */
+function exampleMarkdown(text) {
+	return text.includes("```") ? text : `\`\`\`tsx\n${text}\n\`\`\``;
+}
+/**
+* The default value of a documented member: `@default` / `@defaultValue`, else a
+* "Default `x`" phrase in the description.
+*
+* @param doc - The parsed comment of the member.
+* @returns The default as written, or `undefined`.
+*/
+function defaultFromDoc(doc) {
+	const tag = doc.tags.find((item) => item.tag === "default" || item.tag === "defaultValue");
+	if (tag) return tag.text.replace(/^`|`$/g, "").trim() || void 0;
+	return /\bdefault(?: is)?:?\s+(`[^`]+`|'[^']*'|"[^"]*"|-?\d[\d.]*\b)/i.exec(doc.summary)?.[1]?.replace(/^`|`$/g, "");
+}
+/** Props or fields of an interface or object type. */
+function membersOf(members, sourceFile) {
+	const result = [];
+	for (const member of members) {
+		if (!ts.isPropertySignature(member) && !ts.isMethodSignature(member)) continue;
+		const doc = leadingDoc(member, sourceFile);
+		if (hasTag(doc, "internal")) continue;
+		const type = ts.isMethodSignature(member) ? `(${member.parameters.map((p) => textOf(p, sourceFile)).join(", ")}) => ${textOf(member.type, sourceFile) || "void"}` : textOf(member.type, sourceFile) || "unknown";
+		result.push({
+			name: textOf(member.name, sourceFile),
+			type,
+			optional: Boolean(member.questionToken),
+			defaultValue: defaultFromDoc(doc),
+			description: doc.summary,
+			...hasTag(doc, "deprecated") ? { deprecated: true } : {}
+		});
+	}
+	return result;
+}
+/** Public properties of a class (not private, protected or `#private`). */
+function classMembersOf(node, sourceFile) {
+	const result = [];
+	for (const member of node.members) {
+		if (!ts.isPropertyDeclaration(member) || ts.isPrivateIdentifier(member.name)) continue;
+		const modifiers = ts.getModifiers(member) ?? [];
+		if (modifiers.some((m) => m.kind === ts.SyntaxKind.PrivateKeyword || m.kind === ts.SyntaxKind.ProtectedKeyword)) continue;
+		const doc = leadingDoc(member, sourceFile);
+		if (hasTag(doc, "internal")) continue;
+		const readonly = modifiers.some((m) => m.kind === ts.SyntaxKind.ReadonlyKeyword);
+		result.push({
+			name: `${readonly ? "readonly " : ""}${textOf(member.name, sourceFile)}`,
+			type: textOf(member.type, sourceFile) || "unknown",
+			optional: Boolean(member.questionToken),
+			description: doc.summary
+		});
+	}
+	return result;
+}
+function typeParametersOf(node, sourceFile) {
+	return node.typeParameters?.length ? `<${node.typeParameters.map((p) => textOf(p, sourceFile)).join(", ")}>` : "";
+}
+/** Kind of a function export from its name and return type. */
+function functionKind(name, returns, fileName) {
+	if (/^use[A-Z]/.test(name)) return "hook";
+	if (/^[A-Z]/.test(name) && (/JSX|ReactNode|Element/.test(returns) || fileName.endsWith(".tsx"))) return "component";
+	return "function";
+}
+/** Docs of a function declaration, arrow function, function expression or constructor. */
+function functionDoc(name, fn, doc, sourceFile) {
+	const paramTags = doc.tags.filter((tag) => tag.tag === "param");
+	const propDefaults = {};
+	const found = {};
+	const params = fn.parameters.map((param) => {
+		const paramName = !ts.isIdentifier(param.name) ? "props" : textOf(param.name, sourceFile);
+		if (ts.isObjectBindingPattern(param.name)) {
+			found.propsType = textOf(param.type, sourceFile) || void 0;
+			for (const element of param.name.elements) if (element.initializer && ts.isIdentifier(element.name)) propDefaults[element.name.text] = textOf(element.initializer, sourceFile);
+		}
+		const tag = paramTags.find((item) => item.text.split(/\s/)[0] === paramName);
+		return {
+			name: `${param.dotDotDotToken ? "..." : ""}${paramName}`,
+			type: textOf(param.type, sourceFile) || "unknown",
+			optional: Boolean(param.questionToken || param.initializer),
+			defaultValue: param.initializer ? textOf(param.initializer, sourceFile) : void 0,
+			description: tag ? tag.text.slice(paramName.length).replace(/^\s*-?\s*/, "") : ""
+		};
+	});
+	const returns = textOf(fn.type, sourceFile);
+	const paramList = params.map((p) => `${p.name}${p.optional && !p.defaultValue ? "?" : ""}: ${p.type}`).join(", ");
+	return {
+		kind: functionKind(name, returns, sourceFile.fileName),
+		signature: `${name}${typeParametersOf(fn, sourceFile)}(${paramList})${returns ? `: ${returns}` : ""}`,
+		params,
+		...returns ? { returns } : {},
+		...found.propsType ? { propsType: found.propsType } : {},
+		...Object.keys(propDefaults).length > 0 ? { propDefaults } : {}
+	};
+}
+/** Docs of a type alias: object types and intersections list their members. */
+function typeAliasDoc(name, node, sourceFile) {
+	const typeParams = typeParametersOf(node, sourceFile);
+	const type = node.type;
+	if (ts.isTypeLiteralNode(type)) return {
+		signature: `type ${name}${typeParams} = { … }`,
+		members: membersOf(type.members, sourceFile)
+	};
+	if (ts.isIntersectionTypeNode(type)) {
+		const literals = type.types.filter(ts.isTypeLiteralNode);
+		const others = type.types.filter((part) => !ts.isTypeLiteralNode(part));
+		if (literals.length > 0) return {
+			signature: `type ${name}${typeParams} = ${[...others.map((part) => textOf(part, sourceFile)), "{ … }"].join(" & ")}`,
+			members: literals.flatMap((literal) => membersOf(literal.members, sourceFile)),
+			extends: others.map((part) => textOf(part, sourceFile))
+		};
+	}
+	return { signature: `type ${name}${typeParams} = ${textOf(type, sourceFile)}` };
+}
+const isExported = (node) => ts.canHaveModifiers(node) && (ts.getModifiers(node) ?? []).some((m) => m.kind === ts.SyntaxKind.ExportKeyword) && !(ts.getModifiers(node) ?? []).some((m) => m.kind === ts.SyntaxKind.DefaultKeyword);
+function heritageOf(node, sourceFile) {
+	return (node.heritageClauses ?? []).flatMap((clause) => clause.types.map((type) => textOf(type, sourceFile)));
+}
+/**
+* The documentation of every exported declaration in a file, in source order. Components get
+* the defaults from their props destructuring copied onto their props type's members.
+*
+* @param fileName - Used for the parser (`.tsx` enables JSX).
+* @param content - The file's text.
+* @returns One entry per documented export.
+*/
+function extractDocs(fileName, content) {
+	const sourceFile = ts.createSourceFile(fileName, content, ts.ScriptTarget.Latest, true, fileName.endsWith(".tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
+	const docs = [];
+	const add = (name, doc, details) => {
+		if (hasTag(doc, "internal")) return;
+		const deprecated = doc.tags.find((tag) => tag.tag === "deprecated");
+		const remarks = tagsNamed(doc, "remarks");
+		const returnsDescription = [...tagsNamed(doc, "returns"), ...tagsNamed(doc, "return")][0];
+		docs.push({
+			name,
+			summary: [doc.summary, ...remarks].filter(Boolean).join("\n\n"),
+			examples: tagsNamed(doc, "example").map(exampleMarkdown),
+			throws: tagsNamed(doc, "throws"),
+			...deprecated ? { deprecated: deprecated.text || "Deprecated." } : {},
+			...returnsDescription ? { returnsDescription } : {},
+			...details
+		});
+	};
+	for (const statement of sourceFile.statements) {
+		if (!isExported(statement)) continue;
+		const doc = leadingDoc(statement, sourceFile);
+		if (ts.isFunctionDeclaration(statement) && statement.name) {
+			const name = statement.name.text;
+			add(name, doc, functionDoc(name, statement, doc, sourceFile));
+		} else if (ts.isVariableStatement(statement)) for (const declaration of statement.declarationList.declarations) {
+			if (!ts.isIdentifier(declaration.name)) continue;
+			const name = declaration.name.text;
+			const init = declaration.initializer;
+			if (init && (ts.isArrowFunction(init) || ts.isFunctionExpression(init))) {
+				add(name, doc, functionDoc(name, init, doc, sourceFile));
+				continue;
+			}
+			const type = textOf(declaration.type, sourceFile);
+			const initText = textOf(init, sourceFile);
+			add(name, doc, {
+				kind: "constant",
+				signature: `const ${name}${type ? `: ${type}` : initText && initText.length <= 80 ? ` = ${initText}` : ""}`
+			});
+		}
+		else if (ts.isInterfaceDeclaration(statement)) {
+			const name = statement.name.text;
+			const heritage = heritageOf(statement, sourceFile);
+			add(name, doc, {
+				kind: "interface",
+				signature: `interface ${name}${typeParametersOf(statement, sourceFile)}${heritage.length > 0 ? ` extends ${heritage.join(", ")}` : ""}`,
+				members: membersOf(statement.members, sourceFile),
+				...heritage.length > 0 ? { extends: heritage } : {}
+			});
+		} else if (ts.isTypeAliasDeclaration(statement)) {
+			const name = statement.name.text;
+			add(name, doc, {
+				kind: "type",
+				...typeAliasDoc(name, statement, sourceFile)
+			});
+		} else if (ts.isClassDeclaration(statement) && statement.name) {
+			const name = statement.name.text;
+			const heritage = heritageOf(statement, sourceFile);
+			const ctor = statement.members.find(ts.isConstructorDeclaration);
+			const params = ctor ? functionDoc(name, ctor, leadingDoc(ctor, sourceFile), sourceFile).params : [];
+			add(name, doc, {
+				kind: "class",
+				signature: `class ${name}${typeParametersOf(statement, sourceFile)}${heritage.length > 0 ? ` extends ${heritage.join(", ")}` : ""}`,
+				members: classMembersOf(statement, sourceFile),
+				...params.length > 0 ? { params } : {}
+			});
+		} else if (ts.isEnumDeclaration(statement)) {
+			const name = statement.name.text;
+			add(name, doc, {
+				kind: "enum",
+				signature: `enum ${name}`,
+				members: statement.members.map((member) => ({
+					name: textOf(member.name, sourceFile),
+					type: member.initializer ? textOf(member.initializer, sourceFile) : "",
+					optional: false,
+					description: leadingDoc(member, sourceFile).summary
+				}))
+			});
+		}
+	}
+	for (const doc of docs) {
+		if (!doc.propsType || !doc.propDefaults) continue;
+		const target = docs.find((other) => other.name === doc.propsType && other.members);
+		for (const member of target?.members ?? []) {
+			const fallback = doc.propDefaults[member.name];
+			if (member.defaultValue === void 0 && fallback !== void 0) member.defaultValue = fallback;
+		}
+	}
+	return docs;
+}
+// src/registrySite/itemPage.ts
+/** Kinds that can be imported as values (the rest are types). */
+const VALUE_KINDS = /* @__PURE__ */ new Set([
+	"component",
+	"hook",
+	"function",
+	"constant",
+	"class",
+	"enum"
+]);
+/** Anchor id of an export on its item page. */
+const apiAnchor = (name) => `api-${name}`;
+/**
+* Every documented export of an item, the main one first (the export whose kebab-case name is
+* the item name, for example `Button` for `button`), then in file and source order.
+*
+* @param item - A full registry item (with file contents).
+* @returns The exports with their docs.
+*/
+function itemDocs(item) {
+	const docs = (item.files ?? []).flatMap((file) => file.content && /\.(tsx?|mts)$/.test(file.path) ? extractDocs(file.path, file.content).map((doc) => ({
+		...doc,
+		file: file.path
+	})) : []);
+	const main = docs.findIndex((doc) => toKebabCase(doc.name) === item.name);
+	if (main > 0) docs.unshift(...docs.splice(main, 1));
+	return docs;
+}
+/** `<code>` of a type, linked when it names a documented export. */
+function typeCode(type, linkFor) {
+	const href = linkFor(type);
+	const html = `<code>${escapeHtml(type)}</code>`;
+	return href ? `<a href="${escapeHtml(href)}">${html}</a>` : html;
+}
+/** A props, parameters or members table. */
+function membersTable(caption, rows, linkFor) {
+	const body = rows.map((row) => `<tr>
+                <td><code>${escapeHtml(row.name)}${row.optional && !row.name.startsWith("...") ? "?" : ""}</code>${row.deprecated ? " <span class=\"tag deprecated\">deprecated</span>" : ""}</td>
+                <td>${row.type ? typeCode(row.type, linkFor) : "<span class=\"muted\">—</span>"}</td>
+                <td>${row.defaultValue !== void 0 ? `<code>${escapeHtml(row.defaultValue)}</code>` : "<span class=\"muted\">—</span>"}</td>
+                <td>${row.description ? inlineMarkdown(row.description.replace(/\s*\n\s*/g, " "), { linkFor }) : ""}</td>
+              </tr>`).join("\n              ");
+	return `<h4>${escapeHtml(caption)}</h4>
+            <div class="table-wrap">
+              <table>
+                <thead><tr><th scope="col">Name</th><th scope="col">Type</th><th scope="col">Default</th><th scope="col">Description</th></tr></thead>
+                <tbody>
+              ${body}
+                </tbody>
+              </table>
+            </div>`;
+}
+/** One export in the API reference. */
+function apiEntry(doc, linkFor) {
+	const markdown = (text) => renderMarkdown(text, { linkFor });
+	const parts = [];
+	if (doc.deprecated) parts.push(`<div class="prose"><p><strong>Deprecated.</strong></p>${markdown(doc.deprecated)}</div>`);
+	if (doc.summary) parts.push(`<div class="prose">${markdown(doc.summary)}</div>`);
+	parts.push(`<pre class="sig"><code>${escapeHtml(doc.signature)}</code></pre>`);
+	if (doc.extends?.length) parts.push(`<h4>Also accepts</h4>
+            <p>${doc.extends.map((type) => typeCode(type, linkFor)).join(", ")}</p>`);
+	if (doc.params?.length && doc.kind !== "interface" && doc.kind !== "type") parts.push(membersTable(doc.kind === "class" ? "Constructor" : "Parameters", doc.params, linkFor));
+	if (doc.members?.length) {
+		const caption = doc.kind === "enum" ? "Members" : /Props$/.test(doc.name) ? "Props" : "Properties";
+		parts.push(membersTable(caption, doc.members, linkFor));
+	}
+	if (doc.returnsDescription || doc.returns && doc.kind !== "component") parts.push(`<h4>Returns</h4>
+            <p>${doc.returns ? typeCode(doc.returns, linkFor) : ""} ${doc.returnsDescription ? inlineMarkdown(doc.returnsDescription, { linkFor }) : ""}</p>`);
+	if (doc.throws.length > 0) parts.push(`<h4>Throws</h4>\n            <div class="prose">${doc.throws.map(markdown).join("\n")}</div>`);
+	for (const example of doc.examples) parts.push(`<h4>Example</h4>\n            ${markdown(example)}`);
+	const anchor = escapeHtml(apiAnchor(doc.name));
+	return `<section class="api" id="${anchor}" aria-labelledby="${anchor}-title">
+            <div class="api-head">
+              <h3 id="${anchor}-title">${escapeHtml(doc.name)}</h3>
+              <span class="tag">${escapeHtml(doc.kind)}</span>
+              ${doc.deprecated ? "<span class=\"tag deprecated\">deprecated</span>" : ""}
+            </div>
+            ${parts.join("\n            ")}
+          </section>`;
+}
+/**
+* A shadcn item's `css` object as CSS text: selectors and at-rules become blocks, strings
+* become declarations, empty objects become block-less at-rules (`@import "x";`).
+*
+* @param css - The item's `css` object.
+* @param indent - Indentation of the first level.
+* @returns CSS text.
+*/
+function cssToText(css, indent = "") {
+	return Object.entries(css).map(([key, value]) => {
+		if (typeof value === "string") return `${indent}${key}: ${value};`;
+		const nested = value ?? {};
+		if (Object.keys(nested).length === 0) return `${indent}${key};`;
+		return `${indent}${key} {\n${cssToText(nested, `${indent}  `)}\n${indent}}`;
+	}).join("\n");
+}
+/**
+* Import lines for the value exports of each file:
+* `import { Button } from '@/components/ui/button';`.
+*
+* @param docs - The exports of an item, from {@link itemDocs}.
+* @returns One line per file.
+*/
+function importLines(docs) {
+	const byFile = /* @__PURE__ */ new Map();
+	for (const doc of docs) {
+		if (!VALUE_KINDS.has(doc.kind)) continue;
+		const names = byFile.get(doc.file) ?? [];
+		names.push(doc.name);
+		byFile.set(doc.file, names);
+	}
+	return [...byFile.entries()].map(([file, names]) => `import { ${names.join(", ")} } from '${aliasFor(file)}';`);
+}
+/**
+* How a registry dependency is shown: a link to this site's page when the item belongs to this
+* registry, a link to the ui site (marked "ui") when it is a ui item, plain code otherwise.
+*
+* @param name - The dependency's item name.
+* @param known - Names of the items of this registry.
+* @param pageOf - Relative URL of an item page of this site.
+* @param uiDocsUrl - Where the ui item pages are (ends with `/`), when the registry uses ui.
+* @returns HTML.
+*/
+function dependencyLink(name, known, pageOf, uiDocsUrl) {
+	const label = `<code>${escapeHtml(name)}</code>`;
+	if (known.has(name)) return `<a href="${escapeHtml(pageOf(name))}">${label}</a>`;
+	return uiDocsUrl ? `<a href="${escapeHtml(`${uiDocsUrl}${name}/`)}">${label}</a> <span class="muted">(ui)</span>` : label;
+}
+const ITEM_SCRIPT = `
+    (function () {
+      // Sidebar: open on wide screens, with the current item in view.
+      var nav = document.querySelector('.side-nav');
+      if (nav && window.matchMedia('(min-width: 64rem)').matches) {
+        nav.open = true;
+        var current = nav.querySelector('[aria-current="page"]');
+        var sidebar = document.querySelector('.sidebar');
+        if (current && sidebar) sidebar.scrollTop = current.offsetTop - sidebar.clientHeight / 3;
+      }
+
+      // Live preview: switch story and theme.
+      var preview = document.getElementById('preview');
+      if (!preview) return;
+      var base = preview.getAttribute('data-playground');
+      var story = preview.getAttribute('data-story');
+      var theme = preview.getAttribute('data-default-theme') || '';
+      var select = document.getElementById('story-select');
+      var frame = document.getElementById('story-frame');
+      var themeButtons = Array.prototype.slice.call(preview.querySelectorAll('[data-theme]'));
+      function show() {
+        frame.src = base + '?story=' + encodeURIComponent(story) + (theme ? '&integr8Theme=' + encodeURIComponent(theme) : '') + '&mode=preview&integr8Embed=1';
+      }
+      if (select) select.addEventListener('change', function () { story = select.value; show(); });
+      themeButtons.forEach(function (button) {
+        button.addEventListener('click', function () {
+          theme = button.getAttribute('data-theme');
+          themeButtons.forEach(function (other) {
+            other.setAttribute('aria-pressed', String(other === button));
+          });
+          show();
+        });
+      });
+    })();
+`;
+/**
+* Renders the documentation page of one registry item.
+*
+* @param page - The item, its stories and the items that use it.
+* @param site - Config, URLs, the item list and the optional playground and fonts.
+* @returns The full HTML document.
+*/
+function renderItemPage(page, site) {
+	const { item } = page;
+	const { config } = site;
+	const { brand, ui } = config;
+	const stories = page.stories ?? [];
+	const usedBy = page.usedBy ?? [];
+	const docsPath = site.docsPath ?? "components/";
+	const root = "../".repeat(docsPath.split("/").filter(Boolean).length + 1);
+	const pageOf = (name) => `${root}${docsPath}${name}/`;
+	const title = item.title ?? item.name;
+	const install = `npx shadcn@latest add ${site.baseUrl}/${item.name}.json`;
+	const known = new Set(site.order.map((other) => other.name));
+	const hasThemes = config.previewThemes.length > 0;
+	const firstTheme = config.previewThemes[0]?.[0];
+	const linkFor = (name) => {
+		const owner = site.exportOwners.get(name);
+		if (!owner) return null;
+		return owner === item.name ? `#${apiAnchor(name)}` : `${pageOf(owner)}#${apiAnchor(name)}`;
+	};
+	const docs = itemDocs(item);
+	const group = site.groups.find((candidate) => candidate.items.some((other) => other.name === item.name));
+	const sidebar = site.groups.map((candidate) => `<h2>${escapeHtml(candidate.label)}</h2>
+          <ul>
+            ${candidate.items.map((other) => `<li><a href="${escapeHtml(pageOf(other.name))}"${other.name === item.name ? " aria-current=\"page\"" : ""}>${escapeHtml(other.title ?? other.name)}</a></li>`).join("\n            ")}
+          </ul>`).join("\n          ");
+	const toc = [];
+	let preview = "";
+	const first = stories[0];
+	if (site.playgroundPath && first) {
+		toc.push(["preview", "Preview"]);
+		const playground = root + site.playgroundPath;
+		const select = stories.length > 1 ? `<label class="field">
+                <span class="sr-only">Story</span>
+                <select id="story-select">
+                  ${stories.map((story) => `<option value="${escapeHtml(story.id)}">${escapeHtml(story.name)}</option>`).join("\n                  ")}
+                </select>
+              </label>` : "";
+		preview = `<section id="preview" class="doc-section" aria-labelledby="preview-title" data-playground="${escapeHtml(playground)}" data-story="${escapeHtml(first.id)}" data-default-theme="${escapeHtml(firstTheme ?? "")}">
+          <h2 id="preview-title">Preview</h2>
+          <div class="viewer">
+            <div class="viewer-bar">
+              ${select}
+              ${themeButtons(config.previewThemes, "                ")}
+              <button type="button" class="pill-sm ghost open-full" data-expand aria-pressed="false">Full screen</button>
+            </div>
+            <iframe id="story-frame" title="${escapeHtml(title)} preview" src="${escapeHtml(storyUrl(playground, first.id, hasThemes ? firstTheme : void 0))}" loading="lazy"></iframe>
+          </div>
+        </section>`;
+	}
+	toc.push(["installation", "Installation"]);
+	const facts = [];
+	if (item.dependencies?.length) facts.push(`<li><strong>npm packages</strong>${item.dependencies.map((dep) => `<code>${escapeHtml(dep)}</code>`).join(" ")}</li>`);
+	if (item.registryDependencies?.length) facts.push(`<li><strong>Also adds</strong>${item.registryDependencies.map(itemNameFromUrl).map((name) => dependencyLink(name, known, pageOf, ui?.docsUrl)).join(" ")}</li>`);
+	if (item.files?.length) facts.push(`<li><strong>Files</strong>${item.files.map((file) => `<code>${escapeHtml(file.target ?? file.path)}</code>`).join(" ")}</li>`);
+	const note = config.themeNote;
+	let themeNote = "";
+	if (note && !note.skip.includes(item.name)) themeNote = note.external ? `<p>Uses the Integr8 theme tokens: add the <a href="${escapeHtml(ui ? `${ui.docsUrl}${note.item}/` : "")}">ui theme</a> once per project first (<code>npx shadcn@latest add ${escapeHtml(ui?.registryUrl ?? "")}/${escapeHtml(note.item)}.json</code>).</p>` : item.name === note.item ? "" : `<p>Uses the theme tokens: add <a href="${escapeHtml(pageOf(note.item))}">${escapeHtml(note.item)}</a> once per project first.</p>`;
+	const installation = `<section id="installation" class="doc-section" aria-labelledby="installation-title">
+          <h2 id="installation-title">Installation</h2>
+          ${themeNote}
+          ${commandBlock(install, `Copy the install command for ${item.name}`)}
+          ${facts.length > 0 ? `<ul class="facts">\n            ${facts.join("\n            ")}\n          </ul>` : ""}
+        </section>`;
+	const imports = importLines(docs);
+	const mainExamples = docs.find((doc) => doc.examples.length > 0)?.examples ?? [];
+	let usage = "";
+	if (imports.length > 0 || mainExamples.length > 0) {
+		toc.push(["usage", "Usage"]);
+		usage = `<section id="usage" class="doc-section" aria-labelledby="usage-title">
+          <h2 id="usage-title">Usage</h2>
+          ${imports.length > 0 ? codeBlock(imports.join("\n"), "Copy the import") : ""}
+          ${mainExamples.map((example) => renderMarkdown(example, { linkFor })).join("\n          ")}
+        </section>`;
+	}
+	let styles = "";
+	if (item.cssVars || item.css) {
+		toc.push(["styles", "Styles"]);
+		const light = item.cssVars?.light ?? {};
+		const dark = item.cssVars?.dark ?? {};
+		const tokens = [.../* @__PURE__ */ new Set([...Object.keys(light), ...Object.keys(dark)])];
+		const swatch = (value) => value === void 0 ? "<span class=\"muted\">—</span>" : `<code>${escapeHtml(value)}</code>`;
+		const tokenTable = tokens.length > 0 ? `<h3 class="sr-only">Tokens</h3>
+          <div class="table-wrap">
+            <table>
+              <thead><tr><th scope="col">Token</th><th scope="col">Light (<code>:root</code>)</th><th scope="col">Dark (<code>.dark</code>)</th></tr></thead>
+              <tbody>
+              ${tokens.map((token) => `<tr><td><code>--${escapeHtml(token)}</code></td><td>${swatch(light[token])}</td><td>${swatch(dark[token])}</td></tr>`).join("\n              ")}
+              </tbody>
+            </table>
+          </div>` : "";
+		const cssText = item.css ? cssToText(item.css) : "";
+		styles = `<section id="styles" class="doc-section" aria-labelledby="styles-title">
+          <h2 id="styles-title">Styles</h2>
+          <p>What <code>shadcn add</code> writes into your CSS file${tokens.length > 0 ? ": the theme tokens below, plus the rules for the other themes and the Integr8 extras" : ""}.</p>
+          ${tokenTable}
+          ${cssText ? `<details class="source"><summary>View the CSS</summary>${codeBlock(cssText, "Copy the CSS", "CSS")}</details>` : ""}
+        </section>`;
+	}
+	const hasCode = (item.files ?? []).some((file) => typeof file.content === "string");
+	if (hasCode) toc.push(["api", "API reference"]);
+	const api = !hasCode ? "" : `<section id="api" class="doc-section" aria-labelledby="api-title">
+          <h2 id="api-title">API reference</h2>
+          ${docs.length > 0 ? docs.map((doc) => apiEntry(doc, linkFor)).join("\n          ") : "<p>This item has no public API of its own: other components use it. See the source below.</p>"}
+        </section>`;
+	const sourceFiles = (item.files ?? []).filter((file) => typeof file.content === "string");
+	let source = "";
+	if (sourceFiles.length > 0) {
+		toc.push(["source", "Source"]);
+		source = `<section id="source" class="doc-section" aria-labelledby="source-title">
+          <h2 id="source-title">Source</h2>
+          <p>The code <code>shadcn add</code> copies into your project. It's yours to change.</p>
+          <details class="source">
+            <summary>View the source (${sourceFiles.length} ${sourceFiles.length === 1 ? "file" : "files"})</summary>
+            ${sourceFiles.map((file) => codeBlock(file.content, `Copy ${file.target ?? file.path}`, file.target ?? file.path)).join("\n            ")}
+          </details>
+        </section>`;
+	}
+	const usedBySection = usedBy.length > 0 ? `<section id="used-by" class="doc-section" aria-labelledby="used-by-title">
+          <h2 id="used-by-title">Used by</h2>
+          <div class="chips">
+            ${usedBy.map((name) => `<a class="chip" href="${escapeHtml(pageOf(name))}">${escapeHtml(name)}</a>`).join("\n            ")}
+          </div>
+        </section>` : "";
+	const position = site.order.findIndex((other) => other.name === item.name);
+	const previous = position > 0 ? site.order[position - 1] : void 0;
+	const next = position >= 0 ? site.order[position + 1] : void 0;
+	const pager = `<nav class="pager" aria-label="Previous and next item">
+          ${previous ? `<a href="${escapeHtml(pageOf(previous.name))}"><span>Previous</span>${escapeHtml(previous.title ?? previous.name)}</a>` : "<span></span>"}
+          ${next ? `<a class="next" href="${escapeHtml(pageOf(next.name))}"><span>Next</span>${escapeHtml(next.title ?? next.name)}</a>` : ""}
+        </nav>`;
+	const body = `<main id="main">
+    <div class="wrap docs">
+      <aside class="sidebar">
+        <details class="side-nav">
+          <summary>Browse all items</summary>
+          <nav aria-label="Registry items">
+          ${sidebar}
+          </nav>
+        </details>
+      </aside>
+      <article class="doc">
+        <nav class="crumbs" aria-label="Breadcrumb">
+          <a href="${escapeHtml(root)}#components">Registry</a><span aria-hidden="true">/</span>
+          <span>${escapeHtml(group?.label ?? "Other")}</span>
+        </nav>
+        <header class="doc-head">
+          <div class="tags">
+            <span class="tag">${escapeHtml(typeLabel(item.type))}</span>
+            <span class="tag">${escapeHtml(item.name)}</span>
+          </div>
+          <h1>${escapeHtml(title)}</h1>
+          ${item.description ? `<p class="lead">${inlineMarkdown(item.description, { linkFor })}</p>` : ""}
+          ${commandBlock(install, `Copy the install command for ${item.name}`)}
+          <nav class="toc" aria-label="On this page">
+            ${toc.map(([id, label]) => `<a href="#${id}">${label}</a>`).join("\n            ")}
+          </nav>
+        </header>
+        ${preview}
+        ${installation}
+        ${usage}
+        ${styles}
+        ${api}
+        ${source}
+        ${usedBySection}
+        ${pager}
+      </article>
+    </div>
+  </main>`;
+	return renderShell({
+		title: `${title} · ${brand.name}`,
+		description: item.description ?? `${title}: a ${brand.name} registry item.`,
+		brand,
+		root,
+		fontsHref: site.fontsHref,
+		repositoryUrl: brand.repositoryUrl,
+		...brand.playgroundLink && site.playgroundPath ? { playgroundHref: site.playgroundPath } : {},
+		footerNote: site.config.brand.footer.replaceAll("{packageName}", site.registryName).replaceAll("{version}", site.version),
+		body,
+		script: ITEM_SCRIPT
+	});
+}
+// src/registrySite/landingPage.ts
+const LANDING_SCRIPT = `
+    (function () {
+      // Search and group filters
+      var search = document.getElementById('search');
+      var groups = Array.prototype.slice.call(document.querySelectorAll('.group'));
+      var filterButtons = Array.prototype.slice.call(document.querySelectorAll('[data-filter]'));
+      var count = document.getElementById('result-count');
+      var empty = document.getElementById('no-results');
+      var filter = 'all';
+      function apply() {
+        var query = search.value.trim().toLowerCase();
+        var shown = 0;
+        groups.forEach(function (group) {
+          var inFilter = filter === 'all' || group.getAttribute('data-group') === filter;
+          var visible = 0;
+          group.querySelectorAll('.card').forEach(function (card) {
+            var match = inFilter && (!query || card.getAttribute('data-search').indexOf(query) !== -1);
+            card.hidden = !match;
+            if (match) visible++;
+          });
+          group.hidden = visible === 0;
+          shown += visible;
+        });
+        empty.hidden = shown !== 0;
+        count.textContent = shown + (shown === 1 ? ' item' : ' items') + ' shown.';
+      }
+      search.addEventListener('input', apply);
+      filterButtons.forEach(function (button) {
+        button.addEventListener('click', function () {
+          filter = button.getAttribute('data-filter');
+          filterButtons.forEach(function (other) {
+            other.setAttribute('aria-pressed', String(other === button));
+          });
+          apply();
+        });
+      });
+
+      // Live preview from the Ladle playground
+      var preview = document.getElementById('preview');
+      if (!preview) return;
+      var base = preview.getAttribute('data-playground');
+      var select = document.getElementById('story-select');
+      var frame = document.getElementById('story-frame');
+      var themeButtons = Array.prototype.slice.call(preview.querySelectorAll('[data-theme]'));
+      var theme = preview.getAttribute('data-default-theme') || '';
+      function storyUrl(id) {
+        return base + '?story=' + encodeURIComponent(id) + (theme ? '&integr8Theme=' + encodeURIComponent(theme) : '') + '&mode=preview&integr8Embed=1';
+      }
+      function show(id) {
+        if (!id) return;
+        select.value = id;
+        frame.src = storyUrl(id);
+      }
+      themeButtons.forEach(function (button) {
+        button.addEventListener('click', function () {
+          theme = button.getAttribute('data-theme');
+          themeButtons.forEach(function (other) {
+            other.setAttribute('aria-pressed', String(other === button));
+          });
+          show(select.value);
+        });
+      });
+      select.addEventListener('change', function () { show(select.value); });
+
+      fetch(base + 'meta.json')
+        .then(function (response) {
+          if (!response.ok) throw new Error(response.statusText);
+          return response.json();
+        })
+        .then(function (meta) {
+          var stories = meta.stories || {};
+          var ids = Object.keys(stories);
+          if (ids.length === 0) throw new Error('No stories');
+          select.textContent = '';
+          var byGroup = {};
+          ids.forEach(function (id) {
+            var story = stories[id];
+            var level = (story.levels && story.levels[0]) || 'Stories';
+            if (!byGroup[level]) {
+              byGroup[level] = document.createElement('optgroup');
+              byGroup[level].label = level;
+              select.appendChild(byGroup[level]);
+            }
+            var option = document.createElement('option');
+            option.value = id;
+            option.textContent = (story.levels || []).slice(1).concat(story.name).join(' / ');
+            byGroup[level].appendChild(option);
+          });
+          select.disabled = false;
+
+          // Each item's story id is set at build time (data-story); keep only the known ones.
+          document.querySelectorAll('[data-story]').forEach(function (button) {
+            var id = button.getAttribute('data-story');
+            if (!stories[id]) return;
+            button.hidden = false;
+            button.addEventListener('click', function () {
+              show(id);
+              preview.scrollIntoView();
+              frame.focus();
+            });
+          });
+          var first = preview.getAttribute('data-default-story');
+          show(stories[first] ? first : ids[0]);
+        })
+        .catch(function () {
+          select.closest('.viewer-bar').hidden = true;
+          frame.hidden = true;
+          document.getElementById('preview-error').hidden = false;
+        });
+    })();
+`;
+const NUMBER_WORDS = [
+	"One",
+	"Two",
+	"Three",
+	"Four",
+	"Five",
+	"Six",
+	"Seven",
+	"Eight",
+	"Nine"
+];
+/**
+* Renders the landing page.
+*
+* @param index - The registry index (`registry.json`).
+* @param options - Config, URLs and the optional playground, fonts and item pages.
+* @returns The full HTML document.
+*/
+function renderRegistryPage(index, options) {
+	const { config, baseUrl, version, playgroundPath, docsPath } = options;
+	const { brand, ui } = config;
+	const previewStories = options.previewStories ?? {};
+	const url = (name) => `${baseUrl}/${name}.json`;
+	const add = (name) => `npx shadcn@latest add ${url(name)}`;
+	const docsHref = (name) => docsPath ? `${docsPath}${name}/` : null;
+	const componentCount = index.items.filter((item) => item.type === "registry:ui").length;
+	const groups = groupItems(index.items, config.categories);
+	const hasThemes = config.previewThemes.length > 0;
+	const firstItem = (index.items.find((item) => item.type === "registry:ui") ?? index.items[0])?.name;
+	const values = {
+		registryUrl: baseUrl,
+		uiRegistryUrl: ui?.registryUrl ?? "",
+		version,
+		packageName: index.name
+	};
+	const fill = (text) => fillTemplate(text, values);
+	const steps = config.setup.steps ?? [
+		{
+			title: "Set up shadcn",
+			text: "Skip this if your project already has a `components.json`.",
+			command: "npx shadcn@latest init"
+		},
+		...ui ? [{
+			title: "Add the theme",
+			text: "Once per project: the Integr8 theme tokens from the ui registry.",
+			command: `npx shadcn@latest add ${ui.registryUrl}/theme.json`
+		}] : [],
+		...firstItem ? [{
+			title: "Add items",
+			text: "Each one brings the parts it needs. The code is yours to change.",
+			command: add(firstItem)
+		}] : []
+	];
+	const heroCommand = brand.heroCommand ?? steps.at(-1)?.command;
+	const registries = ui ? {
+		"@integr8": `${ui.registryUrl}/{name}.json`,
+		[config.setup.namespace]: `${baseUrl}/{name}.json`
+	} : { [config.setup.namespace]: `${baseUrl}/{name}.json` };
+	const extras = [...config.setup.shortNames ? [{
+		title: "Shorter names",
+		text: `Add the registry to \`components.json\`, then run \`npx shadcn@latest add ${config.setup.namespace}/${firstItem ?? "item"}\`.`,
+		code: JSON.stringify({ registries }, null, 2)
+	}] : [], ...config.setup.extras];
+	const stepItems = steps.map((step) => `<li class="step">
+            <h3>${escapeHtml(step.title)}</h3>
+            ${step.text ? `<p>${inlineMarkdown(fill(step.text))}</p>` : ""}
+            ${commandBlock(fill(step.command), `Copy the command: ${step.title}`)}
+          </li>`).join("\n          ");
+	const extraItems = extras.map((extra) => `<div class="extra">
+            <h3>${escapeHtml(extra.title)}</h3>
+            ${extra.text ? `<p>${inlineMarkdown(fill(extra.text))}</p>` : ""}
+            ${codeBlock(fill(extra.code), `Copy the example: ${extra.title}`, extra.caption)}
+          </div>`).join("\n          ");
+	const filters = groups.map((group) => `<button type="button" class="chip" data-filter="${escapeHtml(group.id)}" aria-pressed="false">${escapeHtml(group.label)} <span>${group.items.length}</span></button>`).join("\n          ");
+	const sections = groups.map((group) => {
+		const cards = group.items.map((item) => {
+			const search = [
+				item.name,
+				item.title,
+				item.description,
+				group.label
+			].filter(Boolean).join(" ").toLowerCase();
+			const title = escapeHtml(item.title ?? item.name);
+			const href = docsHref(item.name);
+			const previewStory = previewStories[item.name];
+			return `<li class="card" data-name="${escapeHtml(item.name)}" data-search="${escapeHtml(search)}">
+              <div class="card-head">
+                <h4>${href ? `<a href="${escapeHtml(href)}">${title}</a>` : title}</h4>
+                <span class="tag">${escapeHtml(typeLabel(item.type))}</span>
+              </div>
+              <p>${escapeHtml(item.description ?? "")}</p>
+              <div class="card-actions">
+                <button type="button" class="copy pill-sm" data-copy="${escapeHtml(add(item.name))}" aria-label="Copy the install command for ${escapeHtml(item.name)}">Copy install</button>
+                ${href ? `<a class="pill-sm ghost" href="${escapeHtml(href)}" aria-label="Documentation for ${escapeHtml(item.name)}">Docs</a>` : ""}
+                ${previewStory ? `<button type="button" class="preview pill-sm ghost" data-story="${escapeHtml(previewStory)}" hidden>Preview</button>` : ""}
+                ${href ? "" : `<a class="pill-sm ghost" href="${escapeHtml(url(item.name))}">JSON</a>`}
+              </div>
+            </li>`;
+		}).join("\n            ");
+		return `<section class="group" data-group="${escapeHtml(group.id)}" aria-labelledby="group-${escapeHtml(group.id)}">
+          <h3 id="group-${escapeHtml(group.id)}">${escapeHtml(group.label)}</h3>
+          <ul class="cards">
+            ${cards}
+          </ul>
+        </section>`;
+	}).join("\n        ");
+	const previewLead = config.copy.previewLead ?? `Every item runs live from the Ladle playground. Pick a story${hasThemes ? " and a theme" : ""}.`;
+	const previewSection = playgroundPath ? `<section id="preview" class="section" aria-labelledby="preview-title" data-playground="${escapeHtml(playgroundPath)}" data-default-story="${escapeHtml(options.defaultStory ?? "")}" data-default-theme="${escapeHtml(config.previewThemes[0]?.[0] ?? "")}">
+      <div class="wrap">
+        <div class="section-head">
+          <p class="eyebrow">Live</p>
+          <h2 id="preview-title">See it <span class="gradient">before you copy it.</span></h2>
+          <p class="lead">${escapeHtml(previewLead)}</p>
+        </div>
+        <div class="viewer">
+          <div class="viewer-bar">
+            <label class="field">
+              <span class="sr-only">Story</span>
+              <select id="story-select" disabled>
+                <option>Loading stories…</option>
+              </select>
+            </label>
+            ${themeButtons(config.previewThemes, "              ")}
+            <button type="button" class="pill-sm ghost open-full" data-expand aria-pressed="false">Full screen</button>
+          </div>
+          <iframe id="story-frame" title="Component preview" loading="lazy"></iframe>
+          <p id="preview-error" class="note" hidden>The preview could not be loaded. Try again later.</p>
+        </div>
+      </div>
+    </section>` : "";
+	const stats = [
+		{
+			value: String(componentCount),
+			label: "components"
+		},
+		...brand.extraStats,
+		{
+			value: String(index.items.length),
+			label: "registry items"
+		}
+	].map((stat) => `<li><strong>${escapeHtml(stat.value)}</strong><span>${escapeHtml(stat.label)}</span></li>`).join("\n          ");
+	const stepCount = steps.length;
+	const startTitle = config.setup.title ?? `${NUMBER_WORDS[stepCount - 1] ?? String(stepCount)} commands to`;
+	const body = `<main id="main">
+    <section class="hero">
+      <div class="glow" aria-hidden="true"></div>
+      <div class="wrap">
+        <p class="eyebrow">${escapeHtml(brand.eyebrow)} · v${escapeHtml(version)}</p>
+        <h1>${escapeHtml(brand.heroTitle)}${brand.heroAccent ? ` <span class="gradient">${escapeHtml(brand.heroAccent)}</span>` : ""}</h1>
+        ${brand.lead ? `<p class="lead">${escapeHtml(brand.lead)}</p>` : ""}
+        <div class="cta">
+          <a class="btn primary" href="#start">Get started</a>
+          <a class="btn ghost" href="#components">Browse components</a>
+        </div>
+        ${heroCommand ? commandBlock(fill(heroCommand), "Copy the install command") : ""}
+        <ul class="stats">
+          ${stats}
+        </ul>
+      </div>
+    </section>
+
+    <section id="start" class="section" aria-labelledby="start-title">
+      <div class="wrap">
+        <div class="section-head">
+          <p class="eyebrow">Get started</p>
+          <h2 id="start-title">${escapeHtml(startTitle)} <span class="gradient">${escapeHtml(config.setup.accent)}</span></h2>
+          <p class="lead">${escapeHtml(fill(config.setup.lead))}</p>
+        </div>
+        <ol class="steps">
+          ${stepItems}
+        </ol>
+        ${extras.length > 0 ? `<div class="extras">\n          ${extraItems}\n        </div>` : ""}
+      </div>
+    </section>
+
+    ${previewSection}
+
+    <section id="components" class="section" aria-labelledby="components-title">
+      <div class="wrap">
+        <div class="section-head">
+          <p class="eyebrow">Registry</p>
+          <h2 id="components-title">Everything in <span class="gradient">the kit.</span></h2>
+          <p class="lead">${escapeHtml(config.copy.componentsLead)}</p>
+        </div>
+        <div class="toolbar">
+          <label class="search">
+            <span class="sr-only">Search components</span>
+            <input id="search" type="search" placeholder="Search ${index.items.length} items…" autocomplete="off">
+          </label>
+          <div class="chips" role="group" aria-label="Filter by group">
+          <button type="button" class="chip" data-filter="all" aria-pressed="true">All <span>${index.items.length}</span></button>
+          ${filters}
+          </div>
+          <p id="result-count" class="sr-only" aria-live="polite"></p>
+        </div>
+        ${sections}
+        <p id="no-results" class="empty" hidden>No items match your search.</p>
+      </div>
+    </section>
+  </main>`;
+	return renderShell({
+		title: brand.title,
+		description: brand.description,
+		brand,
+		root: "",
+		fontsHref: options.fontsHref,
+		repositoryUrl: brand.repositoryUrl,
+		...brand.playgroundLink && playgroundPath ? { playgroundHref: playgroundPath } : {},
+		footerNote: fillTemplate(brand.footer, values),
+		body,
+		script: LANDING_SCRIPT
+	});
+}
+// src/registrySite/registrySiteError.ts
+/**
+* Thrown while building the registry site, for problems with the repo's files rather than with
+* the options (those are a `ConfigError` with code `INVALID_OPTION`).
+*
+* @example
+* ```ts
+* try {
+*   await buildRegistrySite();
+* } catch (error) {
+*   if (error instanceof RegistrySiteError && error.code === 'REGISTRY_NOT_BUILT') {
+*     // run the registry build first
+*   }
+* }
+* ```
+*/
+var RegistrySiteError = class extends Error {
+	/** Always `'RegistrySiteError'`. */
+	name = "RegistrySiteError";
+	/** Machine-readable reason for the error. */
+	code;
+	/**
+	* @param code - Machine-readable reason for the error.
+	* @param message - Human-readable description.
+	* @param options - Standard error options, such as `cause`.
+	*/
+	constructor(code, message, options) {
+		super(message, options);
+		this.code = code;
+	}
+};
+// src/registrySite/siteConfig.ts
+const TOP_LEVEL_KEYS = [
+	"brand",
+	"categories",
+	"stories",
+	"defaultStory",
+	"ui",
+	"fonts",
+	"setup",
+	"copy",
+	"previewThemes",
+	"themeNote",
+	"bundleSizes",
+	"commands",
+	"registryUrl",
+	"playground"
+];
+const BRAND_KEYS = [
+	"name",
+	"slug",
+	"mark",
+	"eyebrow",
+	"heroTitle",
+	"heroAccent",
+	"lead",
+	"title",
+	"description",
+	"footer",
+	"repositoryUrl",
+	"playgroundLink",
+	"extraStats",
+	"heroCommand"
+];
+const SETUP_KEYS = [
+	"title",
+	"accent",
+	"lead",
+	"steps",
+	"extras",
+	"namespace",
+	"shortNames"
+];
+const UI_KEYS = [
+	"registryUrl",
+	"docsUrl",
+	"packageName"
+];
+const COPY_KEYS = ["previewLead", "componentsLead"];
+const BUNDLE_KEYS = [
+	"entry",
+	"ownCodeLabel",
+	"external"
+];
+const COMMAND_KEYS = ["assets", "registry"];
+const THEME_NOTE_KEYS = ["item", "skip"];
+function fail(path, expectation, value) {
+	const got = value === void 0 ? "" : `; got ${describe(value)}`;
+	throw new ConfigError("INVALID_OPTION", `registry-site config: "${path}" ${expectation}${got}.`);
+}
+function describe(value) {
+	if (typeof value === "string") return JSON.stringify(value);
+	if (typeof value === "function") return "a function";
+	if (Array.isArray(value)) return "an array";
+	return String(value);
+}
+function isPlain(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function plain(value, path) {
+	if (!isPlain(value)) fail(path, "must be an object", value);
+	return value;
+}
+function noUnknownKeys(value, known, path) {
+	for (const key of Object.keys(value)) if (!known.includes(key)) fail(path === "config" ? key : `${path}.${key}`, `is not an option (known options: ${known.join(", ")})`);
+}
+function optionalString(parent, key, path, allowEmpty = false) {
+	const value = parent[key];
+	if (value === void 0) return;
+	if (typeof value !== "string" || !allowEmpty && value.trim() === "") fail(`${path}.${key}`, `must be a${allowEmpty ? "" : " non-empty"} string`, value);
+}
+function optionalBoolean(parent, key, path) {
+	const value = parent[key];
+	if (value !== void 0 && typeof value !== "boolean") fail(`${path}.${key}`, "must be true or false", value);
+}
+function entries(value, path, unique) {
+	if (!Array.isArray(value) || value.length === 0) fail(path, "must be a non-empty list of [id, label] pairs", value);
+	const seen = /* @__PURE__ */ new Set();
+	value.forEach((entry, position) => {
+		const here = `${path}[${position}]`;
+		if (!Array.isArray(entry) || entry.length !== 2 || !entry.every((part) => typeof part === "string" && part.trim() !== "")) fail(here, "must be an [id, label] pair of non-empty strings", entry);
+		const id = entry[0];
+		if (unique && seen.has(id)) fail(here, `repeats the id ${JSON.stringify(id)}`);
+		seen.add(id);
+	});
+}
+function validateUrl(value, path) {
+	if (typeof value !== "string" || !/^https?:\/\/\S+$/.test(value)) fail(path, "must be an http(s) URL", value);
+}
+function validateSetup(value) {
+	const setup = plain(value, "setup");
+	noUnknownKeys(setup, SETUP_KEYS, "setup");
+	for (const key of [
+		"title",
+		"accent",
+		"lead",
+		"namespace"
+	]) optionalString(setup, key, "setup", key !== "namespace");
+	optionalBoolean(setup, "shortNames", "setup");
+	const { steps, extras } = setup;
+	if (steps !== void 0) {
+		if (!Array.isArray(steps) || steps.length === 0) fail("setup.steps", "must be a non-empty list of steps", steps);
+		steps.forEach((step, position) => {
+			const here = `setup.steps[${position}]`;
+			const item = plain(step, here);
+			noUnknownKeys(item, [
+				"title",
+				"text",
+				"command"
+			], here);
+			for (const key of ["title", "command"]) if (typeof item[key] !== "string" || item[key].trim() === "") fail(`${here}.${key}`, "must be a non-empty string", item[key]);
+			optionalString(item, "text", here, true);
+		});
+	}
+	if (extras !== void 0) {
+		if (!Array.isArray(extras)) fail("setup.extras", "must be a list", extras);
+		extras.forEach((extra, position) => {
+			const here = `setup.extras[${position}]`;
+			const item = plain(extra, here);
+			noUnknownKeys(item, [
+				"title",
+				"text",
+				"code",
+				"caption"
+			], here);
+			for (const key of ["title", "code"]) if (typeof item[key] !== "string" || item[key].trim() === "") fail(`${here}.${key}`, "must be a non-empty string", item[key]);
+			optionalString(item, "text", here, true);
+			optionalString(item, "caption", here);
+		});
+	}
+}
+/**
+* Checks a site config and returns it. Use it in `registry/site.config.mjs` to get early,
+* readable errors and editor hints.
+*
+* @param config - The config object.
+* @returns The same config, typed.
+* @throws {@link ConfigError} with code `INVALID_OPTION`, naming the option and what is wrong
+* (a missing `brand.name`, an unknown option, `fonts: 'copy-from-ui'` without `ui`, a repeated
+* category id, and so on).
+*
+* @example
+* ```js
+* export default defineRegistrySite({ brand: { name: 'Integr8 Forms' } });
+* ```
+*/
+function defineRegistrySite(config) {
+	const root = plain(config, "config");
+	noUnknownKeys(root, TOP_LEVEL_KEYS, "config");
+	const brand = plain(root.brand, "brand");
+	noUnknownKeys(brand, BRAND_KEYS, "brand");
+	if (typeof brand.name !== "string" || brand.name.trim() === "") fail("brand.name", "is required and must be a non-empty string", brand.name);
+	for (const key of [
+		"slug",
+		"mark",
+		"eyebrow",
+		"title",
+		"description",
+		"footer",
+		"heroCommand"
+	]) optionalString(brand, key, "brand");
+	for (const key of [
+		"heroTitle",
+		"heroAccent",
+		"lead"
+	]) optionalString(brand, key, "brand", true);
+	optionalBoolean(brand, "playgroundLink", "brand");
+	if (brand.repositoryUrl !== void 0) validateUrl(brand.repositoryUrl, "brand.repositoryUrl");
+	if (brand.extraStats !== void 0) {
+		const stats = brand.extraStats;
+		if (!Array.isArray(stats) || !stats.every((stat) => isPlain(stat) && typeof stat.value === "string" && typeof stat.label === "string")) fail("brand.extraStats", "must be a list of { value, label } strings", stats);
+	}
+	if (root.categories !== void 0) entries(root.categories, "categories", true);
+	if (root.previewThemes !== void 0) entries(root.previewThemes, "previewThemes", true);
+	const { stories } = root;
+	if (stories !== void 0 && typeof stories !== "function") {
+		const map = plain(stories, "stories");
+		for (const [item, parts] of Object.entries(map)) if (!Array.isArray(parts) || parts.length === 0 || !parts.every((part) => typeof part === "string" && part !== "")) fail(`stories.${item}`, "must be a non-empty list of story id parts (non-empty strings)", parts);
+	}
+	optionalString(root, "defaultStory", "config");
+	if (root.ui !== void 0) {
+		const ui = plain(root.ui, "ui");
+		noUnknownKeys(ui, UI_KEYS, "ui");
+		validateUrl(ui.registryUrl, "ui.registryUrl");
+		if (ui.docsUrl !== void 0) validateUrl(ui.docsUrl, "ui.docsUrl");
+		optionalString(ui, "packageName", "ui");
+	}
+	const { fonts } = root;
+	if (fonts !== void 0 && fonts !== false && fonts !== "build" && fonts !== "copy-from-ui") fail("fonts", "must be 'copy-from-ui', 'build' or false", fonts);
+	if (fonts === "copy-from-ui" && root.ui === void 0) fail("fonts", "is 'copy-from-ui', which needs the `ui` option (the ui registry to copy from)");
+	if (root.setup !== void 0) validateSetup(root.setup);
+	if (root.copy !== void 0) {
+		const copy = plain(root.copy, "copy");
+		noUnknownKeys(copy, COPY_KEYS, "copy");
+		for (const key of COPY_KEYS) optionalString(copy, key, "copy");
+	}
+	const { themeNote } = root;
+	if (themeNote !== void 0 && themeNote !== false) {
+		const note = plain(themeNote, "themeNote");
+		noUnknownKeys(note, THEME_NOTE_KEYS, "themeNote");
+		optionalString(note, "item", "themeNote");
+		if (typeof note.item !== "string") fail("themeNote.item", "is required and must be a non-empty string", note.item);
+		if (note.skip !== void 0 && (!Array.isArray(note.skip) || !note.skip.every((name) => typeof name === "string"))) fail("themeNote.skip", "must be a list of item names", note.skip);
+	}
+	const { bundleSizes } = root;
+	if (bundleSizes !== void 0 && bundleSizes !== false) {
+		const sizes = plain(bundleSizes, "bundleSizes");
+		noUnknownKeys(sizes, BUNDLE_KEYS, "bundleSizes");
+		optionalString(sizes, "entry", "bundleSizes");
+		optionalString(sizes, "ownCodeLabel", "bundleSizes");
+		if (sizes.external !== void 0 && (!Array.isArray(sizes.external) || !sizes.external.every((name) => typeof name === "string"))) fail("bundleSizes.external", "must be a list of package names", sizes.external);
+	}
+	if (root.commands !== void 0) {
+		const commands = plain(root.commands, "commands");
+		noUnknownKeys(commands, COMMAND_KEYS, "commands");
+		for (const key of COMMAND_KEYS) optionalString(commands, key, "commands");
+	}
+	if (root.registryUrl !== void 0) validateUrl(root.registryUrl, "registryUrl");
+	optionalBoolean(root, "playground", "config");
+	return config;
+}
+/** `Integr8 Window Manager` → `window-manager`. */
+function slugOf(name) {
+	const slug = name.toLowerCase().replace(/^integr8[\s-]+/, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+	return slug === "" ? "site" : slug;
+}
+function repositoryUrlOf(pkg, env) {
+	const fromEnv = env.GITHUB_REPOSITORY;
+	if (fromEnv !== void 0 && fromEnv !== "") return `https://github.com/${fromEnv}`;
+	const repository = typeof pkg.repository === "string" ? pkg.repository : pkg.repository?.url;
+	if (repository === void 0 || repository === "") return;
+	const cleaned = repository.replace(/^git\+/, "").replace(/^git:\/\//, "https://").replace(/^github:/, "https://github.com/").replace(/\.git$/, "");
+	return /^https?:\/\//.test(cleaned) ? cleaned : void 0;
+}
+/**
+* The URL the registry JSON files are served from, without a trailing slash. The
+* `REGISTRY_BASE_URL` variable wins over `registryUrl` in the config; without either, it is the
+* GitHub Pages URL of the `repository` in `package.json`.
+*
+* @param configured - `registryUrl` from the site config.
+* @param pkg - Name, version and repository of the package.
+* @param env - Environment variables.
+* @returns The folder URL, for example `https://owner.github.io/repo/r`.
+* @throws {@link ConfigError} with code `INVALID_OPTION` when none of the three gives a URL.
+*/
+function resolveRegistryUrl(configured, pkg, env) {
+	const fromEnv = env.REGISTRY_BASE_URL;
+	let url = fromEnv !== void 0 && fromEnv !== "" ? fromEnv : configured;
+	if (url === void 0) {
+		const repository = repositoryUrlOf(pkg, {});
+		const match = repository ? /^https:\/\/github\.com\/([^/]+)\/([^/]+)$/.exec(repository) : null;
+		const owner = match?.[1];
+		const repo = match?.[2];
+		if (owner === void 0 || repo === void 0) throw new ConfigError("INVALID_OPTION", "registry-site config: cannot tell where the registry is served. Set \"registryUrl\" in the config, the REGISTRY_BASE_URL variable, or \"repository\" in package.json.");
+		url = `https://${owner.toLowerCase()}.github.io/${repo}/r`;
+	}
+	return url.replace("{name}", pkg.name).replace("{version}", pkg.version).replace(/\/+$/, "");
+}
+/**
+* The folder where the ui item pages are: the ui registry URL without a trailing `/r`, then
+* `components/`.
+*
+* @param registryUrl - The ui registry URL.
+* @returns A URL ending with `/`.
+*/
+function uiDocsUrlOf(registryUrl) {
+	return `${registryUrl.replace(/\/+$/, "").replace(/\/r$/, "")}/components/`;
+}
+/**
+* Validates a site config and fills in every default.
+*
+* @param config - The repo's config.
+* @param context - `package.json` facts and the environment (default: the process environment).
+* @returns The full config the renderers use.
+* @throws {@link ConfigError} with code `INVALID_OPTION` for bad input.
+*/
+function resolveSiteConfig(config, context) {
+	defineRegistrySite(config);
+	const { pkg } = context;
+	const env = context.env ?? process.env;
+	const brand = config.brand;
+	const ui = config.ui ? {
+		registryUrl: config.ui.registryUrl.replace(/\/+$/, ""),
+		docsUrl: config.ui.docsUrl ?? uiDocsUrlOf(config.ui.registryUrl),
+		packageName: config.ui.packageName ?? "@integr8-media/ui"
+	} : void 0;
+	const slug = brand.slug ?? slugOf(brand.name);
+	const themeNote = config.themeNote === false ? void 0 : config.themeNote ? {
+		item: config.themeNote.item,
+		skip: [...config.themeNote.skip ?? []],
+		external: false
+	} : ui ? {
+		item: "theme",
+		skip: [],
+		external: true
+	} : void 0;
+	return {
+		brand: {
+			name: brand.name,
+			slug,
+			mark: brand.mark ?? "i8",
+			eyebrow: brand.eyebrow ?? "Registry",
+			heroTitle: brand.heroTitle ?? brand.name,
+			heroAccent: brand.heroAccent ?? "",
+			lead: brand.lead ?? pkg.description ?? "",
+			title: brand.title ?? brand.name,
+			description: brand.description ?? pkg.description ?? `${brand.name} as a shadcn registry.`,
+			footer: brand.footer ?? "{packageName} · v{version}",
+			repositoryUrl: brand.repositoryUrl ?? repositoryUrlOf(pkg, env),
+			playgroundLink: brand.playgroundLink ?? false,
+			extraStats: brand.extraStats ?? [],
+			heroCommand: brand.heroCommand
+		},
+		categories: config.categories,
+		stories: config.stories,
+		defaultStory: config.defaultStory,
+		ui,
+		fonts: config.fonts ?? (ui ? "copy-from-ui" : false),
+		setup: {
+			title: config.setup?.title,
+			accent: config.setup?.accent ?? "your first screen.",
+			lead: config.setup?.lead ?? "Works in any React 19 app set up for shadcn/ui with Tailwind v4: Next.js, Vite, React Router.",
+			steps: config.setup?.steps,
+			extras: config.setup?.extras ?? [],
+			namespace: config.setup?.namespace ?? (ui ? `@integr8-${slug}` : "@integr8"),
+			shortNames: config.setup?.shortNames ?? true
+		},
+		copy: {
+			previewLead: config.copy?.previewLead,
+			componentsLead: config.copy?.componentsLead ?? "Search, preview and copy. Every item installs with one command and has its own page with docs."
+		},
+		previewThemes: config.previewThemes ?? [],
+		themeNote,
+		bundleSizes: config.bundleSizes ? {
+			entry: config.bundleSizes.entry ?? "dist/index.mjs",
+			ownCodeLabel: config.bundleSizes.ownCodeLabel ?? `${pkg.name} (dist)`,
+			external: config.bundleSizes.external ?? [
+				"react",
+				"react-dom",
+				"react/*",
+				"react-dom/*"
+			]
+		} : void 0,
+		commands: {
+			assets: config.commands?.assets,
+			registry: config.commands?.registry ?? "node scripts/buildRegistry.mjs"
+		},
+		registryUrl: config.registryUrl,
+		playground: config.playground ?? true
+	};
+}
+// src/registrySite/siteSwitch.ts
+/**
+* Whether the registry site is on, from `integr8.site` in a parsed `package.json`.
+*
+* - key missing: on (a repo that calls the site workflow wants a site)
+* - `"integr8": { "site": false }`: off
+* - `"integr8": { "site": true }`: on
+*
+* This is the only on/off switch. The reusable workflow `registry-site.yml` reads the same key,
+* and the `integr8-registry-site` commands exit with code 0 without building when it is `false`.
+*
+* @param pkg - The parsed `package.json`.
+* @returns `false` only when `integr8.site` is `false`.
+* @throws {@link RegistrySiteError} with code `INVALID_SWITCH` for any other value, so a typo
+* such as `"site": "false"` never silently builds (or skips) the site.
+*
+* @example
+* ```ts
+* readSiteSwitch({ name: 'x', integr8: { site: false } }); // false
+* readSiteSwitch({ name: 'x' }); // true
+* ```
+*/
+function readSiteSwitch(pkg) {
+	if (typeof pkg !== "object" || pkg === null || !("integr8" in pkg)) return true;
+	const { integr8 } = pkg;
+	if (typeof integr8 !== "object" || integr8 === null || Array.isArray(integr8)) throw new RegistrySiteError("INVALID_SWITCH", "package.json \"integr8\" must be an object such as { \"site\": false }.");
+	if (!("site" in integr8)) return true;
+	const { site } = integr8;
+	if (typeof site !== "boolean") throw new RegistrySiteError("INVALID_SWITCH", `package.json "integr8.site" must be true or false (a JSON boolean, not a string); got ${JSON.stringify(site)}.`);
+	return site;
+}
+/**
+* Reads `package.json` in a folder and returns the parsed file with its switch.
+*
+* @param root - The repo root.
+* @returns The parsed `package.json` and `enabled`, the result of {@link readSiteSwitch}.
+* @throws {@link RegistrySiteError} with code `INVALID_SWITCH` for a bad switch value.
+*/
+async function readPackageAndSwitch(root) {
+	const pkg = JSON.parse(await readFile(join(root, "package.json"), "utf8"));
+	return {
+		pkg,
+		enabled: readSiteSwitch(pkg)
+	};
+}
+// src/registrySite/stories.ts
+/**
+* The stories of a parsed Ladle `meta.json`. Anything that is not a story map gives `{}`.
+*
+* @param meta - The parsed `playground/dist/meta.json`.
+* @returns Story id → details.
+*/
+function readLadleStories(meta) {
+	if (typeof meta !== "object" || meta === null || !("stories" in meta)) return {};
+	const { stories } = meta;
+	return typeof stories === "object" && stories !== null && !Array.isArray(stories) ? stories : {};
+}
+/**
+* The Ladle stories that preview an item.
+*
+* - `stories` not set: the stories whose id starts with `<item>--` (the id of `Button.stories.tsx`
+*   starts with `button--`).
+* - a map or a function: the stories whose id contains one of the item's parts. An item the map
+*   does not list has no stories, so no preview.
+*
+* @param itemName - The registry item name.
+* @param mapping - The `stories` option of the site config.
+* @param ladle - Every story in the playground.
+* @returns The matching stories in playground order.
+*/
+function storiesOf(itemName, mapping, ladle) {
+	let matches;
+	if (mapping === void 0) matches = (id) => id.startsWith(`${itemName}--`);
+	else {
+		const parts = typeof mapping === "function" ? mapping(itemName) : Object.hasOwn(mapping, itemName) ? mapping[itemName] : void 0;
+		if (!parts || parts.length === 0) return [];
+		matches = (id) => parts.some((part) => id.includes(part));
+	}
+	return Object.entries(ladle).filter(([id]) => matches(id)).map(([id, story]) => ({
+		id,
+		name: story.name ?? id
+	}));
+}
+/**
+* The story the landing page's "Preview" button opens: `<item>--default` when it is one of the
+* item's stories, else its first one.
+*
+* @param itemName - The registry item name.
+* @param stories - The item's stories, from {@link storiesOf}.
+* @returns A story id, or `undefined` for an item without stories.
+*/
+function previewStoryOf(itemName, stories) {
+	return (stories.find((story) => story.id === `${itemName}--default`) ?? stories[0])?.id;
+}
+/**
+* The story the live preview shows first: `defaultStory` as an item name (its preview story), or
+* as a story id. `undefined` when it names neither, so the page falls back to its first story.
+*
+* @param defaultStory - The `defaultStory` option.
+* @param previewStories - Item name → preview story id.
+* @param ladle - Every story in the playground.
+* @returns A story id, or `undefined`.
+*/
+function defaultStoryOf(defaultStory, previewStories, ladle) {
+	if (defaultStory === void 0) return;
+	if (Object.hasOwn(previewStories, defaultStory)) return previewStories[defaultStory];
+	return Object.hasOwn(ladle, defaultStory) ? defaultStory : void 0;
+}
+// src/registrySite/buildRegistrySite.ts
+const DOCS_PATH = "components/";
+/**
+* Renders every page of the site, without touching the file system.
+*
+* @param input - Config, the registry and what the site contains.
+* @returns The landing page and one page per item.
+*/
+function renderSiteFiles(input) {
+	const { config, index, items, baseUrl, version, ladle } = input;
+	const playgroundPath = input.playground ? "playground/" : void 0;
+	const fontsHref = input.fonts ? "assets/fonts.css" : void 0;
+	const storiesByItem = new Map(index.items.map((item) => [item.name, storiesOf(item.name, config.stories, ladle)]));
+	const previewStories = {};
+	for (const [name, stories] of storiesByItem) {
+		const id = previewStoryOf(name, stories);
+		if (id) previewStories[name] = id;
+	}
+	const exportOwners = /* @__PURE__ */ new Map();
+	const usedBy = /* @__PURE__ */ new Map();
+	for (const item of items) {
+		for (const doc of itemDocs(item)) if (!exportOwners.has(doc.name)) exportOwners.set(doc.name, item.name);
+		for (const url of item.registryDependencies ?? []) {
+			const dependency = itemNameFromUrl(url);
+			usedBy.set(dependency, [...usedBy.get(dependency) ?? [], item.name]);
+		}
+	}
+	const groups = groupItems(index.items, config.categories);
+	const site = {
+		config,
+		baseUrl,
+		version,
+		registryName: index.name,
+		groups,
+		order: groups.flatMap((group) => group.items),
+		exportOwners,
+		docsPath: DOCS_PATH,
+		playgroundPath,
+		fontsHref
+	};
+	const pages = [{
+		path: "index.html",
+		html: renderRegistryPage(index, {
+			config,
+			baseUrl,
+			version,
+			docsPath: DOCS_PATH,
+			playgroundPath,
+			fontsHref,
+			previewStories,
+			defaultStory: defaultStoryOf(config.defaultStory, previewStories, ladle)
+		})
+	}];
+	for (const item of items) pages.push({
+		path: `${DOCS_PATH}${item.name}/index.html`,
+		html: renderItemPage({
+			item,
+			stories: storiesByItem.get(item.name) ?? [],
+			usedBy: [...usedBy.get(item.name) ?? []].sort()
+		}, site)
+	});
+	return pages;
+}
+/**
+* Checks that a built playground loads its assets from where the site serves it.
+*
+* A Ladle build made without `--base <site path>playground/` asks for `/assets/...`, which is a
+* 404 under `site/playground/`, so every preview iframe stays blank.
+*
+* @param html - The text of `playground/dist/index.html`.
+* @param base - The expected base, from {@link playgroundBase}.
+* @throws {@link RegistrySiteError} with code `PLAYGROUND_BASE_MISMATCH` when an asset URL is
+* absolute but outside `base`.
+*/
+function checkPlaygroundBase(html, base) {
+	const wrong = [...html.matchAll(/\b(?:src|href)="(\/[^"]*\/assets\/[^"]*|\/assets\/[^"]*)"/g)].map((match) => match[1] ?? "").find((url) => !url.startsWith(base));
+	if (wrong !== void 0) throw new RegistrySiteError("PLAYGROUND_BASE_MISMATCH", `The playground in playground/dist was built for a different base: it loads ${wrong}, but the site serves it from ${base}. Rebuild it with \`ladle build --base ${base}\`, or run \`integr8-registry-site build\`, which always passes the right base.`);
+}
+/**
+* Loads and validates a site config file.
+*
+* @param root - The repo root.
+* @param file - The config file, relative to `root`. Defaults to `registry/site.config.mjs`.
+* @returns The default export of the file.
+* @throws {@link RegistrySiteError} with code `CONFIG_NOT_FOUND` when the file is missing.
+*/
+async function loadSiteConfig(root, file = "registry/site.config.mjs") {
+	const path = isAbsolute(file) ? file : join(root, file);
+	if (!existsSync(path)) throw new RegistrySiteError("CONFIG_NOT_FOUND", `The site config ${file} does not exist. Create it with defineRegistrySite({ brand: { name: '...' } }), or set "integr8": { "site": false } in package.json if this package has no site.`);
+	const loaded = await import(pathToFileURL(path).href);
+	return loaded.default ?? loaded;
+}
+async function readJson(path) {
+	return JSON.parse(await readFile(path, "utf8"));
+}
+async function copyFonts(config, root, siteDir) {
+	let fromDir;
+	if (config.fonts === "copy-from-ui") {
+		const packageName = config.ui?.packageName ?? "@integr8-media/ui";
+		try {
+			fromDir = dirname(createRequire(join(root, "package.json")).resolve(`${packageName}/fonts.css`));
+		} catch (cause) {
+			throw new RegistrySiteError("UI_PACKAGE_NOT_FOUND", `fonts is 'copy-from-ui', but ${packageName} is not installed (it must export ./fonts.css). Install it as a devDependency, or set fonts: false.`, { cause });
+		}
+	} else if (config.fonts === "build") fromDir = join(root, "dist");
+	else return false;
+	if (!existsSync(join(fromDir, "fonts.css")) || !existsSync(join(fromDir, "fonts"))) {
+		if (config.fonts === "copy-from-ui") throw new RegistrySiteError("UI_PACKAGE_NOT_FOUND", `Expected fonts.css and fonts/ in ${fromDir}, but they are missing. Build the ui package, or set fonts: false.`);
+		return false;
+	}
+	await mkdir(join(siteDir, "assets"), { recursive: true });
+	await cp(join(fromDir, "fonts.css"), join(siteDir, "assets", "fonts.css"));
+	await cp(join(fromDir, "fonts"), join(siteDir, "assets", "fonts"), { recursive: true });
+	return true;
+}
+/**
+* Builds the registry site into `site/`: the landing page, one page per item, the registry JSON
+* (`r/`), the fonts and the Ladle playground. Needs `dist/registry/` (the registry builder's
+* output) and, for live previews, `playground/dist/` built with the base from
+* {@link playgroundBase}.
+*
+* Does nothing (and does not fail) when `"integr8": { "site": false }` is set in `package.json`.
+*
+* @param options - Root, config, environment and site path; all optional.
+* @returns What was built.
+* @throws {@link ConfigError} with code `INVALID_OPTION` for a bad config,
+* {@link RegistrySiteError} for a missing config, registry or fonts, a bad switch value, or a
+* playground built with the wrong `--base`.
+*/
+async function buildRegistrySite(options = {}) {
+	const root = resolve(options.root ?? process.cwd());
+	const env = options.env ?? process.env;
+	const log = options.log ?? ((line) => void process.stdout.write(`${line}\n`));
+	const siteDir = join(root, "site");
+	const { pkg, enabled } = await readPackageAndSwitch(root);
+	if (!enabled) {
+		log("registry site is off (\"integr8\": { \"site\": false } in package.json): nothing to build.");
+		return {
+			enabled,
+			siteDir,
+			pages: 0,
+			fonts: false,
+			playground: false,
+			baseUrl: ""
+		};
+	}
+	const sitePackage = pkg;
+	const config = resolveSiteConfig(typeof options.config === "object" ? options.config : await loadSiteConfig(root, options.config), {
+		pkg: sitePackage,
+		env
+	});
+	const baseUrl = resolveRegistryUrl(config.registryUrl, sitePackage, env);
+	const registryDir = join(root, "dist", "registry");
+	const indexPath = join(registryDir, "registry.json");
+	if (!existsSync(indexPath)) throw new RegistrySiteError("REGISTRY_NOT_BUILT", `${indexPath} is missing. Build the registry first (config "commands.registry", by default node scripts/buildRegistry.mjs).`);
+	const index = await readJson(indexPath);
+	const items = await Promise.all(index.items.map(({ name }) => readJson(join(registryDir, `${name}.json`))));
+	const playgroundDir = join(root, "playground", "dist");
+	const withPlayground = options.playground !== false && config.playground && existsSync(join(playgroundDir, "index.html"));
+	let ladle = {};
+	if (withPlayground) {
+		const base = playgroundBase(options.siteBasePath ?? env.SITE_BASE_PATH ?? normalizeSitePath(""));
+		checkPlaygroundBase(await readFile(join(playgroundDir, "index.html"), "utf8"), base);
+		const metaPath = join(playgroundDir, "meta.json");
+		if (existsSync(metaPath)) ladle = readLadleStories(await readJson(metaPath));
+	}
+	await rm(siteDir, {
+		recursive: true,
+		force: true
+	});
+	await mkdir(siteDir, { recursive: true });
+	await cp(registryDir, join(siteDir, "r"), { recursive: true });
+	const withFonts = await copyFonts(config, root, siteDir);
+	if (withPlayground) await cp(playgroundDir, join(siteDir, "playground"), { recursive: true });
+	const pages = renderSiteFiles({
+		config,
+		index,
+		items,
+		baseUrl,
+		version: sitePackage.version,
+		ladle,
+		playground: withPlayground,
+		fonts: withFonts
+	});
+	for (const page of pages) {
+		const file = join(siteDir, page.path);
+		await mkdir(dirname(file), { recursive: true });
+		await writeFile(file, page.html);
+	}
+	await writeFile(join(siteDir, ".nojekyll"), "");
+	log(`site/ (index.html + ${items.length} item pages + r/${withFonts ? ", fonts" : ""}${withPlayground ? ", playground" : ""}) for ${baseUrl}`);
+	return {
+		enabled,
+		siteDir,
+		pages: pages.length,
+		fonts: withFonts,
+		playground: withPlayground,
+		baseUrl
+	};
+}
+// src/registrySite/bundleSizes.ts
+/** Label for this package's own built files, when none is given. */
+const OWN_CODE = "this package (dist)";
+/**
+* The package a bundled module belongs to: the name after the last `node_modules/` (with its
+* scope), `ownCode` for `dist/`, and `(other)` for anything else (such as `<stdin>`).
+*
+* @param path - The module path.
+* @param ownCode - Label for this package's own code.
+* @returns A package name or label.
+*/
+function packageOf(path, ownCode = OWN_CODE) {
+	const normalized = path.replaceAll("\\", "/");
+	const at = normalized.lastIndexOf("node_modules/");
+	if (at !== -1) {
+		const parts = normalized.slice(at + 13).split("/");
+		return parts[0]?.startsWith("@") ? `${parts[0]}/${parts[1]}` : parts[0] ?? "(other)";
+	}
+	if (normalized.startsWith("dist/") || normalized.includes("/dist/")) return ownCode;
+	return "(other)";
+}
+/**
+* Groups the inputs of one esbuild output by package, largest first. Modules that add no bytes
+* (removed by tree shaking) are left out.
+*
+* @param inputs - `metafile.outputs[file].inputs`.
+* @param ownCode - Label for this package's own code.
+* @returns One entry per package.
+*/
+function groupByPackage(inputs, ownCode = OWN_CODE) {
+	const groups = /* @__PURE__ */ new Map();
+	for (const [rawPath, { bytesInOutput }] of Object.entries(inputs)) {
+		if (bytesInOutput <= 0) continue;
+		const path = rawPath.replaceAll("\\", "/");
+		const name = packageOf(path, ownCode);
+		const group = groups.get(name) ?? {
+			name,
+			bytes: 0,
+			modules: []
+		};
+		group.bytes += bytesInOutput;
+		group.modules.push({
+			path,
+			bytes: bytesInOutput
+		});
+		groups.set(name, group);
+	}
+	const list = [...groups.values()];
+	for (const group of list) group.modules.sort((a, b) => b.bytes - a.bytes);
+	return list.sort((a, b) => b.bytes - a.bytes || a.name.localeCompare(b.name));
+}
+/** `12345` → `12.35 kB` (1 kB = 1000 bytes, like size-limit). */
+function formatKb(bytes) {
+	return `${(bytes / 1e3).toFixed(2)} kB`;
+}
+/** The part of a module path after its package folder (or after `dist/`), for short lines. */
+function shortPath(path) {
+	const normalized = path.replaceAll("\\", "/");
+	const at = normalized.lastIndexOf("node_modules/");
+	if (at !== -1) {
+		const parts = normalized.slice(at + 13).split("/");
+		const skip = parts[0]?.startsWith("@") ? 2 : 1;
+		return parts.slice(skip).join("/") || normalized;
+	}
+	const dist = normalized.indexOf("dist/");
+	return dist === -1 ? normalized : normalized.slice(dist);
+}
+/**
+* The text report for one import: totals, then one line per package with its minified size, an
+* estimate of its brotli share, and its share of the bundle, then its largest modules.
+*
+* The brotli share of a package is estimated from its minified share: compression works on the
+* whole bundle, so an exact per-package brotli size does not exist.
+*
+* @param report - The measured import.
+* @returns Text, one line per row.
+*/
+function formatReport(report) {
+	const { label, groups, minifiedBytes, brotliBytes, topModules = 3 } = report;
+	const lines = [
+		label,
+		`  Total: ${formatKb(minifiedBytes)} minified, ${formatKb(brotliBytes)} brotli`,
+		"",
+		`  ${"Package".padEnd(36)}${"Minified".padStart(12)}${"~Brotli".padStart(12)}${"Share".padStart(8)}`
+	];
+	for (const group of groups) {
+		const share = minifiedBytes > 0 ? group.bytes / minifiedBytes : 0;
+		lines.push(`  ${group.name.padEnd(36)}${formatKb(group.bytes).padStart(12)}${formatKb(share * brotliBytes).padStart(12)}${`${(share * 100).toFixed(1)}%`.padStart(8)}`);
+		for (const item of group.modules.slice(0, topModules)) lines.push(`      ${formatKb(item.bytes).padStart(10)}  ${shortPath(item.path)}`);
+	}
+	return lines.join("\n");
+}
+/**
+* One line per export, largest brotli size first: the overview printed when no export is named.
+*
+* @param rows - The measured exports.
+* @returns Text, one line per export.
+*/
+function formatSummary(rows) {
+	const sorted = [...rows].sort((a, b) => b.brotliBytes - a.brotliBytes || a.name.localeCompare(b.name));
+	const width = Math.max(6, ...sorted.map((row) => row.name.length)) + 2;
+	const lines = [`  ${"Export".padEnd(width)}${"Minified".padStart(12)}${"Brotli".padStart(12)}  Largest package`];
+	for (const row of sorted) lines.push(`  ${row.name.padEnd(width)}${formatKb(row.minifiedBytes).padStart(12)}${formatKb(row.brotliBytes).padStart(12)}  ${row.largest ?? ""}`);
+	return lines.join("\n");
+}
+/**
+* The runtime export names of a module, from esbuild's metafile (`outputs[file].exports`),
+* sorted. Names starting with `_` are left out.
+*
+* @param exportNames - The names esbuild reports.
+* @returns Unique public names.
+*/
+function publicExports(exportNames) {
+	return [...new Set(exportNames)].filter((name) => name !== "default" && !name.startsWith("_")).sort((a, b) => a.localeCompare(b));
+}
+// src/registrySite/serveSite.ts
+const TYPES = {
+	".html": "text/html; charset=utf-8",
+	".js": "text/javascript; charset=utf-8",
+	".mjs": "text/javascript; charset=utf-8",
+	".css": "text/css; charset=utf-8",
+	".json": "application/json; charset=utf-8",
+	".svg": "image/svg+xml",
+	".png": "image/png",
+	".ico": "image/x-icon",
+	".woff": "font/woff",
+	".woff2": "font/woff2",
+	".txt": "text/plain; charset=utf-8"
+};
+/**
+* The file for a URL path: folders serve their `index.html`; `null` for paths outside the root
+* or without a file.
+*
+* @param root - The folder to serve.
+* @param urlPath - The path of the request URL.
+* @returns An absolute file path, or `null`.
+*/
+async function resolveSiteFile(root, urlPath) {
+	const base = resolve(root);
+	let path;
+	try {
+		path = resolve(base, `.${decodeURIComponent(urlPath)}`);
+	} catch {
+		return null;
+	}
+	if (path !== base && !path.startsWith(base + sep)) return null;
+	try {
+		const info = await stat(path);
+		if (info.isFile()) return path;
+		if (info.isDirectory()) {
+			const index = join(path, "index.html");
+			if ((await stat(index)).isFile()) return index;
+		}
+	} catch {}
+	return null;
+}
+/**
+* Creates (does not start) the static server for a folder.
+*
+* @param root - The folder to serve, normally `site/`.
+* @returns A Node HTTP server. Folders without a trailing slash are redirected, so relative
+* links on the page resolve; responses are never cached.
+*/
+function createSiteServer(root) {
+	const base = resolve(root);
+	return createServer(async (request, response) => {
+		const { pathname } = new URL(request.url ?? "/", "http://localhost");
+		const file = await resolveSiteFile(base, pathname);
+		if (file?.endsWith(`${sep}index.html`) && !pathname.endsWith("/") && !pathname.endsWith(".html")) {
+			response.writeHead(301, { location: `${pathname}/` }).end();
+			return;
+		}
+		if (!file) {
+			response.writeHead(404, { "content-type": "text/plain; charset=utf-8" }).end("Not found");
+			return;
+		}
+		response.writeHead(200, {
+			"content-type": TYPES[extname(file).toLowerCase()] ?? "application/octet-stream",
+			"cache-control": "no-store"
+		});
+		createReadStream(file).pipe(response);
+	});
+}
+/**
+* Serves a folder on a port and resolves when it is listening.
+*
+* @param root - The folder to serve.
+* @param port - The port (`0` picks a free one).
+* @returns The running server.
+*/
+function serveSite(root, port) {
+	const server = createSiteServer(root);
+	return new Promise((resolveListening, reject) => {
+		server.once("error", reject);
+		server.listen(port, () => resolveListening(server));
+	});
+}
+// src/registrySite/sizeBreakdown.ts
+/**
+* Prints the bundle size of each export (or of the named ones) with the per-package breakdown.
+*
+* @param options - Root, entry, labels and arguments.
+* @throws {@link RegistrySiteError} with code `BUNDLE_SIZES_UNAVAILABLE` when the entry is not
+* built, esbuild is missing, or an export cannot be bundled.
+*/
+async function runSizeBreakdown(options) {
+	const { root, entry, ownCodeLabel, args, log } = options;
+	const entryPath = join(root, entry);
+	const modulesArg = args.find((arg) => arg.startsWith("--modules="));
+	const parsedModules = modulesArg ? Number(modulesArg.slice(10)) : 3;
+	const topModules = Number.isFinite(parsedModules) && parsedModules >= 0 ? parsedModules : 3;
+	const names = args.filter((arg) => !arg.startsWith("--"));
+	const details = names.length > 0 || args.includes("--details");
+	if (!existsSync(entryPath)) throw new RegistrySiteError("BUNDLE_SIZES_UNAVAILABLE", `${entry} is missing. Run \`npm run build\` first.`);
+	const specifier = "esbuild";
+	let esbuild;
+	try {
+		esbuild = await import(specifier);
+	} catch (cause) {
+		throw new RegistrySiteError("BUNDLE_SIZES_UNAVAILABLE", "esbuild was not found. It is installed with @size-limit/esbuild; run `npm install` first.", { cause });
+	}
+	const shared = {
+		bundle: true,
+		minify: true,
+		format: "esm",
+		platform: "browser",
+		write: false,
+		metafile: true,
+		logLevel: "silent",
+		external: [...options.external],
+		absWorkingDir: root
+	};
+	async function listExports() {
+		const result = await esbuild.build({
+			...shared,
+			entryPoints: [entryPath]
+		});
+		return publicExports(Object.values(result.metafile.outputs)[0]?.exports ?? []);
+	}
+	async function measure(name) {
+		const result = await esbuild.build({
+			...shared,
+			stdin: {
+				contents: `export { ${name} } from './${entry.replaceAll("\\", "/")}';`,
+				resolveDir: root,
+				loader: "js"
+			}
+		});
+		const output = result.outputFiles?.[0];
+		const meta = Object.values(result.metafile.outputs)[0];
+		if (!output || !meta) throw new Error("esbuild produced no output");
+		const brotliBytes = brotliCompressSync(output.contents, { params: { [constants.BROTLI_PARAM_QUALITY]: 11 } }).length;
+		const groups = groupByPackage(meta.inputs, ownCodeLabel);
+		return {
+			name,
+			minifiedBytes: output.contents.length,
+			brotliBytes,
+			groups,
+			largest: groups[0]?.name
+		};
+	}
+	const exportsToCheck = names.length > 0 ? names : await listExports();
+	if (exportsToCheck.length === 0) throw new RegistrySiteError("BUNDLE_SIZES_UNAVAILABLE", `No exports found in ${entry}.`);
+	if (names.length === 0) log(`Measuring ${exportsToCheck.length} exports of ${entry}...\n`);
+	const batchSize = 8;
+	const rows = [];
+	const failures = [];
+	for (let start = 0; start < exportsToCheck.length; start += batchSize) {
+		const batch = exportsToCheck.slice(start, start + batchSize);
+		(await Promise.allSettled(batch.map((name) => measure(name)))).forEach((settled, position) => {
+			if (settled.status === "fulfilled") rows.push(settled.value);
+			else {
+				const reason = settled.reason;
+				failures.push(`Could not bundle "${batch[position]}": ${reason instanceof Error ? reason.message : String(reason)}`);
+			}
+		});
+	}
+	if (details) for (const row of rows) {
+		log(formatReport({
+			label: `import { ${row.name} }`,
+			groups: row.groups,
+			minifiedBytes: row.minifiedBytes,
+			brotliBytes: row.brotliBytes,
+			topModules
+		}));
+		log("");
+	}
+	else {
+		log(formatSummary(rows));
+		log("\nFor the per-package breakdown: npm run size:why -- <Export> [<Export> ...]");
+	}
+	if (failures.length > 0) throw new RegistrySiteError("BUNDLE_SIZES_UNAVAILABLE", failures.join("\n"));
+}
+// src/registrySite/cli.ts
+/** The usage text. */
+const USAGE = `Usage: integr8-registry-site <command> [options]
+
+Commands:
+  build     Build site/ (assets, Ladle playground, registry JSON, pages).
+  serve     Serve site/ on http://localhost:4173 (PORT=5000 to change).
+  dev       build, then serve. The playground is always built for http://localhost:<port>/.
+  enabled   Print true or false: the value of "integr8.site" in package.json.
+  size      Bundle-size breakdown of the package's exports (needs "bundleSizes" in the config).
+
+Options:
+  --config <file>           Site config. Default: registry/site.config.mjs
+  --site-base-path <path>   Path the site is served from. Default: $SITE_BASE_PATH, else /
+  --no-playground           Build without the Ladle playground (no live previews)
+
+The site is off when package.json has "integr8": { "site": false }: every command then
+prints a note and exits with code 0.`;
+function runShell(command, cwd, env) {
+	return new Promise((resolveExit, reject) => {
+		const child = spawn(command, {
+			cwd,
+			shell: true,
+			stdio: "inherit",
+			env: {
+				...process.env,
+				...env
+			}
+		});
+		child.once("error", reject);
+		child.once("exit", (code) => resolveExit(code ?? 1));
+	});
+}
+/** The default dependencies: the real process, shell and server. */
+function defaultDeps() {
+	return {
+		cwd: process.cwd(),
+		env: process.env,
+		log: (line) => void process.stdout.write(`${line}\n`),
+		error: (line) => void process.stderr.write(`${line}\n`),
+		run: runShell,
+		serve: serveSite
+	};
+}
+function parseFlags(args) {
+	const flags = {
+		config: void 0,
+		siteBasePath: void 0,
+		playground: true,
+		rest: []
+	};
+	for (let position = 0; position < args.length; position++) {
+		const arg = args[position] ?? "";
+		if (arg === "--config" || arg === "--site-base-path") {
+			const value = args[position + 1];
+			if (value === void 0 || value.startsWith("--")) throw new ConfigError("INVALID_OPTION", `integr8-registry-site: ${arg} needs a value.`);
+			position++;
+			if (arg === "--config") flags.config = value;
+			else flags.siteBasePath = value;
+		} else if (arg === "--no-playground") flags.playground = false;
+		else flags.rest.push(arg);
+	}
+	return flags;
+}
+/** Only characters that are safe in a URL path and in a shell argument. */
+function checkSitePath(path) {
+	if (!/^[\w.~/-]*$/.test(path)) throw new ConfigError("INVALID_OPTION", `integr8-registry-site: the site base path ${JSON.stringify(path)} may only contain letters, digits and . _ ~ - /`);
+	return normalizeSitePath(path);
+}
+async function run(command, deps, step) {
+	deps.log(`> ${command}`);
+	const code = await deps.run(command, deps.cwd, deps.env);
+	if (code !== 0) throw new RegistrySiteError("STEP_FAILED", `${step} failed (exit code ${code}): ${command}`);
+}
+async function build(flags, deps, forcedSitePath) {
+	const root = resolve(deps.cwd);
+	const { pkg, enabled } = await readPackageAndSwitch(root);
+	if (!enabled) {
+		deps.log("registry site is off (\"integr8\": { \"site\": false } in package.json): nothing to build.");
+		return false;
+	}
+	const input = await loadSiteConfig(root, flags.config);
+	const config = resolveSiteConfig(input, {
+		pkg,
+		env: deps.env
+	});
+	const sitePath = checkSitePath(forcedSitePath ?? flags.siteBasePath ?? deps.env.SITE_BASE_PATH ?? "/");
+	if (config.commands.assets) await run(config.commands.assets, deps, "The assets step");
+	const withPlayground = flags.playground && config.playground && existsSync(join(root, "playground"));
+	if (withPlayground) await run(`npx ladle build --config playground --outDir playground/dist --base "${playgroundBase(sitePath)}"`, deps, "The Ladle playground build");
+	await run(config.commands.registry, deps, "The registry build");
+	await buildRegistrySite({
+		root,
+		config: input,
+		env: deps.env,
+		siteBasePath: sitePath,
+		playground: withPlayground,
+		log: deps.log
+	});
+	return true;
+}
+/**
+* Runs the `integr8-registry-site` command.
+*
+* @param argv - The arguments after the program name.
+* @param deps - Working folder, environment, output and process runner (default: the real ones).
+* @returns The exit code: `0` on success and when the site is switched off, `1` on an error.
+*/
+async function runCli(argv, deps = defaultDeps()) {
+	const [command, ...args] = argv;
+	try {
+		switch (command) {
+			case "build":
+				await build(parseFlags(args), deps);
+				return 0;
+			case "dev":
+			case "serve": {
+				const flags = parseFlags(args);
+				if (command === "dev" && !await build(flags, deps, "/")) return 0;
+				if (command === "serve") {
+					const { enabled } = await readPackageAndSwitch(deps.cwd);
+					if (!enabled) {
+						deps.log("registry site is off (\"integr8\": { \"site\": false } in package.json): nothing to serve.");
+						return 0;
+					}
+				}
+				const siteDir = join(resolve(deps.cwd), "site");
+				if (!existsSync(join(siteDir, "index.html"))) throw new RegistrySiteError("REGISTRY_NOT_BUILT", "site/index.html is missing. Run `integr8-registry-site build` first.");
+				const port = Number(deps.env.PORT ?? 4173);
+				await deps.serve(siteDir, port);
+				deps.log(`Registry site: http://localhost:${port}/  (Ctrl+C to stop)`);
+				return await new Promise(() => void 0);
+			}
+			case "enabled": {
+				const { enabled } = await readPackageAndSwitch(deps.cwd);
+				deps.log(String(enabled));
+				return 0;
+			}
+			case "size": {
+				const flags = parseFlags(args);
+				const root = resolve(deps.cwd);
+				const { pkg } = await readPackageAndSwitch(root);
+				const config = resolveSiteConfig(await loadSiteConfig(root, flags.config), {
+					pkg,
+					env: deps.env
+				});
+				if (!config.bundleSizes) throw new RegistrySiteError("BUNDLE_SIZES_UNAVAILABLE", "The bundle-size breakdown is off. Add \"bundleSizes: {}\" to registry/site.config.mjs to turn it on.");
+				await runSizeBreakdown({
+					root,
+					...config.bundleSizes,
+					args: flags.rest,
+					log: deps.log
+				});
+				return 0;
+			}
+			default: {
+				const known = command === void 0 || command === "help" || command === "--help";
+				(known ? deps.log : deps.error)(USAGE);
+				return known ? 0 : 1;
+			}
+		}
+	} catch (error) {
+		if (error instanceof ConfigError || error instanceof RegistrySiteError) {
+			deps.error(`integr8-registry-site: ${error.message}`);
+			return 1;
+		}
+		throw error;
+	}
+}
+export { cssToText as A, renderMarkdown as B, readSiteSwitch as C, uiDocsUrlOf as D, resolveSiteConfig as E, normalizeSitePath as F, typeLabel as H, playgroundBase as I, escapeHtml as L, itemDocs as M, renderItemPage as N, RegistrySiteError as O, extractDocs as P, groupItems as R, readPackageAndSwitch as S, resolveRegistryUrl as T, renderShell as V, renderSiteFiles as _, serveSite as a, readLadleStories as b, formatReport as c, packageOf as d, publicExports as f, loadSiteConfig as g, checkPlaygroundBase as h, resolveSiteFile as i, importLines as j, renderRegistryPage as k, formatSummary as l, buildRegistrySite as m, runCli as n, OWN_CODE as o, shortPath as p, createSiteServer as r, formatKb as s, USAGE as t, groupByPackage as u, defaultStoryOf as v, defineRegistrySite as w, storiesOf as x, previewStoryOf as y, inlineMarkdown as z };