blume 2.0.2 → 2.1.0

package/dist/cli/{chunk-xh43dwgw.js → chunk-zf748avv.js}

@@ -6,6 +6,7 @@ import {
   enrichDiagnostic
 } from "./index.js";
 import {
+  resolveFallbackLocale,
   OPENAPI_PATH,
   API_PAGES_PATH,
   API_PAGE_PATH,
@@ -16,6 +17,7 @@ import {
   referenceRoutes,
   hasScalarReferences,
   builtinProxyReferences,
+  apiPagesUseBuiltinProxy,
   needsPlaygroundProxy,
   buildMcpDiscovery,
   buildMcpServerCard,
@@ -26,8 +28,9 @@ import {
   routeIsTaken,
   hasGeneratedChangelog,
   customOgRoutes,
-  resolveFallbackLocale,
   resolveAskBackend,
+  captchaSettings,
+  parseApiEndpoint,
   GOOGLE_FONTS,
   isFontSlug,
   fontLocaleCodes,
@@ -46,25 +49,29 @@ import {
   renderRssFeed,
   HTTP_METHODS,
   withServerDefaults,
+  readOverlaidSpec,
   isOpenApiSource,
   buildRawMarkdown,
   markdownRoutePaths
-} from "./chunk-v6ya5kcb.js";
+} from "./chunk-xkz5xbtv.js";
 import {
   trimChar,
   normalizeBasePath,
   withBasePath,
+  mountBasePath,
   siteRoot,
   absoluteUrl2
-} from "./chunk-gs7r695n.js";
+} from "./chunk-zccbjcj0.js";
 import {
+  resolveLocalizable,
   validateSearchPopularIcons,
   validateNavTargets
-} from "./chunk-5r8g91qn.js";
+} from "./chunk-43zcf4gz.js";
 import {
+  EXPANDABLE_VISIBLE_LINES,
   buildSearchDocuments,
   buildMcpData
-} from "./chunk-ddndchfr.js";
+} from "./chunk-2f3ndkpw.js";
 import {
   planComponentSlots,
   publishRuntimeModules,
@@ -76,6 +83,7 @@ import {
   askComponentTemplate,
   searchEndpointTemplate,
   featuresTemplate,
+  consentClientTemplate,
   searchClientTemplate,
   mixedbreadSearchEndpointTemplate,
   rawMarkdownEndpointTemplate,
@@ -104,32 +112,129 @@ import {
   examplesPageTemplate,
   runtimePackageTemplate,
   runtimeTsconfigTemplate
-} from "./chunk-hr8ne106.js";
+} from "./chunk-4h8z9vv5.js";
 import {
   emptyComponentOverrides,
   analyzeComponentOverrides
-} from "./chunk-00gs3wqs.js";
+} from "./chunk-ta27feev.js";
 import {
   writeTextAtomic
 } from "./chunk-jq5n4avg.js";
+import {
+  resolveAccent,
+  resolveRadius,
+  buildThemeCss
+} from "./chunk-cm89scdv.js";
 import {
   registry
-} from "./chunk-fsmrqk8a.js";
+} from "./chunk-2f7n4qzt.js";
 import {
   readClientMode,
   discoverIslands,
   missingDependencyDiagnostic
-} from "./chunk-sqw4ekg1.js";
+} from "./chunk-amrb6hgh.js";
 
 // src/astro/integration.ts
-import { join as join3, relative, resolve as resolve2 } from "pathe";
+import { join as join4, relative, resolve as resolve2 } from "pathe";
 
 // src/deploy/artifacts.ts
-import { dirname as dirname2, join as join2, resolve } from "pathe";
+import { dirname as dirname3, join as join3, resolve } from "pathe";
+
+// src/narration/build.ts
+import { createGateway, generateSpeech } from "ai";
+import { HTMLElement, parse, TextNode } from "node-html-parser";
+import { dirname, join } from "pathe";
+
+// src/narration/script.ts
+var INLINE_TAGS = new Set([
+  "a",
+  "abbr",
+  "audio",
+  "button",
+  "canvas",
+  "embed",
+  "iframe",
+  "img",
+  "input",
+  "math",
+  "noscript",
+  "object",
+  "picture",
+  "script",
+  "select",
+  "style",
+  "svg",
+  "template",
+  "textarea",
+  "video",
+  "b",
+  "bdi",
+  "bdo",
+  "cite",
+  "code",
+  "data",
+  "del",
+  "dfn",
+  "em",
+  "font",
+  "i",
+  "ins",
+  "kbd",
+  "label",
+  "mark",
+  "q",
+  "s",
+  "samp",
+  "small",
+  "span",
+  "strong",
+  "sub",
+  "sup",
+  "time",
+  "u",
+  "var",
+  "wbr"
+]);
+var SKIPPED_TAGS = new Set([
+  "audio",
+  "blume-diff",
+  "blume-mermaid",
+  "button",
+  "canvas",
+  "dialog",
+  "embed",
+  "figure",
+  "iframe",
+  "img",
+  "input",
+  "math",
+  "nav",
+  "noscript",
+  "object",
+  "picture",
+  "pre",
+  "script",
+  "select",
+  "style",
+  "svg",
+  "table",
+  "template",
+  "textarea",
+  "video"
+]);
+var CALLOUT_KINDS = new Set([
+  "danger",
+  "info",
+  "note",
+  "success",
+  "tip",
+  "warning"
+]);
+var DENSE_SCRIPT_LANGS = new Set(["ja", "ko", "zh"]);
 
 // src/search/build.ts
 import { close, createIndex } from "pagefind";
-import { dirname, join } from "pathe";
+import { dirname as dirname2, join as join2 } from "pathe";
 
 // src/deploy/sitemap.ts
 import { escape as escapeXml } from "html-escaper";
@@ -156,18 +261,29 @@ var publishDevNegotiation = (negotiation) => {
     homeLinkHeader: negotiation.homeLinkHeader
   } : null;
 };
+var overlayChannelOf = (server) => server?.ws ?? server?.hot;
+var DATA_STORE_MODULE_ID = "\x00astro:data-layer-content";
+var invalidateDataStore = (server) => {
+  for (const { moduleGraph } of Object.values(server.environments)) {
+    const mod = moduleGraph.getModuleById(DATA_STORE_MODULE_ID);
+    if (mod) {
+      moduleGraph.invalidateModule(mod);
+    }
+  }
+  overlayChannelOf(server)?.send({ type: "full-reload" });
+};
 var refreshBlumeContent = async () => {
-  const { refreshContent } = registry2();
+  const { overlay, refreshContent } = registry2();
   if (!refreshContent) {
     return false;
   }
   await refreshContent({});
+  if (overlay) {
+    invalidateDataStore(overlay);
+  }
   return true;
 };
-var overlayChannel = () => {
-  const { overlay } = registry2();
-  return overlay?.ws ?? overlay?.hot;
-};
+var overlayChannel = () => overlayChannelOf(registry2().overlay);
 var showBlumeErrorOverlay = (diagnostics) => {
   const errors = [];
   for (const diagnostic of diagnostics) {
@@ -214,8 +330,8 @@ import {
   rm,
   writeFile
 } from "node:fs/promises";
-import { dirname as dirname3, join as join4 } from "pathe";
-var ogCacheDir = (context) => existsSync(join4(context.root, "node_modules")) ? join4(context.root, "node_modules", ".cache", "blume", "og") : join4(context.outDir, ".cache", "og");
+import { dirname as dirname4, join as join5 } from "pathe";
+var ogCacheDir = (context) => existsSync(join5(context.root, "node_modules")) ? join5(context.root, "node_modules", ".cache", "blume", "og") : join5(context.outDir, ".cache", "og");
 var REGISTRY_KEY2 = Symbol.for("blume.og-cache");
 var registry3 = () => {
   const host = globalThis;
@@ -233,7 +349,7 @@ var pruneCardCache = async (dir) => {
     return 0;
   }
   const stale = entries.filter((name) => name.endsWith(".tmp") || name.endsWith(".png") && !used.has(name.slice(0, -".png".length)));
-  await Promise.all(stale.map((name) => rm(join4(dir, name), { force: true })));
+  await Promise.all(stale.map((name) => rm(join5(dir, name), { force: true })));
   return stale.length;
 };
 var cardCacheTally = () => {
@@ -256,7 +372,7 @@ import {
 import { createRequire as createRequire2 } from "node:module";
 import { pathToFileURL } from "node:url";
 import pMap2 from "p-map";
-import { dirname as dirname7, isAbsolute as isAbsolute6, join as join11, normalize as normalize2, relative as relative5, resolve as resolve6 } from "pathe";
+import { dirname as dirname8, isAbsolute as isAbsolute6, join as join12, normalize as normalize2, relative as relative5, resolve as resolve6 } from "pathe";
 import { glob as glob2 } from "tinyglobby";
 
 // src/ai/api/problem.ts
@@ -774,7 +890,7 @@ var buildApiSpec = (input) => {
   if (input.site) {
     document.externalDocs = {
       description: `${input.name} documentation`,
-      url: absoluteUrl2(input.site, withBasePath(input.base, "/"))
+      url: absoluteUrl2(input.site, mountBasePath(input.base, "/"))
     };
   }
   return document;
@@ -801,6 +917,12 @@ var buildAskData = async (project) => {
       if (versioned) {
         document.version = doc.version;
       }
+      if (doc.boost !== undefined) {
+        document.boost = doc.boost;
+      }
+      if (doc.keywords) {
+        document.keywords = doc.keywords;
+      }
       return document;
     }),
     site: project.config.deployment.options.site ?? null
@@ -853,7 +975,11 @@ var BUILTIN_MDX_TAGS = new Set([
   "Math",
   "Operation",
   "Panel",
+  "ParamField",
   "Prompt",
+  "RequestExample",
+  "ResponseExample",
+  "ResponseField",
   "Step",
   "Steps",
   "Tab",
@@ -862,6 +988,7 @@ var BUILTIN_MDX_TAGS = new Set([
   "Tooltip",
   "Tree",
   "TypeTable",
+  "View",
   "Visibility",
   "YouTube"
 ]);
@@ -956,7 +1083,7 @@ var svgDimensions = (svg) => {
 
 // src/core/tsconfig-aliases.ts
 import { existsSync as existsSync2 } from "node:fs";
-import { dirname as dirname4, join as join5, resolve as resolve3 } from "pathe";
+import { dirname as dirname5, join as join6, resolve as resolve3 } from "pathe";
 import ts from "typescript";
 var PARSE_HOST = {
   fileExists: ts.sys.fileExists,
@@ -978,7 +1105,7 @@ var toAlias = (key, value, baseDir) => {
   return { find, replacement: resolve3(baseDir, target) };
 };
 var resolveTsconfigAliases = (root) => {
-  const entry = ["tsconfig.json", "jsconfig.json"].map((name) => join5(root, name)).find((file) => existsSync2(file));
+  const entry = ["tsconfig.json", "jsconfig.json"].map((name) => join6(root, name)).find((file) => existsSync2(file));
   if (!entry) {
     return {};
   }
@@ -986,7 +1113,7 @@ var resolveTsconfigAliases = (root) => {
   if (error) {
     return {};
   }
-  const configDir = dirname4(entry);
+  const configDir = dirname5(entry);
   const { options } = ts.parseJsonConfigFileContent(config, PARSE_HOST, configDir, undefined, entry);
   const { paths } = options;
   if (!paths) {
@@ -1139,9 +1266,9 @@ var hasMermaidFence = (text) => MERMAID_FENCE.test(text);
 
 // src/og/derive.ts
 import { existsSync as existsSync3 } from "node:fs";
-import { isAbsolute, join as join6 } from "pathe";
+import { isAbsolute, join as join7 } from "pathe";
 var CARD_WEIGHTS = [400, 600];
-var absoluteSrc = (root, src) => isAbsolute(src) ? src : join6(root, src);
+var absoluteSrc = (root, src) => isAbsolute(src) ? src : join7(root, src);
 var isNumericWeight = (weight) => typeof weight === "number";
 var isRangeWeight = (weight) => typeof weight === "string";
 var isFontName = (value) => typeof value === "string";
@@ -1270,10 +1397,14 @@ var localeFamily = (locale) => {
   }
   return localeFontSubsets([locale]).length > 1 ? "Noto Sans" : null;
 };
-var localeOgFonts = (locales) => {
+var DEFAULT_FALLBACKS = [
+  "Noto Sans",
+  ...new Set(Object.values(SCRIPT_FAMILIES)),
+  "Noto Sans TC"
+];
+var ogFallbackFonts = (locales) => {
   const names = new Set;
-  for (const locale of locales) {
-    const family = localeFamily(locale);
+  for (const family of [...locales.map(localeFamily), ...DEFAULT_FALLBACKS]) {
     if (family) {
       names.add(family);
     }
@@ -1282,18 +1413,15 @@ var localeOgFonts = (locales) => {
 };
 var isGoogleFamilyName = (font) => typeof font === "string";
 var ogFontName = (font) => isGoogleFamilyName(font) ? font : font.name;
-var withLocaleFonts = (derived, locales) => {
+var withFallbacks = (derived, locales) => {
   const loaded = new Set(derived.fonts.map(ogFontName));
-  const fallbacks = localeOgFonts(locales).filter((font) => !loaded.has(ogFontName(font)));
-  if (fallbacks.length === 0) {
-    return derived;
-  }
   return {
+    fallbacks: ogFallbackFonts(locales).filter((font) => !loaded.has(font.name)),
     families: derived.families ?? {
       body: BUILT_IN_FAMILY,
       title: BUILT_IN_FAMILY
     },
-    fonts: [...derived.fonts, ...fallbacks]
+    fonts: derived.fonts
   };
 };
 var resolveOgFontSources = (fonts, root) => fonts.map((font) => isLocalOgFont(font) ? { ...font, src: absoluteSrc(root, font.src) } : font);
@@ -1302,7 +1430,7 @@ var resolveOgFonts = (options, root) => {
     return { fonts: resolveOgFontSources(options.ogFonts, root) };
   }
   const derived = options.themeFontsConfigured ? deriveOgFonts(options.themeFonts, root) : { fonts: [] };
-  return withLocaleFonts(derived, options.locales ?? []);
+  return withFallbacks(derived, options.locales ?? []);
 };
 var missingFontFiles = (options, root) => {
   const sources = [];
@@ -1321,98 +1449,22 @@ var missingFontFiles = (options, root) => {
 
 // src/og/logo.ts
 import { existsSync as existsSync4, readFileSync } from "node:fs";
-import { join as join7 } from "pathe";
+import { join as join8 } from "pathe";
 var resolveOgLogo = (project, source) => {
   if (!source?.toLowerCase().endsWith(".svg")) {
     return;
   }
   const relative = source.replace(/^\//u, "");
   const file = [
-    join7(project.context.root, "public", relative),
-    join7(project.context.root, relative)
+    join8(project.context.root, "public", relative),
+    join8(project.context.root, relative)
   ].find((path) => existsSync4(path));
   return file ? readFileSync(file, "utf-8") : undefined;
 };
 
 // src/openapi/scalar.ts
 import { readFile as readFile2 } from "node:fs/promises";
-import { isAbsolute as isAbsolute2, join as join8 } from "pathe";
-
-// src/theme/palette.ts
-var FALLBACK_ACCENT = "oklch(0.62 0.16 250)";
-var ACCENTS = {
-  blue: FALLBACK_ACCENT,
-  green: "oklch(0.6 0.16 150)",
-  orange: "oklch(0.68 0.17 50)",
-  pink: "oklch(0.65 0.2 350)",
-  purple: "oklch(0.58 0.2 290)",
-  red: "oklch(0.58 0.22 25)",
-  teal: "oklch(0.6 0.12 195)"
-};
-var isAccentPreset = (value) => Object.hasOwn(ACCENTS, value);
-var CSS_COLOR = /^[\w\s#%.,()/+-]+$/u;
-var safeColor = (value, fallback) => CSS_COLOR.test(value.trim()) ? value.trim() : fallback;
-var presetOrColor = (value) => isAccentPreset(value) ? ACCENTS[value] : safeColor(value, FALLBACK_ACCENT);
-var safeColorOrNull = (value) => value && CSS_COLOR.test(value.trim()) ? value.trim() : null;
-var RADII = {
-  lg: "0.75rem",
-  md: "0.5rem",
-  none: "0",
-  sm: "0.25rem"
-};
-var cssString = (value) => JSON.stringify(value);
-var backgroundImageCss = (image) => `url(${cssString(image)})`;
-var cssToken = (name, value) => value ? [`  ${name}: ${value};`] : [];
-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?.light)),
-  ...cssToken("--blume-background-image", theme.backgroundImage?.light ? backgroundImageCss(theme.backgroundImage.light) : null),
-  `  --blume-radius: ${options.radius};`
-].filter(Boolean).join(`
-`);
-var themeDarkCss = (theme, options) => {
-  const tokens = [
-    `  --blume-accent: ${options.accent};`,
-    "  --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.background?.dark)),
-    ...cssToken("--blume-background-image", theme.backgroundImage?.dark ? backgroundImageCss(theme.backgroundImage.dark) : null)
-  ].filter(Boolean);
-  return `:root[data-theme="dark"] {
-${tokens.join(`
-`)}
-}
-`;
-};
-var resolveAccent = (theme) => ({
-  dark: presetOrColor(theme.accent.dark),
-  light: presetOrColor(theme.accent.light)
-});
-var resolveRadius = (theme) => RADII[theme.radius];
-var buildThemeCss = (theme) => {
-  const accent = resolveAccent(theme);
-  const action = theme.action ? presetOrColor(theme.action) : null;
-  const radius = RADII[theme.radius];
-  const root = themeRootCss(theme, {
-    accent: accent.light,
-    action,
-    radius
-  });
-  const dark = themeDarkCss(theme, {
-    accent: accent.dark,
-    action
-  });
-  return `/* Generated by Blume from theme config. */
-:root {
-${root}
-}
-${dark}`;
-};
-
-// src/openapi/scalar.ts
+import { isAbsolute as isAbsolute2, join as join9 } from "pathe";
 var URL_SPEC = /^https?:\/\//u;
 var referencePagePath = (route) => {
   const segments = trimChar(route, "/");
@@ -1428,11 +1480,28 @@ var themeConfiguration = (config, override) => {
     customCss: `:root,.light-mode,.dark-mode{--scalar-color-accent:${accent.light};--scalar-radius:${radius};}.dark-mode{--scalar-color-accent:${accent.dark};}`
   };
 };
-var specConfiguration = async (spec, root) => {
+var overlaidConfiguration = async (ref, root) => {
+  try {
+    const { text, warnings } = await readOverlaidSpec(ref.spec, root, {
+      overlays: ref.overlays
+    });
+    return { config: { content: text }, warning: warnings[0] };
+  } catch (error) {
+    const { message } = error;
+    return {
+      warning: `API reference ${ref.route} was skipped: its overlays couldn't be applied to "${ref.spec}" (${message}).`
+    };
+  }
+};
+var specConfiguration = async (ref, root) => {
+  const { spec } = ref;
+  if (ref.overlays?.length) {
+    return await overlaidConfiguration(ref, root);
+  }
   if (URL_SPEC.test(spec)) {
     return { config: { url: spec } };
   }
-  const absolute = isAbsolute2(spec) ? spec : join8(root, spec);
+  const absolute = isAbsolute2(spec) ? spec : join9(root, spec);
   try {
     return { config: { content: await readFile2(absolute, "utf-8") } };
   } catch {
@@ -1470,13 +1539,16 @@ var buildReferenceFiles = async (options) => {
   }
   const built = await Promise.all(accepted.map(async (ref) => ({
     ref,
-    spec: await specConfiguration(ref.spec, root)
+    spec: await specConfiguration(ref, root)
   })));
   const files = [];
   for (const { ref, spec } of built) {
     if (spec.warning) {
       warnings.push(spec.warning);
     }
+    if (!spec.config) {
+      continue;
+    }
     const pagePath = referencePagePath(ref.route);
     const { theme, ...passthrough } = ref.scalar ?? {};
     files.push({
@@ -2064,14 +2136,60 @@ ${options.languageIcons ?? ""}
     transparent;
 }
 
-/* Word wrap (markdown.code.wrap): long lines wrap instead of scrolling. The
-   attribute is set on <body> from config; default code keeps \`white-space: pre\`. */
+/* Word wrap: long lines wrap instead of scrolling, on every block
+   (markdown.code.wrap, an attribute on <body>) or on one (\`\`\`ts wrap, which
+   Shiki's fence-meta reader sets as data-wrap). Default code keeps
+   \`white-space: pre\`. */
 [data-blume-code-wrap] pre,
-[data-blume-code-wrap] pre code {
+[data-blume-code-wrap] pre code,
+pre[data-wrap],
+pre[data-wrap] code {
   overflow-wrap: break-word;
   white-space: pre-wrap;
 }
 
+/* An expandable block (\`\`\`ts expandable) starts collapsed to its first lines,
+   faded out toward the cut, with a toggle under it (added by the layout
+   script). Opened, it shows in full: no height cap and no inner scroll. The
+   collapse needs that script to undo it, so a page without scripting shows
+   the block the ordinary way. */
+@media (scripting: enabled) {
+  .prose pre[data-expandable]:not([data-expanded]) > code {
+    max-height: calc(${EXPANDABLE_VISIBLE_LINES}lh + ${CODE_SCROLL_INSET_REM}rem);
+    mask-image: linear-gradient(to bottom, #000 calc(100% - 3lh), transparent);
+    overflow-y: hidden;
+  }
+}
+
+.prose pre[data-expandable][data-expanded] > code {
+  max-height: none;
+}
+
+[data-blume-code-expand] {
+  align-items: center;
+  color: var(--blume-muted-foreground);
+  display: flex;
+  font-family: var(--font-sans);
+  font-size: 0.75rem;
+  font-weight: 500;
+  gap: 0.25rem;
+  justify-content: center;
+  padding-top: 0.5rem;
+  width: 100%;
+}
+
+[data-blume-code-expand]:hover {
+  color: var(--blume-foreground);
+}
+
+[data-blume-code-expand] svg {
+  transition: transform 150ms;
+}
+
+[data-blume-code-expand][aria-expanded="true"] svg {
+  transform: rotate(180deg);
+}
+
 .prose :where(table) {
   font-size: 0.8125rem;
 }
@@ -2183,6 +2301,12 @@ blume-tabs pre[data-language],
   padding-inline-end: 3.5rem;
 }
 
+/* With the assistant on, an Ask button sits beside the copy button, so the
+   line's tail clears both. */
+.prose :is(blume-tabs pre, .not-prose pre, pre:not([data-language])):not(.twoslash, .twoslash pre, blume-panel-tabs *):has(> [data-blume-ask]) > code {
+  padding-inline-end: 5.75rem;
+}
+
 blume-tabs pre[data-language]::before,
 .not-prose pre[data-language]::before {
   content: none;
@@ -2433,10 +2557,10 @@ ${options.userCss}
 `;
 
 // src/theme/sources.ts
-import { dirname as dirname5, isAbsolute as isAbsolute3, relative as relative2, resolve as resolve4 } from "pathe";
+import { dirname as dirname6, isAbsolute as isAbsolute3, relative as relative2, resolve as resolve4 } from "pathe";
 var SOURCE_DIRECTIVE = /@source(?<not>\s+not)?\s+(?<quote>["'])(?<path>[^"']+)\k<quote>/gu;
 var rebaseSourceDirectives = (css, options) => {
-  const base = dirname5(options.from);
+  const base = dirname6(options.from);
   return css.replace(SOURCE_DIRECTIVE, (directive, not, quote, path) => {
     if (isAbsolute3(path)) {
       return directive;
@@ -2531,7 +2655,7 @@ ${OVERRIDES}`;
 // src/astro/examples.ts
 import { readFile as readFile3 } from "node:fs/promises";
 import pMap from "p-map";
-import { isAbsolute as isAbsolute4, join as join9, relative as relative3 } from "pathe";
+import { isAbsolute as isAbsolute4, join as join10, relative as relative3 } from "pathe";
 import { glob } from "tinyglobby";
 var FRAMEWORK_BY_EXT = {
   astro: "astro",
@@ -2560,7 +2684,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 = join9(root, base);
+  const dir = join10(root, base);
   const matches = await glob([rest], {
     absolute: true,
     cwd: dir,
@@ -2609,26 +2733,26 @@ var exampleMarkdownLookup = (examples) => Object.fromEntries(examples.map((examp
 import { existsSync as existsSync5, realpathSync } from "node:fs";
 import {
   basename,
-  dirname as dirname6,
+  dirname as dirname7,
   isAbsolute as isAbsolute5,
-  join as join10,
+  join as join11,
   normalize,
   relative as relative4,
   resolve as resolve5
 } from "pathe";
 var depsCandidates = (pkgDir) => [
-  join10(pkgDir, "node_modules"),
-  dirname6(pkgDir)
+  join11(pkgDir, "node_modules"),
+  dirname7(pkgDir)
 ];
-var candidateHolding = (pkgDir, ...segments) => depsCandidates(pkgDir).find((dir) => existsSync5(join10(dir, ...segments))) ?? null;
+var candidateHolding = (pkgDir, ...segments) => depsCandidates(pkgDir).find((dir) => existsSync5(join11(dir, ...segments))) ?? null;
 var packageDirFrom = (name, fromDir) => {
   let dir = normalize(fromDir);
   while (true) {
-    const candidate = join10(dir, "node_modules", name);
-    if (existsSync5(join10(candidate, "package.json"))) {
+    const candidate = join11(dir, "node_modules", name);
+    if (existsSync5(join11(candidate, "package.json"))) {
       return normalize(realpathSync(candidate));
     }
-    const parent = dirname6(dir);
+    const parent = dirname7(dir);
     if (parent === dir) {
       return null;
     }
@@ -2637,13 +2761,13 @@ var packageDirFrom = (name, fromDir) => {
 };
 
 // src/astro/generate.ts
-var BLUME_SRC = join11(packageRoot(), "src");
+var BLUME_SRC = join12(packageRoot(), "src");
 var resolveReactCompiler = (config, needsReact, pkgDir = packageRoot()) => {
   if (!(needsReact && config.react.compiler)) {
     return null;
   }
   try {
-    return createRequire2(pathToFileURL(join11(pkgDir, "_.js")).href).resolve("babel-plugin-react-compiler");
+    return createRequire2(pathToFileURL(join12(pkgDir, "_.js")).href).resolve("babel-plugin-react-compiler");
   } catch {
     return null;
   }
@@ -2653,7 +2777,7 @@ var reactCompilerWarnings = (config, needsReact, compilerPath) => needsReact &&
 ] : [];
 var resolveAstroPackageJson = (modulesDir) => {
   try {
-    return realpathSync2(join11(modulesDir, "astro", "package.json"));
+    return realpathSync2(join12(modulesDir, "astro", "package.json"));
   } catch {
     return null;
   }
@@ -2661,12 +2785,12 @@ var resolveAstroPackageJson = (modulesDir) => {
 var resolvedAstroHit = (fromDir) => {
   let dir = normalize2(fromDir);
   while (true) {
-    const modulesDir = join11(dir, "node_modules");
+    const modulesDir = join12(dir, "node_modules");
     const pkg = resolveAstroPackageJson(modulesDir);
     if (pkg) {
       return { modulesDir, pkg };
     }
-    const parent = dirname7(dir);
+    const parent = dirname8(dir);
     if (parent === dir) {
       return null;
     }
@@ -2699,13 +2823,13 @@ var linkDepsJunction = async (link, depsDir) => {
       return;
     }
     try {
-      if (resolve6(dirname7(link), await readlink(link)) === resolve6(depsDir)) {
+      if (resolve6(dirname8(link), await readlink(link)) === resolve6(depsDir)) {
         return;
       }
     } catch {}
     await rm2(link, { force: true });
   }
-  await mkdir2(dirname7(link), { recursive: true });
+  await mkdir2(dirname8(link), { recursive: true });
   await symlinkDir(depsDir, link);
 };
 var readPkgVersion = (pkgJsonPath) => {
@@ -2738,7 +2862,7 @@ var dropStaleDepsLink = async (link, pkgDir) => {
   let linkedBlume;
   let runningBlume;
   try {
-    linkedBlume = await realpath(join11(link, "blume"));
+    linkedBlume = await realpath(join12(link, "blume"));
     runningBlume = await realpath(pkgDir);
   } catch {
     return;
@@ -2754,7 +2878,7 @@ var ensureDepsLink = async (outDir, pkgDir = packageRoot()) => {
   }
   const mdxDir = candidateHolding(pkgDir, "@astrojs", "mdx");
   const blumeAstro = resolveAstroPackageJson(astroDir);
-  await dropStaleDepsLink(join11(outDir, "node_modules"), pkgDir);
+  await dropStaleDepsLink(join12(outDir, "node_modules"), pkgDir);
   const outDirHit = resolvedAstroHit(outDir);
   const astroCorrect = blumeAstro !== null && outDirHit?.pkg === blumeAstro;
   const walkLandsInDeps = astroCorrect && outDirHit !== null && sameRealDir(outDirHit.modulesDir, astroDir);
@@ -2762,16 +2886,16 @@ var ensureDepsLink = async (outDir, pkgDir = packageRoot()) => {
     return null;
   }
   if (mdxDir && (mdxDir === astroDir || astroCorrect)) {
-    await linkDepsJunction(join11(outDir, "node_modules"), mdxDir);
+    await linkDepsJunction(join12(outDir, "node_modules"), mdxDir);
     return null;
   }
   return astroConflictWarning(blumeAstro, outDirHit?.pkg ?? null);
 };
-var examplesCssFile = (root, config) => config.examples.css ? join11(root, config.examples.css) : null;
+var examplesCssFile = (root, config) => config.examples.css ? join12(root, config.examples.css) : null;
 var writeExamplesPreview = async (options) => {
   const { config, hasExamples, root, srcDir, write } = options;
   if (hasExamples) {
-    await write(join11(srcDir, "pages", ...config.basePath.split("/").filter(Boolean), "blume-examples", "[...path].astro"), examplesPageTemplate());
+    await write(join12(srcDir, "pages", ...config.basePath.split("/").filter(Boolean), "blume-examples", "[...path].astro"), examplesPageTemplate());
   }
   const cssFile = examplesCssFile(root, config);
   return cssFile && !existsSync6(cssFile) ? [
@@ -2808,7 +2932,7 @@ var detectUsesMath = async (root, staged = []) => {
     ignore: ["**/node_modules/**", "**/.blume/**", "**/dist/**"],
     onlyFiles: true
   });
-  const contents = await pMap2(files, (file) => readOptional(join11(root, file)), {
+  const contents = await pMap2(files, (file) => readOptional(join12(root, file)), {
     concurrency: READ_CONCURRENCY2
   });
   return [...contents, ...staged].some(containsMath);
@@ -2870,7 +2994,7 @@ var writeStagedContent = async (out, staged) => {
   const contentDir = stagedContentDir(out);
   const written = new Set;
   await Promise.all([...staged].map(async ([entryId, text]) => {
-    const path = join11(contentDir, entryId);
+    const path = join12(contentDir, entryId);
     written.add(normalize2(path));
     await writeIfChanged(path, text);
   }));
@@ -2885,13 +3009,13 @@ var readLogoSvg = (project, source) => {
   }
   const rel = source.replace(/^\//u, "");
   const file = [
-    join11(project.context.root, "public", rel),
-    join11(project.context.root, rel)
+    join12(project.context.root, "public", rel),
+    join12(project.context.root, rel)
   ].find((path) => existsSync6(path));
   return file ? readFileSync3(file, "utf-8") : undefined;
 };
 var isStringShorthand = (value) => typeof value === "string";
-var headerRepoUrl = (repo, derived) => {
+var footerRepoUrl = (repo, derived) => {
   if (isStringShorthand(repo)) {
     return repo;
   }
@@ -2942,10 +3066,10 @@ var faviconType = (name) => {
 var inlineDataUri = (file, type) => `data:${type};base64,${readFileSync3(file).toString("base64")}`;
 var defaultFavicon = () => ({
   dark: {
-    href: inlineDataUri(join11(BLUME_SRC, "assets", "icon-dark.png"), "image/png"),
+    href: inlineDataUri(join12(BLUME_SRC, "assets", "icon-dark.png"), "image/png"),
     type: "image/png"
   },
-  href: inlineDataUri(join11(BLUME_SRC, "assets", "icon.png"), "image/png"),
+  href: inlineDataUri(join12(BLUME_SRC, "assets", "icon.png"), "image/png"),
   type: "image/png"
 });
 var APPLE_ICON_CANDIDATES = [
@@ -2957,12 +3081,12 @@ var APPLE_ICON_CANDIDATES = [
 var resolveIconFile = (project, candidates) => {
   const { root } = project.context;
   for (const name of candidates) {
-    if (existsSync6(join11(root, "public", name))) {
+    if (existsSync6(join12(root, "public", name))) {
       return { href: `/${name}`, type: faviconType(name) };
     }
   }
   for (const name of candidates) {
-    const file = join11(root, name);
+    const file = join12(root, name);
     if (existsSync6(file)) {
       const type = faviconType(name);
       return { href: inlineDataUri(file, type ?? "image/x-icon"), type };
@@ -2973,18 +3097,18 @@ var resolveIconFile = (project, candidates) => {
 var resolveFavicon = (project) => {
   const { root } = project.context;
   for (const name of FAVICON_CANDIDATES) {
-    if (existsSync6(join11(root, "public", name))) {
+    if (existsSync6(join12(root, "public", name))) {
       const type = faviconType(name);
       const sibling = darkSibling(name);
-      return existsSync6(join11(root, "public", sibling)) ? { dark: { href: `/${sibling}`, type }, href: `/${name}`, type } : { href: `/${name}`, type };
+      return existsSync6(join12(root, "public", sibling)) ? { dark: { href: `/${sibling}`, type }, href: `/${name}`, type } : { href: `/${name}`, type };
     }
   }
   for (const name of FAVICON_CANDIDATES) {
-    const file = join11(root, name);
+    const file = join12(root, name);
     if (existsSync6(file)) {
       const type = faviconType(name);
       const mime = type ?? "image/x-icon";
-      const siblingFile = join11(root, darkSibling(name));
+      const siblingFile = join12(root, darkSibling(name));
       return existsSync6(siblingFile) ? {
         dark: { href: inlineDataUri(siblingFile, mime), type },
         href: inlineDataUri(file, mime),
@@ -3006,10 +3130,31 @@ var resolveBanner = (config) => {
   return {
     content: banner.content,
     dismissible: banner.dismissible,
-    key: banner.id ?? banner.content,
+    key: banner.id ?? resolveLocalizable(banner.content, undefined, config.i18n?.defaultLocale),
     link: banner.link
   };
 };
+var playgroundProxyPattern = (config) => withBasePath(config.basePath, "/_api-proxy");
+var resolveApiPages = (config) => {
+  const { auth, playground, server } = config.api;
+  const resolved = {
+    playground: {
+      enabled: playground.enabled,
+      proxy: playground.proxy === true ? playgroundProxyPattern(config) : playground.proxy
+    }
+  };
+  if (auth) {
+    resolved.auth = auth;
+  }
+  if (server) {
+    resolved.server = server;
+  }
+  return resolved;
+};
+var resolveFooter = (config) => {
+  const { footer } = config;
+  return footer && (footer.links.length > 0 || Object.keys(footer.socials).length > 0) ? footer : null;
+};
 var resolveOgMark = (project, siteLogo) => {
   const configured = project.config.seo.og.logo;
   if (configured === false) {
@@ -3043,6 +3188,18 @@ var resolveGithubData = (github) => github ? {
   owner: github.owner,
   repo: github.repo
 } : null;
+var resolveAssistant = (config) => {
+  const { assistant } = config.ai;
+  if (!assistant?.enabled) {
+    return null;
+  }
+  return {
+    captcha: assistant.captcha ? captchaSettings(assistant.captcha) : null,
+    endpoint: assistant.endpoint ?? null,
+    suggestions: assistant.suggestions,
+    support: assistant.support ?? null
+  };
+};
 var buildRuntimeData = (project) => {
   const { config, context, graph, manifest } = project;
   const { github } = config;
@@ -3056,14 +3213,14 @@ var buildRuntimeData = (project) => {
     }
     const rel = relative5(context.root, sourcePath).split("\\").join("/");
     const editDir = trimChar(github?.dir ?? "", "/");
-    const editPath = normalize2(editDir ? join11(editDir, rel) : rel);
+    const editPath = normalize2(editDir ? join12(editDir, rel) : rel);
     if (editPath.startsWith("..") || isAbsolute6(editPath)) {
       return null;
     }
     return `${editBase}/${editPath}`;
   };
   const { i18n } = config;
-  const markUrl = headerRepoUrl(config.navigation.repo, repoUrl2);
+  const markUrl = footerRepoUrl(config.navigation.repo, repoUrl2);
   const withRepoUrl = (nav) => ({
     ...nav,
     repoUrl: markUrl
@@ -3093,15 +3250,14 @@ var buildRuntimeData = (project) => {
   const data = {
     config: {
       analytics: config.analytics,
+      api: resolveApiPages(config),
       appleIcon: resolveAppleIcon(project),
-      assistant: config.ai.assistant?.enabled ? {
-        endpoint: config.ai.assistant.endpoint ?? null,
-        suggestions: config.ai.assistant.suggestions
-      } : null,
+      assistant: resolveAssistant(config),
       banner: resolveBanner(config),
       basePath: config.basePath,
       codeThemes: config.markdown.code.theme,
       codeWrap: config.markdown.code.wrap,
+      consent: config.consent,
       dateFormat: config.dateFormat,
       description: config.description,
       discovery: {
@@ -3112,7 +3268,9 @@ var buildRuntimeData = (project) => {
         sitemap: config.seo.sitemap && Boolean(config.deployment.options.site)
       },
       favicon: resolveFavicon(project),
-      feedback: config.feedback,
+      feedback: config.feedback.enabled,
+      feedbackComments: config.feedback.comments,
+      footer: resolveFooter(config),
       github: resolveGithubData(github),
       i18n: i18n ? {
         defaultLocale: i18n.defaultLocale,
@@ -3122,7 +3280,8 @@ var buildRuntimeData = (project) => {
           code,
           dir,
           label
-        }))
+        })),
+        routeByBrowserLanguage: i18n.routeByBrowserLanguage
       } : null,
       identity: config.seo.organization || config.seo.software ? {
         organization: config.seo.organization,
@@ -3134,6 +3293,8 @@ var buildRuntimeData = (project) => {
         name: config.agents.mcp.name ?? config.title,
         route: config.agents.mcp.route
       } : null,
+      metatags: config.seo.metatags ?? null,
+      narration: config.narration.enabled ? { generated: config.narration.provider !== null } : null,
       og: {
         description: resolveOgDescription(config),
         enabled: config.seo.og.enabled ?? false,
@@ -3202,7 +3363,7 @@ var buildRuntimeData = (project) => {
 var planMcp = (project, srcDir, userPages) => {
   const { config } = project;
   const { route } = config.agents.mcp;
-  const dir = join11(srcDir, "blume-mcp");
+  const dir = join12(srcDir, "blume-mcp");
   const base = {
     dir,
     discoveryPages: [],
@@ -3226,11 +3387,11 @@ var planMcp = (project, srcDir, userPages) => {
     ...base,
     discoveryPages: [
       {
-        entrypoint: join11(dir, "discovery.ts"),
+        entrypoint: join12(dir, "discovery.ts"),
         pattern: "/.well-known/mcp.json"
       },
       {
-        entrypoint: join11(dir, "server-card.ts"),
+        entrypoint: join12(dir, "server-card.ts"),
         pattern: "/.well-known/mcp/server-card.json"
       }
     ],
@@ -3257,9 +3418,9 @@ var writeMcpFiles = async (plan, write, data) => {
     version: data.version
   };
   await Promise.all([
-    write(join11(plan.srcDir, "pages", mcpPageFile(plan.route)), mcpEndpointTemplate()),
-    write(join11(plan.dir, "discovery.ts"), staticJsonEndpointTemplate(buildMcpDiscovery(discoveryInput))),
-    write(join11(plan.dir, "server-card.ts"), staticJsonEndpointTemplate(buildMcpServerCard(discoveryInput)))
+    write(join12(plan.srcDir, "pages", mcpPageFile(plan.route)), mcpEndpointTemplate()),
+    write(join12(plan.dir, "discovery.ts"), staticJsonEndpointTemplate(buildMcpDiscovery(discoveryInput))),
+    write(join12(plan.dir, "server-card.ts"), staticJsonEndpointTemplate(buildMcpServerCard(discoveryInput)))
   ]);
 };
 var ownsApiRest = (page) => page.pattern.startsWith("/api/[");
@@ -3271,7 +3432,7 @@ var planApi = (project, srcDir, userPages) => {
     catchAll: server && !userPages.some(ownsApiRest) && !project.graph.pages.some(contentUnderApi),
     enabled: config.agents.api,
     server,
-    spec: !routeIsTaken(userPages, project.graph.pages, OPENAPI_PATH) && !existsSync6(join11(context.root, "public", "openapi.json")),
+    spec: !routeIsTaken(userPages, project.graph.pages, OPENAPI_PATH) && !existsSync6(join12(context.root, "public", "openapi.json")),
     srcDir
   };
 };
@@ -3281,20 +3442,20 @@ var writeApiFiles = async (project, plan, write, data, mcp) => {
   }
   const { config } = project;
   const mcpRoute = mcp.enabled ? mcp.route : null;
-  const apiDir = join11(plan.srcDir, "pages", "api");
+  const apiDir = join12(plan.srcDir, "pages", "api");
   const writes = [
-    write(join11(apiDir, "docs", "pages.json.ts"), apiPagesIndexTemplate()),
-    write(join11(apiDir, "docs", "pages", "[...route].json.ts"), apiPageTemplate()),
-    write(join11(apiDir, "docs", "navigation.json.ts"), apiNavigationTemplate())
+    write(join12(apiDir, "docs", "pages.json.ts"), apiPagesIndexTemplate()),
+    write(join12(apiDir, "docs", "pages", "[...route].json.ts"), apiPageTemplate()),
+    write(join12(apiDir, "docs", "navigation.json.ts"), apiNavigationTemplate())
   ];
   if (plan.server) {
-    writes.push(write(join11(apiDir, "docs", "search.ts"), apiSearchTemplate()));
+    writes.push(write(join12(apiDir, "docs", "search.ts"), apiSearchTemplate()));
   }
   if (plan.catchAll) {
-    writes.push(write(join11(apiDir, "[...path].ts"), apiNotFoundTemplate({ base: data.base, site: data.site })));
+    writes.push(write(join12(apiDir, "[...path].ts"), apiNotFoundTemplate({ base: data.base, site: data.site })));
   }
   if (plan.spec) {
-    writes.push(write(join11(plan.srcDir, "pages", "openapi.json.ts"), staticJsonEndpointTemplate(buildApiSpec({
+    writes.push(write(join12(plan.srcDir, "pages", "openapi.json.ts"), staticJsonEndpointTemplate(buildApiSpec({
       agentReadability: config.agents.agentReadability,
       base: data.base,
       description: config.description,
@@ -3308,11 +3469,10 @@ var writeApiFiles = async (project, plan, write, data, mcp) => {
   }
   await Promise.all(writes);
 };
-var PLAYGROUND_PROXY_ENTRY = join11("blume-openapi", "api-proxy.ts");
-var playgroundProxyPattern = (config) => withBasePath(config.basePath, "/_api-proxy");
+var PLAYGROUND_PROXY_ENTRY = join12("blume-openapi", "api-proxy.ts");
 var planPlaygroundProxy = (config, srcDir) => ({
   enabled: needsPlaygroundProxy(config),
-  entrypoint: join11(srcDir, PLAYGROUND_PROXY_ENTRY),
+  entrypoint: join12(srcDir, PLAYGROUND_PROXY_ENTRY),
   pattern: playgroundProxyPattern(config)
 });
 var specOriginsOf = (spec) => {
@@ -3344,6 +3504,27 @@ var specOriginsOf = (spec) => {
   return [...origins];
 };
 var specOrigins = (data) => [...new Set(Object.values(data).flatMap(specOriginsOf))].toSorted();
+var originOf = (url) => {
+  try {
+    return new URL(url).origin;
+  } catch {
+    return null;
+  }
+};
+var apiPageOrigins = (project) => {
+  const { config } = project;
+  if (!apiPagesUseBuiltinProxy(config)) {
+    return [];
+  }
+  const targets = project.graph.pages.map((page) => parseApiEndpoint(page.meta.api ?? "")?.target ?? "");
+  return [config.api.server ?? "", ...targets].flatMap((target) => {
+    const origin = originOf(target);
+    return origin ? [origin] : [];
+  });
+};
+var apiPageProxyWarnings = (project) => apiPagesUseBuiltinProxy(project.config) && apiPageOrigins(project).length === 0 ? [
+  "api.playground.proxy is true, but api.server isn't an absolute URL and no page's api frontmatter names one, so the built-in proxy has no origin to allow and will refuse every request the endpoint pages send. Set api.server to the API's URL, like https://api.acme.com/v1."
+] : [];
 var proxyAllowlistWarnings = (config, data) => {
   const proxied = new Set(builtinProxyReferences(config).map((reference) => reference.slug));
   const warnings = [];
@@ -3364,10 +3545,13 @@ var writeAskFiles = async (project, srcDir, write, modules) => {
   if (backend.grounded) {
     modules.set("blume:ask-data", JSON.stringify(await buildAskData(project)));
   }
-  await write(join11(srcDir, "pages", "api", "ask.ts"), askEndpointTemplate(backend, {
+  await write(join12(srcDir, "pages", "api", "ask.ts"), askEndpointTemplate(backend, {
+    captcha: assistant.captcha,
     cors: assistant.cors,
     instructions: assistant.instructions,
-    retrieval: assistant.retrieval
+    rateLimit: project.config.rateLimit,
+    retrieval: assistant.retrieval,
+    tools: assistant.tools ?? backend.toolsByDefault
   }));
 };
 var writeNotFoundPage = async (write, srcDir, pages, contentPages) => {
@@ -3375,9 +3559,9 @@ var writeNotFoundPage = async (write, srcDir, pages, contentPages) => {
     return;
   }
   await Promise.all([
-    write(join11(srcDir, "pages", "404.astro"), notFoundPageTemplate()),
-    write(join11(srcDir, "pages", "404.md.ts"), notFoundMarkdownTemplate()),
-    write(join11(srcDir, "pages", "404.json.ts"), notFoundJsonTemplate())
+    write(join12(srcDir, "pages", "404.astro"), notFoundPageTemplate()),
+    write(join12(srcDir, "pages", "404.md.ts"), notFoundMarkdownTemplate()),
+    write(join12(srcDir, "pages", "404.json.ts"), notFoundJsonTemplate())
   ]);
 };
 var diagnosticWarning = (diagnostic) => diagnostic.suggestion ? `${diagnostic.message} ${diagnostic.suggestion}` : diagnostic.message;
@@ -3420,20 +3604,21 @@ var languageIconCssFrom = (project, rawMarkdown) => languageIconCss(languageIcon
 ].join(`
 `)));
 var languageIconCssFor = async (project) => languageIconCssFrom(project, await buildRawMarkdown(project));
-var writeNavFragments = (write, srcDir, navFragments) => navFragments ? write(join11(srcDir, "pages", "blume-nav", "[version]", "[locale]", "[id].astro"), navFragmentTemplate()) : Promise.resolve(false);
+var writeNavFragments = (write, srcDir, navFragments) => navFragments ? write(join12(srcDir, "pages", "blume-nav", "[version]", "[locale]", "[id].astro"), navFragmentTemplate()) : Promise.resolve(false);
 var clientFeaturesFor = async (project) => clientFeaturesFrom(project, await buildRawMarkdown(project));
 var generateRuntime = async (project) => {
   const { context, config } = project;
   assertFontFilesExist(project);
   const out = context.outDir;
-  const srcDir = join11(out, "src");
-  const generatedDir = join11(srcDir, "generated");
-  const askPath = join11(srcDir, "generated", "Ask.astro");
-  const themePath = join11(srcDir, "generated", "app.css");
-  const searchClientPath = join11(srcDir, "generated", "search-client.ts");
-  const featuresPath = join11(srcDir, "generated", "features.ts");
-  const examplesPath = join11(srcDir, "generated", "examples.ts");
-  const examplesThemePath = join11(srcDir, "generated", "examples.css");
+  const srcDir = join12(out, "src");
+  const generatedDir = join12(srcDir, "generated");
+  const askPath = join12(srcDir, "generated", "Ask.astro");
+  const themePath = join12(srcDir, "generated", "app.css");
+  const searchClientPath = join12(srcDir, "generated", "search-client.ts");
+  const consentClientPath = join12(srcDir, "generated", "consent-client.ts");
+  const featuresPath = join12(srcDir, "generated", "features.ts");
+  const examplesPath = join12(srcDir, "generated", "examples.ts");
+  const examplesThemePath = join12(srcDir, "generated", "examples.css");
   const written = new Set;
   const write = (path, content) => {
     written.add(normalize2(path));
@@ -3442,7 +3627,7 @@ var generateRuntime = async (project) => {
   const modules = new Map;
   const depsLinkWarning = await ensureDepsLink(out);
   const contentRoutes = markdownRoutePaths(project);
-  const homeLinkHeader = buildHomeLinkHeader(config, contentRoutes) ?? undefined;
+  const homeLinkHeader = buildHomeLinkHeader(config, contentRoutes, "dev") ?? undefined;
   const assistantEnabled = config.ai.assistant?.enabled ?? false;
   const exportPdf = config.export.pdf;
   const exportEpub = config.export.epub;
@@ -3500,16 +3685,19 @@ var generateRuntime = async (project) => {
       pattern: playgroundProxy.pattern
     });
   }
-  const proxyOrigins = specOrigins(openApiData);
+  const proxyOrigins = [
+    ...new Set([...specOrigins(openApiData), ...apiPageOrigins(project)])
+  ].toSorted();
   const hasStaged = staged.size > 0;
   const hasFilesystemSource = project.sources.some((source) => !source.staged);
   const docsCollection = resolveDocsCollection(config, context.root);
   const [structural] = await Promise.all([
     Promise.all([
-      write(join11(out, "astro.config.mjs"), astroConfigTemplate({
+      write(join12(out, "astro.config.mjs"), astroConfigTemplate({
         aliases: resolveTsconfigAliases(context.root),
         askPath,
         config,
+        consentClientPath,
         contentRoot: docsCollection.base,
         contentRoutes,
         context,
@@ -3526,16 +3714,16 @@ var generateRuntime = async (project) => {
         searchClientPath,
         themePath
       })),
-      write(join11(out, "package.json"), runtimePackageTemplate(runtimeDependencies({ config, needsReact, needsSvelte, needsVue }))),
-      write(join11(out, "tsconfig.json"), runtimeTsconfigTemplate()),
-      write(join11(srcDir, "content.config.ts"), contentConfigTemplate({
+      write(join12(out, "package.json"), runtimePackageTemplate(runtimeDependencies({ config, needsReact, needsSvelte, needsVue }))),
+      write(join12(out, "tsconfig.json"), runtimeTsconfigTemplate()),
+      write(join12(srcDir, "content.config.ts"), contentConfigTemplate({
         collection: docsCollection,
         config,
         context,
         filesystem: hasFilesystemSource,
         staged: hasStaged
       })),
-      write(join11(srcDir, "pages", "[...slug].astro"), catchAllPageTemplate({
+      write(join12(srcDir, "pages", "[...slug].astro"), catchAllPageTemplate({
         exportEpub,
         exportPdf,
         mathEnabled: usesMath,
@@ -3544,8 +3732,8 @@ var generateRuntime = async (project) => {
       })),
       writeNavFragments(write, srcDir, navFragments),
       write(askPath, askComponentTemplate(assistantEnabled)),
-      write(join11(srcDir, "generated", "components.ts"), slotPlan.module),
-      write(join11(srcDir, "generated", "examples.ts"), exampleMapTemplate(exampleDiscovery.examples, config.basePath)),
+      write(join12(srcDir, "generated", "components.ts"), slotPlan.module),
+      write(join12(srcDir, "generated", "examples.ts"), exampleMapTemplate(exampleDiscovery.examples, config.basePath)),
       write(examplesThemePath, examplesEntryTemplate({
         configTokens: buildThemeCss(config.theme),
         sources: exampleScanRoots(context.root, exampleDiscovery.dir).map((dir) => `${dir}/${EXAMPLE_SCAN_GLOB}`),
@@ -3562,15 +3750,15 @@ var generateRuntime = async (project) => {
         userTheme
       }))
     ]),
-    Promise.all(slotPlan.wrappers.map((wrapper) => write(join11(srcDir, "generated", "component-slots", `${wrapper.name}.astro`), wrapper.content))),
-    Promise.all(exampleDiscovery.examples.map((example) => write(join11(srcDir, "generated", "examples", `${exampleSlug(example.path)}.astro`), exampleWrapperTemplate(example)))),
+    Promise.all(slotPlan.wrappers.map((wrapper) => write(join12(srcDir, "generated", "component-slots", `${wrapper.name}.astro`), wrapper.content))),
+    Promise.all(exampleDiscovery.examples.map((example) => write(join12(srcDir, "generated", "examples", `${exampleSlug(example.path)}.astro`), exampleWrapperTemplate(example)))),
     writeAskFiles(project, srcDir, write, modules),
     writeMcpFiles(mcp, write, agentData),
     writeApiFiles(project, api, write, agentData, mcp),
     playgroundProxy.enabled ? write(playgroundProxy.entrypoint, playgroundProxyTemplate(proxyOrigins)) : Promise.resolve(false)
   ]);
   if (config.seo.og.enabled) {
-    await write(join11(srcDir, "pages", "og", "[...slug].png.ts"), ogEndpointTemplate(ogRoutes, {
+    await write(join12(srcDir, "pages", "og", "[...slug].png.ts"), ogEndpointTemplate(ogRoutes, {
       ...projectOgFonts(project),
       cache: {
         dir: ogCacheDir(project.context),
@@ -3580,7 +3768,7 @@ var generateRuntime = async (project) => {
     }, changelogIndex));
   }
   if (changelogIndex) {
-    await write(join11(srcDir, "pages", "changelog.astro"), changelogIndexTemplate({
+    await write(join12(srcDir, "pages", "changelog.astro"), changelogIndexTemplate({
       exportEpub,
       exportPdf,
       needsReact,
@@ -3597,36 +3785,38 @@ var generateRuntime = async (project) => {
     }),
     writeNotFoundPage(write, srcDir, pages, project.graph.pages),
     write(searchClientPath, searchClientTemplate(config)),
+    write(consentClientPath, consentClientTemplate(config.consent)),
     write(featuresPath, featuresTemplate(clientFeatures))
   ]);
   const searchAdapter = config.search.provider;
   if (searchAdapter.mode === "static") {
     const documents = await buildSearchDocuments(project);
     modules.set("blume:search-index", JSON.stringify(documents));
-    await write(join11(srcDir, "pages", "blume-search.json.ts"), searchEndpointTemplate());
+    await write(join12(srcDir, "pages", "blume-search.json.ts"), searchEndpointTemplate());
   }
   if (searchAdapter.kind === "mixedbread") {
-    await write(join11(srcDir, "pages", "api", "search.ts"), mixedbreadSearchEndpointTemplate(searchAdapter.options));
+    await write(join12(srcDir, "pages", "api", "search.ts"), mixedbreadSearchEndpointTemplate(searchAdapter.options));
   }
-  await write(join11(srcDir, "generated", "includes.json"), `${JSON.stringify(buildIncludeGraph(project.graph.pages))}
+  await write(join12(srcDir, "generated", "includes.json"), `${JSON.stringify(buildIncludeGraph(project.graph.pages))}
 `);
   modules.set("blume:raw-markdown", JSON.stringify(rawMarkdown));
   const contentAssets = await collectContentAssets(project);
   modules.set("blume:content-assets", JSON.stringify(contentAssets));
   await Promise.all([
-    write(join11(srcDir, "pages", "[...slug].md.ts"), rawMarkdownEndpointTemplate("md")),
-    write(join11(srcDir, "pages", "[...slug].mdx.ts"), rawMarkdownEndpointTemplate("mdx")),
-    write(join11(srcDir, "pages", "blume-assets", "[...asset].ts"), contentAssetsEndpointTemplate(join11(project.context.outDir, "public", "blume-assets")))
+    write(join12(srcDir, "pages", "[...slug].md.ts"), rawMarkdownEndpointTemplate("md")),
+    write(join12(srcDir, "pages", "[...slug].mdx.ts"), rawMarkdownEndpointTemplate("mdx")),
+    write(join12(srcDir, "pages", "blume-assets", "[...asset].ts"), contentAssetsEndpointTemplate(join12(project.context.outDir, "public", "blume-assets")))
   ]);
   const feeds = buildRssFeeds(project);
   if (feeds.length > 0) {
     const feedXml = Object.fromEntries(feeds.map((feed) => [feed.type, renderRssFeed(feed)]));
     modules.set("blume:rss", JSON.stringify(feedXml));
-    await write(join11(srcDir, "pages", "[section]", "rss.xml.ts"), rssEndpointTemplate());
+    await write(join12(srcDir, "pages", "[section]", "rss.xml.ts"), rssEndpointTemplate());
   }
   const warnings = [
     ...depsLinkWarning ? [depsLinkWarning] : [],
     ...proxyAllowlistWarnings(config, openApiData),
+    ...apiPageProxyWarnings(project),
     ...reactCompilerWarnings(config, needsReact, reactCompilerPath),
     ...mcp.warnings,
     ...islandDiscovery.warnings,
@@ -3658,12 +3848,12 @@ var generateRuntime = async (project) => {
       root: context.root
     });
     warnings.push(...references.warnings);
-    await Promise.all(references.files.map((file) => write(join11(srcDir, "pages", file.pagePath), file.content)));
+    await Promise.all(references.files.map((file) => write(join12(srcDir, "pages", file.pagePath), file.content)));
   }
   modules.set("blume:data", buildRuntimeData(project));
   modules.set("blume:openapi", JSON.stringify(openApiData));
   await Promise.all([
-    write(join11(out, "blume.manifest.json"), `${JSON.stringify(project.manifest, null, 2)}
+    write(join12(out, "blume.manifest.json"), `${JSON.stringify(project.manifest, null, 2)}
 `),
     writeStagedContent(out, staged)
   ]);
@@ -3673,7 +3863,7 @@ var generateRuntime = async (project) => {
   return { structuralChange: structural.some(Boolean), warnings };
 };
 
-export { publishBuildProject, refreshBlumeContent, showBlumeErrorOverlay, ogCacheDir, pruneCardCache, cardCacheTally, buildAskData, buildThemeCss, buildReferenceFiles, tailwindEntryTemplate, examplesEntryTemplate, rebaseSourceDirectives, twoslashCss, EXAMPLE_SCAN_GLOB, exampleScanRoots, discoverExamples, exampleMarkdownLookup, packageDirFrom, detectNeedsReact, detectUsesMath, collectStaged, buildRuntimeData, PLAYGROUND_PROXY_ENTRY, playgroundProxyPattern, specOrigins, proxyAllowlistWarnings, analyzeComponentsFile, languageIconCssFor, clientFeaturesFor, generateRuntime };
+export { publishBuildProject, refreshBlumeContent, showBlumeErrorOverlay, ogCacheDir, pruneCardCache, cardCacheTally, buildApiSpec, buildAskData, resolveOgFonts, buildReferenceFiles, tailwindEntryTemplate, examplesEntryTemplate, rebaseSourceDirectives, twoslashCss, EXAMPLE_SCAN_GLOB, exampleScanRoots, discoverExamples, exampleMarkdownLookup, packageDirFrom, detectNeedsReact, detectUsesMath, collectStaged, playgroundProxyPattern, buildRuntimeData, PLAYGROUND_PROXY_ENTRY, specOrigins, proxyAllowlistWarnings, analyzeComponentsFile, languageIconCssFor, clientFeaturesFor, generateRuntime };
 
-//# debugId=0D8B04D4ECFE76CE64756E2164756E21
-//# sourceMappingURL=chunk-xh43dwgw.js.map
+//# debugId=168B822A64F4126564756E2164756E21
+//# sourceMappingURL=chunk-zf748avv.js.map