blume 1.6.6 → 1.7.1

package/dist/cli/{chunk-aerwpe14.js → chunk-4ae4f395.js}

@@ -3,19 +3,19 @@ import {
   API_CATALOG_PATH,
   OPENAPI_PATH,
   hasApiCatalog
-} from "./chunk-3k0kzs6d.js";
+} from "./chunk-qvvpnwaz.js";
 import {
   searchProviderMeta
 } from "./chunk-wd27zjcz.js";
 import {
   BLUME_IGNORE_DIRS,
   TOC_HIDDEN_KEY
-} from "./chunk-etsqspj6.js";
+} from "./chunk-12dzsn9b.js";
 import {
   buildFontEntries,
   fontLocaleCodes,
   hasScalarReferences
-} from "./chunk-vv3f8mb6.js";
+} from "./chunk-r99hynxh.js";
 import {
   normalizeBasePath,
   trimChar,
@@ -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
@@ -279,6 +282,7 @@ var resolveCloudflareAdapterArgs = (context) => {
 };
 var resolveSessionOption = (deployment) => deployment.output === "server" && deployment.adapter === "cloudflare" ? `
   session: false,` : "";
+var astroFontWeights = (weights) => JSON.stringify(weights).replaceAll(/(?<min>\d+)\.\.(?<max>\d+)/gu, "$<min> $<max>");
 var astroConfigImportLine = (options) => {
   const names = ["defineConfig"];
   if (options.hasFonts) {
@@ -374,16 +378,17 @@ const blumeConfig = await loadBlumeConfig(resolve(dirname(fileURLToPath(import.m
 };
 var renderImageOption = (config) => config.image.domains.length > 0 || config.image.remotePatterns.length > 0 ? `
   image: ${JSON.stringify(config.image)},` : "";
+var ALL_CLIENT_FEATURES = { epub: true, mermaid: true };
 var resolveOptimizeDeps = (options) => {
-  const { context } = options;
+  const { context, features } = options;
   const optimizeDepsEntries = [
     ...context.pagesRoot ? [`${context.pagesRoot}/**/*.astro`] : [],
     `${context.root}/islands/**/*.{jsx,svelte,tsx,vue}`,
     ...[...new Set(Object.values(options.aliases ?? {}))].toSorted().map((dir) => `${dir}/**/*.{astro,jsx,svelte,tsx,vue}`)
   ];
   const optimizeDepsInclude = [
-    "blume > mermaid",
-    "blume > epub-gen-memory/bundle",
+    ...features.mermaid ? ["blume > mermaid"] : [],
+    ...features.epub ? ["blume > epub-gen-memory/bundle"] : [],
     ...options.needsReact && options.reactCompilerPath ? ["react/compiler-runtime"] : []
   ];
   return { optimizeDepsEntries, optimizeDepsInclude };
@@ -414,6 +419,8 @@ var astroConfigTemplate = (options) => {
     contentRoutes,
     examplesPath,
     examplesThemePath,
+    features = ALL_CLIENT_FEATURES,
+    featuresPath,
     generatedModulesDir,
     needsSvelte,
     needsVue,
@@ -431,6 +438,7 @@ var astroConfigTemplate = (options) => {
   const { optimizeDepsEntries, optimizeDepsInclude } = resolveOptimizeDeps({
     aliases: options.aliases,
     context,
+    features,
     needsReact,
     reactCompilerPath: options.reactCompilerPath
   });
@@ -484,7 +492,7 @@ var astroConfigTemplate = (options) => {
         isAbsolute(variant.src) ? variant.src : join2(context.root, variant.src)
       ]
     };
-  }))} } }` : `{ provider: fontProviders.${font.provider}(), name: ${JSON.stringify(font.name)}, cssVariable: ${JSON.stringify(font.cssVariable)}, weights: ${JSON.stringify(font.weights)}, subsets: ${JSON.stringify(font.subsets)}, fallbacks: ${JSON.stringify(font.fallbacks)} }`).join(", ")}],` : "";
+  }))} } }` : `{ provider: fontProviders.${font.provider}(), name: ${JSON.stringify(font.name)}, cssVariable: ${JSON.stringify(font.cssVariable)}, weights: ${astroFontWeights(font.weights)}, subsets: ${JSON.stringify(font.subsets)}, fallbacks: ${JSON.stringify(font.fallbacks)} }`).join(", ")}],` : "";
   const defineConfigImport = astroConfigImportLine({
     hasFonts: fontEntries.length > 0
   });
@@ -536,7 +544,8 @@ var astroConfigTemplate = (options) => {
     userIntegrationSpread
   } = renderIntegrationBridge(options.integrationBridge);
   return `// Generated by Blume. Do not edit; this file is recreated on each run.
-${configSourceMarker}${userConfigImports}${defineConfigImport}
+${configSourceMarker}${userConfigImports}import { availableParallelism } from "node:os";
+${defineConfigImport}
 import mdx from "@astrojs/mdx";
 import tailwindcss from "@tailwindcss/vite";
 import { blumeMarkdownProcessor, blumeMdxProcessor, blumeShikiTransformers, blumeTwoslashTransformer } from "blume/markdown";
@@ -579,6 +588,12 @@ ${userConfigSetup}export default defineConfig({
   // request latency behind the user's intent, so most navigations swap
   // instantly.
   prefetch: { prefetchAll: true },
+  // Prerender several pages at once. Rendering is single-threaded, but a
+  // page's OG card renders on a native thread and its HTML is written
+  // asynchronously, so the main thread would otherwise idle behind each
+  // page's off-thread work. Capped at 8: the gain flattens there and beyond it
+  // the overlap only adds memory.
+  build: { concurrency: Math.min(8, availableParallelism()) },
   vite: {${viteCacheOption}
     plugins: [${runtimeModulesPluginEntry}tailwindcss(), includeHmrPlugin(${JSON.stringify(`${context.outDir}/src/generated/includes.json`)}), prerenderDepsPlugin()],
     // Everything hydration can reach must be part of the dev dep optimizer's
@@ -629,6 +644,7 @@ ${userConfigSetup}export default defineConfig({
         "blume:ask": ${JSON.stringify(askPath)},
         "blume:examples": ${JSON.stringify(examplesPath)},
         "blume:examples-theme": ${JSON.stringify(examplesThemePath)},
+        "blume:features": ${JSON.stringify(featuresPath)},
         "blume:search-client": ${JSON.stringify(searchClientPath)},
         "blume:theme": ${JSON.stringify(themePath)},${runtimeModuleAliasLines}${userAliasLines}
       },
@@ -711,15 +727,21 @@ ${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)})`;
   } else if (backend.kind === "openai-compatible") {
@@ -727,7 +749,7 @@ const openrouter = createOpenRouter({ apiKey: getSecret(${JSON.stringify(backend
     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)},
 });
 `;
@@ -888,6 +910,20 @@ var hostedSearchOptions = (search) => {
     }
   }
 };
+var featuresTemplate = (features) => `// Generated by Blume. Do not edit.
+//
+// The client features this site uses. A feature no page needs stays out of
+// the module graph entirely: its loader is null and its library never enters
+// the client bundle.
+
+/** Registers the <blume-mermaid> element; null when no page has a mermaid fence. */
+export const loadMermaid: (() => Promise<unknown>) | null = ${features.mermaid ? '() => import("blume/components/content/mermaid-element.ts")' : "null"};
+
+/** The EPUB generator's browser bundle; null when export.epub is off. */
+export const loadEpub:
+  | (() => Promise<typeof import("epub-gen-memory/bundle")>)
+  | null = ${features.epub ? '() => import("epub-gen-memory/bundle")' : "null"};
+`;
 var searchClientTemplate = (config) => {
   const { search } = config;
   if (search.provider === "orama" || search.provider === "flexsearch") {
@@ -1116,9 +1152,63 @@ export function GET({ props }: { props: { section: string } }) {
   });
 }
 `;
+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 {
+  hiddenDefaultLocale,
+  navGroupIds,
+  navVariants,
+} from "blume/components/layout/nav-utils.ts";
+import type { NavNode } from "blume/core/types.ts";
+import data from "blume:data";
+
+export const prerender = true;
+// A partial: no doctype, head, or script/style injection — the rows only.
+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, 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, hiddenDefaultLocale(data.config.i18n)).find(
+  (entry) => entry.version === version && entry.locale === locale
+);
+const ids = variant
+  ? navGroupIds(variant.navigation.sidebar)
+  : new Map<NavNode, string>();
+const node = [...ids].find(([, groupId]) => groupId === id)?.[0];
+if (!(variant && node && node.kind === "group")) {
+  return new Response(null, { status: 404 });
+}
+const strings =
+  locale === "default" ? data.ui.nav : (data.uiByLocale[locale] ?? data.ui).nav;
+const fragmentBase = withBase(\`/blume-nav/\${version}/\${locale}\`);
+---
+
+<NavTree
+  currentRoute=""
+  depth={1}
+  fragmentBase={fragmentBase}
+  idPrefix={id}
+  ids={ids}
+  items={node.children}
+  root={false}
+  strings={strings}
+/>
+`;
 var ogEndpointTemplate = (customRoutes = [], og = {}, includeChangelog = false) => `// Generated by Blume. Do not edit.
-import { renderOgImage } from "blume/og";
-import type { OgFont, OgFontFamilies } from "blume/og";
+import { cachedOgImage } from "blume/og";
+import type { OgCache, OgFont, OgFontFamilies } from "blume/og";
 import data from "blume:data";
 
 export const prerender = true;
@@ -1135,6 +1225,12 @@ const customRoutes: { slug: string; title: string }[] = ${JSON.stringify(customR
 const fonts: OgFont[] = ${JSON.stringify(og.fonts ?? [])};
 const families: OgFontFamilies | undefined = ${og.families ? JSON.stringify(og.families) : "undefined"};
 
+// Rendered cards are kept on disk between builds, keyed by everything that
+// decides their pixels, so a rebuild renders only the cards whose title,
+// description, branding, or fonts changed. The directory is a build-machine
+// path, baked in for the same reason as the local font paths above.
+const cache: OgCache | undefined = ${og.cache ? JSON.stringify(og.cache) : "undefined"};
+
 // A page's own description (its \`seo.description\`, else \`description\`) is
 // the card subtitle, so the image says what the page's og:description says.
 // Pages without one fall back to the site-wide subtitle at render time.
@@ -1190,7 +1286,7 @@ const repoSlug = data.config.github
   : undefined;
 
 export async function GET({ props }: { props: CardProps }) {
-  const png = await renderOgImage({
+  const png = await cachedOgImage(cache, {
     accent: data.config.og.palette?.accent ?? data.config.theme.accent.light,
     brand: data.config.title,
     description: props.description ?? data.config.og.description,
@@ -1252,22 +1348,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";
@@ -1307,19 +1394,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,
@@ -1356,7 +1432,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) => ({
@@ -1625,7 +1728,8 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   editUrl={editUrl}
   feedback={data.config.feedback}
   exportPdf={${options.exportPdf}}
-  exportEpub={${options.exportEpub}}
+  exportEpub={${options.exportEpub}}${options.navFragments ? `
+  navFragmentBase={withBase(\`/blume-nav/\${version || "current"}/\${i18n && localePrefix(locale) ? locale : "default"}\`)}` : ""}
   openInChat={data.config.openInChat}
   feeds={data.feeds}
   discovery={data.config.discovery}
@@ -1649,6 +1753,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";
@@ -1657,11 +1762,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;
@@ -1860,7 +1973,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) => (
@@ -1871,7 +1984,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>
@@ -1891,7 +2004,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>
@@ -2364,7 +2477,7 @@ var runtimeTsconfigTemplate = () => `${JSON.stringify({
 }, null, 2)}
 `;
 
-export { ADAPTER_IGNORE_DIRS, servesClientSubdir, deployStaticDir, surfaceAdapterOutput, resolveAskBackend, askBackendRuntimeDep, buildHomeLinkHeader, platformRedirects, publishRuntimeModules, runtimeDependencies, astroConfigTemplate, stagedContentDir, contentConfigTemplate, askEndpointTemplate, askComponentTemplate, searchEndpointTemplate, searchClientTemplate, mixedbreadSearchEndpointTemplate, rawMarkdownEndpointTemplate, contentAssetsEndpointTemplate, mcpPageFile, mcpEndpointTemplate, playgroundProxyTemplate, staticJsonEndpointTemplate, rssEndpointTemplate, ogEndpointTemplate, scalarReferenceTemplate, catchAllPageTemplate, changelogIndexTemplate, notFoundPageTemplate, notFoundMarkdownTemplate, notFoundJsonTemplate, apiPagesIndexTemplate, apiPageTemplate, apiNavigationTemplate, apiSearchTemplate, apiNotFoundTemplate, islandWrapperTemplate, islandMapTemplate, exampleSlug, exampleWrapperTemplate, examplesRouteBase, exampleMapTemplate, examplesPageTemplate, runtimePackageTemplate, runtimeTsconfigTemplate };
+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=1666B85D4E0F438E64756E2164756E21
-//# sourceMappingURL=chunk-aerwpe14.js.map
+//# debugId=5A77D8072A1C21F564756E2164756E21
+//# sourceMappingURL=chunk-4ae4f395.js.map