blume 1.6.0 → 1.6.2

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
@@ -3265,6 +3267,14 @@ var builtinProxyKinds = (config) => {
 };
 var needsPlaygroundProxy = (config) => builtinProxyKinds(config).length > 0;
 
+// src/ai/api/paths.ts
+var OPENAPI_PATH = "/openapi.json";
+var API_BASE = "/api/docs";
+var API_PAGES_PATH = `${API_BASE}/pages.json`;
+var API_PAGE_PATH = `${API_BASE}/pages/{route}.json`;
+var API_NAVIGATION_PATH = `${API_BASE}/navigation.json`;
+var API_SEARCH_PATH = `${API_BASE}/search`;
+
 // src/ai/api-catalog.ts
 var API_CATALOG_PATH = "/.well-known/api-catalog";
 var API_CATALOG_TYPE = "application/linkset+json";
@@ -3288,6 +3298,13 @@ var linksetEntries = (config) => {
     }
     entries.push(entry);
   }
+  if (config.ai.api) {
+    entries.push({
+      anchor: abs(API_BASE),
+      "service-desc": [{ href: abs(OPENAPI_PATH), type: "application/json" }],
+      "service-doc": [{ href: abs("/"), type: "text/html" }]
+    });
+  }
   if (config.ai.mcp.enabled) {
     entries.push({
       anchor: abs(config.ai.mcp.route),
@@ -3316,6 +3333,9 @@ var buildHomeLinkHeader = (config, routePaths) => {
   if (hasApiCatalog(config)) {
     links.push(`<${deployBase}${API_CATALOG_PATH}>; rel="api-catalog"; type="application/linkset+json"`);
   }
+  if (config.ai.api) {
+    links.push(`<${deployBase}${OPENAPI_PATH}>; rel="service-desc"; type="application/json"`);
+  }
   if (config.seo.agentReadability) {
     links.push(`<${deployBase}/agent-readability.json>; rel="describedby"; type="application/json"`);
   }
@@ -3818,6 +3838,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 +4013,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 +4065,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 +4170,7 @@ var astroConfigTemplate = (options) => {
     "blumeIntegration",
     "includeHmrPlugin",
     "prerenderDepsPlugin",
+    ...runtimeModuleImports,
     ...adapterOption.includes("withAdapterRoot") ? ["withAdapterRoot"] : []
   ];
   const blumeImport = `import { ${blumeImports.join(", ")} } from "blume/astro";
@@ -4118,7 +4217,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 +4243,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 +4291,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 +4385,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 +4493,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 +4604,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 +4633,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 +4715,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 +4748,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 +4785,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 +4839,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 +4864,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 +5648,172 @@ 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 }]
+    : []),
+  ...(data.config.discovery.api
+    ? [{ href: href("/openapi.json"), label: nf.api }]
+    : []),
+];
+
+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 notFoundJsonTemplate = () => `// Generated by Blume. Do not edit. Override by adding \`pages/404.astro\`.
+import { problem } from "blume/ai/api/problem.ts";
+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 }]
+    : []),
+  ...(data.config.discovery.api
+    ? [{ href: href("/openapi.json"), label: nf.api }]
+    : []),
+];
+
+const body = problem({
+  code: "PAGE_NOT_FOUND",
+  detail: nf.description,
+  links,
+  resolution: nf.suggestions + ": " + links.map((link) => link.href).join(", "),
+  status: 404,
+  title: nf.title,
+});
+
+export function GET() {
+  return new Response(JSON.stringify(body, null, 2) + "\\n", {
+    headers: { "Content-Type": "application/problem+json; charset=utf-8" },
+  });
+}
+`;
+var apiPagesIndexTemplate = () => `// Generated by Blume. Do not edit.
+import { pagesIndexResponse } from "blume/ai/api/handlers.ts";
+import data from "blume:mcp-data";
+
+export const prerender = true;
+
+export function GET() {
+  return pagesIndexResponse(data);
+}
+`;
+var apiPageTemplate = () => `// Generated by Blume. Do not edit.
+import { pageParams, pageResponse } from "blume/ai/api/handlers.ts";
+import data from "blume:mcp-data";
+
+export const prerender = true;
+
+export function getStaticPaths() {
+  return pageParams(data);
+}
+
+export function GET({ props }: { props: { route: string } }) {
+  return pageResponse(data, props.route);
+}
+`;
+var apiNavigationTemplate = () => `// Generated by Blume. Do not edit.
+import { navigationResponse } from "blume/ai/api/handlers.ts";
+import data from "blume:mcp-data";
+
+export const prerender = true;
+
+export function GET() {
+  return navigationResponse(data);
+}
+`;
+var apiSearchTemplate = () => `// Generated by Blume. Do not edit.
+import type { APIRoute } from "astro";
+import { createSearchHandler } from "blume/ai/api/handlers.ts";
+import data from "blume:mcp-data";
+
+export const prerender = false;
+
+const handler = createSearchHandler(data);
+
+export const GET: APIRoute = ({ request }) => handler(request);
+`;
+var apiNotFoundTemplate = (context) => `// Generated by Blume. Do not edit.
+import type { APIRoute } from "astro";
+import { apiNotFoundResponse } from "blume/ai/api/handlers.ts";
+
+export const prerender = false;
+
+const context = ${JSON.stringify(context)};
+
+export const ALL: APIRoute = ({ request }) => apiNotFoundResponse(request, context);
+`;
 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 +5984,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 +6600,7 @@ var ar = {
     copyClaudeCode: "نسخ أمر Claude Code",
     copyCode: "نسخ الكود",
     copyCodex: "نسخ أمر Codex",
+    copyFailed: "فشل النسخ",
     copyMarkdown: "نسخ بصيغة Markdown",
     copyServerUrl: "نسخ عنوان URL للخادم",
     edit: "التعديل على GitHub",
@@ -6384,6 +6697,7 @@ var bg = {
     copyClaudeCode: "Копирай командата на Claude Code",
     copyCode: "Копирай кода",
     copyCodex: "Копирай командата на Codex",
+    copyFailed: "Копирането не бе успешно",
     copyMarkdown: "Копирай като Markdown",
     copyServerUrl: "Копирай URL на сървъра",
     edit: "Редактирай в GitHub",
@@ -6480,6 +6794,7 @@ var bn = {
     copyClaudeCode: "Claude Code কমান্ড অনুলিপি করুন",
     copyCode: "কোড অনুলিপি করুন",
     copyCodex: "Codex কমান্ড অনুলিপি করুন",
+    copyFailed: "অনুলিপি ব্যর্থ হয়েছে",
     copyMarkdown: "Markdown হিসেবে অনুলিপি করুন",
     copyServerUrl: "সার্ভার URL অনুলিপি করুন",
     edit: "GitHub-এ সম্পাদনা করুন",
@@ -6576,6 +6891,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 +6990,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 +7087,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 +7184,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 +7281,7 @@ var el = {
     copyClaudeCode: "Αντιγραφή εντολής Claude Code",
     copyCode: "Αντιγραφή κώδικα",
     copyCodex: "Αντιγραφή εντολής Codex",
+    copyFailed: "Η αντιγραφή απέτυχε",
     copyMarkdown: "Αντιγραφή ως Markdown",
     copyServerUrl: "Αντιγραφή URL διακομιστή",
     edit: "Επεξεργασία στο GitHub",
@@ -7060,6 +7380,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 +7479,7 @@ var fa = {
     copyClaudeCode: "کپی دستور Claude Code",
     copyCode: "کپی کد",
     copyCodex: "کپی دستور Codex",
+    copyFailed: "کپی ناموفق بود",
     copyMarkdown: "کپی به‌صورت Markdown",
     copyServerUrl: "کپی نشانی سرور",
     edit: "ویرایش در GitHub",
@@ -7254,6 +7576,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 +7673,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 +7772,7 @@ var he = {
     copyClaudeCode: "העתק פקודת Claude Code",
     copyCode: "העתק קוד",
     copyCodex: "העתק פקודת Codex",
+    copyFailed: "ההעתקה נכשלה",
     copyMarkdown: "העתק כ-Markdown",
     copyServerUrl: "העתק כתובת URL של השרת",
     edit: "ערוך ב-GitHub",
@@ -7544,6 +7869,7 @@ var hi = {
     copyClaudeCode: "Claude Code कमांड कॉपी करें",
     copyCode: "कोड कॉपी करें",
     copyCodex: "Codex कमांड कॉपी करें",
+    copyFailed: "कॉपी विफल रहा",
     copyMarkdown: "Markdown के रूप में कॉपी करें",
     copyServerUrl: "सर्वर URL कॉपी करें",
     edit: "GitHub पर संपादित करें",
@@ -7640,6 +7966,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 +8063,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 +8160,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 +8257,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 +8356,7 @@ var ja = {
     copyClaudeCode: "Claude Code コマンドをコピー",
     copyCode: "コードをコピー",
     copyCodex: "Codex コマンドをコピー",
+    copyFailed: "コピーに失敗しました",
     copyMarkdown: "Markdown としてコピー",
     copyServerUrl: "サーバー URL をコピー",
     edit: "GitHub で編集",
@@ -8124,6 +8455,7 @@ var ko = {
     copyClaudeCode: "Claude Code 명령 복사",
     copyCode: "코드 복사",
     copyCodex: "Codex 명령 복사",
+    copyFailed: "복사 실패",
     copyMarkdown: "Markdown으로 복사",
     copyServerUrl: "서버 URL 복사",
     edit: "GitHub에서 편집",
@@ -8222,6 +8554,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 +8651,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 +8748,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 +8845,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 +8944,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 +9043,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 +9140,7 @@ var ru = {
     copyClaudeCode: "Скопировать команду Claude Code",
     copyCode: "Скопировать код",
     copyCodex: "Скопировать команду Codex",
+    copyFailed: "Не удалось скопировать",
     copyMarkdown: "Скопировать как Markdown",
     copyServerUrl: "Скопировать URL сервера",
     edit: "Редактировать на GitHub",
@@ -8898,6 +9237,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 +9334,7 @@ var sr = {
     copyClaudeCode: "Копирај Claude Code команду",
     copyCode: "Копирај код",
     copyCodex: "Копирај Codex команду",
+    copyFailed: "Копирање није успело",
     copyMarkdown: "Копирај као Markdown",
     copyServerUrl: "Копирај URL сервера",
     edit: "Уреди на GitHub-у",
@@ -9090,6 +9431,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 +9528,7 @@ var th = {
     copyClaudeCode: "คัดลอกคำสั่ง Claude Code",
     copyCode: "คัดลอกโค้ด",
     copyCodex: "คัดลอกคำสั่ง Codex",
+    copyFailed: "คัดลอกไม่สำเร็จ",
     copyMarkdown: "คัดลอกเป็น Markdown",
     copyServerUrl: "คัดลอก URL ของเซิร์ฟเวอร์",
     edit: "แก้ไขบน GitHub",
@@ -9284,6 +9627,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 +9724,7 @@ var uk = {
     copyClaudeCode: "Скопіювати команду Claude Code",
     copyCode: "Скопіювати код",
     copyCodex: "Скопіювати команду Codex",
+    copyFailed: "Не вдалося скопіювати",
     copyMarkdown: "Скопіювати як Markdown",
     copyServerUrl: "Скопіювати URL сервера",
     edit: "Редагувати на GitHub",
@@ -9476,6 +9821,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 +9920,7 @@ var zhTW = {
     copyClaudeCode: "複製 Claude Code 指令",
     copyCode: "複製程式碼",
     copyCodex: "複製 Codex 指令",
+    copyFailed: "複製失敗",
     copyMarkdown: "複製為 Markdown",
     copyServerUrl: "複製伺服器 URL",
     edit: "在 GitHub 上編輯",
@@ -9672,6 +10019,7 @@ var zh = {
     copyClaudeCode: "复制 Claude Code 命令",
     copyCode: "复制代码",
     copyCodex: "复制 Codex 命令",
+    copyFailed: "复制失败",
     copyMarkdown: "复制为 Markdown",
     copyServerUrl: "复制服务器 URL",
     edit: "在 GitHub 上编辑",
@@ -9810,6 +10158,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"),
@@ -9871,6 +10220,7 @@ var uiStringsObject = z.object({
     toggleTheme: z.string().default("Toggle color theme")
   }).prefault({}),
   notFound: z.object({
+    api: z.string().default("JSON API description (openapi.json)"),
     description: z.string().default("We couldn't find the page you're looking for."),
     home: z.string().default("Back to home"),
     llms: z.string().default("Docs index for AI agents (llms.txt)"),
@@ -10377,6 +10727,7 @@ var llmsTxtObjectSchema = z2.strictObject({
   openapi: z2.boolean().default(true)
 });
 var aiConfigSchema = z2.strictObject({
+  api: z2.boolean().default(true),
   ask: z2.strictObject({
     apiKeyEnv: z2.string().optional(),
     baseUrl: z2.url().optional(),
@@ -10734,6 +11085,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 +13003,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 +13126,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 +13152,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 +13195,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 +14186,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 +14222,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 +16410,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";
@@ -16150,6 +16512,23 @@ var askApiUrl = (endpoint, site, abs) => {
   }
   return site && endpoint.startsWith("/") ? absoluteUrl(site, endpoint) : endpoint;
 };
+var markdownArtifact = (config, abs) => {
+  const negotiates = config.deployment.output === "server" && (config.deployment.adapter === "vercel" || config.deployment.adapter === "cloudflare");
+  return negotiates ? { contentNegotiation: "text/markdown", pattern: abs("/{route}.md") } : { pattern: abs("/{route}.md") };
+};
+var apiArtifact = (config, abs) => {
+  if (!config.ai.api) {
+    return null;
+  }
+  const api = {
+    openapi: abs(OPENAPI_PATH),
+    pages: abs(API_PAGES_PATH)
+  };
+  if (config.deployment.output === "server") {
+    api.search = abs(API_SEARCH_PATH);
+  }
+  return api;
+};
 var wellKnownArtifacts = (config, abs) => {
   const artifacts = {};
   if (config.ai.webBotAuth.keys.length > 0) {
@@ -16174,9 +16553,13 @@ var buildAgentReadability = (project) => {
     const based = withBasePath(deployBase, path);
     return site ? absoluteUrl(site, based) : based;
   };
-  const negotiates = config.deployment.output === "server" && (config.deployment.adapter === "vercel" || config.deployment.adapter === "cloudflare");
-  const markdown = negotiates ? { contentNegotiation: "text/markdown", pattern: abs("/{route}.md") } : { pattern: abs("/{route}.md") };
-  const artifacts = { markdown };
+  const artifacts = {
+    markdown: markdownArtifact(config, abs)
+  };
+  const api = apiArtifact(config, abs);
+  if (api) {
+    artifacts.api = api;
+  }
   if (config.ai.llmsTxt.enabled) {
     artifacts.llmsFullTxt = abs("/llms-full.txt");
     artifacts.llmsTxt = abs("/llms.txt");
@@ -16632,7 +17015,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 +17074,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 +17086,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;
 };
 
@@ -16892,6 +17275,9 @@ var agentResourceLines = (project) => {
     `- [llms-full.txt](${url("/llms-full.txt")}): The full Markdown of every page in one file.`,
     `- [Page Markdown](${url("/index.md")}): Append \`.md\` to any page URL to fetch that page as raw Markdown.`
   ];
+  if (config.ai.api) {
+    lines.push(`- [JSON API](${url(API_PAGES_PATH)}): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at ${url(OPENAPI_PATH)}.`);
+  }
   if (config.ai.mcp.enabled) {
     lines.push(`- [MCP server](${url(config.ai.mcp.route)}): Streamable HTTP Model Context Protocol server with search_docs, get_page, list_pages, and get_navigation tools, plus every page as a resource. Discovery document: ${url("/.well-known/mcp.json")}`);
   }
@@ -17831,11 +18217,38 @@ ${references.join(`
 
 // src/deploy/vercel-negotiation.ts
 var ACCEPT_MARKDOWN_HEADER_VALUE = "(.*,)?\\s*text/(x-)?markdown(\\s*[;,].*)?$";
+var ACCEPT_JSON_HEADER_VALUE = "(.*,)?\\s*application/(problem\\+)?json(\\s*[;,].*)?$";
 var isString6 = (value) => typeof value === "string";
 var ACCEPT_MARKDOWN_CONDITION = [
   { key: "accept", type: "header", value: ACCEPT_MARKDOWN_HEADER_VALUE }
 ];
+var ACCEPT_JSON_CONDITION = [
+  { key: "accept", type: "header", value: ACCEPT_JSON_HEADER_VALUE }
+];
 var VARY_ACCEPT = { vary: "Accept" };
+var NOT_FOUND_MARKDOWN_DEST = "/404.md";
+var NOT_FOUND_JSON_DEST = "/404.json";
+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 NOT_FOUND_JSON_ROUTES = [
+  {
+    dest: NOT_FOUND_JSON_DEST,
+    has: ACCEPT_JSON_CONDITION,
+    headers: VARY_ACCEPT,
+    src: "^/.*$",
+    status: 404
+  },
+  { dest: NOT_FOUND_JSON_DEST, src: "^/.*\\.json$", status: 404 }
+];
 var MAX_ALTERNATION_LENGTH = 3900;
 var REGEX_SPECIALS = /[$()*+.?[\]^{|}\\]/gu;
 var routePattern = (route) => encodeURI(route).replace(REGEX_SPECIALS, "\\$&");
@@ -17891,8 +18304,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.dest === NOT_FOUND_JSON_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, notFound = {}) => {
   const overrideEntries = Object.entries(contentTypeOverrides ?? {});
   let config;
   try {
@@ -17920,6 +18333,16 @@ var injectNegotiationRoutes = (configText, routePaths, homeLinkHeader, contentTy
     });
   }
   routes.splice(filesystemIndex, 0, ...headerRoutes, ...rewriteRoutes, TRAILING_SLASH_REDIRECT);
+  const notFoundRoutes = [
+    ...notFound.markdown ? NOT_FOUND_MARKDOWN_ROUTES : [],
+    ...notFound.json ? NOT_FOUND_JSON_ROUTES : []
+  ];
+  if (notFoundRoutes.length > 0) {
+    const fallbackIndex = routes.findIndex((route) => route.status === 404 && route.dest === NOT_FOUND_HTML_DEST);
+    if (fallbackIndex !== -1) {
+      routes.splice(fallbackIndex, 0, ...notFoundRoutes);
+    }
+  }
   config.routes = routes;
   return `${JSON.stringify(config, null, "\t")}
 `;
@@ -18473,15 +18896,528 @@ 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";
 
+// src/ai/api/problem.ts
+var PROBLEM_TYPE = "application/problem+json";
+
+// src/ai/api/spec.ts
+var JSON_TYPE = "application/json";
+var MARKDOWN_TYPE = "text/markdown";
+var TEXT_TYPE = "text/plain";
+var ref = (name) => ({
+  $ref: `#/components/schemas/${name}`
+});
+var jsonResponse = (description, schema) => ({
+  content: { [JSON_TYPE]: { schema: ref(schema) } },
+  description
+});
+var problemResponse = (description) => ({
+  content: { [PROBLEM_TYPE]: { schema: ref("Problem") } },
+  description
+});
+var textResponse = (description, type) => ({
+  content: { [type]: { schema: { type: "string" } } },
+  description
+});
+var string = (description) => ({ description, type: "string" });
+var facetsSchema = {
+  additionalProperties: { type: "string" },
+  description: "Facet values the site declares for the page's content type (`content.types.<type>.facets`), key → value.",
+  type: "object"
+};
+var versionProperty = {
+  description: 'Docs version the page belongs to on a versioned site: `""` for the current docs, else an archived version id. Absent on unversioned sites.',
+  type: "string"
+};
+var searchParameters = [
+  {
+    description: "The search query.",
+    in: "query",
+    name: "q",
+    required: true,
+    schema: { minLength: 1, type: "string" }
+  },
+  {
+    description: "Maximum hits to return (default 8, at most 20).",
+    in: "query",
+    name: "limit",
+    required: false,
+    schema: { default: 8, maximum: 20, minimum: 1, type: "integer" }
+  },
+  {
+    description: "Only include pages of these content types (frontmatter `type`, e.g. `doc`, `rfc`). Comma-separated or repeated. Omit for every type.",
+    explode: false,
+    in: "query",
+    name: "contentTypes",
+    required: false,
+    schema: { items: { type: "string" }, type: "array" },
+    style: "form"
+  },
+  {
+    description: "Only include pages in this locale (e.g. `fr`). Omit for every language.",
+    in: "query",
+    name: "locale",
+    required: false,
+    schema: { type: "string" }
+  },
+  {
+    description: "Docs version to scope to on a versioned site: `latest` (the default — current docs only), `all`, or an archived version id. Ignored when the site is unversioned.",
+    in: "query",
+    name: "version",
+    required: false,
+    schema: { type: "string" }
+  },
+  {
+    description: "Only include pages matching every facet, as `filters[key]=value` pairs (e.g. `filters[status]=enforced`). Facets are metadata the site declares per content type; the page index shows each page's values.",
+    explode: true,
+    in: "query",
+    name: "filters",
+    required: false,
+    schema: { additionalProperties: { type: "string" }, type: "object" },
+    style: "deepObject"
+  }
+];
+var schemas = {
+  JsonRpcRequest: {
+    description: "A JSON-RPC 2.0 request, as the Model Context Protocol sends.",
+    properties: {
+      id: { description: "Request id (absent on notifications)." },
+      jsonrpc: { const: "2.0", type: "string" },
+      method: string("The MCP method, e.g. `initialize` or `tools/call`."),
+      params: { description: "Method parameters.", type: "object" }
+    },
+    required: ["jsonrpc", "method"],
+    type: "object"
+  },
+  JsonRpcResponse: {
+    description: "A JSON-RPC 2.0 response: a `result` or an `error`.",
+    properties: {
+      error: {
+        properties: {
+          code: { type: "integer" },
+          data: {},
+          message: { type: "string" }
+        },
+        required: ["code", "message"],
+        type: "object"
+      },
+      id: {},
+      jsonrpc: { const: "2.0", type: "string" },
+      result: { type: "object" }
+    },
+    required: ["jsonrpc"],
+    type: "object"
+  },
+  NavLink: {
+    properties: {
+      href: string("Link target — an internal route or an external URL."),
+      icon: string("Optional icon name."),
+      label: { type: "string" }
+    },
+    required: ["href", "label"],
+    type: "object"
+  },
+  NavNode: {
+    description: "A sidebar entry: a page (linking to its route) or a group holding further nodes.",
+    oneOf: [
+      {
+        properties: {
+          badge: { type: "string" },
+          deprecated: { type: "boolean" },
+          description: { type: "string" },
+          icon: { type: "string" },
+          kind: { const: "page", type: "string" },
+          label: { type: "string" },
+          pageId: string("The page's stable content id."),
+          route: string("The page's route.")
+        },
+        required: ["kind", "label", "pageId", "route"],
+        type: "object"
+      },
+      {
+        properties: {
+          badge: { type: "string" },
+          children: { items: ref("NavNode"), type: "array" },
+          collapsed: { type: "boolean" },
+          icon: { type: "string" },
+          kind: { const: "group", type: "string" },
+          label: { type: "string" },
+          path: string("The group's route prefix (not necessarily a page)."),
+          route: string("The group's index page route, when it has one.")
+        },
+        required: ["children", "kind", "label"],
+        type: "object"
+      }
+    ]
+  },
+  NavSelector: {
+    description: "A top-level partition selector (products, versions, languages).",
+    properties: {
+      items: {
+        items: {
+          properties: {
+            description: { type: "string" },
+            label: { type: "string" },
+            path: { type: "string" },
+            tag: { type: "string" }
+          },
+          required: ["label", "path"],
+          type: "object"
+        },
+        type: "array"
+      },
+      kind: { type: "string" },
+      label: { type: "string" }
+    },
+    required: ["items", "kind", "label"],
+    type: "object"
+  },
+  NavTab: {
+    properties: {
+      href: string("The clickable target when it differs from `path` (the section's first page)."),
+      icon: { type: "string" },
+      label: { type: "string" },
+      path: string("The tab's section prefix.")
+    },
+    required: ["label", "path"],
+    type: "object"
+  },
+  Navigation: {
+    description: "The docs navigation model: header tabs, the sidebar tree, partition selectors, and pinned links.",
+    properties: {
+      actions: { items: ref("NavLink"), type: "array" },
+      cta: { oneOf: [ref("NavLink"), { type: "null" }] },
+      featured: { items: ref("NavLink"), type: "array" },
+      repoUrl: { type: ["string", "null"] },
+      root: string("The tree root's route (`/`, or a locale/version prefix)."),
+      selectors: { items: ref("NavSelector"), type: "array" },
+      sidebar: { items: ref("NavNode"), type: "array" },
+      tabs: { items: ref("NavTab"), type: "array" }
+    },
+    required: ["featured", "selectors", "sidebar", "tabs"],
+    type: "object"
+  },
+  Page: {
+    allOf: [
+      ref("PageSummary"),
+      {
+        properties: {
+          markdown: string("The page as agent Markdown: frontmatter included, components downleveled to plain Markdown.")
+        },
+        required: ["markdown"],
+        type: "object"
+      }
+    ],
+    description: "A page's index entry plus its full Markdown body."
+  },
+  PageSummary: {
+    properties: {
+      contentType: string("The page's content type (frontmatter `type`)."),
+      description: { type: "string" },
+      facets: facetsSchema,
+      json: {
+        description: "This page's JSON representation (the `getPage` operation).",
+        format: "uri-reference",
+        type: "string"
+      },
+      lastModified: {
+        description: "ISO 8601 last-modified date, when known.",
+        type: ["string", "null"]
+      },
+      locale: string("The page's locale code."),
+      markdownUrl: {
+        description: "The page's raw-Markdown mirror (the `getPageMarkdown` operation).",
+        format: "uri-reference",
+        type: "string"
+      },
+      route: string("The page's route (`/guides/install`); the key every other operation takes."),
+      title: { type: "string" },
+      url: {
+        description: "Where the rendered page is served.",
+        format: "uri-reference",
+        type: "string"
+      },
+      version: versionProperty
+    },
+    required: [
+      "contentType",
+      "json",
+      "lastModified",
+      "locale",
+      "markdownUrl",
+      "route",
+      "title",
+      "url"
+    ],
+    type: "object"
+  },
+  PagesIndex: {
+    properties: {
+      count: { type: "integer" },
+      generator: string("The Blume version that built the site."),
+      pages: { items: ref("PageSummary"), type: "array" },
+      site: { type: ["string", "null"] }
+    },
+    required: ["count", "generator", "pages", "site"],
+    type: "object"
+  },
+  Problem: {
+    description: "RFC 9457 problem details, with a stable code and a resolution hint.",
+    properties: {
+      code: string("Stable error code (e.g. `PAGE_NOT_FOUND`)."),
+      detail: string("Human-readable explanation of this occurrence."),
+      instance: string("The request path the problem occurred on."),
+      links: {
+        description: "Recovery links, when there is somewhere useful to go.",
+        items: {
+          properties: { href: { type: "string" }, label: { type: "string" } },
+          required: ["href", "label"],
+          type: "object"
+        },
+        type: "array"
+      },
+      resolution: string("What to do next."),
+      status: { type: "integer" },
+      title: { type: "string" },
+      type: string("Problem type URI; `about:blank` by default.")
+    },
+    required: ["code", "detail", "resolution", "status", "title", "type"],
+    type: "object"
+  },
+  SearchHit: {
+    properties: {
+      contentType: { type: "string" },
+      excerpt: string("The page description, else the start of its content."),
+      facets: facetsSchema,
+      route: string("The page's route; pass it to `getPage`."),
+      title: { type: "string" },
+      url: { format: "uri-reference", type: "string" },
+      version: versionProperty
+    },
+    required: ["excerpt", "route", "title", "url"],
+    type: "object"
+  },
+  SearchResponse: {
+    properties: {
+      count: { type: "integer" },
+      query: { type: "string" },
+      results: { items: ref("SearchHit"), type: "array" }
+    },
+    required: ["count", "query", "results"],
+    type: "object"
+  }
+};
+var ROUTE_PARAM = {
+  description: "The page route without its leading slash (`guides/install`), or `index` for the home page. May contain slashes.",
+  in: "path",
+  name: "route",
+  required: true,
+  schema: { type: "string" }
+};
+var serverUrl = (input) => {
+  if (input.site) {
+    return input.base ? absoluteUrl(input.site, input.base) : siteRoot(input.site);
+  }
+  return input.base || "/";
+};
+var buildApiSpec = (input) => {
+  const pathEntries = [
+    [
+      API_PAGES_PATH,
+      {
+        get: {
+          description: "Every documentation page with its route, title, description, content type, locale, facets, and the URLs of its rendered, Markdown, and JSON forms. Unfiltered; on a versioned site every version is listed with its `version`. Use it to enumerate the docs or to find a page when search is too narrow.",
+          operationId: "listPages",
+          responses: {
+            "200": jsonResponse("The page index.", "PagesIndex"),
+            default: problemResponse("An error, as problem details.")
+          },
+          summary: "List every page",
+          tags: ["Pages"]
+        }
+      }
+    ],
+    [
+      API_PAGE_PATH,
+      {
+        get: {
+          description: "A single page as JSON: its index entry plus the page's agent Markdown (frontmatter included, components downleveled to plain Markdown). Take `route` from `listPages` or `searchDocs`.",
+          operationId: "getPage",
+          parameters: [ROUTE_PARAM],
+          responses: {
+            "200": jsonResponse("The page.", "Page"),
+            "404": problemResponse("No page has that route."),
+            default: problemResponse("An error, as problem details.")
+          },
+          summary: "Get a page as JSON",
+          tags: ["Pages"]
+        }
+      }
+    ],
+    [
+      API_NAVIGATION_PATH,
+      {
+        get: {
+          description: "The navigation tree (header tabs and the sidebar hierarchy) as readers see it, for the default locale and the current docs.",
+          operationId: "getNavigation",
+          responses: {
+            "200": jsonResponse("The navigation tree.", "Navigation"),
+            default: problemResponse("An error, as problem details.")
+          },
+          summary: "Get the navigation tree",
+          tags: ["Navigation"]
+        }
+      }
+    ]
+  ];
+  if (input.search) {
+    pathEntries.push([
+      API_SEARCH_PATH,
+      {
+        get: {
+          description: "Full-text search across the documentation. Returns matching pages with their title, route, content type, and a short excerpt; narrow by content type, locale, version, or facet. Use it first to discover relevant pages, then `getPage` to read one in full.",
+          operationId: "searchDocs",
+          parameters: searchParameters,
+          responses: {
+            "200": jsonResponse("The matching pages, best first.", "SearchResponse"),
+            "400": problemResponse("The query was missing or blank."),
+            default: problemResponse("An error, as problem details.")
+          },
+          summary: "Search the docs",
+          tags: ["Search"]
+        }
+      }
+    ]);
+  }
+  pathEntries.push([
+    "/{route}.md",
+    {
+      get: {
+        description: "A page's raw-Markdown mirror: append `.md` to any page URL. Components are downleveled to plain Markdown; `.mdx` serves the source as written. The same body the `getPage` operation carries in its `markdown` field.",
+        operationId: "getPageMarkdown",
+        parameters: [ROUTE_PARAM],
+        responses: {
+          "200": textResponse("The page as Markdown.", MARKDOWN_TYPE),
+          "404": textResponse("No page has that route; the body lists where to look next.", MARKDOWN_TYPE)
+        },
+        summary: "Get a page as Markdown",
+        tags: ["Markdown"]
+      }
+    }
+  ]);
+  if (input.llmsTxt) {
+    pathEntries.push([
+      "/llms.txt",
+      {
+        get: {
+          description: "The llms.txt index: the site's summary, when to use it, and every page with a one-line description, grouped by section.",
+          operationId: "getLlmsTxt",
+          responses: {
+            "200": textResponse("The index.", TEXT_TYPE)
+          },
+          summary: "Get llms.txt",
+          tags: ["Markdown"]
+        }
+      }
+    ], [
+      "/llms-full.txt",
+      {
+        get: {
+          description: "The full Markdown of every current-docs page in one file.",
+          operationId: "getLlmsFullTxt",
+          responses: {
+            "200": textResponse("Every page's Markdown.", TEXT_TYPE)
+          },
+          summary: "Get llms-full.txt",
+          tags: ["Markdown"]
+        }
+      }
+    ]);
+  }
+  if (input.agentReadability) {
+    pathEntries.push([
+      "/agent-readability.json",
+      {
+        get: {
+          description: "A manifest indexing every agent-facing artifact the site publishes — this API, the Markdown mirrors, llms.txt, the MCP server, feeds, and the sitemap.",
+          operationId: "getAgentReadability",
+          responses: {
+            "200": {
+              content: { [JSON_TYPE]: { schema: { type: "object" } } },
+              description: "The manifest."
+            }
+          },
+          summary: "Get the agent-readability manifest",
+          tags: ["Discovery"]
+        }
+      }
+    ]);
+  }
+  if (input.mcpRoute) {
+    pathEntries.push([
+      input.mcpRoute,
+      {
+        post: {
+          description: "The Model Context Protocol server (Streamable HTTP, stateless, JSON responses). Tools: `search_docs`, `get_page`, `list_pages`, `get_navigation` — the same operations this API exposes — plus every page as a `text/markdown` resource. Discovery document at `/.well-known/mcp.json`.",
+          operationId: "mcp",
+          requestBody: {
+            content: { [JSON_TYPE]: { schema: ref("JsonRpcRequest") } },
+            required: true
+          },
+          responses: {
+            "200": jsonResponse("The JSON-RPC response.", "JsonRpcResponse")
+          },
+          summary: "Call the MCP server",
+          tags: ["MCP"]
+        }
+      }
+    ]);
+  }
+  const tags = [
+    { description: "Enumerate and read documentation pages.", name: "Pages" },
+    ...input.search ? [{ description: "Full-text search over the docs.", name: "Search" }] : [],
+    { description: "How the docs are organized.", name: "Navigation" },
+    { description: "Plain-text and Markdown surfaces.", name: "Markdown" },
+    ...input.agentReadability ? [{ description: "Agent discovery documents.", name: "Discovery" }] : [],
+    ...input.mcpRoute ? [{ description: "The Model Context Protocol endpoint.", name: "MCP" }] : []
+  ];
+  const info = {
+    description: [
+      `Read-only JSON API over the ${input.name} documentation${input.description ? `: ${input.description}` : "."}`,
+      "Every operation is public and needs no authentication. Errors are RFC 9457 problem details (`application/problem+json`) with a stable `code`, a `detail`, and a `resolution` hint."
+    ].join(`
+
+`),
+    title: `${input.name} API`,
+    version: input.version,
+    "x-generator": `blume@${input.version}`
+  };
+  const document = {
+    components: { schemas },
+    info,
+    openapi: "3.1.0",
+    paths: Object.fromEntries(pathEntries),
+    security: [],
+    servers: [{ description: input.name, url: serverUrl(input) }],
+    tags
+  };
+  if (input.site) {
+    document.externalDocs = {
+      description: `${input.name} documentation`,
+      url: absoluteUrl(input.site, withBasePath(input.base, "/"))
+    };
+  }
+  return document;
+};
+
 // src/ai/ask-data.ts
 var buildAskData = async (project) => {
   const documents = await buildSearchDocuments(project, {
@@ -18605,7 +19541,7 @@ var MCP_TOOLS = [
 ];
 
 // src/ai/mcp/discovery.ts
-var serverUrl = (input) => {
+var serverUrl2 = (input) => {
   const path = withBasePath(input.base, input.route);
   return input.site ? absoluteUrl(input.site, path) : path;
 };
@@ -18614,7 +19550,7 @@ var buildMcpDiscovery = (input) => ({
     {
       name: input.name,
       transport: "streamable-http",
-      url: serverUrl(input)
+      url: serverUrl2(input)
     }
   ]
 });
@@ -18635,7 +19571,7 @@ var reverseDnsName = (input) => {
 };
 var HTTP_URL2 = /^https?:\/\//u;
 var buildMcpServerCard = (input) => {
-  const url = serverUrl(input);
+  const url = serverUrl2(input);
   const card2 = {
     $schema: SERVER_CARD_SCHEMA,
     capabilities: {
@@ -19285,54 +20221,52 @@ var specConfiguration = async (spec, root) => {
     };
   }
 };
-var acceptScalarReference = (ref, seen, contentRoutes, warnings) => {
-  if (ref.renderer !== "scalar") {
+var acceptScalarReference = (ref2, seen, contentRoutes, warnings) => {
+  if (ref2.renderer !== "scalar") {
     return null;
   }
-  if (seen.has(ref.route)) {
-    warnings.push(`Two API reference sources resolve to ${ref.route}; keeping the first.`);
+  if (seen.has(ref2.route)) {
+    warnings.push(`Two API reference sources resolve to ${ref2.route}; keeping the first.`);
     return null;
   }
-  if (contentRoutes.has(ref.route)) {
-    warnings.push(`API reference route ${ref.route} collides with a content page; skipping the reference there.`);
+  if (contentRoutes.has(ref2.route)) {
+    warnings.push(`API reference route ${ref2.route} collides with a content page; skipping the reference there.`);
     return null;
   }
-  seen.add(ref.route);
-  return ref;
+  seen.add(ref2.route);
+  return ref2;
 };
 var buildReferenceFiles = async (options) => {
   const { config, root, contentRoutes } = options;
   const warnings = [];
   const seen = new Set;
   const accepted = [];
-  for (const ref of resolveReferences(config)) {
-    const next = acceptScalarReference(ref, seen, contentRoutes, warnings);
+  for (const ref2 of resolveReferences(config)) {
+    const next = acceptScalarReference(ref2, seen, contentRoutes, warnings);
     if (next) {
       accepted.push(next);
     }
   }
-  const built = await Promise.all(accepted.map(async (ref) => ({
-    ref,
-    spec: await specConfiguration(ref.spec, root)
+  const built = await Promise.all(accepted.map(async (ref2) => ({
+    ref: ref2,
+    spec: await specConfiguration(ref2.spec, root)
   })));
   const files = [];
-  for (const { ref, spec } of built) {
+  for (const { ref: ref2, spec } of built) {
     if (spec.warning) {
       warnings.push(spec.warning);
     }
-    const pagePath = referencePagePath(ref.route);
-    const depth = pagePath.split("/").length - 1;
+    const pagePath = referencePagePath(ref2.route);
     files.push({
       content: scalarReferenceTemplate({
         configuration: {
           ...spec.config,
-          ...themeConfiguration(config, ref.theme),
-          ...ref.scalar
+          ...themeConfiguration(config, ref2.theme),
+          ...ref2.scalar
         },
-        dataImport: `${"../".repeat(depth + 1)}generated/data.json`,
-        noindex: ref.noindex,
-        route: ref.route,
-        title: ref.label
+        noindex: ref2.noindex,
+        route: ref2.route,
+        title: ref2.label
       }),
       pagePath
     });
@@ -20150,7 +21084,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 +21111,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 +21310,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 +21402,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 +21438,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 +21457,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 +21502,7 @@ var resolvedAstroHit = (fromDir) => {
     if (pkg) {
       return { modulesDir, pkg };
     }
-    const parent = dirname13(dir);
+    const parent = dirname14(dir);
     if (parent === dir) {
       return null;
     }
@@ -20564,7 +21518,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 +21533,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 +21670,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 +21701,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 +21946,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}`;
@@ -21040,6 +21998,7 @@ var buildRuntimeData = (project) => {
       description: config.description,
       discovery: {
         agentReadability: config.seo.agentReadability,
+        api: config.ai.api,
         llmsTxt: config.ai.llmsTxt.enabled,
         sitemap: config.seo.sitemap && Boolean(config.deployment.site)
       },
@@ -21109,6 +22068,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 +22127,18 @@ var planMcp = (project, srcDir, userPages) => {
     enabled: true
   };
 };
-var writeMcpFiles = async (project, plan, write) => {
-  if (!plan.enabled) {
-    return;
+var publishAgentData = async (project, plans, modules) => {
+  if (!(plans.mcp.enabled || plans.api.enabled)) {
+    return null;
   }
   const data = await buildMcpData(project);
+  modules.set("blume:mcp-data", JSON.stringify(data));
+  return data;
+};
+var writeMcpFiles = async (plan, write, data) => {
+  if (!(plan.enabled && data)) {
+    return;
+  }
   const discoveryInput = {
     base: data.base,
     name: data.name,
@@ -21180,13 +22147,57 @@ 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)))
   ]);
 };
+var ownsApiRest = (page) => page.pattern.startsWith("/api/[");
+var contentUnderApi = (page) => page.route === "/api" || page.route.startsWith("/api/");
+var planApi = (project, srcDir, userPages) => {
+  const { config, context } = project;
+  const server = config.deployment.output === "server";
+  return {
+    catchAll: server && !userPages.some(ownsApiRest) && !project.graph.pages.some(contentUnderApi),
+    enabled: config.ai.api,
+    server,
+    spec: !routeIsTaken(userPages, project.graph.pages, OPENAPI_PATH) && !existsSync17(join31(context.root, "public", "openapi.json")),
+    srcDir
+  };
+};
+var writeApiFiles = async (project, plan, write, data, mcp) => {
+  if (!(plan.enabled && data)) {
+    return;
+  }
+  const { config } = project;
+  const mcpRoute = mcp.enabled ? mcp.route : null;
+  const apiDir = join31(plan.srcDir, "pages", "api");
+  const writes = [
+    write(join31(apiDir, "docs", "pages.json.ts"), apiPagesIndexTemplate()),
+    write(join31(apiDir, "docs", "pages", "[...route].json.ts"), apiPageTemplate()),
+    write(join31(apiDir, "docs", "navigation.json.ts"), apiNavigationTemplate())
+  ];
+  if (plan.server) {
+    writes.push(write(join31(apiDir, "docs", "search.ts"), apiSearchTemplate()));
+  }
+  if (plan.catchAll) {
+    writes.push(write(join31(apiDir, "[...path].ts"), apiNotFoundTemplate({ base: data.base, site: data.site })));
+  }
+  if (plan.spec) {
+    writes.push(write(join31(plan.srcDir, "pages", "openapi.json.ts"), staticJsonEndpointTemplate(buildApiSpec({
+      agentReadability: config.seo.agentReadability,
+      base: data.base,
+      description: config.description,
+      llmsTxt: config.ai.llmsTxt.enabled,
+      mcpRoute,
+      name: config.title,
+      search: plan.server,
+      site: data.site,
+      version: data.version
+    }))));
+  }
+  await Promise.all(writes);
+};
 var planPlaygroundProxy = (config, srcDir) => ({
   enabled: needsPlaygroundProxy(config),
   entrypoint: join31(srcDir, "blume-openapi", "api-proxy.ts"),
@@ -21223,15 +22234,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 +22252,11 @@ 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()),
+    write(join31(srcDir, "pages", "404.json.ts"), notFoundJsonTemplate())
+  ]);
 };
 var diagnosticWarning = (diagnostic) => diagnostic.suggestion ? `${diagnostic.message} ${diagnostic.suggestion}` : diagnostic.message;
 var buildComponentSlots = async (componentsFile) => {
@@ -21274,18 +22288,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 +22319,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),
@@ -21331,6 +22345,8 @@ var generateRuntime = async (project) => {
   const changelogIndex = hasGeneratedChangelog(project, pages);
   const mcp = planMcp(project, srcDir, pages);
   pages.push(...mcp.discoveryPages);
+  const api = planApi(project, srcDir, pages);
+  const agentData = await publishAgentData(project, { api, mcp }, modules);
   const openApiSource2 = project.sources.find(isOpenApiSource);
   const openApiData = openApiSource2 ? openApiSource2.openApiData() : {};
   const playgroundProxy = planPlaygroundProxy(config, srcDir);
@@ -21353,14 +22369,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 +22402,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 +22418,16 @@ 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(mcp, write, agentData),
+    writeApiFiles(project, api, write, agentData, mcp),
     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 +22450,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 +22459,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 +22509,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 +22664,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 +22688,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 +22732,11 @@ 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 staticDir = join33(root, ".vercel", "output", "static");
+  const injected = injectNegotiationRoutes(await readFile20(configPath, "utf-8"), routePaths, buildHomeLinkHeader(config2, routePaths), overrides, home ? markdownTokenCount(agentMarkdown(home)) : undefined, {
+    json: existsSync19(join33(staticDir, "404.json")),
+    markdown: existsSync19(join33(staticDir, "404.md"))
+  });
   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 +23280,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 +23386,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 +23400,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 +23473,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 +23499,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 +23535,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 +23549,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 +23572,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 +23624,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 +23675,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 +23815,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 +23950,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 +24054,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 +24130,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 +24218,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 +24294,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 +24354,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 +24381,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 +25005,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 +25019,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 +25189,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);
@@ -24213,6 +25236,9 @@ import {
   McpError,
   ReadResourceRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
+import { z as z8 } from "zod";
+
+// src/ai/mcp/query.ts
 import { z as z7 } from "zod";
 
 // src/search/orama-index.ts
@@ -24356,13 +25382,10 @@ var queryOramaIndex = async (db, term, limit, filters) => {
   return found.hits.map((hit) => hit.document);
 };
 
-// src/ai/mcp/server.ts
+// src/ai/mcp/query.ts
 var DEFAULT_SEARCH_LIMIT = 8;
 var MAX_SEARCH_LIMIT = 20;
 var EXCERPT_LENGTH = 200;
-var RESOURCE_MIME_TYPE = "text/markdown";
-var RESOURCE_NOT_FOUND = -32002;
-var LOCAL_RESOURCE_SCHEME = "blume:";
 var contentTypesField = z7.preprocess((value) => {
   const list2 = (Array.isArray(value) ? value : [value]).filter((entry) => typeof entry === "string");
   return list2.length > 0 ? list2 : undefined;
@@ -24414,21 +25437,6 @@ var TOOL_INPUTS = {
     version: versionField
   })
 };
-var inputSchemaFor = (schema) => {
-  const {
-    $schema: _dialect,
-    additionalProperties: _closed,
-    ...rest
-  } = z7.toJSONSchema(schema);
-  return rest;
-};
-var TOOL_DEFINITIONS = MCP_TOOLS.map((tool) => ({
-  annotations: tool.annotations,
-  description: tool.description,
-  inputSchema: inputSchemaFor(TOOL_INPUTS[tool.name]),
-  name: tool.name,
-  title: tool.title
-}));
 var matchesFacets = (facets, filters) => Object.entries(filters).every(([key, value]) => facets?.[key] === value);
 var asVersionScope = (value, data) => {
   if (!data.archivedVersions) {
@@ -24460,8 +25468,6 @@ var urlFor = (route, data) => {
   const path = withBasePath(data.base, route);
   return data.site ? absoluteUrl(data.site, path) : path;
 };
-var resourceUri = (route, data) => data.site ? urlFor(route, data) : `${LOCAL_RESOURCE_SCHEME}${withBasePath(data.base, route)}`;
-var resourceRoute = (uri, data) => normalizeRoute2(uri.startsWith(LOCAL_RESOURCE_SCHEME) ? uri.slice(LOCAL_RESOURCE_SCHEME.length) : uri, data);
 var excerptFor = (doc) => {
   if (doc.description) {
     return doc.description;
@@ -24469,10 +25475,6 @@ var excerptFor = (doc) => {
   const head = doc.content.slice(0, EXCERPT_LENGTH).trim();
   return doc.content.length > EXCERPT_LENGTH ? `${head}…` : head;
 };
-var text = (value, isError = false) => {
-  const content = [{ text: value, type: "text" }];
-  return isError ? { content, isError: true } : { content };
-};
 var createIndexProvider = (documents, locale) => {
   let dbPromise = null;
   return function provideIndex() {
@@ -24480,6 +25482,90 @@ var createIndexProvider = (documents, locale) => {
     return dbPromise;
   };
 };
+var searchDocs = async (data, index, input) => {
+  const db = await index();
+  const hits = await queryOramaIndex(db, input.query, input.limit ?? DEFAULT_SEARCH_LIMIT, {
+    contentTypes: input.contentTypes,
+    facets: input.filters,
+    locale: input.locale,
+    version: asVersionScope(input.version, data)
+  });
+  return hits.map((doc) => {
+    const hit = {
+      contentType: doc.contentType,
+      excerpt: excerptFor(doc),
+      facets: doc.facets,
+      route: doc.route,
+      title: doc.title,
+      url: urlFor(doc.route, data)
+    };
+    if (data.archivedVersions) {
+      hit.version = doc.version ?? "";
+    }
+    return hit;
+  });
+};
+var getPageMarkdown = (data, route) => data.pages[route];
+var listPages = (data, input) => {
+  const { contentTypes, filters, locale } = input;
+  const versionScope = asVersionScope(input.version, data);
+  return data.routes.filter((route) => (!contentTypes || contentTypes.includes(route.contentType)) && (!filters || matchesFacets(route.facets, filters)) && (!locale || route.locale === locale) && (versionScope === undefined || route.version === versionScope)).map((route) => {
+    const listing = {
+      contentType: route.contentType,
+      description: route.description,
+      facets: route.facets,
+      lastModified: route.lastModified,
+      route: route.route,
+      title: route.title,
+      url: urlFor(route.route, data)
+    };
+    if (data.archivedVersions) {
+      listing.version = route.version;
+    }
+    return listing;
+  });
+};
+var getNavigation = (data, input) => {
+  const { locale, version: versionId } = input;
+  const unknownVersion = unknownVersionError(versionId, data);
+  if (unknownVersion) {
+    return { error: unknownVersion };
+  }
+  let { navigation } = data;
+  const byLocale = versionId ? data.navigationByVersion?.[versionId] : undefined;
+  if (byLocale) {
+    navigation = (locale ? byLocale[locale] : undefined) ?? byLocale[data.defaultLocale ?? ""] ?? Object.values(byLocale)[0] ?? navigation;
+  } else if (locale && data.navigationByLocale?.[locale]) {
+    navigation = data.navigationByLocale[locale];
+  }
+  return { navigation };
+};
+
+// src/ai/mcp/server.ts
+var RESOURCE_MIME_TYPE = "text/markdown";
+var RESOURCE_NOT_FOUND = -32002;
+var LOCAL_RESOURCE_SCHEME = "blume:";
+var inputSchemaFor = (schema) => {
+  const {
+    $schema: _dialect,
+    additionalProperties: _closed,
+    ...rest
+  } = z8.toJSONSchema(schema);
+  return rest;
+};
+var TOOL_DEFINITIONS = MCP_TOOLS.map((tool) => ({
+  annotations: tool.annotations,
+  description: tool.description,
+  inputSchema: inputSchemaFor(TOOL_INPUTS[tool.name]),
+  name: tool.name,
+  title: tool.title
+}));
+var resourceUri = (route, data) => data.site ? urlFor(route, data) : `${LOCAL_RESOURCE_SCHEME}${withBasePath(data.base, route)}`;
+var resourceRoute = (uri, data) => normalizeRoute2(uri.startsWith(LOCAL_RESOURCE_SCHEME) ? uri.slice(LOCAL_RESOURCE_SCHEME.length) : uri, data);
+var text = (value, isError = false) => {
+  const content = [{ text: value, type: "text" }];
+  return isError ? { content, isError: true } : { content };
+};
 var buildServer = (data, index) => {
   const capabilities = { resources: {}, tools: {} };
   const serverOptions = data.instructions ? { capabilities, instructions: data.instructions } : { capabilities };
@@ -24503,7 +25589,7 @@ var buildServer = (data, index) => {
   }));
   server.setRequestHandler(ReadResourceRequestSchema, (request2) => {
     const { uri } = request2.params;
-    const markdown = data.pages[resourceRoute(uri, data)];
+    const markdown = getPageMarkdown(data, resourceRoute(uri, data));
     if (markdown === undefined) {
       throw new McpError(RESOURCE_NOT_FOUND, `No page found at "${uri}". Use resources/list or list_pages to find valid URIs.`);
     }
@@ -24514,74 +25600,28 @@ var buildServer = (data, index) => {
   server.setRequestHandler(CallToolRequestSchema, async (request2) => {
     const { arguments: args = {}, name } = request2.params;
     if (name === "search_docs") {
-      const input = TOOL_INPUTS.search_docs.parse(args);
-      const db = await index();
-      const hits = await queryOramaIndex(db, input.query, input.limit ?? DEFAULT_SEARCH_LIMIT, {
-        contentTypes: input.contentTypes,
-        facets: input.filters,
-        locale: input.locale,
-        version: asVersionScope(input.version, data)
-      });
-      const results = hits.map((doc) => {
-        const hit = {
-          contentType: doc.contentType,
-          excerpt: excerptFor(doc),
-          facets: doc.facets,
-          route: doc.route,
-          title: doc.title,
-          url: urlFor(doc.route, data)
-        };
-        if (data.archivedVersions) {
-          hit.version = doc.version ?? "";
-        }
-        return hit;
-      });
+      const results = await searchDocs(data, index, TOOL_INPUTS.search_docs.parse(args));
       return text(JSON.stringify(results, null, 2));
     }
     if (name === "get_page") {
       const input = TOOL_INPUTS.get_page.parse(args);
       const key = normalizeRoute2(input.route, data);
-      const markdown = data.pages[key];
+      const markdown = getPageMarkdown(data, key);
       if (markdown === undefined) {
         return text(`No page found at "${key}". Use list_pages or search_docs to find valid routes.`, true);
       }
       return text(markdown);
     }
     if (name === "list_pages") {
-      const input = TOOL_INPUTS.list_pages.parse(args);
-      const { contentTypes, filters, locale } = input;
-      const versionScope = asVersionScope(input.version, data);
-      const routes = data.routes.filter((route) => (!contentTypes || contentTypes.includes(route.contentType)) && (!filters || matchesFacets(route.facets, filters)) && (!locale || route.locale === locale) && (versionScope === undefined || route.version === versionScope));
-      return text(JSON.stringify(routes.map((route) => {
-        const listing = {
-          contentType: route.contentType,
-          description: route.description,
-          facets: route.facets,
-          lastModified: route.lastModified,
-          route: route.route,
-          title: route.title,
-          url: urlFor(route.route, data)
-        };
-        if (data.archivedVersions) {
-          listing.version = route.version;
-        }
-        return listing;
-      }), null, 2));
+      const listing = listPages(data, TOOL_INPUTS.list_pages.parse(args));
+      return text(JSON.stringify(listing, null, 2));
     }
     if (name === "get_navigation") {
-      const { locale, version: versionId } = TOOL_INPUTS.get_navigation.parse(args);
-      const unknownVersion = unknownVersionError(versionId, data);
-      if (unknownVersion) {
-        return text(unknownVersion, true);
+      const result = getNavigation(data, TOOL_INPUTS.get_navigation.parse(args));
+      if ("error" in result) {
+        return text(result.error, true);
       }
-      let { navigation } = data;
-      const byLocale = versionId ? data.navigationByVersion?.[versionId] : undefined;
-      if (byLocale) {
-        navigation = (locale ? byLocale[locale] : undefined) ?? byLocale[data.defaultLocale ?? ""] ?? Object.values(byLocale)[0] ?? navigation;
-      } else if (locale && data.navigationByLocale?.[locale]) {
-        navigation = data.navigationByLocale[locale];
-      }
-      return text(JSON.stringify(navigation, null, 2));
+      return text(JSON.stringify(result.navigation, null, 2));
     }
     return text(`Unknown tool: ${name}`, true);
   });
@@ -24733,11 +25773,11 @@ var translateAgentArgs = (kind, lastMessagePath) => kind === "claude" ? claudeAr
 import { createHash as createHash5 } from "node:crypto";
 import { readFile as readFile26 } from "node:fs/promises";
 import { join as join45 } from "pathe";
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 var LEDGER_FILE = "blume.translations.json";
-var ledgerSchema = z8.object({
-  files: z8.record(z8.string(), z8.record(z8.string(), z8.string())),
-  version: z8.literal(1)
+var ledgerSchema = z9.object({
+  files: z9.record(z9.string(), z9.record(z9.string(), z9.string())),
+  version: z9.literal(1)
 });
 var emptyLedger = () => ({
   files: {},
@@ -25004,7 +26044,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 +26067,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 +26096,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 +26410,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 +26461,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 +26477,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 +26518,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 +26531,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 +26558,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 +26792,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 +26807,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 +26882,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;
@@ -25874,18 +26914,18 @@ var checkPathLink = (resolved, fragment, page2, link, site, ctx, via = "") => {
   };
 };
 var checkExternalLinks = async (refs) => {
-  const results = await probeAll(refs.map((ref) => ref.url));
+  const results = await probeAll(refs.map((ref2) => ref2.url));
   const diagnostics = [];
-  for (const ref of refs) {
-    const result = results.get(ref.url);
+  for (const ref2 of refs) {
+    const result = results.get(ref2.url);
     const grade = result ? gradeExternal(result) : null;
     if (grade) {
       diagnostics.push({
         code: "BLUME_DEAD_LINK",
-        column: ref.column,
-        file: ref.file,
-        line: ref.line,
-        message: `External link ${ref.url} is unreachable (${grade.detail}).`,
+        column: ref2.column,
+        file: ref2.file,
+        line: ref2.line,
+        message: `External link ${ref2.url} is unreachable (${grade.detail}).`,
         severity: grade.severity
       });
     }
@@ -25939,7 +26979,7 @@ var validateLinks = async (graph, options) => {
   let uncheckedAssets = 0;
   for (const page2 of graph.pages) {
     for (const link of page2.links) {
-      const result = classifyLink(page2, link, ctx, (ref) => external.push(ref));
+      const result = classifyLink(page2, link, ctx, (ref2) => external.push(ref2));
       if (result === "asset-unchecked") {
         uncheckedAssets += 1;
       } else if (result) {
@@ -26055,7 +27095,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 +27110,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 +27186,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 +27254,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 +27332,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 +27375,7 @@ process.on("unhandledRejection", (error) => {
   reportInternalError(error);
   process.exit(1);
 });
-runMain(main);
+runMain(main, { rawArgs: normalizeHostArgs(process.argv.slice(2)) });
 
-//# debugId=6AEF08BD7421838D64756E2164756E21
+//# debugId=9AB8E5F1D71CCEF764756E2164756E21
 //# sourceMappingURL=index.js.map