blume 1.6.0 → 1.6.1

package/dist/cli/index.js

@@ -3158,6 +3158,7 @@ var sourcesOf = (block) => {
       includeInLlms: true,
       includeInSearch: true,
       noindex: false,
+      seoDescriptionSuffix: true,
       spec: block.spec
     });
   }
@@ -3191,6 +3192,7 @@ var referencesFor = (kind, block, defaultLabel, renderer, display, basePath) =>
       renderer,
       route,
       scalar: block.scalar,
+      seoDescriptionSuffix: source.seoDescriptionSuffix,
       slug: routeSlug(route),
       spec: source.spec,
       theme: block.theme
@@ -3818,6 +3820,55 @@ var configuredFonts = (fonts, locales = []) => {
   });
 };
 
+// src/astro/runtime-modules.ts
+var RUNTIME_MODULE_FILES = new Map([
+  ["blume:ask-data", "ask-data.json"],
+  ["blume:content-assets", "content-assets.json"],
+  ["blume:data", "data.json"],
+  ["blume:mcp-data", "mcp-data.json"],
+  ["blume:openapi", "openapi.json"],
+  ["blume:raw-markdown", "raw-markdown.json"],
+  ["blume:rss", "rss.json"],
+  ["blume:search-index", "search.json"]
+]);
+var RUNTIME_MODULE_IDS = new Set(RUNTIME_MODULE_FILES.keys());
+var RESOLVED_PREFIX = "\x00";
+var REGISTRY_KEY = Symbol.for("blume.runtime-modules");
+var registry2 = () => {
+  const host = globalThis;
+  host[REGISTRY_KEY] ??= { modules: new Map, servers: new Set };
+  return host[REGISTRY_KEY];
+};
+var publishRuntimeModules = (modules) => {
+  const { modules: current, servers } = registry2();
+  const changed = [];
+  for (const id of RUNTIME_MODULE_FILES.keys()) {
+    const next = modules.get(id);
+    if (current.get(id) === next) {
+      continue;
+    }
+    if (next === undefined) {
+      current.delete(id);
+    } else {
+      current.set(id, next);
+    }
+    changed.push(id);
+  }
+  if (changed.length === 0) {
+    return changed;
+  }
+  for (const server of servers) {
+    for (const id of changed) {
+      const mod = server.moduleGraph.getModuleById(`${RESOLVED_PREFIX}${id}`);
+      if (mod) {
+        server.moduleGraph.invalidateModule(mod);
+      }
+    }
+    server.ws.send({ type: "full-reload" });
+  }
+  return changed;
+};
+
 // src/astro/templates.ts
 var WORKSPACE_MARKERS = [
   ".git",
@@ -3944,7 +3995,18 @@ var renderUserAliases = (aliases) => Object.entries(aliases ?? {}).toSorted(([a]
         ${JSON.stringify(find)}: ${JSON.stringify(replacement)},`).join("");
 var astroOutDir = (context) => context.distDir ?? `${context.root}/dist`;
 var adapterRoot = (context) => dirname5(astroOutDir(context));
-var REACT_EXCLUDE = String.raw`exclude: [/\/node_modules\/\.vite\//]`;
+var REACT_EXCLUDE = String.raw`exclude: [/\/node_modules\/\.vite\//, /\/\.cache\/vite\//]`;
+var runtimeCacheOptions = (context, generatedModulesDir) => {
+  if (generatedModulesDir !== undefined) {
+    return { astro: "", vite: "" };
+  }
+  return {
+    astro: `
+  cacheDir: ${JSON.stringify(`${context.outDir}/.cache/astro`)},`,
+    vite: `
+    cacheDir: ${JSON.stringify(`${context.outDir}/.cache/vite`)},`
+  };
+};
 var reactIntegration = (compilerPath) => compilerPath ? `react({ babel: { plugins: [[${JSON.stringify(compilerPath)}, { target: "19" }]] }, ${REACT_EXCLUDE} })` : `react({ ${REACT_EXCLUDE} })`;
 var renderIntegrationBridge = (bridge) => {
   if (!bridge) {
@@ -3985,18 +4047,36 @@ var resolveOptimizeDeps = (options) => {
   ];
   return { optimizeDepsEntries, optimizeDepsInclude };
 };
+var renderRuntimeModuleWiring = (generatedModulesDir) => {
+  if (generatedModulesDir === undefined) {
+    return {
+      aliasLines: "",
+      imports: ["runtimeModulesPlugin"],
+      pluginEntry: "runtimeModulesPlugin(), "
+    };
+  }
+  const aliasLines = [...RUNTIME_MODULE_FILES].map(([id, file]) => `
+        ${JSON.stringify(id)}: ${JSON.stringify(`${generatedModulesDir}/${file}`)},`).join("");
+  return { aliasLines, imports: [], pluginEntry: "" };
+};
 var astroConfigTemplate = (options) => {
-  const { context, config, needsReact, pages, dataPath, themePath } = options;
+  const { context, config, needsReact, pages, themePath } = options;
+  const { astro: cacheOptions, vite: viteCacheOption } = runtimeCacheOptions(context, options.generatedModulesDir);
   const {
     askPath,
     contentRoutes,
     examplesPath,
     examplesThemePath,
+    generatedModulesDir,
     needsSvelte,
     needsVue,
-    openapiPath,
     searchClientPath
   } = options;
+  const {
+    aliasLines: runtimeModuleAliasLines,
+    imports: runtimeModuleImports,
+    pluginEntry: runtimeModulesPluginEntry
+  } = renderRuntimeModuleWiring(generatedModulesDir);
   const { deployment } = config;
   const userAliasLines = renderUserAliases(options.aliases);
   const server = deployment.output === "server";
@@ -4072,6 +4152,7 @@ var astroConfigTemplate = (options) => {
     "blumeIntegration",
     "includeHmrPlugin",
     "prerenderDepsPlugin",
+    ...runtimeModuleImports,
     ...adapterOption.includes("withAdapterRoot") ? ["withAdapterRoot"] : []
   ];
   const blumeImport = `import { ${blumeImports.join(", ")} } from "blume/astro";
@@ -4118,7 +4199,7 @@ ${userConfigSetup}export default defineConfig({
   root: ${JSON.stringify(context.outDir)},
   srcDir: ${JSON.stringify(`${context.outDir}/src`)},
   outDir: ${JSON.stringify(astroOutDir(context))},
-  publicDir: ${JSON.stringify(`${context.root}/public`)},
+  publicDir: ${JSON.stringify(`${context.root}/public`)},${cacheOptions}
   output: ${JSON.stringify(deployment.output)},${adapterOption}${sessionOption}${siteOption}${baseOption}${imageOption}${redirectsOption}${i18nOption}${fontsOption}
   integrations: [${integrations.join(", ")}${userIntegrationSpread}],
   markdown: {
@@ -4144,8 +4225,8 @@ ${userConfigSetup}export default defineConfig({
   // request latency behind the user's intent, so most navigations swap
   // instantly.
   prefetch: { prefetchAll: true },
-  vite: {
-    plugins: [tailwindcss(), includeHmrPlugin(${JSON.stringify(`${context.outDir}/src/generated/includes.json`)}), prerenderDepsPlugin()],
+  vite: {${viteCacheOption}
+    plugins: [${runtimeModulesPluginEntry}tailwindcss(), includeHmrPlugin(${JSON.stringify(`${context.outDir}/src/generated/includes.json`)}), prerenderDepsPlugin()],
     // Everything hydration can reach must be part of the dev dep optimizer's
     // FIRST run. The Vite root is the generated runtime, so user pages,
     // islands, and aliased components live outside it and are only crawled
@@ -4192,12 +4273,10 @@ ${userConfigSetup}export default defineConfig({
     resolve: {
       alias: {
         "blume:ask": ${JSON.stringify(askPath)},
-        "blume:data": ${JSON.stringify(dataPath)},
         "blume:examples": ${JSON.stringify(examplesPath)},
         "blume:examples-theme": ${JSON.stringify(examplesThemePath)},
-        "blume:openapi": ${JSON.stringify(openapiPath)},
         "blume:search-client": ${JSON.stringify(searchClientPath)},
-        "blume:theme": ${JSON.stringify(themePath)},${userAliasLines}
+        "blume:theme": ${JSON.stringify(themePath)},${runtimeModuleAliasLines}${userAliasLines}
       },
     },
     server: {
@@ -4288,7 +4367,7 @@ const provider = createOpenAICompatible({
     modelExpr = `provider(${JSON.stringify(backend.model)})`;
   }
   if (grounded) {
-    imports.push('import { createAskContext } from "blume/ai/ask-context.ts";', 'import askData from "../../generated/ask-data.json";');
+    imports.push('import { createAskContext } from "blume/ai/ask-context.ts";', 'import askData from "blume:ask-data";');
     const groundFields = [];
     if (instructions) {
       groundFields.push(`instructions: ${JSON.stringify(instructions)}`);
@@ -4396,7 +4475,7 @@ const { strings } = Astro.props;
 ---
 `;
 var searchEndpointTemplate = () => `// Generated by Blume. Do not edit.
-import documents from "../generated/search.json";
+import documents from "blume:search-index";
 
 export const prerender = true;
 
@@ -4507,7 +4586,7 @@ export const POST: APIRoute = async ({ request }) => {
 };
 `;
 var rawMarkdownEndpointTemplate = (kind) => `// Generated by Blume. Do not edit.
-import raw from "../generated/raw-markdown.json";
+import raw from "blume:raw-markdown";
 
 export const prerender = true;
 
@@ -4536,7 +4615,7 @@ import { existsSync } from "node:fs";
 import { readdir, readFile } from "node:fs/promises";
 import { isAbsolute, join, relative, resolve } from "node:path";
 import type { APIRoute } from "astro";
-import assets from "../../generated/content-assets.json";
+import assets from "blume:content-assets";
 
 export const prerender = true;
 
@@ -4618,22 +4697,17 @@ export const GET: APIRoute = async ({ params }) => {
 };
 `;
 var mcpPageFile = (route) => `${trimChar(route, "/")}.ts`;
-var mcpEndpointTemplate = (route) => {
-  const clean = trimChar(route, "/");
-  const up = "../".repeat(clean.split("/").length);
-  return `// Generated by Blume. Do not edit.
+var mcpEndpointTemplate = () => `// Generated by Blume. Do not edit.
 import type { APIRoute } from "astro";
 import { createMcpFetchHandler } from "blume/ai/mcp/server.ts";
-import type { McpData } from "blume/ai/mcp/data.ts";
-import data from "${up}generated/mcp-data.json";
+import data from "blume:mcp-data";
 
 export const prerender = false;
 
-const handler = createMcpFetchHandler(data as McpData);
+const handler = createMcpFetchHandler(data);
 
 export const ALL: APIRoute = ({ request }) => handler(request);
 `;
-};
 var playgroundProxyTemplate = (origins) => `// Generated by Blume. Do not edit.
 import type { APIRoute } from "astro";
 import { createPlaygroundProxyHandler } from "blume/openapi/proxy.ts";
@@ -4656,7 +4730,7 @@ export function GET() {
 }
 `;
 var rssEndpointTemplate = () => `// Generated by Blume. Do not edit.
-import feeds from "../../generated/rss.json";
+import feeds from "blume:rss";
 
 export const prerender = true;
 
@@ -4693,26 +4767,50 @@ const customRoutes: { slug: string; title: string }[] = ${JSON.stringify(customR
 const fonts: OgFont[] = ${JSON.stringify(og.fonts ?? [])};
 const families: OgFontFamilies | undefined = ${og.families ? JSON.stringify(og.families) : "undefined"};
 
+// A page's own description (its \`seo.description\`, else \`description\`) is
+// the card subtitle, so the image says what the page's og:description says.
+// Pages without one fall back to the site-wide subtitle at render time.
+// \`seo.og.description: false\` hides the subtitle on every card, page text
+// included, which is what switches this off.
+const pageDescriptions = ${og.pageDescriptions !== false};
+
+interface CardProps {
+  title: string;
+  description: string | null;
+}
+
 export function getStaticPaths() {
   const seen = new Set<string>();
-  const paths: { params: { slug: string }; props: { title: string } }[] = [];
-  const add = (slug: string, title: string) => {
+  const paths: { params: { slug: string }; props: CardProps }[] = [];
+  const add = (slug: string, title: string, description: string | null) => {
     if (seen.has(slug)) {
       return;
     }
     seen.add(slug);
-    paths.push({ params: { slug }, props: { title } });
+    paths.push({
+      params: { slug },
+      props: { title, description: pageDescriptions ? description : null },
+    });
   };
   // A custom page wins over a content route sharing its path, so add it first.
+  // Its description is unknown at generate time, so it takes the site subtitle.
   for (const route of customRoutes) {
-    add(route.slug, route.title);
+    add(route.slug, route.title, null);
   }
   for (const route of data.routes) {
-    add(route.path === "/" ? "index" : route.path.slice(1), route.title);
+    add(
+      route.path === "/" ? "index" : route.path.slice(1),
+      route.title,
+      route.description
+    );
   }${includeChangelog ? `
   // The generated changelog index is not a content route, so it needs its own
   // card. Added last: a custom page or content route owning /changelog wins.
-  add("changelog", data.ui.changelog?.title ?? "Changelog");` : ""}
+  add(
+    "changelog",
+    data.ui.changelog?.title ?? "Changelog",
+    data.ui.changelog?.description ?? null
+  );` : ""}
   return paths;
 }
 
@@ -4723,11 +4821,11 @@ const repoSlug = data.config.github
   ? \`\${data.config.github.owner}/\${data.config.github.repo}\`
   : undefined;
 
-export async function GET({ props }: { props: { title: string } }) {
+export async function GET({ props }: { props: CardProps }) {
   const png = await renderOgImage({
     accent: data.config.og.palette?.accent ?? data.config.theme.accent.light,
     brand: data.config.title,
-    description: data.config.og.description,
+    description: props.description ?? data.config.og.description,
     families,
     fonts,
     logo: data.config.og.logo,
@@ -4748,7 +4846,7 @@ var scalarReferenceTemplate = (options) => `---
 // Generated by Blume. Do not edit.
 import { ScalarComponent } from "@scalar/astro";
 import ReferenceLayout from "blume/components/layout/ReferenceLayout.astro";
-import data from ${JSON.stringify(options.dataImport)};
+import data from "blume:data";
 
 export const prerender = true;
 
@@ -5532,6 +5630,61 @@ const suggestions = [
   </div>
 </PageLayout>
 `;
+var notFoundMarkdownTemplate = () => `// Generated by Blume. Do not edit. Override by adding \`pages/404.astro\`.
+import { withBase } from "blume/components/islands/base-path.ts";
+import { absoluteUrl } from "blume/core/site-url.ts";
+import data from "blume:data";
+
+export const prerender = true;
+
+const nf = data.ui.notFound;
+
+// Absolute for internal routes when the site is known; an external tab href
+// passes through untouched.
+const href = (path: string): string => {
+  const based = withBase(path);
+  return data.config.site && based.startsWith("/") && !based.startsWith("//")
+    ? absoluteUrl(data.config.site, based)
+    : based;
+};
+
+// The recovery set of 404.astro: home, every top-level section (a tab links to
+// its resolved target), then the machine-readable indexes that exist.
+const links = [
+  { href: href("/"), label: nf.home },
+  ...data.navigation.tabs.map((tab) => ({
+    href: href(tab.href ?? tab.path),
+    label: tab.label,
+  })),
+  ...(data.config.discovery.sitemap
+    ? [{ href: href("/sitemap.xml"), label: nf.sitemap }]
+    : []),
+  ...(data.config.discovery.llmsTxt
+    ? [{ href: href("/llms.txt"), label: nf.llms }]
+    : []),
+];
+
+const body = [
+  "# " + nf.title,
+  "",
+  nf.description,
+  "",
+  "## " + nf.suggestions,
+  "",
+  ...links.map((link) => "- [" + link.label + "](" + link.href + ")"),
+  "",
+].join("\\n");
+
+export function GET() {
+  return new Response(body, {
+    headers: {
+      "Content-Type": "text/markdown; charset=utf-8",
+      // ~4 characters per token; keep in sync with markdownTokenCount.
+      "x-markdown-tokens": String(Math.ceil(body.length / 4)),
+    },
+  });
+}
+`;
 var islandDirective = (spec) => spec.client === "only" ? `client:only="${spec.framework}"` : `client:${spec.client}`;
 var wrapperPropsType = (name) => `type Props = typeof ${name} extends (
   props: infer P extends object,
@@ -5702,6 +5855,36 @@ declare module "blume:data" {
   export default data;
 }
 
+declare module "blume:ask-data" {
+  const askData: import("blume/ai/ask-context.ts").AskData;
+  export default askData;
+}
+
+declare module "blume:content-assets" {
+  const assets: Record<string, string>;
+  export default assets;
+}
+
+declare module "blume:mcp-data" {
+  const data: import("blume/ai/mcp/data.ts").McpData;
+  export default data;
+}
+
+declare module "blume:raw-markdown" {
+  const raw: Record<string, import("blume/ai/markdown.ts").RawMarkdownEntry>;
+  export default raw;
+}
+
+declare module "blume:rss" {
+  const feeds: Record<string, string>;
+  export default feeds;
+}
+
+declare module "blume:search-index" {
+  const documents: import("blume/search/documents.ts").SearchDocument[];
+  export default documents;
+}
+
 declare module "blume:examples" {
   type Examples = typeof import("./generated/examples.ts").examples;
   export const examples: Record<string, Examples[keyof Examples]>;
@@ -6288,6 +6471,7 @@ var ar = {
     copyClaudeCode: "نسخ أمر Claude Code",
     copyCode: "نسخ الكود",
     copyCodex: "نسخ أمر Codex",
+    copyFailed: "فشل النسخ",
     copyMarkdown: "نسخ بصيغة Markdown",
     copyServerUrl: "نسخ عنوان URL للخادم",
     edit: "التعديل على GitHub",
@@ -6384,6 +6568,7 @@ var bg = {
     copyClaudeCode: "Копирай командата на Claude Code",
     copyCode: "Копирай кода",
     copyCodex: "Копирай командата на Codex",
+    copyFailed: "Копирането не бе успешно",
     copyMarkdown: "Копирай като Markdown",
     copyServerUrl: "Копирай URL на сървъра",
     edit: "Редактирай в GitHub",
@@ -6480,6 +6665,7 @@ var bn = {
     copyClaudeCode: "Claude Code কমান্ড অনুলিপি করুন",
     copyCode: "কোড অনুলিপি করুন",
     copyCodex: "Codex কমান্ড অনুলিপি করুন",
+    copyFailed: "অনুলিপি ব্যর্থ হয়েছে",
     copyMarkdown: "Markdown হিসেবে অনুলিপি করুন",
     copyServerUrl: "সার্ভার URL অনুলিপি করুন",
     edit: "GitHub-এ সম্পাদনা করুন",
@@ -6576,6 +6762,7 @@ var ca = {
     copyClaudeCode: "Copia l'ordre de Claude Code",
     copyCode: "Copia el codi",
     copyCodex: "Copia l'ordre de Codex",
+    copyFailed: "No s'ha pogut copiar",
     copyMarkdown: "Copia com a Markdown",
     copyServerUrl: "Copia l'URL del servidor",
     edit: "Edita a GitHub",
@@ -6674,6 +6861,7 @@ var cs = {
     copyClaudeCode: "Kopírovat příkaz Claude Code",
     copyCode: "Kopírovat kód",
     copyCodex: "Kopírovat příkaz Codex",
+    copyFailed: "Kopírování se nezdařilo",
     copyMarkdown: "Kopírovat jako Markdown",
     copyServerUrl: "Kopírovat URL serveru",
     edit: "Upravit na GitHubu",
@@ -6770,6 +6958,7 @@ var da = {
     copyClaudeCode: "Kopiér Claude Code-kommando",
     copyCode: "Kopiér kode",
     copyCodex: "Kopiér Codex-kommando",
+    copyFailed: "Kopiering mislykkedes",
     copyMarkdown: "Kopiér som Markdown",
     copyServerUrl: "Kopiér server-URL",
     edit: "Rediger på GitHub",
@@ -6866,6 +7055,7 @@ var de = {
     copyClaudeCode: "Claude-Code-Befehl kopieren",
     copyCode: "Code kopieren",
     copyCodex: "Codex-Befehl kopieren",
+    copyFailed: "Kopieren fehlgeschlagen",
     copyMarkdown: "Als Markdown kopieren",
     copyServerUrl: "Server-URL kopieren",
     edit: "Auf GitHub bearbeiten",
@@ -6962,6 +7152,7 @@ var el = {
     copyClaudeCode: "Αντιγραφή εντολής Claude Code",
     copyCode: "Αντιγραφή κώδικα",
     copyCodex: "Αντιγραφή εντολής Codex",
+    copyFailed: "Η αντιγραφή απέτυχε",
     copyMarkdown: "Αντιγραφή ως Markdown",
     copyServerUrl: "Αντιγραφή URL διακομιστή",
     edit: "Επεξεργασία στο GitHub",
@@ -7060,6 +7251,7 @@ var es = {
     copyClaudeCode: "Copiar comando de Claude Code",
     copyCode: "Copiar código",
     copyCodex: "Copiar comando de Codex",
+    copyFailed: "Error al copiar",
     copyMarkdown: "Copiar como Markdown",
     copyServerUrl: "Copiar URL del servidor",
     edit: "Editar en GitHub",
@@ -7158,6 +7350,7 @@ var fa = {
     copyClaudeCode: "کپی دستور Claude Code",
     copyCode: "کپی کد",
     copyCodex: "کپی دستور Codex",
+    copyFailed: "کپی ناموفق بود",
     copyMarkdown: "کپی به‌صورت Markdown",
     copyServerUrl: "کپی نشانی سرور",
     edit: "ویرایش در GitHub",
@@ -7254,6 +7447,7 @@ var fi = {
     copyClaudeCode: "Kopioi Claude Code -komento",
     copyCode: "Kopioi koodi",
     copyCodex: "Kopioi Codex-komento",
+    copyFailed: "Kopiointi epäonnistui",
     copyMarkdown: "Kopioi Markdownina",
     copyServerUrl: "Kopioi palvelimen URL",
     edit: "Muokkaa GitHubissa",
@@ -7350,6 +7544,7 @@ var fr = {
     copyClaudeCode: "Copier la commande Claude Code",
     copyCode: "Copier le code",
     copyCodex: "Copier la commande Codex",
+    copyFailed: "Échec de la copie",
     copyMarkdown: "Copier en Markdown",
     copyServerUrl: "Copier l'URL du serveur",
     edit: "Modifier sur GitHub",
@@ -7448,6 +7643,7 @@ var he = {
     copyClaudeCode: "העתק פקודת Claude Code",
     copyCode: "העתק קוד",
     copyCodex: "העתק פקודת Codex",
+    copyFailed: "ההעתקה נכשלה",
     copyMarkdown: "העתק כ-Markdown",
     copyServerUrl: "העתק כתובת URL של השרת",
     edit: "ערוך ב-GitHub",
@@ -7544,6 +7740,7 @@ var hi = {
     copyClaudeCode: "Claude Code कमांड कॉपी करें",
     copyCode: "कोड कॉपी करें",
     copyCodex: "Codex कमांड कॉपी करें",
+    copyFailed: "कॉपी विफल रहा",
     copyMarkdown: "Markdown के रूप में कॉपी करें",
     copyServerUrl: "सर्वर URL कॉपी करें",
     edit: "GitHub पर संपादित करें",
@@ -7640,6 +7837,7 @@ var hr = {
     copyClaudeCode: "Kopiraj naredbu Claude Code",
     copyCode: "Kopiraj kôd",
     copyCodex: "Kopiraj naredbu Codex",
+    copyFailed: "Kopiranje nije uspjelo",
     copyMarkdown: "Kopiraj kao Markdown",
     copyServerUrl: "Kopiraj URL poslužitelja",
     edit: "Uredi na GitHubu",
@@ -7736,6 +7934,7 @@ var hu = {
     copyClaudeCode: "Claude Code parancs másolása",
     copyCode: "Kód másolása",
     copyCodex: "Codex parancs másolása",
+    copyFailed: "A másolás nem sikerült",
     copyMarkdown: "Másolás Markdownként",
     copyServerUrl: "Szerver URL másolása",
     edit: "Szerkesztés a GitHubon",
@@ -7832,6 +8031,7 @@ var id = {
     copyClaudeCode: "Salin perintah Claude Code",
     copyCode: "Salin kode",
     copyCodex: "Salin perintah Codex",
+    copyFailed: "Gagal menyalin",
     copyMarkdown: "Salin sebagai Markdown",
     copyServerUrl: "Salin URL server",
     edit: "Edit di GitHub",
@@ -7928,6 +8128,7 @@ var it = {
     copyClaudeCode: "Copia comando di Claude Code",
     copyCode: "Copia codice",
     copyCodex: "Copia comando di Codex",
+    copyFailed: "Copia non riuscita",
     copyMarkdown: "Copia come Markdown",
     copyServerUrl: "Copia URL del server",
     edit: "Modifica su GitHub",
@@ -8026,6 +8227,7 @@ var ja = {
     copyClaudeCode: "Claude Code コマンドをコピー",
     copyCode: "コードをコピー",
     copyCodex: "Codex コマンドをコピー",
+    copyFailed: "コピーに失敗しました",
     copyMarkdown: "Markdown としてコピー",
     copyServerUrl: "サーバー URL をコピー",
     edit: "GitHub で編集",
@@ -8124,6 +8326,7 @@ var ko = {
     copyClaudeCode: "Claude Code 명령 복사",
     copyCode: "코드 복사",
     copyCodex: "Codex 명령 복사",
+    copyFailed: "복사 실패",
     copyMarkdown: "Markdown으로 복사",
     copyServerUrl: "서버 URL 복사",
     edit: "GitHub에서 편집",
@@ -8222,6 +8425,7 @@ var nl = {
     copyClaudeCode: "Claude Code-opdracht kopiëren",
     copyCode: "Code kopiëren",
     copyCodex: "Codex-opdracht kopiëren",
+    copyFailed: "Kopiëren mislukt",
     copyMarkdown: "Kopiëren als Markdown",
     copyServerUrl: "Server-URL kopiëren",
     edit: "Bewerken op GitHub",
@@ -8318,6 +8522,7 @@ var no = {
     copyClaudeCode: "Kopier Claude Code-kommando",
     copyCode: "Kopier kode",
     copyCodex: "Kopier Codex-kommando",
+    copyFailed: "Kopiering mislyktes",
     copyMarkdown: "Kopier som Markdown",
     copyServerUrl: "Kopier server-URL",
     edit: "Rediger på GitHub",
@@ -8414,6 +8619,7 @@ var pl = {
     copyClaudeCode: "Kopiuj polecenie Claude Code",
     copyCode: "Kopiuj kod",
     copyCodex: "Kopiuj polecenie Codex",
+    copyFailed: "Kopiowanie nie powiodło się",
     copyMarkdown: "Kopiuj jako Markdown",
     copyServerUrl: "Kopiuj adres URL serwera",
     edit: "Edytuj na GitHubie",
@@ -8510,6 +8716,7 @@ var ptBR = {
     copyClaudeCode: "Copiar comando do Claude Code",
     copyCode: "Copiar código",
     copyCodex: "Copiar comando do Codex",
+    copyFailed: "Falha ao copiar",
     copyMarkdown: "Copiar como Markdown",
     copyServerUrl: "Copiar URL do servidor",
     edit: "Editar no GitHub",
@@ -8608,6 +8815,7 @@ var pt = {
     copyClaudeCode: "Copiar comando do Claude Code",
     copyCode: "Copiar código",
     copyCodex: "Copiar comando do Codex",
+    copyFailed: "Falha ao copiar",
     copyMarkdown: "Copiar como Markdown",
     copyServerUrl: "Copiar URL do servidor",
     edit: "Editar no GitHub",
@@ -8706,6 +8914,7 @@ var ro = {
     copyClaudeCode: "Copiază comanda Claude Code",
     copyCode: "Copiază codul",
     copyCodex: "Copiază comanda Codex",
+    copyFailed: "Copierea a eșuat",
     copyMarkdown: "Copiază ca Markdown",
     copyServerUrl: "Copiază URL-ul serverului",
     edit: "Editează pe GitHub",
@@ -8802,6 +9011,7 @@ var ru = {
     copyClaudeCode: "Скопировать команду Claude Code",
     copyCode: "Скопировать код",
     copyCodex: "Скопировать команду Codex",
+    copyFailed: "Не удалось скопировать",
     copyMarkdown: "Скопировать как Markdown",
     copyServerUrl: "Скопировать URL сервера",
     edit: "Редактировать на GitHub",
@@ -8898,6 +9108,7 @@ var sk = {
     copyClaudeCode: "Kopírovať príkaz Claude Code",
     copyCode: "Kopírovať kód",
     copyCodex: "Kopírovať príkaz Codex",
+    copyFailed: "Kopírovanie zlyhalo",
     copyMarkdown: "Kopírovať ako Markdown",
     copyServerUrl: "Kopírovať URL servera",
     edit: "Upraviť na GitHube",
@@ -8994,6 +9205,7 @@ var sr = {
     copyClaudeCode: "Копирај Claude Code команду",
     copyCode: "Копирај код",
     copyCodex: "Копирај Codex команду",
+    copyFailed: "Копирање није успело",
     copyMarkdown: "Копирај као Markdown",
     copyServerUrl: "Копирај URL сервера",
     edit: "Уреди на GitHub-у",
@@ -9090,6 +9302,7 @@ var sv = {
     copyClaudeCode: "Kopiera Claude Code-kommando",
     copyCode: "Kopiera kod",
     copyCodex: "Kopiera Codex-kommando",
+    copyFailed: "Kopiering misslyckades",
     copyMarkdown: "Kopiera som Markdown",
     copyServerUrl: "Kopiera server-URL",
     edit: "Redigera på GitHub",
@@ -9186,6 +9399,7 @@ var th = {
     copyClaudeCode: "คัดลอกคำสั่ง Claude Code",
     copyCode: "คัดลอกโค้ด",
     copyCodex: "คัดลอกคำสั่ง Codex",
+    copyFailed: "คัดลอกไม่สำเร็จ",
     copyMarkdown: "คัดลอกเป็น Markdown",
     copyServerUrl: "คัดลอก URL ของเซิร์ฟเวอร์",
     edit: "แก้ไขบน GitHub",
@@ -9284,6 +9498,7 @@ var tr = {
     copyClaudeCode: "Claude Code komutunu kopyala",
     copyCode: "Kodu kopyala",
     copyCodex: "Codex komutunu kopyala",
+    copyFailed: "Kopyalama başarısız oldu",
     copyMarkdown: "Markdown olarak kopyala",
     copyServerUrl: "Sunucu URL'sini kopyala",
     edit: "GitHub'da düzenle",
@@ -9380,6 +9595,7 @@ var uk = {
     copyClaudeCode: "Скопіювати команду Claude Code",
     copyCode: "Скопіювати код",
     copyCodex: "Скопіювати команду Codex",
+    copyFailed: "Не вдалося скопіювати",
     copyMarkdown: "Скопіювати як Markdown",
     copyServerUrl: "Скопіювати URL сервера",
     edit: "Редагувати на GitHub",
@@ -9476,6 +9692,7 @@ var vi = {
     copyClaudeCode: "Sao chép lệnh Claude Code",
     copyCode: "Sao chép mã",
     copyCodex: "Sao chép lệnh Codex",
+    copyFailed: "Sao chép thất bại",
     copyMarkdown: "Sao chép dưới dạng Markdown",
     copyServerUrl: "Sao chép URL máy chủ",
     edit: "Chỉnh sửa trên GitHub",
@@ -9574,6 +9791,7 @@ var zhTW = {
     copyClaudeCode: "複製 Claude Code 指令",
     copyCode: "複製程式碼",
     copyCodex: "複製 Codex 指令",
+    copyFailed: "複製失敗",
     copyMarkdown: "複製為 Markdown",
     copyServerUrl: "複製伺服器 URL",
     edit: "在 GitHub 上編輯",
@@ -9672,6 +9890,7 @@ var zh = {
     copyClaudeCode: "复制 Claude Code 命令",
     copyCode: "复制代码",
     copyCodex: "复制 Codex 命令",
+    copyFailed: "复制失败",
     copyMarkdown: "复制为 Markdown",
     copyServerUrl: "复制服务器 URL",
     edit: "在 GitHub 上编辑",
@@ -9810,6 +10029,7 @@ var uiStringsObject = z.object({
     copyClaudeCode: z.string().default("Copy Claude Code command"),
     copyCode: z.string().default("Copy code"),
     copyCodex: z.string().default("Copy Codex command"),
+    copyFailed: z.string().default("Copy failed"),
     copyMarkdown: z.string().default("Copy as Markdown"),
     copyServerUrl: z.string().default("Copy server URL"),
     edit: z.string().default("Edit on GitHub"),
@@ -10734,6 +10954,7 @@ var openapiSourceSchema = z2.strictObject({
   label: z2.string().optional(),
   noindex: z2.boolean().default(false),
   route: z2.string().optional(),
+  seoDescriptionSuffix: z2.boolean().default(true),
   spec: z2.string()
 });
 var scalarConfigSchema = z2.record(z2.string(), z2.unknown()).optional();
@@ -12651,7 +12872,8 @@ var buildIncludeGraph = (pages) => {
       continue;
     }
     for (const partial of page.includes ?? []) {
-      const includers = graph[partial] ??= [];
+      const includers = graph[partial] ?? [];
+      graph[partial] = includers;
       if (!includers.includes(sourcePath)) {
         includers.push(sourcePath);
       }
@@ -12773,6 +12995,7 @@ var versionAlternatesFor = (byKey, versionKey, locale) => {
 };
 var MANIFEST_VERSION = 1;
 var contentIndexable = (page, config) => !page.meta.search.exclude && (!page.meta.sidebar.hidden || config.search.indexing.includeHiddenPages);
+var routeDescription = (page) => page.meta.seo.description ?? page.description;
 var buildFallbackRoutes = (graph, i18n, alternatesByKey, basePath, versionAlternatesByKey) => {
   const fallback = resolveFallbackLocale(i18n);
   if (!fallback) {
@@ -12798,6 +13021,7 @@ var buildFallbackRoutes = (graph, i18n, alternatesByKey, basePath, versionAltern
         alternates: alternatesByKey.get(key) ?? [],
         collection: source.collection ?? "docs",
         contentType: source.contentType,
+        description: routeDescription(source),
         draft: source.meta.draft,
         editUrl: source.editUrl,
         entryId: source.entryId ?? source.source.ref,
@@ -12840,6 +13064,7 @@ var buildManifest = (options) => {
     alternates: alternatesByKey.get(page.translationKey) ?? [],
     collection: page.collection ?? "docs",
     contentType: page.contentType,
+    description: routeDescription(page),
     draft: page.meta.draft,
     editUrl: page.editUrl,
     entryId: page.entryId ?? page.source.ref,
@@ -13830,7 +14055,10 @@ var GRAPHQL_MEMBER_PHRASES = {
   subscription: "subscription",
   union: "union type"
 };
-var operationDescription = (spec, operation) => {
+var operationDescription = (spec, operation, options) => {
+  if (!options.suffix) {
+    return clip(plainProse(operation.description || operation.summary) || options.title, META_DESCRIPTION_MAX);
+  }
   let suffix;
   if (spec.kind === "asyncapi") {
     suffix = `Reference for the ${operation.method} operation on ${operation.path} in the ${apiName(spec)} API.`;
@@ -13863,7 +14091,10 @@ var operationMdx = (spec, operation, reference) => {
     searchFlags.exclude = true;
   }
   const seo = {
-    description: operationDescription(spec, operation)
+    description: operationDescription(spec, operation, {
+      suffix: reference?.seoDescriptionSuffix !== false,
+      title
+    })
   };
   if (reference?.noindex) {
     seo.noindex = true;
@@ -16048,7 +16279,7 @@ import { existsSync as existsSync19 } from "node:fs";
 import { mkdir as mkdir8, readdir as readdir4, readFile as readFile20, stat as stat4, writeFile as writeFile7 } from "node:fs/promises";
 import { build } from "astro";
 import { defineCommand as defineCommand3 } from "citty";
-import { dirname as dirname15, join as join33, resolve as resolve12 } from "pathe";
+import { dirname as dirname16, join as join33, resolve as resolve13 } from "pathe";
 
 // src/deploy/rss.ts
 import { escape as escapeXml } from "html-escaper";
@@ -16632,7 +16863,7 @@ var SERIALIZERS = {
   YouTube: youtube
 };
 var escapeRegExp2 = (value) => value.replaceAll(/[$()*+.?[\\\]^{|}]/gu, String.raw`\$&`);
-var componentHint = (registry2) => new RegExp(`<(?:${Object.keys(registry2).map(escapeRegExp2).join("|")})[\\s/>]`, "u");
+var componentHint = (registry3) => new RegExp(`<(?:${Object.keys(registry3).map(escapeRegExp2).join("|")})[\\s/>]`, "u");
 var BUILT_IN_HINT = componentHint(SERIALIZERS);
 var componentRegistry = (components) => components && Object.keys(components).length > 0 ? { ...SERIALIZERS, ...components } : SERIALIZERS;
 var renderSlice = (walk, start, end, nodes) => {
@@ -16691,8 +16922,8 @@ var collectSplices = (walk, nodes, out) => {
   }
 };
 var downlevelComponents = (source, components, frontmatter) => {
-  const registry2 = componentRegistry(components);
-  const hint = registry2 === SERIALIZERS ? BUILT_IN_HINT : componentHint(registry2);
+  const registry3 = componentRegistry(components);
+  const hint = registry3 === SERIALIZERS ? BUILT_IN_HINT : componentHint(registry3);
   if (!hint.test(source)) {
     return source;
   }
@@ -16703,7 +16934,7 @@ var downlevelComponents = (source, components, frontmatter) => {
     return source;
   }
   const splices = [];
-  collectSplices({ frontmatter, registry: registry2, source }, tree.children ?? [], splices);
+  collectSplices({ frontmatter, registry: registry3, source }, tree.children ?? [], splices);
   return splices.length > 0 ? applySplices(source, splices) : source;
 };
 
@@ -17836,6 +18067,18 @@ var ACCEPT_MARKDOWN_CONDITION = [
   { key: "accept", type: "header", value: ACCEPT_MARKDOWN_HEADER_VALUE }
 ];
 var VARY_ACCEPT = { vary: "Accept" };
+var NOT_FOUND_MARKDOWN_DEST = "/404.md";
+var NOT_FOUND_HTML_DEST = "/404.html";
+var NOT_FOUND_MARKDOWN_ROUTES = [
+  {
+    dest: NOT_FOUND_MARKDOWN_DEST,
+    has: ACCEPT_MARKDOWN_CONDITION,
+    headers: VARY_ACCEPT,
+    src: "^/.*$",
+    status: 404
+  },
+  { dest: NOT_FOUND_MARKDOWN_DEST, src: "^/.*\\.mdx?$", status: 404 }
+];
 var MAX_ALTERNATION_LENGTH = 3900;
 var REGEX_SPECIALS = /[$()*+.?[\]^{|}\\]/gu;
 var routePattern = (route) => encodeURI(route).replace(REGEX_SPECIALS, "\\$&");
@@ -17891,8 +18134,8 @@ var TRAILING_SLASH_REDIRECT = {
   src: "^/(.+)/$",
   status: 308
 };
-var isNegotiationRoute = (route) => route.has?.some((condition) => condition.value === ACCEPT_MARKDOWN_HEADER_VALUE) === true || route.continue === true && route.headers?.vary === "Accept" && isString6(route.src) && Object.keys(route).length === 3 || route.continue === true && isString6(route.headers?.link) && route.src === HOME_SRC && Object.keys(route).length === 3 || route.status === TRAILING_SLASH_REDIRECT.status && route.src === TRAILING_SLASH_REDIRECT.src;
-var injectNegotiationRoutes = (configText, routePaths, homeLinkHeader, contentTypeOverrides, homeTokens) => {
+var isNegotiationRoute = (route) => route.has?.some((condition) => condition.value === ACCEPT_MARKDOWN_HEADER_VALUE) === true || route.dest === NOT_FOUND_MARKDOWN_DEST && route.status === 404 || route.continue === true && route.headers?.vary === "Accept" && isString6(route.src) && Object.keys(route).length === 3 || route.continue === true && isString6(route.headers?.link) && route.src === HOME_SRC && Object.keys(route).length === 3 || route.status === TRAILING_SLASH_REDIRECT.status && route.src === TRAILING_SLASH_REDIRECT.src;
+var injectNegotiationRoutes = (configText, routePaths, homeLinkHeader, contentTypeOverrides, homeTokens, notFoundMarkdown = false) => {
   const overrideEntries = Object.entries(contentTypeOverrides ?? {});
   let config;
   try {
@@ -17920,6 +18163,12 @@ var injectNegotiationRoutes = (configText, routePaths, homeLinkHeader, contentTy
     });
   }
   routes.splice(filesystemIndex, 0, ...headerRoutes, ...rewriteRoutes, TRAILING_SLASH_REDIRECT);
+  if (notFoundMarkdown) {
+    const fallbackIndex = routes.findIndex((route) => route.status === 404 && route.dest === NOT_FOUND_HTML_DEST);
+    if (fallbackIndex !== -1) {
+      routes.splice(fallbackIndex, 0, ...NOT_FOUND_MARKDOWN_ROUTES);
+    }
+  }
   config.routes = routes;
   return `${JSON.stringify(config, null, "\t")}
 `;
@@ -18473,12 +18722,12 @@ import { imageSize as imageSize2 } from "image-size";
 import pMap6 from "p-map";
 import {
   basename as basename5,
-  dirname as dirname13,
-  isAbsolute as isAbsolute11,
+  dirname as dirname14,
+  isAbsolute as isAbsolute13,
   join as join31,
   normalize as normalize4,
-  relative as relative17,
-  resolve as resolve10
+  relative as relative18,
+  resolve as resolve11
 } from "pathe";
 import { glob as glob7 } from "tinyglobby";
 
@@ -19321,7 +19570,6 @@ var buildReferenceFiles = async (options) => {
       warnings.push(spec.warning);
     }
     const pagePath = referencePagePath(ref.route);
-    const depth = pagePath.split("/").length - 1;
     files.push({
       content: scalarReferenceTemplate({
         configuration: {
@@ -19329,7 +19577,6 @@ var buildReferenceFiles = async (options) => {
           ...themeConfiguration(config, ref.theme),
           ...ref.scalar
         },
-        dataImport: `${"../".repeat(depth + 1)}generated/data.json`,
         noindex: ref.noindex,
         route: ref.route,
         title: ref.label
@@ -20150,7 +20397,7 @@ ${options.userTheme}
 var examplesEntryTemplate = (options) => `/* Generated by Blume. Do not edit. */
 @import "tailwindcss";
 
-/* Scan the example files and the project sources they import. */
+/* Scan the project (and an out-of-root examples directory) for utility classes. */
 ${options.sources.map((source) => `@source "${source}";`).join(`
 `)}
 
@@ -20177,6 +20424,20 @@ ${options.configTokens}
 ${options.userCss}
 `;
 
+// src/theme/sources.ts
+import { dirname as dirname13, isAbsolute as isAbsolute11, relative as relative16, resolve as resolve10 } from "pathe";
+var SOURCE_DIRECTIVE = /@source(?<not>\s+not)?\s+(?<quote>["'])(?<path>[^"']+)\k<quote>/gu;
+var rebaseSourceDirectives = (css, options) => {
+  const base = dirname13(options.from);
+  return css.replace(SOURCE_DIRECTIVE, (directive, not, quote, path) => {
+    if (isAbsolute11(path)) {
+      return directive;
+    }
+    const rebased = relative16(options.to, resolve10(base, path));
+    return `@source${not ?? ""} ${quote}${rebased}${quote}`;
+  });
+};
+
 // src/theme/twoslash.ts
 import { readFileSync as readFileSync8 } from "node:fs";
 import { createRequire as createRequire3 } from "node:module";
@@ -20362,7 +20623,7 @@ export const layoutOverrides = { ...(overrides.layout ?? {})${layoutEntries.leng
 // src/astro/examples.ts
 import { readFile as readFile18 } from "node:fs/promises";
 import pMap5 from "p-map";
-import { join as join30, relative as relative16 } from "pathe";
+import { isAbsolute as isAbsolute12, join as join30, relative as relative17 } from "pathe";
 import { glob as glob6 } from "tinyglobby";
 
 // src/astro/islands.ts
@@ -20454,6 +20715,12 @@ var FRAMEWORK_BY_EXT3 = {
 var EXAMPLE_FILE = /\.(?<ext>astro|jsx|svelte|tsx|vue)$/u;
 var DEFAULT_EXAMPLE_GLOB = "**/*.{astro,jsx,svelte,tsx,vue}";
 var READ_CONCURRENCY3 = 16;
+var EXAMPLE_SCAN_GLOB = "**/*.{astro,jsx,svelte,ts,tsx,vue}";
+var exampleScanRoots = (root, examplesDir) => {
+  const path = relative17(root, examplesDir);
+  const outside = path.startsWith("..") || isAbsolute12(path);
+  return outside ? [root, examplesDir] : [root];
+};
 var GLOB_MAGIC = /[!*?[\]{}]/u;
 var splitGlobBase = (pattern) => {
   const segments = pattern.split("/");
@@ -20484,7 +20751,7 @@ var discoverExamples = async (root, pattern = "examples") => {
     if (!(ext && framework)) {
       return;
     }
-    const path = relative16(dir, file).slice(0, -(ext.length + 1));
+    const path = relative17(dir, file).slice(0, -(ext.length + 1));
     const existing = seen.get(path);
     if (existing) {
       warnings.push(`Two examples both resolve to "${path}" ("${existing}" and "${file}"); ignoring the second. Give them distinct paths.`);
@@ -20503,7 +20770,7 @@ var discoverExamples = async (root, pattern = "examples") => {
   for (const [index, file] of files.entries()) {
     collectExample(file, sources[index] ?? "");
   }
-  return { examples, warnings };
+  return { dir, examples, warnings };
 };
 var exampleMarkdownLookup = (examples) => Object.fromEntries(examples.map((example) => [
   example.path,
@@ -20548,7 +20815,7 @@ var resolvedAstroHit = (fromDir) => {
     if (pkg) {
       return { modulesDir, pkg };
     }
-    const parent = dirname13(dir);
+    const parent = dirname14(dir);
     if (parent === dir) {
       return null;
     }
@@ -20564,7 +20831,7 @@ var sameRealDir = (a, b) => {
 };
 var depsCandidates = (pkgDir) => [
   join31(pkgDir, "node_modules"),
-  dirname13(pkgDir)
+  dirname14(pkgDir)
 ];
 var candidateHolding = (pkgDir, ...segments) => depsCandidates(pkgDir).find((dir) => existsSync17(join31(dir, ...segments))) ?? null;
 var linkDepsJunction = async (link, depsDir) => {
@@ -20579,13 +20846,13 @@ var linkDepsJunction = async (link, depsDir) => {
       return;
     }
     try {
-      if (resolve10(dirname13(link), await readlink(link)) === resolve10(depsDir)) {
+      if (resolve11(dirname14(link), await readlink(link)) === resolve11(depsDir)) {
         return;
       }
     } catch {}
     await rm2(link, { force: true });
   }
-  await mkdir7(dirname13(link), { recursive: true });
+  await mkdir7(dirname14(link), { recursive: true });
   await symlink(depsDir, link, "junction");
 };
 var readPkgVersion = (pkgJsonPath) => {
@@ -20716,6 +20983,10 @@ var readOptional = async (path) => {
     return "";
   }
 };
+var readUserCss = async (file, outputDir) => {
+  const css = await readOptional(file);
+  return file ? rebaseSourceDirectives(css, { from: file, to: outputDir }) : css;
+};
 var detectNeedsReact = async (root) => {
   const matches2 = await glob7(["**/*.{tsx,jsx}"], {
     cwd: root,
@@ -20743,7 +21014,7 @@ var loadIntegrationBridge = async (config, context) => {
     return;
   }
   return {
-    configFile: relative17(context.outDir, context.configFile),
+    configFile: relative18(context.outDir, context.configFile),
     sourceHash: hashConfigSource(await readOptional(context.configFile))
   };
 };
@@ -20988,10 +21259,10 @@ var buildRuntimeData = (project) => {
     if (!(editBase && sourcePath)) {
       return null;
     }
-    const rel = relative17(context.root, sourcePath).split("\\").join("/");
+    const rel = relative18(context.root, sourcePath).split("\\").join("/");
     const editDir = trimChar(github?.dir ?? "", "/");
     const editPath = normalize4(editDir ? join31(editDir, rel) : rel);
-    if (editPath.startsWith("..") || isAbsolute11(editPath)) {
+    if (editPath.startsWith("..") || isAbsolute13(editPath)) {
       return null;
     }
     return `${editBase}/${editPath}`;
@@ -21109,6 +21380,7 @@ var buildRuntimeData = (project) => {
     routes: manifest.routes.map((route) => ({
       alternates: route.alternates,
       collection: route.collection,
+      description: route.description ?? null,
       draft: route.draft,
       editUrl: route.editUrl ?? editUrlFor(route.sourcePath),
       entryId: route.entryId,
@@ -21167,11 +21439,12 @@ var planMcp = (project, srcDir, userPages) => {
     enabled: true
   };
 };
-var writeMcpFiles = async (project, plan, write) => {
+var writeMcpFiles = async (project, plan, write, modules) => {
   if (!plan.enabled) {
     return;
   }
   const data = await buildMcpData(project);
+  modules.set("blume:mcp-data", JSON.stringify(data));
   const discoveryInput = {
     base: data.base,
     name: data.name,
@@ -21180,9 +21453,7 @@ var writeMcpFiles = async (project, plan, write) => {
     version: data.version
   };
   await Promise.all([
-    write(join31(plan.srcDir, "generated", "mcp-data.json"), `${JSON.stringify(data)}
-`),
-    write(join31(plan.srcDir, "pages", mcpPageFile(plan.route)), mcpEndpointTemplate(plan.route)),
+    write(join31(plan.srcDir, "pages", mcpPageFile(plan.route)), mcpEndpointTemplate()),
     write(join31(plan.dir, "discovery.ts"), staticJsonEndpointTemplate(buildMcpDiscovery(discoveryInput))),
     write(join31(plan.dir, "server-card.ts"), staticJsonEndpointTemplate(buildMcpServerCard(discoveryInput)))
   ]);
@@ -21223,15 +21494,14 @@ var proxyAllowlistWarnings = (config, data) => {
   }
   return warnings;
 };
-var writeAskFiles = async (project, srcDir, write) => {
+var writeAskFiles = async (project, srcDir, write, modules) => {
   const { ask } = project.config.ai;
   if (!(ask?.enabled && !ask.endpoint)) {
     return;
   }
   const grounded = ask.provider !== "inkeep";
   if (grounded) {
-    await write(join31(srcDir, "generated", "ask-data.json"), `${JSON.stringify(await buildAskData(project))}
-`);
+    modules.set("blume:ask-data", JSON.stringify(await buildAskData(project)));
   }
   await write(join31(srcDir, "pages", "api", "ask.ts"), askEndpointTemplate(resolveAskBackend(ask), grounded, {
     instructions: ask.instructions,
@@ -21242,7 +21512,10 @@ var writeNotFoundPage = async (write, srcDir, pages, contentPages) => {
   if (routeIsTaken(pages, contentPages, "/404")) {
     return;
   }
-  await write(join31(srcDir, "pages", "404.astro"), notFoundPageTemplate());
+  await Promise.all([
+    write(join31(srcDir, "pages", "404.astro"), notFoundPageTemplate()),
+    write(join31(srcDir, "pages", "404.md.ts"), notFoundMarkdownTemplate())
+  ]);
 };
 var diagnosticWarning = (diagnostic) => diagnostic.suggestion ? `${diagnostic.message} ${diagnostic.suggestion}` : diagnostic.message;
 var buildComponentSlots = async (componentsFile) => {
@@ -21274,18 +21547,18 @@ var generateRuntime = async (project) => {
   assertFontFilesExist(project);
   const out = context.outDir;
   const srcDir = join31(out, "src");
+  const generatedDir = join31(srcDir, "generated");
   const askPath = join31(srcDir, "generated", "Ask.astro");
-  const dataPath = join31(srcDir, "generated", "data.json");
   const themePath = join31(srcDir, "generated", "app.css");
   const searchClientPath = join31(srcDir, "generated", "search-client.ts");
   const examplesPath = join31(srcDir, "generated", "examples.ts");
   const examplesThemePath = join31(srcDir, "generated", "examples.css");
-  const openapiPath = join31(srcDir, "generated", "openapi.json");
   const written = new Set;
   const write = (path, content) => {
     written.add(normalize4(path));
     return writeIfChanged(path, content);
   };
+  const modules = new Map;
   const depsLinkWarning = await ensureDepsLink(out);
   const askEnabled = config.ai.ask?.enabled ?? false;
   const exportPdf = config.export.pdf;
@@ -21305,8 +21578,8 @@ var generateRuntime = async (project) => {
     context.pagesRoot ? discoverPages(context.pagesRoot) : Promise.resolve([]),
     detectNeedsReact(context.root),
     detectUsesMath(context.root, staged.values()),
-    readOptional(context.themeFile),
-    readOptional(examplesCssFile(context.root, config)),
+    readUserCss(context.themeFile, generatedDir),
+    readUserCss(examplesCssFile(context.root, config), generatedDir),
     loadIntegrationBridge(config, context),
     discoverIslands(context.root),
     discoverExamples(context.root, config.examples.source),
@@ -21353,14 +21626,12 @@ var generateRuntime = async (project) => {
         contentRoot: docsCollection.base,
         contentRoutes: markdownRoutePaths(project),
         context,
-        dataPath,
         examplesPath,
         examplesThemePath,
         integrationBridge,
         needsReact,
         needsSvelte,
         needsVue,
-        openapiPath,
         pages,
         reactCompilerPath,
         searchClientPath,
@@ -21388,7 +21659,7 @@ var generateRuntime = async (project) => {
       write(join31(srcDir, "generated", "examples.ts"), exampleMapTemplate(exampleDiscovery.examples, config.basePath)),
       write(examplesThemePath, examplesEntryTemplate({
         configTokens: buildThemeCss(config.theme),
-        sources: [`${context.root}/**/*.{astro,jsx,svelte,ts,tsx,vue}`],
+        sources: exampleScanRoots(context.root, exampleDiscovery.dir).map((dir) => `${dir}/${EXAMPLE_SCAN_GLOB}`),
         userCss: userExamplesCss
       })),
       write(themePath, tailwindEntryTemplate({
@@ -21404,12 +21675,15 @@ var generateRuntime = async (project) => {
     Promise.all(islandDiscovery.islands.map((island) => write(join31(srcDir, "generated", "islands", `${island.name}.astro`), islandWrapperTemplate(island)))),
     Promise.all(slotPlan.wrappers.map((wrapper) => write(join31(srcDir, "generated", "component-slots", `${wrapper.name}.astro`), wrapper.content))),
     Promise.all(exampleDiscovery.examples.map((example) => write(join31(srcDir, "generated", "examples", `${exampleSlug(example.path)}.astro`), exampleWrapperTemplate(example)))),
-    writeAskFiles(project, srcDir, write),
-    writeMcpFiles(project, mcp, write),
+    writeAskFiles(project, srcDir, write, modules),
+    writeMcpFiles(project, mcp, write, modules),
     playgroundProxy.enabled ? write(playgroundProxy.entrypoint, playgroundProxyTemplate(proxyOrigins)) : Promise.resolve(false)
   ]);
   if (config.seo.og.enabled) {
-    await write(join31(srcDir, "pages", "og", "[...slug].png.ts"), ogEndpointTemplate(ogRoutes, projectOgFonts(project), changelogIndex));
+    await write(join31(srcDir, "pages", "og", "[...slug].png.ts"), ogEndpointTemplate(ogRoutes, {
+      ...projectOgFonts(project),
+      pageDescriptions: config.seo.og.description !== false
+    }, changelogIndex));
   }
   if (changelogIndex) {
     await write(join31(srcDir, "pages", "changelog.astro"), changelogIndexTemplate({
@@ -21432,8 +21706,7 @@ var generateRuntime = async (project) => {
   ]);
   if (servesStaticIndex(config.search.provider)) {
     const documents = await buildSearchDocuments(project);
-    await write(join31(srcDir, "generated", "search.json"), `${JSON.stringify(documents)}
-`);
+    modules.set("blume:search-index", JSON.stringify(documents));
     await write(join31(srcDir, "pages", "blume-search.json.ts"), searchEndpointTemplate());
   }
   if (config.search.provider === "mixedbread") {
@@ -21442,24 +21715,19 @@ var generateRuntime = async (project) => {
   await write(join31(srcDir, "generated", "includes.json"), `${JSON.stringify(buildIncludeGraph(project.graph.pages))}
 `);
   const rawMarkdown = await buildRawMarkdown(project);
+  modules.set("blume:raw-markdown", JSON.stringify(rawMarkdown));
   const contentAssets = await collectContentAssets(project);
+  modules.set("blume:content-assets", JSON.stringify(contentAssets));
   await Promise.all([
-    write(join31(srcDir, "generated", "raw-markdown.json"), `${JSON.stringify(rawMarkdown)}
-`),
     write(join31(srcDir, "pages", "[...slug].md.ts"), rawMarkdownEndpointTemplate("md")),
     write(join31(srcDir, "pages", "[...slug].mdx.ts"), rawMarkdownEndpointTemplate("mdx")),
-    write(join31(srcDir, "generated", "content-assets.json"), `${JSON.stringify(contentAssets)}
-`),
     write(join31(srcDir, "pages", "blume-assets", "[...asset].ts"), contentAssetsEndpointTemplate(join31(project.context.outDir, "public", "blume-assets")))
   ]);
   const feeds = buildRssFeeds(project);
   if (feeds.length > 0) {
     const feedXml = Object.fromEntries(feeds.map((feed) => [feed.type, renderRssFeed(feed)]));
-    await Promise.all([
-      write(join31(srcDir, "generated", "rss.json"), `${JSON.stringify(feedXml)}
-`),
-      write(join31(srcDir, "pages", "[section]", "rss.xml.ts"), rssEndpointTemplate())
-    ]);
+    modules.set("blume:rss", JSON.stringify(feedXml));
+    await write(join31(srcDir, "pages", "[section]", "rss.xml.ts"), rssEndpointTemplate());
   }
   const warnings = [
     ...depsLinkWarning ? [depsLinkWarning] : [],
@@ -21497,29 +21765,29 @@ var generateRuntime = async (project) => {
     warnings.push(...references.warnings);
     await Promise.all(references.files.map((file) => write(join31(srcDir, "pages", file.pagePath), file.content)));
   }
+  modules.set("blume:data", buildRuntimeData(project));
+  modules.set("blume:openapi", JSON.stringify(openApiData));
   await Promise.all([
-    write(join31(srcDir, "generated", "data.json"), buildRuntimeData(project)),
-    write(openapiPath, `${JSON.stringify(openApiData)}
-`),
     write(join31(out, "blume.manifest.json"), `${JSON.stringify(project.manifest, null, 2)}
 `),
     writeStagedContent(out, staged)
   ]);
   await pruneOrphans(srcDir, written);
+  publishRuntimeModules(modules);
   return { structuralChange: structural.some(Boolean), warnings };
 };
 
 // src/cli/env.ts
 import { existsSync as existsSync18 } from "node:fs";
 import { config } from "dotenv";
-import { dirname as dirname14, join as join32, resolve as resolve11 } from "pathe";
+import { dirname as dirname15, join as join32, resolve as resolve12 } from "pathe";
 var loadEnvFiles = (startDir) => {
   const paths = [];
-  let dir = resolve11(startDir);
+  let dir = resolve12(startDir);
   let done = false;
   while (!done) {
     paths.push(join32(dir, ".env.local"), join32(dir, ".env"));
-    const parent = dirname14(dir);
+    const parent = dirname15(dir);
     done = existsSync18(join32(dir, ".git")) || parent === dir;
     dir = parent;
   }
@@ -21652,7 +21920,7 @@ var collectConfiguredSkills = async (project, distDir) => {
   if (!configured) {
     return [];
   }
-  const dir = resolve12(project.context.root, configured);
+  const dir = resolve13(project.context.root, configured);
   if (!existsSync19(dir)) {
     logger.warn(`ai.skills points at "${configured}" (${dir}), which does not exist; no skills published.`);
     return [];
@@ -21676,7 +21944,7 @@ var emitAgentSkills = async (project, distDir, skills) => {
   const outDir = join33(distDir, AGENT_SKILLS_DIR.slice(1));
   await Promise.all(skills.map(async (skill) => {
     const target = join33(outDir, skill.path);
-    await mkdir8(dirname15(target), { recursive: true });
+    await mkdir8(dirname16(target), { recursive: true });
     await writeFile7(target, skill.content);
   }));
   await writeFile7(join33(outDir, "index.json"), buildSkillsIndex(skills, project.config), "utf-8");
@@ -21720,7 +21988,8 @@ var emitVercelNegotiation = async (project, routePaths, root) => {
   }
   const rawMarkdown = await buildRawMarkdown(project);
   const home = rawMarkdown["/"];
-  const injected = injectNegotiationRoutes(await readFile20(configPath, "utf-8"), routePaths, buildHomeLinkHeader(config2, routePaths), overrides, home ? markdownTokenCount(agentMarkdown(home)) : undefined);
+  const notFoundMarkdown = existsSync19(join33(root, ".vercel", "output", "static", "404.md"));
+  const injected = injectNegotiationRoutes(await readFile20(configPath, "utf-8"), routePaths, buildHomeLinkHeader(config2, routePaths), overrides, home ? markdownTokenCount(agentMarkdown(home)) : undefined, notFoundMarkdown);
   if (injected === null) {
     logger.warn("Could not wire Accept: text/markdown negotiation into .vercel/output/config.json — raw Markdown stays available at the .md URLs.");
     return;
@@ -22264,7 +22533,9 @@ var devCommand = defineCommand5({
     }).on("all", regenerate);
     const disposers = [
       ...project.sources.map((source) => source.watch?.(regenerate)),
-      () => void projectWatcher.close()
+      () => {
+        projectWatcher.close();
+      }
     ].filter((dispose) => dispose !== undefined);
     const shutdown = async () => {
       for (const dispose of disposers) {
@@ -22368,12 +22639,12 @@ var doctorCommand = defineCommand6({
 
 // src/cli/commands/eject.ts
 import { defineCommand as defineCommand7 } from "citty";
-import { relative as relative20 } from "pathe";
+import { relative as relative21 } from "pathe";
 
 // src/registry/eject.ts
 import { existsSync as existsSync21 } from "node:fs";
 import { cp as cp2, mkdir as mkdir9, readFile as readFile21, rm as rm3, writeFile as writeFile8 } from "node:fs/promises";
-import { join as join36, relative as relative18 } from "pathe";
+import { join as join36, relative as relative19 } from "pathe";
 var toPosix = (path) => path.split("\\").join("/");
 var LOCAL_BLUME_SOURCE = "../../node_modules/blume/src/**/*.{astro,ts,tsx}";
 var blumeSourceGlob = (root, genDir, resolveBlumeRoot = packageRoot) => {
@@ -22382,7 +22653,7 @@ var blumeSourceGlob = (root, genDir, resolveBlumeRoot = packageRoot) => {
   }
   try {
     const src = join36(resolveBlumeRoot(), "src");
-    return `${toPosix(relative18(genDir, src))}/**/*.{astro,ts,tsx}`;
+    return `${toPosix(relative19(genDir, src))}/**/*.{astro,ts,tsx}`;
   } catch {
     console.warn('blume: could not locate the installed blume package; src/generated/app.css keeps its default `@source "../../node_modules/blume/..."` glob. If blume is hoisted elsewhere, point that glob at its install location or Blume\'s utility classes will be missing.');
     return LOCAL_BLUME_SOURCE;
@@ -22455,7 +22726,7 @@ var mcpFiles = async (project, userPages, srcDir, genDir) => {
       path: join36(genDir, "mcp-data.json")
     },
     {
-      content: mcpEndpointTemplate(route),
+      content: mcpEndpointTemplate(),
       path: join36(srcDir, "pages", mcpPageFile(route))
     },
     {
@@ -22481,14 +22752,20 @@ var changelogFiles = (project, userPages, srcDir, options) => {
     }
   ];
 };
-var readExamplesCss = (root, css) => css && existsSync21(join36(root, css)) ? readFile21(join36(root, css), "utf-8") : Promise.resolve("");
+var readUserCss2 = async (file, genDir) => {
+  if (!(file && existsSync21(file))) {
+    return "";
+  }
+  const css = await readFile21(file, "utf-8");
+  return rebaseSourceDirectives(css, { from: file, to: genDir });
+};
 var examplesPreviewFiles = (srcDir, basePath, hasExamples) => hasExamples ? [
   {
     content: examplesPageTemplate(),
     path: join36(srcDir, "pages", ...basePath.split("/").filter(Boolean), "blume-examples", "[...path].astro")
   }
 ] : [];
-var ejectIntegrationBridge = (config2, root, configFile) => config2.integrations.length > 0 && configFile ? { configFile: toPosix(relative18(root, configFile)) } : undefined;
+var ejectIntegrationBridge = (config2, root, configFile) => config2.integrations.length > 0 && configFile ? { configFile: toPosix(relative19(root, configFile)) } : undefined;
 var eject = async (root) => {
   const project = await scanProject(root, { mode: "build" });
   const { context, config: config2 } = project;
@@ -22511,8 +22788,8 @@ var eject = async (root) => {
     context.pagesRoot ? discoverPages(context.pagesRoot) : Promise.resolve([]),
     detectNeedsReact(root),
     detectUsesMath(root),
-    context.themeFile ? readFile21(context.themeFile, "utf-8") : Promise.resolve(""),
-    readExamplesCss(root, config2.examples.css),
+    readUserCss2(context.themeFile, genDir),
+    readUserCss2(config2.examples.css ? join36(root, config2.examples.css) : null, genDir),
     buildRawMarkdown(project),
     discoverIslands(root)
   ]);
@@ -22525,14 +22802,14 @@ var eject = async (root) => {
   const needsSvelte = frameworks.has("svelte");
   const relContext = {
     ...context,
-    contentRoot: toPosix(relative18(root, context.contentRoot)),
+    contentRoot: toPosix(relative19(root, context.contentRoot)),
     outDir: ".",
     root: "."
   };
-  const componentsImport = context.componentsFile ? `../../${toPosix(relative18(root, context.componentsFile))}` : null;
+  const componentsImport = context.componentsFile ? `../../${toPosix(relative19(root, context.componentsFile))}` : null;
   const relPages = [
     ...pages.map((page) => ({
-      entrypoint: toPosix(relative18(root, page.entrypoint)),
+      entrypoint: toPosix(relative19(root, page.entrypoint)),
       pattern: page.pattern
     })),
     ...mcpDiscoveryPages(project, pages)
@@ -22548,14 +22825,13 @@ var eject = async (root) => {
         contentRoot: relContext.contentRoot,
         contentRoutes: project.manifest.routes.map((route) => route.path),
         context: relContext,
-        dataPath: "./src/generated/data.json",
         examplesPath: "./src/generated/examples.ts",
         examplesThemePath: "./src/generated/examples.css",
+        generatedModulesDir: "./src/generated",
         integrationBridge: ejectIntegrationBridge(config2, root, context.configFile),
         needsReact,
         needsSvelte,
         needsVue,
-        openapiPath: "./src/generated/openapi.json",
         pages: relPages,
         searchClientPath: "./src/generated/search-client.ts",
         themePath: "./src/generated/app.css"
@@ -22601,7 +22877,7 @@ var eject = async (root) => {
     {
       content: examplesEntryTemplate({
         configTokens: buildThemeCss(config2.theme),
-        sources: ["../../**/*.{astro,jsx,svelte,ts,tsx,vue}"],
+        sources: exampleScanRoots(root, examples.dir).map((dir) => `${relative19(genDir, dir)}/${EXAMPLE_SCAN_GLOB}`),
         userCss: userExamplesCss
       }),
       path: join36(genDir, "examples.css")
@@ -22652,7 +22928,7 @@ var eject = async (root) => {
   }
   if (config2.seo.og.enabled) {
     files.push({
-      content: ogEndpointTemplate(customOgRoutes(pages, config2.title, config2.seo.og.titles)),
+      content: ogEndpointTemplate(customOgRoutes(pages, config2.title, config2.seo.og.titles), { pageDescriptions: config2.seo.og.description !== false }),
       path: join36(srcDir, "pages", "og", "[...slug].png.ts")
     });
   }
@@ -22792,7 +23068,7 @@ var updatePackageScripts = async (root) => {
 import { existsSync as existsSync22 } from "node:fs";
 import { mkdir as mkdir10, writeFile as writeFile10 } from "node:fs/promises";
 import { detect } from "package-manager-detector/detect";
-import { basename as basename6, dirname as dirname16, isAbsolute as isAbsolute12, join as join38, relative as relative19 } from "pathe";
+import { basename as basename6, dirname as dirname17, isAbsolute as isAbsolute14, join as join38, relative as relative20 } from "pathe";
 
 // src/core/package-json.ts
 var toPackageName = (raw) => raw.toLowerCase().replaceAll(/[^a-z0-9._-]+/gu, "-").replaceAll(/^[-_.]+|[-_.]+$/gu, "") || "docs";
@@ -22927,7 +23203,7 @@ var detectProjectPackageManager = async (root) => {
   const name = detected?.name;
   return name !== undefined && isPackageManager(name) ? name : detectPackageManager(process.env.npm_config_user_agent);
 };
-var validateContentDir = (root, dir) => isAbsolute12(dir) || relative19(root, join38(root, dir)).startsWith("..") ? "Must be a relative path inside the project." : undefined;
+var validateContentDir = (root, dir) => isAbsolute14(dir) || relative20(root, join38(root, dir)).startsWith("..") ? "Must be a relative path inside the project." : undefined;
 var titleize = (raw) => {
   const words = raw.replaceAll(/[-_.]+/gu, " ").split(/\s+/u).filter(Boolean);
   return words.length === 0 ? "My Docs" : words.map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
@@ -23031,7 +23307,7 @@ var writeFileSafe = async (file, log) => {
     log.info(`Skipped existing ${file.path}`);
     return false;
   }
-  await mkdir10(dirname16(file.path), { recursive: true });
+  await mkdir10(dirname17(file.path), { recursive: true });
   await writeFile10(file.path, file.content, "utf-8");
   log.success(`Created ${file.path}`);
   return true;
@@ -23107,7 +23383,7 @@ var ejectCommand = defineCommand7({
     }
     logger.success(`Ejected ${files.length} file(s):`);
     for (const file of files) {
-      process.stdout.write(`  ${relative20(root, file)}
+      process.stdout.write(`  ${relative21(root, file)}
 `);
     }
     reportDroppedArtifacts(notices);
@@ -23195,7 +23471,7 @@ When you are done, print the file and suggest running \`blume eval\` to try it.`
 import { mkdtemp as mkdtemp2, writeFile as writeFile11 } from "node:fs/promises";
 import { tmpdir as tmpdir2 } from "node:os";
 import { colors as colors4 } from "consola/utils";
-import { join as join39, relative as relative21 } from "pathe";
+import { join as join39, relative as relative22 } from "pathe";
 
 // src/cli/report-format.ts
 var seconds = (ms) => `${(ms / 1000).toFixed(1)}s`;
@@ -23271,15 +23547,15 @@ var summaryLine2 = (result) => {
 var headerLine = (total, agent) => `${colors4.bold("blume eval")}  ${total} question(s) · ${AGENTS[agent].name}`;
 var startLine = (id2, index, total) => `  ${colors4.dim(`▸ ${id2} (${index + 1}/${total})`)}`;
 var fixLines = (result, root) => result.diagnostics.filter((diagnostic) => diagnostic.code !== "BLUME_EVAL_ROUTE_UNKNOWN").map((finding2) => {
-  const site = finding2.file ? `${relative21(root, finding2.file)}${finding2.line ? `:${finding2.line}` : ""}` : "";
+  const site = finding2.file ? `${relative22(root, finding2.file)}${finding2.line ? `:${finding2.line}` : ""}` : "";
   return `  ${colors4.cyan("fix:")} ${site} ${colors4.dim(finding2.message)}`;
 });
 var warningLines = (result, root) => result.diagnostics.filter((diagnostic) => diagnostic.code === "BLUME_EVAL_ROUTE_UNKNOWN").map((finding2) => {
-  const site = finding2.file ? ` ${relative21(root, finding2.file)}${finding2.line ? `:${finding2.line}` : ""}` : "";
+  const site = finding2.file ? ` ${relative22(root, finding2.file)}${finding2.line ? `:${finding2.line}` : ""}` : "";
   return `  ${colors4.yellow("⚠")}${site} ${colors4.dim(finding2.message)}`;
 });
 var evalReportJson = (result, root, threshold) => {
-  const diagnostics = result.diagnostics.map((diagnostic) => diagnostic.file ? { ...diagnostic, file: relative21(root, diagnostic.file) } : diagnostic);
+  const diagnostics = result.diagnostics.map((diagnostic) => diagnostic.file ? { ...diagnostic, file: relative22(root, diagnostic.file) } : diagnostic);
   return `${JSON.stringify({
     diagnostics,
     eval: {
@@ -23331,7 +23607,7 @@ var DISALLOWED_TOOLS = [
   "WebSearch",
   "Task"
 ];
-var runAgentHeadless = (bin, args, options) => new Promise((resolve13, reject) => {
+var runAgentHeadless = (bin, args, options) => new Promise((resolve14, reject) => {
   const child = spawn2(bin, args, {
     cwd: options.cwd,
     stdio: ["pipe", "pipe", "pipe"]
@@ -23358,12 +23634,12 @@ var runAgentHeadless = (bin, args, options) => new Promise((resolve13, reject) =
   });
   child.once("close", (code) => {
     clearTimeout(deadline);
-    resolve13({ code: code ?? 1, stderr, stdout, timedOut });
+    resolve14({ code: code ?? 1, stderr, stdout, timedOut });
   });
   child.once("exit", (code) => {
     if (timedOut) {
       clearTimeout(deadline);
-      resolve13({ code: code ?? 1, stderr, stdout, timedOut });
+      resolve14({ code: code ?? 1, stderr, stdout, timedOut });
     }
   });
   child.stdin?.end(options.prompt);
@@ -23982,10 +24258,10 @@ var evalCommand = defineCommand8({
 // src/cli/commands/init.ts
 import * as clack from "@clack/prompts";
 import { defineCommand as defineCommand9 } from "citty";
-import { resolve as resolve14 } from "pathe";
+import { resolve as resolve15 } from "pathe";
 
 // src/cli/init/questions.ts
-import { basename as basename7, resolve as resolve13 } from "pathe";
+import { basename as basename7, resolve as resolve14 } from "pathe";
 var cancelled = (value) => typeof value === "symbol";
 var collectAnswers = async (prompter, flags, defaults) => {
   const directory = flags.directory ?? await prompter.text({
@@ -23996,7 +24272,7 @@ var collectAnswers = async (prompter, flags, defaults) => {
   if (cancelled(directory)) {
     return null;
   }
-  const root = resolve13(defaults.cwd, directory);
+  const root = resolve14(defaults.cwd, directory);
   const title = await prompter.text({
     initialValue: titleize(basename7(root)),
     message: "What's your docs site called?",
@@ -24166,7 +24442,7 @@ var initCommand = defineCommand9({
         title: "My Docs"
       };
     }
-    const root = resolve14(cwd, answers.directory);
+    const root = resolve15(cwd, answers.directory);
     if (validateContentDir(root, answers.contentDir) !== undefined) {
       logger.error(`Invalid --content-dir "${answers.contentDir}" (must be a path inside the project).`);
       process.exit(1);
@@ -25004,7 +25280,7 @@ import { join as join47 } from "pathe";
 
 // src/translate/meta.ts
 import { readFile as readFile27 } from "node:fs/promises";
-import { dirname as dirname17, join as join46, relative as relative22 } from "pathe";
+import { dirname as dirname18, join as join46, relative as relative23 } from "pathe";
 import { glob as glob8 } from "tinyglobby";
 var META_FILES2 = ["**/meta.ts", "**/meta.js", "**/meta.mjs"];
 var isFactoryModule = (value) => typeof value === "function";
@@ -25027,7 +25303,7 @@ var discoverTranslatableMeta = async (project) => {
       onlyFiles: true
     });
     for (const file of files.toSorted()) {
-      const dir = relative22(contentRoot2, dirname17(file));
+      const dir = relative23(contentRoot2, dirname18(file));
       const first = dir.split("/")[0]?.toLowerCase();
       if (first && localeDirs.has(first)) {
         continue;
@@ -25056,7 +25332,7 @@ var discoverTranslatableMeta = async (project) => {
         dir: dir === "." ? "" : dir,
         file,
         raw,
-        sourceRel: relative22(project.context.root, file),
+        sourceRel: relative23(project.context.root, file),
         title: parsed.data.title
       });
     }
@@ -25370,7 +25646,7 @@ var runTranslate = async (options) => {
 // src/translate/work-list.ts
 import { existsSync as existsSync26 } from "node:fs";
 import { readFile as readFile29 } from "node:fs/promises";
-import { dirname as dirname18, extname as extname9, join as join48, relative as relative23 } from "pathe";
+import { dirname as dirname19, extname as extname9, join as join48, relative as relative24 } from "pathe";
 var PAGE_EXTENSIONS = new Set([".md", ".mdx"]);
 var translatablePages = (project, i18n) => {
   const rootsByName = new Map(project.sources.flatMap((source) => source.staged || !source.contentRoot ? [] : [[source.name, source.contentRoot]]));
@@ -25421,12 +25697,12 @@ var partialWorkItems = async (universe, project, i18n, ledger, targetLocales, fo
     }
   }
   for (const [partialPath, contentRoot2] of partials) {
-    const sourceRel = relative23(root, partialPath);
+    const sourceRel = relative24(root, partialPath);
     work.sources.push(sourceRel);
     const hash = hashSource(await readFile29(partialPath, "utf-8"));
     const ext = extname9(partialPath);
     const verbatim = !PAGE_EXTENSIONS.has(ext.toLowerCase());
-    const contentRel = relative23(contentRoot2, partialPath);
+    const contentRel = relative24(contentRoot2, partialPath);
     for (const locale of targetLocales) {
       const targetPath = join48(contentRoot2, localeTargetPath(contentRel, ext, locale, i18n));
       const item = (status) => {
@@ -25437,7 +25713,7 @@ var partialWorkItems = async (universe, project, i18n, ledger, targetLocales, fo
           sourceRel,
           status,
           targetPath,
-          targetRel: relative23(root, targetPath)
+          targetRel: relative24(root, targetPath)
         };
         if (verbatim) {
           partialItem.verbatim = true;
@@ -25478,10 +25754,10 @@ var computeWorkList = async (project, ledger, options = {}) => {
   let upToDate = 0;
   const universe = translatablePages(project, i18n);
   for (const { page: page2, contentRoot: contentRoot2, ext, sourcePath } of universe) {
-    const sourceRel = relative23(root, sourcePath);
+    const sourceRel = relative24(root, sourcePath);
     knownSources.add(sourceRel);
     const hash = hashSource(await readFile29(sourcePath, "utf-8"));
-    const contentRel = relative23(contentRoot2, sourcePath);
+    const contentRel = relative24(contentRoot2, sourcePath);
     for (const locale of targetLocales) {
       const targetPath = join48(contentRoot2, localeTargetPath(contentRel, ext, locale, i18n));
       const item = (status) => ({
@@ -25491,7 +25767,7 @@ var computeWorkList = async (project, ledger, options = {}) => {
         sourceRel,
         status,
         targetPath,
-        targetRel: relative23(root, targetPath)
+        targetRel: relative24(root, targetPath)
       });
       const exists = translated.has(`${page2.translationKey}\x00${locale}`);
       const stamp = ledger.files[sourceRel]?.[locale];
@@ -25518,7 +25794,7 @@ var computeWorkList = async (project, ledger, options = {}) => {
     const entries = [];
     for (const source of meta.metas) {
       knownSources.add(source.sourceRel);
-      const targetDir = dirname18(metaTargetPath(source, locale));
+      const targetDir = dirname19(metaTargetPath(source, locale));
       const exists = ["meta.ts", "meta.js", "meta.mjs"].some((name) => existsSync26(join48(targetDir, name)));
       const hash = hashSource(source.raw);
       const stamp = ledger.files[source.sourceRel]?.[locale];
@@ -25752,7 +26028,7 @@ import { join as join50 } from "pathe";
 
 // src/core/links.ts
 import { existsSync as existsSync27 } from "node:fs";
-import { basename as basename8, dirname as dirname19, join as join49, relative as relative24, resolve as resolve15 } from "pathe";
+import { basename as basename8, dirname as dirname20, join as join49, relative as relative25, resolve as resolve16 } from "pathe";
 var HTTP = /^https?:\/\//iu;
 var PROTOCOL_RELATIVE = /^\/\//u;
 var SCHEME = /^[a-z][a-z0-9+.-]*:/iu;
@@ -25767,7 +26043,7 @@ var DOC_EXT = /\.(?:md|mdx)$/iu;
 var FILE_EXT = /\.[a-z0-9]+$/iu;
 var includedBySuffix = (link, page2) => link.file ? ` (included by ${basename8(page2.sourcePath ?? page2.id)})` : "";
 var authoredImageTarget = (target, pagePath, partialPath) => {
-  const authored = relative24(dirname19(partialPath), resolve15(dirname19(pagePath), target));
+  const authored = relative25(dirname20(partialPath), resolve16(dirname20(pagePath), target));
   return authored.startsWith(".") ? authored : `./${authored}`;
 };
 var assetIsPresent = (resolved, ctx) => ctx.publicDir !== null && existsSync27(join49(ctx.publicDir, resolved));
@@ -25842,7 +26118,7 @@ var checkPathLink = (resolved, fragment, page2, link, site, ctx, via = "") => {
       return null;
     }
     if (link.image && page2.sourcePath && isRelativeImageTarget(link.target)) {
-      if (resolveRelativeImage(dirname19(page2.sourcePath), link.target)) {
+      if (resolveRelativeImage(dirname20(page2.sourcePath), link.target)) {
         return null;
       }
       const authored = link.file ? authoredImageTarget(link.target, page2.sourcePath, link.file) : link.target;
@@ -26055,7 +26331,7 @@ import { defineCommand as defineCommand15 } from "citty";
 // src/core/version-cut.ts
 import { existsSync as existsSync29 } from "node:fs";
 import { cp as cp3, readdir as readdir5, readFile as readFile30, rm as rm5 } from "node:fs/promises";
-import { join as join51, relative as relative25 } from "pathe";
+import { join as join51, relative as relative26 } from "pathe";
 class CutError extends Error {
   constructor(message) {
     super(message);
@@ -26070,7 +26346,7 @@ var buildRouteRewrites = (project, id2) => {
   const rewrites = new Map;
   for (const page2 of project.graph.pages) {
     const { sourcePath } = page2;
-    if (page2.version !== "" || page2.collection === "staged" || !sourcePath || relative25(contentRoot2, sourcePath).startsWith("..")) {
+    if (page2.version !== "" || page2.collection === "staged" || !sourcePath || relative26(contentRoot2, sourcePath).startsWith("..")) {
       continue;
     }
     const logical = versionizeRoute(page2.versionKey, id2);
@@ -26146,13 +26422,12 @@ var insertArchivedVersion = async (configPath, id2) => {
 `, match.index) + 1;
   const indent = text2.slice(lineStart).match(/^\s*/u)?.[0] ?? "";
   const rest = text2.slice(insertAt);
+  const eol = /^\r?\n/u.exec(rest)?.[0];
   let entry;
   if (rest.trimStart().startsWith("]")) {
     entry = `{ id: "${id2}" }`;
-  } else if (rest.startsWith(`
-`)) {
-    entry = `
-${indent}  { id: "${id2}" },`;
+  } else if (eol) {
+    entry = `${eol}${indent}  { id: "${id2}" },`;
   } else {
     entry = `{ id: "${id2}" }, `;
   }
@@ -26215,7 +26490,7 @@ var cutVersion = async (root, id2, options = {}) => {
       const { text: text2, count } = rewriteSnapshotLinks(source, rewrites);
       if (count > 0) {
         await writeTextAtomic(abs, text2);
-        rewritten.push({ count, file: relative25(dir, abs) });
+        rewritten.push({ count, file: relative26(dir, abs) });
       }
     }));
   };
@@ -26293,6 +26568,15 @@ var versionCommand = defineCommand15({
   }
 });
 
+// src/cli/host-args.ts
+var normalizeHostArgs = (rawArgs) => rawArgs.map((arg, index) => {
+  if (arg !== "--host") {
+    return arg;
+  }
+  const next = rawArgs[index + 1];
+  return next === undefined || next.startsWith("-") ? "--host=" : arg;
+});
+
 // src/cli/index.ts
 var main = defineCommand16({
   meta: {
@@ -26327,7 +26611,7 @@ process.on("unhandledRejection", (error) => {
   reportInternalError(error);
   process.exit(1);
 });
-runMain(main);
+runMain(main, { rawArgs: normalizeHostArgs(process.argv.slice(2)) });
 
-//# debugId=6AEF08BD7421838D64756E2164756E21
+//# debugId=2A8DB3E67F0908D564756E2164756E21
 //# sourceMappingURL=index.js.map