blume 1.6.6 → 1.7.1

package/dist/cli/{chunk-62qsssnh.js → chunk-x1wvw7a8.js}

@@ -6,7 +6,7 @@ import {
   buildSearchDocuments,
   markdownRoutePaths,
   renderRssFeed
-} from "./chunk-n4qjabmt.js";
+} from "./chunk-ka5k7cz9.js";
 import {
   MCP_TOOLS
 } from "./chunk-pxj10x8y.js";
@@ -19,7 +19,7 @@ import {
 import {
   collectContentAssets,
   rewriteRelativeImages
-} from "./chunk-5yvt556e.js";
+} from "./chunk-kmx2mydj.js";
 import {
   writeTextAtomic
 } from "./chunk-ev67ycx0.js";
@@ -45,11 +45,13 @@ import {
   exampleSlug,
   exampleWrapperTemplate,
   examplesPageTemplate,
+  featuresTemplate,
   islandMapTemplate,
   islandWrapperTemplate,
   mcpEndpointTemplate,
   mcpPageFile,
   mixedbreadSearchEndpointTemplate,
+  navFragmentTemplate,
   notFoundJsonTemplate,
   notFoundMarkdownTemplate,
   notFoundPageTemplate,
@@ -67,14 +69,14 @@ import {
   searchEndpointTemplate,
   stagedContentDir,
   staticJsonEndpointTemplate
-} from "./chunk-aerwpe14.js";
+} from "./chunk-4ae4f395.js";
 import {
   API_NAVIGATION_PATH,
   API_PAGES_PATH,
   API_PAGE_PATH,
   API_SEARCH_PATH,
   OPENAPI_PATH
-} from "./chunk-3k0kzs6d.js";
+} from "./chunk-qvvpnwaz.js";
 import {
   absoluteUrl,
   siteRoot
@@ -91,7 +93,7 @@ import {
   resolveFallbackLocale,
   validateNavTargets,
   validateSearchPopularIcons
-} from "./chunk-etsqspj6.js";
+} from "./chunk-12dzsn9b.js";
 import {
   EN_UI,
   GOOGLE_FONTS,
@@ -108,12 +110,15 @@ import {
   repoUrl,
   resolveReferences,
   resolveUIStrings
-} from "./chunk-vv3f8mb6.js";
+} from "./chunk-r99hynxh.js";
 import {
   normalizeBasePath,
   trimChar,
   withBasePath
 } from "./chunk-27gtm2ym.js";
+import {
+  getBlumeVersion
+} from "./chunk-4xyggvgf.js";
 import {
   packageRoot
 } from "./chunk-6kzzpsx8.js";
@@ -208,16 +213,53 @@ ${body}`,
   });
 };
 
+// src/og/cache.ts
+import { existsSync } from "node:fs";
+import {
+  mkdir,
+  readdir,
+  readFile,
+  rename,
+  rm,
+  writeFile
+} from "node:fs/promises";
+import { dirname as dirname2, 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");
+var REGISTRY_KEY2 = Symbol.for("blume.og-cache");
+var registry3 = () => {
+  const host = globalThis;
+  host[REGISTRY_KEY2] ??= { hits: 0, misses: 0, used: new Set };
+  return host[REGISTRY_KEY2];
+};
+var localFontDigests = new Map;
+var inflight = new Map;
+var pruneCardCache = async (dir) => {
+  const { used } = registry3();
+  let entries;
+  try {
+    entries = await readdir(dir);
+  } catch {
+    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 })));
+  return stale.length;
+};
+var cardCacheTally = () => {
+  const { hits, misses } = registry3();
+  return hits + misses === 0 ? null : { hits, misses };
+};
+
 // src/astro/generate.ts
 import { createHash } from "node:crypto";
-import { existsSync as existsSync5, readFileSync as readFileSync3, realpathSync } from "node:fs";
+import { existsSync as existsSync6, readFileSync as readFileSync3, realpathSync } from "node:fs";
 import {
   lstat,
-  mkdir,
-  readFile as readFile4,
+  mkdir as mkdir2,
+  readFile as readFile5,
   readlink,
   realpath,
-  rm,
+  rm as rm2,
   symlink
 } from "node:fs/promises";
 import { createRequire as createRequire2 } from "node:module";
@@ -225,9 +267,9 @@ import { pathToFileURL } from "node:url";
 import pMap3 from "p-map";
 import {
   basename as basename2,
-  dirname as dirname5,
+  dirname as dirname6,
   isAbsolute as isAbsolute6,
-  join as join10,
+  join as join11,
   normalize,
   relative as relative4,
   resolve as resolve6
@@ -829,6 +871,22 @@ var buildMcpServerCard = (input) => {
   return card;
 };
 
+// src/components/layout/nav-utils.ts
+var hasDeferrableGroups = (sidebar) => sidebar.some((node) => node.kind === "group" && ((node.display ?? "flat") !== "flat" || hasDeferrableGroups(node.children)));
+var navVariants = (data, hiddenDefault = null) => [
+  { locale: "default", navigation: data.navigation, version: "current" },
+  ...Object.entries(data.navigationByLocale).filter(([locale]) => locale !== hiddenDefault).map(([locale, navigation]) => ({
+    locale,
+    navigation,
+    version: "current"
+  })),
+  ...Object.entries(data.navigationByVersion).flatMap(([version, byLocale]) => Object.entries(byLocale).map(([locale, navigation]) => ({
+    locale: locale && locale !== hiddenDefault ? locale : "default",
+    navigation,
+    version
+  })))
+];
+
 // src/core/builtin-tags.ts
 var BUILTIN_MDX_TAGS = new Set([
   "Accordion",
@@ -894,8 +952,8 @@ var validateUsedComponents = (pages, extraTags, registryNames) => {
 };
 
 // src/core/component-overrides.ts
-import { existsSync } from "node:fs";
-import { dirname as dirname2, extname, isAbsolute, resolve as resolve3 } from "pathe";
+import { existsSync as existsSync2 } from "node:fs";
+import { dirname as dirname3, extname, isAbsolute, resolve as resolve3 } from "pathe";
 import ts from "typescript";
 var GROUPS = ["mdx", "layout", "islands"];
 var GROUP_SET = new Set(GROUPS);
@@ -989,7 +1047,7 @@ var findDefaultExportObject = (sourceFile) => {
 var probeExtension = (base) => {
   for (const extension of COMPONENT_EXTS) {
     const candidate = `${base}.${extension}`;
-    if (existsSync(candidate)) {
+    if (existsSync2(candidate)) {
       return candidate;
     }
   }
@@ -1151,7 +1209,7 @@ var analyzeComponentOverrides = (source, filePath) => {
     return result;
   }
   const imports = collectImports(sourceFile);
-  const dir = dirname2(filePath);
+  const dir = dirname3(filePath);
   for (const property of object.properties) {
     collectGroupOverrides(property, imports, dir, result);
   }
@@ -1222,8 +1280,8 @@ var svgDimensions = (svg) => {
 };
 
 // src/core/tsconfig-aliases.ts
-import { existsSync as existsSync2 } from "node:fs";
-import { dirname as dirname3, join as join4, resolve as resolve4 } from "pathe";
+import { existsSync as existsSync3 } from "node:fs";
+import { dirname as dirname4, join as join5, resolve as resolve4 } from "pathe";
 import ts2 from "typescript";
 var PARSE_HOST = {
   fileExists: ts2.sys.fileExists,
@@ -1245,7 +1303,7 @@ var toAlias = (key, value, baseDir) => {
   return { find, replacement: resolve4(baseDir, target) };
 };
 var resolveTsconfigAliases = (root) => {
-  const entry = ["tsconfig.json", "jsconfig.json"].map((name) => join4(root, name)).find((file) => existsSync2(file));
+  const entry = ["tsconfig.json", "jsconfig.json"].map((name) => join5(root, name)).find((file) => existsSync3(file));
   if (!entry) {
     return {};
   }
@@ -1253,7 +1311,7 @@ var resolveTsconfigAliases = (root) => {
   if (error) {
     return {};
   }
-  const configDir = dirname3(entry);
+  const configDir = dirname4(entry);
   const { options } = ts2.parseJsonConfigFileContent(config, PARSE_HOST, configDir, undefined, entry);
   const { paths } = options;
   if (!paths) {
@@ -1271,11 +1329,144 @@ var resolveTsconfigAliases = (root) => {
   return Object.fromEntries(entries);
 };
 
+// src/markdown/language-icon.ts
+import {
+  siAstro,
+  siC,
+  siCplusplus,
+  siCss,
+  siDart,
+  siDocker,
+  siGnubash,
+  siGo,
+  siGraphql,
+  siHtml5,
+  siJavascript,
+  siJson,
+  siKotlin,
+  siLess,
+  siLua,
+  siMarkdown,
+  siMdx,
+  siMysql,
+  siNextdotjs,
+  siPhp,
+  siPrisma,
+  siPython,
+  siReact,
+  siRuby,
+  siRust,
+  siSass,
+  siScala,
+  siSvelte,
+  siSvg,
+  siSwift,
+  siToml,
+  siTypescript,
+  siVuedotjs,
+  siWebassembly,
+  siYaml
+} from "simple-icons";
+var LANGUAGE_ICONS = {
+  astro: siAstro,
+  bash: siGnubash,
+  c: siC,
+  "c++": siCplusplus,
+  cjs: siJavascript,
+  cpp: siCplusplus,
+  css: siCss,
+  cts: siTypescript,
+  dart: siDart,
+  docker: siDocker,
+  dockerfile: siDocker,
+  go: siGo,
+  gql: siGraphql,
+  graphql: siGraphql,
+  html: siHtml5,
+  javascript: siJavascript,
+  js: siJavascript,
+  json: siJson,
+  json5: siJson,
+  jsonc: siJson,
+  jsx: siReact,
+  kotlin: siKotlin,
+  kt: siKotlin,
+  less: siLess,
+  lua: siLua,
+  markdown: siMarkdown,
+  md: siMarkdown,
+  mdx: siMdx,
+  mjs: siJavascript,
+  mts: siTypescript,
+  nextjs: siNextdotjs,
+  php: siPhp,
+  prisma: siPrisma,
+  py: siPython,
+  python: siPython,
+  rb: siRuby,
+  react: siReact,
+  rs: siRust,
+  ruby: siRuby,
+  rust: siRust,
+  sass: siSass,
+  scala: siScala,
+  scss: siSass,
+  sh: siGnubash,
+  shell: siGnubash,
+  sql: siMysql,
+  svelte: siSvelte,
+  svg: siSvg,
+  swift: siSwift,
+  toml: siToml,
+  ts: siTypescript,
+  tsx: siReact,
+  typescript: siTypescript,
+  vue: siVuedotjs,
+  wasm: siWebassembly,
+  yaml: siYaml,
+  yml: siYaml,
+  zsh: siGnubash
+};
+var languageIconSlug = (language) => LANGUAGE_ICONS[language.toLowerCase()]?.slug ?? null;
+var FENCE_LANGUAGE = /^[ \t]*(?:`{3,}|~{3,})[ \t]*(?<lang>[\w+#.-]+)/gmu;
+var PROP_LANGUAGE = /\blang(?:uage)?=["'](?<lang>[\w+#.-]+)["']/gu;
+var languageIconSlugsIn = (markdown) => {
+  const slugs = new Set;
+  for (const pattern of [FENCE_LANGUAGE, PROP_LANGUAGE]) {
+    for (const match of markdown.matchAll(pattern)) {
+      const slug = languageIconSlug(match.groups?.lang ?? "");
+      if (slug) {
+        slugs.add(slug);
+      }
+    }
+  }
+  return [...slugs].toSorted();
+};
+var iconBySlug = (slug) => Object.values(LANGUAGE_ICONS).find((icon) => icon.slug === slug);
+var maskUri = (path) => `url("data:image/svg+xml,${encodeURIComponent(`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="${path}"/></svg>`)}")`;
+var languageIconCss = (slugs) => slugs.map((slug) => {
+  const icon = iconBySlug(slug);
+  if (!icon) {
+    return "";
+  }
+  const mask = maskUri(icon.path);
+  return `.prose > :where(pre[data-language][data-icon="${slug}"])::after {
+  background-color: var(--blume-muted-foreground);
+  -webkit-mask-image: ${mask};
+  mask-image: ${mask};
+}`;
+}).filter((rule) => rule !== "").join(`
+`);
+
+// src/markdown/mermaid.ts
+var MERMAID_FENCE = /^[ \t]*(?:`{3,}|~{3,})[ \t]*mermaid\b/mu;
+var hasMermaidFence = (text) => MERMAID_FENCE.test(text);
+
 // src/og/derive.ts
-import { existsSync as existsSync3 } from "node:fs";
-import { isAbsolute as isAbsolute2, join as join5 } from "pathe";
+import { existsSync as existsSync4 } from "node:fs";
+import { isAbsolute as isAbsolute2, join as join6 } from "pathe";
 var CARD_WEIGHTS = [400, 600];
-var absoluteSrc = (root, src) => isAbsolute2(src) ? src : join5(root, src);
+var absoluteSrc = (root, src) => isAbsolute2(src) ? src : join6(root, src);
 var isNumericWeight = (weight) => typeof weight === "number";
 var isRangeWeight = (weight) => typeof weight === "string";
 var isFontName = (value) => typeof value === "string";
@@ -1376,27 +1567,27 @@ var missingFontFiles = (options, root) => {
       sources.push(absoluteSrc(root, font.src));
     }
   }
-  return [...new Set(sources)].filter((path) => !existsSync3(path));
+  return [...new Set(sources)].filter((path) => !existsSync4(path));
 };
 
 // src/og/logo.ts
-import { existsSync as existsSync4, readFileSync } from "node:fs";
-import { join as join6 } from "pathe";
+import { existsSync as existsSync5, readFileSync } from "node:fs";
+import { join as join7 } from "pathe";
 var resolveOgLogo = (project, source) => {
   if (!source?.toLowerCase().endsWith(".svg")) {
     return;
   }
   const relative2 = source.replace(/^\//u, "");
   const file = [
-    join6(project.context.root, "public", relative2),
-    join6(project.context.root, relative2)
-  ].find((path) => existsSync4(path));
+    join7(project.context.root, "public", relative2),
+    join7(project.context.root, relative2)
+  ].find((path) => existsSync5(path));
   return file ? readFileSync(file, "utf-8") : undefined;
 };
 
 // src/openapi/scalar.ts
-import { readFile } from "node:fs/promises";
-import { isAbsolute as isAbsolute3, join as join7 } from "pathe";
+import { readFile as readFile2 } from "node:fs/promises";
+import { isAbsolute as isAbsolute3, join as join8 } from "pathe";
 
 // src/theme/palette.ts
 var FALLBACK_ACCENT = "oklch(0.62 0.16 250)";
@@ -1492,9 +1683,9 @@ var specConfiguration = async (spec, root) => {
   if (URL_SPEC.test(spec)) {
     return { config: { url: spec } };
   }
-  const absolute = isAbsolute3(spec) ? spec : join7(root, spec);
+  const absolute = isAbsolute3(spec) ? spec : join8(root, spec);
   try {
-    return { config: { content: await readFile(absolute, "utf-8") } };
+    return { config: { content: await readFile2(absolute, "utf-8") } };
   } catch {
     return {
       config: { url: spec },
@@ -1718,6 +1909,15 @@ ${THEME_MAPPING}
     scroll-padding-top: 4.5rem;
     text-rendering: optimizeLegibility;
   }
+  /* Modal surfaces coordinate through independent root attributes. The lock
+     remains until every owner releases its attribute, while !important lets it
+     temporarily override (and therefore preserve) an authored inline value.
+     Classic (non-overlay) scrollbars would otherwise vanish while locked and
+     shift the page and the centered dialog sideways, so keep their gutter. */
+  html:where([data-blume-nav-open], [data-blume-search-dialog-open]) {
+    overflow: hidden !important;
+    scrollbar-gutter: stable;
+  }
   /* Headings use the display font (defaults to the body font when unset).
      The tightened tracking is part of the theme, not the font: display-tuned
      families bake it into their metrics, but a text family promoted to
@@ -1770,6 +1970,31 @@ ${THEME_MAPPING}
   unicode-bidi: isolate;
 }
 
+/* The sidebar's rows. A docs site renders every sidebar row on every page,
+   so a large site's HTML is mostly this markup — one utility per row kind
+   instead of the dozen classes each expands to keeps every page (and the
+   build's HTML output) small. Kept in sync with NavTree.astro: a page row,
+   a page-mode group's drill-in button, a collapsible group's summary and
+   the link inside it, and a flat group's heading and the link inside it. */
+@utility blume-nav-link {
+  @apply block rounded-[0.65rem] px-2.5 py-1.5 text-muted-foreground text-sm transition-colors hover:bg-muted hover:text-foreground aria-[current=page]:bg-muted aria-[current=page]:font-medium aria-[current=page]:text-foreground;
+}
+@utility blume-nav-drill {
+  @apply flex w-full items-center gap-2 rounded-[0.65rem] px-2.5 py-1.5 text-left font-medium text-foreground text-sm transition-colors hover:bg-muted;
+}
+@utility blume-nav-summary {
+  @apply flex cursor-pointer list-none items-center gap-1.5 rounded-[0.65rem] px-2.5 py-1.5 text-muted-foreground text-sm transition-colors hover:bg-muted hover:text-foreground [&::-webkit-details-marker]:hidden;
+}
+@utility blume-nav-summary-link {
+  @apply -my-1 flex flex-1 items-center gap-1.5 rounded py-1 transition-colors aria-[current=page]:text-foreground aria-[current=page]:font-semibold;
+}
+@utility blume-nav-heading {
+  @apply mb-2 flex items-center gap-1.5 px-2.5 font-medium text-foreground text-sm;
+}
+@utility blume-nav-heading-link {
+  @apply -ml-1 flex flex-1 items-center gap-1.5 rounded-[0.65rem] px-1 py-0.5 text-foreground transition-colors hover:bg-muted aria-[current=page]:bg-muted;
+}
+
 /* Theme Tailwind Typography (prose) with Blume tokens. */
 .prose {
   --tw-prose-body: var(--blume-foreground);
@@ -1985,15 +2210,17 @@ blume-diff {
    CodeBlock (no title) never gets data-language, so without this gate the
    absolutely-positioned icon would overlap the first code line. Fenced code
    and titled blocks always have a header, so the icon shows there. */
-.blume-lang-icon {
-  display: none;
-}
-
-.prose > :where(pre[data-language][data-icon]) > .blume-lang-icon {
-  color: var(--blume-muted-foreground);
-  display: block;
+.prose > :where(pre[data-language][data-icon])::after {
+  content: "";
   height: 0.875rem;
   left: 1rem;
+  -webkit-mask-position: center;
+  -webkit-mask-repeat: no-repeat;
+  -webkit-mask-size: contain;
+  mask-position: center;
+  mask-repeat: no-repeat;
+  mask-size: contain;
+  pointer-events: none;
   position: absolute;
   top: 0.875rem;
   width: 0.875rem;
@@ -2003,6 +2230,11 @@ blume-diff {
   padding-left: 2.5rem;
 }
 
+/* One mask rule per language the site's Markdown uses (see
+   markdown/language-icon.ts); the ::after above only gets a color and a mask
+   from these, so a block whose language has no rule paints nothing. */
+${options.languageIcons ?? ""}
+
 .prose :where(pre code) {
   background: transparent;
   border-radius: 0;
@@ -2401,10 +2633,10 @@ ${options.userCss}
 `;
 
 // src/theme/sources.ts
-import { dirname as dirname4, isAbsolute as isAbsolute4, relative as relative2, resolve as resolve5 } from "pathe";
+import { dirname as dirname5, isAbsolute as isAbsolute4, relative as relative2, resolve as resolve5 } from "pathe";
 var SOURCE_DIRECTIVE = /@source(?<not>\s+not)?\s+(?<quote>["'])(?<path>[^"']+)\k<quote>/gu;
 var rebaseSourceDirectives = (css, options) => {
-  const base = dirname4(options.from);
+  const base = dirname5(options.from);
   return css.replace(SOURCE_DIRECTIVE, (directive, not, quote, path) => {
     if (isAbsolute4(path)) {
       return directive;
@@ -2597,15 +2829,15 @@ export const layoutOverrides = { ...(overrides.layout ?? {})${layoutEntries.leng
 };
 
 // src/astro/examples.ts
-import { readFile as readFile3 } from "node:fs/promises";
+import { readFile as readFile4 } from "node:fs/promises";
 import pMap2 from "p-map";
-import { isAbsolute as isAbsolute5, join as join9, relative as relative3 } from "pathe";
+import { isAbsolute as isAbsolute5, join as join10, relative as relative3 } from "pathe";
 import { glob as glob2 } from "tinyglobby";
 
 // src/astro/islands.ts
-import { readFile as readFile2 } from "node:fs/promises";
+import { readFile as readFile3 } from "node:fs/promises";
 import pMap from "p-map";
-import { basename, join as join8 } from "pathe";
+import { basename, join as join9 } from "pathe";
 import { glob } from "tinyglobby";
 var DEFAULT_CLIENT = "visible";
 var READ_CONCURRENCY = 16;
@@ -2636,14 +2868,14 @@ var readClientMode = (source, file, warnings) => {
   return mode;
 };
 var discoverIslands = async (root) => {
-  const dir = join8(root, "islands");
+  const dir = join9(root, "islands");
   const matches = await glob(["**/*"], {
     absolute: true,
     cwd: dir,
     onlyFiles: true
   });
   const files = matches.toSorted();
-  const sources = await pMap(files, (file) => readFile2(file, "utf-8"), {
+  const sources = await pMap(files, (file) => readFile3(file, "utf-8"), {
     concurrency: READ_CONCURRENCY
   });
   const islands = [];
@@ -2708,14 +2940,14 @@ 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 glob2([rest], {
     absolute: true,
     cwd: dir,
     onlyFiles: true
   });
   const files = matches.toSorted();
-  const sources = await pMap2(files, (file) => readFile3(file, "utf-8"), {
+  const sources = await pMap2(files, (file) => readFile4(file, "utf-8"), {
     concurrency: READ_CONCURRENCY2
   });
   const examples = [];
@@ -2754,10 +2986,10 @@ var exampleMarkdownLookup = (examples) => Object.fromEntries(examples.map((examp
 ]));
 
 // src/astro/generate.ts
-var BLUME_SRC = join10(packageRoot(), "src");
+var BLUME_SRC = join11(packageRoot(), "src");
 var canResolveFrom = (fromDir, spec) => {
   try {
-    createRequire2(pathToFileURL(join10(fromDir, "_.js")).href).resolve(spec);
+    createRequire2(pathToFileURL(join11(fromDir, "_.js")).href).resolve(spec);
     return true;
   } catch {
     return false;
@@ -2768,7 +3000,7 @@ var resolveReactCompiler = (config, needsReact, pkgDir = packageRoot()) => {
     return null;
   }
   try {
-    return createRequire2(pathToFileURL(join10(pkgDir, "_.js")).href).resolve("babel-plugin-react-compiler");
+    return createRequire2(pathToFileURL(join11(pkgDir, "_.js")).href).resolve("babel-plugin-react-compiler");
   } catch {
     return null;
   }
@@ -2778,7 +3010,7 @@ var reactCompilerWarnings = (config, needsReact, compilerPath) => needsReact &&
 ] : [];
 var resolveAstroPackageJson = (modulesDir) => {
   try {
-    return realpathSync(join10(modulesDir, "astro", "package.json"));
+    return realpathSync(join11(modulesDir, "astro", "package.json"));
   } catch {
     return null;
   }
@@ -2786,12 +3018,12 @@ var resolveAstroPackageJson = (modulesDir) => {
 var resolvedAstroHit = (fromDir) => {
   let dir = normalize(fromDir);
   while (true) {
-    const modulesDir = join10(dir, "node_modules");
+    const modulesDir = join11(dir, "node_modules");
     const pkg = resolveAstroPackageJson(modulesDir);
     if (pkg) {
       return { modulesDir, pkg };
     }
-    const parent = dirname5(dir);
+    const parent = dirname6(dir);
     if (parent === dir) {
       return null;
     }
@@ -2806,10 +3038,17 @@ var sameRealDir = (a, b) => {
   }
 };
 var depsCandidates = (pkgDir) => [
-  join10(pkgDir, "node_modules"),
-  dirname5(pkgDir)
+  join11(pkgDir, "node_modules"),
+  dirname6(pkgDir)
 ];
-var candidateHolding = (pkgDir, ...segments) => depsCandidates(pkgDir).find((dir) => existsSync5(join10(dir, ...segments))) ?? null;
+var candidateHolding = (pkgDir, ...segments) => depsCandidates(pkgDir).find((dir) => existsSync6(join11(dir, ...segments))) ?? null;
+var symlinkDir = async (target, link) => {
+  try {
+    await symlink(target, link, "dir");
+  } catch {
+    await symlink(target, link, "junction");
+  }
+};
 var linkDepsJunction = async (link, depsDir) => {
   let existing;
   try {
@@ -2822,14 +3061,14 @@ var linkDepsJunction = async (link, depsDir) => {
       return;
     }
     try {
-      if (resolve6(dirname5(link), await readlink(link)) === resolve6(depsDir)) {
+      if (resolve6(dirname6(link), await readlink(link)) === resolve6(depsDir)) {
         return;
       }
     } catch {}
-    await rm(link, { force: true });
+    await rm2(link, { force: true });
   }
-  await mkdir(dirname5(link), { recursive: true });
-  await symlink(depsDir, link, "junction");
+  await mkdir2(dirname6(link), { recursive: true });
+  await symlinkDir(depsDir, link);
 };
 var readPkgVersion = (pkgJsonPath) => {
   if (!pkgJsonPath) {
@@ -2861,13 +3100,13 @@ var dropStaleDepsLink = async (link, pkgDir) => {
   let linkedBlume;
   let runningBlume;
   try {
-    linkedBlume = await realpath(join10(link, "blume"));
+    linkedBlume = await realpath(join11(link, "blume"));
     runningBlume = await realpath(pkgDir);
   } catch {
     return;
   }
   if (linkedBlume !== runningBlume) {
-    await rm(link, { force: true });
+    await rm2(link, { force: true });
   }
 };
 var ensureDepsLink = async (outDir, pkgDir = packageRoot()) => {
@@ -2877,7 +3116,7 @@ var ensureDepsLink = async (outDir, pkgDir = packageRoot()) => {
   }
   const mdxDir = candidateHolding(pkgDir, "@astrojs", "mdx");
   const blumeAstro = resolveAstroPackageJson(astroDir);
-  await dropStaleDepsLink(join10(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);
@@ -2885,7 +3124,7 @@ var ensureDepsLink = async (outDir, pkgDir = packageRoot()) => {
     return null;
   }
   if (mdxDir && (mdxDir === astroDir || astroCorrect)) {
-    await linkDepsJunction(join10(outDir, "node_modules"), mdxDir);
+    await linkDepsJunction(join11(outDir, "node_modules"), mdxDir);
     return null;
   }
   return astroConflictWarning(blumeAstro, outDirHit?.pkg ?? null);
@@ -2938,14 +3177,14 @@ var askProviderWarnings = (ask, root, pkgDir = packageRoot()) => {
     `Ask AI provider "${ask.provider}" needs "${dep}", which isn't installed. Run \`npm install ${dep}\` (or your package manager's equivalent).`
   ];
 };
-var examplesCssFile = (root, config) => config.examples.css ? join10(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(join10(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 && !existsSync5(cssFile) ? [
+  return cssFile && !existsSync6(cssFile) ? [
     `examples.css points at "${config.examples.css}", which doesn't exist; previews render without it.`
   ] : [];
 };
@@ -2954,7 +3193,7 @@ var readOptional = async (path) => {
     return "";
   }
   try {
-    return await readFile4(path, "utf-8");
+    return await readFile5(path, "utf-8");
   } catch {
     return "";
   }
@@ -2979,7 +3218,7 @@ var detectUsesMath = async (root, staged = []) => {
     ignore: ["**/node_modules/**", "**/.blume/**", "**/dist/**"],
     onlyFiles: true
   });
-  const contents = await pMap3(files, (file) => readOptional(join10(root, file)), {
+  const contents = await pMap3(files, (file) => readOptional(join11(root, file)), {
     concurrency: READ_CONCURRENCY3
   });
   return [...contents, ...staged].some(containsMath);
@@ -2997,7 +3236,7 @@ var loadIntegrationBridge = async (config, context) => {
 var writeIfChanged = async (path, content) => {
   let existing = null;
   try {
-    existing = await readFile4(path, "utf-8");
+    existing = await readFile5(path, "utf-8");
   } catch {
     existing = null;
   }
@@ -3017,7 +3256,7 @@ var pruneOrphans = async (srcDir, written) => {
   for (const path of existing) {
     const normalized = normalize(path);
     if (!written.has(normalized)) {
-      removals.push(rm(normalized, { force: true }));
+      removals.push(rm2(normalized, { force: true }));
     }
   }
   await Promise.all(removals);
@@ -3041,11 +3280,11 @@ var writeStagedContent = async (out, staged) => {
   const contentDir = stagedContentDir(out);
   const written = new Set;
   await Promise.all([...staged].map(async ([entryId, text]) => {
-    const path = join10(contentDir, entryId);
+    const path = join11(contentDir, entryId);
     written.add(normalize(path));
     await writeIfChanged(path, text);
   }));
-  if (existsSync5(contentDir)) {
+  if (existsSync6(contentDir)) {
     await pruneOrphans(contentDir, written);
   }
 };
@@ -3056,9 +3295,9 @@ var readLogoSvg = (project, source) => {
   }
   const rel = source.replace(/^\//u, "");
   const file = [
-    join10(project.context.root, "public", rel),
-    join10(project.context.root, rel)
-  ].find((path) => existsSync5(path));
+    join11(project.context.root, "public", rel),
+    join11(project.context.root, rel)
+  ].find((path) => existsSync6(path));
   return file ? readFileSync3(file, "utf-8") : undefined;
 };
 var isStringShorthand = (value) => typeof value === "string";
@@ -3113,10 +3352,10 @@ var faviconType = (name) => {
 var inlineDataUri = (file, type) => `data:${type};base64,${readFileSync3(file).toString("base64")}`;
 var defaultFavicon = () => ({
   dark: {
-    href: inlineDataUri(join10(BLUME_SRC, "assets", "icon-dark.png"), "image/png"),
+    href: inlineDataUri(join11(BLUME_SRC, "assets", "icon-dark.png"), "image/png"),
     type: "image/png"
   },
-  href: inlineDataUri(join10(BLUME_SRC, "assets", "icon.png"), "image/png"),
+  href: inlineDataUri(join11(BLUME_SRC, "assets", "icon.png"), "image/png"),
   type: "image/png"
 });
 var APPLE_ICON_CANDIDATES = [
@@ -3128,13 +3367,13 @@ var APPLE_ICON_CANDIDATES = [
 var resolveIconFile = (project, candidates) => {
   const { root } = project.context;
   for (const name of candidates) {
-    if (existsSync5(join10(root, "public", name))) {
+    if (existsSync6(join11(root, "public", name))) {
       return { href: `/${name}`, type: faviconType(name) };
     }
   }
   for (const name of candidates) {
-    const file = join10(root, name);
-    if (existsSync5(file)) {
+    const file = join11(root, name);
+    if (existsSync6(file)) {
       const type = faviconType(name);
       return { href: inlineDataUri(file, type ?? "image/x-icon"), type };
     }
@@ -3144,19 +3383,19 @@ var resolveIconFile = (project, candidates) => {
 var resolveFavicon = (project) => {
   const { root } = project.context;
   for (const name of FAVICON_CANDIDATES) {
-    if (existsSync5(join10(root, "public", name))) {
+    if (existsSync6(join11(root, "public", name))) {
       const type = faviconType(name);
       const sibling = darkSibling(name);
-      return existsSync5(join10(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 = join10(root, name);
-    if (existsSync5(file)) {
+    const file = join11(root, name);
+    if (existsSync6(file)) {
       const type = faviconType(name);
       const mime = type ?? "image/x-icon";
-      const siblingFile = join10(root, darkSibling(name));
-      return existsSync5(siblingFile) ? {
+      const siblingFile = join11(root, darkSibling(name));
+      return existsSync6(siblingFile) ? {
         dark: { href: inlineDataUri(siblingFile, mime), type },
         href: inlineDataUri(file, mime),
         type
@@ -3227,7 +3466,7 @@ var buildRuntimeData = (project) => {
     }
     const rel = relative4(context.root, sourcePath).split("\\").join("/");
     const editDir = trimChar(github?.dir ?? "", "/");
-    const editPath = normalize(editDir ? join10(editDir, rel) : rel);
+    const editPath = normalize(editDir ? join11(editDir, rel) : rel);
     if (editPath.startsWith("..") || isAbsolute6(editPath)) {
       return null;
     }
@@ -3371,7 +3610,7 @@ var buildRuntimeData = (project) => {
 var planMcp = (project, srcDir, userPages) => {
   const { config } = project;
   const { route } = config.ai.mcp;
-  const dir = join10(srcDir, "blume-mcp");
+  const dir = join11(srcDir, "blume-mcp");
   const base = {
     dir,
     discoveryPages: [],
@@ -3395,11 +3634,11 @@ var planMcp = (project, srcDir, userPages) => {
     ...base,
     discoveryPages: [
       {
-        entrypoint: join10(dir, "discovery.ts"),
+        entrypoint: join11(dir, "discovery.ts"),
         pattern: "/.well-known/mcp.json"
       },
       {
-        entrypoint: join10(dir, "server-card.ts"),
+        entrypoint: join11(dir, "server-card.ts"),
         pattern: "/.well-known/mcp/server-card.json"
       }
     ],
@@ -3426,9 +3665,9 @@ var writeMcpFiles = async (plan, write, data) => {
     version: data.version
   };
   await Promise.all([
-    write(join10(plan.srcDir, "pages", mcpPageFile(plan.route)), mcpEndpointTemplate()),
-    write(join10(plan.dir, "discovery.ts"), staticJsonEndpointTemplate(buildMcpDiscovery(discoveryInput))),
-    write(join10(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/[");
@@ -3440,7 +3679,7 @@ var planApi = (project, srcDir, userPages) => {
     catchAll: server && !userPages.some(ownsApiRest) && !project.graph.pages.some(contentUnderApi),
     enabled: config.ai.api,
     server,
-    spec: !routeIsTaken(userPages, project.graph.pages, OPENAPI_PATH) && !existsSync5(join10(context.root, "public", "openapi.json")),
+    spec: !routeIsTaken(userPages, project.graph.pages, OPENAPI_PATH) && !existsSync6(join11(context.root, "public", "openapi.json")),
     srcDir
   };
 };
@@ -3450,20 +3689,20 @@ var writeApiFiles = async (project, plan, write, data, mcp) => {
   }
   const { config } = project;
   const mcpRoute = mcp.enabled ? mcp.route : null;
-  const apiDir = join10(plan.srcDir, "pages", "api");
+  const apiDir = join11(plan.srcDir, "pages", "api");
   const writes = [
-    write(join10(apiDir, "docs", "pages.json.ts"), apiPagesIndexTemplate()),
-    write(join10(apiDir, "docs", "pages", "[...route].json.ts"), apiPageTemplate()),
-    write(join10(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(join10(apiDir, "docs", "search.ts"), apiSearchTemplate()));
+    writes.push(write(join11(apiDir, "docs", "search.ts"), apiSearchTemplate()));
   }
   if (plan.catchAll) {
-    writes.push(write(join10(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(join10(plan.srcDir, "pages", "openapi.json.ts"), staticJsonEndpointTemplate(buildApiSpec({
+    writes.push(write(join11(plan.srcDir, "pages", "openapi.json.ts"), staticJsonEndpointTemplate(buildApiSpec({
       agentReadability: config.seo.agentReadability,
       base: data.base,
       description: config.description,
@@ -3479,7 +3718,7 @@ var writeApiFiles = async (project, plan, write, data, mcp) => {
 };
 var planPlaygroundProxy = (config, srcDir) => ({
   enabled: needsPlaygroundProxy(config),
-  entrypoint: join10(srcDir, "blume-openapi", "api-proxy.ts"),
+  entrypoint: join11(srcDir, "blume-openapi", "api-proxy.ts"),
   pattern: "/_api-proxy"
 });
 var specOriginsOf = (spec) => {
@@ -3522,7 +3761,7 @@ var writeAskFiles = async (project, srcDir, write, modules) => {
   if (grounded) {
     modules.set("blume:ask-data", JSON.stringify(await buildAskData(project)));
   }
-  await write(join10(srcDir, "pages", "api", "ask.ts"), askEndpointTemplate(resolveAskBackend(ask), grounded, {
+  await write(join11(srcDir, "pages", "api", "ask.ts"), askEndpointTemplate(resolveAskBackend(ask), grounded, {
     instructions: ask.instructions,
     retrieval: ask.retrieval
   }));
@@ -3532,14 +3771,14 @@ var writeNotFoundPage = async (write, srcDir, pages, contentPages) => {
     return;
   }
   await Promise.all([
-    write(join10(srcDir, "pages", "404.astro"), notFoundPageTemplate()),
-    write(join10(srcDir, "pages", "404.md.ts"), notFoundMarkdownTemplate()),
-    write(join10(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;
 var buildComponentSlots = async (componentsFile) => {
-  const analysis = componentsFile ? analyzeComponentOverrides(await readFile4(componentsFile, "utf-8"), componentsFile) : null;
+  const analysis = componentsFile ? analyzeComponentOverrides(await readFile5(componentsFile, "utf-8"), componentsFile) : null;
   return {
     plan: planComponentSlots(componentsFile, analysis),
     tags: analysis ? [...analysis.mdx, ...analysis.islands].map((entry) => entry.key) : [],
@@ -3562,17 +3801,30 @@ var assertFontFilesExist = (project) => {
     });
   }
 };
+var clientFeaturesFrom = (project, rawMarkdown) => ({
+  epub: project.config.export.epub,
+  mermaid: Object.values(rawMarkdown).some((entry) => hasMermaidFence(entry.mdx ?? entry.md ?? "")) || project.graph.pages.some((page) => page.body !== undefined && hasMermaidFence(page.body.text))
+});
+var languageIconCssFrom = (project, rawMarkdown) => languageIconCss(languageIconSlugsIn([
+  ...Object.values(rawMarkdown).map((entry) => entry.mdx ?? entry.md ?? ""),
+  ...project.graph.pages.map((page) => page.body?.text ?? "")
+].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 clientFeaturesFor = async (project) => clientFeaturesFrom(project, await buildRawMarkdown(project));
 var generateRuntime = async (project) => {
   const { context, config } = project;
   assertFontFilesExist(project);
   const out = context.outDir;
-  const srcDir = join10(out, "src");
-  const generatedDir = join10(srcDir, "generated");
-  const askPath = join10(srcDir, "generated", "Ask.astro");
-  const themePath = join10(srcDir, "generated", "app.css");
-  const searchClientPath = join10(srcDir, "generated", "search-client.ts");
-  const examplesPath = join10(srcDir, "generated", "examples.ts");
-  const examplesThemePath = join10(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 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(normalize(path));
@@ -3585,6 +3837,10 @@ var generateRuntime = async (project) => {
   const askEnabled = config.ai.ask?.enabled ?? false;
   const exportPdf = config.export.pdf;
   const exportEpub = config.export.epub;
+  const rawMarkdown = await buildRawMarkdown(project);
+  const clientFeatures = clientFeaturesFrom(project, rawMarkdown);
+  const navFragments = navVariants(project.graph).some(({ navigation }) => hasDeferrableGroups(navigation.sidebar));
+  const languageIcons = languageIconCssFrom(project, rawMarkdown);
   const staged = collectStaged(project);
   const [
     pages,
@@ -3643,7 +3899,7 @@ var generateRuntime = async (project) => {
   const docsCollection = resolveDocsCollection(config, context);
   const [structural] = await Promise.all([
     Promise.all([
-      write(join10(out, "astro.config.mjs"), astroConfigTemplate({
+      write(join11(out, "astro.config.mjs"), astroConfigTemplate({
         aliases: resolveTsconfigAliases(context.root),
         askPath,
         config,
@@ -3652,6 +3908,8 @@ var generateRuntime = async (project) => {
         context,
         examplesPath,
         examplesThemePath,
+        features: clientFeatures,
+        featuresPath,
         integrationBridge,
         needsReact,
         needsSvelte,
@@ -3661,25 +3919,27 @@ var generateRuntime = async (project) => {
         searchClientPath,
         themePath
       })),
-      write(join10(out, "package.json"), runtimePackageTemplate(runtimeDependencies({ config, needsReact, needsSvelte, needsVue }))),
-      write(join10(out, "tsconfig.json"), runtimeTsconfigTemplate()),
-      write(join10(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(join10(srcDir, "pages", "[...slug].astro"), catchAllPageTemplate({
+      write(join11(srcDir, "pages", "[...slug].astro"), catchAllPageTemplate({
         exportEpub,
         exportPdf,
         mathEnabled: usesMath,
+        navFragments,
         needsReact
       })),
+      writeNavFragments(write, srcDir, navFragments),
       write(askPath, askComponentTemplate(askEnabled)),
-      write(join10(srcDir, "generated", "components.ts"), slotPlan.module),
-      write(join10(srcDir, "generated", "islands.ts"), islandMapTemplate(islandDiscovery.islands)),
-      write(join10(srcDir, "generated", "examples.ts"), exampleMapTemplate(exampleDiscovery.examples, config.basePath)),
+      write(join11(srcDir, "generated", "components.ts"), slotPlan.module),
+      write(join11(srcDir, "generated", "islands.ts"), islandMapTemplate(islandDiscovery.islands)),
+      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}`),
@@ -3687,6 +3947,7 @@ var generateRuntime = async (project) => {
       })),
       write(themePath, tailwindEntryTemplate({
         configTokens: `${buildThemeCss(config.theme)}${buildFontsCss(config.theme.fonts)}`,
+        languageIcons,
         sources: [
           `${BLUME_SRC}/**/*.{astro,ts,tsx}`,
           `${context.root}/**/*.{astro,mdx,ts,tsx}`
@@ -3695,24 +3956,29 @@ var generateRuntime = async (project) => {
         userTheme
       }))
     ]),
-    Promise.all(islandDiscovery.islands.map((island) => write(join10(srcDir, "generated", "islands", `${island.name}.astro`), islandWrapperTemplate(island)))),
-    Promise.all(slotPlan.wrappers.map((wrapper) => write(join10(srcDir, "generated", "component-slots", `${wrapper.name}.astro`), wrapper.content))),
-    Promise.all(exampleDiscovery.examples.map((example) => write(join10(srcDir, "generated", "examples", `${exampleSlug(example.path)}.astro`), exampleWrapperTemplate(example)))),
+    Promise.all(islandDiscovery.islands.map((island) => write(join11(srcDir, "generated", "islands", `${island.name}.astro`), islandWrapperTemplate(island)))),
+    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)
   ]);
   if (config.seo.og.enabled) {
-    await write(join10(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),
+        version: getBlumeVersion()
+      },
       pageDescriptions: config.seo.og.description !== false
     }, changelogIndex));
   }
   if (changelogIndex) {
-    await write(join10(srcDir, "pages", "changelog.astro"), changelogIndexTemplate({
+    await write(join11(srcDir, "pages", "changelog.astro"), changelogIndexTemplate({
       exportEpub,
       exportPdf,
+      mathEnabled: usesMath,
       needsReact,
       staged: hasStaged
     }));
@@ -3726,32 +3992,32 @@ var generateRuntime = async (project) => {
       write
     }),
     writeNotFoundPage(write, srcDir, pages, project.graph.pages),
-    write(searchClientPath, searchClientTemplate(config))
+    write(searchClientPath, searchClientTemplate(config)),
+    write(featuresPath, featuresTemplate(clientFeatures))
   ]);
   if (servesStaticIndex(config.search.provider)) {
     const documents = await buildSearchDocuments(project);
     modules.set("blume:search-index", JSON.stringify(documents));
-    await write(join10(srcDir, "pages", "blume-search.json.ts"), searchEndpointTemplate());
+    await write(join11(srcDir, "pages", "blume-search.json.ts"), searchEndpointTemplate());
   }
   if (config.search.provider === "mixedbread") {
-    await write(join10(srcDir, "pages", "api", "search.ts"), mixedbreadSearchEndpointTemplate(config.search.mixedbread?.storeId ?? ""));
+    await write(join11(srcDir, "pages", "api", "search.ts"), mixedbreadSearchEndpointTemplate(config.search.mixedbread?.storeId ?? ""));
   }
-  await write(join10(srcDir, "generated", "includes.json"), `${JSON.stringify(buildIncludeGraph(project.graph.pages))}
+  await write(join11(srcDir, "generated", "includes.json"), `${JSON.stringify(buildIncludeGraph(project.graph.pages))}
 `);
-  const rawMarkdown = await buildRawMarkdown(project);
   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(join10(srcDir, "pages", "[...slug].md.ts"), rawMarkdownEndpointTemplate("md")),
-    write(join10(srcDir, "pages", "[...slug].mdx.ts"), rawMarkdownEndpointTemplate("mdx")),
-    write(join10(srcDir, "pages", "blume-assets", "[...asset].ts"), contentAssetsEndpointTemplate(join10(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(join10(srcDir, "pages", "[section]", "rss.xml.ts"), rssEndpointTemplate());
+    await write(join11(srcDir, "pages", "[section]", "rss.xml.ts"), rssEndpointTemplate());
   }
   const warnings = [
     ...depsLinkWarning ? [depsLinkWarning] : [],
@@ -3787,12 +4053,12 @@ var generateRuntime = async (project) => {
       root: context.root
     });
     warnings.push(...references.warnings);
-    await Promise.all(references.files.map((file) => write(join10(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(join10(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)
   ]);
@@ -3802,7 +4068,7 @@ var generateRuntime = async (project) => {
   return { structuralChange: structural.some(Boolean), warnings };
 };
 
-export { SIGNATURES_DIRECTORY_PATH, SIGNATURES_DIRECTORY_TYPE, publishBuildProject, refreshBlumeContent, showBlumeErrorOverlay, buildAskData, buildMcpDiscovery, buildMcpServerCard, buildThemeCss, buildReferenceFiles, tailwindEntryTemplate, examplesEntryTemplate, rebaseSourceDirectives, twoslashCss, planComponentSlots, discoverIslands, EXAMPLE_SCAN_GLOB, exampleScanRoots, discoverExamples, exampleMarkdownLookup, detectNeedsReact, detectUsesMath, collectStaged, buildRuntimeData, generateRuntime };
+export { SIGNATURES_DIRECTORY_PATH, SIGNATURES_DIRECTORY_TYPE, publishBuildProject, refreshBlumeContent, showBlumeErrorOverlay, ogCacheDir, pruneCardCache, cardCacheTally, buildAskData, buildMcpDiscovery, buildMcpServerCard, buildThemeCss, buildReferenceFiles, tailwindEntryTemplate, examplesEntryTemplate, rebaseSourceDirectives, twoslashCss, planComponentSlots, discoverIslands, EXAMPLE_SCAN_GLOB, exampleScanRoots, discoverExamples, exampleMarkdownLookup, detectNeedsReact, detectUsesMath, collectStaged, buildRuntimeData, languageIconCssFor, clientFeaturesFor, generateRuntime };
 
-//# debugId=39608A54607A739D64756E2164756E21
-//# sourceMappingURL=chunk-62qsssnh.js.map
+//# debugId=29D4FE8449AF429964756E2164756E21
+//# sourceMappingURL=chunk-x1wvw7a8.js.map