blume 0.4.0 → 0.5.0

package/dist/cli/index.js

@@ -513,11 +513,11 @@ Next steps:
 });
 
 // src/cli/commands/build.ts
-import { existsSync as existsSync16 } from "node:fs";
-import { readdir, stat, writeFile as writeFile6 } from "node:fs/promises";
+import { existsSync as existsSync17 } from "node:fs";
+import { readdir, stat, writeFile as writeFile7 } from "node:fs/promises";
 import { build } from "astro";
 import { defineCommand as defineCommand2 } from "citty";
-import { join as join26 } from "pathe";
+import { join as join28 } from "pathe";
 
 // src/core/frontmatter.ts
 import baseMatter from "gray-matter";
@@ -608,6 +608,29 @@ var buildLlmsFiles = async (project) => ({
   index: buildIndex(project)
 });
 
+// src/core/gitignore.ts
+import { existsSync as existsSync3 } from "node:fs";
+import { readFile as readFile3, writeFile as writeFile2 } from "node:fs/promises";
+import { join as join5 } from "pathe";
+var gitignoreKey = (line) => line.trim().replace(/\/+$/u, "");
+var ensureGitignore = async (root, entries) => {
+  const path = join5(root, ".gitignore");
+  const existing = existsSync3(path) ? await readFile3(path, "utf-8") : "";
+  const present = new Set(existing.split(`
+`).map(gitignoreKey).filter(Boolean));
+  const added = entries.filter((entry) => !present.has(gitignoreKey(entry)));
+  if (added.length === 0) {
+    return [];
+  }
+  const gap = existing.length > 0 && !existing.endsWith(`
+`) ? `
+` : "";
+  await writeFile2(path, `${existing}${gap}${added.join(`
+`)}
+`, "utf-8");
+  return added;
+};
+
 // src/search/providers.ts
 var SEARCH_PROVIDERS = {
   algolia: {
@@ -739,7 +762,7 @@ ${urls.join(`
 };
 
 // src/search/build.ts
-import { join as join5 } from "pathe";
+import { join as join6 } from "pathe";
 var buildSearchIndex = async (outDir) => {
   const pagefind = await import("pagefind");
   const { index } = await pagefind.createIndex({});
@@ -747,7 +770,7 @@ var buildSearchIndex = async (outDir) => {
     throw new Error("Failed to create Pagefind index.");
   }
   const result = await index.addDirectory({ path: outDir });
-  await index.writeFiles({ outputPath: join5(outDir, "pagefind") });
+  await index.writeFiles({ outputPath: join6(outDir, "pagefind") });
   await pagefind.close();
   return result.page_count;
 };
@@ -2791,17 +2814,59 @@ var syncSearchProvider = async (project, reporter) => {
 
 // src/cli/dev-lock.ts
 import {
-  existsSync as existsSync3,
+  existsSync as existsSync5,
   mkdirSync,
   readFileSync as readFileSync2,
   rmSync,
   writeFileSync
 } from "node:fs";
-import { join as join6 } from "pathe";
-var lockPath = (outDir) => join6(outDir, "dev.lock");
+import { join as join8 } from "pathe";
+
+// src/core/project.ts
+import { existsSync as existsSync4 } from "node:fs";
+import { isAbsolute, join as join7, resolve as resolve2 } from "pathe";
+var CONFIG_FILENAMES = [
+  "blume.config.ts",
+  "blume.config.mjs",
+  "blume.config.js"
+];
+var THEME_FILENAMES = ["theme.css"];
+var COMPONENTS_FILENAMES = ["components.tsx", "components.ts"];
+var firstExisting = (root, names) => {
+  for (const name of names) {
+    const candidate = join7(root, name);
+    if (existsSync4(candidate)) {
+      return candidate;
+    }
+  }
+  return null;
+};
+var findConfigFile = (root) => firstExisting(root, CONFIG_FILENAMES);
+var resolveRuntimeDir = (root, runtimeDir = ".blume") => isAbsolute(runtimeDir) ? runtimeDir : join7(resolve2(root), runtimeDir);
+var resolveProjectContext = (root, config, options) => {
+  const absoluteRoot = resolve2(root);
+  const contentRoot = isAbsolute(config.content.root) ? config.content.root : join7(absoluteRoot, config.content.root);
+  const pagesPath = join7(absoluteRoot, config.content.pages);
+  const pagesRoot = existsSync4(pagesPath) ? pagesPath : null;
+  const outDir = resolveRuntimeDir(absoluteRoot, options?.runtimeDir);
+  const distDir = options?.runtimeDir ? join7(outDir, "dist") : join7(absoluteRoot, "dist");
+  return {
+    componentsFile: firstExisting(absoluteRoot, COMPONENTS_FILENAMES),
+    configFile: findConfigFile(absoluteRoot),
+    contentRoot,
+    distDir,
+    outDir,
+    pagesRoot,
+    root: absoluteRoot,
+    themeFile: firstExisting(absoluteRoot, THEME_FILENAMES)
+  };
+};
+
+// src/cli/dev-lock.ts
+var lockPath = (outDir) => join8(outDir, "dev.lock");
 var isDevLocked = (outDir) => {
   const path = lockPath(outDir);
-  if (!existsSync3(path)) {
+  if (!existsSync5(path)) {
     return false;
   }
   const pid = Number.parseInt(readFileSync2(path, "utf-8").trim(), 10);
@@ -2826,33 +2891,33 @@ var acquireDevLock = (outDir) => {
     }
     released = true;
     try {
-      if (existsSync3(path) && readFileSync2(path, "utf-8").trim() === String(process.pid)) {
+      if (existsSync5(path) && readFileSync2(path, "utf-8").trim() === String(process.pid)) {
         rmSync(path, { force: true });
       }
     } catch {}
   };
 };
-var refuseIfDevRunning = (root, action) => {
-  if (isDevLocked(join6(root, ".blume"))) {
-    logger.error(`A \`blume dev\` server is running against .blume; ${action} would corrupt it. Stop the dev server first.`);
+var refuseIfDevRunning = (root, action, runtimeDir) => {
+  if (isDevLocked(resolveRuntimeDir(root, runtimeDir))) {
+    logger.error(`A \`blume dev\` server is running against .blume; ${action} would corrupt it. Stop the dev server, or re-run with --isolated to build/verify against .blume-verify without touching it.`);
     process.exit(1);
   }
 };
 
 // src/astro/generate.ts
-import { existsSync as existsSync7, readFileSync as readFileSync6, realpathSync } from "node:fs";
+import { existsSync as existsSync9, readFileSync as readFileSync6, realpathSync } from "node:fs";
 import {
   lstat,
-  mkdir as mkdir2,
-  readFile as readFile7,
+  mkdir as mkdir3,
+  readFile as readFile10,
   rename,
   rm,
   symlink,
-  writeFile as writeFile2
+  writeFile as writeFile4
 } from "node:fs/promises";
-import { createRequire as createRequire4 } from "node:module";
+import { createRequire as createRequire5 } from "node:module";
 import { pathToFileURL as pathToFileURL2 } from "node:url";
-import { basename as basename2, dirname as dirname7, join as join13, normalize, relative as relative6 } from "pathe";
+import { basename as basename2, dirname as dirname7, join as join17, normalize as normalize3, relative as relative6 } from "pathe";
 import { glob as glob4 } from "tinyglobby";
 
 // src/ai/ask-data.ts
@@ -2924,7 +2989,7 @@ var askBackendRuntimeDep = (ask) => {
 };
 
 // src/ai/markdown.ts
-import { readFile as readFile3 } from "node:fs/promises";
+import { readFile as readFile4 } from "node:fs/promises";
 var buildRawMarkdown = async (project) => {
   const pageById = new Map(project.graph.pages.map((page) => [page.id, page]));
   const readRoute = async (route) => {
@@ -2932,7 +2997,7 @@ var buildRawMarkdown = async (project) => {
     if (page) {
       return await readEntryText(project, page);
     }
-    return route.sourcePath ? await readFile3(route.sourcePath, "utf-8") : "";
+    return route.sourcePath ? await readFile4(route.sourcePath, "utf-8") : "";
   };
   const entries = await Promise.all(project.manifest.routes.map(async (route) => [route.path, await readRoute(route)]));
   return Object.fromEntries(entries);
@@ -3029,6 +3094,7 @@ var buildMcpServerCard = (input) => ({
 var BUILTIN_MDX_TAGS = new Set([
   "Accordion",
   "AccordionItem",
+  "ApiOverview",
   "AutoTypeTable",
   "Badge",
   "Callout",
@@ -3047,8 +3113,12 @@ var BUILTIN_MDX_TAGS = new Set([
   "GithubInfo",
   "Icon",
   "Math",
+  "Operation",
   "Panel",
+  "ParamField",
   "Prompt",
+  "RequestField",
+  "ResponseField",
   "Step",
   "Steps",
   "Tab",
@@ -3087,8 +3157,8 @@ var validateUsedComponents = (pages, extraTags, registryNames) => {
 };
 
 // src/core/component-overrides.ts
-import { existsSync as existsSync4 } from "node:fs";
-import { dirname as dirname4, extname, isAbsolute, resolve as resolve2 } from "pathe";
+import { existsSync as existsSync6 } from "node:fs";
+import { dirname as dirname4, extname, isAbsolute as isAbsolute2, resolve as resolve3 } from "pathe";
 import ts from "typescript";
 var GROUPS = ["mdx", "layout", "islands"];
 var FRAMEWORK_BY_EXT = {
@@ -3176,18 +3246,18 @@ var findDefaultExportObject = (sourceFile) => {
 var probeExtension = (base) => {
   for (const extension of COMPONENT_EXTS) {
     const candidate = `${base}.${extension}`;
-    if (existsSync4(candidate)) {
+    if (existsSync6(candidate)) {
       return candidate;
     }
   }
   return null;
 };
 var toImport = (specifier, imported, dir) => {
-  const relative4 = specifier.startsWith(".") || isAbsolute(specifier);
+  const relative4 = specifier.startsWith(".") || isAbsolute2(specifier);
   let path = specifier;
   let extension = extname(specifier).slice(1).toLowerCase();
   if (relative4) {
-    const absolute = isAbsolute(specifier) ? specifier : resolve2(dir, specifier);
+    const absolute = isAbsolute2(specifier) ? specifier : resolve3(dir, specifier);
     if (extension) {
       path = absolute;
     } else {
@@ -3435,147 +3505,104 @@ var resolveUIStrings = (locale, options) => {
 };
 
 // src/theme/icons.ts
-var icons = {
-  "arrow-left": '<path d="m12 19-7-7 7-7"/><path d="M19 12H5"/>',
-  "arrow-right": '<path d="M5 12h14"/><path d="m12 5 7 7-7 7"/>',
-  "arrow-up": '<path d="m5 12 7-7 7 7"/><path d="M12 19V5"/>',
-  "arrow-up-right": '<path d="M7 7h10v10"/><path d="M7 17 17 7"/>',
-  "badge-alert": '<path d="M3.85 8.62a4 4 0 0 1 4.78-4.77 4 4 0 0 1 6.74 0 4 4 0 0 1 4.78 4.78 4 4 0 0 1 0 6.74 4 4 0 0 1-4.78 4.78 4 4 0 0 1-6.74 0 4 4 0 0 1-4.78-4.78 4 4 0 0 1 0-6.75Z"/><path d="M12 8v4"/><path d="M12 16h.01"/>',
-  ban: '<circle cx="12" cy="12" r="10"/><path d="m4.93 4.93 14.14 14.14"/>',
-  "book-open": '<path d="M2 3h6a4 4 0 0 1 4 4v14a3 3 0 0 0-3-3H2z"/><path d="M22 3h-6a4 4 0 0 0-4 4v14a3 3 0 0 1 3-3h7z"/>',
-  "book-open-cover": '<path d="M12 7v14"/><path d="M3 18a2 2 0 0 1 2-2h7V5H5a2 2 0 0 0-2 2Z"/><path d="M21 18a2 2 0 0 0-2-2h-7V5h7a2 2 0 0 1 2 2Z"/>',
-  "brand-x": '<path d="m4 4 11.7 16H20L8.3 4Z"/><path d="M4 20 20 4"/>',
-  check: '<path d="M20 6 9 17l-5-5"/>',
-  "chevron-down": '<path d="m6 9 6 6 6-6"/>',
-  "chevron-right": '<path d="m9 18 6-6-6-6"/>',
-  "circle-check": '<circle cx="12" cy="12" r="10"/><path d="m9 12 2 2 4-4"/>',
-  "circle-x": '<circle cx="12" cy="12" r="10"/><path d="m15 9-6 6"/><path d="m9 9 6 6"/>',
-  clock: '<circle cx="12" cy="12" r="10"/><path d="M12 6v6l4 2"/>',
-  copy: '<rect width="14" height="14" x="8" y="8" rx="2" ry="2"/><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"/>',
-  download: '<path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><path d="m7 10 5 5 5-5"/><path d="M12 15V3"/>',
-  "external-link": '<path d="M15 3h6v6"/><path d="M10 14 21 3"/><path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"/>',
-  file: '<path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/>',
-  flag: '<path d="M4 15s1-1 4-1 5 2 8 2 4-1 4-1V3s-1 1-4 1-5-2-8-2-4 1-4 1z"/><path d="M4 22V15"/>',
-  folder: '<path d="M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z"/>',
-  gear: '<path d="M9.671 4.136a2.34 2.34 0 0 1 4.659 0 2.34 2.34 0 0 0 3.319 1.915 2.34 2.34 0 0 1 2.33 4.033 2.34 2.34 0 0 0 0 3.831 2.34 2.34 0 0 1-2.33 4.033 2.34 2.34 0 0 0-3.319 1.915 2.34 2.34 0 0 1-4.659 0 2.34 2.34 0 0 0-3.32-1.915 2.34 2.34 0 0 1-2.33-4.033 2.34 2.34 0 0 0 0-3.831A2.34 2.34 0 0 1 6.35 6.051a2.34 2.34 0 0 0 3.319-1.915"/><circle cx="12" cy="12" r="3"/>',
-  github: '<path d="M15 22v-4a4.8 4.8 0 0 0-1-3.5c3 0 6-2 6-5.5.08-1.25-.27-2.48-1-3.5.28-1.15.28-2.35 0-3.5 0 0-1 0-3 1.5-2.64-.5-5.36-.5-8 0C6 2 5 2 5 2c-.3 1.15-.3 2.35 0 3.5A5.4 5.4 0 0 0 4 9c0 3.5 3 5.5 6 5.5-.39.49-.68 1.3-.8 2.1-.36.16-.78.24-1.2.24-1.4 0-2.4-.7-3-2-.3-.6-.8-.9-1.2-.9-.4 0-.8.2-.8.5 0 .5.7.8 1 1.2.7 1.5 2 2.4 4 2.4.43 0 .84-.04 1.2-.13V22"/>',
-  globe: '<circle cx="12" cy="12" r="10"/><path d="M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20"/><path d="M2 12h20"/>',
-  info: '<circle cx="12" cy="12" r="10"/><path d="M12 16v-4"/><path d="M12 8h.01"/>',
-  js: '<path d="M8 8v7a2 2 0 1 1-4 0"/><path d="M16 15a2 2 0 1 0 2-2 2 2 0 1 1 2-2"/><path d="M20 8v.01"/>',
-  key: '<path d="M21 2 11.4 11.6"/><circle cx="7.5" cy="16.5" r="5.5"/><path d="m15 7 2 2"/><path d="m12 10 2 2"/>',
-  leaf: '<path d="M11 20A7 7 0 0 1 9.8 6.1C15.5 5 17 4.48 19 2c1 2 2 4.18 2 8 0 5.5-4.78 10-10 10Z"/><path d="M2 21c0-3 1.85-5.36 5.08-6C9.5 14.52 12 13 13 12"/>',
-  lightbulb: '<path d="M15 14c.2-1 .7-1.7 1.5-2.5 1-.9 1.5-2.2 1.5-3.5A6 6 0 0 0 6 8c0 1 .2 2.2 1.5 3.5.7.7 1.3 1.5 1.5 2.5"/><path d="M9 18h6"/><path d="M10 22h4"/>',
-  link: '<path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"/><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"/>',
-  linkedin: '<path d="M16 8a6 6 0 0 1 6 6v7h-4v-7a2 2 0 0 0-4 0v7h-4v-7a6 6 0 0 1 6-6z"/><rect width="4" height="12" x="2" y="9"/><circle cx="4" cy="4" r="2"/>',
-  lock: '<rect width="18" height="11" x="3" y="11" rx="2"/><path d="M7 11V7a5 5 0 0 1 10 0v4"/>',
-  menu: '<line x1="4" x2="20" y1="12" y2="12"/><line x1="4" x2="20" y1="6" y2="6"/><line x1="4" x2="20" y1="18" y2="18"/>',
-  "message-circle": '<path d="M7.9 20A9 9 0 1 0 4 16.1L2 22Z"/>',
-  moon: '<path d="M12 3a6 6 0 0 0 9 9 9 9 0 1 1-9-9Z"/>',
-  "panel-left": '<rect width="18" height="18" x="3" y="3" rx="2"/><path d="M9 3v18"/>',
-  "panel-left-close": '<rect width="18" height="18" x="3" y="3" rx="2"/><path d="M9 3v18"/><path d="m16 15-3-3 3-3"/>',
-  "panel-right": '<rect width="18" height="18" x="3" y="3" rx="2"/><path d="M15 3v18"/>',
-  "panel-right-close": '<rect width="18" height="18" x="3" y="3" rx="2"/><path d="M15 3v18"/><path d="m8 9 3 3-3 3"/>',
-  paperclip: '<path d="m16 6-8.41 8.41a2 2 0 0 0 2.83 2.83L18.83 8.83a4 4 0 0 0-5.66-5.66L4.76 11.59a6 6 0 0 0 8.49 8.49L21.66 11.66"/>',
-  "puzzle-piece": '<path d="M15.39 4.39a2.1 2.1 0 0 0-2.97 0L12 4.82l-.42-.43a2.1 2.1 0 1 0-2.97 2.97l.43.42L7.6 9.22H4.75A1.75 1.75 0 0 0 3 10.97v8.28C3 20.22 3.78 21 4.75 21h8.28c.97 0 1.75-.78 1.75-1.75V16.4l1.44-1.44.42.43a2.1 2.1 0 1 0 2.97-2.97l-.43-.42.43-.42a2.1 2.1 0 1 0-2.97-2.97l-.42.43-1.44-1.44.61-.61a2.1 2.1 0 0 0 0-2.97Z"/>',
-  python: '<path d="M12 2h4a4 4 0 0 1 4 4v3H8a4 4 0 0 0-4 4v1"/><path d="M12 22H8a4 4 0 0 1-4-4v-3h12a4 4 0 0 0 4-4v-1"/><path d="M9 6h.01"/><path d="M15 18h.01"/>',
-  rocket: '<path d="M4.5 16.5c-1.5 1.26-2 5-2 5s3.74-.5 5-2c.71-.84.7-2.13-.09-2.91a2.18 2.18 0 0 0-2.91-.09z"/><path d="m12 15-3-3a22 22 0 0 1 2-3.95A12.88 12.88 0 0 1 22 2c0 2.72-.78 7.5-6 11a22.35 22.35 0 0 1-4 2z"/><path d="M9 12H4s.55-3.03 2-4c1.62-1.08 5 0 5 0"/><path d="M12 15v5s3.03-.55 4-2c1.08-1.62 0-5 0-5"/>',
-  rss: '<path d="M4 11a9 9 0 0 1 9 9"/><path d="M4 4a16 16 0 0 1 16 16"/><circle cx="5" cy="19" r="1"/>',
-  search: '<circle cx="11" cy="11" r="8"/><path d="m21 21-4.3-4.3"/>',
-  sparkles: '<path d="m12 3-1.9 5.8a2 2 0 0 1-1.3 1.3L3 12l5.8 1.9a2 2 0 0 1 1.3 1.3L12 21l1.9-5.8a2 2 0 0 1 1.3-1.3L21 12l-5.8-1.9a2 2 0 0 1-1.3-1.3Z"/><path d="M5 3v4"/><path d="M3 5h4"/><path d="M19 17v4"/><path d="M17 19h4"/>',
-  star: '<path d="m12 2 3.09 6.26L22 9.27l-5 4.87 1.18 6.88L12 17.77l-6.18 3.25L7 14.14 2 9.27l6.91-1.01Z"/>',
-  sun: '<circle cx="12" cy="12" r="4"/><path d="M12 2v2"/><path d="M12 20v2"/><path d="m4.93 4.93 1.41 1.41"/><path d="m17.66 17.66 1.41 1.41"/><path d="M2 12h2"/><path d="M20 12h2"/><path d="m6.34 17.66-1.41 1.41"/><path d="m19.07 4.93-1.41 1.41"/>',
-  "text-align-start": '<path d="M4 6h16"/><path d="M4 10h10"/><path d="M4 14h16"/><path d="M4 18h10"/>',
-  "thumbs-down": '<path d="M17 14V2"/><path d="M9 18.12 10 14H4.17a2 2 0 0 1-1.92-2.56l2.33-8A2 2 0 0 1 6.5 2H20a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2h-2.76a2 2 0 0 0-1.79 1.11L12 22a3.13 3.13 0 0 1-3-3.88Z"/>',
-  "thumbs-up": '<path d="M7 10v12"/><path d="M15 5.88 14 10h5.83a2 2 0 0 1 1.92 2.56l-2.33 8A2 2 0 0 1 17.5 22H4a2 2 0 0 1-2-2v-8a2 2 0 0 1 2-2h2.76a2 2 0 0 0 1.79-1.11L12 2a3.13 3.13 0 0 1 3 3.88Z"/>',
-  "triangle-alert": '<path d="m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3Z"/><path d="M12 9v4"/><path d="M12 17h.01"/>',
-  x: '<path d="M18 6 6 18"/><path d="m6 6 12 12"/>'
-};
-var iconAliases = {
-  "alien-8bit": "sparkles",
-  "arrow-up-right-from-square": "external-link",
-  "book-open-reader": "book-open",
-  "circle-info": "info",
-  close: "x",
-  "external-link-alt": "external-link",
-  "fa-github": "github",
-  "fa-linkedin": "linkedin",
-  "fa-x-twitter": "brand-x",
-  "file-lines": "file",
-  javascript: "js",
-  "panel-left-open": "panel-left",
-  "panel-right-open": "panel-right",
-  times: "x",
-  "x-twitter": "brand-x"
-};
-var libraryPrefixes = [
-  "fa-brands",
-  "fa-duotone",
-  "fa-light",
-  "fa-regular",
-  "fa-sharp-solid",
-  "fa-solid",
-  "fa-thin",
-  "fa",
-  "fab",
-  "fad",
-  "fal",
-  "far",
-  "fas",
-  "fat",
-  "lucide",
-  "tabler",
-  "ti"
-];
-var normalizedIconName = (name) => name.trim().toLowerCase().replaceAll(/[\s_]+/gu, "-");
-var isString = (value) => typeof value === "string";
-var withoutLibraryPrefix = (name) => {
-  let normalized = normalizedIconName(name).replaceAll(/^icon-/gu, "");
-  let changed = true;
-  while (changed) {
-    changed = false;
-    for (const prefix of libraryPrefixes) {
-      if (normalized.startsWith(`${prefix}-`)) {
-        normalized = normalized.slice(prefix.length + 1);
-        changed = true;
-      }
-      if (normalized.startsWith(`${prefix}:`)) {
-        normalized = normalized.slice(prefix.length + 1);
-        changed = true;
-      }
-    }
+import { createRequire as createRequire2 } from "node:module";
+import { getIconData, iconToSVG } from "@iconify/utils";
+var requireJson = createRequire2(import.meta.url);
+var loadSet = (pkg) => requireJson(pkg);
+var SETS = {
+  "fa6-brands": loadSet("@iconify-json/fa6-brands/icons.json"),
+  "fa6-regular": loadSet("@iconify-json/fa6-regular/icons.json"),
+  "fa6-solid": loadSet("@iconify-json/fa6-solid/icons.json"),
+  lucide: loadSet("@iconify-json/lucide/icons.json"),
+  tabler: loadSet("@iconify-json/tabler/icons.json")
+};
+var DEFAULT_SET = "lucide";
+var LIBRARY_SETS = {
+  fa: "fa6-solid",
+  "font-awesome": "fa6-solid",
+  fontawesome: "fa6-solid",
+  lucide: "lucide",
+  tabler: "tabler"
+};
+var ICON_TYPE_SETS = {
+  brands: "fa6-brands",
+  duotone: "fa6-solid",
+  light: "fa6-solid",
+  regular: "fa6-regular",
+  "sharp-solid": "fa6-solid",
+  solid: "fa6-solid",
+  thin: "fa6-solid"
+};
+var PREFIX_SETS = {
+  ...LIBRARY_SETS,
+  fa: "fa6-solid",
+  "fa-brands": "fa6-brands",
+  "fa-regular": "fa6-regular",
+  "fa-solid": "fa6-solid",
+  "fa6-brands": "fa6-brands",
+  "fa6-regular": "fa6-regular",
+  "fa6-solid": "fa6-solid",
+  fab: "fa6-brands",
+  far: "fa6-regular",
+  fas: "fa6-solid",
+  ti: "tabler"
+};
+var normalize = (name) => name.trim().toLowerCase().replaceAll(/[\s_]+/gu, "-");
+var setFor = (options) => {
+  if (options.iconType) {
+    const set = ICON_TYPE_SETS[normalize(options.iconType)];
+    if (set) {
+      return set;
+    }
+  }
+  if (options.library) {
+    const set = LIBRARY_SETS[normalize(options.library)];
+    if (set) {
+      return set;
+    }
+  }
+  return DEFAULT_SET;
+};
+var fromSet = (setName, iconName) => {
+  const set = SETS[setName];
+  const data = set && getIconData(set, iconName);
+  if (!data) {
+    return null;
   }
-  return normalized;
+  const { attributes, body } = iconToSVG(data, { height: "auto" });
+  return { body, name: iconName, viewBox: attributes.viewBox };
 };
-var resolveIcon = (name, iconType) => {
-  const normalized = normalizedIconName(name);
-  const stripped = withoutLibraryPrefix(name);
-  const type = iconType ? normalizedIconName(iconType) : null;
-  const candidates = [
-    normalized,
-    stripped,
-    type ? `${type}-${stripped}` : null,
-    iconAliases[normalized],
-    iconAliases[stripped]
-  ].filter(isString);
-  for (const candidate of candidates) {
-    const markup = icons[candidate];
-    if (markup) {
-      return { markup, name: candidate };
+var fromFaSet = (setName, name) => fromSet(setName, name) ?? fromSet("fa6-brands", name);
+var resolveInSet = (setName, name) => setName.startsWith("fa6-") ? fromFaSet(setName, name) : fromSet(setName, name);
+var resolveIcon = (name, options = {}) => {
+  const normalized = normalize(name);
+  const colon = normalized.indexOf(":");
+  if (colon > 0) {
+    const setName = PREFIX_SETS[normalized.slice(0, colon)];
+    if (setName) {
+      return resolveInSet(setName, normalized.slice(colon + 1));
     }
   }
-  return null;
+  return resolveInSet(setFor(options), normalized);
+};
+var hasIcon = (name, options = {}) => {
+  if (resolveIcon(name, options)) {
+    return true;
+  }
+  const normalized = normalize(name);
+  const bare = normalized.includes(":") ? normalized.slice(normalized.indexOf(":") + 1) : normalized;
+  return Object.values(SETS).some((set) => getIconData(set, bare) !== null);
 };
-var hasIcon = (name, iconType) => resolveIcon(name, iconType) !== null;
 
 // src/core/nav-diagnostics.ts
 var IMAGE_ICON = /^(?:https?:\/\/|data:image\/|\/|\.{1,2}\/)|\.(?:avif|gif|jpe?g|png|svg|webp)$/iu;
 var isAssetIcon = (value) => value.startsWith("<") || IMAGE_ICON.test(value);
 var flattenNodes = (nodes) => nodes.flatMap((node) => node.kind === "group" ? [node, ...flattenNodes(node.children)] : [node]);
 var collectIcons = (navigation) => {
-  const icons2 = [];
+  const icons = [];
   const push = (icon, where) => {
     if (icon) {
-      icons2.push({ icon, where });
+      icons.push({ icon, where });
     }
   };
   for (const tab of navigation.tabs) {
@@ -3598,7 +3625,7 @@ var collectIcons = (navigation) => {
       push(node.icon, `"${node.label}"`);
     }
   }
-  return icons2;
+  return icons;
 };
 var validateNavIcons = (navigation) => {
   const seen = new Set;
@@ -3708,10 +3735,10 @@ var validateNavStructure = (navigation, pages) => [
 ];
 
 // src/core/tsconfig-aliases.ts
-import { existsSync as existsSync5, readFileSync as readFileSync3, statSync } from "node:fs";
-import { createRequire as createRequire2 } from "node:module";
+import { existsSync as existsSync7, readFileSync as readFileSync3, statSync } from "node:fs";
+import { createRequire as createRequire3 } from "node:module";
 import { pathToFileURL } from "node:url";
-import { dirname as dirname5, isAbsolute as isAbsolute2, join as join7, resolve as resolve3 } from "pathe";
+import { dirname as dirname5, isAbsolute as isAbsolute3, join as join9, resolve as resolve4 } from "pathe";
 var stripJsonComments = (text) => {
   let out = "";
   let inString = false;
@@ -3765,16 +3792,16 @@ var isFile = (path) => {
   }
 };
 var resolveExtends = (spec, fromDir) => {
-  if (spec.startsWith(".") || isAbsolute2(spec)) {
-    const candidates = spec.endsWith(".json") ? [resolve3(fromDir, spec)] : [
-      resolve3(fromDir, `${spec}.json`),
-      resolve3(fromDir, spec, "tsconfig.json"),
-      resolve3(fromDir, spec)
+  if (spec.startsWith(".") || isAbsolute3(spec)) {
+    const candidates = spec.endsWith(".json") ? [resolve4(fromDir, spec)] : [
+      resolve4(fromDir, `${spec}.json`),
+      resolve4(fromDir, spec, "tsconfig.json"),
+      resolve4(fromDir, spec)
     ];
     return candidates.find(isFile) ?? null;
   }
   try {
-    const require_ = createRequire2(pathToFileURL(join7(fromDir, "_.js")).href);
+    const require_ = createRequire3(pathToFileURL(join9(fromDir, "_.js")).href);
     for (const sub of [`${spec}/tsconfig.json`, spec]) {
       try {
         return require_.resolve(sub);
@@ -3784,7 +3811,7 @@ var resolveExtends = (spec, fromDir) => {
   return null;
 };
 var loadPaths = (file, seen) => {
-  if (seen.has(file) || !existsSync5(file)) {
+  if (seen.has(file) || !existsSync7(file)) {
     return null;
   }
   seen.add(file);
@@ -3796,7 +3823,7 @@ var loadPaths = (file, seen) => {
   if (options.paths && typeof options.paths === "object") {
     const baseUrl = typeof options.baseUrl === "string" ? options.baseUrl : ".";
     return {
-      baseDir: resolve3(dirname5(file), baseUrl),
+      baseDir: resolve4(dirname5(file), baseUrl),
       paths: options.paths
     };
   }
@@ -3823,10 +3850,10 @@ var toAlias = (key, value, baseDir) => {
   if (find === "" || find === "*") {
     return null;
   }
-  return { find, replacement: resolve3(baseDir, target) };
+  return { find, replacement: resolve4(baseDir, target) };
 };
 var resolveTsconfigAliases = (root) => {
-  const entry = ["tsconfig.json", "jsconfig.json"].map((name) => join7(root, name)).find((file) => existsSync5(file));
+  const entry = ["tsconfig.json", "jsconfig.json"].map((name) => join9(root, name)).find((file) => existsSync7(file));
   if (!entry) {
     return {};
   }
@@ -3922,19 +3949,97 @@ ${items}
 `;
 };
 
+// src/openapi/references.ts
+var NON_SLUG = /[^a-z0-9]+/gu;
+var SLUG_EDGES = /^-+|-+$/gu;
+var ROUTE_EDGES = /^\/+|\/+$/gu;
+var TRAILING_SLASH = /\/+$/u;
+var slugify = (text) => text.toLowerCase().replace(NON_SLUG, "-").replace(SLUG_EDGES, "");
+var normalizeRoute = (route) => {
+  const trimmed = route.trim();
+  const withSlash = trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+  const noTrailing = withSlash.replace(TRAILING_SLASH, "");
+  return noTrailing === "" ? "/" : noTrailing;
+};
+var routeSlug = (route) => slugify(route.replace(ROUTE_EDGES, "")) || "reference";
+var sourcesOf = (block) => {
+  const sources = [...block.sources];
+  if (block.spec) {
+    sources.unshift({ spec: block.spec });
+  }
+  return sources;
+};
+var referencesFor = (kind, block, defaultLabel, renderer, display) => {
+  if (!block.enabled) {
+    return [];
+  }
+  const sources = sourcesOf(block);
+  const base = normalizeRoute(block.route);
+  return sources.map((source, index) => {
+    const label = source.label ?? (sources.length > 1 ? `${defaultLabel} ${index + 1}` : defaultLabel);
+    let route;
+    if (source.route) {
+      route = normalizeRoute(source.route);
+    } else if (sources.length === 1) {
+      route = base;
+    } else {
+      const suffix = source.label ? slugify(source.label) : "";
+      route = normalizeRoute(`${base}/${suffix || index + 1}`);
+    }
+    return {
+      display,
+      kind,
+      label,
+      renderer,
+      route,
+      slug: routeSlug(route),
+      spec: source.spec,
+      theme: block.theme
+    };
+  });
+};
+var NO_DISPLAY = { codeSamples: [], expandSchemas: false };
+var resolveReferences = (config) => [
+  ...referencesFor("openapi", config.openapi, "API Reference", config.openapi.renderer, {
+    codeSamples: config.openapi.codeSamples,
+    expandSchemas: config.openapi.expandSchemas
+  }),
+  ...referencesFor("asyncapi", config.asyncapi, "Events", "scalar", NO_DISPLAY)
+];
+var referenceTabs = (config) => resolveReferences(config).map((ref) => ({
+  label: ref.label,
+  path: ref.route
+}));
+var blumeReferences = (config) => {
+  const seen = new Set;
+  const result = [];
+  for (const ref of resolveReferences(config)) {
+    if (ref.kind !== "openapi" || ref.renderer !== "blume") {
+      continue;
+    }
+    if (seen.has(ref.route)) {
+      continue;
+    }
+    seen.add(ref.route);
+    result.push(ref);
+  }
+  return result;
+};
+var hasScalarReferences = (config) => resolveReferences(config).some((ref) => ref.renderer === "scalar");
+
 // src/openapi/scalar.ts
-import { readFile as readFile4 } from "node:fs/promises";
-import { isAbsolute as isAbsolute3, join as join10 } from "pathe";
+import { readFile as readFile5 } from "node:fs/promises";
+import { isAbsolute as isAbsolute4, join as join12 } from "pathe";
 
 // src/astro/templates.ts
-import { existsSync as existsSync6, readFileSync as readFileSync4 } from "node:fs";
-import { dirname as dirname6, join as join9 } from "pathe";
+import { existsSync as existsSync8, readFileSync as readFileSync4 } from "node:fs";
+import { dirname as dirname6, join as join11 } from "pathe";
 
 // src/core/assets.ts
-import { join as join8 } from "pathe";
+import { join as join10 } from "pathe";
 var resolveAssetMounts = (root, assets) => assets.map((entry) => {
   const rel = entry.replace(/^[./]+/u, "").replaceAll(/\.\.\/?/gu, "").replace(/\/+$/u, "");
-  return { dir: join8(root, rel), url: `/${rel}` };
+  return { dir: join10(root, rel), url: `/${rel}` };
 });
 
 // src/theme/fonts.ts
@@ -4093,7 +4198,7 @@ var WORKSPACE_MARKERS = [
   "yarn.lock"
 ];
 var hasWorkspacesField = (pkgPath) => {
-  if (!existsSync6(pkgPath)) {
+  if (!existsSync8(pkgPath)) {
     return false;
   }
   try {
@@ -4103,7 +4208,7 @@ var hasWorkspacesField = (pkgPath) => {
     return false;
   }
 };
-var hasWorkspaceMarker = (dir) => hasWorkspacesField(join9(dir, "package.json")) || WORKSPACE_MARKERS.some((marker) => existsSync6(join9(dir, marker)));
+var hasWorkspaceMarker = (dir) => hasWorkspacesField(join11(dir, "package.json")) || WORKSPACE_MARKERS.some((marker) => existsSync8(join11(dir, marker)));
 var findWorkspaceRoot = (start) => {
   let dir = start;
   for (;; ) {
@@ -4138,7 +4243,7 @@ var runtimeDependencies = (options) => {
   if (needsSvelte) {
     deps.push("@astrojs/svelte");
   }
-  if (config.openapi.enabled || config.asyncapi.enabled) {
+  if (hasScalarReferences(config)) {
     deps.push("@scalar/astro");
   }
   deps.push(...searchProviderMeta(config.search.provider).runtimeDeps);
@@ -4171,6 +4276,7 @@ var RENDER_EXTERNAL_DEPS = [
 ];
 var renderUserAliases = (aliases) => Object.entries(aliases ?? {}).toSorted(([a], [b]) => b.length - a.length).map(([find, replacement]) => `
         ${JSON.stringify(find)}: ${JSON.stringify(replacement)},`).join("");
+var astroOutDir = (context) => context.distDir ?? `${context.root}/dist`;
 var astroConfigTemplate = (options) => {
   const { context, config, needsReact, pages, dataPath, themePath } = options;
   const {
@@ -4178,6 +4284,7 @@ var astroConfigTemplate = (options) => {
     examplesPath,
     needsSvelte,
     needsVue,
+    openapiPath,
     searchClientPath
   } = options;
   const { deployment } = config;
@@ -4248,7 +4355,7 @@ ${twoslashImport}${reactImport}${vueImport}${svelteImport}${blumeImport}${adapte
 export default defineConfig({
   root: ${JSON.stringify(context.outDir)},
   srcDir: ${JSON.stringify(`${context.outDir}/src`)},
-  outDir: ${JSON.stringify(`${context.root}/dist`)},
+  outDir: ${JSON.stringify(astroOutDir(context))},
   publicDir: ${JSON.stringify(`${context.root}/public`)},
   output: ${JSON.stringify(deployment.output)},${adapterOption}${siteOption}${baseOption}${redirectsOption}${i18nOption}${fontsOption}
   integrations: [${integrations.join(", ")}],
@@ -4281,6 +4388,7 @@ export default defineConfig({
       alias: {
         "blume:data": ${JSON.stringify(dataPath)},
         "blume:examples": ${JSON.stringify(examplesPath)},
+        "blume:openapi": ${JSON.stringify(openapiPath)},
         "blume:search-client": ${JSON.stringify(searchClientPath)},
         "blume:theme": ${JSON.stringify(themePath)},${userAliasLines}
       },
@@ -4294,7 +4402,7 @@ export default defineConfig({
 });
 `;
 };
-var stagedContentDir = (outDir) => join9(outDir, "content");
+var stagedContentDir = (outDir) => join11(outDir, "content");
 var contentConfigTemplate = (options) => {
   const { context, config } = options;
   const stagedBase = options.stagedBase ?? stagedContentDir(context.outDir);
@@ -4700,7 +4808,10 @@ import FileTree from "blume/components/content/FileTree.astro";
 import Frame from "blume/components/content/Frame.astro";
 import GithubInfo from "blume/components/content/GithubInfo.astro";
 import Panel from "blume/components/content/Panel.astro";
+import ParamField from "blume/components/content/ParamField.astro";
 import Prompt from "blume/components/content/Prompt.astro";
+import RequestField from "blume/components/content/RequestField.astro";
+import ResponseField from "blume/components/content/ResponseField.astro";
 import Step from "blume/components/content/Step.astro";
 import Steps from "blume/components/content/Steps.astro";
 import Tab from "blume/components/content/Tab.astro";
@@ -4714,6 +4825,8 @@ import TypeTable from "blume/components/content/TypeTable.astro";
 import Visibility from "blume/components/content/Visibility.astro";
 import YouTube from "blume/components/content/YouTube.astro";
 import Icon from "blume/components/Icon.astro";
+import ApiOverview from "blume/components/openapi/ApiOverview.astro";
+import Operation from "blume/components/openapi/Operation.astro";
 ${mathImport}import { mdxComponents as userMdx, layoutOverrides } from "../generated/components.ts";
 import { islandComponents } from "../generated/islands.ts";
 import data from "../generated/data.json";
@@ -4730,6 +4843,7 @@ export const prerender = true;
 const components = {
   Accordion,
   AccordionItem,
+  ApiOverview,
   AutoTypeTable,
   Badge,
   Callout,
@@ -4747,8 +4861,12 @@ const components = {
   Frame,
   GithubInfo,
   Icon,
+  Operation,
   Panel,
+  ParamField,
   Prompt,
+  RequestField,
+  ResponseField,
   Step,
   Steps,
   Tab,
@@ -5148,6 +5266,11 @@ declare module "blume:data" {
   export default data;
 }
 
+declare module "blume:openapi" {
+  const specs: import("blume/openapi/model.ts").OpenApiData;
+  export default specs;
+}
+
 declare module "blume:search-client" {
   export const createSearch: () =>
     | import("blume/components/layout/search/types.ts").SearchFn
@@ -5262,57 +5385,11 @@ ${dark}`;
 
 // src/openapi/scalar.ts
 var URL_SPEC = /^https?:\/\//u;
-var NON_SLUG = /[^a-z0-9]+/gu;
-var SLUG_EDGES = /^-+|-+$/gu;
-var ROUTE_EDGES = /^\/+|\/+$/gu;
-var TRAILING_SLASH = /\/+$/u;
-var slugify = (text) => text.toLowerCase().replace(NON_SLUG, "-").replace(SLUG_EDGES, "");
-var normalizeRoute = (route) => {
-  const trimmed = route.trim();
-  const withSlash = trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
-  const noTrailing = withSlash.replace(TRAILING_SLASH, "");
-  return noTrailing === "" ? "/" : noTrailing;
-};
+var ROUTE_EDGES2 = /^\/+|\/+$/gu;
 var referencePagePath = (route) => {
-  const segments = route.replace(ROUTE_EDGES, "");
+  const segments = route.replace(ROUTE_EDGES2, "");
   return `${segments === "" ? "index" : segments}.astro`;
 };
-var sourcesOf = (block) => {
-  const sources = [...block.sources];
-  if (block.spec) {
-    sources.unshift({ spec: block.spec });
-  }
-  return sources;
-};
-var referencesFor = (kind, block, defaultLabel) => {
-  if (!block.enabled) {
-    return [];
-  }
-  const sources = sourcesOf(block);
-  const base = normalizeRoute(block.route);
-  return sources.map((source, index) => {
-    const label = source.label ?? (sources.length > 1 ? `${defaultLabel} ${index + 1}` : defaultLabel);
-    let route;
-    if (source.route) {
-      route = normalizeRoute(source.route);
-    } else if (sources.length === 1) {
-      route = base;
-    } else {
-      const suffix = source.label ? slugify(source.label) : "";
-      route = normalizeRoute(`${base}/${suffix || index + 1}`);
-    }
-    return { kind, label, route, spec: source.spec, theme: block.theme };
-  });
-};
-var resolveReferences = (config) => [
-  ...referencesFor("openapi", config.openapi, "API Reference"),
-  ...referencesFor("asyncapi", config.asyncapi, "Events")
-];
-var referenceTabs = (config) => resolveReferences(config).map((ref) => ({
-  label: ref.label,
-  path: ref.route
-}));
-var hasReferences = (config) => config.openapi.enabled || config.asyncapi.enabled;
 var darkModeConfig = (mode) => {
   if (mode === "dark") {
     return { darkMode: true };
@@ -5337,9 +5414,9 @@ var specConfiguration = async (spec, root) => {
   if (URL_SPEC.test(spec)) {
     return { config: { url: spec } };
   }
-  const absolute = isAbsolute3(spec) ? spec : join10(root, spec);
+  const absolute = isAbsolute4(spec) ? spec : join12(root, spec);
   try {
-    return { config: { content: await readFile4(absolute, "utf-8") } };
+    return { config: { content: await readFile5(absolute, "utf-8") } };
   } catch {
     return {
       config: { url: spec },
@@ -5353,6 +5430,9 @@ var buildReferenceFiles = async (options) => {
   const seen = new Set;
   const accepted = [];
   for (const ref of resolveReferences(config)) {
+    if (ref.renderer !== "scalar") {
+      continue;
+    }
     if (seen.has(ref.route)) {
       warnings.push(`Two API reference sources resolve to ${ref.route}; keeping the first.`);
       continue;
@@ -5373,22 +5453,300 @@ var buildReferenceFiles = async (options) => {
     if (spec.warning) {
       warnings.push(spec.warning);
     }
-    const pagePath = referencePagePath(ref.route);
-    const depth = pagePath.split("/").length - 1;
-    files.push({
-      content: scalarReferenceTemplate({
-        configuration: {
-          ...spec.config,
-          ...themeConfiguration(config, ref.theme)
-        },
-        dataImport: `${"../".repeat(depth + 1)}generated/data.json`,
-        route: ref.route,
-        title: ref.label
-      }),
-      pagePath
-    });
-  }
-  return { files, warnings };
+    const pagePath = referencePagePath(ref.route);
+    const depth = pagePath.split("/").length - 1;
+    files.push({
+      content: scalarReferenceTemplate({
+        configuration: {
+          ...spec.config,
+          ...themeConfiguration(config, ref.theme)
+        },
+        dataImport: `${"../".repeat(depth + 1)}generated/data.json`,
+        route: ref.route,
+        title: ref.label
+      }),
+      pagePath
+    });
+  }
+  return { files, warnings };
+};
+
+// src/core/sources/cache.ts
+import { mkdir as mkdir2, readFile as readFile6, writeFile as writeFile3 } from "node:fs/promises";
+import { join as join13 } from "pathe";
+var hashText = (text) => {
+  let hash = 5381;
+  for (let i = 0;i < text.length; i += 1) {
+    hash = (hash * 33 + (text.codePointAt(i) ?? 0)) % 2147483647;
+  }
+  return hash.toString(36);
+};
+var entriesDigest = (entries) => hashText(entries.map((entry) => `${entry.ref}:${entry.hash ?? hashText(entry.body.text)}`).join("|"));
+var pollingWatch = (load2, intervalSeconds) => (onChange) => {
+  let last = "";
+  const tick = async () => {
+    try {
+      const { entries } = await load2();
+      const next = entriesDigest(entries);
+      if (last && next !== last) {
+        onChange();
+      }
+      last = next;
+    } catch {}
+  };
+  const timer = setInterval(() => {
+    tick();
+  }, intervalSeconds * 1000);
+  return () => clearInterval(timer);
+};
+var snapshotCache = (cacheDir) => {
+  const file = join13(cacheDir, "entries.json");
+  return {
+    read: async () => {
+      try {
+        return JSON.parse(await readFile6(file, "utf-8"));
+      } catch {
+        return [];
+      }
+    },
+    write: async (entries) => {
+      try {
+        await mkdir2(cacheDir, { recursive: true });
+        await writeFile3(file, `${JSON.stringify(entries)}
+`, "utf-8");
+      } catch {}
+    }
+  };
+};
+var loadWithCache = async (name, cache, fetchEntries, refresh = true) => {
+  if (!refresh) {
+    const cached3 = await cache.read();
+    if (cached3.length > 0) {
+      return { diagnostics: [], entries: cached3 };
+    }
+  }
+  try {
+    const entries = await fetchEntries();
+    await cache.write(entries);
+    return { diagnostics: [], entries };
+  } catch (error) {
+    const fallback = await cache.read();
+    if (fallback.length > 0) {
+      const diagnostic = {
+        code: "BLUME_SOURCE_OFFLINE",
+        message: `Source "${name}" could not be fetched (${error.message}); served ${fallback.length} cached entries.`,
+        severity: "warning"
+      };
+      return { diagnostics: [diagnostic], entries: fallback };
+    }
+    throw new BlumeError({
+      code: "BLUME_SOURCE_FETCH_FAILED",
+      message: `Source "${name}" failed to load and no cache is available: ${error.message}`,
+      severity: "error"
+    });
+  }
+};
+
+// src/openapi/model.ts
+var NON_SLUG2 = /[^a-z0-9]+/gu;
+var SLUG_EDGES2 = /^-+|-+$/gu;
+var slugify2 = (text) => text.toLowerCase().replace(NON_SLUG2, "-").replace(SLUG_EDGES2, "");
+var HTTP_METHODS = [
+  "get",
+  "put",
+  "post",
+  "delete",
+  "options",
+  "head",
+  "patch",
+  "trace"
+];
+var UNTAGGED = "Operations";
+var operationKey = (method, path, operationId) => {
+  const fromId = operationId ? slugify2(operationId) : "";
+  return fromId || slugify2(`${method}-${path}`);
+};
+var isOperation = (value) => typeof value === "object" && value !== null;
+var extractOperations = (document, baseRoute) => {
+  const operations = [];
+  const tagOrder = [];
+  const tagMeta = new Map((document.tags ?? []).map((tag) => [tag.name, tag.description ?? ""]));
+  const seen = new Set;
+  for (const [path, rawItem] of Object.entries(document.paths ?? {})) {
+    const item = rawItem;
+    if (!item || "$ref" in item) {
+      continue;
+    }
+    for (const method of HTTP_METHODS) {
+      const operation = item[method];
+      if (!isOperation(operation)) {
+        continue;
+      }
+      const tag = operation.tags?.[0] ?? UNTAGGED;
+      const tagSlug = slugify2(tag) || "operations";
+      if (!tagOrder.includes(tag)) {
+        tagOrder.push(tag);
+      }
+      let key = operationKey(method, path, operation.operationId);
+      while (seen.has(key)) {
+        key = `${key}-${method}`;
+      }
+      seen.add(key);
+      operations.push({
+        deprecated: operation.deprecated ?? false,
+        description: operation.description ?? "",
+        key,
+        method,
+        operationId: operation.operationId,
+        path,
+        route: `${baseRoute}/${tagSlug}/${key}`,
+        summary: operation.summary ?? "",
+        tag,
+        tagSlug
+      });
+    }
+  }
+  const tags = tagOrder.map((name) => ({
+    description: tagMeta.get(name) ?? "",
+    name,
+    slug: slugify2(name) || "operations"
+  }));
+  return { operations, tags };
+};
+
+// src/openapi/parse.ts
+import { readFile as readFile7 } from "node:fs/promises";
+import { normalize as normalize2, upgrade } from "@scalar/openapi-parser";
+import { isAbsolute as isAbsolute5, join as join14 } from "pathe";
+var URL_SPEC2 = /^https?:\/\//u;
+var readSpecText = async (spec, root) => {
+  if (URL_SPEC2.test(spec)) {
+    const response = await fetch(spec);
+    if (!response.ok) {
+      throw new Error(`${spec} -> ${response.status} ${response.statusText}`);
+    }
+    return await response.text();
+  }
+  const absolute = isAbsolute5(spec) ? spec : join14(root, spec);
+  return await readFile7(absolute, "utf-8");
+};
+var parseSpec = async (spec, root) => {
+  const text = await readSpecText(spec, root);
+  const normalized = normalize2(text);
+  const { specification } = upgrade(normalized);
+  return { document: specification, warnings: [] };
+};
+
+// src/openapi/render-mdx.ts
+var MDX_UNSAFE = /[<>{}]/gu;
+var ENTITIES = {
+  "<": "&lt;",
+  ">": "&gt;",
+  "{": "&#123;",
+  "}": "&#125;"
+};
+var mdxSafe = (text) => text.replace(MDX_UNSAFE, (char) => ENTITIES[char] ?? char);
+var withDescription = (description, component) => description.trim() ? `${mdxSafe(description.trim())}
+
+${component}` : component;
+var operationMdx = (spec, operation) => {
+  const method = operation.method.toUpperCase();
+  const title = operation.summary || `${method} ${operation.path}`;
+  const description = operation.description.trim() === operation.summary.trim() ? "" : operation.description;
+  return {
+    body: withDescription(description, `<Operation source="${spec.slug}" id="${operation.key}" />`),
+    data: {
+      ...operation.deprecated ? { deprecated: true } : {},
+      search: { tags: [operation.tag, method] },
+      sidebar: { badge: method, label: operation.summary || operation.path },
+      title,
+      type: "openapi-operation"
+    }
+  };
+};
+var overviewMdx = (spec) => ({
+  body: withDescription(spec.description, `<ApiOverview source="${spec.slug}" />`),
+  data: {
+    sidebar: { label: "Overview" },
+    title: spec.title || spec.label
+  }
+});
+
+// src/openapi/source.ts
+var isOpenApiSource = (source) => source.kind === "openapi-source";
+var routeToRef = (route) => route.replace(/^\/+/u, "");
+var toEntry = (rendered, ref) => {
+  const raw = frontmatter_default.stringify(`${rendered.body}
+`, rendered.data);
+  return {
+    body: { format: "mdx", text: rendered.body },
+    data: rendered.data,
+    hash: hashText(raw),
+    raw,
+    ref
+  };
+};
+var specEntries = (spec, operations) => {
+  const entries = operations.map((operation) => toEntry(operationMdx(spec, operation), `${routeToRef(operation.route)}.mdx`));
+  entries.push(toEntry(overviewMdx(spec), `${routeToRef(spec.route)}/index.mdx`));
+  return entries;
+};
+var openApiSource = (references, ctx) => {
+  let parsed = {};
+  const loadReference = async (reference) => {
+    try {
+      const { document } = await parseSpec(reference.spec, ctx.projectRoot);
+      const { operations, tags } = extractOperations(document, reference.route);
+      const info = document.info ?? { title: reference.label, version: "" };
+      const spec = {
+        codeSamples: reference.display.codeSamples,
+        description: info.description ?? "",
+        document,
+        expandSchemas: reference.display.expandSchemas,
+        label: reference.label,
+        operations: Object.fromEntries(operations.map((operation) => [operation.key, operation])),
+        route: reference.route,
+        slug: reference.slug,
+        tags,
+        title: info.title ?? reference.label,
+        version: info.version ?? ""
+      };
+      return {
+        entries: specEntries(spec, operations),
+        slug: reference.slug,
+        spec
+      };
+    } catch (error) {
+      return {
+        code: "BLUME_OPENAPI_UNAVAILABLE",
+        message: `Could not load OpenAPI spec "${reference.spec}" for ${reference.route} (${error.message}); its reference pages were skipped.`,
+        severity: "warning"
+      };
+    }
+  };
+  const load2 = async () => {
+    const results = await Promise.all(references.map(loadReference));
+    const entries = [];
+    const diagnostics = [];
+    const data = {};
+    for (const result of results) {
+      if ("severity" in result) {
+        diagnostics.push(result);
+        continue;
+      }
+      data[result.slug] = result.spec;
+      entries.push(...result.entries);
+    }
+    parsed = data;
+    return { diagnostics, entries };
+  };
+  return {
+    kind: "openapi-source",
+    load: load2,
+    name: "openapi",
+    openApiData: () => parsed,
+    staged: true
+  };
 };
 
 // src/theme/entry.ts
@@ -6011,8 +6369,8 @@ ${options.userTheme}
 
 // src/theme/twoslash.ts
 import { readFileSync as readFileSync5 } from "node:fs";
-import { createRequire as createRequire3 } from "node:module";
-var require2 = createRequire3(import.meta.url);
+import { createRequire as createRequire4 } from "node:module";
+var require2 = createRequire4(import.meta.url);
 var OVERRIDES = `
 /* Twoslash: theme the rich renderer with Blume tokens. */
 :root {
@@ -6174,13 +6532,13 @@ export const layoutOverrides = { ...(overrides.layout ?? {})${layoutEntries.leng
 };
 
 // src/astro/examples.ts
-import { readFile as readFile6 } from "node:fs/promises";
-import { join as join12, relative as relative4 } from "pathe";
+import { readFile as readFile9 } from "node:fs/promises";
+import { join as join16, relative as relative4 } from "pathe";
 import { glob as glob2 } from "tinyglobby";
 
 // src/astro/islands.ts
-import { readFile as readFile5 } from "node:fs/promises";
-import { basename, join as join11 } from "pathe";
+import { readFile as readFile8 } from "node:fs/promises";
+import { basename, join as join15 } from "pathe";
 import { glob } from "tinyglobby";
 var DEFAULT_CLIENT = "visible";
 var VALID_MODES = new Set([
@@ -6209,14 +6567,14 @@ var readClientMode = (source, file, warnings) => {
   return mode;
 };
 var discoverIslands = async (root) => {
-  const dir = join11(root, "islands");
+  const dir = join15(root, "islands");
   const matches = await glob(["**/*.{jsx,svelte,tsx,vue}"], {
     absolute: true,
     cwd: dir,
     onlyFiles: true
   });
   const files = matches.toSorted();
-  const sources = await Promise.all(files.map((file) => readFile5(file, "utf-8")));
+  const sources = await Promise.all(files.map((file) => readFile8(file, "utf-8")));
   const islands = [];
   const warnings = [];
   const seen = new Map;
@@ -6272,14 +6630,14 @@ var splitGlobBase = (pattern) => {
 };
 var discoverExamples = async (root, pattern = "examples") => {
   const { base, rest } = GLOB_MAGIC.test(pattern) ? splitGlobBase(pattern) : { base: pattern, rest: DEFAULT_EXAMPLE_GLOB };
-  const dir = join12(root, base);
+  const dir = join16(root, base);
   const matches = await glob2([rest], {
     absolute: true,
     cwd: dir,
     onlyFiles: true
   });
   const files = matches.toSorted();
-  const sources = await Promise.all(files.map((file) => readFile6(file, "utf-8")));
+  const sources = await Promise.all(files.map((file) => readFile9(file, "utf-8")));
   const examples = [];
   const warnings = [];
   const seen = new Map;
@@ -6353,10 +6711,10 @@ var customOgRoutes = (pages, siteTitle) => {
 };
 
 // src/astro/generate.ts
-var BLUME_SRC = join13(packageRoot(), "src");
+var BLUME_SRC = join17(packageRoot(), "src");
 var canResolveFrom = (fromDir, spec) => {
   try {
-    createRequire4(pathToFileURL2(join13(fromDir, "_.js")).href).resolve(spec);
+    createRequire5(pathToFileURL2(join17(fromDir, "_.js")).href).resolve(spec);
     return true;
   } catch {
     return false;
@@ -6364,15 +6722,15 @@ var canResolveFrom = (fromDir, spec) => {
 };
 var resolvedAstroPath = (fromDir) => {
   try {
-    const pkg = createRequire4(pathToFileURL2(join13(fromDir, "_.js")).href).resolve("astro/package.json");
+    const pkg = createRequire5(pathToFileURL2(join17(fromDir, "_.js")).href).resolve("astro/package.json");
     return realpathSync(pkg);
   } catch {
     return null;
   }
 };
 var blumeDepsDir = (pkgDir = packageRoot()) => {
-  const candidates = [join13(pkgDir, "node_modules"), dirname7(pkgDir)];
-  return candidates.find((dir) => existsSync7(join13(dir, "astro"))) ?? null;
+  const candidates = [join17(pkgDir, "node_modules"), dirname7(pkgDir)];
+  return candidates.find((dir) => existsSync9(join17(dir, "astro"))) ?? null;
 };
 var linkDepsJunction = async (link, depsDir) => {
   const existing = await lstat(link).catch(() => null);
@@ -6382,7 +6740,7 @@ var linkDepsJunction = async (link, depsDir) => {
     }
     await rm(link, { force: true });
   }
-  await mkdir2(dirname7(link), { recursive: true });
+  await mkdir3(dirname7(link), { recursive: true });
   await symlink(depsDir, link, "junction");
 };
 var readPkgVersion = (pkgJsonPath) => {
@@ -6412,8 +6770,8 @@ var ensureDepsLink = async (outDir, pkgDir = packageRoot()) => {
   if (blumeAstro && outDirAstro === blumeAstro) {
     return null;
   }
-  if (existsSync7(join13(depsDir, "@astrojs", "mdx"))) {
-    await linkDepsJunction(join13(outDir, "node_modules"), depsDir);
+  if (existsSync9(join17(depsDir, "@astrojs", "mdx"))) {
+    await linkDepsJunction(join17(outDir, "node_modules"), depsDir);
     return null;
   }
   return astroConflictWarning(blumeAstro, outDirAstro);
@@ -6437,7 +6795,7 @@ var readOptional = async (path) => {
     return "";
   }
   try {
-    return await readFile7(path, "utf-8");
+    return await readFile10(path, "utf-8");
   } catch {
     return "";
   }
@@ -6453,16 +6811,16 @@ var detectNeedsReact = async (root) => {
 var writeIfChanged = async (path, content) => {
   let existing = null;
   try {
-    existing = await readFile7(path, "utf-8");
+    existing = await readFile10(path, "utf-8");
   } catch {
     existing = null;
   }
   if (existing === content) {
     return false;
   }
-  await mkdir2(dirname7(path), { recursive: true });
+  await mkdir3(dirname7(path), { recursive: true });
   const tmp = `${path}.${process.pid}.tmp`;
-  await writeFile2(tmp, content, "utf-8");
+  await writeFile4(tmp, content, "utf-8");
   try {
     await rename(tmp, path);
   } catch (error) {
@@ -6477,7 +6835,7 @@ var pruneOrphans = async (srcDir, written) => {
     cwd: srcDir,
     onlyFiles: true
   });
-  await Promise.all(existing.map((path) => normalize(path)).filter((path) => !written.has(path)).map((path) => rm(path, { force: true })));
+  await Promise.all(existing.map((path) => normalize3(path)).filter((path) => !written.has(path)).map((path) => rm(path, { force: true })));
 };
 var collectStaged = (project) => {
   const staged = new Map;
@@ -6492,11 +6850,11 @@ var writeStagedContent = async (out, staged) => {
   const contentDir = stagedContentDir(out);
   const written = new Set;
   await Promise.all([...staged].map(async ([entryId, text]) => {
-    const path = join13(contentDir, entryId);
-    written.add(normalize(path));
+    const path = join17(contentDir, entryId);
+    written.add(normalize3(path));
     await writeIfChanged(path, text);
   }));
-  if (existsSync7(contentDir)) {
+  if (existsSync9(contentDir)) {
     await pruneOrphans(contentDir, written);
   }
 };
@@ -6513,9 +6871,9 @@ var resolveLogo = (project) => {
   if (light && light === dark && light.toLowerCase().endsWith(".svg")) {
     const rel = light.replace(/^\//u, "");
     const file = [
-      join13(project.context.root, "public", rel),
-      join13(project.context.root, rel)
-    ].find((path) => existsSync7(path));
+      join17(project.context.root, "public", rel),
+      join17(project.context.root, rel)
+    ].find((path) => existsSync9(path));
     if (file) {
       return { alt, href, svg: readFileSync6(file, "utf-8") };
     }
@@ -6543,7 +6901,7 @@ var faviconType = (name) => {
 };
 var inlineDataUri = (file, type) => `data:${type};base64,${readFileSync6(file).toString("base64")}`;
 var defaultFavicon = () => ({
-  href: inlineDataUri(join13(BLUME_SRC, "assets", "icon.png"), "image/png"),
+  href: inlineDataUri(join17(BLUME_SRC, "assets", "icon.png"), "image/png"),
   type: "image/png"
 });
 var APPLE_ICON_CANDIDATES = [
@@ -6555,13 +6913,13 @@ var APPLE_ICON_CANDIDATES = [
 var resolveIconFile = (project, candidates) => {
   const { root } = project.context;
   for (const name of candidates) {
-    if (existsSync7(join13(root, "public", name))) {
+    if (existsSync9(join17(root, "public", name))) {
       return { href: `/${name}`, type: faviconType(name) };
     }
   }
   for (const name of candidates) {
-    const file = join13(root, name);
-    if (existsSync7(file)) {
+    const file = join17(root, name);
+    if (existsSync9(file)) {
       const type = faviconType(name);
       return { href: inlineDataUri(file, type ?? "image/x-icon"), type };
     }
@@ -6643,6 +7001,7 @@ var buildRuntimeData = (project) => {
           label
         }))
       } : null,
+      icons: config.icons,
       imageZoom: config.markdown.imageZoom,
       logo: resolveLogo(project),
       mcp: config.mcp.enabled ? { name: config.mcp.name ?? config.title, route: config.mcp.route } : null,
@@ -6689,7 +7048,7 @@ var buildRuntimeData = (project) => {
 var planMcp = (project, srcDir) => {
   const { config } = project;
   const { route } = config.mcp;
-  const dir = join13(srcDir, "blume-mcp");
+  const dir = join17(srcDir, "blume-mcp");
   const base = {
     dir,
     discoveryPages: [],
@@ -6713,11 +7072,11 @@ var planMcp = (project, srcDir) => {
     ...base,
     discoveryPages: [
       {
-        entrypoint: join13(dir, "discovery.ts"),
+        entrypoint: join17(dir, "discovery.ts"),
         pattern: "/.well-known/mcp.json"
       },
       {
-        entrypoint: join13(dir, "server-card.ts"),
+        entrypoint: join17(dir, "server-card.ts"),
         pattern: "/.well-known/mcp/server-card.json"
       }
     ],
@@ -6736,11 +7095,11 @@ var writeMcpFiles = async (project, plan, write) => {
     version: data.version
   };
   await Promise.all([
-    write(join13(plan.srcDir, "generated", "mcp-data.json"), `${JSON.stringify(data)}
+    write(join17(plan.srcDir, "generated", "mcp-data.json"), `${JSON.stringify(data)}
 `),
-    write(join13(plan.srcDir, "pages", mcpPageFile(plan.route)), mcpEndpointTemplate(plan.route)),
-    write(join13(plan.dir, "discovery.ts"), staticJsonEndpointTemplate(buildMcpDiscovery(discoveryInput))),
-    write(join13(plan.dir, "server-card.ts"), staticJsonEndpointTemplate(buildMcpServerCard(discoveryInput)))
+    write(join17(plan.srcDir, "pages", mcpPageFile(plan.route)), mcpEndpointTemplate(plan.route)),
+    write(join17(plan.dir, "discovery.ts"), staticJsonEndpointTemplate(buildMcpDiscovery(discoveryInput))),
+    write(join17(plan.dir, "server-card.ts"), staticJsonEndpointTemplate(buildMcpServerCard(discoveryInput)))
   ]);
 };
 var writeAskFiles = async (project, srcDir, write) => {
@@ -6750,16 +7109,16 @@ var writeAskFiles = async (project, srcDir, write) => {
   }
   const grounded = ask.provider !== "inkeep";
   if (grounded) {
-    await write(join13(srcDir, "generated", "ask-data.json"), `${JSON.stringify(await buildAskData(project))}
+    await write(join17(srcDir, "generated", "ask-data.json"), `${JSON.stringify(await buildAskData(project))}
 `);
   }
-  await write(join13(srcDir, "pages", "api", "ask.ts"), askEndpointTemplate(resolveAskBackend(ask), grounded));
+  await write(join17(srcDir, "pages", "api", "ask.ts"), askEndpointTemplate(resolveAskBackend(ask), grounded));
 };
 var writeNotFoundPage = async (write, srcDir, pages, contentPages) => {
   if (routeIsTaken(pages, contentPages, "/404")) {
     return;
   }
-  await write(join13(srcDir, "pages", "404.astro"), notFoundPageTemplate());
+  await write(join17(srcDir, "pages", "404.astro"), notFoundPageTemplate());
 };
 var shouldGenerateChangelog = (project) => {
   const hasChangelog = project.graph.pages.some((page) => page.contentType === "changelog" && !(page.meta.draft || page.meta.sidebar.hidden));
@@ -6768,7 +7127,7 @@ var shouldGenerateChangelog = (project) => {
   return (hasChangelog || hasChangelogSource) && !changelogRouteTaken;
 };
 var buildComponentSlots = async (componentsFile) => {
-  const analysis = componentsFile ? analyzeComponentOverrides(await readFile7(componentsFile, "utf-8"), componentsFile) : null;
+  const analysis = componentsFile ? analyzeComponentOverrides(await readFile10(componentsFile, "utf-8"), componentsFile) : null;
   return {
     plan: planComponentSlots(componentsFile, analysis),
     tags: analysis ? [...analysis.mdx, ...analysis.islands].map((entry) => entry.key) : [],
@@ -6778,14 +7137,15 @@ var buildComponentSlots = async (componentsFile) => {
 var generateRuntime = async (project) => {
   const { context, config } = project;
   const out = context.outDir;
-  const srcDir = join13(out, "src");
-  const dataPath = join13(srcDir, "generated", "data.json");
-  const themePath = join13(srcDir, "generated", "app.css");
-  const searchClientPath = join13(srcDir, "generated", "search-client.ts");
-  const examplesPath = join13(srcDir, "generated", "examples.ts");
+  const srcDir = join17(out, "src");
+  const dataPath = join17(srcDir, "generated", "data.json");
+  const themePath = join17(srcDir, "generated", "app.css");
+  const searchClientPath = join17(srcDir, "generated", "search-client.ts");
+  const examplesPath = join17(srcDir, "generated", "examples.ts");
+  const openapiPath = join17(srcDir, "generated", "openapi.json");
   const written = new Set;
   const write = (path, content) => {
-    written.add(normalize(path));
+    written.add(normalize3(path));
     return writeIfChanged(path, content);
   };
   const depsLinkWarning = await ensureDepsLink(out);
@@ -6818,7 +7178,7 @@ var generateRuntime = async (project) => {
   const staged = collectStaged(project);
   const hasStaged = staged.size > 0;
   const structural = await Promise.all([
-    write(join13(out, "astro.config.mjs"), astroConfigTemplate({
+    write(join17(out, "astro.config.mjs"), astroConfigTemplate({
       aliases: resolveTsconfigAliases(context.root),
       config,
       contentRoutes: project.manifest.routes.map((route) => route.path),
@@ -6828,24 +7188,25 @@ var generateRuntime = async (project) => {
       needsReact,
       needsSvelte,
       needsVue,
+      openapiPath,
       pages,
       searchClientPath,
       themePath
     })),
-    write(join13(out, "package.json"), runtimePackageTemplate(runtimeDependencies({ config, needsReact, needsSvelte, needsVue }))),
-    write(join13(out, "tsconfig.json"), runtimeTsconfigTemplate()),
-    write(join13(srcDir, "env.d.ts"), envTemplate()),
-    write(join13(srcDir, "content.config.ts"), contentConfigTemplate({ config, context, staged: hasStaged })),
-    write(join13(srcDir, "pages", "[...slug].astro"), catchAllPageTemplate({
+    write(join17(out, "package.json"), runtimePackageTemplate(runtimeDependencies({ config, needsReact, needsSvelte, needsVue }))),
+    write(join17(out, "tsconfig.json"), runtimeTsconfigTemplate()),
+    write(join17(srcDir, "env.d.ts"), envTemplate()),
+    write(join17(srcDir, "content.config.ts"), contentConfigTemplate({ config, context, staged: hasStaged })),
+    write(join17(srcDir, "pages", "[...slug].astro"), catchAllPageTemplate({
       askEnabled,
       exportEpub,
       exportPdf,
       mathEnabled: config.markdown.math,
       needsReact
     })),
-    write(join13(srcDir, "generated", "components.ts"), slotPlan.module),
-    write(join13(srcDir, "generated", "islands.ts"), islandMapTemplate(islandDiscovery.islands)),
-    write(join13(srcDir, "generated", "examples.ts"), exampleMapTemplate(exampleDiscovery.examples)),
+    write(join17(srcDir, "generated", "components.ts"), slotPlan.module),
+    write(join17(srcDir, "generated", "islands.ts"), islandMapTemplate(islandDiscovery.islands)),
+    write(join17(srcDir, "generated", "examples.ts"), exampleMapTemplate(exampleDiscovery.examples)),
     write(themePath, tailwindEntryTemplate({
       configTokens: `${buildThemeCss(config.theme)}${buildFontsCss(config.theme.fonts)}`,
       sources: [
@@ -6856,16 +7217,16 @@ var generateRuntime = async (project) => {
       userTheme
     }))
   ]);
-  await Promise.all(islandDiscovery.islands.map((island) => write(join13(srcDir, "generated", "islands", `${island.name}.astro`), islandWrapperTemplate(island))));
-  await Promise.all(slotPlan.wrappers.map((wrapper) => write(join13(srcDir, "generated", "component-slots", `${wrapper.name}.astro`), wrapper.content)));
-  await Promise.all(exampleDiscovery.examples.map((example) => write(join13(srcDir, "generated", "examples", `${exampleSlug(example.path)}.astro`), exampleWrapperTemplate(example))));
+  await Promise.all(islandDiscovery.islands.map((island) => write(join17(srcDir, "generated", "islands", `${island.name}.astro`), islandWrapperTemplate(island))));
+  await Promise.all(slotPlan.wrappers.map((wrapper) => write(join17(srcDir, "generated", "component-slots", `${wrapper.name}.astro`), wrapper.content)));
+  await Promise.all(exampleDiscovery.examples.map((example) => write(join17(srcDir, "generated", "examples", `${exampleSlug(example.path)}.astro`), exampleWrapperTemplate(example))));
   await writeAskFiles(project, srcDir, write);
   await writeMcpFiles(project, mcp, write);
   if (config.seo.og.enabled) {
-    await write(join13(srcDir, "pages", "og", "[...slug].png.ts"), ogEndpointTemplate(ogRoutes));
+    await write(join17(srcDir, "pages", "og", "[...slug].png.ts"), ogEndpointTemplate(ogRoutes));
   }
   if (shouldGenerateChangelog(project)) {
-    await write(join13(srcDir, "pages", "changelog.astro"), changelogIndexTemplate({
+    await write(join17(srcDir, "pages", "changelog.astro"), changelogIndexTemplate({
       askEnabled,
       exportEpub,
       exportPdf,
@@ -6877,27 +7238,27 @@ var generateRuntime = async (project) => {
   await write(searchClientPath, searchClientTemplate(config));
   if (servesStaticIndex(config.search.provider)) {
     const documents = await buildSearchDocuments(project);
-    await write(join13(srcDir, "generated", "search.json"), `${JSON.stringify(documents)}
+    await write(join17(srcDir, "generated", "search.json"), `${JSON.stringify(documents)}
 `);
-    await write(join13(srcDir, "pages", "blume-search.json.ts"), searchEndpointTemplate());
+    await write(join17(srcDir, "pages", "blume-search.json.ts"), searchEndpointTemplate());
   }
   if (config.search.provider === "mixedbread") {
-    await write(join13(srcDir, "pages", "api", "search.ts"), mixedbreadSearchEndpointTemplate(config.search.mixedbread?.storeId ?? ""));
+    await write(join17(srcDir, "pages", "api", "search.ts"), mixedbreadSearchEndpointTemplate(config.search.mixedbread?.storeId ?? ""));
   }
   const rawMarkdown = await buildRawMarkdown(project);
   await Promise.all([
-    write(join13(srcDir, "generated", "raw-markdown.json"), `${JSON.stringify(rawMarkdown)}
+    write(join17(srcDir, "generated", "raw-markdown.json"), `${JSON.stringify(rawMarkdown)}
 `),
-    write(join13(srcDir, "pages", "[...slug].md.ts"), rawMarkdownEndpointTemplate()),
-    write(join13(srcDir, "pages", "[...slug].mdx.ts"), rawMarkdownEndpointTemplate())
+    write(join17(srcDir, "pages", "[...slug].md.ts"), rawMarkdownEndpointTemplate()),
+    write(join17(srcDir, "pages", "[...slug].mdx.ts"), rawMarkdownEndpointTemplate())
   ]);
   const feeds = buildRssFeeds(project);
   if (feeds.length > 0) {
     const feedXml = Object.fromEntries(feeds.map((feed) => [feed.type, renderRssFeed(feed)]));
     await Promise.all([
-      write(join13(srcDir, "generated", "rss.json"), `${JSON.stringify(feedXml)}
+      write(join17(srcDir, "generated", "rss.json"), `${JSON.stringify(feedXml)}
 `),
-      write(join13(srcDir, "pages", "[section]", "rss.xml.ts"), rssEndpointTemplate())
+      write(join17(srcDir, "pages", "[section]", "rss.xml.ts"), rssEndpointTemplate())
     ]);
   }
   const warnings = [
@@ -6927,17 +7288,20 @@ var generateRuntime = async (project) => {
     }
   }
   warnings.push(...islandFrameworkWarnings(frameworks, context.root));
-  if (hasReferences(config)) {
+  if (hasScalarReferences(config)) {
     const references = await buildReferenceFiles({
       config,
       contentRoutes: new Set(project.graph.pages.map((page) => page.route)),
       root: context.root
     });
     warnings.push(...references.warnings);
-    await Promise.all(references.files.map((file) => write(join13(srcDir, "pages", file.pagePath), file.content)));
+    await Promise.all(references.files.map((file) => write(join17(srcDir, "pages", file.pagePath), file.content)));
   }
-  await write(join13(srcDir, "generated", "data.json"), buildRuntimeData(project));
-  await write(join13(out, "blume.manifest.json"), `${JSON.stringify(project.manifest, null, 2)}
+  await write(join17(srcDir, "generated", "data.json"), buildRuntimeData(project));
+  const openApiSource2 = project.sources.find(isOpenApiSource);
+  await write(openapiPath, `${JSON.stringify(openApiSource2 ? openApiSource2.openApiData() : {})}
+`);
+  await write(join17(out, "blume.manifest.json"), `${JSON.stringify(project.manifest, null, 2)}
 `);
   await writeStagedContent(out, staged);
   await pruneOrphans(srcDir, written);
@@ -6945,12 +7309,12 @@ var generateRuntime = async (project) => {
 };
 
 // src/core/config.ts
-import { existsSync as existsSync10, readFileSync as readFileSync7 } from "node:fs";
+import { existsSync as existsSync11, readFileSync as readFileSync7 } from "node:fs";
 
 // src/core/bridge.ts
-import { existsSync as existsSync8 } from "node:fs";
-import { readFile as readFile9 } from "node:fs/promises";
-import { join as join14 } from "pathe";
+import { existsSync as existsSync10 } from "node:fs";
+import { readFile as readFile12 } from "node:fs/promises";
+import { join as join18 } from "pathe";
 
 // src/migrate/mintlify/assets.ts
 var assetRefs = (config) => {
@@ -6985,8 +7349,8 @@ var assetSegments = (config) => {
 };
 
 // src/migrate/mintlify/config.ts
-import { readFile as readFile8 } from "node:fs/promises";
-import { dirname as dirname8, relative as relative7, resolve as resolve4 } from "pathe";
+import { readFile as readFile11 } from "node:fs/promises";
+import { dirname as dirname8, relative as relative7, resolve as resolve5 } from "pathe";
 var MINTLIFY_DEFAULT_IGNORES = [
   "**/_*",
   "**/.*",
@@ -7027,7 +7391,7 @@ var isInsideRoot = (root, candidate) => {
 };
 var readJsonFile = async (file) => {
   try {
-    return JSON.parse(await readFile8(file, "utf-8"));
+    return JSON.parse(await readFile11(file, "utf-8"));
   } catch (error) {
     throw new BlumeError({
       code: "BLUME_MINTLIFY_CONFIG_INVALID",
@@ -7047,7 +7411,7 @@ var resolveRefs = async (value, options) => {
   }
   const ref = asString(object.$ref);
   if (ref) {
-    const refFile = resolve4(dirname8(options.file), ref);
+    const refFile = resolve5(dirname8(options.file), ref);
     if (!isInsideRoot(options.root, refFile)) {
       throw new BlumeError({
         code: "BLUME_MINTLIFY_REF_OUTSIDE_ROOT",
@@ -7403,13 +7767,15 @@ var mintlifySelectors = (spec) => {
 };
 var mintignorePatterns = async (root) => {
   try {
-    const raw = await readFile8(resolve4(root, ".mintignore"), "utf-8");
+    const raw = await readFile11(resolve5(root, ".mintignore"), "utf-8");
     return raw.split(`
 `).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#")).filter((line) => !line.startsWith("!")).map((line) => line.endsWith("/") ? `${line}**` : line);
   } catch {
     return [];
   }
 };
+var REDIRECT_PARAM = /:(?<name>[A-Za-z_]\w*)(?<modifier>[*+?])?/gu;
+var toAstroRedirectPath = (path) => path.replaceAll(REDIRECT_PARAM, (_match, name, modifier) => modifier === "*" || modifier === "+" ? `[...${name}]` : `[${name}]`);
 var mintlifyRedirects = (spec) => asArray(spec.redirects).flatMap((redirect) => {
   const object = asObject(redirect);
   if (!object) {
@@ -7420,8 +7786,72 @@ var mintlifyRedirects = (spec) => asArray(spec.redirects).flatMap((redirect) =>
   if (!from || !to) {
     return [];
   }
-  return [{ from, to }];
+  return [{ from: toAstroRedirectPath(from), to: toAstroRedirectPath(to) }];
 });
+var openapiRouteFromDirectory = (value) => {
+  const directory = normalizeDirectory(asString(value) ?? "");
+  return directory.length > 0 ? `/${directory}` : undefined;
+};
+var openapiSourcesFromValue = (value, context) => {
+  if (typeof value === "string") {
+    if (value.length === 0 || API_ENDPOINT_REF.test(value)) {
+      return [];
+    }
+    return [
+      withoutUndefined({
+        label: context.label,
+        route: context.route,
+        spec: value
+      })
+    ];
+  }
+  if (Array.isArray(value)) {
+    return value.flatMap((item) => openapiSourcesFromValue(item, context));
+  }
+  const object = asObject(value);
+  if (!object) {
+    return [];
+  }
+  return openapiSourcesFromValue(object.source ?? object.openapi, {
+    label: context.label,
+    route: openapiRouteFromDirectory(object.directory) ?? context.route
+  });
+};
+var mintlifyOpenapi = (spec) => {
+  const drafts = [];
+  const visit = (node) => {
+    if (Array.isArray(node)) {
+      for (const item of node) {
+        visit(item);
+      }
+      return;
+    }
+    const object = asObject(node);
+    if (!object) {
+      return;
+    }
+    if (hasOwn(object, "openapi")) {
+      drafts.push(...openapiSourcesFromValue(object.openapi, {
+        label: labelForNavItem(object)
+      }));
+    }
+    for (const children of childNavigationArrays(object)) {
+      visit(children);
+    }
+  };
+  visit(spec.navigation);
+  drafts.push(...openapiSourcesFromValue(spec.openapi, {}));
+  drafts.push(...openapiSourcesFromValue(asObject(spec.api)?.openapi, {}));
+  const seen = new Set;
+  const sources = drafts.flatMap((draft) => {
+    if (seen.has(draft.spec)) {
+      return [];
+    }
+    seen.add(draft.spec);
+    return [draft];
+  });
+  return sources.length > 0 ? { enabled: true, sources } : undefined;
+};
 var mintlifyLogo = (value) => {
   if (typeof value === "string") {
     return value;
@@ -7453,6 +7883,12 @@ var mintlifyFavicon = (value) => {
   }
   return withoutUndefined({ dark, light });
 };
+var mintlifyIcons = (value) => {
+  const library = asString(asObject(value)?.library);
+  return {
+    library: library === "lucide" || library === "tabler" ? library : "fontawesome"
+  };
+};
 var mintlifyBanner = (value) => {
   const object = asObject(value);
   const content = object ? asString(object.content) : undefined;
@@ -7543,6 +7979,27 @@ var mintlifyMarkdown = (value, styling) => {
     schema: object?.schema === false ? false : undefined
   });
 };
+var FAMILY_TO_SLUG = Object.fromEntries(Object.entries(GOOGLE_FONTS).map(([slug, def]) => [
+  def.family.toLowerCase(),
+  slug
+]));
+var fontSlugForFamily = (value) => {
+  const family = asString(value);
+  return family ? FAMILY_TO_SLUG[family.toLowerCase()] : undefined;
+};
+var mintlifyFonts = (value) => {
+  const object = asObject(value);
+  if (!object) {
+    return;
+  }
+  const heading = asObject(object.heading);
+  const body = asObject(object.body);
+  const fonts = withoutUndefined({
+    body: fontSlugForFamily(body?.family) ?? fontSlugForFamily(object.family),
+    display: fontSlugForFamily(heading?.family) ?? fontSlugForFamily(object.family)
+  });
+  return Object.keys(fonts).length > 0 ? fonts : undefined;
+};
 var mintlifySeo = (value) => {
   const object = asObject(value);
   const metatags = asObject(object?.metatags);
@@ -7554,8 +8011,8 @@ var mintlifySeo = (value) => {
   };
 };
 var loadMintlifyConfig = async (root, file) => {
-  const projectRoot = resolve4(root);
-  const configFile = resolve4(file);
+  const projectRoot = resolve5(root);
+  const configFile = resolve5(file);
   const spec = asObject(await resolveRefs(await readJsonFile(configFile), {
     file: configFile,
     root: projectRoot,
@@ -7588,6 +8045,7 @@ var loadMintlifyConfig = async (root, file) => {
     },
     description: asString(spec.description),
     favicon: mintlifyFavicon(spec.favicon),
+    icons: mintlifyIcons(spec.icons),
     logo: mintlifyLogo(spec.logo),
     markdown: mintlifyMarkdown(spec.markdown, styling),
     navigation: {
@@ -7597,6 +8055,7 @@ var loadMintlifyConfig = async (root, file) => {
       sidebarVariants: await mintlifySidebarVariants(spec),
       tabs: mintlifyTabs(spec)
     },
+    openapi: mintlifyOpenapi(spec),
     redirects: mintlifyRedirects(spec),
     search: {
       indexing: {
@@ -7614,6 +8073,7 @@ var loadMintlifyConfig = async (root, file) => {
       backgroundDecoration: mintlifyBackgroundDecoration(spec.background),
       backgroundImage: backgroundImage.light,
       backgroundImageDark: backgroundImage.dark,
+      fonts: mintlifyFonts(spec.fonts ?? spec.font),
       mode: appearance.default === "light" || appearance.default === "dark" || appearance.default === "system" ? appearance.default : "system",
       strict: appearance.strict === true
     },
@@ -7651,12 +8111,12 @@ var mintlifyI18n = (spec) => {
 // src/core/bridge.ts
 var MINTLIFY_CONFIG_FILES = ["docs.json", "mint.json"];
 var detectMintlifyBridge = async (root) => {
-  const configFile = MINTLIFY_CONFIG_FILES.map((name) => join14(root, name)).find((candidate) => existsSync8(candidate));
+  const configFile = MINTLIFY_CONFIG_FILES.map((name) => join18(root, name)).find((candidate) => existsSync10(candidate));
   if (!configFile) {
     return null;
   }
   const config = await loadMintlifyConfig(root, configFile);
-  const spec = JSON.parse(await readFile9(configFile, "utf-8"));
+  const spec = JSON.parse(await readFile12(configFile, "utf-8"));
   const i18n = mintlifyI18n(spec);
   if (i18n) {
     config.i18n = i18n;
@@ -7667,7 +8127,7 @@ var detectMintlifyBridge = async (root) => {
   const variables = config.variables ?? {};
   const root_ = config.content?.root ?? ".";
   const exclude = config.content?.exclude ?? [];
-  const assets = assetSegments(config).filter((segment) => segment !== "public" && existsSync8(join14(root, segment)));
+  const assets = assetSegments(config).filter((segment) => segment !== "public" && existsSync10(join18(root, segment)));
   return {
     configFile,
     raw: {
@@ -7741,42 +8201,6 @@ var createModuleLoader = () => {
   };
 };
 
-// src/core/project.ts
-import { existsSync as existsSync9 } from "node:fs";
-import { isAbsolute as isAbsolute4, join as join15, resolve as resolve5 } from "pathe";
-var CONFIG_FILENAMES = [
-  "blume.config.ts",
-  "blume.config.mjs",
-  "blume.config.js"
-];
-var THEME_FILENAMES = ["theme.css"];
-var COMPONENTS_FILENAMES = ["components.tsx", "components.ts"];
-var firstExisting = (root, names) => {
-  for (const name of names) {
-    const candidate = join15(root, name);
-    if (existsSync9(candidate)) {
-      return candidate;
-    }
-  }
-  return null;
-};
-var findConfigFile = (root) => firstExisting(root, CONFIG_FILENAMES);
-var resolveProjectContext = (root, config) => {
-  const absoluteRoot = resolve5(root);
-  const contentRoot = isAbsolute4(config.content.root) ? config.content.root : join15(absoluteRoot, config.content.root);
-  const pagesPath = join15(absoluteRoot, config.content.pages);
-  const pagesRoot = existsSync9(pagesPath) ? pagesPath : null;
-  return {
-    componentsFile: firstExisting(absoluteRoot, COMPONENTS_FILENAMES),
-    configFile: findConfigFile(absoluteRoot),
-    contentRoot,
-    outDir: join15(absoluteRoot, ".blume"),
-    pagesRoot,
-    root: absoluteRoot,
-    themeFile: firstExisting(absoluteRoot, THEME_FILENAMES)
-  };
-};
-
 // src/core/schema.ts
 import { z as z2 } from "zod";
 var iconName = z2.string().min(1);
@@ -7806,7 +8230,17 @@ var changelogMetaSchema = z2.object({
   date: dateSchema.optional(),
   version: z2.string().optional()
 }).strict();
+var authorSchema = z2.union([
+  z2.string(),
+  z2.object({
+    avatar: z2.string().optional(),
+    image: z2.string().optional(),
+    name: z2.string(),
+    url: z2.string().optional()
+  }).passthrough()
+]);
 var pageMetaBaseSchema = z2.object({
+  authors: z2.union([authorSchema, z2.array(authorSchema)]).optional(),
   changelog: changelogMetaSchema.optional(),
   date: dateSchema.optional(),
   deprecated: z2.boolean().default(false),
@@ -8247,7 +8681,10 @@ var openapiSourceSchema = z2.object({
   spec: z2.string()
 }).strict();
 var openapiConfigSchema = z2.object({
+  codeSamples: z2.array(z2.string()).default(["curl", "js", "python"]),
   enabled: z2.boolean().default(false),
+  expandSchemas: z2.boolean().default(false),
+  renderer: z2.enum(["blume", "scalar"]).default("blume"),
   route: z2.string().default("/reference"),
   sources: z2.array(openapiSourceSchema).default([]),
   spec: z2.string().optional(),
@@ -8276,6 +8713,9 @@ var tocConfigSchema = z2.union([
     minLevel: value.minHeadingLevel ?? 2
   };
 });
+var iconsConfigSchema = z2.object({
+  library: z2.enum(["lucide", "fontawesome", "tabler"]).default("lucide")
+}).strict();
 var blumeConfigSchema = z2.object({
   ai: aiConfigSchema.default({}),
   analytics: analyticsConfigSchema.optional(),
@@ -8290,6 +8730,7 @@ var blumeConfigSchema = z2.object({
   feedback: z2.boolean().default(true),
   github: githubConfigSchema.optional(),
   i18n: i18nConfigSchema.optional(),
+  icons: iconsConfigSchema.default({}),
   lastModified: lastModifiedConfigSchema.default(false),
   logo: logoConfigSchema.optional(),
   markdown: markdownConfigSchema.default({}),
@@ -8331,7 +8772,7 @@ var loadConfig = async (root, options = {}) => {
   const sourceFile = bridge?.configFile ?? configFile;
   const parsed = blumeConfigSchema.safeParse(raw ?? {});
   if (!parsed.success) {
-    const source = sourceFile && existsSync10(sourceFile) ? readFileSync7(sourceFile, "utf-8") : undefined;
+    const source = sourceFile && existsSync11(sourceFile) ? readFileSync7(sourceFile, "utf-8") : undefined;
     const diagnostics = diagnosticsFromZod(parsed.error, {
       code: "BLUME_CONFIG_INVALID",
       file: sourceFile ?? undefined,
@@ -8808,7 +9249,7 @@ var discoverFolderMeta = async (contentRoot) => {
 };
 
 // src/core/sources/normalize.ts
-import { existsSync as existsSync11, readFileSync as readFileSync8 } from "node:fs";
+import { existsSync as existsSync12, readFileSync as readFileSync8 } from "node:fs";
 import GithubSlugger from "github-slugger";
 import { extname as extname4 } from "pathe";
 var NUMERIC_PREFIX2 = /^\d+[-_.]/u;
@@ -8816,7 +9257,7 @@ var GROUP_FOLDER2 = /^\((?<label>.+)\)$/u;
 var WORD_SPLIT2 = /[-_]/u;
 var stripNumericPrefix = (segment) => segment.replace(NUMERIC_PREFIX2, "");
 var groupLabel = (segment) => segment.match(GROUP_FOLDER2)?.groups?.label ?? null;
-var slugify2 = (text) => text.toLowerCase().trim().replaceAll(/[^\w\s-]/gu, "").replaceAll(/[\s_]+/gu, "-").replaceAll(/-+/gu, "-").replaceAll(/^-|-$/gu, "");
+var slugify3 = (text) => text.toLowerCase().trim().replaceAll(/[^\w\s-]/gu, "").replaceAll(/[\s_]+/gu, "-").replaceAll(/-+/gu, "-").replaceAll(/^-|-$/gu, "");
 var titleCase = (value) => value.split(WORD_SPLIT2).filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
 var mapRoute = (relativePath) => {
   const withoutExt = relativePath.slice(0, relativePath.length - extname4(relativePath).length);
@@ -8934,7 +9375,7 @@ var normalizeEntry2 = (entry, ctx) => {
   const ext = format === "mdx" ? ".mdx" : ".md";
   const result = pageMetaSchema.safeParse(entry.data);
   if (!result.success) {
-    const source = entry.raw ?? (entry.sourcePath && existsSync11(entry.sourcePath) ? readFileSync8(entry.sourcePath, "utf-8") : undefined);
+    const source = entry.raw ?? (entry.sourcePath && existsSync12(entry.sourcePath) ? readFileSync8(entry.sourcePath, "utf-8") : undefined);
     return {
       diagnostics: diagnosticsFromZod(result.error, {
         code: "BLUME_FRONTMATTER_INVALID",
@@ -8983,15 +9424,15 @@ var normalizeEntry2 = (entry, ctx) => {
 };
 
 // src/core/sources/resolve.ts
-import { join as join24 } from "pathe";
+import { join as join26 } from "pathe";
 
 // src/core/sources/filesystem.ts
-import { existsSync as existsSync12, watch as fsWatch } from "node:fs";
-import { readFile as readFile10 } from "node:fs/promises";
-import { extname as extname5, isAbsolute as isAbsolute5, join as join16, relative as relative10, resolve as resolve6 } from "pathe";
+import { existsSync as existsSync13, watch as fsWatch } from "node:fs";
+import { readFile as readFile13 } from "node:fs/promises";
+import { extname as extname5, isAbsolute as isAbsolute6, join as join19, relative as relative10, resolve as resolve6 } from "pathe";
 import { glob as glob6 } from "tinyglobby";
 var filesystemSource = (options) => {
-  const contentRoot = isAbsolute5(options.root) ? options.root : join16(resolve6(options.projectRoot), options.root);
+  const contentRoot = isAbsolute6(options.root) ? options.root : join19(resolve6(options.projectRoot), options.root);
   const load2 = async () => {
     const files = await glob6(options.include, {
       absolute: true,
@@ -9001,7 +9442,7 @@ var filesystemSource = (options) => {
     });
     files.sort();
     const entries = await Promise.all(files.map(async (file) => {
-      const source = await readFile10(file, "utf-8");
+      const source = await readFile13(file, "utf-8");
       const ext = extname5(file).toLowerCase();
       const format = ext === ".mdx" ? "mdx" : "md";
       const parsed = frontmatter_default(source);
@@ -9015,7 +9456,7 @@ var filesystemSource = (options) => {
     return { diagnostics: [], entries };
   };
   const validate = () => {
-    if (!existsSync12(contentRoot)) {
+    if (!existsSync13(contentRoot)) {
       throw new BlumeError({
         code: options.missingCode ?? "BLUME_CONTENT_ROOT_MISSING",
         file: contentRoot,
@@ -9026,7 +9467,7 @@ var filesystemSource = (options) => {
     }
   };
   const watch = (onChange) => {
-    if (!existsSync12(contentRoot)) {
+    if (!existsSync13(contentRoot)) {
       return () => {};
     }
     const watcher = fsWatch(contentRoot, { recursive: true }, onChange);
@@ -9037,97 +9478,21 @@ var filesystemSource = (options) => {
     load: load2,
     name: options.name,
     prefix: options.prefix,
-    read: (ref) => readFile10(join16(contentRoot, ref), "utf-8"),
+    read: (ref) => readFile13(join19(contentRoot, ref), "utf-8"),
     staged: false,
     validate,
     watch
   };
 };
 
-// src/core/sources/cache.ts
-import { mkdir as mkdir3, readFile as readFile11, writeFile as writeFile3 } from "node:fs/promises";
-import { join as join17 } from "pathe";
-var hashText = (text) => {
-  let hash = 5381;
-  for (let i = 0;i < text.length; i += 1) {
-    hash = (hash * 33 + (text.codePointAt(i) ?? 0)) % 2147483647;
-  }
-  return hash.toString(36);
-};
-var entriesDigest = (entries) => hashText(entries.map((entry) => `${entry.ref}:${entry.hash ?? hashText(entry.body.text)}`).join("|"));
-var pollingWatch = (load2, intervalSeconds) => (onChange) => {
-  let last = "";
-  const tick = async () => {
-    try {
-      const { entries } = await load2();
-      const next = entriesDigest(entries);
-      if (last && next !== last) {
-        onChange();
-      }
-      last = next;
-    } catch {}
-  };
-  const timer = setInterval(() => {
-    tick();
-  }, intervalSeconds * 1000);
-  return () => clearInterval(timer);
-};
-var snapshotCache = (cacheDir) => {
-  const file = join17(cacheDir, "entries.json");
-  return {
-    read: async () => {
-      try {
-        return JSON.parse(await readFile11(file, "utf-8"));
-      } catch {
-        return [];
-      }
-    },
-    write: async (entries) => {
-      try {
-        await mkdir3(cacheDir, { recursive: true });
-        await writeFile3(file, `${JSON.stringify(entries)}
-`, "utf-8");
-      } catch {}
-    }
-  };
-};
-var loadWithCache = async (name, cache, fetchEntries, refresh = true) => {
-  if (!refresh) {
-    const cached3 = await cache.read();
-    if (cached3.length > 0) {
-      return { diagnostics: [], entries: cached3 };
-    }
-  }
-  try {
-    const entries = await fetchEntries();
-    await cache.write(entries);
-    return { diagnostics: [], entries };
-  } catch (error) {
-    const fallback = await cache.read();
-    if (fallback.length > 0) {
-      const diagnostic = {
-        code: "BLUME_SOURCE_OFFLINE",
-        message: `Source "${name}" could not be fetched (${error.message}); served ${fallback.length} cached entries.`,
-        severity: "warning"
-      };
-      return { diagnostics: [diagnostic], entries: fallback };
-    }
-    throw new BlumeError({
-      code: "BLUME_SOURCE_FETCH_FAILED",
-      message: `Source "${name}" failed to load and no cache is available: ${error.message}`,
-      severity: "error"
-    });
-  }
-};
-
 // src/core/sources/github-releases.ts
 var DEFAULT_BASE_URL = "https://api.github.com";
 var DEFAULT_LIMIT = 100;
 var PER_PAGE = 100;
 var LEADING_V = /^v/iu;
-var NON_SLUG2 = /[^a-z0-9]+/gu;
+var NON_SLUG3 = /[^a-z0-9]+/gu;
 var EDGE_DASHES = /^-+|-+$/gu;
-var slugifyTag = (tag) => tag.toLowerCase().replaceAll(NON_SLUG2, "-").replaceAll(EDGE_DASHES, "");
+var slugifyTag = (tag) => tag.toLowerCase().replaceAll(NON_SLUG3, "-").replaceAll(EDGE_DASHES, "");
 var githubHeaders = () => {
   const headers = new Headers({ Accept: "application/vnd.github+json" });
   const token = process.env.GITHUB_TOKEN;
@@ -9390,25 +9755,25 @@ var mdxRemoteSource = (options, ctx) => {
 };
 
 // src/core/sources/mintlify.ts
-import { existsSync as existsSync14, watch as fsWatch2 } from "node:fs";
-import { readFile as readFile13 } from "node:fs/promises";
-import { isAbsolute as isAbsolute7, join as join20, relative as relative14, resolve as resolve8 } from "pathe";
+import { existsSync as existsSync15, watch as fsWatch2 } from "node:fs";
+import { readFile as readFile15 } from "node:fs/promises";
+import { isAbsolute as isAbsolute8, join as join22, relative as relative14, resolve as resolve8 } from "pathe";
 import { glob as glob7 } from "tinyglobby";
 
 // src/migrate/shared.ts
-import { existsSync as existsSync13 } from "node:fs";
-import { readFile as readFile12, writeFile as writeFile4 } from "node:fs/promises";
-import { isAbsolute as isAbsolute6, join as join18, relative as relative11 } from "pathe";
+import { existsSync as existsSync14 } from "node:fs";
+import { readFile as readFile14, writeFile as writeFile5 } from "node:fs/promises";
+import { isAbsolute as isAbsolute7, join as join20, relative as relative11 } from "pathe";
 var isInsideRoot2 = (root, candidate) => {
   const rel = relative11(root, candidate);
-  return rel === "" || !rel.startsWith("..") && !isAbsolute6(rel);
+  return rel === "" || !rel.startsWith("..") && !isAbsolute7(rel);
 };
 var writeBlumeConfig = async (root, config) => {
   const body = `import { defineConfig } from "blume";
 
 export default defineConfig(${JSON.stringify(config, null, 2)});
 `;
-  await writeFile4(join18(root, "blume.config.ts"), body, "utf-8");
+  await writeFile5(join20(root, "blume.config.ts"), body, "utf-8");
 };
 var BLUME_SCRIPTS = {
   build: "blume build",
@@ -9416,13 +9781,13 @@ var BLUME_SCRIPTS = {
   start: "blume preview"
 };
 var rewriteFrameworkScripts = async (root, cli, remove) => {
-  const pkgPath = join18(root, "package.json");
-  if (!existsSync13(pkgPath)) {
+  const pkgPath = join20(root, "package.json");
+  if (!existsSync14(pkgPath)) {
     return false;
   }
   let pkg;
   try {
-    pkg = JSON.parse(await readFile12(pkgPath, "utf-8"));
+    pkg = JSON.parse(await readFile14(pkgPath, "utf-8"));
   } catch {
     return false;
   }
@@ -9445,12 +9810,12 @@ var rewriteFrameworkScripts = async (root, cli, remove) => {
   }
   if (changed) {
     pkg.scripts = next;
-    await writeFile4(pkgPath, `${JSON.stringify(pkg, null, 2)}
+    await writeFile5(pkgPath, `${JSON.stringify(pkg, null, 2)}
 `, "utf-8");
   }
   return changed;
 };
-var leftoverFiles = (root, candidates) => candidates.filter((candidate) => existsSync13(join18(root, candidate)));
+var leftoverFiles = (root, candidates) => candidates.filter((candidate) => existsSync14(join20(root, candidate)));
 var attribute = (attrs, name) => {
   const match = attrs.match(new RegExp(`\\b${name}=(?:"(?<dq>[^"]*)"|'(?<sq>[^']*)')`, "u"));
   return match?.groups?.dq ?? match?.groups?.sq;
@@ -9847,7 +10212,7 @@ var isLiteralObject = (value) => typeof value === "object" && value !== null &&
 var asLiteralArray = (value) => Array.isArray(value) ? value : undefined;
 
 // src/migrate/mintlify/content.ts
-import { dirname as dirname10, join as join19, relative as relative12 } from "pathe";
+import { dirname as dirname10, join as join21, relative as relative12 } from "pathe";
 var CALLOUT_DIRECTIVES = {
   Check: "success",
   Danger: "danger",
@@ -9883,7 +10248,7 @@ var rewriteSnippetImports = (source, options) => {
     if (/\.mdx?$/u.test(importSource)) {
       return "";
     }
-    const target = join19(options.root, importSource.replace(/^\/+/u, ""));
+    const target = join21(options.root, importSource.replace(/^\/+/u, ""));
     components.push(importSource.replace(/^\/+/u, ""));
     let rel = relative12(dirname10(options.filePath), target);
     if (!rel.startsWith(".")) {
@@ -9893,7 +10258,7 @@ var rewriteSnippetImports = (source, options) => {
   });
   return { components, source: next };
 };
-var UNSUPPORTED_COMPONENTS = ["ParamField", "ResponseField"];
+var UNSUPPORTED_COMPONENTS = ["Update"];
 var unsupportedMintlifyComponents = (source) => UNSUPPORTED_COMPONENTS.filter((name) => new RegExp(`<${name}\\b`, "u").test(source));
 
 // src/migrate/mintlify/frontmatter.ts
@@ -10164,9 +10529,9 @@ var rewriteMintlifyMarkdownSnippets = async (source, options) => {
       throw new Error(snippetCycleMessage(options.root, file, options.trail ?? []));
     }
     seen.add(file);
-    const readFile13 = options.readFile ?? readFileFromDisk;
+    const readFile15 = options.readFile ?? readFileFromDisk;
     try {
-      const raw = await readFile13(file);
+      const raw = await readFile15(file);
       const content = frontmatter_default(raw).content.trim();
       const transformed = await rewriteMintlifyMarkdownSnippets(content, {
         ...options,
@@ -10207,7 +10572,7 @@ var rewriteMintlifyMarkdownSnippets = async (source, options) => {
   return await inlineAt(0, source);
 };
 var rewriteMintlifySnippetVariables = async (source, options) => {
-  const readFile13 = options.readFile ?? readFileFromDisk;
+  const readFile15 = options.readFile ?? readFileFromDisk;
   const inlineImport = async (current, variableImport) => {
     const file = resolveSnippetPath({
       filePath: options.filePath,
@@ -10217,7 +10582,7 @@ var rewriteMintlifySnippetVariables = async (source, options) => {
     if (!file) {
       return current;
     }
-    const exports = collectStringExports(frontmatter_default(await readFile13(file)).content);
+    const exports = collectStringExports(frontmatter_default(await readFile15(file)).content);
     let next = current;
     for (const name of variableImport.names) {
       const value = exports.get(name.imported);
@@ -10295,7 +10660,7 @@ var MINTLIFY_SOURCE_IGNORES = [
   "snippets/**"
 ];
 var mintlifySource = (options) => {
-  const contentRoot = isAbsolute7(options.root) ? options.root : join20(resolve8(options.projectRoot), options.root);
+  const contentRoot = isAbsolute8(options.root) ? options.root : join22(resolve8(options.projectRoot), options.root);
   const ignore = [...new Set([...options.exclude, ...MINTLIFY_SOURCE_IGNORES])];
   const transform = (raw, file) => transformMintlifyContent(raw, {
     filePath: file,
@@ -10312,7 +10677,7 @@ var mintlifySource = (options) => {
     files.sort();
     const unsupported = new Set;
     const entries = await Promise.all(files.map(async (file) => {
-      const result = await transform(await readFile13(file, "utf-8"), file);
+      const result = await transform(await readFile15(file, "utf-8"), file);
       for (const name of result.unsupported) {
         unsupported.add(name);
       }
@@ -10328,14 +10693,14 @@ var mintlifySource = (options) => {
     const diagnostics = unsupported.size > 0 ? [
       {
         code: "BLUME_MINTLIFY_UNSUPPORTED",
-        message: `Mintlify components without a Blume equivalent were left as-is: ${[...unsupported].toSorted().join(", ")}. Use the OpenAPI reference for API parameters.`,
+        message: `Mintlify components without a Blume equivalent were left as-is: ${[...unsupported].toSorted().join(", ")}. Replace them by hand or provide a matching component.`,
         severity: "warning"
       }
     ] : [];
     return { diagnostics, entries };
   };
   const validate = () => {
-    if (!existsSync14(contentRoot)) {
+    if (!existsSync15(contentRoot)) {
       throw new BlumeError({
         code: "BLUME_CONTENT_ROOT_MISSING",
         file: contentRoot,
@@ -10347,11 +10712,11 @@ var mintlifySource = (options) => {
   };
   const watch = (onChange) => {
     const disposers = [];
-    if (existsSync14(contentRoot)) {
+    if (existsSync15(contentRoot)) {
       const watcher = fsWatch2(contentRoot, { recursive: true }, onChange);
       disposers.push(() => watcher.close());
     }
-    if (options.configFile && existsSync14(options.configFile)) {
+    if (options.configFile && existsSync15(options.configFile)) {
       const watcher = fsWatch2(options.configFile, onChange);
       disposers.push(() => watcher.close());
     }
@@ -10362,8 +10727,8 @@ var mintlifySource = (options) => {
     };
   };
   const read = async (ref) => {
-    const file = join20(contentRoot, ref);
-    const result = await transform(await readFile13(file, "utf-8"), file);
+    const file = join22(contentRoot, ref);
+    const result = await transform(await readFile15(file, "utf-8"), file);
     return result.content;
   };
   return {
@@ -10380,11 +10745,11 @@ var mintlifySource = (options) => {
 
 // src/core/sources/notion.ts
 import { setTimeout as sleep } from "node:timers/promises";
-import { join as join22 } from "pathe";
+import { join as join24 } from "pathe";
 
 // src/core/sources/assets.ts
-import { mkdir as mkdir4, writeFile as writeFile5 } from "node:fs/promises";
-import { extname as extname6, join as join21 } from "pathe";
+import { mkdir as mkdir4, writeFile as writeFile6 } from "node:fs/promises";
+import { extname as extname6, join as join23 } from "pathe";
 var MD_IMAGE = /!\[(?<alt>[^\]]*)\]\((?<url>[^)\s]+)\)/gu;
 var REMOTE = /^https?:\/\//u;
 var SAFE_EXT = /^\.[a-z0-9]+$/iu;
@@ -10413,7 +10778,7 @@ var materializeAssets = async (markdown, ctx) => {
       const bytes = new Uint8Array(await res.arrayBuffer());
       const file = `${hashText(url)}${extFor(url)}`;
       await mkdir4(ctx.assetsDir, { recursive: true });
-      await writeFile5(join21(ctx.assetsDir, file), bytes);
+      await writeFile6(join23(ctx.assetsDir, file), bytes);
       rewrites.set(url, `${ctx.assetsBaseUrl}/${file}`);
     } catch (error) {
       diagnostics.push({
@@ -10529,8 +10894,8 @@ ${text}
 };
 var notionSource = (options, ctx) => {
   const props = options.properties ?? {};
-  const cache = snapshotCache(ctx?.cacheDir ?? join22(".blume", "cache", options.name));
-  const assetsDir = ctx?.assetsDir ?? join22(".blume", "public", "blume-assets", options.name);
+  const cache = snapshotCache(ctx?.cacheDir ?? join24(".blume", "cache", options.name));
+  const assetsDir = ctx?.assetsDir ?? join24(".blume", "public", "blume-assets", options.name);
   const assetsBaseUrl = ctx?.assetsBaseUrl ?? `/blume-assets/${options.name}`;
   let snapshot = new Map;
   const resolveClient = async () => {
@@ -10635,10 +11000,10 @@ ${rendered.join(`
       data.sidebar = { order };
     }
     const slugProp = richToMarkdown(page.properties[props.slug ?? "Slug"]?.rich_text);
-    const slug = slugify2(slugProp || title) || page.id;
+    const slug = slugify3(slugProp || title) || page.id;
     return { data, slug };
   };
-  const toEntry = async (client, page) => {
+  const toEntry2 = async (client, page) => {
     const { data, slug } = frontmatter(page);
     const mdx = await renderBlocks(client, await childrenOf(client, page.id));
     const assets = await materializeAssets(mdx, {
@@ -10667,7 +11032,7 @@ ${rendered.join(`
         database_id: options.database,
         start_cursor: cursor
       })));
-      const built = await Promise.all(pages.map((page) => toEntry(client, page)));
+      const built = await Promise.all(pages.map((page) => toEntry2(client, page)));
       for (const item of built) {
         assetDiagnostics.push(...item.diagnostics);
       }
@@ -10698,7 +11063,7 @@ ${rendered.join(`
 };
 
 // src/core/sources/sanity.ts
-import { join as join23 } from "pathe";
+import { join as join25 } from "pathe";
 
 // src/core/sources/portable-text.ts
 var HEADING_STYLES = {
@@ -10837,11 +11202,11 @@ var resolveClient = async (options, preview) => {
 };
 var sanitySource = (options, ctx) => {
   const fields = options.fields ?? {};
-  const cache = snapshotCache(ctx?.cacheDir ?? join23(".blume", "cache", options.name));
+  const cache = snapshotCache(ctx?.cacheDir ?? join25(".blume", "cache", options.name));
   let snapshot = new Map;
-  const toEntry = (doc) => {
+  const toEntry2 = (doc) => {
     const slugValue = asString2(getPath(doc, fields.slug ?? "slug.current")) ?? asString2(doc._id) ?? "untitled";
-    const slug = slugify2(slugValue) || slugify2(asString2(doc._id) ?? "") || "untitled";
+    const slug = slugify3(slugValue) || slugify3(asString2(doc._id) ?? "") || "untitled";
     const data = {};
     const title = asString2(getPath(doc, fields.title ?? "title"));
     const description = asString2(getPath(doc, fields.description ?? "description"));
@@ -10873,7 +11238,7 @@ var sanitySource = (options, ctx) => {
     const result = await loadWithCache(options.name, cache, async () => {
       const client = await resolveClient(options, ctx?.preview ?? false);
       const docs = await client.fetch(options.query);
-      return docs.map(toEntry);
+      return docs.map(toEntry2);
     }, ctx?.refresh ?? true);
     snapshot = new Map(result.entries.map((entry) => [entry.ref, entry]));
     return result;
@@ -10912,8 +11277,8 @@ var uniqueNamer = () => {
 };
 var sourceContext = (context, name, runtime) => ({
   assetsBaseUrl: `/blume-assets/${name}`,
-  assetsDir: join24(context.outDir, "public", "blume-assets", name),
-  cacheDir: join24(context.outDir, "cache", name),
+  assetsDir: join26(context.outDir, "public", "blume-assets", name),
+  cacheDir: join26(context.outDir, "cache", name),
   mode: runtime.mode,
   preview: runtime.preview,
   projectRoot: context.root,
@@ -10995,7 +11360,7 @@ var baseName = (def) => {
   }
   return def.prefix ?? def.type;
 };
-var resolveSources = (config, context, runtime) => {
+var contentSources = (config, context, runtime) => {
   const defs = config.content.sources;
   if (!defs || defs.length === 0) {
     return [
@@ -11011,6 +11376,14 @@ var resolveSources = (config, context, runtime) => {
   const nameFor = uniqueNamer();
   return defs.map((def) => buildSource(def, nameFor(baseName(def)), context, runtime));
 };
+var resolveSources = (config, context, runtime) => {
+  const sources = contentSources(config, context, runtime);
+  const references = blumeReferences(config);
+  if (references.length > 0) {
+    sources.push(openApiSource(references, sourceContext(context, "openapi", runtime)));
+  }
+  return sources;
+};
 
 // src/core/project-graph.ts
 var applyConfigOverrides = (config, overrides) => {
@@ -11039,7 +11412,9 @@ var scanProject = async (root, options = {}) => {
   });
   const { bridge } = configResult;
   const config = applyConfigOverrides(configResult.config, options.overrides);
-  const context = resolveProjectContext(root, config);
+  const context = resolveProjectContext(root, config, {
+    runtimeDir: options.runtimeDir
+  });
   const sources = resolveSources(config, context, {
     mode,
     preview,
@@ -11107,8 +11482,8 @@ var scanProject = async (root, options = {}) => {
 };
 
 // src/cli/env.ts
-import { existsSync as existsSync15, readFileSync as readFileSync9 } from "node:fs";
-import { dirname as dirname12, join as join25, resolve as resolve9 } from "pathe";
+import { existsSync as existsSync16, readFileSync as readFileSync9 } from "node:fs";
+import { dirname as dirname12, join as join27, resolve as resolve9 } from "pathe";
 var ENV_LINE = /^\s*(?:export\s+)?(?<key>[A-Za-z_][A-Za-z0-9_]*)\s*=\s*(?<value>.*?)\s*$/u;
 var DOUBLE_QUOTED2 = /^"(?<body>[\s\S]*)"$/u;
 var SINGLE_QUOTED = /^'(?<body>[\s\S]*)'$/u;
@@ -11146,7 +11521,7 @@ var applyEnv = (parsed) => {
 };
 var loadFile = (path) => {
   try {
-    if (existsSync15(path)) {
+    if (existsSync16(path)) {
       applyEnv(parseEnv(readFileSync9(path, "utf-8")));
     }
   } catch {}
@@ -11155,10 +11530,10 @@ var loadEnvFiles = (startDir) => {
   let dir = resolve9(startDir);
   let done = false;
   while (!done) {
-    loadFile(join25(dir, ".env.local"));
-    loadFile(join25(dir, ".env"));
+    loadFile(join27(dir, ".env.local"));
+    loadFile(join27(dir, ".env"));
     const parent = dirname12(dir);
-    done = existsSync15(join25(dir, ".git")) || parent === dir;
+    done = existsSync16(join27(dir, ".git")) || parent === dir;
     dir = parent;
   }
 };
@@ -11231,7 +11606,8 @@ var prepareProject = async (options) => {
       mode: options.mode,
       overrides: options.overrides,
       preview: options.preview,
-      refresh: options.refresh
+      refresh: options.refresh,
+      runtimeDir: options.runtimeDir
     });
   } catch (error) {
     if (error instanceof BlumeError) {
@@ -11287,24 +11663,24 @@ var emitRedirectFiles = async (config, distDir) => {
   if (redirects.length === 0 || config.deployment.output !== "static") {
     return;
   }
-  await writeFile6(join26(distDir, "blume-redirects.json"), buildRedirectManifest(redirects), "utf-8");
+  await writeFile7(join28(distDir, "blume-redirects.json"), buildRedirectManifest(redirects), "utf-8");
   const platformFiles = [
     { content: buildNetlifyRedirects(redirects), name: "_redirects" },
     { content: buildVercelConfig(redirects), name: "vercel.json" }
   ];
-  await Promise.all(platformFiles.map((file) => existsSync16(join26(distDir, file.name)) ? Promise.resolve() : writeFile6(join26(distDir, file.name), file.content, "utf-8")));
+  await Promise.all(platformFiles.map((file) => existsSync17(join28(distDir, file.name)) ? Promise.resolve() : writeFile7(join28(distDir, file.name), file.content, "utf-8")));
   logger.success(`Emitted redirect files for ${redirects.length} redirect(s)`);
 };
 var formatBytes = (bytes) => bytes < 1024 ? `${bytes} B` : `${(bytes / 1024).toFixed(bytes < 1024 * 100 ? 1 : 0)} kB`;
 var astroAssets = async (distDir, ext) => {
-  const astroDir = join26(distDir, "_astro");
-  if (!existsSync16(astroDir)) {
+  const astroDir = join28(distDir, "_astro");
+  if (!existsSync17(astroDir)) {
     return [];
   }
   const entries = await readdir(astroDir);
   const files = entries.filter((name) => name.endsWith(`.${ext}`));
   const sized = await Promise.all(files.map(async (name) => {
-    const info = await stat(join26(astroDir, name));
+    const info = await stat(join28(astroDir, name));
     return { name, size: info.size };
   }));
   return sized.toSorted((a, b) => b.size - a.size);
@@ -11346,6 +11722,58 @@ var enforceBudget = async (distDir, args) => {
   }
   return passed ? "pass" : "fail";
 };
+var publishBuildArtifacts = async (project, distDir, args) => {
+  if (project.config.search.provider === "pagefind") {
+    logger.start("Building search index");
+    const indexed = await buildSearchIndex(distDir);
+    logger.success(`Indexed ${indexed} page(s) for search`);
+  }
+  await syncSearchProvider(project, {
+    start: (message) => logger.start(message),
+    success: (message) => logger.success(message),
+    warn: (message) => logger.warn(message)
+  });
+  if (project.config.ai.llmsTxt) {
+    const { index, full } = await buildLlmsFiles(project);
+    await Promise.all([
+      writeFile7(join28(distDir, "llms.txt"), index, "utf-8"),
+      writeFile7(join28(distDir, "llms-full.txt"), full, "utf-8")
+    ]);
+    logger.success("Generated llms.txt and llms-full.txt");
+  }
+  const sitemap = buildSitemap(project);
+  if (sitemap && !existsSync17(join28(distDir, "sitemap.xml"))) {
+    await writeFile7(join28(distDir, "sitemap.xml"), sitemap, "utf-8");
+    logger.success("Generated sitemap.xml");
+  }
+  const robots = buildRobots(project);
+  if (robots && !existsSync17(join28(distDir, "robots.txt"))) {
+    await writeFile7(join28(distDir, "robots.txt"), robots, "utf-8");
+    logger.success("Generated robots.txt");
+  }
+  await emitRedirectFiles(project.config, distDir);
+  const { config } = project;
+  const features = serverFeatures(config);
+  logger.box([
+    `Output     ${config.deployment.output}`,
+    `Adapter    ${config.deployment.adapter ?? "none"}`,
+    `Site       ${config.deployment.site ?? "not set"}`,
+    `Search     ${config.search.provider}`,
+    `Redirects  ${config.redirects.length}`,
+    `Sitemap    ${sitemap ? "yes" : "no (set deployment.site)"}`,
+    `Robots     ${robots ? "yes" : "no"}`,
+    `LLM files  ${config.ai.llmsTxt ? "yes" : "no"}`,
+    `Server features  ${features.length > 0 ? features.join(", ") : "none"}`
+  ].join(`
+`));
+  if (args.analyze) {
+    await reportBundleSizes(distDir);
+  }
+  if (await enforceBudget(distDir, args) === "fail") {
+    process.exit(1);
+  }
+  logger.success(`Built to ${distDir}`);
+};
 var buildCommand = defineCommand2({
   args: {
     adapter: {
@@ -11368,6 +11796,10 @@ var buildCommand = defineCommand2({
       description: "Fail if total client JavaScript exceeds this many kB.",
       type: "string"
     },
+    isolated: {
+      description: "Build into an isolated .blume-verify runtime (and its own dist) so a running dev server and the real dist/ are untouched. For verifying changes while `blume dev` runs.",
+      type: "boolean"
+    },
     output: {
       description: "Output mode: static | server.",
       type: "string"
@@ -11384,7 +11816,11 @@ var buildCommand = defineCommand2({
   },
   async run({ args }) {
     const root = process.cwd();
-    refuseIfDevRunning(root, "building");
+    const runtimeDir = args.isolated ? ".blume-verify" : process.env.BLUME_RUNTIME_DIR;
+    refuseIfDevRunning(root, "building", runtimeDir);
+    if (args.isolated) {
+      await ensureGitignore(root, [".blume-verify/"]);
+    }
     if (args.output && args.output !== "static" && args.output !== "server") {
       logger.error(`Invalid --output "${args.output}" (use static | server).`);
       process.exit(1);
@@ -11403,6 +11839,7 @@ var buildCommand = defineCommand2({
       },
       preview: args.preview,
       root,
+      runtimeDir,
       strict: args.strict
     });
     logger.start(`Building ${project.graph.pages.length} page(s) (${project.config.deployment.output} output)`);
@@ -11410,68 +11847,27 @@ var buildCommand = defineCommand2({
       logLevel: "info",
       root: project.context.outDir
     });
-    const distDir = join26(root, "dist");
-    if (project.config.search.provider === "pagefind") {
-      logger.start("Building search index");
-      const indexed = await buildSearchIndex(distDir);
-      logger.success(`Indexed ${indexed} page(s) for search`);
-    }
-    await syncSearchProvider(project, {
-      start: (message) => logger.start(message),
-      success: (message) => logger.success(message),
-      warn: (message) => logger.warn(message)
-    });
-    if (project.config.ai.llmsTxt) {
-      const { index, full } = await buildLlmsFiles(project);
-      await Promise.all([
-        writeFile6(join26(distDir, "llms.txt"), index, "utf-8"),
-        writeFile6(join26(distDir, "llms-full.txt"), full, "utf-8")
-      ]);
-      logger.success("Generated llms.txt and llms-full.txt");
-    }
-    const sitemap = buildSitemap(project);
-    if (sitemap && !existsSync16(join26(distDir, "sitemap.xml"))) {
-      await writeFile6(join26(distDir, "sitemap.xml"), sitemap, "utf-8");
-      logger.success("Generated sitemap.xml");
-    }
-    const robots = buildRobots(project);
-    if (robots && !existsSync16(join26(distDir, "robots.txt"))) {
-      await writeFile6(join26(distDir, "robots.txt"), robots, "utf-8");
-      logger.success("Generated robots.txt");
-    }
-    await emitRedirectFiles(project.config, distDir);
-    const { config } = project;
-    const features = serverFeatures(config);
-    logger.box([
-      `Output     ${config.deployment.output}`,
-      `Adapter    ${config.deployment.adapter ?? "none"}`,
-      `Site       ${config.deployment.site ?? "not set"}`,
-      `Search     ${config.search.provider}`,
-      `Redirects  ${config.redirects.length}`,
-      `Sitemap    ${sitemap ? "yes" : "no (set deployment.site)"}`,
-      `Robots     ${robots ? "yes" : "no"}`,
-      `LLM files  ${config.ai.llmsTxt ? "yes" : "no"}`,
-      `Server features  ${features.length > 0 ? features.join(", ") : "none"}`
-    ].join(`
-`));
-    if (args.analyze) {
-      await reportBundleSizes(distDir);
-    }
-    if (await enforceBudget(distDir, args) === "fail") {
-      process.exit(1);
+    const distDir = project.context.distDir ?? join28(root, "dist");
+    if (runtimeDir) {
+      logger.success(`Isolated build OK — output at ${distDir} (not published).`);
+      return;
     }
-    logger.success(`Built to ${distDir}`);
+    await publishBuildArtifacts(project, distDir, args);
   }
 });
 
 // src/cli/commands/check.ts
-import { existsSync as existsSync17 } from "node:fs";
+import { existsSync as existsSync18 } from "node:fs";
 import { check } from "@astrojs/check";
 import { sync } from "astro";
 import { defineCommand as defineCommand3 } from "citty";
-import { join as join27 } from "pathe";
+import { join as join29 } from "pathe";
 var checkCommand = defineCommand3({
   args: {
+    isolated: {
+      description: "Type-check in an isolated .blume-verify runtime so a running dev server is untouched. For verifying changes while `blume dev` runs.",
+      type: "boolean"
+    },
     preview: {
       description: "Include drafts and unpublished CMS content.",
       type: "boolean"
@@ -11487,21 +11883,27 @@ var checkCommand = defineCommand3({
   },
   async run({ args }) {
     const root = process.cwd();
+    const runtimeDir = args.isolated ? ".blume-verify" : process.env.BLUME_RUNTIME_DIR;
+    refuseIfDevRunning(root, "checking", runtimeDir);
+    if (args.isolated) {
+      await ensureGitignore(root, [".blume-verify/"]);
+    }
     const project = await prepareProject({
       mode: "build",
       preview: args.preview,
       root,
+      runtimeDir,
       strict: args.strict
     });
     const { outDir } = project.context;
     await sync({ logLevel: "warn", root: outDir });
-    const tsconfig = join27(root, "tsconfig.json");
+    const tsconfig = join29(root, "tsconfig.json");
     logger.start(`Type-checking ${project.graph.pages.length} page(s)`);
     const failed = await check({
       minimumFailingSeverity: "error",
       minimumSeverity: "hint",
       root: outDir,
-      tsconfig: existsSync17(tsconfig) ? tsconfig : undefined,
+      tsconfig: existsSync18(tsconfig) ? tsconfig : undefined,
       watch: false
     });
     if (failed) {
@@ -11518,7 +11920,7 @@ import { dev } from "astro";
 import { defineCommand as defineCommand4 } from "citty";
 
 // src/astro/static-assets.ts
-import { extname as extname7, join as join28, relative as relative15, resolve as resolve10, sep } from "pathe";
+import { extname as extname7, join as join30, relative as relative15, resolve as resolve10, sep } from "pathe";
 
 // src/astro/integration.ts
 var overlayServer = null;
@@ -11744,15 +12146,19 @@ var doctorCommand = defineCommand5({
 });
 
 // src/cli/commands/eject.ts
-import { readFile as readFile15, writeFile as writeFile8 } from "node:fs/promises";
+import { readFile as readFile17, writeFile as writeFile9 } from "node:fs/promises";
 import { defineCommand as defineCommand6 } from "citty";
-import { join as join30, relative as relative17 } from "pathe";
+import { join as join32, relative as relative17 } from "pathe";
 
 // src/registry/eject.ts
-import { existsSync as existsSync18 } from "node:fs";
-import { cp, mkdir as mkdir5, readFile as readFile14, rm as rm2, writeFile as writeFile7 } from "node:fs/promises";
-import { join as join29, relative as relative16 } from "pathe";
+import { existsSync as existsSync19 } from "node:fs";
+import { cp, mkdir as mkdir5, readFile as readFile16, rm as rm2, writeFile as writeFile8 } from "node:fs/promises";
+import { join as join31, relative as relative16 } from "pathe";
 var POSIX = (path) => path.split("\\").join("/");
+var ejectOpenApiData = (project) => {
+  const source = project.sources.find(isOpenApiSource);
+  return source ? source.openApiData() : {};
+};
 var askFiles = async (project, srcDir, genDir) => {
   const { ask } = project.config.ai;
   if (!ask?.enabled) {
@@ -11762,14 +12168,14 @@ var askFiles = async (project, srcDir, genDir) => {
   const files = [
     {
       content: askEndpointTemplate(resolveAskBackend(ask), grounded),
-      path: join29(srcDir, "pages", "api", "ask.ts")
+      path: join31(srcDir, "pages", "api", "ask.ts")
     }
   ];
   if (grounded) {
     files.push({
       content: `${JSON.stringify(await buildAskData(project))}
 `,
-      path: join29(genDir, "ask-data.json")
+      path: join31(genDir, "ask-data.json")
     });
   }
   return files;
@@ -11777,15 +12183,15 @@ var askFiles = async (project, srcDir, genDir) => {
 var eject = async (root) => {
   const project = await scanProject(root, { mode: "build" });
   const { context, config } = project;
-  const srcDir = join29(root, "src");
-  const genDir = join29(srcDir, "generated");
+  const srcDir = join31(root, "src");
+  const genDir = join31(srcDir, "generated");
   const askEnabled = config.ai.ask?.enabled ?? false;
   const exportPdf = config.export.pdf;
   const exportEpub = config.export.epub;
   const [pages, needsReactRaw, userTheme, rawMarkdown, islands, examples] = await Promise.all([
     context.pagesRoot ? discoverPages(context.pagesRoot) : Promise.resolve([]),
     detectNeedsReact(root),
-    context.themeFile ? readFile14(context.themeFile, "utf-8") : Promise.resolve(""),
+    context.themeFile ? readFile16(context.themeFile, "utf-8") : Promise.resolve(""),
     buildRawMarkdown(project),
     discoverIslands(root),
     discoverExamples(root, config.examples)
@@ -11822,18 +12228,19 @@ var eject = async (root) => {
         needsReact,
         needsSvelte,
         needsVue,
+        openapiPath: "./src/generated/openapi.json",
         pages: relPages,
         searchClientPath: "./src/generated/search-client.ts",
         themePath: "./src/generated/app.css"
       }),
-      path: join29(root, "astro.config.mjs")
+      path: join31(root, "astro.config.mjs")
     },
     {
       content: runtimeTsconfigTemplate(),
-      path: join29(root, "tsconfig.json"),
+      path: join31(root, "tsconfig.json"),
       skipIfExists: true
     },
-    { content: envTemplate(), path: join29(srcDir, "env.d.ts") },
+    { content: envTemplate(), path: join31(srcDir, "env.d.ts") },
     {
       content: contentConfigTemplate({
         config,
@@ -11841,7 +12248,7 @@ var eject = async (root) => {
         staged: hasStaged,
         stagedBase: stagedDir
       }),
-      path: join29(srcDir, "content.config.ts")
+      path: join31(srcDir, "content.config.ts")
     },
     {
       content: catchAllPageTemplate({
@@ -11851,19 +12258,19 @@ var eject = async (root) => {
         mathEnabled: config.markdown.math,
         needsReact
       }),
-      path: join29(srcDir, "pages", "[...slug].astro")
+      path: join31(srcDir, "pages", "[...slug].astro")
     },
     {
       content: planComponentSlots(componentsImport, null).module,
-      path: join29(genDir, "components.ts")
+      path: join31(genDir, "components.ts")
     },
     {
       content: islandMapTemplate(islands.islands),
-      path: join29(genDir, "islands.ts")
+      path: join31(genDir, "islands.ts")
     },
     {
       content: exampleMapTemplate(examples.examples),
-      path: join29(genDir, "examples.ts")
+      path: join31(genDir, "examples.ts")
     },
     {
       content: tailwindEntryTemplate({
@@ -11875,21 +12282,26 @@ var eject = async (root) => {
         twoslashCss: twoslashCss(),
         userTheme
       }),
-      path: join29(genDir, "app.css")
+      path: join31(genDir, "app.css")
+    },
+    { content: buildRuntimeData(project), path: join31(genDir, "data.json") },
+    {
+      content: `${JSON.stringify(ejectOpenApiData(project))}
+`,
+      path: join31(genDir, "openapi.json")
     },
-    { content: buildRuntimeData(project), path: join29(genDir, "data.json") },
     {
       content: `${JSON.stringify(rawMarkdown)}
 `,
-      path: join29(genDir, "raw-markdown.json")
+      path: join31(genDir, "raw-markdown.json")
     },
     {
       content: rawMarkdownEndpointTemplate(),
-      path: join29(srcDir, "pages", "[...slug].md.ts")
+      path: join31(srcDir, "pages", "[...slug].md.ts")
     },
     {
       content: rawMarkdownEndpointTemplate(),
-      path: join29(srcDir, "pages", "[...slug].mdx.ts")
+      path: join31(srcDir, "pages", "[...slug].mdx.ts")
     }
   ];
   if (askEnabled) {
@@ -11898,34 +12310,34 @@ var eject = async (root) => {
   if (config.seo.og.enabled) {
     files.push({
       content: ogEndpointTemplate(customOgRoutes(pages, config.title)),
-      path: join29(srcDir, "pages", "og", "[...slug].png.ts")
+      path: join31(srcDir, "pages", "og", "[...slug].png.ts")
     });
   }
   if (!routeIsTaken(pages, project.graph.pages, "/404")) {
     files.push({
       content: notFoundPageTemplate(),
-      path: join29(srcDir, "pages", "404.astro")
+      path: join31(srcDir, "pages", "404.astro")
     });
   }
   files.push({
     content: searchClientTemplate(config),
-    path: join29(genDir, "search-client.ts")
+    path: join31(genDir, "search-client.ts")
   });
   if (servesStaticIndex(config.search.provider)) {
     const documents = await buildSearchDocuments(project);
     files.push({
       content: `${JSON.stringify(documents)}
 `,
-      path: join29(genDir, "search.json")
+      path: join31(genDir, "search.json")
     }, {
       content: searchEndpointTemplate(),
-      path: join29(srcDir, "pages", "blume-search.json.ts")
+      path: join31(srcDir, "pages", "blume-search.json.ts")
     });
   }
   if (config.search.provider === "mixedbread") {
     files.push({
       content: mixedbreadSearchEndpointTemplate(config.search.mixedbread?.storeId ?? ""),
-      path: join29(srcDir, "pages", "api", "search.ts")
+      path: join31(srcDir, "pages", "api", "search.ts")
     });
   }
   const feeds = buildRssFeeds(project);
@@ -11934,13 +12346,13 @@ var eject = async (root) => {
     files.push({
       content: `${JSON.stringify(feedXml)}
 `,
-      path: join29(genDir, "rss.json")
+      path: join31(genDir, "rss.json")
     }, {
       content: rssEndpointTemplate(),
-      path: join29(srcDir, "pages", "[section]", "rss.xml.ts")
+      path: join31(srcDir, "pages", "[section]", "rss.xml.ts")
     });
   }
-  if (hasReferences(config)) {
+  if (hasScalarReferences(config)) {
     const references = await buildReferenceFiles({
       config,
       contentRoutes: new Set(project.graph.pages.map((page) => page.route)),
@@ -11949,28 +12361,28 @@ var eject = async (root) => {
     for (const file of references.files) {
       files.push({
         content: file.content,
-        path: join29(srcDir, "pages", file.pagePath)
+        path: join31(srcDir, "pages", file.pagePath)
       });
     }
   }
   files.push(...islands.islands.map((island) => ({
     content: islandWrapperTemplate(island),
-    path: join29(genDir, "islands", `${island.name}.astro`)
+    path: join31(genDir, "islands", `${island.name}.astro`)
   })), ...examples.examples.map((example) => ({
     content: exampleWrapperTemplate(example),
-    path: join29(genDir, "examples", `${exampleSlug(example.path)}.astro`)
+    path: join31(genDir, "examples", `${exampleSlug(example.path)}.astro`)
   })));
   for (const [entryId, content] of staged) {
-    files.push({ content, path: join29(root, stagedDir, entryId) });
+    files.push({ content, path: join31(root, stagedDir, entryId) });
   }
-  const written = files.filter((file) => !(file.skipIfExists && existsSync18(file.path)));
+  const written = files.filter((file) => !(file.skipIfExists && existsSync19(file.path)));
   await Promise.all(written.map(async (file) => {
-    await mkdir5(join29(file.path, ".."), { recursive: true });
-    await writeFile7(file.path, file.content, "utf-8");
+    await mkdir5(join31(file.path, ".."), { recursive: true });
+    await writeFile8(file.path, file.content, "utf-8");
   }));
-  const assetsSrc = join29(context.outDir, "public", "blume-assets");
-  if (existsSync18(assetsSrc)) {
-    await cp(assetsSrc, join29(root, "public", "blume-assets"), {
+  const assetsSrc = join31(context.outDir, "public", "blume-assets");
+  if (existsSync19(assetsSrc)) {
+    await cp(assetsSrc, join31(root, "public", "blume-assets"), {
       recursive: true
     });
   }
@@ -11980,10 +12392,10 @@ var eject = async (root) => {
 
 // src/cli/commands/eject.ts
 var updatePackageScripts = async (root) => {
-  const pkgPath = join30(root, "package.json");
+  const pkgPath = join32(root, "package.json");
   let pkg;
   try {
-    pkg = JSON.parse(await readFile15(pkgPath, "utf-8"));
+    pkg = JSON.parse(await readFile17(pkgPath, "utf-8"));
   } catch {
     return;
   }
@@ -11994,7 +12406,7 @@ var updatePackageScripts = async (root) => {
     dev: "astro dev",
     preview: "astro preview"
   };
-  await writeFile8(pkgPath, `${JSON.stringify(pkg, null, 2)}
+  await writeFile9(pkgPath, `${JSON.stringify(pkg, null, 2)}
 `, "utf-8");
 };
 var ejectCommand = defineCommand6({
@@ -12033,32 +12445,7 @@ The blume package remains importable.`);
 import { existsSync as existsSync20 } from "node:fs";
 import { mkdir as mkdir6, writeFile as writeFile10 } from "node:fs/promises";
 import { defineCommand as defineCommand7 } from "citty";
-import { basename as basename4, dirname as dirname13, isAbsolute as isAbsolute8, join as join32, relative as relative18 } from "pathe";
-
-// src/core/gitignore.ts
-import { existsSync as existsSync19 } from "node:fs";
-import { readFile as readFile16, writeFile as writeFile9 } from "node:fs/promises";
-import { join as join31 } from "pathe";
-var gitignoreKey = (line) => line.trim().replace(/\/+$/u, "");
-var ensureGitignore = async (root, entries) => {
-  const path = join31(root, ".gitignore");
-  const existing = existsSync19(path) ? await readFile16(path, "utf-8") : "";
-  const present = new Set(existing.split(`
-`).map(gitignoreKey).filter(Boolean));
-  const added = entries.filter((entry) => !present.has(gitignoreKey(entry)));
-  if (added.length === 0) {
-    return [];
-  }
-  const gap = existing.length > 0 && !existing.endsWith(`
-`) ? `
-` : "";
-  await writeFile9(path, `${existing}${gap}${added.join(`
-`)}
-`, "utf-8");
-  return added;
-};
-
-// src/cli/commands/init.ts
+import { basename as basename4, dirname as dirname13, isAbsolute as isAbsolute9, join as join33, relative as relative18 } from "pathe";
 var toPackageName = (raw) => raw.toLowerCase().replaceAll(/[^a-z0-9._-]+/gu, "-").replaceAll(/^[-_.]+|[-_.]+$/gu, "") || "docs";
 var packageTemplate = (name, version) => `{
   "name": ${JSON.stringify(name)},
@@ -12106,7 +12493,7 @@ var STARTERS = {
     files: (dir) => [
       {
         content: page("API Reference", "Explore the API.", "# API Reference\n\nYour OpenAPI spec renders at [`/api`](/api). Point `openapi.sources` at your own spec in `blume.config.ts`."),
-        path: join32(dir, "index.mdx")
+        path: join33(dir, "index.mdx")
       }
     ]
   },
@@ -12121,7 +12508,7 @@ var STARTERS = {
     files: (dir) => [
       {
         content: page("Introduction", "Welcome to your new Blume docs.", "# Introduction\n\nWrite your docs here, and log releases under `changelog/`."),
-        path: join32(dir, "index.mdx")
+        path: join33(dir, "index.mdx")
       },
       {
         content: `---
@@ -12132,7 +12519,7 @@ date: 2026-01-01
 
 The first release. Edit \`${dir}/changelog/v1-0-0.mdx\` or add new entries beside it.
 `,
-        path: join32(dir, "changelog", "v1-0-0.mdx")
+        path: join33(dir, "changelog", "v1-0-0.mdx")
       }
     ]
   },
@@ -12145,7 +12532,7 @@ The first release. Edit \`${dir}/changelog/v1-0-0.mdx\` or add new entries besid
 Welcome to **Blume** — markdown-first docs powered by Astro and Vite.
 
 Edit \`${dir}/index.mdx\` to get started, then run \`blume dev\`.`),
-        path: join32(dir, "index.mdx")
+        path: join33(dir, "index.mdx")
       }
     ]
   },
@@ -12156,11 +12543,11 @@ Edit \`${dir}/index.mdx\` to get started, then run \`blume dev\`.`),
         content: page("Introduction", "Get started with the SDK.", `# Introduction
 
 Install the SDK and make your first call. See [Installation](/installation).`),
-        path: join32(dir, "index.mdx")
+        path: join33(dir, "index.mdx")
       },
       {
         content: page("Installation", "Install the SDK.", "# Installation\n\n```package-install\nyour-sdk\n```"),
-        path: join32(dir, "installation.mdx")
+        path: join33(dir, "installation.mdx")
       }
     ]
   }
@@ -12207,7 +12594,7 @@ var initCommand = defineCommand7({
   async run({ args }) {
     const root = process.cwd();
     const contentDir = args["content-dir"] ?? "docs";
-    if (isAbsolute8(contentDir) || relative18(root, join32(root, contentDir)).startsWith("..")) {
+    if (isAbsolute9(contentDir) || relative18(root, join33(root, contentDir)).startsWith("..")) {
       logger.error(`Invalid --content-dir "${contentDir}" (must be a path inside the project).`);
       process.exit(1);
     }
@@ -12222,9 +12609,9 @@ var initCommand = defineCommand7({
       process.exit(1);
     }
     const starter = STARTERS[template];
-    const createdPackage = await writeFileSafe(join32(root, "package.json"), packageTemplate(toPackageName(basename4(root)), getBlumeVersion()));
-    await writeFileSafe(join32(root, "blume.config.ts"), starter.config);
-    await Promise.all(starter.files(contentDir).map((file) => writeFileSafe(join32(root, file.path), file.content)));
+    const createdPackage = await writeFileSafe(join33(root, "package.json"), packageTemplate(toPackageName(basename4(root)), getBlumeVersion()));
+    await writeFileSafe(join33(root, "blume.config.ts"), starter.config);
+    await Promise.all(starter.files(contentDir).map((file) => writeFileSafe(join33(root, file.path), file.content)));
     const ignored = await ensureGitignore(root, [".blume/", "dist/"]);
     if (ignored.length > 0) {
       logger.success(`Added ${ignored.join(", ")} to .gitignore`);
@@ -12266,14 +12653,14 @@ import { defineCommand as defineCommand8 } from "citty";
 
 // src/migrate/fumadocs/index.ts
 import { existsSync as existsSync24 } from "node:fs";
-import { mkdir as mkdir8, readFile as readFile18, rename as rename3, rm as rm3, writeFile as writeFile12 } from "node:fs/promises";
-import { dirname as dirname16, join as join35, relative as relative19 } from "pathe";
+import { mkdir as mkdir8, readFile as readFile19, rename as rename3, rm as rm3, writeFile as writeFile12 } from "node:fs/promises";
+import { dirname as dirname16, join as join36, relative as relative19 } from "pathe";
 import { glob as glob8 } from "tinyglobby";
 
 // src/migrate/fumadocs/config.ts
 import { existsSync as existsSync21 } from "node:fs";
-import { readFile as readFile17 } from "node:fs/promises";
-import { basename as basename5, dirname as dirname14, join as join33 } from "pathe";
+import { readFile as readFile18 } from "node:fs/promises";
+import { basename as basename5, dirname as dirname14, join as join34 } from "pathe";
 var SOURCE_FILES = [
   "lib/source.ts",
   "app/source.ts",
@@ -12303,7 +12690,7 @@ var GENERIC_NAMES = new Set([
 var gitRepoRoot = (start) => {
   let dir = start;
   for (;; ) {
-    if (existsSync21(join33(dir, ".git"))) {
+    if (existsSync21(join34(dir, ".git"))) {
       return dir;
     }
     const parent = dirname14(dir);
@@ -12315,12 +12702,12 @@ var gitRepoRoot = (start) => {
 };
 var bareName = (name) => name.includes("/") ? name.slice(name.lastIndexOf("/") + 1) : name;
 var readTitle = async (root) => {
-  const packageJson = join33(root, "package.json");
+  const packageJson = join34(root, "package.json");
   if (!existsSync21(packageJson)) {
     return "Documentation";
   }
   try {
-    const parsed = JSON.parse(await readFile17(packageJson, "utf-8"));
+    const parsed = JSON.parse(await readFile18(packageJson, "utf-8"));
     const { name } = parsed;
     if (typeof name !== "string" || !name.trim()) {
       return "Documentation";
@@ -12341,11 +12728,11 @@ var readTitle = async (root) => {
 };
 var scrapeBaseUrl = async (root) => {
   for (const candidate of SOURCE_FILES) {
-    const file = join33(root, candidate);
+    const file = join34(root, candidate);
     if (!existsSync21(file)) {
       continue;
     }
-    const base = BASE_URL.exec(await readFile17(file, "utf-8"))?.groups?.base;
+    const base = BASE_URL.exec(await readFile18(file, "utf-8"))?.groups?.base;
     if (base) {
       return base;
     }
@@ -12620,7 +13007,7 @@ var normalizeFumadocsPageMeta = (value) => {
 // src/migrate/fumadocs/groups.ts
 import { existsSync as existsSync23, statSync as statSync2 } from "node:fs";
 import { mkdir as mkdir7, rename as rename2, writeFile as writeFile11 } from "node:fs/promises";
-import { basename as basename6, join as join34 } from "pathe";
+import { basename as basename6, join as join35 } from "pathe";
 
 // src/migrate/fumadocs/meta.ts
 var SEPARATOR = /^---(?<label>.*)---$/u;
@@ -12765,16 +13152,16 @@ var isDirectory = (path) => {
   }
 };
 var resolveEntry = (docsDir, name) => {
-  if (!isInsideRoot2(docsDir, join34(docsDir, name))) {
+  if (!isInsideRoot2(docsDir, join35(docsDir, name))) {
     return null;
   }
   for (const ext of PAGE_EXTS) {
-    const file = join34(docsDir, `${name}${ext}`);
+    const file = join35(docsDir, `${name}${ext}`);
     if (existsSync23(file)) {
       return { kind: "file", path: file };
     }
   }
-  const folder = join34(docsDir, name);
+  const folder = join35(docsDir, name);
   return isDirectory(folder) ? { kind: "folder", path: folder } : null;
 };
 var humanize2 = (name) => name.split(WORD_SPLIT3).filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
@@ -12809,7 +13196,7 @@ var moveItemIntoGroup = async (item, docsDir, groupDir, label, warnings) => {
     warnings.push(`Sidebar entry "${item.name}" in section "${label}" matched no page or folder; skipped.`);
     return null;
   }
-  const dest = join34(groupDir, basename6(resolved.path));
+  const dest = join35(groupDir, basename6(resolved.path));
   if (existsSync23(dest)) {
     warnings.push(`Skipped moving "${item.name}" into section "${label}" (target already exists).`);
     return null;
@@ -12837,7 +13224,7 @@ var reshapeSection = async (section, docsDir, order, warnings) => {
     }
     return;
   }
-  const groupDir = join34(docsDir, `(${section.label})`);
+  const groupDir = join35(docsDir, `(${section.label})`);
   const sectionKeys = [];
   for (const item of section.items) {
     const key = await moveItemIntoGroup(item, docsDir, groupDir, section.label, warnings);
@@ -12850,7 +13237,7 @@ var reshapeSection = async (section, docsDir, order, warnings) => {
   }
   order.push(section.label);
   if (sectionKeys.length > 1) {
-    await writeFile11(join34(groupDir, "meta.ts"), renderMetaModule({ pages: sectionKeys }), "utf-8");
+    await writeFile11(join35(groupDir, "meta.ts"), renderMetaModule({ pages: sectionKeys }), "utf-8");
   }
 };
 var reshapeFumadocsGroups = async (structure, docsDir) => {
@@ -12883,7 +13270,7 @@ var FUMADOCS_LEFTOVERS = [
 ];
 var movePage = async (abs, base, root) => {
   const rel = relative19(base, abs);
-  const dest = join35(root, "docs", rel);
+  const dest = join36(root, "docs", rel);
   if (existsSync24(dest)) {
     return {
       includeWarnings: [],
@@ -12893,7 +13280,7 @@ var movePage = async (abs, base, root) => {
       unsupported: []
     };
   }
-  const raw = await readFile18(abs, "utf-8");
+  const raw = await readFile19(abs, "utf-8");
   const included = await inlineFumadocsIncludes(raw, {
     filePath: abs,
     root: base
@@ -12930,12 +13317,12 @@ var writeMeta = async (dest, meta, rel, warnings) => {
 };
 var convertMeta = async (abs, base, root) => {
   const rel = relative19(base, abs);
-  const raw = await readFile18(abs, "utf-8");
+  const raw = await readFile19(abs, "utf-8");
   let parsed;
   try {
     parsed = JSON.parse(raw);
   } catch {
-    const dest2 = join35(root, "docs", rel);
+    const dest2 = join36(root, "docs", rel);
     if (existsSync24(dest2)) {
       return [`Skipped ${rel} (target already exists)`];
     }
@@ -12946,8 +13333,8 @@ var convertMeta = async (abs, base, root) => {
     ];
   }
   const dir = dirname16(rel) === "." ? "" : dirname16(rel);
-  const docsDir = join35(root, "docs", dir);
-  const dest = join35(docsDir, "meta.ts");
+  const docsDir = join36(root, "docs", dir);
+  const dest = join36(docsDir, "meta.ts");
   const structure = parseFumadocsPages(parsed.pages);
   if (structure.hasSections && !existsSync24(dest)) {
     const self = translateFumadocsSelfMeta(parsed);
@@ -12996,7 +13383,7 @@ var summarizePages = (results) => {
   };
 };
 var cleanupSourceDirs = async (root) => {
-  const docs = join35(root, "content", "docs");
+  const docs = join36(root, "content", "docs");
   if (existsSync24(docs)) {
     const remaining = await glob8(["**/*"], { cwd: docs, dot: true });
     if (remaining.length > 0) {
@@ -13006,7 +13393,7 @@ var cleanupSourceDirs = async (root) => {
     }
     await rm3(docs, { force: true, recursive: true });
   }
-  const content = join35(root, "content");
+  const content = join36(root, "content");
   if (existsSync24(content)) {
     const remaining = await glob8(["**/*"], { cwd: content, dot: true });
     if (remaining.length === 0) {
@@ -13017,7 +13404,7 @@ var cleanupSourceDirs = async (root) => {
 };
 var migrateFumadocsProject = async (root) => {
   const { config, warnings: configWarnings } = await loadFumadocsConfig(root);
-  const base = join35(root, SOURCE_DIR);
+  const base = join36(root, SOURCE_DIR);
   if (!existsSync24(base)) {
     await writeBlumeConfig(root, config);
     return {
@@ -13077,9 +13464,32 @@ var migrateFumadocsProject = async (root) => {
 
 // src/migrate/mintlify/index.ts
 import { existsSync as existsSync25 } from "node:fs";
-import { mkdir as mkdir9, readFile as readFile19, rename as rename4, rm as rm4, stat as stat2, writeFile as writeFile13 } from "node:fs/promises";
-import { dirname as dirname17, join as join36 } from "pathe";
+import { mkdir as mkdir9, readFile as readFile20, rename as rename4, rm as rm4, stat as stat2, writeFile as writeFile13 } from "node:fs/promises";
+import { dirname as dirname17, join as join37 } from "pathe";
 import { glob as glob9 } from "tinyglobby";
+var asRecord = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+var hasFontFamily = (value) => {
+  const object = asRecord(value);
+  if (!object) {
+    return false;
+  }
+  const named = (child) => typeof asRecord(child)?.family === "string";
+  return typeof object.family === "string" || named(object.heading) || named(object.body);
+};
+var droppedChromeWarnings = (spec, config) => {
+  const warnings = [];
+  const navbar = asRecord(spec.navbar);
+  if (navbar && (navbar.links || navbar.primary)) {
+    warnings.push("Header links (navbar.links/navbar.primary) have no blume.config equivalent and were dropped; re-add them with navigation.tabs or a Header layout override.");
+  }
+  if (asRecord(spec.footer)?.socials) {
+    warnings.push("Footer social links (footer.socials) have no blume.config equivalent and were dropped; add them with a Footer layout override.");
+  }
+  if (hasFontFamily(spec.fonts ?? spec.font) && !config.theme?.fonts) {
+    warnings.push("docs.json font family isn't in Blume's curated Google Fonts set; set theme.fonts to a supported slug or add @font-face rules in theme.css.");
+  }
+  return warnings;
+};
 var prune = (value) => {
   if (Array.isArray(value)) {
     return value.map(prune);
@@ -13108,13 +13518,13 @@ var writeBlumeConfig2 = async (root, config) => {
 
 export default defineConfig(${JSON.stringify(prune(config), null, 2)});
 `;
-  await writeFile13(join36(root, "blume.config.ts"), body, "utf-8");
+  await writeFile13(join37(root, "blume.config.ts"), body, "utf-8");
 };
 var relocateAssets = async (root, segments) => {
   const served = [];
   const moved = [];
   for (const segment of segments) {
-    const source = join36(root, segment);
+    const source = join37(root, segment);
     if (!existsSync25(source) || segment === "public") {
       continue;
     }
@@ -13123,11 +13533,11 @@ var relocateAssets = async (root, segments) => {
       served.push(segment);
       continue;
     }
-    const dest = join36(root, "public", segment);
+    const dest = join37(root, "public", segment);
     if (existsSync25(dest)) {
       continue;
     }
-    await mkdir9(join36(root, "public"), { recursive: true });
+    await mkdir9(join37(root, "public"), { recursive: true });
     await rename4(source, dest);
     moved.push(segment);
   }
@@ -13148,7 +13558,7 @@ var applyRelocatedAssets = (config, assets, warnings) => {
   }
 };
 var cleanupSnippets = async (root, kept, warnings) => {
-  const dir = join36(root, "snippets");
+  const dir = join37(root, "snippets");
   if (!existsSync25(dir)) {
     return;
   }
@@ -13169,11 +13579,11 @@ var cleanupSnippets = async (root, kept, warnings) => {
 };
 var migrateMintlifyProject = async (root) => {
   const warnings = [];
-  const configFile = existsSync25(join36(root, "docs.json")) ? join36(root, "docs.json") : join36(root, "mint.json");
+  const configFile = existsSync25(join37(root, "docs.json")) ? join37(root, "docs.json") : join37(root, "mint.json");
   let config;
   if (existsSync25(configFile)) {
     config = await loadMintlifyConfig(root, configFile);
-    const spec = JSON.parse(await readFile19(configFile, "utf-8"));
+    const spec = JSON.parse(await readFile20(configFile, "utf-8"));
     const i18n = mintlifyI18n(spec);
     if (i18n) {
       config.i18n = i18n;
@@ -13182,6 +13592,11 @@ var migrateMintlifyProject = async (root) => {
       }
       warnings.push(`Mapped ${i18n.locales.length} languages to i18n.locales (default: ${i18n.defaultLocale}); review the locale labels.`);
     }
+    const openapiSources = config.openapi?.sources ?? [];
+    if (openapiSources.length > 0) {
+      warnings.push(`Mapped ${openapiSources.length} OpenAPI spec source(s) to openapi.sources (native reference renderer); verify each spec path or URL resolves.`);
+    }
+    warnings.push(...droppedChromeWarnings(spec, config));
   } else {
     warnings.push("No docs.json or mint.json found; writing a default config.");
     config = { content: { root: "." }, title: "Documentation" };
@@ -13204,7 +13619,7 @@ var migrateMintlifyProject = async (root) => {
   const unsupported = new Set;
   const keptComponents = new Set;
   for (const file of files) {
-    const raw = await readFile19(file, "utf-8");
+    const raw = await readFile20(file, "utf-8");
     const result = await transformMintlifyContent(raw, {
       filePath: file,
       root,
@@ -13239,7 +13654,7 @@ var migrateMintlifyProject = async (root) => {
     warnings.push(`Dropped unsupported page frontmatter keys: ${[...removedKeys].join(", ")}.`);
   }
   if (unsupported.size > 0) {
-    warnings.push(`Components without a Blume equivalent need manual review (use the OpenAPI reference instead): ${[...unsupported].join(", ")}.`);
+    warnings.push(`Components without a Blume equivalent need manual review: ${[...unsupported].join(", ")}.`);
   }
   warnings.push("Review blume.config.ts; navigation, theme, and chrome were mapped from docs.json.");
   return { moved, warnings };
@@ -13247,8 +13662,8 @@ var migrateMintlifyProject = async (root) => {
 
 // src/migrate/nextra/index.ts
 import { existsSync as existsSync26 } from "node:fs";
-import { mkdir as mkdir10, readFile as readFile20, rename as rename5, rm as rm5, writeFile as writeFile14 } from "node:fs/promises";
-import { basename as basename7, dirname as dirname18, extname as extname8, join as join37, relative as relative20 } from "pathe";
+import { mkdir as mkdir10, readFile as readFile21, rename as rename5, rm as rm5, writeFile as writeFile14 } from "node:fs/promises";
+import { basename as basename7, dirname as dirname18, extname as extname8, join as join38, relative as relative20 } from "pathe";
 import { glob as glob10 } from "tinyglobby";
 
 // src/migrate/nextra/content.ts
@@ -13530,7 +13945,7 @@ var planMetas = (metas, index) => {
     plan.metaByDir.set(dir, conversion.folderMeta);
     plan.consumedMetas.push(meta.abs);
     for (const [slug, title] of Object.entries(conversion.folderTitles)) {
-      plan.folderTitleByDir.set(normalizeDir(join37(dir, slug)), title);
+      plan.folderTitleByDir.set(normalizeDir(join38(dir, slug)), title);
     }
     for (const [slug, label] of Object.entries(conversion.pageLabels)) {
       const pageAbs = index.pagesByDir.get(dir)?.get(slug);
@@ -13555,11 +13970,11 @@ var planMetas = (metas, index) => {
 };
 var movePage2 = async (abs, options) => {
   const rel = relative20(options.base, abs);
-  const dest = join37(options.root, "docs", rel);
+  const dest = join38(options.root, "docs", rel);
   if (existsSync26(dest)) {
     return { moved: 0, removed: [], skipped: rel, unsupported: [] };
   }
-  const raw = await readFile20(abs, "utf-8");
+  const raw = await readFile21(abs, "utf-8");
   const text = rewriteNextraCallouts(stripNextraImports(raw));
   const unsupported = unsupportedNextraComponents(text);
   const parsed = frontmatter_default(text);
@@ -13608,7 +14023,7 @@ var writeFolderMetas = async (root, plan) => {
     if (Object.keys(finalMeta).length === 0) {
       return;
     }
-    const dest = join37(root, "docs", dir, "meta.ts");
+    const dest = join38(root, "docs", dir, "meta.ts");
     await mkdir10(dirname18(dest), { recursive: true });
     await writeFile14(dest, `import { defineMeta } from "blume";
 
@@ -13619,7 +14034,7 @@ export default defineMeta(${JSON.stringify(finalMeta, null, 2)});
 var relocateUnparseableMetas = async (root, metas) => {
   const warnings = [];
   await Promise.all(metas.map(async ({ abs, rel }) => {
-    const dest = join37(root, "docs", rel);
+    const dest = join38(root, "docs", rel);
     if (existsSync26(dest)) {
       warnings.push(`Skipped ${rel} (target already exists)`);
       return;
@@ -13632,7 +14047,7 @@ var relocateUnparseableMetas = async (root, metas) => {
 };
 var buildConfig = (tabs) => tabs.length > 0 ? { navigation: { tabs }, title: "Documentation" } : { title: "Documentation" };
 var migrateNextraProject = async (root) => {
-  const sourceDir = SOURCE_DIRS.find((dir) => existsSync26(join37(root, dir)));
+  const sourceDir = SOURCE_DIRS.find((dir) => existsSync26(join38(root, dir)));
   if (!sourceDir) {
     await writeBlumeConfig(root, { title: "Documentation" });
     return {
@@ -13642,7 +14057,7 @@ var migrateNextraProject = async (root) => {
       ]
     };
   }
-  const base = join37(root, sourceDir);
+  const base = join38(root, sourceDir);
   const pageFiles = await glob10([PAGE_GLOB2], {
     absolute: true,
     cwd: base,
@@ -13657,7 +14072,7 @@ var migrateNextraProject = async (root) => {
   const metas = await Promise.all(metaFiles.map(async (abs) => ({
     abs,
     ext: extname8(abs),
-    raw: await readFile20(abs, "utf-8"),
+    raw: await readFile21(abs, "utf-8"),
     rel: relative20(base, abs)
   })));
   const plan = planMetas(metas, index);
@@ -13684,14 +14099,14 @@ var migrateNextraProject = async (root) => {
 
 // src/migrate/starlight/index.ts
 import { existsSync as existsSync28 } from "node:fs";
-import { readFile as readFile22, writeFile as writeFile15 } from "node:fs/promises";
-import { join as join39 } from "pathe";
+import { readFile as readFile23, writeFile as writeFile15 } from "node:fs/promises";
+import { join as join40 } from "pathe";
 import { glob as glob11 } from "tinyglobby";
 
 // src/migrate/starlight/config.ts
 import { existsSync as existsSync27 } from "node:fs";
-import { readFile as readFile21 } from "node:fs/promises";
-import { join as join38 } from "pathe";
+import { readFile as readFile22 } from "node:fs/promises";
+import { join as join39 } from "pathe";
 var CONFIG_FILES = [
   "astro.config.mjs",
   "astro.config.mts",
@@ -13722,7 +14137,7 @@ var extractStarlightOptions = (source) => {
   return isLiteralObject(parsed) ? parsed : "unparseable";
 };
 var loadStarlightConfig = async (root) => {
-  const file = CONFIG_FILES.map((name) => join38(root, name)).find((path) => existsSync27(path));
+  const file = CONFIG_FILES.map((name) => join39(root, name)).find((path) => existsSync27(path));
   if (!file) {
     return {
       options: {},
@@ -13731,7 +14146,7 @@ var loadStarlightConfig = async (root) => {
       ]
     };
   }
-  const source = await readFile21(file, "utf-8");
+  const source = await readFile22(file, "utf-8");
   const result = extractStarlightOptions(source);
   if (result === "missing") {
     return {
@@ -14129,7 +14544,7 @@ var starlightI18n = (options) => {
 // src/migrate/starlight/index.ts
 var CONTENT_DIR = "src/content/docs";
 var transformPage = async (file) => {
-  const raw = await readFile22(file, "utf-8");
+  const raw = await readFile23(file, "utf-8");
   let text = stripStarlightImports(raw);
   text = rewriteStarlightAsides(text);
   text = rewriteStarlightComponents(text);
@@ -14151,7 +14566,7 @@ var migrateStarlightProject = async (root) => {
     config.i18n = i18n;
     warnings.push(`Mapped ${i18n.locales.length} locale(s) to i18n (default: ${i18n.defaultLocale}); review the locale labels.`);
   }
-  const base = join39(root, CONTENT_DIR);
+  const base = join40(root, CONTENT_DIR);
   if (!existsSync28(base)) {
     await writeBlumeConfig(root, config);
     return {
@@ -14243,7 +14658,7 @@ var migrateCommand = defineCommand8({
 import { existsSync as existsSync29 } from "node:fs";
 import { preview } from "astro";
 import { defineCommand as defineCommand9 } from "citty";
-import { join as join40 } from "pathe";
+import { join as join41 } from "pathe";
 var previewCommand = defineCommand9({
   args: {
     host: { description: "Network host to bind.", type: "string" },
@@ -14257,7 +14672,7 @@ var previewCommand = defineCommand9({
     const root = process.cwd();
     const { config } = await loadConfig(root);
     const context = resolveProjectContext(root, config);
-    if (!existsSync29(join40(context.outDir, "astro.config.mjs"))) {
+    if (!existsSync29(join41(context.outDir, "astro.config.mjs"))) {
       logger.error("No build found. Run `blume build` first.");
       process.exit(1);
     }
@@ -14275,7 +14690,7 @@ var previewCommand = defineCommand9({
 // src/cli/commands/sync.ts
 import { rm as rm6 } from "node:fs/promises";
 import { defineCommand as defineCommand10 } from "citty";
-import { join as join41 } from "pathe";
+import { join as join42 } from "pathe";
 var syncCommand = defineCommand10({
   args: {
     force: {
@@ -14297,7 +14712,7 @@ var syncCommand = defineCommand10({
     if (args.force) {
       const { config } = await loadConfig(root);
       const context = resolveProjectContext(root, config);
-      await rm6(join41(context.outDir, "cache"), { force: true, recursive: true });
+      await rm6(join42(context.outDir, "cache"), { force: true, recursive: true });
       logger.info("Cleared source cache.");
     }
     await prepareProject({
@@ -14314,11 +14729,11 @@ var syncCommand = defineCommand10({
 // src/cli/commands/validate.ts
 import { existsSync as existsSync31 } from "node:fs";
 import { defineCommand as defineCommand11 } from "citty";
-import { join as join43 } from "pathe";
+import { join as join44 } from "pathe";
 
 // src/core/links.ts
 import { existsSync as existsSync30 } from "node:fs";
-import { basename as basename8, join as join42 } from "pathe";
+import { basename as basename8, join as join43 } from "pathe";
 var HTTP = /^https?:\/\//iu;
 var PROTOCOL_RELATIVE = /^\/\//u;
 var SCHEME = /^[a-z][a-z0-9+.-]*:/iu;
@@ -14331,10 +14746,10 @@ var STATUS_GONE = 410;
 var STATUS_METHOD_NOT_ALLOWED = 405;
 var STATUS_NOT_IMPLEMENTED = 501;
 var assetIsPresent = (resolved, ctx) => {
-  if (ctx.publicDir && existsSync30(join42(ctx.publicDir, resolved))) {
+  if (ctx.publicDir && existsSync30(join43(ctx.publicDir, resolved))) {
     return true;
   }
-  return ctx.assetMounts.some((mount) => (resolved === mount.url || resolved.startsWith(`${mount.url}/`)) && existsSync30(join42(mount.dir, resolved.slice(mount.url.length))));
+  return ctx.assetMounts.some((mount) => (resolved === mount.url || resolved.startsWith(`${mount.url}/`)) && existsSync30(join43(mount.dir, resolved.slice(mount.url.length))));
 };
 var isIndexPage = (page2) => {
   const ref = page2.source?.ref ?? page2.sourcePath ?? "";
@@ -14579,7 +14994,7 @@ var validateCommand = defineCommand11({
     try {
       const project = await scanProject(root, { mode: "build" });
       diagnostics.push(...project.diagnostics);
-      const publicDir = join43(root, "public");
+      const publicDir = join44(root, "public");
       diagnostics.push(...await validateLinks(project.graph, {
         assetMounts: resolveAssetMounts(root, project.config.content.assets),
         checkExternal: Boolean(args.external),
@@ -14644,5 +15059,5 @@ process.on("unhandledRejection", (error) => {
 });
 runMain(main);
 
-//# debugId=114B8B7438537BD664756E2164756E21
+//# debugId=432F59E1AFBFB0A064756E2164756E21
 //# sourceMappingURL=index.js.map