blume 1.6.6 → 1.7.0

package/dist/cli/{chunk-ag1zyr5x.js → chunk-9qs6acpw.js}

@@ -7,37 +7,37 @@ import {
 } from "./chunk-bcy492zc.js";
 import {
   prepareProject
-} from "./chunk-nyqzjdhj.js";
-import"./chunk-9sh49q0h.js";
+} from "./chunk-0qhq7b8q.js";
+import"./chunk-n0nyat6g.js";
 import"./chunk-btfr9yvw.js";
 import {
   DevLockHeldError,
   acquireDevLock,
   describeDevLock,
   updateDevLockPort
-} from "./chunk-tc89yh2r.js";
+} from "./chunk-ye9zdkgv.js";
 import {
   generateRuntime,
   refreshBlumeContent,
   showBlumeErrorOverlay
-} from "./chunk-62qsssnh.js";
-import"./chunk-n4qjabmt.js";
+} from "./chunk-5d4q7121.js";
+import"./chunk-ynacq3ev.js";
 import"./chunk-pxj10x8y.js";
 import"./chunk-sbdqrjbb.js";
-import"./chunk-5yvt556e.js";
+import"./chunk-v5mm027v.js";
 import"./chunk-ev67ycx0.js";
 import"./chunk-vt8fgygt.js";
 import"./chunk-3r94j3tc.js";
-import"./chunk-aerwpe14.js";
-import"./chunk-3k0kzs6d.js";
+import"./chunk-agy5rzxy.js";
+import"./chunk-j6pxe0dt.js";
 import"./chunk-vxv4x1n8.js";
 import"./chunk-wd27zjcz.js";
 import {
   scanProject
-} from "./chunk-etsqspj6.js";
+} from "./chunk-s102bysw.js";
 import {
   resolveRuntimeDir
-} from "./chunk-vv3f8mb6.js";
+} from "./chunk-xv91q4nm.js";
 import"./chunk-27gtm2ym.js";
 import"./chunk-4xyggvgf.js";
 import"./chunk-6kzzpsx8.js";
@@ -173,4 +173,4 @@ export {
 };
 
 //# debugId=EE16C622AD2E2BB164756E2164756E21
-//# sourceMappingURL=chunk-ag1zyr5x.js.map
+//# sourceMappingURL=chunk-9qs6acpw.js.map

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

@@ -3,19 +3,19 @@ import {
   API_CATALOG_PATH,
   OPENAPI_PATH,
   hasApiCatalog
-} from "./chunk-3k0kzs6d.js";
+} from "./chunk-j6pxe0dt.js";
 import {
   searchProviderMeta
 } from "./chunk-wd27zjcz.js";
 import {
   BLUME_IGNORE_DIRS,
   TOC_HIDDEN_KEY
-} from "./chunk-etsqspj6.js";
+} from "./chunk-s102bysw.js";
 import {
   buildFontEntries,
   fontLocaleCodes,
   hasScalarReferences
-} from "./chunk-vv3f8mb6.js";
+} from "./chunk-xv91q4nm.js";
 import {
   normalizeBasePath,
   trimChar,
@@ -279,6 +279,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 +375,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 +416,8 @@ var astroConfigTemplate = (options) => {
     contentRoutes,
     examplesPath,
     examplesThemePath,
+    features = ALL_CLIENT_FEATURES,
+    featuresPath,
     generatedModulesDir,
     needsSvelte,
     needsVue,
@@ -431,6 +435,7 @@ var astroConfigTemplate = (options) => {
   const { optimizeDepsEntries, optimizeDepsInclude } = resolveOptimizeDeps({
     aliases: options.aliases,
     context,
+    features,
     needsReact,
     reactCompilerPath: options.reactCompilerPath
   });
@@ -484,7 +489,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 +541,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 +585,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 +641,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}
       },
@@ -888,6 +901,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 +1143,58 @@ 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 { 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).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(
+  (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 +1211,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 +1272,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,
@@ -1625,7 +1707,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 ? locale : "default"}\`)}` : ""}
   openInChat={data.config.openInChat}
   feeds={data.feeds}
   discovery={data.config.discovery}
@@ -2364,7 +2447,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=539E38867287181364756E2164756E21
+//# sourceMappingURL=chunk-agy5rzxy.js.map