blume 1.7.1 → 1.7.3

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

@@ -1,131 +1,127 @@
 #!/usr/bin/env node
 import {
-  buildMcpData,
-  buildRawMarkdown,
-  buildRssFeeds,
-  buildSearchDocuments,
-  markdownRoutePaths,
-  renderRssFeed
-} from "./chunk-ka5k7cz9.js";
+  packageRoot,
+  getBlumeVersion,
+  BlumeError,
+  enrichDiagnostic
+} from "./index.js";
 import {
-  MCP_TOOLS
-} from "./chunk-pxj10x8y.js";
+  resolveReferences,
+  referenceRoutes,
+  hasScalarReferences,
+  builtinProxyKinds,
+  needsPlaygroundProxy,
+  GOOGLE_FONTS,
+  isFontSlug,
+  fontLocaleCodes,
+  buildFontsCss,
+  configuredFonts,
+  repoUrl,
+  editBaseUrl,
+  apiUrl,
+  EN_UI,
+  resolveUIStrings
+} from "./chunk-7s8hm3b6.js";
 import {
-  customOgRoutes,
-  discoverPages,
-  hasGeneratedChangelog,
-  routeIsTaken
-} from "./chunk-sbdqrjbb.js";
+  resolveFallbackLocale,
+  validateSearchPopularIcons,
+  validateNavTargets,
+  buildIncludeGraph,
+  apiNamePhrase,
+  isOpenApiSource,
+  resolveDocsCollection
+} from "./chunk-1jefwnfs.js";
 import {
-  collectContentAssets,
-  rewriteRelativeImages
-} from "./chunk-kmx2mydj.js";
+  siteRoot,
+  absoluteUrl
+} from "./chunk-ct47dqpx.js";
 import {
-  writeTextAtomic
-} from "./chunk-ev67ycx0.js";
+  buildRssFeeds,
+  renderRssFeed,
+  buildRawMarkdown,
+  markdownRoutePaths,
+  buildSearchDocuments,
+  buildMcpData
+} from "./chunk-js7saxwm.js";
 import {
-  registry
-} from "./chunk-3r94j3tc.js";
+  OPENAPI_PATH,
+  API_PAGES_PATH,
+  API_PAGE_PATH,
+  API_NAVIGATION_PATH,
+  API_SEARCH_PATH,
+  buildMcpDiscovery,
+  buildMcpServerCard,
+  hasAiCatalog
+} from "./chunk-0qymqwzz.js";
 import {
-  apiNavigationTemplate,
-  apiNotFoundTemplate,
-  apiPageTemplate,
-  apiPagesIndexTemplate,
-  apiSearchTemplate,
+  rewriteRelativeImages,
+  collectContentAssets
+} from "./chunk-bf6bt1xt.js";
+import {
+  resolveAskBackend,
   askBackendRuntimeDep,
-  askComponentTemplate,
-  askEndpointTemplate,
-  astroConfigTemplate,
   buildHomeLinkHeader,
-  catchAllPageTemplate,
-  changelogIndexTemplate,
-  contentAssetsEndpointTemplate,
+  publishRuntimeModules,
+  runtimeDependencies,
+  astroConfigTemplate,
+  stagedContentDir,
   contentConfigTemplate,
-  exampleMapTemplate,
-  exampleSlug,
-  exampleWrapperTemplate,
-  examplesPageTemplate,
+  askEndpointTemplate,
+  askComponentTemplate,
+  searchEndpointTemplate,
   featuresTemplate,
-  islandMapTemplate,
-  islandWrapperTemplate,
-  mcpEndpointTemplate,
-  mcpPageFile,
+  searchClientTemplate,
   mixedbreadSearchEndpointTemplate,
-  navFragmentTemplate,
-  notFoundJsonTemplate,
-  notFoundMarkdownTemplate,
-  notFoundPageTemplate,
-  ogEndpointTemplate,
-  playgroundProxyTemplate,
-  publishRuntimeModules,
   rawMarkdownEndpointTemplate,
-  resolveAskBackend,
+  contentAssetsEndpointTemplate,
+  mcpPageFile,
+  mcpEndpointTemplate,
+  playgroundProxyTemplate,
+  staticJsonEndpointTemplate,
   rssEndpointTemplate,
-  runtimeDependencies,
-  runtimePackageTemplate,
-  runtimeTsconfigTemplate,
+  navFragmentTemplate,
+  ogEndpointTemplate,
   scalarReferenceTemplate,
-  searchClientTemplate,
-  searchEndpointTemplate,
-  stagedContentDir,
-  staticJsonEndpointTemplate
-} from "./chunk-4ae4f395.js";
+  catchAllPageTemplate,
+  changelogIndexTemplate,
+  notFoundPageTemplate,
+  notFoundMarkdownTemplate,
+  notFoundJsonTemplate,
+  apiPagesIndexTemplate,
+  apiPageTemplate,
+  apiNavigationTemplate,
+  apiSearchTemplate,
+  apiNotFoundTemplate,
+  islandWrapperTemplate,
+  islandMapTemplate,
+  exampleSlug,
+  exampleWrapperTemplate,
+  exampleMapTemplate,
+  examplesPageTemplate,
+  runtimePackageTemplate,
+  runtimeTsconfigTemplate
+} from "./chunk-ps4m1xh4.js";
 import {
-  API_NAVIGATION_PATH,
-  API_PAGES_PATH,
-  API_PAGE_PATH,
-  API_SEARCH_PATH,
-  OPENAPI_PATH
-} from "./chunk-qvvpnwaz.js";
+  discoverPages,
+  routeIsTaken,
+  hasGeneratedChangelog,
+  customOgRoutes
+} from "./chunk-vrfp10qk.js";
 import {
-  absoluteUrl,
-  siteRoot
-} from "./chunk-vxv4x1n8.js";
+  writeTextAtomic
+} from "./chunk-jq5n4avg.js";
+import {
+  registry
+} from "./chunk-nn13znc2.js";
 import {
   searchProviderMeta,
   servesStaticIndex
-} from "./chunk-wd27zjcz.js";
-import {
-  apiNamePhrase,
-  buildIncludeGraph,
-  isOpenApiSource,
-  resolveDocsCollection,
-  resolveFallbackLocale,
-  validateNavTargets,
-  validateSearchPopularIcons
-} from "./chunk-12dzsn9b.js";
-import {
-  EN_UI,
-  GOOGLE_FONTS,
-  apiUrl,
-  buildFontsCss,
-  builtinProxyKinds,
-  configuredFonts,
-  editBaseUrl,
-  fontLocaleCodes,
-  hasScalarReferences,
-  isFontSlug,
-  needsPlaygroundProxy,
-  referenceRoutes,
-  repoUrl,
-  resolveReferences,
-  resolveUIStrings
-} from "./chunk-r99hynxh.js";
+} from "./chunk-q4rae3bg.js";
 import {
-  normalizeBasePath,
   trimChar,
+  normalizeBasePath,
   withBasePath
-} from "./chunk-27gtm2ym.js";
-import {
-  getBlumeVersion
-} from "./chunk-4xyggvgf.js";
-import {
-  packageRoot
-} from "./chunk-6kzzpsx8.js";
-import {
-  BlumeError,
-  enrichDiagnostic
-} from "./chunk-ey89bjj1.js";
+} from "./chunk-2mzebbbz.js";
 
 // src/ai/web-bot-auth.ts
 var SIGNATURES_DIRECTORY_PATH = "/.well-known/http-message-signatures-directory";
@@ -135,10 +131,10 @@ var SIGNATURES_DIRECTORY_TYPE = "application/http-message-signatures-directory+j
 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 { dirname, join } from "pathe";
 
 // src/deploy/sitemap.ts
 import { escape as escapeXml } from "html-escaper";
@@ -223,7 +219,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 = () => {
@@ -267,7 +263,7 @@ import { pathToFileURL } from "node:url";
 import pMap3 from "p-map";
 import {
   basename as basename2,
-  dirname as dirname6,
+  dirname as dirname7,
   isAbsolute as isAbsolute6,
   join as join11,
   normalize,
@@ -809,68 +805,6 @@ var buildAskData = async (project) => {
   };
 };
 
-// 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) => [
@@ -953,7 +887,7 @@ var validateUsedComponents = (pages, extraTags, registryNames) => {
 
 // src/core/component-overrides.ts
 import { existsSync as existsSync2 } from "node:fs";
-import { dirname as dirname3, extname, isAbsolute, resolve as resolve3 } from "pathe";
+import { dirname as dirname4, extname, isAbsolute, resolve as resolve3 } from "pathe";
 import ts from "typescript";
 var GROUPS = ["mdx", "layout", "islands"];
 var GROUP_SET = new Set(GROUPS);
@@ -1054,10 +988,10 @@ var probeExtension = (base) => {
   return null;
 };
 var toImport = (specifier, imported, dir) => {
-  const relative2 = specifier.startsWith(".") || isAbsolute(specifier);
+  const relative = specifier.startsWith(".") || isAbsolute(specifier);
   let path = specifier;
   let extension = extname(specifier).slice(1).toLowerCase();
-  if (relative2) {
+  if (relative) {
     const absolute = isAbsolute(specifier) ? specifier : resolve3(dir, specifier);
     if (extension) {
       path = absolute;
@@ -1209,7 +1143,7 @@ var analyzeComponentOverrides = (source, filePath) => {
     return result;
   }
   const imports = collectImports(sourceFile);
-  const dir = dirname3(filePath);
+  const dir = dirname4(filePath);
   for (const property of object.properties) {
     collectGroupOverrides(property, imports, dir, result);
   }
@@ -1281,7 +1215,7 @@ 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 { dirname as dirname5, join as join5, resolve as resolve4 } from "pathe";
 import ts2 from "typescript";
 var PARSE_HOST = {
   fileExists: ts2.sys.fileExists,
@@ -1311,7 +1245,7 @@ var resolveTsconfigAliases = (root) => {
   if (error) {
     return {};
   }
-  const configDir = dirname4(entry);
+  const configDir = dirname5(entry);
   const { options } = ts2.parseJsonConfigFileContent(config, PARSE_HOST, configDir, undefined, entry);
   const { paths } = options;
   if (!paths) {
@@ -1577,10 +1511,10 @@ var resolveOgLogo = (project, source) => {
   if (!source?.toLowerCase().endsWith(".svg")) {
     return;
   }
-  const relative2 = source.replace(/^\//u, "");
+  const relative = source.replace(/^\//u, "");
   const file = [
-    join7(project.context.root, "public", relative2),
-    join7(project.context.root, relative2)
+    join7(project.context.root, "public", relative),
+    join7(project.context.root, relative)
   ].find((path) => existsSync5(path));
   return file ? readFileSync(file, "utf-8") : undefined;
 };
@@ -1693,52 +1627,52 @@ var specConfiguration = async (spec, root) => {
     };
   }
 };
-var acceptScalarReference = (ref2, seen, contentRoutes, warnings) => {
-  if (ref2.renderer !== "scalar") {
+var acceptScalarReference = (ref, seen, contentRoutes, warnings) => {
+  if (ref.renderer !== "scalar") {
     return null;
   }
-  if (seen.has(ref2.route)) {
-    warnings.push(`Two API reference sources resolve to ${ref2.route}; keeping the first.`);
+  if (seen.has(ref.route)) {
+    warnings.push(`Two API reference sources resolve to ${ref.route}; keeping the first.`);
     return null;
   }
-  if (contentRoutes.has(ref2.route)) {
-    warnings.push(`API reference route ${ref2.route} collides with a content page; skipping the reference there.`);
+  if (contentRoutes.has(ref.route)) {
+    warnings.push(`API reference route ${ref.route} collides with a content page; skipping the reference there.`);
     return null;
   }
-  seen.add(ref2.route);
-  return ref2;
+  seen.add(ref.route);
+  return ref;
 };
 var buildReferenceFiles = async (options) => {
   const { config, root, contentRoutes } = options;
   const warnings = [];
   const seen = new Set;
   const accepted = [];
-  for (const ref2 of resolveReferences(config)) {
-    const next = acceptScalarReference(ref2, seen, contentRoutes, warnings);
+  for (const ref of resolveReferences(config)) {
+    const next = acceptScalarReference(ref, seen, contentRoutes, warnings);
     if (next) {
       accepted.push(next);
     }
   }
-  const built = await Promise.all(accepted.map(async (ref2) => ({
-    ref: ref2,
-    spec: await specConfiguration(ref2.spec, root)
+  const built = await Promise.all(accepted.map(async (ref) => ({
+    ref,
+    spec: await specConfiguration(ref.spec, root)
   })));
   const files = [];
-  for (const { ref: ref2, spec } of built) {
+  for (const { ref, spec } of built) {
     if (spec.warning) {
       warnings.push(spec.warning);
     }
-    const pagePath = referencePagePath(ref2.route);
+    const pagePath = referencePagePath(ref.route);
     files.push({
       content: scalarReferenceTemplate({
         configuration: {
           ...spec.config,
-          ...themeConfiguration(config, ref2.theme),
-          ...ref2.scalar
+          ...themeConfiguration(config, ref.theme),
+          ...ref.scalar
         },
-        noindex: ref2.noindex,
-        route: ref2.route,
-        title: ref2.label
+        noindex: ref.noindex,
+        route: ref.route,
+        title: ref.label
       }),
       pagePath
     });
@@ -2013,6 +1947,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;
@@ -2542,6 +2481,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. */
@@ -2633,10 +2590,10 @@ ${options.userCss}
 `;
 
 // src/theme/sources.ts
-import { dirname as dirname5, isAbsolute as isAbsolute4, relative as relative2, resolve as resolve5 } from "pathe";
+import { dirname as dirname6, 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 = dirname5(options.from);
+  const base = dirname6(options.from);
   return css.replace(SOURCE_DIRECTIVE, (directive, not, quote, path) => {
     if (isAbsolute4(path)) {
       return directive;
@@ -3023,7 +2980,7 @@ var resolvedAstroHit = (fromDir) => {
     if (pkg) {
       return { modulesDir, pkg };
     }
-    const parent = dirname6(dir);
+    const parent = dirname7(dir);
     if (parent === dir) {
       return null;
     }
@@ -3039,7 +2996,7 @@ var sameRealDir = (a, b) => {
 };
 var depsCandidates = (pkgDir) => [
   join11(pkgDir, "node_modules"),
-  dirname6(pkgDir)
+  dirname7(pkgDir)
 ];
 var candidateHolding = (pkgDir, ...segments) => depsCandidates(pkgDir).find((dir) => existsSync6(join11(dir, ...segments))) ?? null;
 var symlinkDir = async (target, link) => {
@@ -3061,13 +3018,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) => {
@@ -3516,6 +3473,7 @@ var buildRuntimeData = (project) => {
       description: config.description,
       discovery: {
         agentReadability: config.seo.agentReadability,
+        aiCatalog: hasAiCatalog(config),
         api: config.ai.api,
         llmsTxt: config.ai.llmsTxt.enabled,
         sitemap: config.seo.sitemap && Boolean(config.deployment.site)
@@ -3762,7 +3720,9 @@ var writeAskFiles = async (project, srcDir, write, modules) => {
     modules.set("blume:ask-data", JSON.stringify(await buildAskData(project)));
   }
   await write(join11(srcDir, "pages", "api", "ask.ts"), askEndpointTemplate(resolveAskBackend(ask), grounded, {
+    cors: ask.cors,
     instructions: ask.instructions,
+    reasoning: ask.reasoning,
     retrieval: ask.retrieval
   }));
 };
@@ -4068,7 +4028,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 { SIGNATURES_DIRECTORY_PATH, SIGNATURES_DIRECTORY_TYPE, publishBuildProject, refreshBlumeContent, showBlumeErrorOverlay, ogCacheDir, pruneCardCache, cardCacheTally, buildAskData, buildThemeCss, buildReferenceFiles, tailwindEntryTemplate, examplesEntryTemplate, rebaseSourceDirectives, twoslashCss, planComponentSlots, discoverIslands, EXAMPLE_SCAN_GLOB, exampleScanRoots, discoverExamples, exampleMarkdownLookup, detectNeedsReact, detectUsesMath, collectStaged, buildRuntimeData, languageIconCssFor, clientFeaturesFor, generateRuntime };
 
-//# debugId=29D4FE8449AF429964756E2164756E21
-//# sourceMappingURL=chunk-x1wvw7a8.js.map
+//# debugId=54E9E2185852692F64756E2164756E21
+//# sourceMappingURL=chunk-k79xp7av.js.map