blume 2.0.3 → 2.1.1

package/dist/cli/{chunk-c8chx29p.js → chunk-ep6nd0rn.js}

@@ -14,20 +14,25 @@ import {
   API_SEARCH_PATH,
   apiNamePhrase,
   resolveReferences,
-  referenceRoutes,
   hasScalarReferences,
   builtinProxyReferences,
+  apiPagesUseBuiltinProxy,
   needsPlaygroundProxy,
   buildMcpDiscovery,
   buildMcpServerCard,
   hasAiCatalog,
   buildHomeLinkHeader,
+  resolveLocalizable,
   resolveDocsCollection,
+  withChangelogIndexText,
   discoverPages,
   routeIsTaken,
   hasGeneratedChangelog,
+  navTargetRoutes,
   customOgRoutes,
   resolveAskBackend,
+  captchaSettings,
+  parseApiEndpoint,
   GOOGLE_FONTS,
   isFontSlug,
   fontLocaleCodes,
@@ -46,10 +51,11 @@ import {
   renderRssFeed,
   HTTP_METHODS,
   withServerDefaults,
+  readOverlaidSpec,
   isOpenApiSource,
   buildRawMarkdown,
   markdownRoutePaths
-} from "./chunk-pv29h0wf.js";
+} from "./chunk-ehweg4fr.js";
 import {
   trimChar,
   normalizeBasePath,
@@ -57,15 +63,16 @@ import {
   mountBasePath,
   siteRoot,
   absoluteUrl2
-} from "./chunk-3em5wd2y.js";
+} from "./chunk-zccbjcj0.js";
 import {
   validateSearchPopularIcons,
   validateNavTargets
-} from "./chunk-j85vccga.js";
+} from "./chunk-ncj7w596.js";
 import {
+  EXPANDABLE_VISIBLE_LINES,
   buildSearchDocuments,
   buildMcpData
-} from "./chunk-yfyb25rh.js";
+} from "./chunk-n0v7m8ry.js";
 import {
   planComponentSlots,
   publishRuntimeModules,
@@ -77,6 +84,7 @@ import {
   askComponentTemplate,
   searchEndpointTemplate,
   featuresTemplate,
+  consentClientTemplate,
   searchClientTemplate,
   mixedbreadSearchEndpointTemplate,
   rawMarkdownEndpointTemplate,
@@ -105,32 +113,138 @@ import {
   examplesPageTemplate,
   runtimePackageTemplate,
   runtimeTsconfigTemplate
-} from "./chunk-5m5nmvyq.js";
+} from "./chunk-gb420vvz.js";
+import {
+  validateUsedComponents,
+  missingExampleDiagnostics,
+  discoverIslands,
+  EXAMPLE_SCAN_GLOB,
+  exampleScanRoots,
+  discoverExamples,
+  exampleMarkdownLookup,
+  missingDependencyDiagnostic
+} from "./chunk-66w9j7p6.js";
 import {
   emptyComponentOverrides,
   analyzeComponentOverrides
-} from "./chunk-8ktnccpt.js";
+} from "./chunk-54ztw1nj.js";
 import {
   writeTextAtomic
 } from "./chunk-jq5n4avg.js";
 import {
-  registry
-} from "./chunk-r20tn01b.js";
+  resolveAccent,
+  resolveRadius,
+  buildThemeCss
+} from "./chunk-cm89scdv.js";
 import {
-  readClientMode,
-  discoverIslands,
-  missingDependencyDiagnostic
-} from "./chunk-b07cmahc.js";
+  registry
+} from "./chunk-c1y538kd.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/search/sync/algolia.ts
+var jsonBytes = (value) => Buffer.byteLength(JSON.stringify(value), "utf-8");
+var WIDEST_CHARACTER = jsonBytes("\x00");
 
 // src/deploy/sitemap.ts
 import { escape as escapeXml } from "html-escaper";
@@ -226,8 +340,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;
@@ -245,7 +359,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 = () => {
@@ -259,7 +373,7 @@ import { existsSync as existsSync6, readFileSync as readFileSync3, realpathSync
 import {
   lstat,
   mkdir as mkdir2,
-  readFile as readFile4,
+  readFile as readFile3,
   readlink,
   realpath,
   rm as rm2,
@@ -267,9 +381,9 @@ import {
 } from "node:fs/promises";
 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 { glob as glob2 } from "tinyglobby";
+import pMap from "p-map";
+import { dirname as dirname8, isAbsolute as isAbsolute5, join as join11, normalize as normalize2, relative as relative5, resolve as resolve6 } from "pathe";
+import { glob } from "tinyglobby";
 
 // src/ai/api/problem.ts
 var PROBLEM_TYPE = "application/problem+json";
@@ -813,6 +927,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
@@ -839,70 +959,6 @@ var navVariants = (data, hiddenDefault = null) => [
   })))
 ];
 
-// src/core/builtin-tags.ts
-var BUILTIN_MDX_TAGS = new Set([
-  "Accordion",
-  "AccordionItem",
-  "ApiOverview",
-  "ApiTagOperations",
-  "AutoTypeTable",
-  "Badge",
-  "Callout",
-  "Card",
-  "CardGroup",
-  "CodeBlock",
-  "CodeGroup",
-  "Color",
-  "Column",
-  "Columns",
-  "Component",
-  "Diff",
-  "Expandable",
-  "FileTree",
-  "Frame",
-  "GithubInfo",
-  "Icon",
-  "Math",
-  "Operation",
-  "Panel",
-  "Prompt",
-  "Step",
-  "Steps",
-  "Tab",
-  "Tabs",
-  "Tile",
-  "Tooltip",
-  "Tree",
-  "TypeTable",
-  "Visibility",
-  "YouTube"
-]);
-
-// src/core/component-diagnostics.ts
-var toKebab = (tag) => tag.replaceAll(/(?<lower>[a-z0-9])(?<upper>[A-Z])/gu, "$<lower>-$<upper>").toLowerCase();
-var validateUsedComponents = (pages, extraTags, registryNames) => {
-  const diagnostics = [];
-  const seen = new Set;
-  for (const page of pages) {
-    for (const tag of page.componentsUsed ?? []) {
-      if (BUILTIN_MDX_TAGS.has(tag) || extraTags.has(tag) || seen.has(tag)) {
-        continue;
-      }
-      seen.add(tag);
-      const name = toKebab(tag);
-      const suggestion = registryNames.has(name) ? `Run \`blume add ${name}\` to install it, or register <${tag}> in components.ts (mdx).` : `Register <${tag}> in components.ts (mdx), or add an islands/${tag}.tsx component.`;
-      diagnostics.push({
-        code: "BLUME_UNKNOWN_COMPONENT",
-        file: page.sourcePath ?? page.id,
-        message: `<${tag}> is used in ${page.route} but isn't a known component.`,
-        severity: "warning",
-        suggestion
-      });
-    }
-  }
-  return diagnostics;
-};
-
 // src/core/svg-dimensions.ts
 var ROOT = /<svg\s(?:[^>"']|"[^"]*"|'[^']*')*>/u;
 var WIDTH = /\swidth=(?<quote>['"])(?<value>[^%]+?)\k<quote>/u;
@@ -968,7 +1024,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,
@@ -990,7 +1046,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 {};
   }
@@ -998,7 +1054,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) {
@@ -1151,9 +1207,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";
@@ -1334,98 +1390,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, "/");
@@ -1441,11 +1421,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 {
@@ -1483,13 +1480,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({
@@ -1521,6 +1521,15 @@ var resolveSearchPopular = (popular, basePath) => popular.map(({ href, icon, lab
   return page;
 });
 
+// src/search/source-pages.ts
+import { relative as relative2 } from "pathe";
+var sourcePages = (project) => project.manifest.routes.flatMap((route) => route.indexable && route.sourcePath ? [
+  [
+    relative2(project.context.root, route.sourcePath),
+    { title: route.title, url: route.path }
+  ]
+] : []);
+
 // src/theme/code-block-padding.ts
 var CODE_PADDING_BLOCK_REM = 1;
 
@@ -2077,14 +2086,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;
 }
@@ -2196,6 +2251,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;
@@ -2363,8 +2424,11 @@ pre:has(.line.focused):hover .line:not(.focused) {
    Strip the surrounding chrome so the printout is just the article. Scoped to
    the chrome itself, never bare \`header\`/\`aside\`: content renders those too
    (every Callout and Panel is an <aside>, every changelog Update has a
-   <header>), and they belong in the printout. \`body > header\` keeps a
-   \`layout.Header\` override out as well. */
+   <header>), and they belong in the printout. \`body > header\` and
+   \`body > footer\` keep \`layout.Header\` and \`layout.Footer\` overrides out
+   as well. Everything after the article (directory and related-page cards,
+   last updated, feedback, prev/next) is page chrome too, and so are the
+   copy, ask, and expand buttons on code blocks. */
 @media print {
   [data-blume-banner],
   [data-blume-header],
@@ -2374,7 +2438,13 @@ pre:has(.line.focused):hover .line:not(.focused) {
   [data-blume-assistant-panel],
   [data-blume-page-actions],
   #blume-content > nav,
-  #blume-content > details {
+  #blume-content > details,
+  [data-blume-page-end],
+  [data-blume-footer],
+  body > footer,
+  [data-blume-copy],
+  [data-blume-ask],
+  [data-blume-code-expand] {
     display: none !important;
   }
 
@@ -2385,6 +2455,23 @@ pre:has(.line.focused):hover .line:not(.focused) {
     overflow: visible;
   }
 
+  /* A collapsed \`expandable\` block prints open: its toggle is hidden above,
+     so the collapse would cut the block off at its first lines. Same
+     selector as the collapse, so this later rule wins. */
+  .prose pre[data-expandable]:not([data-expanded]) > code {
+    mask-image: none;
+    max-height: none;
+    overflow-y: visible;
+  }
+
+  /* The theme script switches a dark page to light for printing
+     (\`beforeprint\`); a color transition would print mid-fade. */
+  *,
+  *::before,
+  *::after {
+    transition: none !important;
+  }
+
   #blume-content {
     padding: 0 !important;
   }
@@ -2446,15 +2533,15 @@ ${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 relative3, 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;
     }
-    const rebased = relative2(options.to, resolve4(base, path));
+    const rebased = relative3(options.to, resolve4(base, path));
     return `@source${not ?? ""} ${quote}${rebased}${quote}`;
   });
 };
@@ -2541,89 +2628,12 @@ var twoslashCss = () => {
 ${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 { glob } from "tinyglobby";
-var FRAMEWORK_BY_EXT = {
-  astro: "astro",
-  jsx: "react",
-  svelte: "svelte",
-  tsx: "react",
-  vue: "vue"
-};
-var EXAMPLE_FILE = /\.(?<ext>astro|jsx|svelte|tsx|vue)$/u;
-var DEFAULT_EXAMPLE_GLOB = "**/*.{astro,jsx,svelte,tsx,vue}";
-var READ_CONCURRENCY = 16;
-var EXAMPLE_SCAN_GLOB = "**/*.{astro,jsx,svelte,ts,tsx,vue}";
-var exampleScanRoots = (root, examplesDir) => {
-  const path = relative3(root, examplesDir);
-  const outside = path.startsWith("..") || isAbsolute4(path);
-  return outside ? [root, examplesDir] : [root];
-};
-var GLOB_MAGIC = /[!*?[\]{}]/u;
-var splitGlobBase = (pattern) => {
-  const segments = pattern.split("/");
-  const firstMagic = segments.findIndex((segment) => GLOB_MAGIC.test(segment));
-  return {
-    base: segments.slice(0, firstMagic).join("/"),
-    rest: segments.slice(firstMagic).join("/")
-  };
-};
-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 matches = await glob([rest], {
-    absolute: true,
-    cwd: dir,
-    onlyFiles: true
-  });
-  const files = matches.toSorted();
-  const sources = await pMap(files, (file) => readFile3(file, "utf-8"), {
-    concurrency: READ_CONCURRENCY
-  });
-  const examples = [];
-  const warnings = [];
-  const seen = new Map;
-  const collectExample = (file, source) => {
-    const ext = file.match(EXAMPLE_FILE)?.groups?.ext;
-    const framework = ext ? FRAMEWORK_BY_EXT[ext] : undefined;
-    if (!(ext && framework)) {
-      return;
-    }
-    const path = relative3(dir, file).slice(0, -(ext.length + 1));
-    const existing = seen.get(path);
-    if (existing) {
-      warnings.push(`Two examples both resolve to "${path}" ("${existing}" and "${file}"); ignoring the second. Give them distinct paths.`);
-      return;
-    }
-    seen.set(path, file);
-    examples.push({
-      client: framework === "astro" ? undefined : readClientMode(source, file, warnings),
-      file,
-      framework,
-      lang: ext,
-      path,
-      source
-    });
-  };
-  for (const [index, file] of files.entries()) {
-    collectExample(file, sources[index] ?? "");
-  }
-  return { dir, examples, warnings };
-};
-var exampleMarkdownLookup = (examples) => Object.fromEntries(examples.map((example) => [
-  example.path,
-  { lang: example.lang, source: example.source }
-]));
-
 // src/astro/render-deps.ts
 import { existsSync as existsSync5, realpathSync } from "node:fs";
 import {
   basename,
-  dirname as dirname6,
-  isAbsolute as isAbsolute5,
+  dirname as dirname7,
+  isAbsolute as isAbsolute4,
   join as join10,
   normalize,
   relative as relative4,
@@ -2631,7 +2641,7 @@ import {
 } from "pathe";
 var depsCandidates = (pkgDir) => [
   join10(pkgDir, "node_modules"),
-  dirname6(pkgDir)
+  dirname7(pkgDir)
 ];
 var candidateHolding = (pkgDir, ...segments) => depsCandidates(pkgDir).find((dir) => existsSync5(join10(dir, ...segments))) ?? null;
 var packageDirFrom = (name, fromDir) => {
@@ -2641,7 +2651,7 @@ var packageDirFrom = (name, fromDir) => {
     if (existsSync5(join10(candidate, "package.json"))) {
       return normalize(realpathSync(candidate));
     }
-    const parent = dirname6(dir);
+    const parent = dirname7(dir);
     if (parent === dir) {
       return null;
     }
@@ -2653,16 +2663,19 @@ var packageDirFrom = (name, fromDir) => {
 var BLUME_SRC = join11(packageRoot(), "src");
 var resolveReactCompiler = (config, needsReact, pkgDir = packageRoot()) => {
   if (!(needsReact && config.react.compiler)) {
-    return null;
+    return false;
   }
   try {
-    return createRequire2(pathToFileURL(join11(pkgDir, "_.js")).href).resolve("babel-plugin-react-compiler");
+    const astroReact = createRequire2(pathToFileURL(join11(pkgDir, "_.js")).href).resolve("@astrojs/react");
+    const pluginReact = createRequire2(astroReact).resolve("@vitejs/plugin-react");
+    createRequire2(pluginReact).resolve("oxc-transform-react");
+    return true;
   } catch {
-    return null;
+    return false;
   }
 };
-var reactCompilerWarnings = (config, needsReact, compilerPath) => needsReact && config.react.compiler && !compilerPath ? [
-  "React Compiler is enabled but `babel-plugin-react-compiler` could not be resolved; falling back to an uncompiled build. Reinstall Blume, or set `react: { compiler: false }` to silence this."
+var reactCompilerWarnings = (config, needsReact, compiler) => needsReact && config.react.compiler && !compiler ? [
+  "React Compiler is enabled but `oxc-transform-react` could not be resolved; falling back to an uncompiled build. Reinstall Blume, or set `react: { compiler: false }` to silence this."
 ] : [];
 var resolveAstroPackageJson = (modulesDir) => {
   try {
@@ -2679,7 +2692,7 @@ var resolvedAstroHit = (fromDir) => {
     if (pkg) {
       return { modulesDir, pkg };
     }
-    const parent = dirname7(dir);
+    const parent = dirname8(dir);
     if (parent === dir) {
       return null;
     }
@@ -2712,13 +2725,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) => {
@@ -2796,7 +2809,7 @@ var readOptional = async (path) => {
     return "";
   }
   try {
-    return await readFile4(path, "utf-8");
+    return await readFile3(path, "utf-8");
   } catch {
     return "";
   }
@@ -2806,7 +2819,7 @@ var readUserCss = async (file, outputDir) => {
   return file ? rebaseSourceDirectives(css, { from: file, to: outputDir }) : css;
 };
 var detectNeedsReact = async (root) => {
-  const matches = await glob2(["**/*.{tsx,jsx}"], {
+  const matches = await glob(["**/*.{tsx,jsx}"], {
     cwd: root,
     ignore: ["**/node_modules/**", "**/.blume/**", "**/dist/**"],
     onlyFiles: true
@@ -2814,15 +2827,15 @@ var detectNeedsReact = async (root) => {
   return matches.length > 0;
 };
 var containsMath = (content) => content.includes("$$") || content.includes("<Math");
-var READ_CONCURRENCY2 = 16;
+var READ_CONCURRENCY = 16;
 var detectUsesMath = async (root, staged = []) => {
-  const files = await glob2(["**/*.{md,mdx}"], {
+  const files = await glob(["**/*.{md,mdx}"], {
     cwd: root,
     ignore: ["**/node_modules/**", "**/.blume/**", "**/dist/**"],
     onlyFiles: true
   });
-  const contents = await pMap2(files, (file) => readOptional(join11(root, file)), {
-    concurrency: READ_CONCURRENCY2
+  const contents = await pMap(files, (file) => readOptional(join11(root, file)), {
+    concurrency: READ_CONCURRENCY
   });
   return [...contents, ...staged].some(containsMath);
 };
@@ -2839,7 +2852,7 @@ var loadIntegrationBridge = async (config, context) => {
 var writeIfChanged = async (path, content) => {
   let existing = null;
   try {
-    existing = await readFile4(path, "utf-8");
+    existing = await readFile3(path, "utf-8");
   } catch {
     existing = null;
   }
@@ -2850,7 +2863,7 @@ var writeIfChanged = async (path, content) => {
   return true;
 };
 var pruneOrphans = async (srcDir, written) => {
-  const existing = await glob2("**/*", {
+  const existing = await glob("**/*", {
     absolute: true,
     cwd: srcDir,
     onlyFiles: true
@@ -2904,7 +2917,7 @@ var readLogoSvg = (project, source) => {
   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;
   }
@@ -3019,10 +3032,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) {
@@ -3056,6 +3090,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;
@@ -3070,28 +3116,28 @@ var buildRuntimeData = (project) => {
     const rel = relative5(context.root, sourcePath).split("\\").join("/");
     const editDir = trimChar(github?.dir ?? "", "/");
     const editPath = normalize2(editDir ? join11(editDir, rel) : rel);
-    if (editPath.startsWith("..") || isAbsolute6(editPath)) {
+    if (editPath.startsWith("..") || isAbsolute5(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
   });
   const uiByLocale = i18n ? Object.fromEntries(i18n.locales.map(({ code }) => [
     code,
-    resolveUIStrings(code, {
+    withChangelogIndexText(config, resolveUIStrings(code, {
       defaultLocale: i18n.defaultLocale,
       overrides: i18n.ui
-    })
+    }), code)
   ])) : {};
-  const defaultUi = i18n ? resolveUIStrings(i18n.defaultLocale, {
+  const defaultUi = withChangelogIndexText(config, i18n ? resolveUIStrings(i18n.defaultLocale, {
     defaultLocale: i18n.defaultLocale,
     overrides: i18n.ui
-  }) : EN_UI;
+  }) : EN_UI, i18n?.defaultLocale);
   const navigationByLocale = i18n ? Object.fromEntries(i18n.locales.map(({ code }) => [
     code,
     withRepoUrl(graph.navigationByLocale[code] ?? {
@@ -3106,15 +3152,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: {
@@ -3125,7 +3170,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,
@@ -3135,7 +3182,8 @@ var buildRuntimeData = (project) => {
           code,
           dir,
           label
-        }))
+        })),
+        routeByBrowserLanguage: i18n.routeByBrowserLanguage
       } : null,
       identity: config.seo.organization || config.seo.software ? {
         organization: config.seo.organization,
@@ -3147,6 +3195,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,
@@ -3157,6 +3207,7 @@ var buildRuntimeData = (project) => {
       openInChat: config.ai.openInChat,
       repoUrl: repoUrl2,
       search: {
+        analytics: config.search.analytics,
         enabled: config.search.provider.mode !== "none",
         popular: resolveSearchPopular(config.search.popular, config.basePath),
         provider: config.search.provider.kind
@@ -3322,7 +3373,6 @@ 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 planPlaygroundProxy = (config, srcDir) => ({
   enabled: needsPlaygroundProxy(config),
   entrypoint: join11(srcDir, PLAYGROUND_PROXY_ENTRY),
@@ -3357,6 +3407,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 = [];
@@ -3378,9 +3449,12 @@ var writeAskFiles = async (project, srcDir, write, modules) => {
     modules.set("blume:ask-data", JSON.stringify(await buildAskData(project)));
   }
   await write(join11(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) => {
@@ -3405,7 +3479,7 @@ var dependencyPreflight = async (project, frameworks) => {
   }
   return [diagnosticWarning(diagnostic)];
 };
-var analyzeComponentsFile = async (componentsFile) => componentsFile ? analyzeComponentOverrides(await readFile4(componentsFile, "utf-8"), componentsFile) : emptyComponentOverrides();
+var analyzeComponentsFile = async (componentsFile) => componentsFile ? analyzeComponentOverrides(await readFile3(componentsFile, "utf-8"), componentsFile) : emptyComponentOverrides();
 var projectOgFonts = (project) => resolveOgFonts({
   locales: fontLocaleCodes(project.config.i18n),
   ogFonts: project.config.seo.og.fonts,
@@ -3444,6 +3518,7 @@ var generateRuntime = async (project) => {
   const askPath = join11(srcDir, "generated", "Ask.astro");
   const themePath = join11(srcDir, "generated", "app.css");
   const searchClientPath = join11(srcDir, "generated", "search-client.ts");
+  const consentClientPath = join11(srcDir, "generated", "consent-client.ts");
   const featuresPath = join11(srcDir, "generated", "features.ts");
   const examplesPath = join11(srcDir, "generated", "examples.ts");
   const examplesThemePath = join11(srcDir, "generated", "examples.css");
@@ -3497,7 +3572,7 @@ var generateRuntime = async (project) => {
   const needsReact = detectedReact || assistantEnabled || frameworks.has("react");
   const needsVue = frameworks.has("vue");
   const needsSvelte = frameworks.has("svelte");
-  const reactCompilerPath = resolveReactCompiler(config, needsReact);
+  const reactCompiler = resolveReactCompiler(config, needsReact);
   const ogRoutes = customOgRoutes(pages, config.title, config.seo.og.titles);
   const changelogIndex = hasGeneratedChangelog(project, pages);
   const mcp = planMcp(project, srcDir, pages);
@@ -3513,7 +3588,9 @@ 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);
@@ -3523,6 +3600,7 @@ var generateRuntime = async (project) => {
         aliases: resolveTsconfigAliases(context.root),
         askPath,
         config,
+        consentClientPath,
         contentRoot: docsCollection.base,
         contentRoutes,
         context,
@@ -3535,7 +3613,7 @@ var generateRuntime = async (project) => {
         needsSvelte,
         needsVue,
         pages,
-        reactCompilerPath,
+        reactCompiler,
         searchClientPath,
         themePath
       })),
@@ -3569,7 +3647,7 @@ var generateRuntime = async (project) => {
         languageIcons,
         sources: [
           `${BLUME_SRC}/**/*.{astro,ts,tsx}`,
-          `${context.root}/**/*.{astro,mdx,ts,tsx}`
+          `${context.root}/**/*.{astro,jsx,mdx,ts,tsx}`
         ],
         twoslashCss: twoslashCss(),
         userTheme
@@ -3580,7 +3658,7 @@ var generateRuntime = async (project) => {
     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)
+    playgroundProxy.enabled ? write(playgroundProxy.entrypoint, playgroundProxyTemplate(proxyOrigins, config.rateLimit)) : Promise.resolve(false)
   ]);
   if (config.seo.og.enabled) {
     await write(join11(srcDir, "pages", "og", "[...slug].png.ts"), ogEndpointTemplate(ogRoutes, {
@@ -3610,6 +3688,7 @@ 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;
@@ -3619,7 +3698,7 @@ var generateRuntime = async (project) => {
     await write(join11(srcDir, "pages", "blume-search.json.ts"), searchEndpointTemplate());
   }
   if (searchAdapter.kind === "mixedbread") {
-    await write(join11(srcDir, "pages", "api", "search.ts"), mixedbreadSearchEndpointTemplate(searchAdapter.options));
+    await write(join11(srcDir, "pages", "api", "search.ts"), mixedbreadSearchEndpointTemplate(searchAdapter.options, sourcePages(project), config.rateLimit));
   }
   await write(join11(srcDir, "generated", "includes.json"), `${JSON.stringify(buildIncludeGraph(project.graph.pages))}
 `);
@@ -3640,30 +3719,23 @@ var generateRuntime = async (project) => {
   const warnings = [
     ...depsLinkWarning ? [depsLinkWarning] : [],
     ...proxyAllowlistWarnings(config, openApiData),
-    ...reactCompilerWarnings(config, needsReact, reactCompilerPath),
+    ...apiPageProxyWarnings(project),
+    ...reactCompilerWarnings(config, needsReact, reactCompiler),
     ...mcp.warnings,
     ...islandDiscovery.warnings,
     ...exampleDiscovery.warnings,
     ...examplesWarnings,
     ...overrideWarnings
   ];
-  const navTargetRoutes = new Set([
-    ...project.graph.routes.keys(),
-    ...pages.map((page) => page.pattern),
-    ...referenceRoutes(config)
-  ]);
-  if (changelogIndex) {
-    navTargetRoutes.add("/changelog");
-  }
   warnings.push(...[
-    ...validateNavTargets(project.graph.navigation, navTargetRoutes),
+    ...validateNavTargets(project.graph.navigation, navTargetRoutes(project, pages)),
     ...validateSearchPopularIcons(config.search.popular)
   ].map(diagnosticWarning));
   const knownComponentTags = new Set([
     ...islandDiscovery.islands.map((island) => island.name),
     ...overrideAnalysis.mdx.map((entry) => entry.key)
   ]);
-  warnings.push(...validateUsedComponents(project.graph.pages, knownComponentTags, new Set(registry.map((item) => item.name))).map(diagnosticWarning), ...dependencyWarnings);
+  warnings.push(...validateUsedComponents(project.graph.pages, knownComponentTags, new Set(registry.map((item) => item.name))).map(diagnosticWarning), ...missingExampleDiagnostics(project.graph.pages, exampleDiscovery, context.root, knownComponentTags).map(diagnosticWarning), ...dependencyWarnings);
   if (hasScalarReferences(config)) {
     const references = await buildReferenceFiles({
       config,
@@ -3686,7 +3758,7 @@ var generateRuntime = async (project) => {
   return { structuralChange: structural.some(Boolean), warnings };
 };
 
-export { publishBuildProject, refreshBlumeContent, showBlumeErrorOverlay, ogCacheDir, pruneCardCache, cardCacheTally, buildApiSpec, buildAskData, resolveOgFonts, 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, sourcePages, tailwindEntryTemplate, examplesEntryTemplate, rebaseSourceDirectives, twoslashCss, packageDirFrom, detectNeedsReact, detectUsesMath, collectStaged, playgroundProxyPattern, buildRuntimeData, PLAYGROUND_PROXY_ENTRY, specOrigins, proxyAllowlistWarnings, analyzeComponentsFile, languageIconCssFor, clientFeaturesFor, generateRuntime };
 
-//# debugId=067C177A5C0052FA64756E2164756E21
-//# sourceMappingURL=chunk-c8chx29p.js.map
+//# debugId=06510295E6F5A8F264756E2164756E21
+//# sourceMappingURL=chunk-ep6nd0rn.js.map