blume 2.1.0 → 2.1.1

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

@@ -14,7 +14,6 @@ import {
   API_SEARCH_PATH,
   apiNamePhrase,
   resolveReferences,
-  referenceRoutes,
   hasScalarReferences,
   builtinProxyReferences,
   apiPagesUseBuiltinProxy,
@@ -23,10 +22,13 @@ import {
   buildMcpServerCard,
   hasAiCatalog,
   buildHomeLinkHeader,
+  resolveLocalizable,
   resolveDocsCollection,
+  withChangelogIndexText,
   discoverPages,
   routeIsTaken,
   hasGeneratedChangelog,
+  navTargetRoutes,
   customOgRoutes,
   resolveAskBackend,
   captchaSettings,
@@ -53,7 +55,7 @@ import {
   isOpenApiSource,
   buildRawMarkdown,
   markdownRoutePaths
-} from "./chunk-xkz5xbtv.js";
+} from "./chunk-ehweg4fr.js";
 import {
   trimChar,
   normalizeBasePath,
@@ -63,15 +65,14 @@ import {
   absoluteUrl2
 } from "./chunk-zccbjcj0.js";
 import {
-  resolveLocalizable,
   validateSearchPopularIcons,
   validateNavTargets
-} from "./chunk-43zcf4gz.js";
+} from "./chunk-ncj7w596.js";
 import {
   EXPANDABLE_VISIBLE_LINES,
   buildSearchDocuments,
   buildMcpData
-} from "./chunk-2f3ndkpw.js";
+} from "./chunk-n0v7m8ry.js";
 import {
   planComponentSlots,
   publishRuntimeModules,
@@ -112,11 +113,21 @@ import {
   examplesPageTemplate,
   runtimePackageTemplate,
   runtimeTsconfigTemplate
-} from "./chunk-4h8z9vv5.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-ta27feev.js";
+} from "./chunk-54ztw1nj.js";
 import {
   writeTextAtomic
 } from "./chunk-jq5n4avg.js";
@@ -127,12 +138,7 @@ import {
 } from "./chunk-cm89scdv.js";
 import {
   registry
-} from "./chunk-2f7n4qzt.js";
-import {
-  readClientMode,
-  discoverIslands,
-  missingDependencyDiagnostic
-} from "./chunk-amrb6hgh.js";
+} from "./chunk-c1y538kd.js";
 
 // src/astro/integration.ts
 import { join as join4, relative, resolve as resolve2 } from "pathe";
@@ -236,6 +242,10 @@ var DENSE_SCRIPT_LANGS = new Set(["ja", "ko", "zh"]);
 import { close, createIndex } from "pagefind";
 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";
 var ERROR_ROUTES = new Set(["/404", "/500"]);
@@ -363,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,
@@ -371,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 dirname8, isAbsolute as isAbsolute6, join as join12, 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";
@@ -949,75 +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",
-  "ParamField",
-  "Prompt",
-  "RequestExample",
-  "ResponseExample",
-  "ResponseField",
-  "Step",
-  "Steps",
-  "Tab",
-  "Tabs",
-  "Tile",
-  "Tooltip",
-  "Tree",
-  "TypeTable",
-  "View",
-  "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;
@@ -1580,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;
 
@@ -2474,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],
@@ -2485,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;
   }
 
@@ -2496,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;
   }
@@ -2557,7 +2533,7 @@ ${options.userCss}
 `;
 
 // src/theme/sources.ts
-import { dirname as dirname6, 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 = dirname6(options.from);
@@ -2565,7 +2541,7 @@ var rebaseSourceDirectives = (css, options) => {
     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}`;
   });
 };
@@ -2652,104 +2628,27 @@ 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 join10, 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 = join10(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 dirname7,
-  isAbsolute as isAbsolute5,
-  join as join11,
+  isAbsolute as isAbsolute4,
+  join as join10,
   normalize,
   relative as relative4,
   resolve as resolve5
 } from "pathe";
 var depsCandidates = (pkgDir) => [
-  join11(pkgDir, "node_modules"),
+  join10(pkgDir, "node_modules"),
   dirname7(pkgDir)
 ];
-var candidateHolding = (pkgDir, ...segments) => depsCandidates(pkgDir).find((dir) => existsSync5(join11(dir, ...segments))) ?? null;
+var candidateHolding = (pkgDir, ...segments) => depsCandidates(pkgDir).find((dir) => existsSync5(join10(dir, ...segments))) ?? null;
 var packageDirFrom = (name, fromDir) => {
   let dir = normalize(fromDir);
   while (true) {
-    const candidate = join11(dir, "node_modules", name);
-    if (existsSync5(join11(candidate, "package.json"))) {
+    const candidate = join10(dir, "node_modules", name);
+    if (existsSync5(join10(candidate, "package.json"))) {
       return normalize(realpathSync(candidate));
     }
     const parent = dirname7(dir);
@@ -2761,23 +2660,26 @@ var packageDirFrom = (name, fromDir) => {
 };
 
 // src/astro/generate.ts
-var BLUME_SRC = join12(packageRoot(), "src");
+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(join12(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 {
-    return realpathSync2(join12(modulesDir, "astro", "package.json"));
+    return realpathSync2(join11(modulesDir, "astro", "package.json"));
   } catch {
     return null;
   }
@@ -2785,7 +2687,7 @@ var resolveAstroPackageJson = (modulesDir) => {
 var resolvedAstroHit = (fromDir) => {
   let dir = normalize2(fromDir);
   while (true) {
-    const modulesDir = join12(dir, "node_modules");
+    const modulesDir = join11(dir, "node_modules");
     const pkg = resolveAstroPackageJson(modulesDir);
     if (pkg) {
       return { modulesDir, pkg };
@@ -2862,7 +2764,7 @@ var dropStaleDepsLink = async (link, pkgDir) => {
   let linkedBlume;
   let runningBlume;
   try {
-    linkedBlume = await realpath(join12(link, "blume"));
+    linkedBlume = await realpath(join11(link, "blume"));
     runningBlume = await realpath(pkgDir);
   } catch {
     return;
@@ -2878,7 +2780,7 @@ var ensureDepsLink = async (outDir, pkgDir = packageRoot()) => {
   }
   const mdxDir = candidateHolding(pkgDir, "@astrojs", "mdx");
   const blumeAstro = resolveAstroPackageJson(astroDir);
-  await dropStaleDepsLink(join12(outDir, "node_modules"), pkgDir);
+  await dropStaleDepsLink(join11(outDir, "node_modules"), pkgDir);
   const outDirHit = resolvedAstroHit(outDir);
   const astroCorrect = blumeAstro !== null && outDirHit?.pkg === blumeAstro;
   const walkLandsInDeps = astroCorrect && outDirHit !== null && sameRealDir(outDirHit.modulesDir, astroDir);
@@ -2886,16 +2788,16 @@ var ensureDepsLink = async (outDir, pkgDir = packageRoot()) => {
     return null;
   }
   if (mdxDir && (mdxDir === astroDir || astroCorrect)) {
-    await linkDepsJunction(join12(outDir, "node_modules"), mdxDir);
+    await linkDepsJunction(join11(outDir, "node_modules"), mdxDir);
     return null;
   }
   return astroConflictWarning(blumeAstro, outDirHit?.pkg ?? null);
 };
-var examplesCssFile = (root, config) => config.examples.css ? join12(root, config.examples.css) : null;
+var examplesCssFile = (root, config) => config.examples.css ? join11(root, config.examples.css) : null;
 var writeExamplesPreview = async (options) => {
   const { config, hasExamples, root, srcDir, write } = options;
   if (hasExamples) {
-    await write(join12(srcDir, "pages", ...config.basePath.split("/").filter(Boolean), "blume-examples", "[...path].astro"), examplesPageTemplate());
+    await write(join11(srcDir, "pages", ...config.basePath.split("/").filter(Boolean), "blume-examples", "[...path].astro"), examplesPageTemplate());
   }
   const cssFile = examplesCssFile(root, config);
   return cssFile && !existsSync6(cssFile) ? [
@@ -2907,7 +2809,7 @@ var readOptional = async (path) => {
     return "";
   }
   try {
-    return await readFile4(path, "utf-8");
+    return await readFile3(path, "utf-8");
   } catch {
     return "";
   }
@@ -2917,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
@@ -2925,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(join12(root, file)), {
-    concurrency: READ_CONCURRENCY2
+  const contents = await pMap(files, (file) => readOptional(join11(root, file)), {
+    concurrency: READ_CONCURRENCY
   });
   return [...contents, ...staged].some(containsMath);
 };
@@ -2950,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;
   }
@@ -2961,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
@@ -2994,7 +2896,7 @@ var writeStagedContent = async (out, staged) => {
   const contentDir = stagedContentDir(out);
   const written = new Set;
   await Promise.all([...staged].map(async ([entryId, text]) => {
-    const path = join12(contentDir, entryId);
+    const path = join11(contentDir, entryId);
     written.add(normalize2(path));
     await writeIfChanged(path, text);
   }));
@@ -3009,8 +2911,8 @@ var readLogoSvg = (project, source) => {
   }
   const rel = source.replace(/^\//u, "");
   const file = [
-    join12(project.context.root, "public", rel),
-    join12(project.context.root, rel)
+    join11(project.context.root, "public", rel),
+    join11(project.context.root, rel)
   ].find((path) => existsSync6(path));
   return file ? readFileSync3(file, "utf-8") : undefined;
 };
@@ -3066,10 +2968,10 @@ var faviconType = (name) => {
 var inlineDataUri = (file, type) => `data:${type};base64,${readFileSync3(file).toString("base64")}`;
 var defaultFavicon = () => ({
   dark: {
-    href: inlineDataUri(join12(BLUME_SRC, "assets", "icon-dark.png"), "image/png"),
+    href: inlineDataUri(join11(BLUME_SRC, "assets", "icon-dark.png"), "image/png"),
     type: "image/png"
   },
-  href: inlineDataUri(join12(BLUME_SRC, "assets", "icon.png"), "image/png"),
+  href: inlineDataUri(join11(BLUME_SRC, "assets", "icon.png"), "image/png"),
   type: "image/png"
 });
 var APPLE_ICON_CANDIDATES = [
@@ -3081,12 +2983,12 @@ var APPLE_ICON_CANDIDATES = [
 var resolveIconFile = (project, candidates) => {
   const { root } = project.context;
   for (const name of candidates) {
-    if (existsSync6(join12(root, "public", name))) {
+    if (existsSync6(join11(root, "public", name))) {
       return { href: `/${name}`, type: faviconType(name) };
     }
   }
   for (const name of candidates) {
-    const file = join12(root, name);
+    const file = join11(root, name);
     if (existsSync6(file)) {
       const type = faviconType(name);
       return { href: inlineDataUri(file, type ?? "image/x-icon"), type };
@@ -3097,18 +2999,18 @@ var resolveIconFile = (project, candidates) => {
 var resolveFavicon = (project) => {
   const { root } = project.context;
   for (const name of FAVICON_CANDIDATES) {
-    if (existsSync6(join12(root, "public", name))) {
+    if (existsSync6(join11(root, "public", name))) {
       const type = faviconType(name);
       const sibling = darkSibling(name);
-      return existsSync6(join12(root, "public", sibling)) ? { dark: { href: `/${sibling}`, type }, href: `/${name}`, type } : { href: `/${name}`, type };
+      return existsSync6(join11(root, "public", sibling)) ? { dark: { href: `/${sibling}`, type }, href: `/${name}`, type } : { href: `/${name}`, type };
     }
   }
   for (const name of FAVICON_CANDIDATES) {
-    const file = join12(root, name);
+    const file = join11(root, name);
     if (existsSync6(file)) {
       const type = faviconType(name);
       const mime = type ?? "image/x-icon";
-      const siblingFile = join12(root, darkSibling(name));
+      const siblingFile = join11(root, darkSibling(name));
       return existsSync6(siblingFile) ? {
         dark: { href: inlineDataUri(siblingFile, mime), type },
         href: inlineDataUri(file, mime),
@@ -3213,8 +3115,8 @@ var buildRuntimeData = (project) => {
     }
     const rel = relative5(context.root, sourcePath).split("\\").join("/");
     const editDir = trimChar(github?.dir ?? "", "/");
-    const editPath = normalize2(editDir ? join12(editDir, rel) : rel);
-    if (editPath.startsWith("..") || isAbsolute6(editPath)) {
+    const editPath = normalize2(editDir ? join11(editDir, rel) : rel);
+    if (editPath.startsWith("..") || isAbsolute5(editPath)) {
       return null;
     }
     return `${editBase}/${editPath}`;
@@ -3227,15 +3129,15 @@ var buildRuntimeData = (project) => {
   });
   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] ?? {
@@ -3305,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
@@ -3363,7 +3266,7 @@ var buildRuntimeData = (project) => {
 var planMcp = (project, srcDir, userPages) => {
   const { config } = project;
   const { route } = config.agents.mcp;
-  const dir = join12(srcDir, "blume-mcp");
+  const dir = join11(srcDir, "blume-mcp");
   const base = {
     dir,
     discoveryPages: [],
@@ -3387,11 +3290,11 @@ var planMcp = (project, srcDir, userPages) => {
     ...base,
     discoveryPages: [
       {
-        entrypoint: join12(dir, "discovery.ts"),
+        entrypoint: join11(dir, "discovery.ts"),
         pattern: "/.well-known/mcp.json"
       },
       {
-        entrypoint: join12(dir, "server-card.ts"),
+        entrypoint: join11(dir, "server-card.ts"),
         pattern: "/.well-known/mcp/server-card.json"
       }
     ],
@@ -3418,9 +3321,9 @@ var writeMcpFiles = async (plan, write, data) => {
     version: data.version
   };
   await Promise.all([
-    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)))
+    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)))
   ]);
 };
 var ownsApiRest = (page) => page.pattern.startsWith("/api/[");
@@ -3432,7 +3335,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(join12(context.root, "public", "openapi.json")),
+    spec: !routeIsTaken(userPages, project.graph.pages, OPENAPI_PATH) && !existsSync6(join11(context.root, "public", "openapi.json")),
     srcDir
   };
 };
@@ -3442,20 +3345,20 @@ var writeApiFiles = async (project, plan, write, data, mcp) => {
   }
   const { config } = project;
   const mcpRoute = mcp.enabled ? mcp.route : null;
-  const apiDir = join12(plan.srcDir, "pages", "api");
+  const apiDir = join11(plan.srcDir, "pages", "api");
   const writes = [
-    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())
+    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())
   ];
   if (plan.server) {
-    writes.push(write(join12(apiDir, "docs", "search.ts"), apiSearchTemplate()));
+    writes.push(write(join11(apiDir, "docs", "search.ts"), apiSearchTemplate()));
   }
   if (plan.catchAll) {
-    writes.push(write(join12(apiDir, "[...path].ts"), apiNotFoundTemplate({ base: data.base, site: data.site })));
+    writes.push(write(join11(apiDir, "[...path].ts"), apiNotFoundTemplate({ base: data.base, site: data.site })));
   }
   if (plan.spec) {
-    writes.push(write(join12(plan.srcDir, "pages", "openapi.json.ts"), staticJsonEndpointTemplate(buildApiSpec({
+    writes.push(write(join11(plan.srcDir, "pages", "openapi.json.ts"), staticJsonEndpointTemplate(buildApiSpec({
       agentReadability: config.agents.agentReadability,
       base: data.base,
       description: config.description,
@@ -3469,10 +3372,10 @@ var writeApiFiles = async (project, plan, write, data, mcp) => {
   }
   await Promise.all(writes);
 };
-var PLAYGROUND_PROXY_ENTRY = join12("blume-openapi", "api-proxy.ts");
+var PLAYGROUND_PROXY_ENTRY = join11("blume-openapi", "api-proxy.ts");
 var planPlaygroundProxy = (config, srcDir) => ({
   enabled: needsPlaygroundProxy(config),
-  entrypoint: join12(srcDir, PLAYGROUND_PROXY_ENTRY),
+  entrypoint: join11(srcDir, PLAYGROUND_PROXY_ENTRY),
   pattern: playgroundProxyPattern(config)
 });
 var specOriginsOf = (spec) => {
@@ -3545,7 +3448,7 @@ var writeAskFiles = async (project, srcDir, write, modules) => {
   if (backend.grounded) {
     modules.set("blume:ask-data", JSON.stringify(await buildAskData(project)));
   }
-  await write(join12(srcDir, "pages", "api", "ask.ts"), askEndpointTemplate(backend, {
+  await write(join11(srcDir, "pages", "api", "ask.ts"), askEndpointTemplate(backend, {
     captcha: assistant.captcha,
     cors: assistant.cors,
     instructions: assistant.instructions,
@@ -3559,9 +3462,9 @@ var writeNotFoundPage = async (write, srcDir, pages, contentPages) => {
     return;
   }
   await Promise.all([
-    write(join12(srcDir, "pages", "404.astro"), notFoundPageTemplate()),
-    write(join12(srcDir, "pages", "404.md.ts"), notFoundMarkdownTemplate()),
-    write(join12(srcDir, "pages", "404.json.ts"), notFoundJsonTemplate())
+    write(join11(srcDir, "pages", "404.astro"), notFoundPageTemplate()),
+    write(join11(srcDir, "pages", "404.md.ts"), notFoundMarkdownTemplate()),
+    write(join11(srcDir, "pages", "404.json.ts"), notFoundJsonTemplate())
   ]);
 };
 var diagnosticWarning = (diagnostic) => diagnostic.suggestion ? `${diagnostic.message} ${diagnostic.suggestion}` : diagnostic.message;
@@ -3576,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,
@@ -3604,21 +3507,21 @@ var languageIconCssFrom = (project, rawMarkdown) => languageIconCss(languageIcon
 ].join(`
 `)));
 var languageIconCssFor = async (project) => languageIconCssFrom(project, await buildRawMarkdown(project));
-var writeNavFragments = (write, srcDir, navFragments) => navFragments ? write(join12(srcDir, "pages", "blume-nav", "[version]", "[locale]", "[id].astro"), navFragmentTemplate()) : Promise.resolve(false);
+var writeNavFragments = (write, srcDir, navFragments) => navFragments ? write(join11(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 = 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 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 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");
   const written = new Set;
   const write = (path, content) => {
     written.add(normalize2(path));
@@ -3669,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);
@@ -3693,7 +3596,7 @@ var generateRuntime = async (project) => {
   const docsCollection = resolveDocsCollection(config, context.root);
   const [structural] = await Promise.all([
     Promise.all([
-      write(join12(out, "astro.config.mjs"), astroConfigTemplate({
+      write(join11(out, "astro.config.mjs"), astroConfigTemplate({
         aliases: resolveTsconfigAliases(context.root),
         askPath,
         config,
@@ -3710,20 +3613,20 @@ var generateRuntime = async (project) => {
         needsSvelte,
         needsVue,
         pages,
-        reactCompilerPath,
+        reactCompiler,
         searchClientPath,
         themePath
       })),
-      write(join12(out, "package.json"), runtimePackageTemplate(runtimeDependencies({ config, needsReact, needsSvelte, needsVue }))),
-      write(join12(out, "tsconfig.json"), runtimeTsconfigTemplate()),
-      write(join12(srcDir, "content.config.ts"), contentConfigTemplate({
+      write(join11(out, "package.json"), runtimePackageTemplate(runtimeDependencies({ config, needsReact, needsSvelte, needsVue }))),
+      write(join11(out, "tsconfig.json"), runtimeTsconfigTemplate()),
+      write(join11(srcDir, "content.config.ts"), contentConfigTemplate({
         collection: docsCollection,
         config,
         context,
         filesystem: hasFilesystemSource,
         staged: hasStaged
       })),
-      write(join12(srcDir, "pages", "[...slug].astro"), catchAllPageTemplate({
+      write(join11(srcDir, "pages", "[...slug].astro"), catchAllPageTemplate({
         exportEpub,
         exportPdf,
         mathEnabled: usesMath,
@@ -3732,8 +3635,8 @@ var generateRuntime = async (project) => {
       })),
       writeNavFragments(write, srcDir, navFragments),
       write(askPath, askComponentTemplate(assistantEnabled)),
-      write(join12(srcDir, "generated", "components.ts"), slotPlan.module),
-      write(join12(srcDir, "generated", "examples.ts"), exampleMapTemplate(exampleDiscovery.examples, config.basePath)),
+      write(join11(srcDir, "generated", "components.ts"), slotPlan.module),
+      write(join11(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}`),
@@ -3744,21 +3647,21 @@ 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
       }))
     ]),
-    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)))),
+    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)))),
     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(join12(srcDir, "pages", "og", "[...slug].png.ts"), ogEndpointTemplate(ogRoutes, {
+    await write(join11(srcDir, "pages", "og", "[...slug].png.ts"), ogEndpointTemplate(ogRoutes, {
       ...projectOgFonts(project),
       cache: {
         dir: ogCacheDir(project.context),
@@ -3768,7 +3671,7 @@ var generateRuntime = async (project) => {
     }, changelogIndex));
   }
   if (changelogIndex) {
-    await write(join12(srcDir, "pages", "changelog.astro"), changelogIndexTemplate({
+    await write(join11(srcDir, "pages", "changelog.astro"), changelogIndexTemplate({
       exportEpub,
       exportPdf,
       needsReact,
@@ -3792,55 +3695,47 @@ var generateRuntime = async (project) => {
   if (searchAdapter.mode === "static") {
     const documents = await buildSearchDocuments(project);
     modules.set("blume:search-index", JSON.stringify(documents));
-    await write(join12(srcDir, "pages", "blume-search.json.ts"), searchEndpointTemplate());
+    await write(join11(srcDir, "pages", "blume-search.json.ts"), searchEndpointTemplate());
   }
   if (searchAdapter.kind === "mixedbread") {
-    await write(join12(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(join12(srcDir, "generated", "includes.json"), `${JSON.stringify(buildIncludeGraph(project.graph.pages))}
+  await write(join11(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(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")))
+    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")))
   ]);
   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(join12(srcDir, "pages", "[section]", "rss.xml.ts"), rssEndpointTemplate());
+    await write(join11(srcDir, "pages", "[section]", "rss.xml.ts"), rssEndpointTemplate());
   }
   const warnings = [
     ...depsLinkWarning ? [depsLinkWarning] : [],
     ...proxyAllowlistWarnings(config, openApiData),
     ...apiPageProxyWarnings(project),
-    ...reactCompilerWarnings(config, needsReact, reactCompilerPath),
+    ...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,
@@ -3848,12 +3743,12 @@ var generateRuntime = async (project) => {
       root: context.root
     });
     warnings.push(...references.warnings);
-    await Promise.all(references.files.map((file) => write(join12(srcDir, "pages", file.pagePath), file.content)));
+    await Promise.all(references.files.map((file) => write(join11(srcDir, "pages", file.pagePath), file.content)));
   }
   modules.set("blume:data", buildRuntimeData(project));
   modules.set("blume:openapi", JSON.stringify(openApiData));
   await Promise.all([
-    write(join12(out, "blume.manifest.json"), `${JSON.stringify(project.manifest, null, 2)}
+    write(join11(out, "blume.manifest.json"), `${JSON.stringify(project.manifest, null, 2)}
 `),
     writeStagedContent(out, staged)
   ]);
@@ -3863,7 +3758,7 @@ var generateRuntime = async (project) => {
   return { structuralChange: structural.some(Boolean), warnings };
 };
 
-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 };
+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=168B822A64F4126564756E2164756E21
-//# sourceMappingURL=chunk-zf748avv.js.map
+//# debugId=06510295E6F5A8F264756E2164756E21
+//# sourceMappingURL=chunk-ep6nd0rn.js.map