blume 0.5.4 → 0.6.1

package/dist/cli/index.js

@@ -513,11 +513,155 @@ Next steps:
 });
 
 // src/cli/commands/build.ts
-import { existsSync as existsSync14 } from "node:fs";
+import { existsSync as existsSync15 } 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 join23 } from "pathe";
+import { join as join24 } from "pathe";
+
+// src/deploy/xml.ts
+var escapeXml = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&apos;");
+
+// src/deploy/rss.ts
+var capitalize = (value) => value.charAt(0).toUpperCase() + value.slice(1);
+var pageDate = (page) => {
+  const raw = page.meta.date ?? page.meta.changelog?.date;
+  if (!raw) {
+    return;
+  }
+  const date = new Date(raw);
+  return Number.isNaN(date.getTime()) ? undefined : date;
+};
+var buildRssFeeds = (project) => {
+  const { config } = project;
+  const { rss } = config.seo;
+  const { site } = config.deployment;
+  if (!(rss.enabled && site)) {
+    return [];
+  }
+  const base = site.replace(/\/$/u, "");
+  const feeds = [];
+  for (const type of rss.types) {
+    const pages = project.graph.pages.filter((page) => page.contentType === type && !(page.meta.draft || page.meta.sidebar.hidden));
+    if (pages.length === 0) {
+      continue;
+    }
+    const items = pages.map((page) => ({
+      date: pageDate(page),
+      description: page.description,
+      link: `${base}${page.route}`,
+      title: page.title
+    })).toSorted((a, b) => (b.date?.getTime() ?? 0) - (a.date?.getTime() ?? 0)).slice(0, rss.limit);
+    feeds.push({
+      description: config.description,
+      items,
+      link: base,
+      path: `/${type}/rss.xml`,
+      title: `${config.title} — ${capitalize(type)}`,
+      type
+    });
+  }
+  return feeds;
+};
+var renderItem = (item) => {
+  const parts = [
+    `    <title>${escapeXml(item.title)}</title>`,
+    `    <link>${escapeXml(item.link)}</link>`,
+    `    <guid isPermaLink="true">${escapeXml(item.link)}</guid>`
+  ];
+  if (item.description) {
+    parts.push(`    <description>${escapeXml(item.description)}</description>`);
+  }
+  if (item.date) {
+    parts.push(`    <pubDate>${item.date.toUTCString()}</pubDate>`);
+  }
+  return `  <item>
+${parts.join(`
+`)}
+  </item>`;
+};
+var renderRssFeed = (feed) => {
+  const channel = [
+    `  <title>${escapeXml(feed.title)}</title>`,
+    `  <link>${escapeXml(feed.link)}</link>`,
+    `  <description>${escapeXml(feed.description ?? feed.title)}</description>`,
+    `  <atom:link href="${escapeXml(`${feed.link}${feed.path}`)}" rel="self" type="application/rss+xml" />`
+  ];
+  const items = feed.items.map(renderItem).join(`
+`);
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+<channel>
+${channel.join(`
+`)}
+${items}
+</channel>
+</rss>
+`;
+};
+
+// src/ai/agent-readability.ts
+var USAGE_TOKENS = [
+  ["search", "search"],
+  ["aiInput", "ai-input"],
+  ["aiTrain", "ai-train"]
+];
+var usagePolicy = (signals) => {
+  if (!signals) {
+    return null;
+  }
+  return Object.fromEntries(USAGE_TOKENS.map(([key, token]) => [token, signals[key]]));
+};
+var buildAgentReadability = (project) => {
+  const { config } = project;
+  if (!config.seo.agentReadability) {
+    return null;
+  }
+  const site = config.deployment.site ?? null;
+  const abs = (path) => site ? `${site.replace(/\/+$/u, "")}${path}` : path;
+  const artifacts = {
+    markdown: {
+      contentNegotiation: "text/markdown",
+      pattern: abs("/{route}.md")
+    }
+  };
+  if (config.ai.llmsTxt) {
+    artifacts.llmsFullTxt = abs("/llms-full.txt");
+    artifacts.llmsTxt = abs("/llms.txt");
+  }
+  if (config.mcp.enabled) {
+    artifacts.mcp = {
+      discovery: abs("/.well-known/mcp.json"),
+      url: abs(config.mcp.route)
+    };
+  }
+  if (config.ai.ask?.enabled) {
+    artifacts.askApi = abs("/api/ask");
+  }
+  if (site && config.seo.sitemap) {
+    artifacts.sitemap = abs("/sitemap.xml");
+  }
+  const feeds = site && config.seo.rss.enabled ? buildRssFeeds(project).map((feed) => abs(feed.path)) : [];
+  if (feeds.length > 0) {
+    artifacts.feeds = feeds;
+  }
+  const version = project.manifest?.blumeVersion;
+  const manifest = {
+    artifacts,
+    description: config.description,
+    generator: version ? `blume@${version}` : undefined,
+    name: config.mcp.name ?? config.title,
+    site
+  };
+  const usage = usagePolicy(config.seo.contentSignals);
+  if (usage) {
+    manifest.contentUsage = usage;
+  }
+  if (config.github) {
+    manifest.repository = `https://github.com/${config.github.owner}/${config.github.repo}`;
+  }
+  return manifest;
+};
 
 // src/core/frontmatter.ts
 import baseMatter from "gray-matter";
@@ -700,6 +844,42 @@ var serverFeatures = (config) => {
   return features;
 };
 
+// src/deploy/adapter-output.ts
+import { existsSync as existsSync4 } from "node:fs";
+import { cp, mkdir as mkdir2, rm } from "node:fs/promises";
+import { dirname as dirname4, join as join6 } from "pathe";
+var ADAPTER_OUTPUT_PATHS = {
+  netlify: ".netlify",
+  vercel: ".vercel/output"
+};
+var deployStaticDir = (config, context) => {
+  const { adapter, output } = config.deployment;
+  if (output === "server" && adapter === "vercel") {
+    return join6(context.root, ".vercel", "output", "static");
+  }
+  return context.distDir ?? join6(context.root, "dist");
+};
+var surfaceAdapterOutput = async (config, context) => {
+  const { adapter, output } = config.deployment;
+  if (output !== "server" || !adapter) {
+    return { moved: false };
+  }
+  const rel = ADAPTER_OUTPUT_PATHS[adapter];
+  if (!rel) {
+    return { moved: false };
+  }
+  const from = join6(context.outDir, rel);
+  const to = join6(context.root, rel);
+  if (!existsSync4(from)) {
+    return { moved: false };
+  }
+  await mkdir2(dirname4(to), { recursive: true });
+  await rm(to, { force: true, recursive: true });
+  await cp(from, to, { recursive: true });
+  await rm(from, { force: true, recursive: true });
+  return { from, ignore: `${rel.split("/")[0]}/`, moved: true, to };
+};
+
 // src/deploy/redirects.ts
 var buildNetlifyRedirects = (redirects) => `${redirects.map((redirect) => `${redirect.from} ${redirect.to} ${redirect.status}`).join(`
 `)}
@@ -720,12 +900,29 @@ var buildRedirectManifest = (redirects) => `${JSON.stringify(redirects.map((redi
 `;
 
 // src/deploy/robots.ts
+var SIGNAL_TOKENS = [
+  ["search", "search"],
+  ["aiInput", "ai-input"],
+  ["aiTrain", "ai-train"]
+];
+var contentSignalLine = (signals) => {
+  if (!signals) {
+    return null;
+  }
+  const tokens = SIGNAL_TOKENS.map(([key, token]) => `${token}=${signals[key] ? "yes" : "no"}`);
+  return `Content-Signal: ${tokens.join(", ")}`;
+};
 var buildRobots = (project) => {
   const { config } = project;
   if (!config.seo.robots) {
     return null;
   }
-  const lines = ["User-agent: *", "Allow: /"];
+  const lines = ["User-agent: *"];
+  const signal = contentSignalLine(config.seo.contentSignals);
+  if (signal) {
+    lines.push(signal);
+  }
+  lines.push("Allow: /");
   const { site } = config.deployment;
   if (site && config.seo.sitemap) {
     lines.push("", `Sitemap: ${site.replace(/\/$/u, "")}/sitemap.xml`);
@@ -735,9 +932,6 @@ var buildRobots = (project) => {
 `;
 };
 
-// src/deploy/xml.ts
-var escapeXml = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&apos;");
-
 // src/deploy/sitemap.ts
 var lastmodTag = (value) => {
   if (!value) {
@@ -762,7 +956,7 @@ ${urls.join(`
 };
 
 // src/search/build.ts
-import { join as join6 } from "pathe";
+import { join as join7 } from "pathe";
 var buildSearchIndex = async (outDir) => {
   const pagefind = await import("pagefind");
   const { index } = await pagefind.createIndex({});
@@ -770,7 +964,7 @@ var buildSearchIndex = async (outDir) => {
     throw new Error("Failed to create Pagefind index.");
   }
   const result = await index.addDirectory({ path: outDir });
-  await index.writeFiles({ outputPath: join6(outDir, "pagefind") });
+  await index.writeFiles({ outputPath: join7(outDir, "pagefind") });
   await pagefind.close();
   return result.page_count;
 };
@@ -2676,7 +2870,8 @@ var buildSearchDocuments = async (project, options) => {
   return await Promise.all(indexable.map(async (route) => {
     const page = pageById.get(route.id);
     const raw = page ? await readEntryText(project, page) : "";
-    const body = raw ? toPlainText(frontmatter_default(raw).content) : "";
+    const source = raw ? frontmatter_default(raw).content : "";
+    const body = options?.content === "markdown" ? source.trim() : toPlainText(source);
     const tags = page?.meta?.search?.tags;
     const crumb = crumbs.get(route.path);
     return {
@@ -2817,17 +3012,17 @@ var syncSearchProvider = async (project, reporter) => {
 
 // src/cli/dev-lock.ts
 import {
-  existsSync as existsSync5,
+  existsSync as existsSync6,
   mkdirSync,
   readFileSync as readFileSync2,
   rmSync,
   writeFileSync
 } from "node:fs";
-import { join as join8 } from "pathe";
+import { join as join9 } from "pathe";
 
 // src/core/project.ts
-import { existsSync as existsSync4 } from "node:fs";
-import { isAbsolute, join as join7, resolve as resolve2 } from "pathe";
+import { existsSync as existsSync5 } from "node:fs";
+import { isAbsolute, join as join8, resolve as resolve2 } from "pathe";
 var CONFIG_FILENAMES = [
   "blume.config.ts",
   "blume.config.mjs",
@@ -2837,22 +3032,22 @@ 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)) {
+    const candidate = join8(root, name);
+    if (existsSync5(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 resolveRuntimeDir = (root, runtimeDir = ".blume") => isAbsolute(runtimeDir) ? runtimeDir : join8(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 contentRoot = isAbsolute(config.content.root) ? config.content.root : join8(absoluteRoot, config.content.root);
+  const pagesPath = join8(absoluteRoot, config.content.pages);
+  const pagesRoot = existsSync5(pagesPath) ? pagesPath : null;
   const outDir = resolveRuntimeDir(absoluteRoot, options?.runtimeDir);
-  const distDir = options?.runtimeDir ? join7(outDir, "dist") : join7(absoluteRoot, "dist");
+  const distDir = options?.runtimeDir ? join8(outDir, "dist") : join8(absoluteRoot, "dist");
   return {
     componentsFile: firstExisting(absoluteRoot, COMPONENTS_FILENAMES),
     configFile: findConfigFile(absoluteRoot),
@@ -2866,16 +3061,27 @@ var resolveProjectContext = (root, config, options) => {
 };
 
 // src/cli/dev-lock.ts
-var lockPath = (outDir) => join8(outDir, "dev.lock");
-var isDevLocked = (outDir) => {
-  const path = lockPath(outDir);
-  if (!existsSync5(path)) {
-    return false;
+var lockPath = (outDir) => join9(outDir, "dev.lock");
+var isValidPid = (pid) => typeof pid === "number" && Number.isInteger(pid) && pid > 0;
+var parseLock = (raw) => {
+  let data;
+  try {
+    data = JSON.parse(raw.trim());
+  } catch {
+    return null;
   }
-  const pid = Number.parseInt(readFileSync2(path, "utf-8").trim(), 10);
-  if (!(Number.isInteger(pid) && pid > 0)) {
-    return false;
+  if (isValidPid(data)) {
+    return { pid: data };
   }
+  if (typeof data === "object" && data !== null) {
+    const { pid, port } = data;
+    if (isValidPid(pid)) {
+      return typeof port === "number" ? { pid, port } : { pid };
+    }
+  }
+  return null;
+};
+var isProcessAlive = (pid) => {
   try {
     process.kill(pid, 0);
     return true;
@@ -2883,10 +3089,34 @@ var isDevLocked = (outDir) => {
     return error.code === "EPERM";
   }
 };
-var acquireDevLock = (outDir) => {
+var readDevLock = (outDir) => {
+  const path = lockPath(outDir);
+  if (!existsSync6(path)) {
+    return null;
+  }
+  const lock = parseLock(readFileSync2(path, "utf-8"));
+  return lock && isProcessAlive(lock.pid) ? lock : null;
+};
+var writeLock = (outDir, port) => {
+  writeFileSync(lockPath(outDir), JSON.stringify({
+    pid: process.pid,
+    ...port === undefined ? {} : { port }
+  }));
+};
+var ownsLock = (outDir) => {
   const path = lockPath(outDir);
+  if (!existsSync6(path)) {
+    return false;
+  }
+  try {
+    return parseLock(readFileSync2(path, "utf-8"))?.pid === process.pid;
+  } catch {
+    return false;
+  }
+};
+var acquireDevLock = (outDir, port) => {
   mkdirSync(outDir, { recursive: true });
-  writeFileSync(path, String(process.pid));
+  writeLock(outDir, port);
   let released = false;
   return () => {
     if (released) {
@@ -2894,38 +3124,46 @@ var acquireDevLock = (outDir) => {
     }
     released = true;
     try {
-      if (existsSync5(path) && readFileSync2(path, "utf-8").trim() === String(process.pid)) {
-        rmSync(path, { force: true });
+      if (ownsLock(outDir)) {
+        rmSync(lockPath(outDir), { force: true });
       }
     } catch {}
   };
 };
+var updateDevLockPort = (outDir, port) => {
+  if (ownsLock(outDir)) {
+    writeLock(outDir, port);
+  }
+};
+var describeDevLock = (lock) => lock.port === undefined ? "" : ` at http://localhost:${lock.port}`;
 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.`);
+  const lock = readDevLock(resolveRuntimeDir(root, runtimeDir));
+  if (lock) {
+    logger.error(`A \`blume dev\` server is running${describeDevLock(lock)}; ${action} would corrupt its .blume runtime. Reuse that server, stop it first, or re-run with --isolated to build/verify against .blume-verify without touching it.`);
     process.exit(1);
   }
 };
 
 // src/astro/generate.ts
-import { existsSync as existsSync9, readFileSync as readFileSync6, realpathSync } from "node:fs";
+import { existsSync as existsSync10, readFileSync as readFileSync6, realpathSync } from "node:fs";
 import {
   lstat,
-  mkdir as mkdir4,
+  mkdir as mkdir5,
   readFile as readFile10,
   rename,
-  rm,
+  rm as rm2,
   symlink,
   writeFile as writeFile5
 } from "node:fs/promises";
 import { createRequire as createRequire5 } from "node:module";
 import { pathToFileURL as pathToFileURL2 } from "node:url";
-import { basename as basename2, dirname as dirname7, join as join16, normalize as normalize3, relative as relative7 } from "pathe";
+import { basename as basename2, dirname as dirname8, join as join17, normalize as normalize3, relative as relative7 } from "pathe";
 import { glob as glob4 } from "tinyglobby";
 
 // src/ai/ask-data.ts
 var buildAskData = async (project) => {
   const documents = await buildSearchDocuments(project, {
+    content: "markdown",
     includeWhenDisabled: true
   });
   return {
@@ -3158,8 +3396,8 @@ var validateUsedComponents = (pages, extraTags, registryNames) => {
 };
 
 // src/core/component-overrides.ts
-import { existsSync as existsSync6 } from "node:fs";
-import { dirname as dirname4, extname, isAbsolute as isAbsolute2, resolve as resolve3 } from "pathe";
+import { existsSync as existsSync7 } from "node:fs";
+import { dirname as dirname5, extname, isAbsolute as isAbsolute2, resolve as resolve3 } from "pathe";
 import ts from "typescript";
 var GROUPS = ["mdx", "layout", "islands"];
 var FRAMEWORK_BY_EXT = {
@@ -3247,7 +3485,7 @@ var findDefaultExportObject = (sourceFile) => {
 var probeExtension = (base) => {
   for (const extension of COMPONENT_EXTS) {
     const candidate = `${base}.${extension}`;
-    if (existsSync6(candidate)) {
+    if (existsSync7(candidate)) {
       return candidate;
     }
   }
@@ -3394,7 +3632,7 @@ var analyzeComponentOverrides = (source, filePath) => {
     return result;
   }
   const imports = collectImports(sourceFile);
-  const dir = dirname4(filePath);
+  const dir = dirname5(filePath);
   for (const property of object.properties) {
     if (!ts.isPropertyAssignment(property)) {
       continue;
@@ -3424,6 +3662,7 @@ var uiStringsObject = z.object({
     connectMcp: z.string().default("Connect to MCP"),
     copied: z.string().default("Copied!"),
     copyClaudeCode: z.string().default("Copy Claude Code command"),
+    copyCodex: z.string().default("Copy Codex command"),
     copyMarkdown: z.string().default("Copy as Markdown"),
     copyServerUrl: z.string().default("Copy server URL"),
     edit: z.string().default("Edit on GitHub"),
@@ -3431,11 +3670,15 @@ var uiStringsObject = z.object({
     scrollToTop: z.string().default("Scroll to top")
   }).default({}),
   ask: z.object({
+    clear: z.string().default("Clear conversation"),
+    close: z.string().default("Close"),
+    copy: z.string().default("Copy conversation"),
     empty: z.string().default("Ask a question about the docs."),
     error: z.string().default("Sorry, something went wrong."),
     label: z.string().default("Ask a question"),
     placeholder: z.string().default("Ask a question…"),
     send: z.string().default("Send"),
+    tip: z.string().default("Tip: You can open and close chat with"),
     title: z.string().default("Ask AI")
   }).default({}),
   feedback: z.object({
@@ -3568,6 +3811,9 @@ var collectIcons = (navigation) => {
       push(item.icon, `selector "${item.label}"`);
     }
   }
+  for (const link of navigation.featured) {
+    push(link.icon, `featured link "${link.label}"`);
+  }
   const sidebars = [navigation.sidebar];
   for (const sidebar of sidebars) {
     for (const node of flattenNodes(sidebar)) {
@@ -3597,7 +3843,11 @@ var resolvesToPages = (routes, path) => routes.has(path) || [...routes].some((ro
 var validateNavTargets = (navigation, routes) => {
   const targets = [
     ...navigation.tabs.map((tab) => ({ label: tab.label, path: tab.path })),
-    ...navigation.selectors.flatMap((selector) => selector.items.map((item) => ({ label: item.label, path: item.path })))
+    ...navigation.selectors.flatMap((selector) => selector.items.map((item) => ({ label: item.label, path: item.path }))),
+    ...navigation.featured.map((link) => ({
+      label: link.label,
+      path: link.href
+    }))
   ];
   const diagnostics = [];
   const seen = new Set;
@@ -3677,10 +3927,10 @@ var validateNavStructure = (navigation, pages) => [
 ];
 
 // src/core/tsconfig-aliases.ts
-import { existsSync as existsSync7, readFileSync as readFileSync3, statSync } from "node:fs";
+import { existsSync as existsSync8, 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 isAbsolute3, join as join9, resolve as resolve4 } from "pathe";
+import { dirname as dirname6, isAbsolute as isAbsolute3, join as join10, resolve as resolve4 } from "pathe";
 var stripJsonComments = (text) => {
   let out = "";
   let inString = false;
@@ -3743,7 +3993,7 @@ var resolveExtends = (spec, fromDir) => {
     return candidates.find(isFile) ?? null;
   }
   try {
-    const require_ = createRequire3(pathToFileURL(join9(fromDir, "_.js")).href);
+    const require_ = createRequire3(pathToFileURL(join10(fromDir, "_.js")).href);
     for (const sub of [`${spec}/tsconfig.json`, spec]) {
       try {
         return require_.resolve(sub);
@@ -3753,7 +4003,7 @@ var resolveExtends = (spec, fromDir) => {
   return null;
 };
 var loadPaths = (file, seen) => {
-  if (seen.has(file) || !existsSync7(file)) {
+  if (seen.has(file) || !existsSync8(file)) {
     return null;
   }
   seen.add(file);
@@ -3765,7 +4015,7 @@ var loadPaths = (file, seen) => {
   if (options.paths && typeof options.paths === "object") {
     const baseUrl = typeof options.baseUrl === "string" ? options.baseUrl : ".";
     return {
-      baseDir: resolve4(dirname5(file), baseUrl),
+      baseDir: resolve4(dirname6(file), baseUrl),
       paths: options.paths
     };
   }
@@ -3774,7 +4024,7 @@ var loadPaths = (file, seen) => {
     if (typeof base !== "string") {
       continue;
     }
-    const resolved = resolveExtends(base, dirname5(file));
+    const resolved = resolveExtends(base, dirname6(file));
     const found = resolved ? loadPaths(resolved, seen) : null;
     if (found) {
       return found;
@@ -3795,7 +4045,7 @@ var toAlias = (key, value, baseDir) => {
   return { find, replacement: resolve4(baseDir, target) };
 };
 var resolveTsconfigAliases = (root) => {
-  const entry = ["tsconfig.json", "jsconfig.json"].map((name) => join9(root, name)).find((file) => existsSync7(file));
+  const entry = ["tsconfig.json", "jsconfig.json"].map((name) => join10(root, name)).find((file) => existsSync8(file));
   if (!entry) {
     return {};
   }
@@ -3813,84 +4063,6 @@ var resolveTsconfigAliases = (root) => {
   return aliases;
 };
 
-// src/deploy/rss.ts
-var capitalize = (value) => value.charAt(0).toUpperCase() + value.slice(1);
-var pageDate = (page) => {
-  const raw = page.meta.date ?? page.meta.changelog?.date;
-  if (!raw) {
-    return;
-  }
-  const date = new Date(raw);
-  return Number.isNaN(date.getTime()) ? undefined : date;
-};
-var buildRssFeeds = (project) => {
-  const { config } = project;
-  const { rss } = config.seo;
-  const { site } = config.deployment;
-  if (!(rss.enabled && site)) {
-    return [];
-  }
-  const base = site.replace(/\/$/u, "");
-  const feeds = [];
-  for (const type of rss.types) {
-    const pages = project.graph.pages.filter((page) => page.contentType === type && !(page.meta.draft || page.meta.sidebar.hidden));
-    if (pages.length === 0) {
-      continue;
-    }
-    const items = pages.map((page) => ({
-      date: pageDate(page),
-      description: page.description,
-      link: `${base}${page.route}`,
-      title: page.title
-    })).toSorted((a, b) => (b.date?.getTime() ?? 0) - (a.date?.getTime() ?? 0)).slice(0, rss.limit);
-    feeds.push({
-      description: config.description,
-      items,
-      link: base,
-      path: `/${type}/rss.xml`,
-      title: `${config.title} — ${capitalize(type)}`,
-      type
-    });
-  }
-  return feeds;
-};
-var renderItem = (item) => {
-  const parts = [
-    `    <title>${escapeXml(item.title)}</title>`,
-    `    <link>${escapeXml(item.link)}</link>`,
-    `    <guid isPermaLink="true">${escapeXml(item.link)}</guid>`
-  ];
-  if (item.description) {
-    parts.push(`    <description>${escapeXml(item.description)}</description>`);
-  }
-  if (item.date) {
-    parts.push(`    <pubDate>${item.date.toUTCString()}</pubDate>`);
-  }
-  return `  <item>
-${parts.join(`
-`)}
-  </item>`;
-};
-var renderRssFeed = (feed) => {
-  const channel = [
-    `  <title>${escapeXml(feed.title)}</title>`,
-    `  <link>${escapeXml(feed.link)}</link>`,
-    `  <description>${escapeXml(feed.description ?? feed.title)}</description>`,
-    `  <atom:link href="${escapeXml(`${feed.link}${feed.path}`)}" rel="self" type="application/rss+xml" />`
-  ];
-  const items = feed.items.map(renderItem).join(`
-`);
-  return `<?xml version="1.0" encoding="UTF-8"?>
-<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
-<channel>
-${channel.join(`
-`)}
-${items}
-</channel>
-</rss>
-`;
-};
-
 // src/openapi/references.ts
 var NON_SLUG = /[^a-z0-9]+/gu;
 var SLUG_EDGES = /^-+|-+$/gu;
@@ -3971,11 +4143,35 @@ var hasScalarReferences = (config) => resolveReferences(config).some((ref) => re
 
 // src/openapi/scalar.ts
 import { readFile as readFile5 } from "node:fs/promises";
-import { isAbsolute as isAbsolute5, join as join11 } from "pathe";
+import { isAbsolute as isAbsolute5, join as join12 } from "pathe";
 
 // src/astro/templates.ts
-import { existsSync as existsSync8, readFileSync as readFileSync4 } from "node:fs";
-import { dirname as dirname6, isAbsolute as isAbsolute4, join as join10, relative as relative4 } from "pathe";
+import { existsSync as existsSync9, readFileSync as readFileSync4 } from "node:fs";
+import { dirname as dirname7, isAbsolute as isAbsolute4, join as join11, relative as relative4 } from "pathe";
+
+// src/core/sources/watch.ts
+var BLUME_IGNORE_DIRS = [
+  ".blume",
+  ".cache",
+  ".git",
+  ".next",
+  ".turbo",
+  ".vercel",
+  "dist",
+  "node_modules"
+];
+var baselineScanIgnore = () => BLUME_IGNORE_DIRS.map((dir) => `**/${dir}/**`);
+var BLUME_WATCH_IGNORE_DIRS = BLUME_IGNORE_DIRS;
+var excludeDirSegments = (patterns) => patterns.map((pattern) => /^(?<dir>[^*/]+)\/\*\*$/u.exec(pattern)?.groups?.dir).filter((dir) => dir !== undefined);
+var ignoringWatchListener = (onChange, ignoreDirs = BLUME_WATCH_IGNORE_DIRS) => {
+  const ignore = new Set(ignoreDirs);
+  return (_event, filename) => {
+    if (typeof filename === "string" && filename.split(/[/\\]/u).some((segment) => ignore.has(segment))) {
+      return;
+    }
+    onChange();
+  };
+};
 
 // src/theme/fonts.ts
 var FALLBACKS = {
@@ -4133,7 +4329,7 @@ var WORKSPACE_MARKERS = [
   "yarn.lock"
 ];
 var hasWorkspacesField = (pkgPath) => {
-  if (!existsSync8(pkgPath)) {
+  if (!existsSync9(pkgPath)) {
     return false;
   }
   try {
@@ -4143,14 +4339,14 @@ var hasWorkspacesField = (pkgPath) => {
     return false;
   }
 };
-var hasWorkspaceMarker = (dir) => hasWorkspacesField(join10(dir, "package.json")) || WORKSPACE_MARKERS.some((marker) => existsSync8(join10(dir, marker)));
+var hasWorkspaceMarker = (dir) => hasWorkspacesField(join11(dir, "package.json")) || WORKSPACE_MARKERS.some((marker) => existsSync9(join11(dir, marker)));
 var findWorkspaceRoot = (start) => {
   let dir = start;
   for (;; ) {
     if (hasWorkspaceMarker(dir)) {
       return dir;
     }
-    const parent = dirname6(dir);
+    const parent = dirname7(dir);
     if (parent === dir) {
       return start;
     }
@@ -4265,9 +4461,7 @@ var astroConfigTemplate = (options) => {
   const twoslashTransformer = "transformerTwoslash({ explicitTrigger: true }), ";
   const integrations = [
     `mdx({ processor: blumeMdxProcessor(${JSON.stringify({
-      headingAnchors: config.markdown.headingAnchors,
-      inline: config.markdown.code.inline,
-      math: config.markdown.math
+      headingAnchors: config.markdown.headingAnchors
     })}) })`
   ];
   if (needsReact) {
@@ -4295,8 +4489,7 @@ export default defineConfig({
   integrations: [${integrations.join(", ")}],
   markdown: {
     processor: blumeMarkdownProcessor(${JSON.stringify({
-    headingAnchors: config.markdown.headingAnchors,
-    inline: config.markdown.code.inline
+    headingAnchors: config.markdown.headingAnchors
   })}),
     shikiConfig: {
       themes: {
@@ -4314,9 +4507,17 @@ export default defineConfig({
     // native bindings resolve at runtime and isolated linkers don't bundle
     // symlinked store copies (which would surface their children as unresolvable
     // imports). See RENDER_EXTERNAL_DEPS / prerenderDepsPlugin.
+    //
+    // The SSR externals go through the legacy \`ssr.external\` key rather than
+    // \`environments.ssr\`: defining a user-owned \`environments.ssr\` block
+    // collides with the internal environment Astro 7 builds the server under and
+    // detaches the adapter's server entrypoint from the rolldown input, so the
+    // SSR entry is emitted as \`index.mjs\` instead of the \`entry.mjs\` the
+    // Vercel adapter's \`astro:build:done\` hook then fails to find. \`prerender\`
+    // is Astro-only and has no legacy equivalent, so it stays under \`environments\`.
+    ssr: { external: ${JSON.stringify(RENDER_EXTERNAL_DEPS)} },
     environments: {
       prerender: { resolve: { external: ${JSON.stringify(RENDER_EXTERNAL_DEPS)} } },
-      ssr: { resolve: { external: ${JSON.stringify(RENDER_EXTERNAL_DEPS)} } },
     },
     resolve: {
       alias: {
@@ -4338,14 +4539,14 @@ export default defineConfig({
       // self-hosted fonts) -- pure noise the loader logs as "No entry type
       // found". Vite appends this to its default ignores.
       watch: {
-        ignored: ${JSON.stringify([join10(context.outDir, ".astro", "**")])},
+        ignored: ${JSON.stringify([join11(context.outDir, ".astro", "**")])},
       },
     },
   },
 });
 `;
 };
-var stagedContentDir = (outDir) => join10(outDir, "content");
+var stagedContentDir = (outDir) => join11(outDir, "content");
 var contentConfigTemplate = (options) => {
   const { context, config } = options;
   const stagedBase = options.stagedBase ?? stagedContentDir(context.outDir);
@@ -4355,7 +4556,7 @@ var contentConfigTemplate = (options) => {
   const docsPattern = filesystem ? [
     ...config.content.include,
     ...(config.content.exclude ?? []).map((pattern) => `!${pattern}`),
-    "!**/node_modules/**",
+    ...BLUME_IGNORE_DIRS.filter((dir) => dir !== ".blume").map((dir) => `!**/${dir}/**`),
     ...outDirIgnore
   ] : [];
   const stagedBlock = options.staged ? `
@@ -4691,7 +4892,7 @@ const siteHost = (() => {
 
 export async function GET({ props }) {
   const png = await renderOgImage({
-    accent: data.config.theme.accent,
+    accent: data.config.theme.accent.light,
     brand: data.config.title,
     description: data.config.description,
     logo: data.config.logo?.svg,
@@ -4739,7 +4940,7 @@ var catchAllPageTemplate = (options) => {
   const askImport = options.askEnabled ? `import AskAI from "blume/components/islands/AskAI.astro";
 ` : "";
   const askSlot = options.askEnabled ? `
-  <AskAI slot="ask" strings={ui.ask} />` : "";
+  <AskAI slot="ask" strings={ui.ask} suggestions={data.config.ask?.suggestions ?? []} />` : "";
   const mathImport = options.mathEnabled ? `import Math from "blume/components/content/Math.astro";
 ` : "";
   const mathEntry = options.mathEnabled ? `Math,
@@ -4991,7 +5192,7 @@ var changelogIndexTemplate = (options) => {
   const askImport = options.askEnabled ? `import AskAI from "blume/components/islands/AskAI.astro";
 ` : "";
   const askSlot = options.askEnabled ? `
-  <AskAI slot="ask" />` : "";
+  <AskAI slot="ask" strings={data.ui.ask} suggestions={data.config.ask?.suggestions ?? []} />` : "";
   const clientData = options.needsReact ? `
   clientData={{ config: data.config, navigation: data.navigation, page: { route: "/changelog", title: data.config.title + " changelog" } }}` : "";
   const stagedSpread = options.staged ? `
@@ -5035,6 +5236,20 @@ const slugify = (text) =>
   text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") ||
   "update";
 
+// The major of a version's embedded semver (\`1.2.3\` -> 1, \`pkg@2.0.0\` -> 2), or
+// null when there is no full major.minor.patch to key on. Drives the changelog's
+// group-by-major pagination, so it tolerates the scoped tags monorepos publish.
+const majorVersion = (version) => {
+  const match = /(\\d+)\\.\\d+\\.\\d+/.exec(String(version ?? ""));
+  return match ? Number(match[1]) : null;
+};
+
+// Map each entry to its own generated page so the timeline heading can deep-link
+// to it. The collection entry id matches the route manifest's \`entryId\`.
+const routeByEntry = new Map(
+  data.routes.map((route) => [route.entryId, route.path])
+);
+
 const changelogEntries = [
   ...(await getCollection("docs")),${stagedSpread}
 ]
@@ -5056,8 +5271,10 @@ const items = await Promise.all(
     return {
       Content: (await render(entry)).Content,
       date: formatDate(entryDate(entry)),
+      href: routeByEntry.get(entry.id) ?? null,
       id: slugify(label),
       label,
+      major: majorVersion(entry.data.changelog?.version),
       tags: entry.data.changelog?.category
         ? [entry.data.changelog.category]
         : [],
@@ -5065,6 +5282,19 @@ const items = await Promise.all(
   })
 );
 
+// A changelog is semver-paginated only when every visible release parses as
+// semver and they span more than one major line. Older majors then collapse
+// into groups the reader reveals one at a time; otherwise the timeline is flat.
+const majors = items.every((item) => item.major !== null)
+  ? [...new Set(items.map((item) => item.major))].toSorted((a, b) => b - a)
+  : [];
+const paginate = majors.length > 1;
+const majorGroups = majors.map((major) => ({
+  items: items.filter((item) => item.major === major),
+  label: major + ".x",
+  major,
+}));
+
 const headings = items.map((item) => ({
   depth: 2,
   slug: item.id,
@@ -5096,6 +5326,7 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   }}
   headings={headings}
   toc={data.config.toc}
+  contentLayout="bare"
   themeMode={data.config.theme.mode}
   fontCssVars={data.fontCssVars}
   searchEnabled={data.config.search.enabled}
@@ -5114,16 +5345,50 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   {
     items.length === 0 ? (
       <p>No changelog entries yet.</p>
+    ) : paginate ? (
+      <blume-changelog class="not-prose mt-8 block">
+        {majorGroups[0].items.map(({ Content, href, id, label, date, tags }) => (
+          <Update description={date} href={href} id={id} label={label} tags={tags}>
+            <Content />
+          </Update>
+        ))}
+        {majorGroups.slice(1).map((group) => (
+          <section
+            aria-label={group.label + " releases"}
+            data-changelog-label={group.label}
+            data-changelog-major={group.major}
+          >
+            {group.items.map(({ Content, href, id, label, date, tags }) => (
+              <Update description={date} href={href} id={id} label={label} tags={tags}>
+                <Content />
+              </Update>
+            ))}
+          </section>
+        ))}
+        <div class="mt-10 flex justify-center">
+          <button
+            class="inline-flex items-center gap-2 rounded-full border border-border bg-background px-4 py-2 font-medium text-muted-foreground text-sm transition-colors hover:bg-muted hover:text-foreground"
+            data-changelog-more
+            hidden
+            type="button"
+          >
+            Show older releases
+          </button>
+        </div>
+      </blume-changelog>
     ) : (
       <div class="not-prose mt-8">
-        {items.map(({ Content, id, label, date, tags }) => (
-          <Update description={date} id={id} label={label} tags={tags}>
+        {items.map(({ Content, href, id, label, date, tags }) => (
+          <Update description={date} href={href} id={id} label={label} tags={tags}>
             <Content />
           </Update>
         ))}
       </div>
     )
   }
+  <script>
+    import "blume/components/content/changelog-element.ts";
+  </script>
 </LayoutComponent>
 `;
 };
@@ -5281,8 +5546,8 @@ var themeRootCss = (theme, options) => [
   `  --blume-accent: ${options.accent};`,
   ...cssToken("--blume-action", options.action),
   ...cssToken("--blume-action-foreground", options.action ? "oklch(1 0 0)" : null),
-  ...cssToken("--blume-background", safeColorOrNull(theme.background)),
-  ...cssToken("--blume-background-image", theme.backgroundImage ? backgroundImageCss(theme.backgroundImage) : null),
+  ...cssToken("--blume-background", safeColorOrNull(theme.background?.light)),
+  ...cssToken("--blume-background-image", theme.backgroundImage?.light ? backgroundImageCss(theme.backgroundImage.light) : null),
   `  --blume-radius: ${options.radius};`
 ].filter(Boolean).join(`
 `);
@@ -5292,8 +5557,8 @@ var themeDarkCss = (theme, options) => {
     "  --blume-accent-foreground: oklch(1 0 0);",
     ...cssToken("--blume-action", options.action),
     ...cssToken("--blume-action-foreground", options.action ? "oklch(1 0 0)" : null),
-    ...cssToken("--blume-background", safeColorOrNull(theme.backgroundDark)),
-    ...cssToken("--blume-background-image", theme.backgroundImageDark ? backgroundImageCss(theme.backgroundImageDark) : null)
+    ...cssToken("--blume-background", safeColorOrNull(theme.background?.dark)),
+    ...cssToken("--blume-background-image", theme.backgroundImage?.dark ? backgroundImageCss(theme.backgroundImage.dark) : null)
   ].filter(Boolean);
   return `:root[data-theme="dark"] {
 ${tokens.join(`
@@ -5301,20 +5566,22 @@ ${tokens.join(`
 }
 `;
 };
-var resolveAccent = (theme) => presetOrColor(theme.accent);
+var resolveAccent = (theme) => ({
+  dark: presetOrColor(theme.accent.dark),
+  light: presetOrColor(theme.accent.light)
+});
 var resolveRadius = (theme) => RADII[theme.radius];
 var buildThemeCss = (theme) => {
-  const accent = presetOrColor(theme.accent);
-  const accentDark = theme.accentDark ? presetOrColor(theme.accentDark) : null;
+  const accent = resolveAccent(theme);
   const action = theme.action ? presetOrColor(theme.action) : null;
   const radius = RADII[theme.radius];
   const root = themeRootCss(theme, {
-    accent,
+    accent: accent.light,
     action,
     radius
   });
   const dark = themeDarkCss(theme, {
-    accent: accentDark ?? accent,
+    accent: accent.dark,
     action
   });
   return `/* Generated by Blume from theme config. */
@@ -5347,7 +5614,7 @@ var themeConfiguration = (config, override) => {
   const accent = resolveAccent(config.theme);
   const radius = resolveRadius(config.theme);
   return {
-    customCss: `:root,.light-mode,.dark-mode{--scalar-color-accent:${accent};--scalar-radius:${radius};}`,
+    customCss: `:root,.light-mode,.dark-mode{--scalar-color-accent:${accent.light};--scalar-radius:${radius};}.dark-mode{--scalar-color-accent:${accent.dark};}`,
     ...darkModeConfig(config.theme.mode)
   };
 };
@@ -5355,7 +5622,7 @@ var specConfiguration = async (spec, root) => {
   if (URL_SPEC.test(spec)) {
     return { config: { url: spec } };
   }
-  const absolute = isAbsolute5(spec) ? spec : join11(root, spec);
+  const absolute = isAbsolute5(spec) ? spec : join12(root, spec);
   try {
     return { config: { content: await readFile5(absolute, "utf-8") } };
   } catch {
@@ -5413,8 +5680,8 @@ var buildReferenceFiles = async (options) => {
 };
 
 // src/core/sources/cache.ts
-import { mkdir as mkdir2, readFile as readFile6, writeFile as writeFile3 } from "node:fs/promises";
-import { join as join12 } from "pathe";
+import { mkdir as mkdir3, 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) {
@@ -5441,7 +5708,7 @@ var pollingWatch = (load2, intervalSeconds) => (onChange) => {
   return () => clearInterval(timer);
 };
 var snapshotCache = (cacheDir) => {
-  const file = join12(cacheDir, "entries.json");
+  const file = join13(cacheDir, "entries.json");
   return {
     read: async () => {
       try {
@@ -5452,7 +5719,7 @@ var snapshotCache = (cacheDir) => {
     },
     write: async (entries) => {
       try {
-        await mkdir2(cacheDir, { recursive: true });
+        await mkdir3(cacheDir, { recursive: true });
         await writeFile3(file, `${JSON.stringify(entries)}
 `, "utf-8");
       } catch {}
@@ -5556,10 +5823,10 @@ var extractOperations = (document, baseRoute) => {
 };
 
 // src/openapi/parse.ts
-import { mkdir as mkdir3, readFile as readFile7, writeFile as writeFile4 } from "node:fs/promises";
+import { mkdir as mkdir4, readFile as readFile7, writeFile as writeFile4 } from "node:fs/promises";
 import { setTimeout as sleep } from "node:timers/promises";
 import { normalize as normalize2, upgrade } from "@scalar/openapi-parser";
-import { isAbsolute as isAbsolute6, join as join13 } from "pathe";
+import { isAbsolute as isAbsolute6, join as join14 } from "pathe";
 var URL_SPEC2 = /^https?:\/\//u;
 var FETCH_TIMEOUT_MS = 15000;
 var MAX_ATTEMPTS = 3;
@@ -5634,7 +5901,7 @@ var fetchSpecText = async (spec) => {
   }
   throw last.error;
 };
-var cacheFileFor = (cacheDir, spec) => join13(cacheDir, `spec-${hashText(spec)}.cache`);
+var cacheFileFor = (cacheDir, spec) => join14(cacheDir, `spec-${hashText(spec)}.cache`);
 var readCache = async (file) => {
   try {
     return await readFile7(file, "utf-8");
@@ -5644,13 +5911,13 @@ var readCache = async (file) => {
 };
 var writeCache = async (dir, file, text) => {
   try {
-    await mkdir3(dir, { recursive: true });
+    await mkdir4(dir, { recursive: true });
     await writeFile4(file, text, "utf-8");
   } catch {}
 };
 var readSpecText = async (spec, root, options) => {
   if (!URL_SPEC2.test(spec)) {
-    const absolute = isAbsolute6(spec) ? spec : join13(root, spec);
+    const absolute = isAbsolute6(spec) ? spec : join14(root, spec);
     return { text: await readFile7(absolute, "utf-8"), warnings: [] };
   }
   const cacheFile = options.cacheDir ? cacheFileFor(options.cacheDir, spec) : undefined;
@@ -6252,6 +6519,10 @@ blume-diff {
   font-size: 0.8125rem;
 }
 
+.prose :where(td, th) :not(pre) > code {
+  white-space: nowrap;
+}
+
 blume-tabs pre,
 .not-prose > div > pre {
   background: var(--blume-code-background);
@@ -6427,9 +6698,9 @@ pre:has(.line.focused):hover .line:not(.focused) {
   content: none;
 }
 
-/* Inline code highlighting (markdown.code.inline): Shiki colors the tokens of a
-   \`code\`{:lang} snippet via the same dual-theme CSS variables as fenced blocks,
-   keeping the inline pill background. */
+/* Inline code highlighting: Shiki colors the tokens of a \`code\`{:lang} snippet
+   via the same dual-theme CSS variables as fenced blocks, keeping the inline
+   pill background. Always on — it only fires on the trailing {:lang} marker. */
 .prose code.blume-inline-code span {
   color: var(--shiki-light);
 }
@@ -6653,12 +6924,12 @@ export const layoutOverrides = { ...(overrides.layout ?? {})${layoutEntries.leng
 
 // src/astro/examples.ts
 import { readFile as readFile9 } from "node:fs/promises";
-import { join as join15, relative as relative5 } from "pathe";
+import { join as join16, relative as relative5 } from "pathe";
 import { glob as glob2 } from "tinyglobby";
 
 // src/astro/islands.ts
 import { readFile as readFile8 } from "node:fs/promises";
-import { basename, join as join14 } from "pathe";
+import { basename, join as join15 } from "pathe";
 import { glob } from "tinyglobby";
 var DEFAULT_CLIENT = "visible";
 var VALID_MODES = new Set([
@@ -6687,7 +6958,7 @@ var readClientMode = (source, file, warnings) => {
   return mode;
 };
 var discoverIslands = async (root) => {
-  const dir = join14(root, "islands");
+  const dir = join15(root, "islands");
   const matches = await glob(["**/*.{jsx,svelte,tsx,vue}"], {
     absolute: true,
     cwd: dir,
@@ -6750,7 +7021,7 @@ 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 = join15(root, base);
+  const dir = join16(root, base);
   const matches = await glob2([rest], {
     absolute: true,
     cwd: dir,
@@ -6831,10 +7102,10 @@ var customOgRoutes = (pages, siteTitle) => {
 };
 
 // src/astro/generate.ts
-var BLUME_SRC = join16(packageRoot(), "src");
+var BLUME_SRC = join17(packageRoot(), "src");
 var canResolveFrom = (fromDir, spec) => {
   try {
-    createRequire5(pathToFileURL2(join16(fromDir, "_.js")).href).resolve(spec);
+    createRequire5(pathToFileURL2(join17(fromDir, "_.js")).href).resolve(spec);
     return true;
   } catch {
     return false;
@@ -6842,15 +7113,15 @@ var canResolveFrom = (fromDir, spec) => {
 };
 var resolvedAstroPath = (fromDir) => {
   try {
-    const pkg = createRequire5(pathToFileURL2(join16(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 = [join16(pkgDir, "node_modules"), dirname7(pkgDir)];
-  return candidates.find((dir) => existsSync9(join16(dir, "astro"))) ?? null;
+  const candidates = [join17(pkgDir, "node_modules"), dirname8(pkgDir)];
+  return candidates.find((dir) => existsSync10(join17(dir, "astro"))) ?? null;
 };
 var linkDepsJunction = async (link, depsDir) => {
   const existing = await lstat(link).catch(() => null);
@@ -6858,9 +7129,9 @@ var linkDepsJunction = async (link, depsDir) => {
     if (!existing.isSymbolicLink()) {
       return;
     }
-    await rm(link, { force: true });
+    await rm2(link, { force: true });
   }
-  await mkdir4(dirname7(link), { recursive: true });
+  await mkdir5(dirname8(link), { recursive: true });
   await symlink(depsDir, link, "junction");
 };
 var readPkgVersion = (pkgJsonPath) => {
@@ -6890,8 +7161,8 @@ var ensureDepsLink = async (outDir, pkgDir = packageRoot()) => {
   if (blumeAstro && outDirAstro === blumeAstro) {
     return null;
   }
-  if (existsSync9(join16(depsDir, "@astrojs", "mdx"))) {
-    await linkDepsJunction(join16(outDir, "node_modules"), depsDir);
+  if (existsSync10(join17(depsDir, "@astrojs", "mdx"))) {
+    await linkDepsJunction(join17(outDir, "node_modules"), depsDir);
     return null;
   }
   return astroConflictWarning(blumeAstro, outDirAstro);
@@ -6928,6 +7199,15 @@ var detectNeedsReact = async (root) => {
   });
   return matches.length > 0;
 };
+var detectUsesMath = async (root) => {
+  const files = await glob4(["**/*.mdx"], {
+    cwd: root,
+    ignore: ["**/node_modules/**", "**/.blume/**", "**/dist/**"],
+    onlyFiles: true
+  });
+  const contents = await Promise.all(files.map((file) => readOptional(join17(root, file))));
+  return contents.some((content) => content.includes("$$"));
+};
 var writeIfChanged = async (path, content) => {
   let existing = null;
   try {
@@ -6938,13 +7218,13 @@ var writeIfChanged = async (path, content) => {
   if (existing === content) {
     return false;
   }
-  await mkdir4(dirname7(path), { recursive: true });
+  await mkdir5(dirname8(path), { recursive: true });
   const tmp = `${path}.${process.pid}.tmp`;
   await writeFile5(tmp, content, "utf-8");
   try {
     await rename(tmp, path);
   } catch (error) {
-    await rm(tmp, { force: true });
+    await rm2(tmp, { force: true });
     throw error;
   }
   return true;
@@ -6955,7 +7235,7 @@ var pruneOrphans = async (srcDir, written) => {
     cwd: srcDir,
     onlyFiles: true
   });
-  await Promise.all(existing.map((path) => normalize3(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) => rm2(path, { force: true })));
 };
 var collectStaged = (project) => {
   const staged = new Map;
@@ -6970,11 +7250,11 @@ var writeStagedContent = async (out, staged) => {
   const contentDir = stagedContentDir(out);
   const written = new Set;
   await Promise.all([...staged].map(async ([entryId, text]) => {
-    const path = join16(contentDir, entryId);
+    const path = join17(contentDir, entryId);
     written.add(normalize3(path));
     await writeIfChanged(path, text);
   }));
-  if (existsSync9(contentDir)) {
+  if (existsSync10(contentDir)) {
     await pruneOrphans(contentDir, written);
   }
 };
@@ -6993,9 +7273,9 @@ var resolveLogo = (project) => {
   if (light && light === dark && light.toLowerCase().endsWith(".svg")) {
     const rel = light.replace(/^\//u, "");
     const file = [
-      join16(project.context.root, "public", rel),
-      join16(project.context.root, rel)
-    ].find((path) => existsSync9(path));
+      join17(project.context.root, "public", rel),
+      join17(project.context.root, rel)
+    ].find((path) => existsSync10(path));
     if (file) {
       return { alt, href: brandHref, svg: readFileSync6(file, "utf-8"), text };
     }
@@ -7023,7 +7303,7 @@ var faviconType = (name) => {
 };
 var inlineDataUri = (file, type) => `data:${type};base64,${readFileSync6(file).toString("base64")}`;
 var defaultFavicon = () => ({
-  href: inlineDataUri(join16(BLUME_SRC, "assets", "icon.png"), "image/png"),
+  href: inlineDataUri(join17(BLUME_SRC, "assets", "icon.png"), "image/png"),
   type: "image/png"
 });
 var APPLE_ICON_CANDIDATES = [
@@ -7035,13 +7315,13 @@ var APPLE_ICON_CANDIDATES = [
 var resolveIconFile = (project, candidates) => {
   const { root } = project.context;
   for (const name of candidates) {
-    if (existsSync9(join16(root, "public", name))) {
+    if (existsSync10(join17(root, "public", name))) {
       return { href: `/${name}`, type: faviconType(name) };
     }
   }
   for (const name of candidates) {
-    const file = join16(root, name);
-    if (existsSync9(file)) {
+    const file = join17(root, name);
+    if (existsSync10(file)) {
       const type = faviconType(name);
       return { href: inlineDataUri(file, type ?? "image/x-icon"), type };
     }
@@ -7097,6 +7377,7 @@ var buildRuntimeData = (project) => {
   const navigationByLocale = i18n ? Object.fromEntries(i18n.locales.map(({ code }) => [
     code,
     withReferenceTabs(graph.navigationByLocale[code] ?? {
+      featured: [],
       selectors: [],
       sidebar: [],
       tabs: []
@@ -7106,6 +7387,7 @@ var buildRuntimeData = (project) => {
     config: {
       analytics: config.analytics ?? null,
       appleIcon: resolveAppleIcon(project),
+      ask: config.ai.ask?.enabled ? { suggestions: config.ai.ask.suggestions } : null,
       banner: resolveBanner(config),
       codeWrap: config.markdown.code.wrap,
       description: config.description,
@@ -7167,7 +7449,7 @@ var buildRuntimeData = (project) => {
 var planMcp = (project, srcDir) => {
   const { config } = project;
   const { route } = config.mcp;
-  const dir = join16(srcDir, "blume-mcp");
+  const dir = join17(srcDir, "blume-mcp");
   const base = {
     dir,
     discoveryPages: [],
@@ -7191,11 +7473,11 @@ var planMcp = (project, srcDir) => {
     ...base,
     discoveryPages: [
       {
-        entrypoint: join16(dir, "discovery.ts"),
+        entrypoint: join17(dir, "discovery.ts"),
         pattern: "/.well-known/mcp.json"
       },
       {
-        entrypoint: join16(dir, "server-card.ts"),
+        entrypoint: join17(dir, "server-card.ts"),
         pattern: "/.well-known/mcp/server-card.json"
       }
     ],
@@ -7214,11 +7496,11 @@ var writeMcpFiles = async (project, plan, write) => {
     version: data.version
   };
   await Promise.all([
-    write(join16(plan.srcDir, "generated", "mcp-data.json"), `${JSON.stringify(data)}
+    write(join17(plan.srcDir, "generated", "mcp-data.json"), `${JSON.stringify(data)}
 `),
-    write(join16(plan.srcDir, "pages", mcpPageFile(plan.route)), mcpEndpointTemplate(plan.route)),
-    write(join16(plan.dir, "discovery.ts"), staticJsonEndpointTemplate(buildMcpDiscovery(discoveryInput))),
-    write(join16(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) => {
@@ -7228,16 +7510,16 @@ var writeAskFiles = async (project, srcDir, write) => {
   }
   const grounded = ask.provider !== "inkeep";
   if (grounded) {
-    await write(join16(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(join16(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(join16(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));
@@ -7256,12 +7538,12 @@ var buildComponentSlots = async (componentsFile) => {
 var generateRuntime = async (project) => {
   const { context, config } = project;
   const out = context.outDir;
-  const srcDir = join16(out, "src");
-  const dataPath = join16(srcDir, "generated", "data.json");
-  const themePath = join16(srcDir, "generated", "app.css");
-  const searchClientPath = join16(srcDir, "generated", "search-client.ts");
-  const examplesPath = join16(srcDir, "generated", "examples.ts");
-  const openapiPath = join16(srcDir, "generated", "openapi.json");
+  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(normalize3(path));
@@ -7271,9 +7553,17 @@ var generateRuntime = async (project) => {
   const askEnabled = config.ai.ask?.enabled ?? false;
   const exportPdf = config.export.pdf;
   const exportEpub = config.export.epub;
-  const [pages, detectedReact, userTheme, islandDiscovery, exampleDiscovery] = await Promise.all([
+  const [
+    pages,
+    detectedReact,
+    usesMath,
+    userTheme,
+    islandDiscovery,
+    exampleDiscovery
+  ] = await Promise.all([
     context.pagesRoot ? discoverPages(context.pagesRoot) : Promise.resolve([]),
     detectNeedsReact(context.root),
+    detectUsesMath(context.root),
     readOptional(context.themeFile),
     discoverIslands(context.root),
     discoverExamples(context.root, config.examples)
@@ -7298,7 +7588,7 @@ var generateRuntime = async (project) => {
   const hasStaged = staged.size > 0;
   const hasFilesystemSource = project.sources.some((source) => !source.staged);
   const structural = await Promise.all([
-    write(join16(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),
@@ -7313,25 +7603,25 @@ var generateRuntime = async (project) => {
       searchClientPath,
       themePath
     })),
-    write(join16(out, "package.json"), runtimePackageTemplate(runtimeDependencies({ config, needsReact, needsSvelte, needsVue }))),
-    write(join16(out, "tsconfig.json"), runtimeTsconfigTemplate()),
-    write(join16(srcDir, "env.d.ts"), envTemplate()),
-    write(join16(srcDir, "content.config.ts"), contentConfigTemplate({
+    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,
       filesystem: hasFilesystemSource,
       staged: hasStaged
     })),
-    write(join16(srcDir, "pages", "[...slug].astro"), catchAllPageTemplate({
+    write(join17(srcDir, "pages", "[...slug].astro"), catchAllPageTemplate({
       askEnabled,
       exportEpub,
       exportPdf,
-      mathEnabled: config.markdown.math,
+      mathEnabled: usesMath,
       needsReact
     })),
-    write(join16(srcDir, "generated", "components.ts"), slotPlan.module),
-    write(join16(srcDir, "generated", "islands.ts"), islandMapTemplate(islandDiscovery.islands)),
-    write(join16(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: [
@@ -7342,16 +7632,16 @@ var generateRuntime = async (project) => {
       userTheme
     }))
   ]);
-  await Promise.all(islandDiscovery.islands.map((island) => write(join16(srcDir, "generated", "islands", `${island.name}.astro`), islandWrapperTemplate(island))));
-  await Promise.all(slotPlan.wrappers.map((wrapper) => write(join16(srcDir, "generated", "component-slots", `${wrapper.name}.astro`), wrapper.content)));
-  await Promise.all(exampleDiscovery.examples.map((example) => write(join16(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(join16(srcDir, "pages", "og", "[...slug].png.ts"), ogEndpointTemplate(ogRoutes));
+    await write(join17(srcDir, "pages", "og", "[...slug].png.ts"), ogEndpointTemplate(ogRoutes));
   }
   if (shouldGenerateChangelog(project)) {
-    await write(join16(srcDir, "pages", "changelog.astro"), changelogIndexTemplate({
+    await write(join17(srcDir, "pages", "changelog.astro"), changelogIndexTemplate({
       askEnabled,
       exportEpub,
       exportPdf,
@@ -7363,27 +7653,27 @@ var generateRuntime = async (project) => {
   await write(searchClientPath, searchClientTemplate(config));
   if (servesStaticIndex(config.search.provider)) {
     const documents = await buildSearchDocuments(project);
-    await write(join16(srcDir, "generated", "search.json"), `${JSON.stringify(documents)}
+    await write(join17(srcDir, "generated", "search.json"), `${JSON.stringify(documents)}
 `);
-    await write(join16(srcDir, "pages", "blume-search.json.ts"), searchEndpointTemplate());
+    await write(join17(srcDir, "pages", "blume-search.json.ts"), searchEndpointTemplate());
   }
   if (config.search.provider === "mixedbread") {
-    await write(join16(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(join16(srcDir, "generated", "raw-markdown.json"), `${JSON.stringify(rawMarkdown)}
+    write(join17(srcDir, "generated", "raw-markdown.json"), `${JSON.stringify(rawMarkdown)}
 `),
-    write(join16(srcDir, "pages", "[...slug].md.ts"), rawMarkdownEndpointTemplate()),
-    write(join16(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(join16(srcDir, "generated", "rss.json"), `${JSON.stringify(feedXml)}
+      write(join17(srcDir, "generated", "rss.json"), `${JSON.stringify(feedXml)}
 `),
-      write(join16(srcDir, "pages", "[section]", "rss.xml.ts"), rssEndpointTemplate())
+      write(join17(srcDir, "pages", "[section]", "rss.xml.ts"), rssEndpointTemplate())
     ]);
   }
   const warnings = [
@@ -7420,13 +7710,13 @@ var generateRuntime = async (project) => {
       root: context.root
     });
     warnings.push(...references.warnings);
-    await Promise.all(references.files.map((file) => write(join16(srcDir, "pages", file.pagePath), file.content)));
+    await Promise.all(references.files.map((file) => write(join17(srcDir, "pages", file.pagePath), file.content)));
   }
-  await write(join16(srcDir, "generated", "data.json"), buildRuntimeData(project));
+  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(join16(out, "blume.manifest.json"), `${JSON.stringify(project.manifest, null, 2)}
+  await write(join17(out, "blume.manifest.json"), `${JSON.stringify(project.manifest, null, 2)}
 `);
   await writeStagedContent(out, staged);
   await pruneOrphans(srcDir, written);
@@ -7434,7 +7724,7 @@ 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/deployment-env.ts
 var toUrl = (value) => {
@@ -7545,7 +7835,6 @@ var pageMetaSchema = pageMetaBaseSchema;
 var sidebarDisplaySchema = z2.enum(["flat", "group", "page"]);
 var folderMetaSchema = z2.object({
   collapsed: z2.boolean().optional(),
-  display: sidebarDisplaySchema.optional(),
   icon: iconName.optional(),
   order: z2.number().optional(),
   pages: z2.array(z2.string()).optional(),
@@ -7699,14 +7988,18 @@ var sidebarItemSchema = z2.lazy(() => z2.union([
 var fontSlug = z2.string().refine(isFontSlug, (value) => ({
   message: `Unknown font "${value}". Supported fonts: ${FONT_SLUGS.join(", ")}.`
 }));
+var perModeValueSchema = z2.union([
+  z2.string(),
+  z2.object({ dark: z2.string().optional(), light: z2.string().optional() }).strict()
+]).optional().transform((value) => typeof value === "string" ? { dark: value, light: value } : value);
 var themeConfigSchema = z2.object({
-  accent: z2.string().default("blue"),
-  accentDark: z2.string().optional(),
+  accent: z2.union([
+    z2.string(),
+    z2.object({ dark: z2.string(), light: z2.string() }).strict()
+  ]).default("blue").transform((value) => typeof value === "string" ? { dark: value, light: value } : value),
   action: z2.string().optional(),
-  background: z2.string().optional(),
-  backgroundDark: z2.string().optional(),
-  backgroundImage: z2.string().optional(),
-  backgroundImageDark: z2.string().optional(),
+  background: perModeValueSchema,
+  backgroundImage: perModeValueSchema,
   fonts: z2.object({
     body: fontSlug.default("inter"),
     display: fontSlug.default("inter-tight"),
@@ -7785,7 +8078,11 @@ var aiConfigSchema = z2.object({
     baseUrl: z2.string().url().optional(),
     enabled: z2.boolean().default(false),
     model: z2.string().default("openai/gpt-5.5"),
-    provider: z2.enum(askAiProviders).default("gateway")
+    provider: z2.enum(askAiProviders).default("gateway"),
+    suggestions: z2.array(z2.object({
+      icon: iconName.optional(),
+      label: z2.string().min(1)
+    }).strict()).default([])
   }).strict().superRefine((value, ctx) => {
     if (value.provider === "openai-compatible" && !value.baseUrl) {
       ctx.addIssue({
@@ -7797,10 +8094,22 @@ var aiConfigSchema = z2.object({
   }).optional(),
   llmsTxt: z2.boolean().default(false)
 }).strict();
+var featuredLinkSchema = z2.object({
+  href: z2.string(),
+  icon: iconName.optional(),
+  label: z2.string()
+}).strict();
 var navigationConfigSchema = z2.object({
+  featured: z2.array(featuredLinkSchema).default([]),
   repo: z2.boolean().default(true),
   selectors: z2.array(navSelectorSchema).default([]),
-  sidebar: z2.array(sidebarItemSchema).optional(),
+  sidebar: z2.union([
+    z2.array(sidebarItemSchema),
+    z2.object({
+      display: sidebarDisplaySchema.default("flat"),
+      items: z2.array(sidebarItemSchema).optional()
+    }).strict()
+  ]).default({}).transform((value) => Array.isArray(value) ? { display: "flat", items: value } : value),
   tabs: z2.array(navTabSchema).optional()
 }).strict();
 var exportConfigSchema = z2.union([
@@ -7880,7 +8189,23 @@ var rssConfigSchema = z2.object({
   limit: z2.number().int().positive().default(50),
   types: z2.array(z2.string()).default(["blog", "changelog"])
 }).strict();
+var contentSignalsObjectSchema = z2.object({
+  aiInput: z2.boolean().default(true),
+  aiTrain: z2.boolean().default(true),
+  search: z2.boolean().default(true)
+}).strict();
+var contentSignalsSchema = z2.union([z2.boolean(), contentSignalsObjectSchema]).transform((value) => {
+  if (value === true) {
+    return contentSignalsObjectSchema.parse({});
+  }
+  if (value === false) {
+    return null;
+  }
+  return value;
+});
 var seoConfigSchema = z2.object({
+  agentReadability: z2.boolean().default(true),
+  contentSignals: contentSignalsSchema.default(true),
   og: ogConfigSchema.default({}),
   robots: z2.boolean().default(true),
   rss: rssConfigSchema.default({}),
@@ -7906,15 +8231,13 @@ var lastModifiedConfigSchema = z2.union([
 ]);
 var codeConfigSchema = z2.object({
   icons: z2.boolean().default(true),
-  inline: z2.boolean().default(false),
   wrap: z2.boolean().default(false)
 }).strict();
 var markdownConfigSchema = z2.object({
   code: codeConfigSchema.default({}),
   codeBlocks: codeBlocksConfigSchema.default({}),
   headingAnchors: z2.boolean().default(true),
-  imageZoom: z2.boolean().default(true),
-  math: z2.boolean().default(false)
+  imageZoom: z2.boolean().default(true)
 }).strict();
 var openapiSourceSchema = z2.object({
   label: z2.string().optional(),
@@ -8000,7 +8323,7 @@ var loadConfig = async (root, options = {}) => {
   }
   const parsed = blumeConfigSchema.safeParse(raw ?? {});
   if (!parsed.success) {
-    const source = configFile && existsSync10(configFile) ? readFileSync7(configFile, "utf-8") : undefined;
+    const source = configFile && existsSync11(configFile) ? readFileSync7(configFile, "utf-8") : undefined;
     const diagnostics = diagnosticsFromZod(parsed.error, {
       code: "BLUME_CONFIG_INVALID",
       file: configFile ?? undefined,
@@ -8091,7 +8414,6 @@ var applyFolderMeta = (group, folderMeta, sharedMeta, metaPrefix) => {
     group.icon = meta.icon ?? group.icon;
     group.order = meta.order ?? group.order;
     group.collapsed = meta.collapsed ?? group.collapsed;
-    group.display = meta.display ?? group.display;
     if (meta.pages) {
       const rank = new Map(meta.pages.map((key, i) => [key, i]));
       for (const child of group.children) {
@@ -8121,7 +8443,15 @@ var sortNodes = (nodes) => {
     }
   }
 };
-var toNavNode = (node) => {
+var hoistPages = (nodes) => {
+  const pages = nodes.filter((node) => node.kind === "page");
+  const groups = nodes.filter((node) => node.kind === "group");
+  nodes.splice(0, nodes.length, ...pages, ...groups);
+  for (const group of groups) {
+    hoistPages(group.children);
+  }
+};
+var toNavNode = (node, display) => {
   if (node.kind === "page") {
     return {
       badge: node.badge,
@@ -8135,16 +8465,16 @@ var toNavNode = (node) => {
     };
   }
   return {
-    children: node.children.map(toNavNode),
+    children: node.children.map((child) => toNavNode(child, display)),
     collapsed: node.collapsed,
-    display: node.display,
+    display,
     icon: node.icon,
     kind: "group",
     label: node.label,
     path: node.routePath
   };
 };
-var buildFileSystemSidebar = (pages, folderMeta, sharedMeta, metaPrefix) => {
+var buildFileSystemSidebar = (pages, folderMeta, sharedMeta, metaPrefix, display) => {
   const root = createGroup("", "", "", 0);
   for (const page of pages) {
     if (page.meta.sidebar.hidden) {
@@ -8175,7 +8505,10 @@ var buildFileSystemSidebar = (pages, folderMeta, sharedMeta, metaPrefix) => {
   }
   applyFolderMeta(root, folderMeta, sharedMeta, metaPrefix);
   sortNodes(root.children);
-  return root.children.map(toNavNode);
+  if (display === "flat") {
+    hoistPages(root.children);
+  }
+  return root.children.map((child) => toNavNode(child, display));
 };
 var normalizeRef = (ref) => {
   if (ref === "index") {
@@ -8192,7 +8525,7 @@ var routeForRef = (ref, byRoute) => {
   const normalized = normalizeRef(ref);
   return byRoute.get(normalized)?.route ?? normalized;
 };
-var buildConfigSidebar = (items, byRoute) => {
+var buildConfigSidebar = (items, byRoute, display) => {
   const nodes = [];
   for (const item of items) {
     if (typeof item === "string") {
@@ -8214,10 +8547,10 @@ var buildConfigSidebar = (items, byRoute) => {
     if (item.items) {
       nodes.push({
         badge: item.badge,
-        children: buildConfigSidebar(item.items, byRoute),
+        children: buildConfigSidebar(item.items, byRoute, display),
         collapsed: item.collapsed,
         directory: item.directory,
-        display: item.display,
+        display: item.display ?? display,
         icon: item.icon,
         kind: "group",
         label: item.label,
@@ -8252,8 +8585,10 @@ var buildConfigSidebar = (items, byRoute) => {
   return nodes;
 };
 var buildNavigation = (pages, options) => {
+  const featured = options.featured ?? [];
   const selectors = options.selectors ?? [];
   const tabs = options.tabs ?? [];
+  const display = options.display ?? "flat";
   const metaPrefix = options.metaPrefix ?? "";
   const sharedFolderMeta = options.sharedFolderMeta ?? new Map;
   const byRoute = new Map(pages.map((page) => [
@@ -8262,14 +8597,16 @@ var buildNavigation = (pages, options) => {
   ]));
   if (options.sidebar) {
     return {
+      featured,
       selectors,
-      sidebar: buildConfigSidebar(options.sidebar, byRoute),
+      sidebar: buildConfigSidebar(options.sidebar, byRoute, display),
       tabs
     };
   }
   return {
+    featured,
     selectors,
-    sidebar: buildFileSystemSidebar(pages, options.folderMeta, sharedFolderMeta, metaPrefix),
+    sidebar: buildFileSystemSidebar(pages, options.folderMeta, sharedFolderMeta, metaPrefix, display),
     tabs
   };
 };
@@ -8327,26 +8664,31 @@ var buildContentGraph = (pages, options) => {
         localePages = [...real, ...filled];
       }
       navigationByLocale[code] = buildNavigation(localePages, {
+        display: options.navigation.sidebar.display,
+        featured: options.navigation.featured,
         folderMeta: options.folderMeta,
         metaPrefix: i18n.parser === "dir" && code !== i18n.defaultLocale ? code : "",
         refByLogical: true,
         selectors: options.navigation.selectors,
         sharedFolderMeta: options.sharedFolderMeta,
-        sidebar: options.navigation.sidebar,
+        sidebar: options.navigation.sidebar.items,
         tabs
       });
     }
     navigation = navigationByLocale[i18n.defaultLocale] ?? {
+      featured: [],
       selectors: [],
       sidebar: [],
       tabs: []
     };
   } else {
     navigation = buildNavigation(pages, {
+      display: options.navigation.sidebar.display,
+      featured: options.navigation.featured,
       folderMeta: options.folderMeta,
       selectors: options.navigation.selectors,
       sharedFolderMeta: options.sharedFolderMeta,
-      sidebar: options.navigation.sidebar,
+      sidebar: options.navigation.sidebar.items,
       tabs: options.navigation.tabs
     });
   }
@@ -8415,7 +8757,7 @@ var gitLastModifiedTimes = (root, contentRoot, sourcePaths) => {
 };
 
 // src/core/meta.ts
-import { basename as basename3, dirname as dirname8, relative as relative9 } from "pathe";
+import { basename as basename3, dirname as dirname9, relative as relative9 } from "pathe";
 import { glob as glob5 } from "tinyglobby";
 var META_FILES = [
   "**/meta.ts",
@@ -8445,7 +8787,7 @@ var discoverFolderMeta = async (contentRoot) => {
   const shared = new Map;
   const diagnostics = [];
   for (const entry of loaded) {
-    const dir = relative9(contentRoot, dirname8(entry.file));
+    const dir = relative9(contentRoot, dirname9(entry.file));
     if (!entry.ok) {
       diagnostics.push({
         code: "BLUME_META_LOAD_FAILED",
@@ -8470,7 +8812,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;
@@ -8604,7 +8946,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",
@@ -8655,35 +8997,20 @@ var normalizeEntry2 = (entry, ctx) => {
 };
 
 // src/core/sources/resolve.ts
-import { join as join21 } from "pathe";
+import { join as join22 } from "pathe";
 
 // src/core/sources/filesystem.ts
-import { existsSync as existsSync12, watch as fsWatch } from "node:fs";
+import { existsSync as existsSync13, watch as fsWatch } from "node:fs";
 import { readFile as readFile11 } from "node:fs/promises";
-import { extname as extname5, isAbsolute as isAbsolute7, join as join17, relative as relative10, resolve as resolve5 } from "pathe";
+import { extname as extname5, isAbsolute as isAbsolute7, join as join18, relative as relative10, resolve as resolve5 } from "pathe";
 import { glob as glob6 } from "tinyglobby";
-
-// src/core/sources/watch.ts
-var BLUME_WATCH_IGNORE_DIRS = [".blume", ".git", "node_modules"];
-var excludeDirSegments = (patterns) => patterns.map((pattern) => /^(?<dir>[^*/]+)\/\*\*$/u.exec(pattern)?.groups?.dir).filter((dir) => dir !== undefined);
-var ignoringWatchListener = (onChange, ignoreDirs = BLUME_WATCH_IGNORE_DIRS) => {
-  const ignore = new Set(ignoreDirs);
-  return (_event, filename) => {
-    if (typeof filename === "string" && filename.split(/[/\\]/u).some((segment) => ignore.has(segment))) {
-      return;
-    }
-    onChange();
-  };
-};
-
-// src/core/sources/filesystem.ts
 var filesystemSource = (options) => {
-  const contentRoot = isAbsolute7(options.root) ? options.root : join17(resolve5(options.projectRoot), options.root);
+  const contentRoot = isAbsolute7(options.root) ? options.root : join18(resolve5(options.projectRoot), options.root);
   const load2 = async () => {
     const files = await glob6(options.include, {
       absolute: true,
       cwd: contentRoot,
-      ignore: options.exclude,
+      ignore: [...options.exclude, ...baselineScanIgnore()],
       onlyFiles: true
     });
     files.sort();
@@ -8702,7 +9029,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,
@@ -8717,7 +9044,7 @@ var filesystemSource = (options) => {
     ...excludeDirSegments(options.exclude)
   ]);
   const watch = (onChange) => {
-    if (!existsSync12(contentRoot)) {
+    if (!existsSync13(contentRoot)) {
       return () => {};
     }
     const watcher = fsWatch(contentRoot, { recursive: true }, ignoringWatchListener(onChange, watchIgnoreDirs));
@@ -8728,7 +9055,7 @@ var filesystemSource = (options) => {
     load: load2,
     name: options.name,
     prefix: options.prefix,
-    read: (ref) => readFile11(join17(contentRoot, ref), "utf-8"),
+    read: (ref) => readFile11(join18(contentRoot, ref), "utf-8"),
     staged: false,
     validate,
     watch
@@ -9018,11 +9345,11 @@ var mdxRemoteSource = (options, ctx) => {
 
 // src/core/sources/notion.ts
 import { setTimeout as sleep2 } from "node:timers/promises";
-import { join as join19 } from "pathe";
+import { join as join20 } from "pathe";
 
 // src/core/sources/assets.ts
-import { mkdir as mkdir5, writeFile as writeFile6 } from "node:fs/promises";
-import { extname as extname6, join as join18 } from "pathe";
+import { mkdir as mkdir6, writeFile as writeFile6 } from "node:fs/promises";
+import { extname as extname6, join as join19 } from "pathe";
 var MD_IMAGE = /!\[(?<alt>[^\]]*)\]\((?<url>[^)\s]+)\)/gu;
 var REMOTE = /^https?:\/\//u;
 var SAFE_EXT = /^\.[a-z0-9]+$/iu;
@@ -9050,8 +9377,8 @@ var materializeAssets = async (markdown, ctx) => {
       }
       const bytes = new Uint8Array(await res.arrayBuffer());
       const file = `${hashText(url)}${extFor(url)}`;
-      await mkdir5(ctx.assetsDir, { recursive: true });
-      await writeFile6(join18(ctx.assetsDir, file), bytes);
+      await mkdir6(ctx.assetsDir, { recursive: true });
+      await writeFile6(join19(ctx.assetsDir, file), bytes);
       rewrites.set(url, `${ctx.assetsBaseUrl}/${file}`);
     } catch (error) {
       diagnostics.push({
@@ -9167,8 +9494,8 @@ ${text}
 };
 var notionSource = (options, ctx) => {
   const props = options.properties ?? {};
-  const cache = snapshotCache(ctx?.cacheDir ?? join19(".blume", "cache", options.name));
-  const assetsDir = ctx?.assetsDir ?? join19(".blume", "public", "blume-assets", options.name);
+  const cache = snapshotCache(ctx?.cacheDir ?? join20(".blume", "cache", options.name));
+  const assetsDir = ctx?.assetsDir ?? join20(".blume", "public", "blume-assets", options.name);
   const assetsBaseUrl = ctx?.assetsBaseUrl ?? `/blume-assets/${options.name}`;
   let snapshot = new Map;
   const resolveClient = async () => {
@@ -9336,7 +9663,7 @@ ${rendered.join(`
 };
 
 // src/core/sources/sanity.ts
-import { join as join20 } from "pathe";
+import { join as join21 } from "pathe";
 
 // src/core/sources/portable-text.ts
 var HEADING_STYLES = {
@@ -9475,7 +9802,7 @@ var resolveClient = async (options, preview) => {
 };
 var sanitySource = (options, ctx) => {
   const fields = options.fields ?? {};
-  const cache = snapshotCache(ctx?.cacheDir ?? join20(".blume", "cache", options.name));
+  const cache = snapshotCache(ctx?.cacheDir ?? join21(".blume", "cache", options.name));
   let snapshot = new Map;
   const toEntry2 = (doc) => {
     const slugValue = asString(getPath(doc, fields.slug ?? "slug.current")) ?? asString(doc._id) ?? "untitled";
@@ -9550,8 +9877,8 @@ var uniqueNamer = () => {
 };
 var sourceContext = (context, name, runtime) => ({
   assetsBaseUrl: `/blume-assets/${name}`,
-  assetsDir: join21(context.outDir, "public", "blume-assets", name),
-  cacheDir: join21(context.outDir, "cache", name),
+  assetsDir: join22(context.outDir, "public", "blume-assets", name),
+  cacheDir: join22(context.outDir, "cache", name),
   mode: runtime.mode,
   preview: runtime.preview,
   projectRoot: context.root,
@@ -9741,8 +10068,8 @@ var scanProject = async (root, options = {}) => {
 };
 
 // src/cli/env.ts
-import { existsSync as existsSync13, readFileSync as readFileSync9 } from "node:fs";
-import { dirname as dirname9, join as join22, resolve as resolve6 } from "pathe";
+import { existsSync as existsSync14, readFileSync as readFileSync9 } from "node:fs";
+import { dirname as dirname10, join as join23, resolve as resolve6 } 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;
@@ -9780,7 +10107,7 @@ var applyEnv = (parsed) => {
 };
 var loadFile = (path) => {
   try {
-    if (existsSync13(path)) {
+    if (existsSync14(path)) {
       applyEnv(parseEnv(readFileSync9(path, "utf-8")));
     }
   } catch {}
@@ -9789,10 +10116,10 @@ var loadEnvFiles = (startDir) => {
   let dir = resolve6(startDir);
   let done = false;
   while (!done) {
-    loadFile(join22(dir, ".env.local"));
-    loadFile(join22(dir, ".env"));
-    const parent = dirname9(dir);
-    done = existsSync13(join22(dir, ".git")) || parent === dir;
+    loadFile(join23(dir, ".env.local"));
+    loadFile(join23(dir, ".env"));
+    const parent = dirname10(dir);
+    done = existsSync14(join23(dir, ".git")) || parent === dir;
     dir = parent;
   }
 };
@@ -9922,24 +10249,24 @@ var emitRedirectFiles = async (config, distDir) => {
   if (redirects.length === 0 || config.deployment.output !== "static") {
     return;
   }
-  await writeFile7(join23(distDir, "blume-redirects.json"), buildRedirectManifest(redirects), "utf-8");
+  await writeFile7(join24(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) => existsSync14(join23(distDir, file.name)) ? Promise.resolve() : writeFile7(join23(distDir, file.name), file.content, "utf-8")));
+  await Promise.all(platformFiles.map((file) => existsSync15(join24(distDir, file.name)) ? Promise.resolve() : writeFile7(join24(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 = join23(distDir, "_astro");
-  if (!existsSync14(astroDir)) {
+  const astroDir = join24(distDir, "_astro");
+  if (!existsSync15(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(join23(astroDir, name));
+    const info = await stat(join24(astroDir, name));
     return { name, size: info.size };
   }));
   return sized.toSorted((a, b) => b.size - a.size);
@@ -9995,21 +10322,27 @@ var publishBuildArtifacts = async (project, distDir, args) => {
   if (project.config.ai.llmsTxt) {
     const { index, full } = await buildLlmsFiles(project);
     await Promise.all([
-      writeFile7(join23(distDir, "llms.txt"), index, "utf-8"),
-      writeFile7(join23(distDir, "llms-full.txt"), full, "utf-8")
+      writeFile7(join24(distDir, "llms.txt"), index, "utf-8"),
+      writeFile7(join24(distDir, "llms-full.txt"), full, "utf-8")
     ]);
     logger.success("Generated llms.txt and llms-full.txt");
   }
   const sitemap = buildSitemap(project);
-  if (sitemap && !existsSync14(join23(distDir, "sitemap.xml"))) {
-    await writeFile7(join23(distDir, "sitemap.xml"), sitemap, "utf-8");
+  if (sitemap && !existsSync15(join24(distDir, "sitemap.xml"))) {
+    await writeFile7(join24(distDir, "sitemap.xml"), sitemap, "utf-8");
     logger.success("Generated sitemap.xml");
   }
   const robots = buildRobots(project);
-  if (robots && !existsSync14(join23(distDir, "robots.txt"))) {
-    await writeFile7(join23(distDir, "robots.txt"), robots, "utf-8");
+  if (robots && !existsSync15(join24(distDir, "robots.txt"))) {
+    await writeFile7(join24(distDir, "robots.txt"), robots, "utf-8");
     logger.success("Generated robots.txt");
   }
+  const agentReadability = buildAgentReadability(project);
+  if (agentReadability && !existsSync15(join24(distDir, "agent-readability.json"))) {
+    await writeFile7(join24(distDir, "agent-readability.json"), `${JSON.stringify(agentReadability, null, 2)}
+`, "utf-8");
+    logger.success("Generated agent-readability.json");
+  }
   await emitRedirectFiles(project.config, distDir);
   const { config } = project;
   const features = serverFeatures(config);
@@ -10021,6 +10354,7 @@ var publishBuildArtifacts = async (project, distDir, args) => {
     `Redirects  ${config.redirects.length}`,
     `Sitemap    ${sitemap ? "yes" : "no (set deployment.site)"}`,
     `Robots     ${robots ? "yes" : "no"}`,
+    `Agent JSON ${agentReadability ? "yes" : "no"}`,
     `LLM files  ${config.ai.llmsTxt ? "yes" : "no"}`,
     `Server features  ${features.length > 0 ? features.join(", ") : "none"}`
   ].join(`
@@ -10106,21 +10440,26 @@ var buildCommand = defineCommand2({
       logLevel: "info",
       root: project.context.outDir
     });
-    const distDir = project.context.distDir ?? join23(root, "dist");
+    const distDir = project.context.distDir ?? join24(root, "dist");
     if (runtimeDir) {
       logger.success(`Isolated build OK — output at ${distDir} (not published).`);
       return;
     }
-    await publishBuildArtifacts(project, distDir, args);
+    const surfaced = await surfaceAdapterOutput(project.config, project.context);
+    if (surfaced.moved) {
+      logger.success(`Surfaced ${project.config.deployment.adapter} output to ${surfaced.to}`);
+      await ensureGitignore(root, [surfaced.ignore]);
+    }
+    await publishBuildArtifacts(project, deployStaticDir(project.config, project.context), args);
   }
 });
 
 // src/cli/commands/check.ts
-import { existsSync as existsSync15 } from "node:fs";
+import { existsSync as existsSync16 } from "node:fs";
 import { check } from "@astrojs/check";
 import { sync } from "astro";
 import { defineCommand as defineCommand3 } from "citty";
-import { join as join24 } from "pathe";
+import { join as join25 } from "pathe";
 var checkCommand = defineCommand3({
   args: {
     isolated: {
@@ -10156,13 +10495,13 @@ var checkCommand = defineCommand3({
     });
     const { outDir } = project.context;
     await sync({ logLevel: "warn", root: outDir });
-    const tsconfig = join24(root, "tsconfig.json");
+    const tsconfig = join25(root, "tsconfig.json");
     logger.start(`Type-checking ${project.graph.pages.length} page(s)`);
     const failed = await check({
       minimumFailingSeverity: "error",
       minimumSeverity: "hint",
       root: outDir,
-      tsconfig: existsSync15(tsconfig) ? tsconfig : undefined,
+      tsconfig: existsSync16(tsconfig) ? tsconfig : undefined,
       watch: false
     });
     if (failed) {
@@ -10279,6 +10618,14 @@ var devCommand = defineCommand4({
     const explicitPort = parsePort(args.port);
     const port = explicitPort ?? 4321;
     const devServerUrl = `http://localhost:${port}`;
+    const outDir = resolveRuntimeDir(root);
+    const running = readDevLock(outDir);
+    if (running) {
+      logger.error(`A \`blume dev\` server is already running${describeDevLock(running)} in this project. Reuse that server instead of starting a second one — two dev servers would corrupt the shared .blume dir. If it crashed, delete .blume/dev.lock.`);
+      process.exit(1);
+    }
+    const releaseLock = acquireDevLock(outDir, port);
+    process.on("exit", releaseLock);
     const project = await prepareProject({
       devServerUrl,
       mode: "dev",
@@ -10287,12 +10634,6 @@ var devCommand = defineCommand4({
       root,
       strict: args.strict
     });
-    if (isDevLocked(project.context.outDir)) {
-      logger.error("Another `blume dev` is already running in this project; two dev servers would corrupt the shared .blume dir. Stop the other one first (or delete .blume/dev.lock if it crashed).");
-      process.exit(1);
-    }
-    const releaseLock = acquireDevLock(project.context.outDir);
-    process.on("exit", releaseLock);
     const server = await dev({
       logLevel: args.debug ? "debug" : "info",
       root: project.context.outDir,
@@ -10302,6 +10643,9 @@ var devCommand = defineCommand4({
         port: explicitPort
       }
     });
+    if (server.address.port !== port) {
+      updateDevLockPort(outDir, server.address.port);
+    }
     showBlumeErrorOverlay(project.diagnostics);
     const runRegenerate = coalescedRunner(async () => {
       try {
@@ -10429,12 +10773,12 @@ var doctorCommand = defineCommand5({
 // src/cli/commands/eject.ts
 import { readFile as readFile13, writeFile as writeFile9 } from "node:fs/promises";
 import { defineCommand as defineCommand6 } from "citty";
-import { join as join26, relative as relative12 } from "pathe";
+import { join as join27, relative as relative12 } from "pathe";
 
 // src/registry/eject.ts
-import { existsSync as existsSync16 } from "node:fs";
-import { cp, mkdir as mkdir6, readFile as readFile12, rm as rm2, writeFile as writeFile8 } from "node:fs/promises";
-import { join as join25, relative as relative11 } from "pathe";
+import { existsSync as existsSync17 } from "node:fs";
+import { cp as cp2, mkdir as mkdir7, readFile as readFile12, rm as rm3, writeFile as writeFile8 } from "node:fs/promises";
+import { join as join26, relative as relative11 } from "pathe";
 var POSIX = (path) => path.split("\\").join("/");
 var ejectOpenApiData = (project) => {
   const source = project.sources.find(isOpenApiSource);
@@ -10449,14 +10793,14 @@ var askFiles = async (project, srcDir, genDir) => {
   const files = [
     {
       content: askEndpointTemplate(resolveAskBackend(ask), grounded),
-      path: join25(srcDir, "pages", "api", "ask.ts")
+      path: join26(srcDir, "pages", "api", "ask.ts")
     }
   ];
   if (grounded) {
     files.push({
       content: `${JSON.stringify(await buildAskData(project))}
 `,
-      path: join25(genDir, "ask-data.json")
+      path: join26(genDir, "ask-data.json")
     });
   }
   return files;
@@ -10464,14 +10808,23 @@ var askFiles = async (project, srcDir, genDir) => {
 var eject = async (root) => {
   const project = await scanProject(root, { mode: "build" });
   const { context, config } = project;
-  const srcDir = join25(root, "src");
-  const genDir = join25(srcDir, "generated");
+  const srcDir = join26(root, "src");
+  const genDir = join26(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([
+  const [
+    pages,
+    needsReactRaw,
+    usesMath,
+    userTheme,
+    rawMarkdown,
+    islands,
+    examples
+  ] = await Promise.all([
     context.pagesRoot ? discoverPages(context.pagesRoot) : Promise.resolve([]),
     detectNeedsReact(root),
+    detectUsesMath(root),
     context.themeFile ? readFile12(context.themeFile, "utf-8") : Promise.resolve(""),
     buildRawMarkdown(project),
     discoverIslands(root),
@@ -10514,14 +10867,14 @@ var eject = async (root) => {
         searchClientPath: "./src/generated/search-client.ts",
         themePath: "./src/generated/app.css"
       }),
-      path: join25(root, "astro.config.mjs")
+      path: join26(root, "astro.config.mjs")
     },
     {
       content: runtimeTsconfigTemplate(),
-      path: join25(root, "tsconfig.json"),
+      path: join26(root, "tsconfig.json"),
       skipIfExists: true
     },
-    { content: envTemplate(), path: join25(srcDir, "env.d.ts") },
+    { content: envTemplate(), path: join26(srcDir, "env.d.ts") },
     {
       content: contentConfigTemplate({
         config,
@@ -10529,29 +10882,29 @@ var eject = async (root) => {
         staged: hasStaged,
         stagedBase: stagedDir
       }),
-      path: join25(srcDir, "content.config.ts")
+      path: join26(srcDir, "content.config.ts")
     },
     {
       content: catchAllPageTemplate({
         askEnabled,
         exportEpub,
         exportPdf,
-        mathEnabled: config.markdown.math,
+        mathEnabled: usesMath,
         needsReact
       }),
-      path: join25(srcDir, "pages", "[...slug].astro")
+      path: join26(srcDir, "pages", "[...slug].astro")
     },
     {
       content: planComponentSlots(componentsImport, null).module,
-      path: join25(genDir, "components.ts")
+      path: join26(genDir, "components.ts")
     },
     {
       content: islandMapTemplate(islands.islands),
-      path: join25(genDir, "islands.ts")
+      path: join26(genDir, "islands.ts")
     },
     {
       content: exampleMapTemplate(examples.examples),
-      path: join25(genDir, "examples.ts")
+      path: join26(genDir, "examples.ts")
     },
     {
       content: tailwindEntryTemplate({
@@ -10563,26 +10916,26 @@ var eject = async (root) => {
         twoslashCss: twoslashCss(),
         userTheme
       }),
-      path: join25(genDir, "app.css")
+      path: join26(genDir, "app.css")
     },
-    { content: buildRuntimeData(project), path: join25(genDir, "data.json") },
+    { content: buildRuntimeData(project), path: join26(genDir, "data.json") },
     {
       content: `${JSON.stringify(ejectOpenApiData(project))}
 `,
-      path: join25(genDir, "openapi.json")
+      path: join26(genDir, "openapi.json")
     },
     {
       content: `${JSON.stringify(rawMarkdown)}
 `,
-      path: join25(genDir, "raw-markdown.json")
+      path: join26(genDir, "raw-markdown.json")
     },
     {
       content: rawMarkdownEndpointTemplate(),
-      path: join25(srcDir, "pages", "[...slug].md.ts")
+      path: join26(srcDir, "pages", "[...slug].md.ts")
     },
     {
       content: rawMarkdownEndpointTemplate(),
-      path: join25(srcDir, "pages", "[...slug].mdx.ts")
+      path: join26(srcDir, "pages", "[...slug].mdx.ts")
     }
   ];
   if (askEnabled) {
@@ -10591,34 +10944,34 @@ var eject = async (root) => {
   if (config.seo.og.enabled) {
     files.push({
       content: ogEndpointTemplate(customOgRoutes(pages, config.title)),
-      path: join25(srcDir, "pages", "og", "[...slug].png.ts")
+      path: join26(srcDir, "pages", "og", "[...slug].png.ts")
     });
   }
   if (!routeIsTaken(pages, project.graph.pages, "/404")) {
     files.push({
       content: notFoundPageTemplate(),
-      path: join25(srcDir, "pages", "404.astro")
+      path: join26(srcDir, "pages", "404.astro")
     });
   }
   files.push({
     content: searchClientTemplate(config),
-    path: join25(genDir, "search-client.ts")
+    path: join26(genDir, "search-client.ts")
   });
   if (servesStaticIndex(config.search.provider)) {
     const documents = await buildSearchDocuments(project);
     files.push({
       content: `${JSON.stringify(documents)}
 `,
-      path: join25(genDir, "search.json")
+      path: join26(genDir, "search.json")
     }, {
       content: searchEndpointTemplate(),
-      path: join25(srcDir, "pages", "blume-search.json.ts")
+      path: join26(srcDir, "pages", "blume-search.json.ts")
     });
   }
   if (config.search.provider === "mixedbread") {
     files.push({
       content: mixedbreadSearchEndpointTemplate(config.search.mixedbread?.storeId ?? ""),
-      path: join25(srcDir, "pages", "api", "search.ts")
+      path: join26(srcDir, "pages", "api", "search.ts")
     });
   }
   const feeds = buildRssFeeds(project);
@@ -10627,10 +10980,10 @@ var eject = async (root) => {
     files.push({
       content: `${JSON.stringify(feedXml)}
 `,
-      path: join25(genDir, "rss.json")
+      path: join26(genDir, "rss.json")
     }, {
       content: rssEndpointTemplate(),
-      path: join25(srcDir, "pages", "[section]", "rss.xml.ts")
+      path: join26(srcDir, "pages", "[section]", "rss.xml.ts")
     });
   }
   if (hasScalarReferences(config)) {
@@ -10642,38 +10995,38 @@ var eject = async (root) => {
     for (const file of references.files) {
       files.push({
         content: file.content,
-        path: join25(srcDir, "pages", file.pagePath)
+        path: join26(srcDir, "pages", file.pagePath)
       });
     }
   }
   files.push(...islands.islands.map((island) => ({
     content: islandWrapperTemplate(island),
-    path: join25(genDir, "islands", `${island.name}.astro`)
+    path: join26(genDir, "islands", `${island.name}.astro`)
   })), ...examples.examples.map((example) => ({
     content: exampleWrapperTemplate(example),
-    path: join25(genDir, "examples", `${exampleSlug(example.path)}.astro`)
+    path: join26(genDir, "examples", `${exampleSlug(example.path)}.astro`)
   })));
   for (const [entryId, content] of staged) {
-    files.push({ content, path: join25(root, stagedDir, entryId) });
+    files.push({ content, path: join26(root, stagedDir, entryId) });
   }
-  const written = files.filter((file) => !(file.skipIfExists && existsSync16(file.path)));
+  const written = files.filter((file) => !(file.skipIfExists && existsSync17(file.path)));
   await Promise.all(written.map(async (file) => {
-    await mkdir6(join25(file.path, ".."), { recursive: true });
+    await mkdir7(join26(file.path, ".."), { recursive: true });
     await writeFile8(file.path, file.content, "utf-8");
   }));
-  const assetsSrc = join25(context.outDir, "public", "blume-assets");
-  if (existsSync16(assetsSrc)) {
-    await cp(assetsSrc, join25(root, "public", "blume-assets"), {
+  const assetsSrc = join26(context.outDir, "public", "blume-assets");
+  if (existsSync17(assetsSrc)) {
+    await cp2(assetsSrc, join26(root, "public", "blume-assets"), {
       recursive: true
     });
   }
-  await rm2(context.outDir, { force: true, recursive: true });
+  await rm3(context.outDir, { force: true, recursive: true });
   return written.map((file) => file.path);
 };
 
 // src/cli/commands/eject.ts
 var updatePackageScripts = async (root) => {
-  const pkgPath = join26(root, "package.json");
+  const pkgPath = join27(root, "package.json");
   let pkg;
   try {
     pkg = JSON.parse(await readFile13(pkgPath, "utf-8"));
@@ -10723,10 +11076,10 @@ The blume package remains importable.`);
 });
 
 // src/cli/commands/init.ts
-import { existsSync as existsSync17 } from "node:fs";
-import { mkdir as mkdir7, writeFile as writeFile10 } from "node:fs/promises";
+import { existsSync as existsSync18 } from "node:fs";
+import { mkdir as mkdir8, writeFile as writeFile10 } from "node:fs/promises";
 import { defineCommand as defineCommand7 } from "citty";
-import { basename as basename4, dirname as dirname10, isAbsolute as isAbsolute8, join as join27, relative as relative13 } from "pathe";
+import { basename as basename4, dirname as dirname11, isAbsolute as isAbsolute8, join as join28, relative as relative13 } from "pathe";
 
 // src/core/package-json.ts
 var toPackageName = (raw) => raw.toLowerCase().replaceAll(/[^a-z0-9._-]+/gu, "-").replaceAll(/^[-_.]+|[-_.]+$/gu, "") || "docs";
@@ -10778,7 +11131,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: join27(dir, "index.mdx")
+        path: join28(dir, "index.mdx")
       }
     ]
   },
@@ -10793,7 +11146,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: join27(dir, "index.mdx")
+        path: join28(dir, "index.mdx")
       },
       {
         content: `---
@@ -10804,7 +11157,7 @@ date: 2026-01-01
 
 The first release. Edit \`${dir}/changelog/v1-0-0.mdx\` or add new entries beside it.
 `,
-        path: join27(dir, "changelog", "v1-0-0.mdx")
+        path: join28(dir, "changelog", "v1-0-0.mdx")
       }
     ]
   },
@@ -10817,7 +11170,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: join27(dir, "index.mdx")
+        path: join28(dir, "index.mdx")
       }
     ]
   },
@@ -10828,11 +11181,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: join27(dir, "index.mdx")
+        path: join28(dir, "index.mdx")
       },
       {
         content: page("Installation", "Install the SDK.", "# Installation\n\n```package-install\nyour-sdk\n```"),
-        path: join27(dir, "installation.mdx")
+        path: join28(dir, "installation.mdx")
       }
     ]
   }
@@ -10842,11 +11195,11 @@ var commandsFor = (pm) => ({
   install: `${pm} install`
 });
 var writeFileSafe = async (path, content) => {
-  if (existsSync17(path)) {
+  if (existsSync18(path)) {
     logger.info(`Skipped existing ${path}`);
     return false;
   }
-  await mkdir7(dirname10(path), { recursive: true });
+  await mkdir8(dirname11(path), { recursive: true });
   await writeFile10(path, content, "utf-8");
   logger.success(`Created ${path}`);
   return true;
@@ -10879,7 +11232,7 @@ var initCommand = defineCommand7({
   async run({ args }) {
     const root = process.cwd();
     const contentDir = args["content-dir"] ?? "docs";
-    if (isAbsolute8(contentDir) || relative13(root, join27(root, contentDir)).startsWith("..")) {
+    if (isAbsolute8(contentDir) || relative13(root, join28(root, contentDir)).startsWith("..")) {
       logger.error(`Invalid --content-dir "${contentDir}" (must be a path inside the project).`);
       process.exit(1);
     }
@@ -10894,9 +11247,9 @@ var initCommand = defineCommand7({
       process.exit(1);
     }
     const starter = STARTERS[template];
-    const createdPackage = await writeFileSafe(join27(root, "package.json"), blumePackageJson(toPackageName(basename4(root))));
-    await writeFileSafe(join27(root, "blume.config.ts"), starter.config);
-    await Promise.all(starter.files(contentDir).map((file) => writeFileSafe(join27(root, file.path), file.content)));
+    const createdPackage = await writeFileSafe(join28(root, "package.json"), blumePackageJson(toPackageName(basename4(root))));
+    await writeFileSafe(join28(root, "blume.config.ts"), starter.config);
+    await Promise.all(starter.files(contentDir).map((file) => writeFileSafe(join28(root, file.path), file.content)));
     const ignored = await ensureGitignore(root, [".blume/", "dist/"]);
     if (ignored.length > 0) {
       logger.success(`Added ${ignored.join(", ")} to .gitignore`);
@@ -10934,10 +11287,10 @@ var initCommand = defineCommand7({
 });
 
 // src/cli/commands/preview.ts
-import { existsSync as existsSync18 } from "node:fs";
+import { existsSync as existsSync19 } from "node:fs";
 import { preview } from "astro";
 import { defineCommand as defineCommand8 } from "citty";
-import { join as join28 } from "pathe";
+import { join as join29 } from "pathe";
 var previewCommand = defineCommand8({
   args: {
     host: { description: "Network host to bind.", type: "string" },
@@ -10951,7 +11304,7 @@ var previewCommand = defineCommand8({
     const root = process.cwd();
     const { config } = await loadConfig(root);
     const context = resolveProjectContext(root, config);
-    if (!existsSync18(join28(context.outDir, "astro.config.mjs"))) {
+    if (!existsSync19(join29(context.outDir, "astro.config.mjs"))) {
       logger.error("No build found. Run `blume build` first.");
       process.exit(1);
     }
@@ -10967,9 +11320,9 @@ var previewCommand = defineCommand8({
 });
 
 // src/cli/commands/sync.ts
-import { rm as rm3 } from "node:fs/promises";
+import { rm as rm4 } from "node:fs/promises";
 import { defineCommand as defineCommand9 } from "citty";
-import { join as join29 } from "pathe";
+import { join as join30 } from "pathe";
 var syncCommand = defineCommand9({
   args: {
     force: {
@@ -10991,7 +11344,7 @@ var syncCommand = defineCommand9({
     if (args.force) {
       const { config } = await loadConfig(root);
       const context = resolveProjectContext(root, config);
-      await rm3(join29(context.outDir, "cache"), { force: true, recursive: true });
+      await rm4(join30(context.outDir, "cache"), { force: true, recursive: true });
       logger.info("Cleared source cache.");
     }
     await prepareProject({
@@ -11006,13 +11359,13 @@ var syncCommand = defineCommand9({
 });
 
 // src/cli/commands/validate.ts
-import { existsSync as existsSync20 } from "node:fs";
+import { existsSync as existsSync21 } from "node:fs";
 import { defineCommand as defineCommand10 } from "citty";
-import { join as join31 } from "pathe";
+import { join as join32 } from "pathe";
 
 // src/core/links.ts
-import { existsSync as existsSync19 } from "node:fs";
-import { basename as basename5, join as join30 } from "pathe";
+import { existsSync as existsSync20 } from "node:fs";
+import { basename as basename5, join as join31 } from "pathe";
 var HTTP = /^https?:\/\//iu;
 var PROTOCOL_RELATIVE = /^\/\//u;
 var SCHEME = /^[a-z][a-z0-9+.-]*:/iu;
@@ -11024,7 +11377,7 @@ var STATUS_NOT_FOUND = 404;
 var STATUS_GONE = 410;
 var STATUS_METHOD_NOT_ALLOWED = 405;
 var STATUS_NOT_IMPLEMENTED = 501;
-var assetIsPresent = (resolved, ctx) => ctx.publicDir !== null && existsSync19(join30(ctx.publicDir, resolved));
+var assetIsPresent = (resolved, ctx) => ctx.publicDir !== null && existsSync20(join31(ctx.publicDir, resolved));
 var isIndexPage = (page2) => {
   const ref = page2.source?.ref ?? page2.sourcePath ?? "";
   return /^index\.(?:md|mdx)$/iu.test(basename5(ref));
@@ -11267,10 +11620,10 @@ var validateCommand = defineCommand10({
     try {
       const project = await scanProject(root, { mode: "build" });
       diagnostics.push(...project.diagnostics);
-      const publicDir = join31(root, "public");
+      const publicDir = join32(root, "public");
       diagnostics.push(...await validateLinks(project.graph, {
         checkExternal: Boolean(args.external),
-        publicDir: existsSync20(publicDir) ? publicDir : null,
+        publicDir: existsSync21(publicDir) ? publicDir : null,
         redirects: project.config.redirects
       }));
     } catch (error) {
@@ -11330,5 +11683,5 @@ process.on("unhandledRejection", (error) => {
 });
 runMain(main);
 
-//# debugId=59F90AF7D601CF0764756E2164756E21
+//# debugId=0628D18D87A2023564756E2164756E21
 //# sourceMappingURL=index.js.map