blume 1.7.0 → 1.7.2

package/dist/cli/{chunk-agy5rzxy.js → chunk-ejjx8znq.js}

@@ -1,27 +1,27 @@
 #!/usr/bin/env node
 import {
-  API_CATALOG_PATH,
   OPENAPI_PATH,
+  API_CATALOG_PATH,
   hasApiCatalog
-} from "./chunk-j6pxe0dt.js";
+} from "./chunk-tqa1s0k8.js";
+import {
+  hasScalarReferences,
+  fontLocaleCodes,
+  buildFontEntries
+} from "./chunk-61j18dwk.js";
 import {
   searchProviderMeta
-} from "./chunk-wd27zjcz.js";
+} from "./chunk-q4rae3bg.js";
 import {
-  BLUME_IGNORE_DIRS,
-  TOC_HIDDEN_KEY
-} from "./chunk-s102bysw.js";
+  TOC_HIDDEN_KEY,
+  BLUME_IGNORE_DIRS
+} from "./chunk-hdm2dkd2.js";
 import {
-  buildFontEntries,
-  fontLocaleCodes,
-  hasScalarReferences
-} from "./chunk-xv91q4nm.js";
-import {
-  normalizeBasePath,
   trimChar,
+  normalizeBasePath,
   withBasePath,
   withComposedBasePath
-} from "./chunk-27gtm2ym.js";
+} from "./chunk-2mzebbbz.js";
 
 // src/deploy/adapter-output.ts
 import { existsSync } from "node:fs";
@@ -134,20 +134,23 @@ var ASK_PRESETS = {
   }
 };
 var DEFAULT_MODEL = "openai/gpt-5.5";
+var askHeadersField = (ask) => ask?.headers && Object.keys(ask.headers).length > 0 ? { headers: ask.headers } : {};
 var resolveAskBackend = (ask) => {
   const provider = ask?.provider ?? "gateway";
   const model = ask?.model ?? DEFAULT_MODEL;
+  const headers = askHeadersField(ask);
   if (provider === "gateway") {
-    return { kind: "gateway", model };
+    return { ...headers, kind: "gateway", model };
   }
   const preset = ASK_PRESETS[provider];
   const apiKeyEnv = ask?.apiKeyEnv ?? preset?.apiKeyEnv ?? "API_KEY";
   if (provider === "openrouter") {
-    return { apiKeyEnv, kind: "openrouter", model };
+    return { apiKeyEnv, ...headers, kind: "openrouter", model };
   }
   return {
     apiKeyEnv,
     baseUrl: ask?.baseUrl ?? preset?.baseUrl ?? "",
+    ...headers,
     kind: OPENAI_COMPATIBLE,
     model,
     name: preset?.name ?? OPENAI_COMPATIBLE
@@ -712,8 +715,21 @@ export const collections = { docs${options.staged ? ", staged" : ""} };
 `;
 };
 var ASK_FALLBACK_PROMPT = "You are a helpful documentation assistant. Answer using the project's documentation.";
+var askCorsTemplate = (cors = []) => cors.length > 0 ? {
+  close: "});",
+  imports: [
+    'import { preflightResponse, withCors } from "blume/ai/cors.ts";'
+  ],
+  open: "withCors(ALLOWED_ORIGINS, async ({ request }) => {",
+  setup: `
+const ALLOWED_ORIGINS = ${JSON.stringify(cors)};
+
+export const OPTIONS: APIRoute = ({ request }) =>
+  preflightResponse(request, ALLOWED_ORIGINS);
+`
+} : { close: "};", imports: [], open: "async ({ request }) => {", setup: "" };
 var askEndpointTemplate = (backend, grounded, options) => {
-  const instructions = options?.instructions;
+  const { instructions, reasoning, retrieval } = options ?? {};
   const fallbackPrompt = instructions ? `${ASK_FALLBACK_PROMPT}
 
 ${instructions}` : ASK_FALLBACK_PROMPT;
@@ -724,23 +740,30 @@ ${instructions}` : ASK_FALLBACK_PROMPT;
   ];
   let setup = "";
   let modelExpr = JSON.stringify(backend.model);
+  const headersField = backend.headers ? `
+  headers: ${JSON.stringify(backend.headers)},` : "";
   if (backend.kind === "gateway") {
     setup = `
-const gateway = createGateway({ apiKey: getSecret("AI_GATEWAY_API_KEY") });
+const gateway = createGateway({
+  apiKey: getSecret("AI_GATEWAY_API_KEY"),${headersField}
+});
 `;
     modelExpr = `gateway(${JSON.stringify(backend.model)})`;
   } else if (backend.kind === "openrouter") {
     imports.push('import { createOpenRouter } from "@openrouter/ai-sdk-provider";');
     setup = `
-const openrouter = createOpenRouter({ apiKey: getSecret(${JSON.stringify(backend.apiKeyEnv)}) });
+const openrouter = createOpenRouter({
+  apiKey: getSecret(${JSON.stringify(backend.apiKeyEnv)}),${headersField}
+});
 `;
-    modelExpr = `openrouter(${JSON.stringify(backend.model)})`;
+    const settings = reasoning ? `, { reasoning: { effort: ${JSON.stringify(reasoning)} } }` : "";
+    modelExpr = `openrouter(${JSON.stringify(backend.model)}${settings})`;
   } else if (backend.kind === "openai-compatible") {
     imports.push('import { createOpenAICompatible } from "@ai-sdk/openai-compatible";');
     setup = `
 const provider = createOpenAICompatible({
   apiKey: getSecret(${JSON.stringify(backend.apiKeyEnv)}),
-  baseURL: ${JSON.stringify(backend.baseUrl)},
+  baseURL: ${JSON.stringify(backend.baseUrl)},${headersField}
   name: ${JSON.stringify(backend.name)},
 });
 `;
@@ -752,14 +775,16 @@ const provider = createOpenAICompatible({
     if (instructions) {
       groundFields.push(`instructions: ${JSON.stringify(instructions)}`);
     }
-    if (options?.retrieval) {
-      groundFields.push(`retrieval: ${JSON.stringify(options.retrieval)}`);
+    if (retrieval) {
+      groundFields.push(`retrieval: ${JSON.stringify(retrieval)}`);
     }
     const groundOptions = groundFields.length > 0 ? `, { ${groundFields.join(", ")} }` : "";
     setup += `
 const ground = createAskContext(askData${groundOptions});
 `;
   }
+  const cors = askCorsTemplate(options?.cors);
+  imports.push(...cors.imports);
   const validate = `  const body = await request.json().catch(() => null);
   const raw = body?.messages;
   const valid =
@@ -800,22 +825,25 @@ const ground = createAskContext(askData${groundOptions});
   const onError = `      onError({ error }) {
         console.error("Ask AI provider error:", error);
       },`;
+  const streamFields = [
+    `model: ${modelExpr}`,
+    grounded ? "instructions" : `instructions:
+        ${JSON.stringify(fallbackPrompt)}`,
+    "messages"
+  ];
+  if (reasoning && backend.kind !== "openrouter") {
+    streamFields.push(`reasoning: ${JSON.stringify(reasoning)}`);
+  }
+  const call = `    const result = streamText({
+      ${streamFields.join(`,
+      `)},
+${onError}
+    });`;
   const stream = grounded ? `    const instructions =
       (await ground(messages, body.page)) ??
       ${JSON.stringify(fallbackPrompt)};
-    const result = streamText({
-      model: ${modelExpr},
-      instructions,
-      messages,
-${onError}
-    });` : `    const result = streamText({
-      model: ${modelExpr},
-      instructions:
-        ${JSON.stringify(fallbackPrompt)},
-      messages,
-${onError}
-    });`;
-  const handler = `export const POST: APIRoute = async ({ request }) => {
+${call}` : call;
+  const handler = `export const POST: APIRoute = ${cors.open}
 ${validate}
 ${keyCheck}
   try {
@@ -824,13 +852,13 @@ ${stream}
   } catch {
     return new Response("Failed to generate a response.", { status: 500 });
   }
-};`;
+${cors.close}`;
   return `// Generated by Blume. Do not edit.
 ${imports.join(`
 `)}
 
 export const prerender = false;
-${setup}
+${setup}${cors.setup}
 ${handler}
 `;
 };
@@ -1147,7 +1175,11 @@ var navFragmentTemplate = () => `---
 // Generated by Blume. Do not edit.
 import NavTree from "blume/components/layout/NavTree.astro";
 import { withBase } from "blume/components/islands/base-path.ts";
-import { navGroupIds, navVariants } from "blume/components/layout/nav-utils.ts";
+import {
+  hiddenDefaultLocale,
+  navGroupIds,
+  navVariants,
+} from "blume/components/layout/nav-utils.ts";
 import type { NavNode } from "blume/core/types.ts";
 import data from "blume:data";
 
@@ -1158,15 +1190,16 @@ export const partial = true;
 // Only imports are in scope here (Astro hoists getStaticPaths), which is why
 // the variant walk lives in nav-utils.
 export function getStaticPaths() {
-  return navVariants(data).flatMap(({ locale, navigation, version }) =>
-    [...navGroupIds(navigation.sidebar)]
-      .filter(([node]) => (node.display ?? "flat") !== "flat")
-      .map(([, id]) => ({ params: { id, locale, version } }))
+  return navVariants(data, hiddenDefaultLocale(data.config.i18n)).flatMap(
+    ({ locale, navigation, version }) =>
+      [...navGroupIds(navigation.sidebar)]
+        .filter(([node]) => (node.display ?? "flat") !== "flat")
+        .map(([, id]) => ({ params: { id, locale, version } }))
   );
 }
 
 const { id, locale, version } = Astro.params;
-const variant = navVariants(data).find(
+const variant = navVariants(data, hiddenDefaultLocale(data.config.i18n)).find(
   (entry) => entry.version === version && entry.locale === locale
 );
 const ids = variant
@@ -1334,22 +1367,13 @@ const htmlLang = i18n ? i18n.defaultLocale : "en";
   <ScalarComponent configuration={configuration} renderMode="client" />
 </ReferenceLayout>
 `;
-var catchAllPageTemplate = (options) => {
-  const mathImport = options.mathEnabled ? `import Math from "blume/components/content/Math.astro";
+var contentComponentsSource = (mathEnabled) => {
+  const mathImport = mathEnabled ? `import Math from "blume/components/content/Math.astro";
 ` : "";
-  const mathEntry = options.mathEnabled ? `Math,
+  const mathEntry = mathEnabled ? `Math,
   ` : "";
-  const clientData = options.needsReact ? `
-  clientData={{ config: data.config, navigation, page: { route, title: seo.title ?? title } }}` : "";
-  return `---
-// Generated by Blume. Do not edit.
-import { getEntry, render } from "astro:content";
-import type { CollectionKey } from "astro:content";
-import RootLayout from "blume/components/layout/RootLayout.astro";
-import { withBase } from "blume/components/islands/base-path.ts";
-import { stripBasePath, withBasePath } from "blume/core/base-path.ts";
-import { resolveSlot } from "blume/components/layout/overrides.ts";
-import Accordion from "blume/components/content/Accordion.astro";
+  return {
+    imports: `import Accordion from "blume/components/content/Accordion.astro";
 import AccordionItem from "blume/components/content/AccordionItem.astro";
 import AutoTypeTable from "blume/components/content/AutoTypeTable.astro";
 import Badge from "blume/components/content/Badge.astro";
@@ -1389,19 +1413,8 @@ import ApiOverview from "blume/components/openapi/ApiOverview.astro";
 import ApiTagOperations from "blume/components/openapi/ApiTagOperations.astro";
 import Operation from "blume/components/openapi/Operation.astro";
 ${mathImport}import { mdxComponents as userMdx, layoutOverrides } from "../generated/components.ts";
-import { islandComponents } from "../generated/islands.ts";
-import data from "blume:data";
-
-const Color = Object.assign(ColorRoot, { Item: ColorItem, Row: ColorRow });
-const Tree = Object.assign(TreeRoot, { File: TreeFile, Folder: TreeFolder });
-
-// Docs content is file-based and always prerendered, even in server output
-// (where only endpoints like /api/ask render on demand). Without this, server
-// builds would render this route on demand and ignore getStaticPaths, leaving
-// the entry id undefined.
-export const prerender = true;
-
-const components = {
+import { islandComponents } from "../generated/islands.ts";`,
+    map: `{
   Accordion,
   AccordionItem,
   ApiOverview,
@@ -1438,7 +1451,34 @@ const components = {
   YouTube,
   ${mathEntry}...islandComponents,
   ...userMdx,
+}`
+  };
 };
+var catchAllPageTemplate = (options) => {
+  const { imports: componentImports, map: componentMap } = contentComponentsSource(options.mathEnabled);
+  const clientData = options.needsReact ? `
+  clientData={{ config: data.config, navigation, page: { route, title: seo.title ?? title } }}` : "";
+  return `---
+// Generated by Blume. Do not edit.
+import { getEntry, render } from "astro:content";
+import type { CollectionKey } from "astro:content";
+import RootLayout from "blume/components/layout/RootLayout.astro";
+import { withBase } from "blume/components/islands/base-path.ts";
+import { stripBasePath, withBasePath } from "blume/core/base-path.ts";
+import { resolveSlot } from "blume/components/layout/overrides.ts";
+${componentImports}
+import data from "blume:data";
+
+const Color = Object.assign(ColorRoot, { Item: ColorItem, Row: ColorRow });
+const Tree = Object.assign(TreeRoot, { File: TreeFile, Folder: TreeFolder });
+
+// Docs content is file-based and always prerendered, even in server output
+// (where only endpoints like /api/ask render on demand). Without this, server
+// builds would render this route on demand and ignore getStaticPaths, leaving
+// the entry id undefined.
+export const prerender = true;
+
+const components = ${componentMap};
 
 export function getStaticPaths() {
   return data.routes.map((route) => ({
@@ -1708,7 +1748,7 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   feedback={data.config.feedback}
   exportPdf={${options.exportPdf}}
   exportEpub={${options.exportEpub}}${options.navFragments ? `
-  navFragmentBase={withBase(\`/blume-nav/\${version || "current"}/\${i18n ? locale : "default"}\`)}` : ""}
+  navFragmentBase={withBase(\`/blume-nav/\${version || "current"}/\${i18n && localePrefix(locale) ? locale : "default"}\`)}` : ""}
   openInChat={data.config.openInChat}
   feeds={data.feeds}
   discovery={data.config.discovery}
@@ -1732,6 +1772,7 @@ var changelogIndexTemplate = (options) => {
   clientData={{ config: data.config, navigation: data.navigation, page: { route: "/changelog", title: pageTitle } }}` : "";
   const stagedSpread = options.staged ? `
   ...(await getCollection("staged")),` : "";
+  const { imports: componentImports, map: componentMap } = contentComponentsSource(options.mathEnabled);
   return `---
 // Generated by Blume. Do not edit.
 import { getCollection, render } from "astro:content";
@@ -1740,11 +1781,19 @@ import Update from "blume/components/content/Update.astro";
 import { withBase } from "blume/components/islands/base-path.ts";
 import { resolveSlot } from "blume/components/layout/overrides.ts";
 import { resolveDateFormatOptions } from "blume/core/date-format.ts";
-import { layoutOverrides } from "../generated/components.ts";
+${componentImports}
 import data from "blume:data";
 
+const Color = Object.assign(ColorRoot, { Item: ColorItem, Row: ColorRow });
+const Tree = Object.assign(TreeRoot, { File: TreeFile, Folder: TreeFolder });
+
 export const prerender = true;
 
+// Entry bodies are MDX rendered outside the catch-all, so they need the same
+// component map: a \`:::\` callout or \`<Steps>\` in a release note otherwise
+// throws "Expected component ... to be defined" at build time.
+const components = ${componentMap};
+
 const entryDate = (entry: {
   data: { date?: string | null; changelog?: { date?: string | null } | null };
 }) => entry.data.date ?? entry.data.changelog?.date ?? null;
@@ -1943,7 +1992,7 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
       >
         {majorGroups[0].items.map(({ Content, href, id, label, date, tags }) => (
           <Update description={date} href={href} id={id} label={label} tags={tags}>
-            <Content />
+            <Content components={components} />
           </Update>
         ))}
         {majorGroups.slice(1).map((group) => (
@@ -1954,7 +2003,7 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
           >
             {group.items.map(({ Content, href, id, label, date, tags }) => (
               <Update description={date} href={href} id={id} label={label} tags={tags}>
-                <Content />
+                <Content components={components} />
               </Update>
             ))}
           </section>
@@ -1974,7 +2023,7 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
       <div class="not-prose mt-8">
         {items.map(({ Content, href, id, label, date, tags }) => (
           <Update description={date} href={href} id={id} label={label} tags={tags}>
-            <Content />
+            <Content components={components} />
           </Update>
         ))}
       </div>
@@ -2449,5 +2498,5 @@ var runtimeTsconfigTemplate = () => `${JSON.stringify({
 
 export { ADAPTER_IGNORE_DIRS, servesClientSubdir, deployStaticDir, surfaceAdapterOutput, resolveAskBackend, askBackendRuntimeDep, buildHomeLinkHeader, platformRedirects, publishRuntimeModules, runtimeDependencies, astroConfigTemplate, stagedContentDir, contentConfigTemplate, askEndpointTemplate, askComponentTemplate, searchEndpointTemplate, featuresTemplate, searchClientTemplate, mixedbreadSearchEndpointTemplate, rawMarkdownEndpointTemplate, contentAssetsEndpointTemplate, mcpPageFile, mcpEndpointTemplate, playgroundProxyTemplate, staticJsonEndpointTemplate, rssEndpointTemplate, navFragmentTemplate, ogEndpointTemplate, scalarReferenceTemplate, catchAllPageTemplate, changelogIndexTemplate, notFoundPageTemplate, notFoundMarkdownTemplate, notFoundJsonTemplate, apiPagesIndexTemplate, apiPageTemplate, apiNavigationTemplate, apiSearchTemplate, apiNotFoundTemplate, islandWrapperTemplate, islandMapTemplate, exampleSlug, exampleWrapperTemplate, examplesRouteBase, exampleMapTemplate, examplesPageTemplate, runtimePackageTemplate, runtimeTsconfigTemplate };
 
-//# debugId=539E38867287181364756E2164756E21
-//# sourceMappingURL=chunk-agy5rzxy.js.map
+//# debugId=53365D3EDA449FFB64756E2164756E21
+//# sourceMappingURL=chunk-ejjx8znq.js.map