blume 1.7.2 → 2.0.0

package/dist/cli/{chunk-5n7t497w.js → chunk-z1f5arsg.js}

@@ -6,11 +6,28 @@ import {
   enrichDiagnostic
 } from "./index.js";
 import {
+  OPENAPI_PATH,
+  API_PAGES_PATH,
+  API_PAGE_PATH,
+  API_NAVIGATION_PATH,
+  API_SEARCH_PATH,
+  apiNamePhrase,
   resolveReferences,
   referenceRoutes,
   hasScalarReferences,
-  builtinProxyKinds,
+  builtinProxyReferences,
   needsPlaygroundProxy,
+  buildMcpDiscovery,
+  buildMcpServerCard,
+  hasAiCatalog,
+  buildHomeLinkHeader,
+  resolveDocsCollection,
+  discoverPages,
+  routeIsTaken,
+  hasGeneratedChangelog,
+  customOgRoutes,
+  resolveFallbackLocale,
+  resolveAskBackend,
   GOOGLE_FONTS,
   isFontSlug,
   fontLocaleCodes,
@@ -20,44 +37,40 @@ import {
   editBaseUrl,
   apiUrl,
   EN_UI,
-  resolveUIStrings
-} from "./chunk-61j18dwk.js";
-import {
-  resolveFallbackLocale,
-  validateSearchPopularIcons,
-  validateNavTargets,
+  resolveUIStrings,
   buildIncludeGraph,
-  apiNamePhrase,
+  rewriteRelativeImages,
+  collectContentAssets,
+  buildRssFeeds,
+  renderRssFeed,
   isOpenApiSource,
-  resolveDocsCollection
-} from "./chunk-hdm2dkd2.js";
+  buildRawMarkdown,
+  markdownRoutePaths
+} from "./chunk-xaz13gwg.js";
 import {
+  trimChar,
+  normalizeBasePath,
+  withBasePath,
   siteRoot,
-  absoluteUrl
-} from "./chunk-88by27n5.js";
+  absoluteUrl2
+} from "./chunk-jts8mvcz.js";
+import {
+  validateSearchPopularIcons,
+  validateNavTargets
+} from "./chunk-zg2gtj10.js";
 import {
-  buildRssFeeds,
-  renderRssFeed,
-  buildRawMarkdown,
-  markdownRoutePaths,
   buildSearchDocuments,
   buildMcpData
-} from "./chunk-wjt80jps.js";
+} from "./chunk-a9kptbw5.js";
 import {
-  OPENAPI_PATH,
-  API_PAGES_PATH,
-  API_PAGE_PATH,
-  API_NAVIGATION_PATH,
-  API_SEARCH_PATH
-} from "./chunk-tqa1s0k8.js";
+  emptyComponentOverrides,
+  analyzeComponentOverrides
+} from "./chunk-f2972sbt.js";
 import {
-  rewriteRelativeImages,
-  collectContentAssets
-} from "./chunk-450a7rcr.js";
+  writeTextAtomic
+} from "./chunk-jq5n4avg.js";
 import {
-  resolveAskBackend,
-  askBackendRuntimeDep,
-  buildHomeLinkHeader,
+  planComponentSlots,
   publishRuntimeModules,
   runtimeDependencies,
   astroConfigTemplate,
@@ -89,52 +102,31 @@ import {
   apiNavigationTemplate,
   apiSearchTemplate,
   apiNotFoundTemplate,
-  islandWrapperTemplate,
-  islandMapTemplate,
   exampleSlug,
   exampleWrapperTemplate,
   exampleMapTemplate,
   examplesPageTemplate,
   runtimePackageTemplate,
   runtimeTsconfigTemplate
-} from "./chunk-ejjx8znq.js";
-import {
-  discoverPages,
-  routeIsTaken,
-  hasGeneratedChangelog,
-  customOgRoutes
-} from "./chunk-vrfp10qk.js";
-import {
-  writeTextAtomic
-} from "./chunk-jq5n4avg.js";
+} from "./chunk-mnqj32sj.js";
 import {
   registry
-} from "./chunk-688e0dde.js";
-import {
-  MCP_TOOLS
-} from "./chunk-ra1v2nc2.js";
+} from "./chunk-88cpgt6h.js";
 import {
-  searchProviderMeta,
-  servesStaticIndex
-} from "./chunk-q4rae3bg.js";
-import {
-  trimChar,
-  normalizeBasePath,
-  withBasePath
-} from "./chunk-2mzebbbz.js";
-
-// src/ai/web-bot-auth.ts
-var SIGNATURES_DIRECTORY_PATH = "/.well-known/http-message-signatures-directory";
-var SIGNATURES_DIRECTORY_TYPE = "application/http-message-signatures-directory+json";
+  readClientMode,
+  discoverIslands,
+  missingDependencyDiagnostic
+} from "./chunk-bnbmcwfb.js";
 
 // src/astro/integration.ts
 import { join as join3, relative, resolve as resolve2 } from "pathe";
 
 // src/deploy/artifacts.ts
-import { dirname, join as join2, resolve } from "pathe";
+import { dirname as dirname2, join as join2, resolve } from "pathe";
 
 // src/search/build.ts
-import { join } from "pathe";
+import { close, createIndex } from "pagefind";
+import { dirname, join } from "pathe";
 
 // src/deploy/sitemap.ts
 import { escape as escapeXml } from "html-escaper";
@@ -219,7 +211,7 @@ import {
   rm,
   writeFile
 } from "node:fs/promises";
-import { dirname as dirname2, join as join4 } from "pathe";
+import { dirname as dirname3, join as join4 } from "pathe";
 var ogCacheDir = (context) => existsSync(join4(context.root, "node_modules")) ? join4(context.root, "node_modules", ".cache", "blume", "og") : join4(context.outDir, ".cache", "og");
 var REGISTRY_KEY2 = Symbol.for("blume.og-cache");
 var registry3 = () => {
@@ -248,11 +240,11 @@ var cardCacheTally = () => {
 
 // src/astro/generate.ts
 import { createHash } from "node:crypto";
-import { existsSync as existsSync6, readFileSync as readFileSync3, realpathSync } from "node:fs";
+import { existsSync as existsSync6, readFileSync as readFileSync3, realpathSync as realpathSync2 } from "node:fs";
 import {
   lstat,
   mkdir as mkdir2,
-  readFile as readFile5,
+  readFile as readFile4,
   readlink,
   realpath,
   rm as rm2,
@@ -260,17 +252,9 @@ import {
 } from "node:fs/promises";
 import { createRequire as createRequire2 } from "node:module";
 import { pathToFileURL } from "node:url";
-import pMap3 from "p-map";
-import {
-  basename as basename2,
-  dirname as dirname6,
-  isAbsolute as isAbsolute6,
-  join as join11,
-  normalize,
-  relative as relative4,
-  resolve as resolve6
-} from "pathe";
-import { glob as glob3 } from "tinyglobby";
+import pMap2 from "p-map";
+import { dirname as dirname7, isAbsolute as isAbsolute6, join as join11, normalize as normalize2, relative as relative5, resolve as resolve6 } from "pathe";
+import { glob as glob2 } from "tinyglobby";
 
 // src/ai/api/problem.ts
 var PROBLEM_TYPE = "application/problem+json";
@@ -591,7 +575,7 @@ var ROUTE_PARAM = {
 };
 var serverUrl = (input) => {
   if (input.site) {
-    return input.base ? absoluteUrl(input.site, input.base) : siteRoot(input.site);
+    return input.base ? absoluteUrl2(input.site, input.base) : siteRoot(input.site);
   }
   return input.base || "/";
 };
@@ -779,7 +763,7 @@ var buildApiSpec = (input) => {
   if (input.site) {
     document.externalDocs = {
       description: `${input.name} documentation`,
-      url: absoluteUrl(input.site, withBasePath(input.base, "/"))
+      url: absoluteUrl2(input.site, withBasePath(input.base, "/"))
     };
   }
   return document;
@@ -801,72 +785,10 @@ var buildAskData = async (project) => {
       route: doc.route,
       title: doc.title
     })),
-    site: project.config.deployment.site ?? null
+    site: project.config.deployment.options.site ?? null
   };
 };
 
-// src/ai/mcp/discovery.ts
-var serverUrl2 = (input) => {
-  const path = withBasePath(input.base, input.route);
-  return input.site ? absoluteUrl(input.site, path) : path;
-};
-var buildMcpDiscovery = (input) => ({
-  servers: [
-    {
-      name: input.name,
-      transport: "streamable-http",
-      url: serverUrl2(input)
-    }
-  ]
-});
-var SERVER_CARD_SCHEMA = "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json";
-var CARD_TEXT_MAX = 100;
-var truncate = (text) => text.length > CARD_TEXT_MAX ? `${text.slice(0, CARD_TEXT_MAX - 1)}…` : text;
-var NON_ASCII_SLUG = /[^a-z0-9]+/gu;
-var COMBINING_MARKS = /\p{M}+/gu;
-var asciiSlugify = (text) => trimChar(text.normalize("NFKD").replace(COMBINING_MARKS, "").toLowerCase().replace(NON_ASCII_SLUG, "-"), "-");
-var reverseDnsName = (input) => {
-  let namespace = "localhost";
-  if (input.site) {
-    try {
-      namespace = new URL(input.site).hostname.split(".").toReversed().join(".");
-    } catch {}
-  }
-  return `${namespace}/${asciiSlugify(input.name) || "docs"}`;
-};
-var HTTP_URL = /^https?:\/\//u;
-var buildMcpServerCard = (input) => {
-  const url = serverUrl2(input);
-  const card = {
-    $schema: SERVER_CARD_SCHEMA,
-    capabilities: {
-      resources: { listChanged: false, subscribe: false },
-      tools: { listChanged: false }
-    },
-    description: truncate(`Model Context Protocol server for the ${input.name} documentation.`),
-    name: reverseDnsName(input),
-    serverInfo: { name: input.name, version: input.version },
-    title: truncate(input.name),
-    tools: MCP_TOOLS.map((tool) => ({
-      annotations: tool.annotations,
-      description: tool.description,
-      name: tool.name,
-      title: tool.title
-    })),
-    transport: "streamable-http",
-    transports: [{ endpoint: url, type: "streamable-http" }],
-    url,
-    version: input.version
-  };
-  if (HTTP_URL.test(url)) {
-    card.remotes = [{ type: "streamable-http", url }];
-  }
-  if (input.site) {
-    card.websiteUrl = siteRoot(input.site);
-  }
-  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) => [
@@ -947,271 +869,6 @@ var validateUsedComponents = (pages, extraTags, registryNames) => {
   return diagnostics;
 };
 
-// src/core/component-overrides.ts
-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);
-var isGroup = (name) => GROUP_SET.has(name);
-var FRAMEWORK_BY_EXT = new Map([
-  ["jsx", "react"],
-  ["svelte", "svelte"],
-  ["tsx", "react"],
-  ["vue", "vue"]
-]);
-var FRAMEWORK_LABEL = {
-  react: "React",
-  svelte: "Svelte",
-  vue: "Vue"
-};
-var COMPONENT_EXTS = [
-  "astro",
-  "tsx",
-  "ts",
-  "jsx",
-  "js",
-  "mjs",
-  "vue",
-  "svelte"
-];
-var HYDRATION_MODES = new Set([
-  "idle",
-  "load",
-  "media",
-  "only",
-  "visible"
-]);
-var isHydrationMode = (value) => HYDRATION_MODES.has(value);
-var emptyAnalysis = () => ({
-  islands: [],
-  layout: [],
-  mdx: [],
-  warnings: []
-});
-var propName = (name) => ts.isIdentifier(name) || ts.isStringLiteral(name) ? name.text : undefined;
-var addImportBindings = (map, statement) => {
-  if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) {
-    return;
-  }
-  const specifier = statement.moduleSpecifier.text;
-  const clause = statement.importClause;
-  if (!clause) {
-    return;
-  }
-  if (clause.name) {
-    map.set(clause.name.text, { imported: "default", specifier });
-  }
-  const named = clause.namedBindings;
-  if (named && ts.isNamedImports(named)) {
-    for (const element of named.elements) {
-      map.set(element.name.text, {
-        imported: (element.propertyName ?? element.name).text,
-        specifier
-      });
-    }
-  }
-};
-var collectImports = (sourceFile) => {
-  const map = new Map;
-  for (const statement of sourceFile.statements) {
-    addImportBindings(map, statement);
-  }
-  return map;
-};
-var unwrapObject = (expression) => {
-  if (ts.isObjectLiteralExpression(expression)) {
-    return expression;
-  }
-  if (ts.isCallExpression(expression)) {
-    const [arg] = expression.arguments;
-    return arg && ts.isObjectLiteralExpression(arg) ? arg : undefined;
-  }
-  if (ts.isAsExpression(expression) || ts.isParenthesizedExpression(expression)) {
-    return unwrapObject(expression.expression);
-  }
-  return;
-};
-var findDefaultExportObject = (sourceFile) => {
-  for (const statement of sourceFile.statements) {
-    if (ts.isExportAssignment(statement) && !statement.isExportEquals) {
-      return unwrapObject(statement.expression);
-    }
-  }
-  return;
-};
-var probeExtension = (base) => {
-  for (const extension of COMPONENT_EXTS) {
-    const candidate = `${base}.${extension}`;
-    if (existsSync2(candidate)) {
-      return candidate;
-    }
-  }
-  return null;
-};
-var toImport = (specifier, imported, dir) => {
-  const relative = specifier.startsWith(".") || isAbsolute(specifier);
-  let path = specifier;
-  let extension = extname(specifier).slice(1).toLowerCase();
-  if (relative) {
-    const absolute = isAbsolute(specifier) ? specifier : resolve3(dir, specifier);
-    if (extension) {
-      path = absolute;
-    } else {
-      const probed = probeExtension(absolute);
-      path = probed ?? absolute;
-      extension = probed ? extname(probed).slice(1).toLowerCase() : "";
-    }
-  }
-  return {
-    framework: FRAMEWORK_BY_EXT.get(extension) ?? null,
-    name: imported,
-    path
-  };
-};
-var resolveIdentifier = (name, imports, dir) => {
-  const binding = imports.get(name);
-  return binding ? toImport(binding.specifier, binding.imported, dir) : null;
-};
-var applyDescriptorProperty = (descriptor, property, imports, dir) => {
-  if (ts.isShorthandPropertyAssignment(property)) {
-    if (property.name.text === "component") {
-      descriptor.hadComponent = true;
-      descriptor.source = resolveIdentifier(property.name.text, imports, dir);
-    }
-    return;
-  }
-  if (!ts.isPropertyAssignment(property)) {
-    return;
-  }
-  const name = propName(property.name);
-  const init = property.initializer;
-  if (name === "component") {
-    descriptor.hadComponent = true;
-    if (ts.isStringLiteral(init)) {
-      descriptor.source = toImport(init.text, "default", dir);
-    } else if (ts.isIdentifier(init)) {
-      descriptor.source = resolveIdentifier(init.text, imports, dir);
-    }
-  } else if (name === "client" && ts.isStringLiteral(init) && isHydrationMode(init.text)) {
-    descriptor.client = init.text;
-  } else if (name === "media" && ts.isStringLiteral(init)) {
-    descriptor.media = init.text;
-  }
-};
-var readDescriptor = (object, imports, dir) => {
-  const descriptor = { hadComponent: false, source: null };
-  for (const property of object.properties) {
-    applyDescriptorProperty(descriptor, property, imports, dir);
-  }
-  return descriptor;
-};
-var finalize = (key, group, descriptor, label, identifier, warnings) => {
-  const { client, media, source } = descriptor;
-  if (group === "islands") {
-    if (!source) {
-      warnings.push(`Island override "${key}" couldn't be resolved to a file. Reference it by an imported component or a path string with an extension.`);
-      return null;
-    }
-    if (!source.framework) {
-      warnings.push(`Island override "${key}" (${label}) is not a React, Vue, or Svelte component; only framework components can be islands.`);
-      return null;
-    }
-  }
-  if (client === "media" && !media) {
-    warnings.push(`Override "${key}" uses client: "media" but no \`media\` query was given; it will hydrate as if \`client: "load"\`.`);
-  }
-  if (client === "only" && source && !source.framework) {
-    warnings.push(`Override "${key}" uses client: "only" but its framework couldn't be inferred; reference a .tsx/.jsx/.vue/.svelte file.`);
-  }
-  if (!client && source?.framework) {
-    warnings.push(`Override "${key}" points to a ${FRAMEWORK_LABEL[source.framework]} component (${label}) but has no hydration mode, so it renders as static HTML with no interactivity. Add one, e.g. \`${key}: { component: ${JSON.stringify(label)}, client: "load" }\`.`);
-  }
-  const normalized = { identifier, key, source };
-  if (client) {
-    normalized.client = client;
-  }
-  if (media) {
-    normalized.media = media;
-  }
-  return normalized;
-};
-var normalizeEntry = (entry, group, imports, dir, warnings) => {
-  const defaultClient = group === "islands" ? "visible" : undefined;
-  if (ts.isShorthandPropertyAssignment(entry)) {
-    const name = entry.name.text;
-    return finalize(name, group, {
-      client: defaultClient,
-      hadComponent: true,
-      source: resolveIdentifier(name, imports, dir)
-    }, name, true, warnings);
-  }
-  if (!ts.isPropertyAssignment(entry)) {
-    return null;
-  }
-  const key = propName(entry.name);
-  if (!key) {
-    return null;
-  }
-  const value = entry.initializer;
-  if (ts.isIdentifier(value)) {
-    return finalize(key, group, {
-      client: defaultClient,
-      hadComponent: true,
-      source: resolveIdentifier(value.text, imports, dir)
-    }, value.text, true, warnings);
-  }
-  if (ts.isStringLiteral(value)) {
-    return finalize(key, group, {
-      client: defaultClient,
-      hadComponent: true,
-      source: toImport(value.text, "default", dir)
-    }, value.text, false, warnings);
-  }
-  if (ts.isObjectLiteralExpression(value)) {
-    const descriptor = readDescriptor(value, imports, dir);
-    if (!descriptor.hadComponent) {
-      warnings.push(`Override "${key}" is an object without a \`component\` field; expected \`{ component, client }\`.`);
-      return null;
-    }
-    if (!descriptor.source) {
-      warnings.push(`Override "${key}"'s \`component\` couldn't be resolved to a file. Reference an imported component or a path string with an extension.`);
-      return null;
-    }
-    return finalize(key, group, { ...descriptor, client: descriptor.client ?? defaultClient }, key, false, warnings);
-  }
-  return { identifier: false, key, source: null };
-};
-var collectGroupOverrides = (property, imports, dir, result) => {
-  if (!ts.isPropertyAssignment(property)) {
-    return;
-  }
-  const name = propName(property.name);
-  if (!(name && isGroup(name)) || !ts.isObjectLiteralExpression(property.initializer)) {
-    return;
-  }
-  for (const entry of property.initializer.properties) {
-    const normalized = normalizeEntry(entry, name, imports, dir, result.warnings);
-    if (normalized) {
-      result[name].push(normalized);
-    }
-  }
-};
-var analyzeComponentOverrides = (source, filePath) => {
-  const result = emptyAnalysis();
-  const sourceFile = ts.createSourceFile(filePath, source, ts.ScriptTarget.Latest, true, filePath.endsWith("tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
-  const object = findDefaultExportObject(sourceFile);
-  if (!object) {
-    return result;
-  }
-  const imports = collectImports(sourceFile);
-  const dir = dirname3(filePath);
-  for (const property of object.properties) {
-    collectGroupOverrides(property, imports, dir, result);
-  }
-  return result;
-};
-
 // src/core/svg-dimensions.ts
 var ROOT = /<svg\s(?:[^>"']|"[^"]*"|'[^']*')*>/u;
 var WIDTH = /\swidth=(?<quote>['"])(?<value>[^%]+?)\k<quote>/u;
@@ -1276,14 +933,14 @@ var svgDimensions = (svg) => {
 };
 
 // src/core/tsconfig-aliases.ts
-import { existsSync as existsSync3 } from "node:fs";
-import { dirname as dirname4, join as join5, resolve as resolve4 } from "pathe";
-import ts2 from "typescript";
+import { existsSync as existsSync2 } from "node:fs";
+import { dirname as dirname4, join as join5, resolve as resolve3 } from "pathe";
+import ts from "typescript";
 var PARSE_HOST = {
-  fileExists: ts2.sys.fileExists,
+  fileExists: ts.sys.fileExists,
   readDirectory: () => [],
-  readFile: ts2.sys.readFile,
-  useCaseSensitiveFileNames: ts2.sys.useCaseSensitiveFileNames
+  readFile: ts.sys.readFile,
+  useCaseSensitiveFileNames: ts.sys.useCaseSensitiveFileNames
 };
 var isPathTarget = (target) => typeof target === "string";
 var toAlias = (key, value, baseDir) => {
@@ -1296,19 +953,19 @@ var toAlias = (key, value, baseDir) => {
   if (find === "" || find === "*") {
     return null;
   }
-  return { find, replacement: resolve4(baseDir, target) };
+  return { find, replacement: resolve3(baseDir, target) };
 };
 var resolveTsconfigAliases = (root) => {
-  const entry = ["tsconfig.json", "jsconfig.json"].map((name) => join5(root, name)).find((file) => existsSync3(file));
+  const entry = ["tsconfig.json", "jsconfig.json"].map((name) => join5(root, name)).find((file) => existsSync2(file));
   if (!entry) {
     return {};
   }
-  const { config, error } = ts2.readConfigFile(entry, ts2.sys.readFile);
+  const { config, error } = ts.readConfigFile(entry, ts.sys.readFile);
   if (error) {
     return {};
   }
   const configDir = dirname4(entry);
-  const { options } = ts2.parseJsonConfigFileContent(config, PARSE_HOST, configDir, undefined, entry);
+  const { options } = ts.parseJsonConfigFileContent(config, PARSE_HOST, configDir, undefined, entry);
   const { paths } = options;
   if (!paths) {
     return {};
@@ -1459,10 +1116,10 @@ var MERMAID_FENCE = /^[ \t]*(?:`{3,}|~{3,})[ \t]*mermaid\b/mu;
 var hasMermaidFence = (text) => MERMAID_FENCE.test(text);
 
 // src/og/derive.ts
-import { existsSync as existsSync4 } from "node:fs";
-import { isAbsolute as isAbsolute2, join as join6 } from "pathe";
+import { existsSync as existsSync3 } from "node:fs";
+import { isAbsolute, join as join6 } from "pathe";
 var CARD_WEIGHTS = [400, 600];
-var absoluteSrc = (root, src) => isAbsolute2(src) ? src : join6(root, src);
+var absoluteSrc = (root, src) => isAbsolute(src) ? src : join6(root, src);
 var isNumericWeight = (weight) => typeof weight === "number";
 var isRangeWeight = (weight) => typeof weight === "string";
 var isFontName = (value) => typeof value === "string";
@@ -1563,11 +1220,11 @@ var missingFontFiles = (options, root) => {
       sources.push(absoluteSrc(root, font.src));
     }
   }
-  return [...new Set(sources)].filter((path) => !existsSync4(path));
+  return [...new Set(sources)].filter((path) => !existsSync3(path));
 };
 
 // src/og/logo.ts
-import { existsSync as existsSync5, readFileSync } from "node:fs";
+import { existsSync as existsSync4, readFileSync } from "node:fs";
 import { join as join7 } from "pathe";
 var resolveOgLogo = (project, source) => {
   if (!source?.toLowerCase().endsWith(".svg")) {
@@ -1577,13 +1234,13 @@ var resolveOgLogo = (project, source) => {
   const file = [
     join7(project.context.root, "public", relative),
     join7(project.context.root, relative)
-  ].find((path) => existsSync5(path));
+  ].find((path) => existsSync4(path));
   return file ? readFileSync(file, "utf-8") : undefined;
 };
 
 // src/openapi/scalar.ts
 import { readFile as readFile2 } from "node:fs/promises";
-import { isAbsolute as isAbsolute3, join as join8 } from "pathe";
+import { isAbsolute as isAbsolute2, join as join8 } from "pathe";
 
 // src/theme/palette.ts
 var FALLBACK_ACCENT = "oklch(0.62 0.16 250)";
@@ -1679,7 +1336,7 @@ var specConfiguration = async (spec, root) => {
   if (URL_SPEC.test(spec)) {
     return { config: { url: spec } };
   }
-  const absolute = isAbsolute3(spec) ? spec : join8(root, spec);
+  const absolute = isAbsolute2(spec) ? spec : join8(root, spec);
   try {
     return { config: { content: await readFile2(absolute, "utf-8") } };
   } catch {
@@ -1690,7 +1347,7 @@ var specConfiguration = async (spec, root) => {
   }
 };
 var acceptScalarReference = (ref, seen, contentRoutes, warnings) => {
-  if (ref.renderer !== "scalar") {
+  if (ref.kind !== "scalar") {
     return null;
   }
   if (seen.has(ref.route)) {
@@ -1725,12 +1382,13 @@ var buildReferenceFiles = async (options) => {
       warnings.push(spec.warning);
     }
     const pagePath = referencePagePath(ref.route);
+    const { theme, ...passthrough } = ref.scalar ?? {};
     files.push({
       content: scalarReferenceTemplate({
         configuration: {
           ...spec.config,
-          ...themeConfiguration(config, ref.theme),
-          ...ref.scalar
+          ...themeConfiguration(config, theme),
+          ...passthrough
         },
         noindex: ref.noindex,
         route: ref.route,
@@ -1759,6 +1417,7 @@ var CODE_PADDING_BLOCK_REM = 1;
 
 // src/theme/entry.ts
 var CODE_SCROLL_INSET_REM = 0.375;
+var EXTERNAL_LINK_MASK = `url("data:image/svg+xml,${encodeURIComponent('<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#000" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"><path d="M7 7h10v10M7 17L17 7"/></svg>')}")`;
 var DARK_VARIANT = `/* Dark mode is driven by data-theme on the <html> element. */
 @custom-variant dark (&:where([data-theme="dark"], [data-theme="dark"] *));`;
 var COLOR_SCHEME_DEFAULTS = `:root {
@@ -1985,10 +1644,13 @@ ${THEME_MAPPING}
   @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;
+  @apply mb-1 flex items-center gap-1.5 px-2.5 py-1.5 font-medium text-foreground text-sm;
 }
+/* The linked heading fills the heading's own box with negative margins, so
+   its hover/active pill is the page row's exactly (same padding and radius)
+   and an unlinked heading beside it keeps the same text position. */
 @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;
+  @apply -mx-2.5 -my-1.5 flex flex-1 items-center gap-1.5 rounded-[0.65rem] px-2.5 py-1.5 text-foreground transition-colors hover:bg-muted aria-[current=page]:bg-muted;
 }
 
 /* Theme Tailwind Typography (prose) with Blume tokens. */
@@ -2009,6 +1671,11 @@ ${THEME_MAPPING}
   --tw-prose-pre-bg: var(--blume-code-background);
   --tw-prose-th-borders: var(--blume-border);
   --tw-prose-td-borders: var(--blume-border);
+  /* Neutralized: the plugin defaults are near-black text and shadow with no
+     dark counterpart (Blume never applies prose-invert), and the kbd rule
+     below draws the badge with Blume tokens instead. */
+  --tw-prose-kbd: inherit;
+  --tw-prose-kbd-shadows: transparent;
   color: var(--blume-muted-foreground);
   font-size: 0.875rem;
   line-height: 1.7;
@@ -2119,6 +1786,22 @@ ${THEME_MAPPING}
   text-decoration: none;
 }
 
+/* External Markdown links (markdown.externalLinks) open in a new tab and trail
+   the same Lucide arrow-up-right the featured sidebar links use, as a mask so it
+   takes the link's color. A link wrapping only an image (a badge, a logo)
+   skips the arrow. */
+.prose :where(a[data-blume-external]:not(:has(img, svg)))::after {
+  background-color: currentColor;
+  content: "";
+  display: inline-block;
+  height: 0.75em;
+  margin-inline-start: 0.125em;
+  -webkit-mask: ${EXTERNAL_LINK_MASK} center / contain no-repeat;
+  mask: ${EXTERNAL_LINK_MASK} center / contain no-repeat;
+  opacity: 0.6;
+  width: 0.75em;
+}
+
 .prose :where(hr) {
   margin: 2.5rem 0;
 }
@@ -2538,6 +2221,24 @@ pre:has(.line.focused):hover .line:not(.focused) {
   content: none;
 }
 
+/* Keyboard keys (<kbd>) render as the same bordered badge the search dialog
+   uses for its shortcut hints. Typography's own kbd rule is scoped with
+   :not(.not-prose *), so it never reaches a key inside <Steps>, <Callout>,
+   <Card>, or any other not-prose component; this rule is deliberately
+   unscoped from that exclusion so a key looks the same everywhere in the
+   content column. Unlayered, so it outranks the plugin's layered rule. */
+.prose kbd {
+  background: var(--blume-muted);
+  border: 1px solid var(--blume-border);
+  border-radius: 0.25rem;
+  box-shadow: none;
+  color: inherit;
+  font-family: var(--font-mono);
+  font-size: 0.85em;
+  font-weight: 500;
+  padding: 0.125rem 0.25rem;
+}
+
 /* Inline code highlighting: Shiki colors the tokens of a \`code\`{:lang} snippet
    via the same dual-theme CSS variables as fenced blocks, keeping the inline
    pill background. Always on — it only fires on the trailing {:lang} marker. */
@@ -2629,15 +2330,15 @@ ${options.userCss}
 `;
 
 // src/theme/sources.ts
-import { dirname as dirname5, isAbsolute as isAbsolute4, relative as relative2, resolve as resolve5 } from "pathe";
+import { dirname as dirname5, isAbsolute as isAbsolute3, relative as relative2, resolve as resolve4 } from "pathe";
 var SOURCE_DIRECTIVE = /@source(?<not>\s+not)?\s+(?<quote>["'])(?<path>[^"']+)\k<quote>/gu;
 var rebaseSourceDirectives = (css, options) => {
   const base = dirname5(options.from);
   return css.replace(SOURCE_DIRECTIVE, (directive, not, quote, path) => {
-    if (isAbsolute4(path)) {
+    if (isAbsolute3(path)) {
       return directive;
     }
-    const rebased = relative2(options.to, resolve5(base, path));
+    const rebased = relative2(options.to, resolve4(base, path));
     return `@source${not ?? ""} ${quote}${rebased}${quote}`;
   });
 };
@@ -2724,192 +2425,12 @@ var twoslashCss = () => {
 ${OVERRIDES}`;
 };
 
-// src/astro/component-slots.ts
-var EMPTY_MODULE = `// Generated by Blume. Do not edit.
-import type { ComponentOverride } from "blume/core/define-components.ts";
-export const mdxComponents: Record<string, ComponentOverride> = {};
-export const layoutOverrides: Record<string, ComponentOverride> = {};
-`;
-var attributeValue = (value) => value.replaceAll(/["\n\r]/gu, " ").trim();
-var CLIENT_LOAD = "client:load";
-var directiveFor = (override) => {
-  const framework = override.source?.framework;
-  switch (override.client) {
-    case "idle": {
-      return "client:idle";
-    }
-    case "visible": {
-      return "client:visible";
-    }
-    case "media": {
-      return override.media ? `client:media="${attributeValue(override.media)}"` : CLIENT_LOAD;
-    }
-    case "only": {
-      return framework ? `client:only="${attributeValue(framework)}"` : CLIENT_LOAD;
-    }
-    default: {
-      return CLIENT_LOAD;
-    }
-  }
-};
-var importClause = (variable, name, path) => name === "default" ? `import ${variable} from ${JSON.stringify(path)};` : `import { ${name} as ${variable} } from ${JSON.stringify(path)};`;
-var wrapperContent = (override) => {
-  const { name, path } = override.source;
-  const clause = name === "default" ? `import Component from ${JSON.stringify(path)};` : `import { ${name} as Component } from ${JSON.stringify(path)};`;
-  return `---
-// Generated by Blume. Do not edit.
-${clause}
----
-<Component ${directiveFor(override)} {...Astro.props}><slot /></Component>
-`;
-};
-var sanitize = (value) => value.replaceAll(/[^A-Za-z0-9]/gu, (char) => `_${(char.codePointAt(0) ?? 0).toString(16)}_`);
-var planComponentSlots = (componentsFile, analysis) => {
-  const frameworks = new Set;
-  if (!componentsFile) {
-    return { frameworks, module: EMPTY_MODULE, wrappers: [] };
-  }
-  if (!analysis) {
-    return {
-      frameworks,
-      module: `// Generated by Blume. Do not edit.
-import overrides from ${JSON.stringify(componentsFile)};
-export const mdxComponents = overrides.mdx ?? {};
-export const layoutOverrides = overrides.layout ?? {};
-`,
-      wrappers: []
-    };
-  }
-  const wrappers = [];
-  const importLines = [];
-  const mdxEntries = [];
-  const layoutEntries = [];
-  let counter = 0;
-  const mdxOverrides = [...analysis.mdx, ...analysis.islands];
-  const plan = (override, group, entries) => {
-    const { source } = override;
-    if (source?.framework) {
-      frameworks.add(source.framework);
-    }
-    if (override.identifier && !override.client) {
-      return;
-    }
-    if (!source) {
-      return;
-    }
-    const variable = `__blumeSlot${counter}`;
-    counter += 1;
-    if (override.client) {
-      const name = `${group}-${sanitize(override.key)}`;
-      wrappers.push({ content: wrapperContent(override), name });
-      importLines.push(importClause(variable, "default", `./component-slots/${name}.astro`));
-    } else {
-      importLines.push(importClause(variable, source.name, source.path));
-    }
-    entries.push(`${JSON.stringify(override.key)}: ${variable}`);
-  };
-  for (const override of mdxOverrides) {
-    plan(override, "mdx", mdxEntries);
-  }
-  for (const override of analysis.layout) {
-    plan(override, "layout", layoutEntries);
-  }
-  const moduleSource = `// Generated by Blume. Do not edit.
-import overrides from ${JSON.stringify(componentsFile)};
-${importLines.join(`
-`)}${importLines.length ? `
-` : ""}export const mdxComponents = { ...(overrides.mdx ?? {})${mdxEntries.length ? `, ${mdxEntries.join(", ")}` : ""} };
-export const layoutOverrides = { ...(overrides.layout ?? {})${layoutEntries.length ? `, ${layoutEntries.join(", ")}` : ""} };
-`;
-  return { frameworks, module: moduleSource, wrappers };
-};
-
 // src/astro/examples.ts
-import { readFile as readFile4 } from "node:fs/promises";
-import pMap2 from "p-map";
-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 readFile3 } from "node:fs/promises";
 import pMap from "p-map";
-import { basename, join as join9 } from "pathe";
+import { isAbsolute as isAbsolute4, join as join9, relative as relative3 } from "pathe";
 import { glob } from "tinyglobby";
-var DEFAULT_CLIENT = "visible";
-var READ_CONCURRENCY = 16;
-var VALID_MODES = new Set([
-  "idle",
-  "load",
-  "only",
-  "visible"
-]);
-var isClientMode = (mode) => VALID_MODES.has(mode);
-var FRAMEWORK_BY_EXT2 = new Map([
-  ["jsx", "react"],
-  ["svelte", "svelte"],
-  ["tsx", "react"],
-  ["vue", "vue"]
-]);
-var ISLAND_FILE = /\.(?<ext>jsx|svelte|tsx|vue)$/u;
-var CLIENT_EXPORT = /export\s+const\s+client\s*(?::[^=]+)?=\s*["'](?<mode>\w+)["']/u;
-var readClientMode = (source, file, warnings) => {
-  const mode = source.match(CLIENT_EXPORT)?.groups?.mode;
-  if (!mode) {
-    return DEFAULT_CLIENT;
-  }
-  if (!isClientMode(mode)) {
-    warnings.push(`Island "${file}" declares an unknown client mode "${mode}"; defaulting to "${DEFAULT_CLIENT}". Use "load", "idle", "visible", or "only".`);
-    return DEFAULT_CLIENT;
-  }
-  return mode;
-};
-var discoverIslands = async (root) => {
-  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) => readFile3(file, "utf-8"), {
-    concurrency: READ_CONCURRENCY
-  });
-  const islands = [];
-  const warnings = [];
-  const seen = new Map;
-  const collectIsland = (file, source) => {
-    const base = basename(file);
-    const ext = base.match(ISLAND_FILE)?.groups?.ext;
-    const framework = ext ? FRAMEWORK_BY_EXT2.get(ext) : undefined;
-    if (!framework) {
-      return;
-    }
-    const name = base.replace(ISLAND_FILE, "");
-    if (!/^[A-Z][A-Za-z0-9_]*$/u.test(name)) {
-      warnings.push(`Island "${file}" must have a PascalCase identifier filename to be used in MDX (letters, digits, and underscores only, e.g. Counter.tsx → <Counter />); skipping it.`);
-      return;
-    }
-    const existing = seen.get(name);
-    if (existing) {
-      warnings.push(`Two islands both resolve to <${name}> ("${existing}" and "${file}"); ignoring the second. Give them distinct filenames.`);
-      return;
-    }
-    seen.set(name, file);
-    islands.push({
-      client: readClientMode(source, file, warnings),
-      file,
-      framework,
-      name
-    });
-  };
-  for (const [index, file] of files.entries()) {
-    collectIsland(file, sources[index] ?? "");
-  }
-  return { islands, warnings };
-};
-
-// src/astro/examples.ts
-var FRAMEWORK_BY_EXT3 = {
+var FRAMEWORK_BY_EXT = {
   astro: "astro",
   jsx: "react",
   svelte: "svelte",
@@ -2918,11 +2439,11 @@ var FRAMEWORK_BY_EXT3 = {
 };
 var EXAMPLE_FILE = /\.(?<ext>astro|jsx|svelte|tsx|vue)$/u;
 var DEFAULT_EXAMPLE_GLOB = "**/*.{astro,jsx,svelte,tsx,vue}";
-var READ_CONCURRENCY2 = 16;
+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("..") || isAbsolute5(path);
+  const outside = path.startsWith("..") || isAbsolute4(path);
   return outside ? [root, examplesDir] : [root];
 };
 var GLOB_MAGIC = /[!*?[\]{}]/u;
@@ -2936,22 +2457,22 @@ 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 = join10(root, base);
-  const matches = await glob2([rest], {
+  const dir = join9(root, base);
+  const matches = await glob([rest], {
     absolute: true,
     cwd: dir,
     onlyFiles: true
   });
   const files = matches.toSorted();
-  const sources = await pMap2(files, (file) => readFile4(file, "utf-8"), {
-    concurrency: READ_CONCURRENCY2
+  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_EXT3[ext] : undefined;
+    const framework = ext ? FRAMEWORK_BY_EXT[ext] : undefined;
     if (!(ext && framework)) {
       return;
     }
@@ -2981,16 +2502,39 @@ var exampleMarkdownLookup = (examples) => Object.fromEntries(examples.map((examp
   { lang: example.lang, source: example.source }
 ]));
 
-// src/astro/generate.ts
-var BLUME_SRC = join11(packageRoot(), "src");
-var canResolveFrom = (fromDir, spec) => {
-  try {
-    createRequire2(pathToFileURL(join11(fromDir, "_.js")).href).resolve(spec);
-    return true;
-  } catch {
-    return false;
+// src/astro/render-deps.ts
+import { existsSync as existsSync5, realpathSync } from "node:fs";
+import {
+  basename,
+  dirname as dirname6,
+  isAbsolute as isAbsolute5,
+  join as join10,
+  normalize,
+  relative as relative4,
+  resolve as resolve5
+} from "pathe";
+var depsCandidates = (pkgDir) => [
+  join10(pkgDir, "node_modules"),
+  dirname6(pkgDir)
+];
+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 = join10(dir, "node_modules", name);
+    if (existsSync5(join10(candidate, "package.json"))) {
+      return normalize(realpathSync(candidate));
+    }
+    const parent = dirname6(dir);
+    if (parent === dir) {
+      return null;
+    }
+    dir = parent;
   }
 };
+
+// src/astro/generate.ts
+var BLUME_SRC = join11(packageRoot(), "src");
 var resolveReactCompiler = (config, needsReact, pkgDir = packageRoot()) => {
   if (!(needsReact && config.react.compiler)) {
     return null;
@@ -3006,20 +2550,20 @@ var reactCompilerWarnings = (config, needsReact, compilerPath) => needsReact &&
 ] : [];
 var resolveAstroPackageJson = (modulesDir) => {
   try {
-    return realpathSync(join11(modulesDir, "astro", "package.json"));
+    return realpathSync2(join11(modulesDir, "astro", "package.json"));
   } catch {
     return null;
   }
 };
 var resolvedAstroHit = (fromDir) => {
-  let dir = normalize(fromDir);
+  let dir = normalize2(fromDir);
   while (true) {
     const modulesDir = join11(dir, "node_modules");
     const pkg = resolveAstroPackageJson(modulesDir);
     if (pkg) {
       return { modulesDir, pkg };
     }
-    const parent = dirname6(dir);
+    const parent = dirname7(dir);
     if (parent === dir) {
       return null;
     }
@@ -3028,16 +2572,11 @@ var resolvedAstroHit = (fromDir) => {
 };
 var sameRealDir = (a, b) => {
   try {
-    return realpathSync(a) === realpathSync(b);
+    return realpathSync2(a) === realpathSync2(b);
   } catch {
     return false;
   }
 };
-var depsCandidates = (pkgDir) => [
-  join11(pkgDir, "node_modules"),
-  dirname6(pkgDir)
-];
-var candidateHolding = (pkgDir, ...segments) => depsCandidates(pkgDir).find((dir) => existsSync6(join11(dir, ...segments))) ?? null;
 var symlinkDir = async (target, link) => {
   try {
     await symlink(target, link, "dir");
@@ -3057,13 +2596,13 @@ var linkDepsJunction = async (link, depsDir) => {
       return;
     }
     try {
-      if (resolve6(dirname6(link), await readlink(link)) === resolve6(depsDir)) {
+      if (resolve6(dirname7(link), await readlink(link)) === resolve6(depsDir)) {
         return;
       }
     } catch {}
     await rm2(link, { force: true });
   }
-  await mkdir2(dirname6(link), { recursive: true });
+  await mkdir2(dirname7(link), { recursive: true });
   await symlinkDir(depsDir, link);
 };
 var readPkgVersion = (pkgJsonPath) => {
@@ -3125,54 +2664,6 @@ var ensureDepsLink = async (outDir, pkgDir = packageRoot()) => {
   }
   return astroConflictWarning(blumeAstro, outDirHit?.pkg ?? null);
 };
-var ISLAND_FRAMEWORK_DEPS = new Map([
-  ["svelte", "@astrojs/svelte"],
-  ["vue", "@astrojs/vue"]
-]);
-var DEPLOYMENT_ADAPTER_DEPS = new Map([
-  ["cloudflare", "@astrojs/cloudflare"],
-  ["netlify", "@astrojs/netlify"]
-]);
-var islandFrameworkWarnings = (frameworks, root) => {
-  const warnings = [];
-  for (const framework of frameworks) {
-    const dep = ISLAND_FRAMEWORK_DEPS.get(framework);
-    if (dep && !canResolveFrom(root, dep)) {
-      warnings.push(`Islands use ${framework}, which needs "${dep}". Install it (e.g. \`npm install ${dep} ${framework}\`).`);
-    }
-  }
-  return warnings;
-};
-var deploymentAdapterWarnings = (deployment, root, pkgDir = packageRoot()) => {
-  const dep = deployment.output === "server" && deployment.adapter ? DEPLOYMENT_ADAPTER_DEPS.get(deployment.adapter) : undefined;
-  if (dep && !(canResolveFrom(root, dep) || canResolveFrom(pkgDir, dep))) {
-    return [
-      `Deployment adapter "${deployment.adapter}" needs "${dep}", which isn't installed. Run \`npm install ${dep}\` (or your package manager's equivalent).`
-    ];
-  }
-  return [];
-};
-var searchProviderWarnings = (provider, root, pkgDir = packageRoot()) => {
-  const warnings = [];
-  for (const dep of searchProviderMeta(provider).runtimeDeps) {
-    if (!(canResolveFrom(root, dep) || canResolveFrom(pkgDir, dep))) {
-      warnings.push(`Search provider "${provider}" needs "${dep}", which isn't installed. Run \`npm install ${dep}\` (or your package manager's equivalent).`);
-    }
-  }
-  return warnings;
-};
-var askProviderWarnings = (ask, root, pkgDir = packageRoot()) => {
-  if (!ask?.enabled || ask.endpoint) {
-    return [];
-  }
-  const dep = askBackendRuntimeDep(ask);
-  if (!dep || canResolveFrom(root, dep) || canResolveFrom(pkgDir, dep)) {
-    return [];
-  }
-  return [
-    `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 ? join11(root, config.examples.css) : null;
 var writeExamplesPreview = async (options) => {
   const { config, hasExamples, root, srcDir, write } = options;
@@ -3189,7 +2680,7 @@ var readOptional = async (path) => {
     return "";
   }
   try {
-    return await readFile5(path, "utf-8");
+    return await readFile4(path, "utf-8");
   } catch {
     return "";
   }
@@ -3199,7 +2690,7 @@ var readUserCss = async (file, outputDir) => {
   return file ? rebaseSourceDirectives(css, { from: file, to: outputDir }) : css;
 };
 var detectNeedsReact = async (root) => {
-  const matches = await glob3(["**/*.{tsx,jsx}"], {
+  const matches = await glob2(["**/*.{tsx,jsx}"], {
     cwd: root,
     ignore: ["**/node_modules/**", "**/.blume/**", "**/dist/**"],
     onlyFiles: true
@@ -3207,15 +2698,15 @@ var detectNeedsReact = async (root) => {
   return matches.length > 0;
 };
 var containsMath = (content) => content.includes("$$") || content.includes("<Math");
-var READ_CONCURRENCY3 = 16;
+var READ_CONCURRENCY2 = 16;
 var detectUsesMath = async (root, staged = []) => {
-  const files = await glob3(["**/*.{md,mdx}"], {
+  const files = await glob2(["**/*.{md,mdx}"], {
     cwd: root,
     ignore: ["**/node_modules/**", "**/.blume/**", "**/dist/**"],
     onlyFiles: true
   });
-  const contents = await pMap3(files, (file) => readOptional(join11(root, file)), {
-    concurrency: READ_CONCURRENCY3
+  const contents = await pMap2(files, (file) => readOptional(join11(root, file)), {
+    concurrency: READ_CONCURRENCY2
   });
   return [...contents, ...staged].some(containsMath);
 };
@@ -3225,14 +2716,14 @@ var loadIntegrationBridge = async (config, context) => {
     return;
   }
   return {
-    configFile: relative4(context.outDir, context.configFile),
+    configFile: relative5(context.outDir, context.configFile),
     sourceHash: hashConfigSource(await readOptional(context.configFile))
   };
 };
 var writeIfChanged = async (path, content) => {
   let existing = null;
   try {
-    existing = await readFile5(path, "utf-8");
+    existing = await readFile4(path, "utf-8");
   } catch {
     existing = null;
   }
@@ -3243,14 +2734,14 @@ var writeIfChanged = async (path, content) => {
   return true;
 };
 var pruneOrphans = async (srcDir, written) => {
-  const existing = await glob3("**/*", {
+  const existing = await glob2("**/*", {
     absolute: true,
     cwd: srcDir,
     onlyFiles: true
   });
   const removals = [];
   for (const path of existing) {
-    const normalized = normalize(path);
+    const normalized = normalize2(path);
     if (!written.has(normalized)) {
       removals.push(rm2(normalized, { force: true }));
     }
@@ -3262,7 +2753,7 @@ var collectStaged = (project) => {
   for (const page of project.graph.pages) {
     if (page.collection === "staged" && page.entryId && page.body) {
       const text = page.sourcePath ? rewriteRelativeImages({
-        deployBase: project.config.deployment.base,
+        deployBase: project.config.deployment.options.base,
         projectRoot: project.context.root,
         source: page.body.text,
         sourcePath: page.sourcePath
@@ -3277,7 +2768,7 @@ var writeStagedContent = async (out, staged) => {
   const written = new Set;
   await Promise.all([...staged].map(async ([entryId, text]) => {
     const path = join11(contentDir, entryId);
-    written.add(normalize(path));
+    written.add(normalize2(path));
     await writeIfChanged(path, text);
   }));
   if (existsSync6(contentDir)) {
@@ -3434,7 +2925,7 @@ var resolveOgSite = (config) => {
   if (configured !== undefined) {
     return configured;
   }
-  return config.deployment.site ? `${new URL(config.deployment.site).host}${normalizeBasePath(config.deployment.base)}` : undefined;
+  return config.deployment.options.site ? `${new URL(config.deployment.options.site).host}${normalizeBasePath(config.deployment.options.base)}` : undefined;
 };
 var resolveOgDescription = (config) => {
   const configured = config.seo.og.description;
@@ -3460,9 +2951,9 @@ var buildRuntimeData = (project) => {
     if (!(editBase && sourcePath)) {
       return null;
     }
-    const rel = relative4(context.root, sourcePath).split("\\").join("/");
+    const rel = relative5(context.root, sourcePath).split("\\").join("/");
     const editDir = trimChar(github?.dir ?? "", "/");
-    const editPath = normalize(editDir ? join11(editDir, rel) : rel);
+    const editPath = normalize2(editDir ? join11(editDir, rel) : rel);
     if (editPath.startsWith("..") || isAbsolute6(editPath)) {
       return null;
     }
@@ -3498,7 +2989,7 @@ var buildRuntimeData = (project) => {
   ])) : {};
   const data = {
     config: {
-      analytics: config.analytics ?? null,
+      analytics: config.analytics,
       appleIcon: resolveAppleIcon(project),
       ask: config.ai.ask?.enabled ? {
         endpoint: config.ai.ask.endpoint ?? null,
@@ -3506,15 +2997,16 @@ var buildRuntimeData = (project) => {
       } : null,
       banner: resolveBanner(config),
       basePath: config.basePath,
-      codeThemes: config.markdown.codeBlocks.theme,
+      codeThemes: config.markdown.code.theme,
       codeWrap: config.markdown.code.wrap,
       dateFormat: config.dateFormat,
       description: config.description,
       discovery: {
-        agentReadability: config.seo.agentReadability,
-        api: config.ai.api,
-        llmsTxt: config.ai.llmsTxt.enabled,
-        sitemap: config.seo.sitemap && Boolean(config.deployment.site)
+        agentReadability: config.agents.agentReadability,
+        aiCatalog: hasAiCatalog(config),
+        api: config.agents.api,
+        llmsTxt: config.agents.llmsTxt.enabled,
+        sitemap: config.seo.sitemap && Boolean(config.deployment.options.site)
       },
       favicon: resolveFavicon(project),
       feedback: config.feedback,
@@ -3535,9 +3027,9 @@ var buildRuntimeData = (project) => {
       } : null,
       imageZoom: config.markdown.imageZoom,
       logo,
-      mcp: config.ai.mcp.enabled ? {
-        name: config.ai.mcp.name ?? config.title,
-        route: config.ai.mcp.route
+      mcp: config.agents.mcp.enabled ? {
+        name: config.agents.mcp.name ?? config.title,
+        route: config.agents.mcp.route
       } : null,
       og: {
         description: resolveOgDescription(config),
@@ -3549,19 +3041,19 @@ var buildRuntimeData = (project) => {
       openInChat: config.ai.openInChat,
       repoUrl: repoUrl2,
       search: {
-        enabled: config.search.provider !== "none",
+        enabled: config.search.provider.mode !== "none",
         popular: resolveSearchPopular(config.search.popular, config.basePath),
-        provider: config.search.provider
+        provider: config.search.provider.kind
       },
-      site: config.deployment.site ?? null,
+      site: config.deployment.options.site ?? null,
       structuredData: config.seo.structuredData,
       theme: config.theme,
       title: config.title,
       toc: config.toc,
       versions: config.versions ?? null,
       webmcp: {
-        enabled: config.ai.webmcp,
-        llms: config.ai.llmsTxt.enabled
+        enabled: config.agents.webmcp,
+        llms: config.agents.llmsTxt.enabled
       },
       x: config.seo.x
     },
@@ -3592,6 +3084,7 @@ var buildRuntimeData = (project) => {
       indexable: route.indexable,
       lastModified: route.lastModified ?? null,
       locale: route.locale,
+      monolingual: route.monolingual ?? false,
       path: route.path,
       title: route.title,
       version: route.version,
@@ -3605,7 +3098,7 @@ var buildRuntimeData = (project) => {
 };
 var planMcp = (project, srcDir, userPages) => {
   const { config } = project;
-  const { route } = config.ai.mcp;
+  const { route } = config.agents.mcp;
   const dir = join11(srcDir, "blume-mcp");
   const base = {
     dir,
@@ -3615,14 +3108,14 @@ var planMcp = (project, srcDir, userPages) => {
     srcDir,
     warnings: []
   };
-  if (!config.ai.mcp.enabled) {
+  if (!config.agents.mcp.enabled) {
     return base;
   }
   if (routeIsTaken(userPages, project.graph.pages, route)) {
     return {
       ...base,
       warnings: [
-        `MCP server route "${route}" is already used by a content or custom page; the MCP server was not generated. Set a different "ai.mcp.route" in blume.config.ts.`
+        `MCP server route "${route}" is already used by a content or custom page; the MCP server was not generated. Set a different "agents.mcp.route" in blume.config.ts.`
       ]
     };
   }
@@ -3670,10 +3163,10 @@ var ownsApiRest = (page) => page.pattern.startsWith("/api/[");
 var contentUnderApi = (page) => page.route === "/api" || page.route.startsWith("/api/");
 var planApi = (project, srcDir, userPages) => {
   const { config, context } = project;
-  const server = config.deployment.output === "server";
+  const server = config.deployment.options.output === "server";
   return {
     catchAll: server && !userPages.some(ownsApiRest) && !project.graph.pages.some(contentUnderApi),
-    enabled: config.ai.api,
+    enabled: config.agents.api,
     server,
     spec: !routeIsTaken(userPages, project.graph.pages, OPENAPI_PATH) && !existsSync6(join11(context.root, "public", "openapi.json")),
     srcDir
@@ -3699,10 +3192,10 @@ var writeApiFiles = async (project, plan, write, data, mcp) => {
   }
   if (plan.spec) {
     writes.push(write(join11(plan.srcDir, "pages", "openapi.json.ts"), staticJsonEndpointTemplate(buildApiSpec({
-      agentReadability: config.seo.agentReadability,
+      agentReadability: config.agents.agentReadability,
       base: data.base,
       description: config.description,
-      llmsTxt: config.ai.llmsTxt.enabled,
+      llmsTxt: config.agents.llmsTxt.enabled,
       mcpRoute,
       name: config.title,
       search: plan.server,
@@ -3738,13 +3231,13 @@ var specOriginsOf = (spec) => {
 };
 var specOrigins = (data) => [...new Set(Object.values(data).flatMap(specOriginsOf))].toSorted();
 var proxyAllowlistWarnings = (config, data) => {
-  const kinds = builtinProxyKinds(config);
+  const proxied = new Set(builtinProxyReferences(config).map((reference) => reference.slug));
   const warnings = [];
   for (const spec of Object.values(data)) {
-    if (!kinds.includes(spec.kind) || specOriginsOf(spec).length > 0) {
+    if (!proxied.has(spec.slug) || specOriginsOf(spec).length > 0) {
       continue;
     }
-    warnings.push(spec.kind === "graphql" ? `The "${spec.label}" GraphQL reference (${spec.route}) has playground.proxy: true, but no absolute endpoint is configured for it, so the built-in proxy has no origin to allow and will refuse every request its playground sends. Set the graphql block's (or the source's) \`endpoint\` to the live GraphQL URL, or point playground.proxy at an external proxy URL.` : `The "${spec.label}" reference (${spec.route}) has playground.proxy: true, but its spec declares no absolute servers[].url (relative and templated URLs carry no origin), so the built-in proxy has no origin to allow and will refuse every request its playground sends. Add an absolute server URL to the spec, or point playground.proxy at an external proxy URL.`);
+    warnings.push(spec.kind === "graphql" ? `The "${spec.label}" GraphQL reference (${spec.route}) has playground.proxy: true, but no absolute endpoint is configured for it, so the built-in proxy has no origin to allow and will refuse every request its playground sends. Set \`endpoint\` on the graphql() adapter (or the source) to the live GraphQL URL, or point playground.proxy at an external proxy URL.` : `The "${spec.label}" reference (${spec.route}) has playground.proxy: true, but its spec declares no absolute servers[].url (relative and templated URLs carry no origin), so the built-in proxy has no origin to allow and will refuse every request its playground sends. Add an absolute server URL to the spec, or point playground.proxy at an external proxy URL.`);
   }
   return warnings;
 };
@@ -3753,14 +3246,13 @@ var writeAskFiles = async (project, srcDir, write, modules) => {
   if (!(ask?.enabled && !ask.endpoint)) {
     return;
   }
-  const grounded = ask.provider !== "inkeep";
-  if (grounded) {
+  const backend = resolveAskBackend(ask.provider);
+  if (backend.grounded) {
     modules.set("blume:ask-data", JSON.stringify(await buildAskData(project)));
   }
-  await write(join11(srcDir, "pages", "api", "ask.ts"), askEndpointTemplate(resolveAskBackend(ask), grounded, {
+  await write(join11(srcDir, "pages", "api", "ask.ts"), askEndpointTemplate(backend, {
     cors: ask.cors,
     instructions: ask.instructions,
-    reasoning: ask.reasoning,
     retrieval: ask.retrieval
   }));
 };
@@ -3775,14 +3267,18 @@ var writeNotFoundPage = async (write, srcDir, pages, contentPages) => {
   ]);
 };
 var diagnosticWarning = (diagnostic) => diagnostic.suggestion ? `${diagnostic.message} ${diagnostic.suggestion}` : diagnostic.message;
-var buildComponentSlots = async (componentsFile) => {
-  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) : [],
-    warnings: analysis ? analysis.warnings : []
-  };
+var dependencyPreflight = async (project, frameworks) => {
+  const build = project.mode === "build";
+  const diagnostic = await missingDependencyDiagnostic(project.config, project.context.root, build ? "error" : "warning", frameworks);
+  if (!diagnostic) {
+    return [];
+  }
+  if (build) {
+    throw new BlumeError(diagnostic);
+  }
+  return [diagnosticWarning(diagnostic)];
 };
+var analyzeComponentsFile = async (componentsFile) => componentsFile ? analyzeComponentOverrides(await readFile4(componentsFile, "utf-8"), componentsFile) : emptyComponentOverrides();
 var projectOgFonts = (project) => resolveOgFonts({
   ogFonts: project.config.seo.og.fonts,
   themeFonts: project.config.theme.fonts,
@@ -3825,7 +3321,7 @@ var generateRuntime = async (project) => {
   const examplesThemePath = join11(srcDir, "generated", "examples.css");
   const written = new Set;
   const write = (path, content) => {
-    written.add(normalize(path));
+    written.add(normalize2(path));
     return writeIfChanged(path, content);
   };
   const modules = new Map;
@@ -3849,7 +3345,7 @@ var generateRuntime = async (project) => {
     integrationBridge,
     islandDiscovery,
     exampleDiscovery,
-    componentSlots
+    overrideAnalysis
   ] = await Promise.all([
     context.pagesRoot ? discoverPages(context.pagesRoot) : Promise.resolve([]),
     detectNeedsReact(context.root),
@@ -3859,19 +3355,17 @@ var generateRuntime = async (project) => {
     loadIntegrationBridge(config, context),
     discoverIslands(context.root),
     discoverExamples(context.root, config.examples.source),
-    buildComponentSlots(context.componentsFile)
+    analyzeComponentsFile(context.componentsFile)
   ]);
-  const {
-    plan: slotPlan,
-    tags: overrideTags,
-    warnings: overrideWarnings
-  } = componentSlots;
+  const slotPlan = planComponentSlots(islandDiscovery.islands, overrideAnalysis);
+  const overrideWarnings = overrideAnalysis.warnings;
   project.examples = exampleMarkdownLookup(exampleDiscovery.examples);
   const frameworks = new Set([
     ...islandDiscovery.islands.map((island) => island.framework),
     ...exampleDiscovery.examples.map((example) => example.framework),
     ...slotPlan.frameworks
   ]);
+  const dependencyWarnings = await dependencyPreflight(project, frameworks);
   const needsReact = detectedReact || askEnabled || frameworks.has("react");
   const needsVue = frameworks.has("vue");
   const needsSvelte = frameworks.has("svelte");
@@ -3894,7 +3388,7 @@ var generateRuntime = async (project) => {
   const proxyOrigins = specOrigins(openApiData);
   const hasStaged = staged.size > 0;
   const hasFilesystemSource = project.sources.some((source) => !source.staged);
-  const docsCollection = resolveDocsCollection(config, context);
+  const docsCollection = resolveDocsCollection(config, context.root);
   const [structural] = await Promise.all([
     Promise.all([
       write(join11(out, "astro.config.mjs"), astroConfigTemplate({
@@ -3936,7 +3430,6 @@ var generateRuntime = async (project) => {
       writeNavFragments(write, srcDir, navFragments),
       write(askPath, askComponentTemplate(askEnabled)),
       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),
@@ -3954,7 +3447,6 @@ var generateRuntime = async (project) => {
         userTheme
       }))
     ]),
-    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),
@@ -3976,7 +3468,6 @@ var generateRuntime = async (project) => {
     await write(join11(srcDir, "pages", "changelog.astro"), changelogIndexTemplate({
       exportEpub,
       exportPdf,
-      mathEnabled: usesMath,
       needsReact,
       staged: hasStaged
     }));
@@ -3993,13 +3484,14 @@ var generateRuntime = async (project) => {
     write(searchClientPath, searchClientTemplate(config)),
     write(featuresPath, featuresTemplate(clientFeatures))
   ]);
-  if (servesStaticIndex(config.search.provider)) {
+  const searchAdapter = config.search.provider;
+  if (searchAdapter.mode === "static") {
     const documents = await buildSearchDocuments(project);
     modules.set("blume:search-index", JSON.stringify(documents));
     await write(join11(srcDir, "pages", "blume-search.json.ts"), searchEndpointTemplate());
   }
-  if (config.search.provider === "mixedbread") {
-    await write(join11(srcDir, "pages", "api", "search.ts"), mixedbreadSearchEndpointTemplate(config.search.mixedbread?.storeId ?? ""));
+  if (searchAdapter.kind === "mixedbread") {
+    await write(join11(srcDir, "pages", "api", "search.ts"), mixedbreadSearchEndpointTemplate(searchAdapter.options));
   }
   await write(join11(srcDir, "generated", "includes.json"), `${JSON.stringify(buildIncludeGraph(project.graph.pages))}
 `);
@@ -4041,9 +3533,9 @@ var generateRuntime = async (project) => {
   ].map(diagnosticWarning));
   const knownComponentTags = new Set([
     ...islandDiscovery.islands.map((island) => island.name),
-    ...overrideTags
+    ...overrideAnalysis.mdx.map((entry) => entry.key)
   ]);
-  warnings.push(...validateUsedComponents(project.graph.pages, knownComponentTags, new Set(registry.map((item) => item.name))).map(diagnosticWarning), ...searchProviderWarnings(config.search.provider, context.root), ...askProviderWarnings(config.ai.ask, context.root), ...deploymentAdapterWarnings(config.deployment, context.root), ...islandFrameworkWarnings(frameworks, context.root));
+  warnings.push(...validateUsedComponents(project.graph.pages, knownComponentTags, new Set(registry.map((item) => item.name))).map(diagnosticWarning), ...dependencyWarnings);
   if (hasScalarReferences(config)) {
     const references = await buildReferenceFiles({
       config,
@@ -4066,7 +3558,7 @@ var generateRuntime = async (project) => {
   return { structuralChange: structural.some(Boolean), warnings };
 };
 
-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 };
+export { publishBuildProject, refreshBlumeContent, showBlumeErrorOverlay, ogCacheDir, pruneCardCache, cardCacheTally, buildAskData, buildThemeCss, buildReferenceFiles, tailwindEntryTemplate, examplesEntryTemplate, rebaseSourceDirectives, twoslashCss, EXAMPLE_SCAN_GLOB, exampleScanRoots, discoverExamples, exampleMarkdownLookup, packageDirFrom, detectNeedsReact, detectUsesMath, collectStaged, buildRuntimeData, analyzeComponentsFile, languageIconCssFor, clientFeaturesFor, generateRuntime };
 
-//# debugId=851B0C91E17092DD64756E2164756E21
-//# sourceMappingURL=chunk-5n7t497w.js.map
+//# debugId=8216F00B3292FE6F64756E2164756E21
+//# sourceMappingURL=chunk-z1f5arsg.js.map