blume 1.0.2 → 1.0.4

package/dist/cli/index.js

@@ -525,11 +525,11 @@ Next steps:
 });
 
 // src/cli/commands/build.ts
-import { existsSync as existsSync15 } from "node:fs";
+import { existsSync as existsSync16 } 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 join24 } from "pathe";
+import { join as join25 } from "pathe";
 
 // src/core/base-path.ts
 var normalizeBasePath = (input) => {
@@ -676,10 +676,10 @@ var buildAgentReadability = (project) => {
     artifacts.llmsFullTxt = abs("/llms-full.txt");
     artifacts.llmsTxt = abs("/llms.txt");
   }
-  if (config.mcp.enabled) {
+  if (config.ai.mcp.enabled) {
     artifacts.mcp = {
       discovery: abs("/.well-known/mcp.json"),
-      url: abs(config.mcp.route)
+      url: abs(config.ai.mcp.route)
     };
   }
   if (config.ai.ask?.enabled) {
@@ -697,7 +697,7 @@ var buildAgentReadability = (project) => {
     artifacts,
     description: config.description,
     generator: version ? `blume@${version}` : undefined,
-    name: config.mcp.name ?? config.title,
+    name: config.ai.mcp.name ?? config.title,
     site
   };
   const usage = usagePolicy(config.seo.contentSignals);
@@ -1225,7 +1225,7 @@ var serverFeatures = (config) => {
   if (config.ai.ask?.enabled) {
     features.push("Ask AI");
   }
-  if (config.mcp.enabled) {
+  if (config.ai.mcp.enabled) {
     features.push("MCP server");
   }
   if (searchProviderMeta(config.search.provider).requiresServer) {
@@ -1269,7 +1269,7 @@ var surfaceAdapterOutput = async (config, context) => {
   }
   await mkdir2(dirname4(to), { recursive: true });
   await rm(to, { force: true, recursive: true });
-  await cp(from, to, { recursive: true });
+  await cp(from, to, { recursive: true, verbatimSymlinks: true });
   await rm(from, { force: true, recursive: true });
   return { from, ignore: `${rel.split("/")[0]}/`, moved: true, to };
 };
@@ -3972,7 +3972,7 @@ var refuseIfDevRunning = (root, action, options = {}) => {
 };
 
 // src/astro/generate.ts
-import { existsSync as existsSync12, readFileSync as readFileSync7, realpathSync } from "node:fs";
+import { existsSync as existsSync13, readFileSync as readFileSync8, realpathSync } from "node:fs";
 import {
   lstat,
   mkdir as mkdir6,
@@ -3984,7 +3984,7 @@ import {
 } from "node:fs/promises";
 import { createRequire as createRequire5 } from "node:module";
 import { pathToFileURL as pathToFileURL3 } from "node:url";
-import { basename as basename2, dirname as dirname8, join as join22, normalize as normalize3, relative as relative8 } from "pathe";
+import { basename as basename2, dirname as dirname8, join as join23, normalize as normalize3, relative as relative8 } from "pathe";
 import { glob as glob5 } from "tinyglobby";
 
 // src/ai/ask-data.ts
@@ -4117,8 +4117,8 @@ var buildMcpData = async (project) => {
       route: doc.route,
       title: doc.title
     })),
-    instructions: config.mcp.instructions,
-    name: config.mcp.name ?? config.title,
+    instructions: config.ai.mcp.instructions,
+    name: config.ai.mcp.name ?? config.title,
     navigation: graph.navigation,
     pages,
     routes,
@@ -4899,10 +4899,7 @@ var resolveReferences = (config) => [
   }, config.basePath),
   ...referencesFor("asyncapi", config.asyncapi, "Events", "scalar", NO_DISPLAY, config.basePath)
 ];
-var referenceTabs = (config) => resolveReferences(config).map((ref) => ({
-  label: ref.label,
-  path: ref.renderer === "blume" ? withBasePath(config.basePath, ref.route) : ref.route
-}));
+var referenceRoutes = (config) => resolveReferences(config).map((ref) => ref.renderer === "blume" ? withBasePath(config.basePath, ref.route) : ref.route);
 var blumeReferenceOf = (ref, seen, usedSlugs) => {
   if (ref.kind !== "openapi" || ref.renderer !== "blume") {
     return null;
@@ -5480,6 +5477,7 @@ import { glob as glob2 } from "tinyglobby";
 // src/core/sources/watch.ts
 var BLUME_IGNORE_DIRS = [
   ".blume",
+  ".blume-verify",
   ".cache",
   ".git",
   ".next",
@@ -6377,6 +6375,12 @@ var askAiProviders = [
   "inkeep",
   "openai-compatible"
 ];
+var mcpConfigSchema = z2.strictObject({
+  enabled: z2.boolean().default(false),
+  instructions: z2.string().optional(),
+  name: z2.string().optional(),
+  route: z2.string().default("/mcp").transform(normalizeRoute)
+});
 var aiConfigSchema = z2.strictObject({
   ask: z2.strictObject({
     apiKeyEnv: z2.string().optional(),
@@ -6406,7 +6410,8 @@ var aiConfigSchema = z2.strictObject({
   ]).default(true).transform((value) => typeof value === "boolean" ? { enabled: value, openapi: true } : value),
   markdownComponents: z2.record(z2.string(), z2.custom((value) => typeof value === "function", {
     message: "Expected a serializer function."
-  })).default({})
+  })).default({}),
+  mcp: mcpConfigSchema.default({})
 });
 var featuredLinkSchema = z2.strictObject({
   href: z2.string(),
@@ -6424,7 +6429,7 @@ var navigationConfigSchema = z2.strictObject({
       items: z2.array(sidebarItemSchema).optional()
     })
   ]).default({}).transform((value) => Array.isArray(value) ? { display: "flat", items: value } : value),
-  tabs: z2.array(navTabSchema).optional()
+  tabs: z2.array(navTabSchema).default([])
 });
 var exportConfigSchema = z2.union([
   z2.boolean(),
@@ -6433,12 +6438,6 @@ var exportConfigSchema = z2.union([
     pdf: z2.boolean().default(false)
   })
 ]).transform((value) => typeof value === "boolean" ? { epub: value, pdf: value } : value);
-var mcpConfigSchema = z2.strictObject({
-  enabled: z2.boolean().default(false),
-  instructions: z2.string().optional(),
-  name: z2.string().optional(),
-  route: z2.string().default("/mcp").transform(normalizeRoute)
-});
 var localeSchema = z2.strictObject({
   code: z2.string().min(1),
   dir: z2.enum(["ltr", "rtl"]).default("ltr"),
@@ -6499,8 +6498,18 @@ var xConfigSchema = z2.strictObject({
   creator: xHandleSchema,
   handle: xHandleSchema
 });
+var ogColorSchema = z2.string().regex(/^#(?:[0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/iu);
+var ogPaletteSchema = z2.strictObject({
+  accent: ogColorSchema.optional(),
+  background: ogColorSchema.optional(),
+  border: ogColorSchema.optional(),
+  foreground: ogColorSchema.optional(),
+  muted: ogColorSchema.optional()
+});
 var ogConfigSchema = z2.strictObject({
-  enabled: z2.boolean().optional()
+  enabled: z2.boolean().optional(),
+  logo: z2.string().optional(),
+  palette: ogPaletteSchema.optional()
 });
 var rssConfigSchema = z2.strictObject({
   enabled: z2.boolean().default(true),
@@ -6625,7 +6634,6 @@ var blumeConfigSchema = z2.strictObject({
   lastModified: lastModifiedConfigSchema.default(false),
   logo: logoConfigSchema.optional(),
   markdown: markdownConfigSchema.default({}),
-  mcp: mcpConfigSchema.default({}),
   navigation: navigationConfigSchema.default({}),
   openapi: openapiConfigSchema.default({}),
   react: reactConfigSchema.default({}),
@@ -7646,14 +7654,29 @@ var resolveTsconfigAliases = (root) => {
   return aliases;
 };
 
+// src/og/logo.ts
+import { existsSync as existsSync11, readFileSync as readFileSync5 } from "node:fs";
+import { join as join18 } from "pathe";
+var resolveOgLogo = (project, source) => {
+  if (!source?.toLowerCase().endsWith(".svg")) {
+    return;
+  }
+  const relative6 = source.replace(/^\//u, "");
+  const file = [
+    join18(project.context.root, "public", relative6),
+    join18(project.context.root, relative6)
+  ].find((path) => existsSync11(path));
+  return file ? readFileSync5(file, "utf-8") : undefined;
+};
+
 // src/openapi/scalar.ts
 import { readFile as readFile8 } from "node:fs/promises";
-import { isAbsolute as isAbsolute8, join as join19 } from "pathe";
+import { isAbsolute as isAbsolute8, join as join20 } from "pathe";
 
 // src/astro/templates.ts
-import { existsSync as existsSync11, readFileSync as readFileSync5 } from "node:fs";
+import { existsSync as existsSync12, readFileSync as readFileSync6 } from "node:fs";
 import { pathToFileURL as pathToFileURL2 } from "node:url";
-import { dirname as dirname7, isAbsolute as isAbsolute7, join as join18, relative as relative6 } from "pathe";
+import { dirname as dirname7, isAbsolute as isAbsolute7, join as join19, relative as relative6 } from "pathe";
 var WORKSPACE_MARKERS = [
   ".git",
   "bun.lock",
@@ -7664,17 +7687,17 @@ var WORKSPACE_MARKERS = [
   "yarn.lock"
 ];
 var hasWorkspacesField = (pkgPath) => {
-  if (!existsSync11(pkgPath)) {
+  if (!existsSync12(pkgPath)) {
     return false;
   }
   try {
-    const pkg = JSON.parse(readFileSync5(pkgPath, "utf-8"));
+    const pkg = JSON.parse(readFileSync6(pkgPath, "utf-8"));
     return pkg.workspaces !== undefined;
   } catch {
     return false;
   }
 };
-var hasWorkspaceMarker = (dir) => hasWorkspacesField(join18(dir, "package.json")) || WORKSPACE_MARKERS.some((marker) => existsSync11(join18(dir, marker)));
+var hasWorkspaceMarker = (dir) => hasWorkspacesField(join19(dir, "package.json")) || WORKSPACE_MARKERS.some((marker) => existsSync12(join19(dir, marker)));
 var findWorkspaceRoot = (start) => {
   let dir = start;
   for (;; ) {
@@ -7697,6 +7720,23 @@ var ADAPTER_IMPORTS = {
 var ADAPTER_OPTIONS = {
   node: '{ mode: "standalone" }'
 };
+var WRANGLER_CONFIG_FILES = [
+  "wrangler.jsonc",
+  "wrangler.json",
+  "wrangler.toml"
+];
+var resolveCloudflareAdapterArgs = (context) => {
+  const args = ['prerenderEnvironment: "node"'];
+  const wranglerPath = WRANGLER_CONFIG_FILES.map((file) => join19(context.root, file)).find((file) => existsSync12(file));
+  if (wranglerPath) {
+    let configPath = relative6(context.outDir, wranglerPath);
+    if (!configPath.startsWith(".") && !configPath.startsWith("/")) {
+      configPath = `./${configPath}`;
+    }
+    args.push(`configPath: ${JSON.stringify(configPath)}`);
+  }
+  return `{ ${args.join(", ")} }`;
+};
 var runtimeDependencies = (options) => {
   const { config, needsReact, needsSvelte, needsVue } = options;
   const deps = ["@astrojs/mdx"];
@@ -7748,6 +7788,7 @@ var reactIntegration = (compilerPath) => compilerPath ? `react({ babel: { plugin
 var astroConfigTemplate = (options) => {
   const { context, config, needsReact, pages, dataPath, themePath } = options;
   const {
+    askPath,
     contentRoutes,
     examplesPath,
     examplesThemePath,
@@ -7762,7 +7803,15 @@ var astroConfigTemplate = (options) => {
   const fsAllow = [...new Set([findWorkspaceRoot(context.root), context.root])];
   const adapterImport = server && deployment.adapter ? `import adapter from "${ADAPTER_IMPORTS[deployment.adapter]}";
 ` : "";
-  const adapterArgs = server && deployment.adapter ? ADAPTER_OPTIONS[deployment.adapter] ?? "" : "";
+  const adapterArgs = (() => {
+    if (!server || !deployment.adapter) {
+      return "";
+    }
+    if (deployment.adapter === "cloudflare") {
+      return resolveCloudflareAdapterArgs(context);
+    }
+    return ADAPTER_OPTIONS[deployment.adapter] ?? "";
+  })();
   const adapterOption = server && deployment.adapter ? `
   adapter: adapter(${adapterArgs}),` : "";
   const siteOption = deployment.site ? `
@@ -7849,6 +7898,18 @@ export default defineConfig({
   devToolbar: { enabled: false },
   vite: {
     plugins: [tailwindcss(), prerenderDepsPlugin(), serverAppResolvePlugin()],
+    // Mermaid (lazy-loaded client-side for diagrams) statically imports dayjs as
+    // CJS (\`dayjs/dayjs.min.js\`). In dev, an un-pre-bundled dependency is served
+    // as raw ESM, and that UMD file exposes no \`default\` export, so mermaid
+    // throws on load and diagrams render blank. Forcing mermaid through the dep
+    // optimizer bundles dayjs with correct CJS interop. In a standalone install
+    // Blume's dynamic \`import("mermaid")\` lives inside \`node_modules/blume\`,
+    // which Vite's optimizer scan doesn't crawl, so mermaid is never discovered
+    // on its own — hence the explicit include. mermaid resolves through the
+    // \`blume\` package (it isn't a direct dep of the generated project), so the
+    // nested \`blume > mermaid\` form is required. Production (Rollup) already
+    // handles the interop, so this only affects dev.
+    optimizeDeps: { include: ["blume > mermaid"] },
     // Blume's render-time deps are forced external on both build environments so
     // native bindings resolve at runtime and isolated linkers don't bundle
     // symlinked store copies (which would surface their children as unresolvable
@@ -7867,6 +7928,7 @@ export default defineConfig({
     },
     resolve: {
       alias: {
+        "blume:ask": ${JSON.stringify(askPath)},
         "blume:data": ${JSON.stringify(dataPath)},
         "blume:examples": ${JSON.stringify(examplesPath)},
         "blume:examples-theme": ${JSON.stringify(examplesThemePath)},
@@ -7886,14 +7948,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([join18(context.outDir, ".astro", "**")])},
+        ignored: ${JSON.stringify([join19(context.outDir, ".astro", "**")])},
       },
     },
   },
 });
 `;
 };
-var stagedContentDir = (outDir) => join18(outDir, "content");
+var stagedContentDir = (outDir) => join19(outDir, "content");
 var astroGlobBase = (base) => isAbsolute7(base) ? pathToFileURL2(base).href : base;
 var contentConfigTemplate = (options) => {
   const { context, config } = options;
@@ -8038,6 +8100,22 @@ ${setup}
 ${handler}
 `;
 };
+var askComponentTemplate = (askEnabled) => askEnabled ? `---
+// Generated by Blume. Do not edit.
+import AskAI from "blume/components/islands/AskAI.astro";
+import data from "blume:data";
+
+const { strings } = Astro.props;
+---
+
+<AskAI strings={strings ?? data.ui.ask} suggestions={data.config.ask?.suggestions ?? []} />
+` : `---
+// Generated by Blume. Do not edit.
+// Ask AI is off (\`ai.ask.enabled\`), so the header's Ask trigger renders nothing.
+// Deliberately imports no React island, keeping the JSX renderer out of projects
+// that don't need it.
+---
+`;
 var searchEndpointTemplate = () => `// Generated by Blume. Do not edit.
 import documents from "../generated/search.json";
 
@@ -8160,9 +8238,10 @@ export function getStaticPaths() {
   }));
 }
 
-export function GET({ props }) {
-  const entry = raw[props.route];
-  return new Response(entry ? ${kind === "md" ? "(entry.md ?? entry.mdx)" : "entry.mdx"} : "", {
+export function GET({ props }: { props: { route: string } }) {
+  const entries = raw as Record<string, { md?: string; mdx?: string }>;
+  const entry = entries[props.route];
+  return new Response(entry ? ${kind === "md" ? '(entry.md ?? entry.mdx ?? "")' : '(entry.mdx ?? "")'} : "", {
     headers: { "Content-Type": "text/markdown; charset=utf-8" },
   });
 }
@@ -8206,15 +8285,16 @@ export function getStaticPaths() {
   }));
 }
 
-export function GET({ props }) {
-  return new Response(feeds[props.section] ?? "", {
+export function GET({ props }: { props: { section: string } }) {
+  const bySection = feeds as Record<string, string>;
+  return new Response(bySection[props.section] ?? "", {
     headers: { "Content-Type": "application/rss+xml; charset=utf-8" },
   });
 }
 `;
 var ogEndpointTemplate = (customRoutes = []) => `// Generated by Blume. Do not edit.
 import { renderOgImage } from "blume/og";
-import data from "../../generated/data.json";
+import data from "blume:data";
 
 export const prerender = true;
 
@@ -8222,9 +8302,9 @@ export const prerender = true;
 const customRoutes = ${JSON.stringify(customRoutes)};
 
 export function getStaticPaths() {
-  const seen = new Set();
-  const paths = [];
-  const add = (slug, title) => {
+  const seen = new Set<string>();
+  const paths: { params: { slug: string }; props: { title: string } }[] = [];
+  const add = (slug: string, title: string) => {
     if (seen.has(slug)) {
       return;
     }
@@ -8257,17 +8337,18 @@ const siteHost = (() => {
   }
 })();
 
-export async function GET({ props }) {
+export async function GET({ props }: { props: { title: string } }) {
   const png = await renderOgImage({
-    accent: data.config.theme.accent.light,
+    accent: data.config.og.palette?.accent ?? data.config.theme.accent.light,
     brand: data.config.title,
     description: data.config.description,
-    logo: data.config.logo?.svg,
+    logo: data.config.og.logo,
+    palette: data.config.og.palette,
     repo: repoSlug,
     site: siteHost,
     title: props.title,
   });
-  return new Response(png, {
+  return new Response(new Uint8Array(png), {
     headers: {
       "Cache-Control": "public, max-age=31536000, immutable",
       "Content-Type": "image/png",
@@ -8317,10 +8398,6 @@ const htmlLang = i18n ? i18n.defaultLocale : "en";
 </ReferenceLayout>
 `;
 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} suggestions={data.config.ask?.suggestions ?? []} />` : "";
   const mathImport = options.mathEnabled ? `import Math from "blume/components/content/Math.astro";
 ` : "";
   const mathEntry = options.mathEnabled ? `Math,
@@ -8330,10 +8407,10 @@ var catchAllPageTemplate = (options) => {
   return `---
 // Generated by Blume. Do not edit.
 import { getEntry, render } from "astro:content";
+import type { CollectionKey } from "astro:content";
 import RootLayout from "blume/components/layout/RootLayout.astro";
 import { withBase } from "blume/components/islands/base-path.ts";
 import { resolveSlot } from "blume/components/layout/overrides.ts";
-${askImport}
 import Accordion from "blume/components/content/Accordion.astro";
 import AccordionItem from "blume/components/content/AccordionItem.astro";
 import AutoTypeTable from "blume/components/content/AutoTypeTable.astro";
@@ -8374,7 +8451,7 @@ import ApiTagOperations from "blume/components/openapi/ApiTagOperations.astro";
 import Operation from "blume/components/openapi/Operation.astro";
 ${mathImport}import { mdxComponents as userMdx, layoutOverrides } from "../generated/components.ts";
 import { islandComponents } from "../generated/islands.ts";
-import data from "../generated/data.json";
+import data from "blume:data";
 
 const Color = Object.assign(ColorRoot, { Item: ColorItem, Row: ColorRow });
 const Tree = Object.assign(TreeRoot, { File: TreeFile, Folder: TreeFolder });
@@ -8443,7 +8520,7 @@ export function getStaticPaths() {
 }
 
 const { entryId, collection, route, title, indexable, editUrl, lastModified, locale, alternates, fallback } = Astro.props;
-const entry = await getEntry(collection, entryId);
+const entry = await getEntry(collection as CollectionKey, entryId);
 if (!entry) {
   return new Response(null, { status: 404 });
 }
@@ -8478,18 +8555,18 @@ const canonical =
 // Locale resolution. With i18n on, pick the active locale's nav + dictionary,
 // build hreflang alternates, and derive the language-switcher targets.
 const i18n = data.config.i18n;
-const localePrefix = (codeArg) =>
+const localePrefix = (codeArg: string) =>
   i18n && codeArg === i18n.defaultLocale && i18n.hideDefaultLocalePrefix
     ? ""
     : \`/\${codeArg}\`;
-const localizeRoute = (logical, codeArg) => {
+const localizeRoute = (logical: string, codeArg: string) => {
   const prefix = localePrefix(codeArg);
   if (!prefix) {
     return logical;
   }
   return logical === "/" ? prefix : \`\${prefix}\${logical}\`;
 };
-const stripLocale = (path, codeArg) => {
+const stripLocale = (path: string, codeArg: string) => {
   const prefix = localePrefix(codeArg);
   return prefix && path.startsWith(prefix) ? path.slice(prefix.length) || "/" : path;
 };
@@ -8506,7 +8583,7 @@ const contentLocale =
 const contentDir = i18n
   ? (i18n.locales.find((l) => l.code === contentLocale)?.dir ?? "ltr")
   : "ltr";
-const absolute = (path) => {
+const absolute = (path: string) => {
   const p = withBase(path);
   return base + (p === "/" ? "" : p);
 };
@@ -8570,7 +8647,6 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   canonical={canonical}
   editUrl={editUrl}
   feedback={data.config.feedback}
-  askEnabled={${options.askEnabled}}
   exportPdf={${options.exportPdf}}
   exportEpub={${options.exportEpub}}
   feeds={data.feeds}
@@ -8580,7 +8656,7 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   lastModified={lastModified}
   noindex={seo.noindex}
   structuredDataEnabled={data.config.structuredData}
->${askSlot}
+>
   <h1>{title}</h1>
   {frontmatter.description && <p class="text-lg text-muted-foreground">{frontmatter.description}</p>}
   <Content components={components} />
@@ -8588,10 +8664,6 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
 `;
 };
 var changelogIndexTemplate = (options) => {
-  const askImport = options.askEnabled ? `import AskAI from "blume/components/islands/AskAI.astro";
-` : "";
-  const askSlot = options.askEnabled ? `
-  <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: pageTitle } }}` : "";
   const stagedSpread = options.staged ? `
@@ -8604,14 +8676,15 @@ import Update from "blume/components/content/Update.astro";
 import { withBase } from "blume/components/islands/base-path.ts";
 import { resolveSlot } from "blume/components/layout/overrides.ts";
 import { layoutOverrides } from "../generated/components.ts";
-${askImport}import data from "../generated/data.json";
+import data from "blume:data";
 
 export const prerender = true;
 
-const entryDate = (entry) =>
-  entry.data.date ?? entry.data.changelog?.date ?? null;
+const entryDate = (entry: {
+  data: { date?: string | null; changelog?: { date?: string | null } | null };
+}) => entry.data.date ?? entry.data.changelog?.date ?? null;
 
-const toTime = (value) => {
+const toTime = (value: string | null | undefined) => {
   if (!value) {
     return 0;
   }
@@ -8619,7 +8692,7 @@ const toTime = (value) => {
   return Number.isNaN(date.getTime()) ? 0 : date.getTime();
 };
 
-const formatDate = (value) => {
+const formatDate = (value: string | null | undefined) => {
   if (!value) {
     return;
   }
@@ -8632,14 +8705,14 @@ const formatDate = (value) => {
       }).format(date);
 };
 
-const slugify = (text) =>
+const slugify = (text: string) =>
   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 majorVersion = (version: string | null | undefined) => {
   const match = /(\\d+)\\.\\d+\\.\\d+/.exec(String(version ?? ""));
   return match ? Number(match[1]) : null;
 };
@@ -8671,7 +8744,7 @@ const items = await Promise.all(
     return {
       Content: (await render(entry)).Content,
       date: formatDate(entryDate(entry)),
-      href: routeByEntry.get(entry.id) ?? null,
+      href: routeByEntry.get(entry.id) ?? undefined,
       id: slugify(label),
       label,
       major: majorVersion(entry.data.changelog?.version),
@@ -8700,7 +8773,9 @@ for (const item of items) {
 // 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)
+  ? [...new Set(items.map((item) => item.major))]
+      .filter((major): major is number => major !== null)
+      .toSorted((a, b) => b - a)
   : [];
 const paginate = majors.length > 1;
 const majorGroups = majors.map((major) => ({
@@ -8773,14 +8848,13 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   ogImage={null}
   x={data.config.x}
   canonical={canonical}
-  askEnabled={${options.askEnabled}}
   exportPdf={${options.exportPdf}}
   exportEpub={${options.exportEpub}}
   feeds={data.feeds}
   siteUrl={data.config.site}
   noindex={false}
   structuredDataEnabled={data.config.structuredData}
->${askSlot}
+>
   <h1>{changelogTitle}</h1>
   {
     items.length === 0 ? (
@@ -8839,7 +8913,7 @@ var notFoundPageTemplate = () => `---
 // Generated by Blume. Do not edit. Override by adding \`pages/404.astro\`.
 import PageLayout from "blume/components/layout/PageLayout.astro";
 import { withBase } from "blume/components/islands/base-path.ts";
-import data from "../generated/data.json";
+import data from "blume:data";
 
 export const prerender = true;
 
@@ -8956,7 +9030,10 @@ export const getStaticPaths = () =>
   Object.keys(examples).map((path) => ({ params: { path } }));
 
 const { path } = Astro.params;
-const entry = examples[path];
+const entry = path ? examples[path] : undefined;
+if (!entry) {
+  return new Response(null, { status: 404 });
+}
 const Example = entry.Component;
 ---
 
@@ -9000,11 +9077,24 @@ const Example = entry.Component;
 var envTemplate = () => `/// <reference path="../.astro/types.d.ts" />
 /// <reference types="astro/client" />
 
+declare module "blume:ask" {
+  const Ask: typeof import("blume/components/islands/AskAI.astro").default;
+  export default Ask;
+}
+
 declare module "blume:data" {
   const data: import("blume").BlumeData;
   export default data;
 }
 
+declare module "blume:examples" {
+  type Examples = typeof import("./generated/examples.ts").examples;
+  export const examples: Record<string, Examples[keyof Examples]>;
+  export const examplesBase: string;
+}
+
+declare module "blume:examples-theme";
+
 declare module "blume:openapi" {
   const specs: import("blume/openapi/model.ts").OpenApiData;
   export default specs;
@@ -9135,7 +9225,7 @@ var specConfiguration = async (spec, root) => {
   if (URL_SPEC2.test(spec)) {
     return { config: { url: spec } };
   }
-  const absolute = isAbsolute8(spec) ? spec : join19(root, spec);
+  const absolute = isAbsolute8(spec) ? spec : join20(root, spec);
   try {
     return { config: { content: await readFile8(absolute, "utf-8") } };
   } catch {
@@ -9201,6 +9291,13 @@ var buildReferenceFiles = async (options) => {
 // src/theme/entry.ts
 var DARK_VARIANT = `/* Dark mode is driven by data-theme on the <html> element. */
 @custom-variant dark (&:where([data-theme="dark"], [data-theme="dark"] *));`;
+var COLOR_SCHEME_DEFAULTS = `:root {
+  color-scheme: light;
+}
+
+:root[data-theme="dark"] {
+  color-scheme: dark;
+}`;
 var TOKEN_DEFAULTS = `:root {
   --blume-background: oklch(1 0 0);
   --blume-background-image: none;
@@ -9306,6 +9403,8 @@ ${options.sources.map((source) => `@source "${source}";`).join(`
 
 ${DARK_VARIANT}
 
+${COLOR_SCHEME_DEFAULTS}
+
 ${TOKEN_DEFAULTS}
 
 ${THEME_MAPPING}
@@ -9551,13 +9650,16 @@ blume-diff {
 
 /* Language icon (simple-icons) sits at the header's left edge; the label shifts
    right to make room. Injected at build time by the language-icon transformer.
-   Shown only for top-level prose blocks, which have a header — flush code in
-   tabs and API panels is nested deeper, so the child combinator skips it. */
+   The icon is gated on data-language (the header bar), not just data-icon: the
+   transformer runs whenever icons are on, but a header-less standalone
+   CodeBlock (no title) never gets data-language, so without this gate the
+   absolutely-positioned icon would overlap the first code line. Fenced code
+   and titled blocks always have a header, so the icon shows there. */
 .blume-lang-icon {
   display: none;
 }
 
-.prose > :where(pre[data-icon]) > .blume-lang-icon {
+.prose > :where(pre[data-language][data-icon]) > .blume-lang-icon {
   color: var(--blume-muted-foreground);
   display: block;
   height: 0.875rem;
@@ -9567,7 +9669,7 @@ blume-diff {
   width: 0.875rem;
 }
 
-.prose > :where(pre[data-icon])::before {
+.prose > :where(pre[data-language][data-icon])::before {
   padding-left: 2.5rem;
 }
 
@@ -9618,11 +9720,40 @@ blume-diff {
   font-size: 0.8125rem;
 }
 
+/* Scroll wide tables in place; the wrapper is added by the blume:table-wrap hast
+   plugin. The border+radius frames the scroll viewport so a clipped wide table
+   reads as scrollable rather than cut off, and carries the table's vertical
+   rhythm (the inner table's own margin is zeroed so it fills the frame). */
+.blume-table-scroll {
+  overflow-x: auto;
+  -webkit-overflow-scrolling: touch;
+  margin: 1.5rem 0;
+  border: 1px solid var(--blume-border);
+  border-radius: var(--blume-radius);
+}
+.blume-table-scroll > table {
+  margin: 0;
+}
+/* Restore inner padding on every cell. Typography zeroes the first/last cell's
+   inline padding so a borderless table aligns to the prose margin; inside the
+   framed wrapper that leaves edge text touching the border. The :is() selector
+   outweighs Typography's :where()-scoped rules so the outer columns get it too. */
+.blume-table-scroll :is(th, td) {
+  padding: 0.5rem 0.75rem;
+}
+/* Keep column labels on one line so a two-word header does not wrap into a
+   ragged stack; the table just scrolls a little wider instead. Body cells keep
+   wrapping so a wide table stays a scroll away, not an endless horizontal run. */
+.blume-table-scroll th {
+  white-space: nowrap;
+}
+
 /* GFM renders cells as <td><code> directly, which the descendant form alone
    never matches (a cell is not its own descendant). */
 .prose :where(td, th) > code,
 .prose :where(td, th) :not(pre) > code {
-  white-space: nowrap;
+  overflow-wrap: break-word;
+  white-space: normal;
 }
 
 blume-tabs pre,
@@ -9862,6 +9993,8 @@ ${options.sources.map((source) => `@source "${source}";`).join(`
 
 ${DARK_VARIANT}
 
+${COLOR_SCHEME_DEFAULTS}
+
 ${TOKEN_DEFAULTS}
 
 ${THEME_MAPPING}
@@ -9882,7 +10015,7 @@ ${options.userCss}
 `;
 
 // src/theme/twoslash.ts
-import { readFileSync as readFileSync6 } from "node:fs";
+import { readFileSync as readFileSync7 } from "node:fs";
 import { createRequire as createRequire4 } from "node:module";
 var require2 = createRequire4(import.meta.url);
 var OVERRIDES = `
@@ -9949,14 +10082,15 @@ var OVERRIDES = `
 `;
 var twoslashCss = () => {
   const file = require2.resolve("@shikijs/twoslash/style-rich.css");
-  return `${readFileSync6(file, "utf-8")}
+  return `${readFileSync7(file, "utf-8")}
 ${OVERRIDES}`;
 };
 
 // src/astro/component-slots.ts
 var EMPTY_MODULE = `// Generated by Blume. Do not edit.
-export const mdxComponents = {};
-export const layoutOverrides = {};
+import type { ComponentOverride } from "blume/core/define-components.ts";
+export const mdxComponents: Record<string, ComponentOverride> = {};
+export const layoutOverrides: Record<string, ComponentOverride> = {};
 `;
 var attributeValue = (value) => value.replaceAll(/["\n\r]/gu, " ").trim();
 var CLIENT_LOAD = "client:load";
@@ -10054,12 +10188,12 @@ export const layoutOverrides = { ...(overrides.layout ?? {})${layoutEntries.leng
 
 // src/astro/examples.ts
 import { readFile as readFile10 } from "node:fs/promises";
-import { join as join21, relative as relative7 } from "pathe";
+import { join as join22, relative as relative7 } from "pathe";
 import { glob as glob4 } from "tinyglobby";
 
 // src/astro/islands.ts
 import { readFile as readFile9 } from "node:fs/promises";
-import { basename, join as join20 } from "pathe";
+import { basename, join as join21 } from "pathe";
 import { glob as glob3 } from "tinyglobby";
 var DEFAULT_CLIENT = "visible";
 var VALID_MODES = new Set([
@@ -10088,7 +10222,7 @@ var readClientMode = (source, file, warnings) => {
   return mode;
 };
 var discoverIslands = async (root) => {
-  const dir = join20(root, "islands");
+  const dir = join21(root, "islands");
   const matches = await glob3(["**/*.{jsx,svelte,tsx,vue}"], {
     absolute: true,
     cwd: dir,
@@ -10151,7 +10285,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 = join21(root, base);
+  const dir = join22(root, base);
   const matches = await glob4([rest], {
     absolute: true,
     cwd: dir,
@@ -10191,10 +10325,10 @@ var discoverExamples = async (root, pattern = "examples") => {
 };
 
 // src/astro/generate.ts
-var BLUME_SRC = join22(packageRoot(), "src");
+var BLUME_SRC = join23(packageRoot(), "src");
 var canResolveFrom = (fromDir, spec) => {
   try {
-    createRequire5(pathToFileURL3(join22(fromDir, "_.js")).href).resolve(spec);
+    createRequire5(pathToFileURL3(join23(fromDir, "_.js")).href).resolve(spec);
     return true;
   } catch {
     return false;
@@ -10205,7 +10339,7 @@ var resolveReactCompiler = (config, needsReact) => {
     return null;
   }
   try {
-    return createRequire5(pathToFileURL3(join22(packageRoot(), "_.js")).href).resolve("babel-plugin-react-compiler");
+    return createRequire5(pathToFileURL3(join23(packageRoot(), "_.js")).href).resolve("babel-plugin-react-compiler");
   } catch {
     return null;
   }
@@ -10215,15 +10349,15 @@ var reactCompilerWarnings = (config, needsReact, compilerPath) => needsReact &&
 ] : [];
 var resolvedAstroPath = (fromDir) => {
   try {
-    const pkg = createRequire5(pathToFileURL3(join22(fromDir, "_.js")).href).resolve("astro/package.json");
+    const pkg = createRequire5(pathToFileURL3(join23(fromDir, "_.js")).href).resolve("astro/package.json");
     return realpathSync(pkg);
   } catch {
     return null;
   }
 };
 var blumeDepsDir = (pkgDir = packageRoot()) => {
-  const candidates = [join22(pkgDir, "node_modules"), dirname8(pkgDir)];
-  return candidates.find((dir) => existsSync12(join22(dir, "astro"))) ?? null;
+  const candidates = [join23(pkgDir, "node_modules"), dirname8(pkgDir)];
+  return candidates.find((dir) => existsSync13(join23(dir, "astro"))) ?? null;
 };
 var linkDepsJunction = async (link, depsDir) => {
   let existing;
@@ -10246,7 +10380,7 @@ var readPkgVersion = (pkgJsonPath) => {
     return null;
   }
   try {
-    return JSON.parse(readFileSync7(pkgJsonPath, "utf-8")).version ?? null;
+    return JSON.parse(readFileSync8(pkgJsonPath, "utf-8")).version ?? null;
   } catch {
     return null;
   }
@@ -10268,8 +10402,8 @@ var ensureDepsLink = async (outDir, pkgDir = packageRoot()) => {
   if (blumeAstro && outDirAstro === blumeAstro) {
     return null;
   }
-  if (existsSync12(join22(depsDir, "@astrojs", "mdx"))) {
-    await linkDepsJunction(join22(outDir, "node_modules"), depsDir);
+  if (existsSync13(join23(depsDir, "@astrojs", "mdx"))) {
+    await linkDepsJunction(join23(outDir, "node_modules"), depsDir);
     return null;
   }
   return astroConflictWarning(blumeAstro, outDirAstro);
@@ -10301,14 +10435,14 @@ var deploymentAdapterWarnings = (deployment, root) => {
   }
   return [];
 };
-var examplesCssFile = (root, config) => config.examples.css ? join22(root, config.examples.css) : null;
+var examplesCssFile = (root, config) => config.examples.css ? join23(root, config.examples.css) : null;
 var writeExamplesPreview = async (options) => {
   const { config, hasExamples, root, srcDir, write } = options;
   if (hasExamples) {
-    await write(join22(srcDir, "pages", ...config.basePath.split("/").filter(Boolean), "blume-examples", "[...path].astro"), examplesPageTemplate());
+    await write(join23(srcDir, "pages", ...config.basePath.split("/").filter(Boolean), "blume-examples", "[...path].astro"), examplesPageTemplate());
   }
   const cssFile = examplesCssFile(root, config);
-  return cssFile && !existsSync12(cssFile) ? [
+  return cssFile && !existsSync13(cssFile) ? [
     `examples.css points at "${config.examples.css}", which doesn't exist; previews render without it.`
   ] : [];
 };
@@ -10337,7 +10471,7 @@ var detectUsesMath = async (root, staged = []) => {
     ignore: ["**/node_modules/**", "**/.blume/**", "**/dist/**"],
     onlyFiles: true
   });
-  const contents = await Promise.all(files.map((file) => readOptional(join22(root, file))));
+  const contents = await Promise.all(files.map((file) => readOptional(join23(root, file))));
   return [...contents, ...staged].some(containsMath);
 };
 var writeIfChanged = async (path, content) => {
@@ -10389,14 +10523,46 @@ var writeStagedContent = async (out, staged) => {
   const contentDir = stagedContentDir(out);
   const written = new Set;
   await Promise.all([...staged].map(async ([entryId, text]) => {
-    const path = join22(contentDir, entryId);
+    const path = join23(contentDir, entryId);
     written.add(normalize3(path));
     await writeIfChanged(path, text);
   }));
-  if (existsSync12(contentDir)) {
+  if (existsSync13(contentDir)) {
     await pruneOrphans(contentDir, written);
   }
 };
+var SVG_ROOT = /<svg\b(?<attributes>[^>]*)>/u;
+var SVG_WIDTH = /\bwidth\s*=\s*["'](?<value>[^"']+)["']/u;
+var SVG_HEIGHT = /\bheight\s*=\s*["'](?<value>[^"']+)["']/u;
+var SVG_LENGTH = /^\s*(?<value>[\d.]+)(?:px)?\s*$/u;
+var SVG_VIEW_BOX = /\bviewBox\s*=\s*["'][\d.-]+[\s,]+[\d.-]+[\s,]+(?<width>[\d.]+)[\s,]+(?<height>[\d.]+)["']/u;
+var parseSvgLength = (value) => {
+  const length = Number(value?.match(SVG_LENGTH)?.groups?.value);
+  return length > 0 ? length : undefined;
+};
+var svgDimensions = (svg) => {
+  const attributes = svg?.match(SVG_ROOT)?.groups?.attributes;
+  const width = parseSvgLength(attributes?.match(SVG_WIDTH)?.groups?.value);
+  const height = parseSvgLength(attributes?.match(SVG_HEIGHT)?.groups?.value);
+  if (width && height) {
+    return { height, width };
+  }
+  const viewBox = attributes?.match(SVG_VIEW_BOX);
+  const viewBoxWidth = Number(viewBox?.groups?.width);
+  const viewBoxHeight = Number(viewBox?.groups?.height);
+  return viewBoxWidth > 0 && viewBoxHeight > 0 ? { height: viewBoxHeight, width: viewBoxWidth } : undefined;
+};
+var readLogoSvg = (project, source) => {
+  if (!source?.toLowerCase().endsWith(".svg")) {
+    return;
+  }
+  const rel = source.replace(/^\//u, "");
+  const file = [
+    join23(project.context.root, "public", rel),
+    join23(project.context.root, rel)
+  ].find((path) => existsSync13(path));
+  return file ? readFileSync8(file, "utf-8") : undefined;
+};
 var resolveLogo = (project) => {
   const { logo } = project.config;
   if (!logo) {
@@ -10409,17 +10575,15 @@ var resolveLogo = (project) => {
   const dark = image?.dark ?? image?.light;
   const alt = image?.alt ?? "";
   const brandHref = href ?? "/";
-  if (light && light === dark && light.toLowerCase().endsWith(".svg")) {
-    const rel = light.replace(/^\//u, "");
-    const file = [
-      join22(project.context.root, "public", rel),
-      join22(project.context.root, rel)
-    ].find((path) => existsSync12(path));
-    if (file) {
-      return { alt, href: brandHref, svg: readFileSync7(file, "utf-8"), text };
-    }
+  const lightSvg = readLogoSvg(project, light);
+  const darkSvg = dark === light ? lightSvg : readLogoSvg(project, dark);
+  if (light && light === dark && lightSvg) {
+    return { alt, href: brandHref, svg: lightSvg, text };
   }
-  return { alt, dark, href: brandHref, light, text };
+  const lightDimensions = svgDimensions(lightSvg);
+  const darkDimensions = svgDimensions(darkSvg);
+  const dimensions = lightDimensions || darkDimensions ? { dark: darkDimensions, light: lightDimensions } : undefined;
+  return { alt, dark, dimensions, href: brandHref, light, text };
 };
 var FAVICON_CANDIDATES = [
   "icon.svg",
@@ -10440,9 +10604,9 @@ var faviconType = (name) => {
   const ext = name.split(".").pop()?.toLowerCase();
   return ext ? FAVICON_TYPES[ext] : undefined;
 };
-var inlineDataUri = (file, type) => `data:${type};base64,${readFileSync7(file).toString("base64")}`;
+var inlineDataUri = (file, type) => `data:${type};base64,${readFileSync8(file).toString("base64")}`;
 var defaultFavicon = () => ({
-  href: inlineDataUri(join22(BLUME_SRC, "assets", "icon.png"), "image/png"),
+  href: inlineDataUri(join23(BLUME_SRC, "assets", "icon.png"), "image/png"),
   type: "image/png"
 });
 var APPLE_ICON_CANDIDATES = [
@@ -10454,13 +10618,13 @@ var APPLE_ICON_CANDIDATES = [
 var resolveIconFile = (project, candidates) => {
   const { root } = project.context;
   for (const name of candidates) {
-    if (existsSync12(join22(root, "public", name))) {
+    if (existsSync13(join23(root, "public", name))) {
       return { href: `/${name}`, type: faviconType(name) };
     }
   }
   for (const name of candidates) {
-    const file = join22(root, name);
-    if (existsSync12(file)) {
+    const file = join23(root, name);
+    if (existsSync13(file)) {
       const type = faviconType(name);
       return { href: inlineDataUri(file, type ?? "image/x-icon"), type };
     }
@@ -10489,6 +10653,8 @@ var buildRuntimeData = (project) => {
   const { github } = config;
   const repoUrl = github ? `https://github.com/${github.owner}/${github.repo}` : null;
   const editBase = github ? `${repoUrl}/edit/${github.branch}` : null;
+  const logo = resolveLogo(project);
+  const ogLogo = config.seo.og.logo ? resolveOgLogo(project, config.seo.og.logo) : logo?.svg;
   const editUrlFor = (sourcePath) => {
     if (!(editBase && sourcePath)) {
       return null;
@@ -10498,10 +10664,9 @@ var buildRuntimeData = (project) => {
     return `${editBase}/${editPath}`;
   };
   const { i18n } = config;
-  const withReferenceTabs = (nav) => ({
+  const withRepoUrl = (nav) => ({
     ...nav,
-    repoUrl: config.navigation.repo && repoUrl ? repoUrl : null,
-    tabs: [...nav.tabs, ...referenceTabs(config)]
+    repoUrl: config.navigation.repo && repoUrl ? repoUrl : null
   });
   const uiByLocale = i18n ? Object.fromEntries(i18n.locales.map(({ code }) => [
     code,
@@ -10516,7 +10681,7 @@ var buildRuntimeData = (project) => {
   }) : EN_UI;
   const navigationByLocale = i18n ? Object.fromEntries(i18n.locales.map(({ code }) => [
     code,
-    withReferenceTabs(graph.navigationByLocale[code] ?? {
+    withRepoUrl(graph.navigationByLocale[code] ?? {
       featured: [],
       selectors: [],
       sidebar: [],
@@ -10546,9 +10711,16 @@ var buildRuntimeData = (project) => {
         }))
       } : null,
       imageZoom: config.markdown.imageZoom,
-      logo: resolveLogo(project),
-      mcp: config.mcp.enabled ? { name: config.mcp.name ?? config.title, route: config.mcp.route } : null,
-      og: { enabled: config.seo.og.enabled ?? false },
+      logo,
+      mcp: config.ai.mcp.enabled ? {
+        name: config.ai.mcp.name ?? config.title,
+        route: config.ai.mcp.route
+      } : null,
+      og: {
+        enabled: config.seo.og.enabled ?? false,
+        logo: ogLogo,
+        palette: config.seo.og.palette
+      },
       repoUrl,
       search: {
         enabled: config.search.provider !== "none",
@@ -10566,7 +10738,7 @@ var buildRuntimeData = (project) => {
       title: feed.title
     })),
     fontCssVars: configuredCssVars(config.theme.fonts),
-    navigation: withReferenceTabs(graph.navigation),
+    navigation: withRepoUrl(graph.navigation),
     navigationByLocale,
     routes: manifest.routes.map((route) => ({
       alternates: route.alternates,
@@ -10591,8 +10763,8 @@ var buildRuntimeData = (project) => {
 };
 var planMcp = (project, srcDir, userPages) => {
   const { config } = project;
-  const { route } = config.mcp;
-  const dir = join22(srcDir, "blume-mcp");
+  const { route } = config.ai.mcp;
+  const dir = join23(srcDir, "blume-mcp");
   const base = {
     dir,
     discoveryPages: [],
@@ -10601,14 +10773,14 @@ var planMcp = (project, srcDir, userPages) => {
     srcDir,
     warnings: []
   };
-  if (!config.mcp.enabled) {
+  if (!config.ai.mcp.enabled) {
     return base;
   }
   if (routeIsTaken(userPages, project.graph.pages, route)) {
     return {
       ...base,
       warnings: [
-        `MCP server route "${route}" is already used by a content or custom page; the MCP server was not generated. Set a different "mcp.route" in blume.config.ts.`
+        `MCP server route "${route}" is already used by a content or custom page; the MCP server was not generated. Set a different "ai.mcp.route" in blume.config.ts.`
       ]
     };
   }
@@ -10616,11 +10788,11 @@ var planMcp = (project, srcDir, userPages) => {
     ...base,
     discoveryPages: [
       {
-        entrypoint: join22(dir, "discovery.ts"),
+        entrypoint: join23(dir, "discovery.ts"),
         pattern: "/.well-known/mcp.json"
       },
       {
-        entrypoint: join22(dir, "server-card.ts"),
+        entrypoint: join23(dir, "server-card.ts"),
         pattern: "/.well-known/mcp/server-card.json"
       }
     ],
@@ -10640,11 +10812,11 @@ var writeMcpFiles = async (project, plan, write) => {
     version: data.version
   };
   await Promise.all([
-    write(join22(plan.srcDir, "generated", "mcp-data.json"), `${JSON.stringify(data)}
+    write(join23(plan.srcDir, "generated", "mcp-data.json"), `${JSON.stringify(data)}
 `),
-    write(join22(plan.srcDir, "pages", mcpPageFile(plan.route)), mcpEndpointTemplate(plan.route)),
-    write(join22(plan.dir, "discovery.ts"), staticJsonEndpointTemplate(buildMcpDiscovery(discoveryInput))),
-    write(join22(plan.dir, "server-card.ts"), staticJsonEndpointTemplate(buildMcpServerCard(discoveryInput)))
+    write(join23(plan.srcDir, "pages", mcpPageFile(plan.route)), mcpEndpointTemplate(plan.route)),
+    write(join23(plan.dir, "discovery.ts"), staticJsonEndpointTemplate(buildMcpDiscovery(discoveryInput))),
+    write(join23(plan.dir, "server-card.ts"), staticJsonEndpointTemplate(buildMcpServerCard(discoveryInput)))
   ]);
 };
 var writeAskFiles = async (project, srcDir, write) => {
@@ -10654,16 +10826,16 @@ var writeAskFiles = async (project, srcDir, write) => {
   }
   const grounded = ask.provider !== "inkeep";
   if (grounded) {
-    await write(join22(srcDir, "generated", "ask-data.json"), `${JSON.stringify(await buildAskData(project))}
+    await write(join23(srcDir, "generated", "ask-data.json"), `${JSON.stringify(await buildAskData(project))}
 `);
   }
-  await write(join22(srcDir, "pages", "api", "ask.ts"), askEndpointTemplate(resolveAskBackend(ask), grounded));
+  await write(join23(srcDir, "pages", "api", "ask.ts"), askEndpointTemplate(resolveAskBackend(ask), grounded));
 };
 var writeNotFoundPage = async (write, srcDir, pages, contentPages) => {
   if (routeIsTaken(pages, contentPages, "/404")) {
     return;
   }
-  await write(join22(srcDir, "pages", "404.astro"), notFoundPageTemplate());
+  await write(join23(srcDir, "pages", "404.astro"), notFoundPageTemplate());
 };
 var buildComponentSlots = async (componentsFile) => {
   const analysis = componentsFile ? analyzeComponentOverrides(await readFile11(componentsFile, "utf-8"), componentsFile) : null;
@@ -10676,13 +10848,14 @@ var buildComponentSlots = async (componentsFile) => {
 var generateRuntime = async (project) => {
   const { context, config } = project;
   const out = context.outDir;
-  const srcDir = join22(out, "src");
-  const dataPath = join22(srcDir, "generated", "data.json");
-  const themePath = join22(srcDir, "generated", "app.css");
-  const searchClientPath = join22(srcDir, "generated", "search-client.ts");
-  const examplesPath = join22(srcDir, "generated", "examples.ts");
-  const examplesThemePath = join22(srcDir, "generated", "examples.css");
-  const openapiPath = join22(srcDir, "generated", "openapi.json");
+  const srcDir = join23(out, "src");
+  const askPath = join23(srcDir, "generated", "Ask.astro");
+  const dataPath = join23(srcDir, "generated", "data.json");
+  const themePath = join23(srcDir, "generated", "app.css");
+  const searchClientPath = join23(srcDir, "generated", "search-client.ts");
+  const examplesPath = join23(srcDir, "generated", "examples.ts");
+  const examplesThemePath = join23(srcDir, "generated", "examples.css");
+  const openapiPath = join23(srcDir, "generated", "openapi.json");
   const written = new Set;
   const write = (path, content) => {
     written.add(normalize3(path));
@@ -10733,8 +10906,9 @@ var generateRuntime = async (project) => {
   const hasFilesystemSource = project.sources.some((source) => !source.staged);
   const [structural] = await Promise.all([
     Promise.all([
-      write(join22(out, "astro.config.mjs"), astroConfigTemplate({
+      write(join23(out, "astro.config.mjs"), astroConfigTemplate({
         aliases: resolveTsconfigAliases(context.root),
+        askPath,
         config,
         contentRoutes: project.manifest.routes.map((route) => route.path),
         context,
@@ -10750,26 +10924,26 @@ var generateRuntime = async (project) => {
         searchClientPath,
         themePath
       })),
-      write(join22(out, "package.json"), runtimePackageTemplate(runtimeDependencies({ config, needsReact, needsSvelte, needsVue }))),
-      write(join22(out, "tsconfig.json"), runtimeTsconfigTemplate()),
-      write(join22(srcDir, "env.d.ts"), envTemplate()),
-      write(join22(srcDir, "content.config.ts"), contentConfigTemplate({
+      write(join23(out, "package.json"), runtimePackageTemplate(runtimeDependencies({ config, needsReact, needsSvelte, needsVue }))),
+      write(join23(out, "tsconfig.json"), runtimeTsconfigTemplate()),
+      write(join23(srcDir, "env.d.ts"), envTemplate()),
+      write(join23(srcDir, "content.config.ts"), contentConfigTemplate({
         collection: resolveDocsCollection(config, context),
         config,
         context,
         filesystem: hasFilesystemSource,
         staged: hasStaged
       })),
-      write(join22(srcDir, "pages", "[...slug].astro"), catchAllPageTemplate({
-        askEnabled,
+      write(join23(srcDir, "pages", "[...slug].astro"), catchAllPageTemplate({
         exportEpub,
         exportPdf,
         mathEnabled: usesMath,
         needsReact
       })),
-      write(join22(srcDir, "generated", "components.ts"), slotPlan.module),
-      write(join22(srcDir, "generated", "islands.ts"), islandMapTemplate(islandDiscovery.islands)),
-      write(join22(srcDir, "generated", "examples.ts"), exampleMapTemplate(exampleDiscovery.examples, config.basePath)),
+      write(askPath, askComponentTemplate(askEnabled)),
+      write(join23(srcDir, "generated", "components.ts"), slotPlan.module),
+      write(join23(srcDir, "generated", "islands.ts"), islandMapTemplate(islandDiscovery.islands)),
+      write(join23(srcDir, "generated", "examples.ts"), exampleMapTemplate(exampleDiscovery.examples, config.basePath)),
       write(examplesThemePath, examplesEntryTemplate({
         configTokens: buildThemeCss(config.theme),
         sources: [`${context.root}/**/*.{astro,jsx,svelte,ts,tsx,vue}`],
@@ -10785,18 +10959,17 @@ var generateRuntime = async (project) => {
         userTheme
       }))
     ]),
-    Promise.all(islandDiscovery.islands.map((island) => write(join22(srcDir, "generated", "islands", `${island.name}.astro`), islandWrapperTemplate(island)))),
-    Promise.all(slotPlan.wrappers.map((wrapper) => write(join22(srcDir, "generated", "component-slots", `${wrapper.name}.astro`), wrapper.content))),
-    Promise.all(exampleDiscovery.examples.map((example) => write(join22(srcDir, "generated", "examples", `${exampleSlug(example.path)}.astro`), exampleWrapperTemplate(example)))),
+    Promise.all(islandDiscovery.islands.map((island) => write(join23(srcDir, "generated", "islands", `${island.name}.astro`), islandWrapperTemplate(island)))),
+    Promise.all(slotPlan.wrappers.map((wrapper) => write(join23(srcDir, "generated", "component-slots", `${wrapper.name}.astro`), wrapper.content))),
+    Promise.all(exampleDiscovery.examples.map((example) => write(join23(srcDir, "generated", "examples", `${exampleSlug(example.path)}.astro`), exampleWrapperTemplate(example)))),
     writeAskFiles(project, srcDir, write),
     writeMcpFiles(project, mcp, write)
   ]);
   if (config.seo.og.enabled) {
-    await write(join22(srcDir, "pages", "og", "[...slug].png.ts"), ogEndpointTemplate(ogRoutes));
+    await write(join23(srcDir, "pages", "og", "[...slug].png.ts"), ogEndpointTemplate(ogRoutes));
   }
   if (hasGeneratedChangelog(project, pages)) {
-    await write(join22(srcDir, "pages", "changelog.astro"), changelogIndexTemplate({
-      askEnabled,
+    await write(join23(srcDir, "pages", "changelog.astro"), changelogIndexTemplate({
       exportEpub,
       exportPdf,
       needsReact,
@@ -10816,27 +10989,27 @@ var generateRuntime = async (project) => {
   ]);
   if (servesStaticIndex(config.search.provider)) {
     const documents = await buildSearchDocuments(project);
-    await write(join22(srcDir, "generated", "search.json"), `${JSON.stringify(documents)}
+    await write(join23(srcDir, "generated", "search.json"), `${JSON.stringify(documents)}
 `);
-    await write(join22(srcDir, "pages", "blume-search.json.ts"), searchEndpointTemplate());
+    await write(join23(srcDir, "pages", "blume-search.json.ts"), searchEndpointTemplate());
   }
   if (config.search.provider === "mixedbread") {
-    await write(join22(srcDir, "pages", "api", "search.ts"), mixedbreadSearchEndpointTemplate(config.search.mixedbread?.storeId ?? ""));
+    await write(join23(srcDir, "pages", "api", "search.ts"), mixedbreadSearchEndpointTemplate(config.search.mixedbread?.storeId ?? ""));
   }
   const rawMarkdown = await buildRawMarkdown(project);
   await Promise.all([
-    write(join22(srcDir, "generated", "raw-markdown.json"), `${JSON.stringify(rawMarkdown)}
+    write(join23(srcDir, "generated", "raw-markdown.json"), `${JSON.stringify(rawMarkdown)}
 `),
-    write(join22(srcDir, "pages", "[...slug].md.ts"), rawMarkdownEndpointTemplate("md")),
-    write(join22(srcDir, "pages", "[...slug].mdx.ts"), rawMarkdownEndpointTemplate("mdx"))
+    write(join23(srcDir, "pages", "[...slug].md.ts"), rawMarkdownEndpointTemplate("md")),
+    write(join23(srcDir, "pages", "[...slug].mdx.ts"), rawMarkdownEndpointTemplate("mdx"))
   ]);
   const feeds = buildRssFeeds(project);
   if (feeds.length > 0) {
     const feedXml = Object.fromEntries(feeds.map((feed) => [feed.type, renderRssFeed(feed)]));
     await Promise.all([
-      write(join22(srcDir, "generated", "rss.json"), `${JSON.stringify(feedXml)}
+      write(join23(srcDir, "generated", "rss.json"), `${JSON.stringify(feedXml)}
 `),
-      write(join22(srcDir, "pages", "[section]", "rss.xml.ts"), rssEndpointTemplate())
+      write(join23(srcDir, "pages", "[section]", "rss.xml.ts"), rssEndpointTemplate())
     ]);
   }
   const warnings = [
@@ -10851,7 +11024,7 @@ var generateRuntime = async (project) => {
   const navTargetRoutes = new Set([
     ...project.graph.routes.keys(),
     ...pages.map((page) => page.pattern),
-    ...referenceTabs(config).map((tab) => tab.path)
+    ...referenceRoutes(config)
   ]);
   if (hasGeneratedChangelog(project, pages)) {
     navTargetRoutes.add("/changelog");
@@ -10875,14 +11048,14 @@ var generateRuntime = async (project) => {
       root: context.root
     });
     warnings.push(...references.warnings);
-    await Promise.all(references.files.map((file) => write(join22(srcDir, "pages", file.pagePath), file.content)));
+    await Promise.all(references.files.map((file) => write(join23(srcDir, "pages", file.pagePath), file.content)));
   }
   const openApiSource2 = project.sources.find(isOpenApiSource);
   await Promise.all([
-    write(join22(srcDir, "generated", "data.json"), buildRuntimeData(project)),
+    write(join23(srcDir, "generated", "data.json"), buildRuntimeData(project)),
     write(openapiPath, `${JSON.stringify(openApiSource2 ? openApiSource2.openApiData() : {})}
 `),
-    write(join22(out, "blume.manifest.json"), `${JSON.stringify(project.manifest, null, 2)}
+    write(join23(out, "blume.manifest.json"), `${JSON.stringify(project.manifest, null, 2)}
 `),
     writeStagedContent(out, staged)
   ]);
@@ -10894,7 +11067,7 @@ var generateRuntime = async (project) => {
 import { relative as relative11 } from "pathe";
 
 // src/core/config.ts
-import { existsSync as existsSync13, readFileSync as readFileSync8 } from "node:fs";
+import { existsSync as existsSync14, readFileSync as readFileSync9 } from "node:fs";
 
 // src/core/deployment-env.ts
 var toUrl = (value) => {
@@ -10964,7 +11137,7 @@ var loadConfig = async (root, options = {}) => {
   }
   const parsed = blumeConfigSchema.safeParse(raw ?? {});
   if (!parsed.success) {
-    const source = configFile && existsSync13(configFile) ? readFileSync8(configFile, "utf-8") : undefined;
+    const source = configFile && existsSync14(configFile) ? readFileSync9(configFile, "utf-8") : undefined;
     const diagnostics = diagnosticsFromZod(parsed.error, {
       code: "BLUME_CONFIG_INVALID",
       file: configFile ?? undefined,
@@ -11259,6 +11432,29 @@ var buildConfigSidebar = (items, byRoute, display, basePath) => {
   }
   return nodes;
 };
+var resolveTabHref = (sidebar, path) => {
+  let first;
+  const walk = (nodes) => {
+    for (const node of nodes) {
+      const { route } = node;
+      if (route === path) {
+        return true;
+      }
+      if (first === undefined && route !== undefined && route.startsWith(`${path}/`)) {
+        first = route;
+      }
+      if (node.kind === "group" && walk(node.children)) {
+        return true;
+      }
+    }
+    return false;
+  };
+  return walk(sidebar) ? path : first ?? path;
+};
+var withTabHrefs = (tabs2, sidebar) => tabs2.map((tab) => {
+  const href = resolveTabHref(sidebar, tab.path);
+  return href === tab.path ? tab : { ...tab, href };
+});
 var buildNavigation = (pages, options) => {
   const basePath = options.basePath ?? "";
   const display = options.display ?? "flat";
@@ -11294,19 +11490,21 @@ var buildNavigation = (pages, options) => {
     }
   }
   if (options.sidebar) {
+    const sidebar2 = buildConfigSidebar(options.sidebar, byRoute, display, basePath);
     return {
       featured,
       selectors,
-      sidebar: buildConfigSidebar(options.sidebar, byRoute, display, basePath),
-      tabs: tabs2
+      sidebar: sidebar2,
+      tabs: withTabHrefs(tabs2, sidebar2)
     };
   }
   const rootTabPath = withBasePath(basePath, options.localizedRoot ?? "/");
+  const sidebar = buildFileSystemSidebar(pages, options.folderMeta, sharedFolderMeta, metaPrefix, display, new Set(tabs2.flatMap((tab) => tab.path === rootTabPath ? [] : [tab.path])));
   return {
     featured,
     selectors,
-    sidebar: buildFileSystemSidebar(pages, options.folderMeta, sharedFolderMeta, metaPrefix, display, new Set(tabs2.flatMap((tab) => tab.path === rootTabPath ? [] : [tab.path]))),
-    tabs: tabs2
+    sidebar,
+    tabs: withTabHrefs(tabs2, sidebar)
   };
 };
 
@@ -11675,8 +11873,8 @@ var scanProject = async (root, options = {}) => {
 };
 
 // src/cli/env.ts
-import { existsSync as existsSync14, readFileSync as readFileSync9 } from "node:fs";
-import { dirname as dirname10, join as join23, resolve as resolve7 } from "pathe";
+import { existsSync as existsSync15, readFileSync as readFileSync10 } from "node:fs";
+import { dirname as dirname10, join as join24, resolve as resolve7 } 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;
@@ -11722,8 +11920,8 @@ var applyEnv = (parsed) => {
 };
 var loadFile = (path) => {
   try {
-    if (existsSync14(path)) {
-      applyEnv(parseEnv(readFileSync9(path, "utf-8")));
+    if (existsSync15(path)) {
+      applyEnv(parseEnv(readFileSync10(path, "utf-8")));
     }
   } catch {}
 };
@@ -11731,10 +11929,10 @@ var loadEnvFiles = (startDir) => {
   let dir = resolve7(startDir);
   let done = false;
   while (!done) {
-    loadFile(join23(dir, ".env.local"));
-    loadFile(join23(dir, ".env"));
+    loadFile(join24(dir, ".env.local"));
+    loadFile(join24(dir, ".env"));
     const parent = dirname10(dir);
-    done = existsSync14(join23(dir, ".git")) || parent === dir;
+    done = existsSync15(join24(dir, ".git")) || parent === dir;
     dir = parent;
   }
 };
@@ -11869,12 +12067,12 @@ var emitRedirectFiles = async (config, distDir) => {
   if (redirects.length === 0 || config.deployment.output !== "static") {
     return;
   }
-  await writeFile7(join24(distDir, "blume-redirects.json"), buildRedirectManifest(redirects), "utf-8");
+  await writeFile7(join25(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) => existsSync15(join24(distDir, file.name)) ? Promise.resolve() : writeFile7(join24(distDir, file.name), file.content, "utf-8")));
+  await Promise.all(platformFiles.map((file) => existsSync16(join25(distDir, file.name)) ? Promise.resolve() : writeFile7(join25(distDir, file.name), file.content, "utf-8")));
   logger.success(`Emitted redirect files for ${redirects.length} redirect(s)`);
 };
 var formatBytes = (bytes) => {
@@ -11885,14 +12083,14 @@ var formatBytes = (bytes) => {
   return `${(bytes / 1024).toFixed(digits)} kB`;
 };
 var astroAssets = async (distDir, ext) => {
-  const astroDir = join24(distDir, "_astro");
-  if (!existsSync15(astroDir)) {
+  const astroDir = join25(distDir, "_astro");
+  if (!existsSync16(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(join24(astroDir, name));
+    const info = await stat(join25(astroDir, name));
     return { name, size: info.size };
   }));
   return sized.toSorted((a, b) => b.size - a.size);
@@ -11945,26 +12143,26 @@ var runClientAssetChecks = async (staticDir, args) => {
 var isolatedOutputDir = (config, context) => {
   const { adapter, output } = config.deployment;
   if (output === "server" && adapter === "vercel") {
-    return join24(context.outDir, ".vercel", "output");
+    return join25(context.outDir, ".vercel", "output");
   }
-  return context.distDir ?? join24(context.outDir, "dist");
+  return context.distDir ?? join25(context.outDir, "dist");
 };
 var isolatedStaticDir = (config, context) => {
   const { adapter, output } = config.deployment;
   const outputDir = isolatedOutputDir(config, context);
   if (output === "server" && adapter === "vercel") {
-    return join24(outputDir, "static");
+    return join25(outputDir, "static");
   }
   if (output === "server" && adapter === "node") {
-    return join24(outputDir, "client");
+    return join25(outputDir, "client");
   }
   return outputDir;
 };
 var publishLlmsFiles = async (project, distDir) => {
-  const indexPath = join24(distDir, "llms.txt");
-  const fullPath = join24(distDir, "llms-full.txt");
-  const writeIndex = !existsSync15(indexPath);
-  const writeFull = !existsSync15(fullPath);
+  const indexPath = join25(distDir, "llms.txt");
+  const fullPath = join25(distDir, "llms-full.txt");
+  const writeIndex = !existsSync16(indexPath);
+  const writeFull = !existsSync16(fullPath);
   if (!(writeIndex || writeFull)) {
     return;
   }
@@ -11997,18 +12195,18 @@ var publishBuildArtifacts = async (project, distDir, args) => {
     await publishLlmsFiles(project, distDir);
   }
   const sitemap = buildSitemap(project);
-  if (sitemap && !existsSync15(join24(distDir, "sitemap.xml"))) {
-    await writeFile7(join24(distDir, "sitemap.xml"), sitemap, "utf-8");
+  if (sitemap && !existsSync16(join25(distDir, "sitemap.xml"))) {
+    await writeFile7(join25(distDir, "sitemap.xml"), sitemap, "utf-8");
     logger.success("Generated sitemap.xml");
   }
   const robots = buildRobots(project);
-  if (robots && !existsSync15(join24(distDir, "robots.txt"))) {
-    await writeFile7(join24(distDir, "robots.txt"), robots, "utf-8");
+  if (robots && !existsSync16(join25(distDir, "robots.txt"))) {
+    await writeFile7(join25(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)}
+  if (agentReadability && !existsSync16(join25(distDir, "agent-readability.json"))) {
+    await writeFile7(join25(distDir, "agent-readability.json"), `${JSON.stringify(agentReadability, null, 2)}
 `, "utf-8");
     logger.success("Generated agent-readability.json");
   }
@@ -12120,11 +12318,11 @@ var buildCommand = defineCommand2({
 });
 
 // src/cli/commands/check.ts
-import { existsSync as existsSync16 } from "node:fs";
+import { existsSync as existsSync17 } from "node:fs";
 import { check } from "@astrojs/check";
 import { sync } from "astro";
 import { defineCommand as defineCommand3 } from "citty";
-import { join as join25 } from "pathe";
+import { join as join26 } from "pathe";
 var checkCommand = defineCommand3({
   args: {
     isolated: {
@@ -12160,13 +12358,13 @@ var checkCommand = defineCommand3({
     });
     const { outDir } = project.context;
     await sync({ logLevel: "warn", root: outDir });
-    const tsconfig = join25(root, "tsconfig.json");
+    const tsconfig = join26(root, "tsconfig.json");
     logger.start(`Type-checking ${project.graph.pages.length} page(s)`);
     const failed = await check({
       minimumFailingSeverity: "error",
       minimumSeverity: "hint",
       root: outDir,
-      tsconfig: existsSync16(tsconfig) ? tsconfig : undefined,
+      tsconfig: existsSync17(tsconfig) ? tsconfig : undefined,
       watch: false
     });
     if (failed) {
@@ -12386,14 +12584,14 @@ var devCommand = defineCommand4({
 });
 
 // src/cli/commands/doctor.ts
-import { readFileSync as readFileSync10 } from "node:fs";
+import { readFileSync as readFileSync11 } from "node:fs";
 import { defineCommand as defineCommand5 } from "citty";
-import { join as join26 } from "pathe";
+import { join as join27 } from "pathe";
 var FALLBACK_MIN_NODE = "22.12.0";
 var LEADING_RANGE = /^[^\d]*/u;
 var minSupportedNode = () => {
   try {
-    const pkg = JSON.parse(readFileSync10(join26(packageRoot(), "package.json"), "utf-8"));
+    const pkg = JSON.parse(readFileSync11(join27(packageRoot(), "package.json"), "utf-8"));
     const range = pkg.engines?.node ?? "";
     return range.replace(LEADING_RANGE, "") || FALLBACK_MIN_NODE;
   } catch {
@@ -12489,17 +12687,17 @@ import { defineCommand as defineCommand6 } from "citty";
 import { relative as relative14 } from "pathe";
 
 // src/registry/eject.ts
-import { existsSync as existsSync17 } from "node:fs";
+import { existsSync as existsSync18 } 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 join27, relative as relative12 } from "pathe";
+import { join as join28, relative as relative12 } from "pathe";
 var toPosix = (path) => path.split("\\").join("/");
 var LOCAL_BLUME_SOURCE = "../../node_modules/blume/src/**/*.{astro,ts,tsx}";
 var blumeSourceGlob = (root, genDir, resolveBlumeRoot = packageRoot) => {
-  if (existsSync17(join27(root, "node_modules", "blume"))) {
+  if (existsSync18(join28(root, "node_modules", "blume"))) {
     return LOCAL_BLUME_SOURCE;
   }
   try {
-    const src = join27(resolveBlumeRoot(), "src");
+    const src = join28(resolveBlumeRoot(), "src");
     return `${toPosix(relative12(genDir, src))}/**/*.{astro,ts,tsx}`;
   } catch {
     console.warn('blume: could not locate the installed blume package; src/generated/app.css keeps its default `@source "../../node_modules/blume/..."` glob. If blume is hoisted elsewhere, point that glob at its install location or Blume\'s utility classes will be missing.');
@@ -12519,19 +12717,19 @@ var askFiles = async (project, srcDir, genDir) => {
   const files = [
     {
       content: askEndpointTemplate(resolveAskBackend(ask), grounded),
-      path: join27(srcDir, "pages", "api", "ask.ts")
+      path: join28(srcDir, "pages", "api", "ask.ts")
     }
   ];
   if (grounded) {
     files.push({
       content: `${JSON.stringify(await buildAskData(project))}
 `,
-      path: join27(genDir, "ask-data.json")
+      path: join28(genDir, "ask-data.json")
     });
   }
   return files;
 };
-var hostsMcp = (project, userPages) => project.config.mcp.enabled && !routeIsTaken(userPages, project.graph.pages, project.config.mcp.route);
+var hostsMcp = (project, userPages) => project.config.ai.mcp.enabled && !routeIsTaken(userPages, project.graph.pages, project.config.ai.mcp.route);
 var mcpDiscoveryPages = (project, userPages) => hostsMcp(project, userPages) ? [
   {
     entrypoint: "src/blume-mcp/discovery.ts",
@@ -12546,7 +12744,7 @@ var mcpFiles = async (project, userPages, srcDir, genDir) => {
   if (!hostsMcp(project, userPages)) {
     return [];
   }
-  const { route } = project.config.mcp;
+  const { route } = project.config.ai.mcp;
   const data = await buildMcpData(project);
   const discoveryInput = {
     base: data.base,
@@ -12559,19 +12757,19 @@ var mcpFiles = async (project, userPages, srcDir, genDir) => {
     {
       content: `${JSON.stringify(data)}
 `,
-      path: join27(genDir, "mcp-data.json")
+      path: join28(genDir, "mcp-data.json")
     },
     {
       content: mcpEndpointTemplate(route),
-      path: join27(srcDir, "pages", mcpPageFile(route))
+      path: join28(srcDir, "pages", mcpPageFile(route))
     },
     {
       content: staticJsonEndpointTemplate(buildMcpDiscovery(discoveryInput)),
-      path: join27(srcDir, "blume-mcp", "discovery.ts")
+      path: join28(srcDir, "blume-mcp", "discovery.ts")
     },
     {
       content: staticJsonEndpointTemplate(buildMcpServerCard(discoveryInput)),
-      path: join27(srcDir, "blume-mcp", "server-card.ts")
+      path: join28(srcDir, "blume-mcp", "server-card.ts")
     }
   ];
 };
@@ -12584,22 +12782,22 @@ var changelogFiles = (project, userPages, srcDir, options) => {
   return [
     {
       content: changelogIndexTemplate(options),
-      path: join27(srcDir, "pages", "changelog.astro")
+      path: join28(srcDir, "pages", "changelog.astro")
     }
   ];
 };
-var readExamplesCss = (root, css) => css && existsSync17(join27(root, css)) ? readFile12(join27(root, css), "utf-8") : Promise.resolve("");
+var readExamplesCss = (root, css) => css && existsSync18(join28(root, css)) ? readFile12(join28(root, css), "utf-8") : Promise.resolve("");
 var examplesPreviewFiles = (srcDir, basePath, hasExamples) => hasExamples ? [
   {
     content: examplesPageTemplate(),
-    path: join27(srcDir, "pages", ...basePath.split("/").filter(Boolean), "blume-examples", "[...path].astro")
+    path: join28(srcDir, "pages", ...basePath.split("/").filter(Boolean), "blume-examples", "[...path].astro")
   }
 ] : [];
 var eject = async (root) => {
   const project = await scanProject(root, { mode: "build" });
   const { context, config } = project;
-  const srcDir = join27(root, "src");
-  const genDir = join27(srcDir, "generated");
+  const srcDir = join28(root, "src");
+  const genDir = join28(srcDir, "generated");
   const askEnabled = config.ai.ask?.enabled ?? false;
   const exportPdf = config.export.pdf;
   const exportEpub = config.export.epub;
@@ -12649,6 +12847,7 @@ var eject = async (root) => {
   const files = [
     {
       content: astroConfigTemplate({
+        askPath: "./src/generated/Ask.astro",
         config,
         contentRoutes: project.manifest.routes.map((route) => route.path),
         context: relContext,
@@ -12663,14 +12862,14 @@ var eject = async (root) => {
         searchClientPath: "./src/generated/search-client.ts",
         themePath: "./src/generated/app.css"
       }),
-      path: join27(root, "astro.config.mjs")
+      path: join28(root, "astro.config.mjs")
     },
     {
       content: runtimeTsconfigTemplate(),
-      path: join27(root, "tsconfig.json"),
+      path: join28(root, "tsconfig.json"),
       skipIfExists: true
     },
-    { content: envTemplate(), path: join27(srcDir, "env.d.ts") },
+    { content: envTemplate(), path: join28(srcDir, "env.d.ts") },
     {
       content: contentConfigTemplate({
         config,
@@ -12678,29 +12877,28 @@ var eject = async (root) => {
         staged: hasStaged,
         stagedBase: stagedDir
       }),
-      path: join27(srcDir, "content.config.ts")
+      path: join28(srcDir, "content.config.ts")
     },
     {
       content: catchAllPageTemplate({
-        askEnabled,
         exportEpub,
         exportPdf,
         mathEnabled: usesMath,
         needsReact
       }),
-      path: join27(srcDir, "pages", "[...slug].astro")
+      path: join28(srcDir, "pages", "[...slug].astro")
     },
     {
       content: planComponentSlots(componentsImport, null).module,
-      path: join27(genDir, "components.ts")
+      path: join28(genDir, "components.ts")
     },
     {
       content: islandMapTemplate(islands.islands),
-      path: join27(genDir, "islands.ts")
+      path: join28(genDir, "islands.ts")
     },
     {
       content: exampleMapTemplate(examples.examples, config.basePath),
-      path: join27(genDir, "examples.ts")
+      path: join28(genDir, "examples.ts")
     },
     {
       content: examplesEntryTemplate({
@@ -12708,7 +12906,7 @@ var eject = async (root) => {
         sources: ["../../**/*.{astro,jsx,svelte,ts,tsx,vue}"],
         userCss: userExamplesCss
       }),
-      path: join27(genDir, "examples.css")
+      path: join28(genDir, "examples.css")
     },
     {
       content: tailwindEntryTemplate({
@@ -12720,26 +12918,30 @@ var eject = async (root) => {
         twoslashCss: twoslashCss(),
         userTheme
       }),
-      path: join27(genDir, "app.css")
+      path: join28(genDir, "app.css")
+    },
+    { content: buildRuntimeData(project), path: join28(genDir, "data.json") },
+    {
+      content: askComponentTemplate(askEnabled),
+      path: join28(genDir, "Ask.astro")
     },
-    { content: buildRuntimeData(project), path: join27(genDir, "data.json") },
     {
       content: `${JSON.stringify(ejectOpenApiData(project))}
 `,
-      path: join27(genDir, "openapi.json")
+      path: join28(genDir, "openapi.json")
     },
     {
       content: `${JSON.stringify(rawMarkdown)}
 `,
-      path: join27(genDir, "raw-markdown.json")
+      path: join28(genDir, "raw-markdown.json")
     },
     {
       content: rawMarkdownEndpointTemplate("md"),
-      path: join27(srcDir, "pages", "[...slug].md.ts")
+      path: join28(srcDir, "pages", "[...slug].md.ts")
     },
     {
       content: rawMarkdownEndpointTemplate("mdx"),
-      path: join27(srcDir, "pages", "[...slug].mdx.ts")
+      path: join28(srcDir, "pages", "[...slug].mdx.ts")
     }
   ];
   if (askEnabled) {
@@ -12748,11 +12950,10 @@ var eject = async (root) => {
   if (config.seo.og.enabled) {
     files.push({
       content: ogEndpointTemplate(customOgRoutes(pages, config.title)),
-      path: join27(srcDir, "pages", "og", "[...slug].png.ts")
+      path: join28(srcDir, "pages", "og", "[...slug].png.ts")
     });
   }
   files.push(...await mcpFiles(project, pages, srcDir, genDir), ...changelogFiles(project, pages, srcDir, {
-    askEnabled,
     exportEpub,
     exportPdf,
     needsReact,
@@ -12761,28 +12962,28 @@ var eject = async (root) => {
   if (!routeIsTaken(pages, project.graph.pages, "/404")) {
     files.push({
       content: notFoundPageTemplate(),
-      path: join27(srcDir, "pages", "404.astro")
+      path: join28(srcDir, "pages", "404.astro")
     });
   }
   files.push({
     content: searchClientTemplate(config),
-    path: join27(genDir, "search-client.ts")
+    path: join28(genDir, "search-client.ts")
   });
   if (servesStaticIndex(config.search.provider)) {
     const documents = await buildSearchDocuments(project);
     files.push({
       content: `${JSON.stringify(documents)}
 `,
-      path: join27(genDir, "search.json")
+      path: join28(genDir, "search.json")
     }, {
       content: searchEndpointTemplate(),
-      path: join27(srcDir, "pages", "blume-search.json.ts")
+      path: join28(srcDir, "pages", "blume-search.json.ts")
     });
   }
   if (config.search.provider === "mixedbread") {
     files.push({
       content: mixedbreadSearchEndpointTemplate(config.search.mixedbread?.storeId ?? ""),
-      path: join27(srcDir, "pages", "api", "search.ts")
+      path: join28(srcDir, "pages", "api", "search.ts")
     });
   }
   const feeds = buildRssFeeds(project);
@@ -12791,10 +12992,10 @@ var eject = async (root) => {
     files.push({
       content: `${JSON.stringify(feedXml)}
 `,
-      path: join27(genDir, "rss.json")
+      path: join28(genDir, "rss.json")
     }, {
       content: rssEndpointTemplate(),
-      path: join27(srcDir, "pages", "[section]", "rss.xml.ts")
+      path: join28(srcDir, "pages", "[section]", "rss.xml.ts")
     });
   }
   const warnings = [];
@@ -12808,28 +13009,28 @@ var eject = async (root) => {
     for (const file of references.files) {
       files.push({
         content: file.content,
-        path: join27(srcDir, "pages", file.pagePath)
+        path: join28(srcDir, "pages", file.pagePath)
       });
     }
   }
   files.push(...islands.islands.map((island) => ({
     content: islandWrapperTemplate(island),
-    path: join27(genDir, "islands", `${island.name}.astro`)
+    path: join28(genDir, "islands", `${island.name}.astro`)
   })), ...examples.examples.map((example) => ({
     content: exampleWrapperTemplate(example),
-    path: join27(genDir, "examples", `${exampleSlug(example.path)}.astro`)
+    path: join28(genDir, "examples", `${exampleSlug(example.path)}.astro`)
   })), ...examplesPreviewFiles(srcDir, config.basePath, examples.examples.length > 0));
   for (const [entryId, content] of staged) {
-    files.push({ content, path: join27(root, stagedDir, entryId) });
+    files.push({ content, path: join28(root, stagedDir, entryId) });
   }
-  const written = files.filter((file) => !(file.skipIfExists && existsSync17(file.path)));
+  const written = files.filter((file) => !(file.skipIfExists && existsSync18(file.path)));
   await Promise.all(written.map(async (file) => {
-    await mkdir7(join27(file.path, ".."), { recursive: true });
+    await mkdir7(join28(file.path, ".."), { recursive: true });
     await writeFile8(file.path, file.content, "utf-8");
   }));
-  const assetsSrc = join27(context.outDir, "public", "blume-assets");
-  if (existsSync17(assetsSrc)) {
-    await cp2(assetsSrc, join27(root, "public", "blume-assets"), {
+  const assetsSrc = join28(context.outDir, "public", "blume-assets");
+  if (existsSync18(assetsSrc)) {
+    await cp2(assetsSrc, join28(root, "public", "blume-assets"), {
       recursive: true
     });
   }
@@ -12839,7 +13040,7 @@ var eject = async (root) => {
 
 // src/cli/eject-scripts.ts
 import { readFile as readFile13, writeFile as writeFile9 } from "node:fs/promises";
-import { join as join28 } from "pathe";
+import { join as join29 } from "pathe";
 var droppedArtifactNotices = (config) => {
   const notices = [];
   if (config.search.provider === "pagefind") {
@@ -12866,7 +13067,7 @@ var droppedArtifactNotices = (config) => {
   return notices;
 };
 var updatePackageScripts = async (root) => {
-  const pkgPath = join28(root, "package.json");
+  const pkgPath = join29(root, "package.json");
   let pkg;
   try {
     pkg = JSON.parse(await readFile13(pkgPath, "utf-8"));
@@ -12885,9 +13086,9 @@ var updatePackageScripts = async (root) => {
 };
 
 // src/cli/init/scaffold.ts
-import { existsSync as existsSync18 } from "node:fs";
+import { existsSync as existsSync19 } from "node:fs";
 import { mkdir as mkdir8, writeFile as writeFile10 } from "node:fs/promises";
-import { basename as basename4, dirname as dirname11, isAbsolute as isAbsolute9, join as join29, relative as relative13 } from "pathe";
+import { basename as basename4, dirname as dirname11, isAbsolute as isAbsolute9, join as join30, relative as relative13 } from "pathe";
 
 // src/core/package-json.ts
 var toPackageName = (raw) => raw.toLowerCase().replaceAll(/[^a-z0-9._-]+/gu, "-").replaceAll(/^[-_.]+|[-_.]+$/gu, "") || "docs";
@@ -12946,7 +13147,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: join29(dir, "index.mdx")
+        path: join30(dir, "index.mdx")
       }
     ]
   },
@@ -12961,7 +13162,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: join29(dir, "index.mdx")
+        path: join30(dir, "index.mdx")
       },
       {
         content: `---
@@ -12972,7 +13173,7 @@ date: 2026-01-01
 
 The first release. Edit \`${dir}/changelog/v1-0-0.mdx\` or add new entries beside it.
 `,
-        path: join29(dir, "changelog", "v1-0-0.mdx")
+        path: join30(dir, "changelog", "v1-0-0.mdx")
       }
     ]
   },
@@ -12985,7 +13186,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: join29(dir, "index.mdx")
+        path: join30(dir, "index.mdx")
       }
     ]
   },
@@ -12996,11 +13197,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: join29(dir, "index.mdx")
+        path: join30(dir, "index.mdx")
       },
       {
         content: page("Installation", "Install the SDK.", "# Installation\n\n```package-install\nyour-sdk\n```"),
-        path: join29(dir, "installation.mdx")
+        path: join30(dir, "installation.mdx")
       }
     ]
   }
@@ -13015,7 +13216,7 @@ var detectPackageManager = (userAgent) => {
   const name = userAgent?.split("/")[0];
   return name !== undefined && PACKAGE_MANAGERS.includes(name) ? name : "npm";
 };
-var validateContentDir = (root, dir) => isAbsolute9(dir) || relative13(root, join29(root, dir)).startsWith("..") ? "Must be a relative path inside the project." : undefined;
+var validateContentDir = (root, dir) => isAbsolute9(dir) || relative13(root, join30(root, dir)).startsWith("..") ? "Must be a relative path inside the project." : undefined;
 var titleize = (raw) => {
   const words = raw.replaceAll(/[-_.]+/gu, " ").split(/\s+/u).filter(Boolean);
   return words.length === 0 ? "My Docs" : words.map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
@@ -13098,17 +13299,17 @@ var buildPlan = (root, answers) => {
   const files = [
     {
       content: blumePackageJson(toPackageName(basename4(root)), extraDepsFor(answers.sources)),
-      path: join29(root, "package.json")
+      path: join30(root, "package.json")
     },
-    { content: buildConfig(answers), path: join29(root, "blume.config.ts") }
+    { content: buildConfig(answers), path: join30(root, "blume.config.ts") }
   ];
   if (answers.sources.length === 0 || answers.sources.includes("filesystem")) {
-    files.push(...STARTERS[answers.template].files(answers.contentDir).map((file) => ({ ...file, path: join29(root, file.path) })));
+    files.push(...STARTERS[answers.template].files(answers.contentDir).map((file) => ({ ...file, path: join30(root, file.path) })));
   }
   return files;
 };
 var writeFileSafe = async (file, log) => {
-  if (existsSync18(file.path)) {
+  if (existsSync19(file.path)) {
     log.info(`Skipped existing ${file.path}`);
     return false;
   }
@@ -13415,10 +13616,10 @@ var initCommand = defineCommand7({
 });
 
 // src/cli/commands/preview.ts
-import { existsSync as existsSync19 } from "node:fs";
+import { existsSync as existsSync20 } from "node:fs";
 import { preview } from "astro";
 import { defineCommand as defineCommand8 } from "citty";
-import { join as join30 } from "pathe";
+import { join as join31 } from "pathe";
 var previewCommand = defineCommand8({
   args: {
     host: { description: "Network host to bind.", type: "string" },
@@ -13432,7 +13633,7 @@ var previewCommand = defineCommand8({
     const root = process.cwd();
     const { config } = await loadConfig(root);
     const context = resolveProjectContext(root, config);
-    if (!existsSync19(join30(context.outDir, "astro.config.mjs"))) {
+    if (!existsSync20(join31(context.outDir, "astro.config.mjs"))) {
       logger.error("No build found. Run `blume build` first.");
       process.exit(1);
     }
@@ -13450,7 +13651,7 @@ var previewCommand = defineCommand8({
 // src/cli/commands/sync.ts
 import { rm as rm4 } from "node:fs/promises";
 import { defineCommand as defineCommand9 } from "citty";
-import { join as join31 } from "pathe";
+import { join as join32 } from "pathe";
 var syncCommand = defineCommand9({
   args: {
     force: {
@@ -13472,7 +13673,7 @@ var syncCommand = defineCommand9({
     if (args.force) {
       const { config } = await loadConfig(root);
       const context = resolveProjectContext(root, config);
-      await rm4(join31(context.outDir, "cache"), { force: true, recursive: true });
+      await rm4(join32(context.outDir, "cache"), { force: true, recursive: true });
       logger.info("Cleared source cache.");
     }
     const lock = readDevLock(resolveRuntimeDir(root));
@@ -13490,13 +13691,13 @@ var syncCommand = defineCommand9({
 });
 
 // src/cli/commands/validate.ts
-import { existsSync as existsSync21 } from "node:fs";
+import { existsSync as existsSync22 } from "node:fs";
 import { defineCommand as defineCommand10 } from "citty";
-import { join as join33 } from "pathe";
+import { join as join34 } from "pathe";
 
 // src/core/links.ts
-import { existsSync as existsSync20 } from "node:fs";
-import { basename as basename6, join as join32 } from "pathe";
+import { existsSync as existsSync21 } from "node:fs";
+import { basename as basename6, join as join33 } from "pathe";
 var HTTP = /^https?:\/\//iu;
 var PROTOCOL_RELATIVE = /^\/\//u;
 var SCHEME = /^[a-z][a-z0-9+.-]*:/iu;
@@ -13515,7 +13716,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 && existsSync20(join32(ctx.publicDir, resolved));
+var assetIsPresent = (resolved, ctx) => ctx.publicDir !== null && existsSync21(join33(ctx.publicDir, resolved));
 var NUMERIC_PREFIX3 = /^\d+[-_.]/u;
 var isIndexPage = (page2) => /^index\.(?:md|mdx)$/iu.test(basename6(page2.navPath).replace(NUMERIC_PREFIX3, ""));
 var applyRelativePart = (segments, part) => {
@@ -13781,12 +13982,12 @@ var validateCommand = defineCommand10({
         });
         extraRoutes.push(...manifest.routes.flatMap((route) => route.fallback ? [route.path] : []));
       }
-      const publicDir = join33(root, "public");
+      const publicDir = join34(root, "public");
       diagnostics.push(...await validateLinks(project.graph, {
         basePath: project.config.basePath,
         checkExternal: Boolean(args.external),
         extraRoutes,
-        publicDir: existsSync21(publicDir) ? publicDir : null,
+        publicDir: existsSync22(publicDir) ? publicDir : null,
         redirects: project.config.redirects
       }));
     } catch (error) {
@@ -13847,5 +14048,5 @@ process.on("unhandledRejection", (error) => {
 });
 runMain(main);
 
-//# debugId=5F5E50EAF35B586A64756E2164756E21
+//# debugId=E383A1CFB1E8864864756E2164756E21
 //# sourceMappingURL=index.js.map