blume 1.6.6 → 1.7.1

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # blume
 
+## 1.7.1
+
+### Patch Changes
+
+- f52d4b7: Add `ai.ask.headers` to send static request headers to the Ask AI provider on every backend (gateway, OpenRouter, and the OpenAI-compatible providers), so a shared LLM backend can identify the caller without an external endpoint or an eject.
+- b9645bf: Render callouts, steps, and every other Blume component inside changelog entries on the `/changelog` index. The index rendered each entry's MDX body without the component map the docs pages use, so a `:::info` directive or `<Steps>` in a release note failed the build (and the dev route) with "Expected component `Callout` to be defined".
+- c25c859: Prevent the page behind the search dialog from scrolling while Command K search is open, and restore any existing page scroll lock when search closes.
+- 39f683c: Fix the grouped sidebar 404ing its deferred section fragments in `blume dev` on sites whose default locale is unprefixed (`i18n.hideDefaultLocalePrefix`, the default). Astro's i18n routing rejects any page URL that carries the default locale's code as a segment, so `/blume-nav/current/de/…` never resolved for a site with `defaultLocale: "de"`; those fragments now live under `default`, the same way the locale's pages drop the prefix.
+- 2575166: Import video blocks from Notion pages. A video block previously rendered as an `unsupported Notion block` comment, so neither uploaded videos nor pasted YouTube links appeared in the output. A YouTube link now becomes a `<YouTube>` embed, and any other video becomes a `<video>` player whose source is downloaded at build time — Notion's uploaded-file URLs are signed and expire, so they would otherwise rot the build. Downloads stream to disk through a shared concurrency gate with a timeout, a file already on disk is reused instead of fetched again, an extension-less asset is named by the response's media type, and a video link that answers with a web page (a Vimeo or Loom URL) is reported as a warning rather than written out as a broken player. String props the adapter writes (captions, toggle titles) use JSX expression form, so a double quote in a Notion caption no longer breaks the page.
+
+## 1.7.0
+
+### Minor Changes
+
+- 78aadc8: Bundle Mermaid and the EPUB generator only for sites that use them. Both were dynamic imports, so they never loaded on a page that didn't need them, but they were still built on every `blume build` — over 3 MB of client chunks (ELK, Cytoscape, KaTeX, every diagram type) that most sites never serve, and most of the client build's memory. The generated runtime now decides at generation time whether any page has a mermaid fence and whether `export.epub` is on, and leaves the libraries out of the module graph otherwise; the dev server also stops pre-bundling them for sites that don't need them.
+- 51eb2ac: Leave collapsed sidebar sections out of the page. In `group` and `page` display modes, a section that isn't open on the current page no longer ships its rows in that page's HTML; the empty disclosure or panel fetches a prerendered fragment on first open (prefetched on hover or focus, and kept for the visit), so a large site's pages carry only the open section instead of every section on every page. Group ids are now stable across tab-scoped views of the sidebar.
+
+### Patch Changes
+
+- ede3c94: Cache rendered OG cards between builds. Each card is stored under `node_modules/.cache/blume/og`, keyed by everything that decides its pixels (title, description, branding, palette, fonts, and the Blume version), so a rebuild renders only the cards whose inputs changed and reads the rest back from disk. The build log reports how many cards were reused, and cards no page asks for any more are pruned after each build.
+- a43c1d9: Paint code-block language icons from the theme instead of inlining an SVG in every block. A block now carries `data-icon="<slug>"` and the theme masks the brand path onto it, with one rule per language the site's Markdown uses, so a page with twenty TypeScript blocks no longer repeats the same 1 kB logo twenty times. Set icons rendered by the Icon component are deduplicated the same way, through a per-page sprite.
+- 7b7d585: Prerender pages concurrently. The build now renders up to eight pages at once (one per available CPU below that), so the main thread renders the next page while a page's OG card renders on a native thread and its HTML is written to disk, instead of idling behind each page's off-thread work. A 1,400-page site's route generation phase runs in roughly half the time.
+- 903eec0: Render the sidebar's group rows (collapsible summaries, flat headings, drill-in buttons, and the links inside them) through theme utility classes, as page rows already are, so a sidebar with many groups adds a few dozen bytes per group to every page instead of several hundred.
+- 7b7d585: Shrink the sidebar's per-page cost. Every page's HTML carries the whole sidebar, so on a large site the sidebar was most of every page: each row now renders as a single theme utility class (`blume-nav-link`) instead of a dozen Tailwind classes, a bare row drops its inner spans, and groups that don't contain the current page are rendered once per build and reused across pages. A 1,400-page site's pages go from about 570 kB to under 190 kB each, and the build's HTML output shrinks and renders accordingly.
+- 4005c27: Load the curated Google fonts that ship as variable fonts (every preset except IBM Plex Mono, IBM Plex Serif, and Space Mono) as one weight range, so each page declares one `@font-face` per style instead of one per weight — the same font files, a quarter of the inline font CSS. A configured `"100..900"` range now reaches Astro in the form it understands; it previously loaded nothing for that weight.
+- 071e35d: Fix `blume dev` and `blume build` failing on Windows with `Cannot find module '@astrojs/mdx'` under Bun's isolated linker. The hidden runtime's `node_modules` link is now a directory symlink (falling back to a junction where symlinks need elevated privileges), because Windows can't follow the relative symlinks Bun writes into Blume's dependency directory when they're reached through a junction.
+
 ## 1.6.6
 
 ### Patch Changes

package/dist/cli/{chunk-etsqspj6.js → chunk-12dzsn9b.js}

@@ -10,7 +10,7 @@ import {
   pageMetaSchema,
   resolveProjectContext,
   slugify
-} from "./chunk-vv3f8mb6.js";
+} from "./chunk-r99hynxh.js";
 import {
   isInternalPath,
   stripBasePath,
@@ -3803,21 +3803,81 @@ import { setTimeout as sleep2 } from "node:timers/promises";
 import pLimit from "p-limit";
 import { join as join6 } from "pathe";
 
+// src/components/content/youtube.ts
+var BARE_ID = /^[\w-]{11}$/u;
+var URL_ID = /(?:youtu\.be\/|\/embed\/|\/shorts\/|\/live\/|[?&]v=)(?<id>[\w-]{11})/u;
+var parseYouTubeId = (input) => {
+  const value = input.trim();
+  if (!value) {
+    return null;
+  }
+  if (BARE_ID.test(value)) {
+    return value;
+  }
+  return URL_ID.exec(value)?.groups?.id ?? null;
+};
+
 // src/core/sources/assets.ts
-import { mkdir as mkdir3, writeFile as writeFile3 } from "node:fs/promises";
+import { randomUUID } from "node:crypto";
+import {
+  access,
+  mkdir as mkdir3,
+  readdir,
+  rename,
+  rm,
+  writeFile as writeFile3
+} from "node:fs/promises";
 import { extname as extname5, join as join5 } from "pathe";
 var MD_IMAGE2 = /!\[(?<alt>[^\]]*)\]\((?<url>[^)\s]+)\)/gu;
+var HTML_VIDEO_SRC = /(?<open><video\b[^>]*?\ssrc=")(?<url>[^"]+)(?<close>")/gu;
 var REMOTE = /^https?:\/\//u;
 var SAFE_EXT = /^\.[a-z0-9]+$/iu;
 var CODE_FENCE_BLOCK = /^(?<fence>`{3,}|~{3,})[^\n]*\n[\s\S]*?^\k<fence>[^\n]*(?=\n|$)/gmu;
 var FENCE_TOKEN = /\u0000blume-fence-(?<index>\d+)\u0000/gu;
-var extFor = (url) => {
+var EXT_BY_MIME = new Map([
+  ["image/avif", ".avif"],
+  ["image/gif", ".gif"],
+  ["image/jpeg", ".jpg"],
+  ["image/png", ".png"],
+  ["image/svg+xml", ".svg"],
+  ["image/webp", ".webp"],
+  ["video/mp4", ".mp4"],
+  ["video/ogg", ".ogv"],
+  ["video/quicktime", ".mov"],
+  ["video/webm", ".webm"]
+]);
+var UNKNOWN_EXT = ".bin";
+var NON_MEDIA_TYPE = /^(?:text\/|application\/(?:[\w.-]+\+)?(?:json|xml|javascript))/u;
+var PART_SUFFIX = ".part";
+var DEFAULT_TIMEOUT_MS = 120000;
+var extFromUrl = (url) => {
   const clean = url.split("?")[0] ?? url;
   const ext = extname5(clean);
-  return SAFE_EXT.test(ext) ? ext.toLowerCase() : ".png";
+  return SAFE_EXT.test(ext) ? ext.toLowerCase() : null;
+};
+var mediaType = (res) => res.headers.get("content-type")?.split(";")[0]?.trim().toLowerCase() ?? "";
+var exists = async (path) => {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+};
+var completedFor = async (dir, stem) => {
+  let names;
+  try {
+    names = await readdir(dir);
+  } catch {
+    return null;
+  }
+  const candidates = names.filter((name) => name.startsWith(`${stem}.`) && !name.endsWith(PART_SUFFIX));
+  return candidates.length === 1 ? candidates[0] ?? null : null;
 };
 var materializeAssets = async (markdown, ctx) => {
   const doFetch = ctx.fetchImpl ?? globalThis.fetch;
+  const limit = ctx.limit ?? ((task) => task());
+  const timeoutMs = ctx.timeoutMs ?? DEFAULT_TIMEOUT_MS;
   const diagnostics = [];
   const fences = [];
   const masked = markdown.replace(CODE_FENCE_BLOCK, (block) => {
@@ -3825,23 +3885,52 @@ var materializeAssets = async (markdown, ctx) => {
     return `\x00blume-fence-${fences.length - 1}\x00`;
   });
   const urls = new Set;
-  for (const match of masked.matchAll(MD_IMAGE2)) {
-    const url = match.groups?.url;
-    if (url && REMOTE.test(url)) {
-      urls.add(url);
+  for (const pattern of [MD_IMAGE2, HTML_VIDEO_SRC]) {
+    for (const match of masked.matchAll(pattern)) {
+      const url = match.groups?.url;
+      if (url && REMOTE.test(url)) {
+        urls.add(url);
+      }
     }
   }
+  const download = async (url) => {
+    const stem = hashText(url.split("?")[0] ?? url);
+    const urlExt = extFromUrl(url);
+    if (urlExt && await exists(join5(ctx.assetsDir, `${stem}${urlExt}`))) {
+      return `${stem}${urlExt}`;
+    }
+    const completed = urlExt ? null : await completedFor(ctx.assetsDir, stem);
+    if (completed) {
+      return completed;
+    }
+    const res = await doFetch(url, { signal: AbortSignal.timeout(timeoutMs) });
+    if (!res.ok) {
+      throw new Error(`${res.status}`);
+    }
+    const type = mediaType(res);
+    if (NON_MEDIA_TYPE.test(type)) {
+      throw new Error(`responded with ${type}, not a media file`);
+    }
+    if (!res.body) {
+      throw new Error("empty response body");
+    }
+    const file = `${stem}${urlExt ?? EXT_BY_MIME.get(type) ?? UNKNOWN_EXT}`;
+    const target = join5(ctx.assetsDir, file);
+    await mkdir3(ctx.assetsDir, { recursive: true });
+    const part = `${target}.${randomUUID()}${PART_SUFFIX}`;
+    try {
+      await writeFile3(part, res.body);
+    } catch (error) {
+      await rm(part, { force: true });
+      throw error;
+    }
+    await rename(part, target);
+    return file;
+  };
   const rewrites = new Map;
   await Promise.all([...urls].map(async (url) => {
     try {
-      const res = await doFetch(url);
-      if (!res.ok) {
-        throw new Error(`${res.status}`);
-      }
-      const bytes = new Uint8Array(await res.arrayBuffer());
-      const file = `${hashText(url.split("?")[0] ?? url)}${extFor(url)}`;
-      await mkdir3(ctx.assetsDir, { recursive: true });
-      await writeFile3(join5(ctx.assetsDir, file), bytes);
+      const file = await limit(() => download(url));
       rewrites.set(url, `${ctx.assetsBaseUrl}/${file}`);
     } catch (error) {
       diagnostics.push({
@@ -3854,6 +3943,9 @@ var materializeAssets = async (markdown, ctx) => {
   const rewritten = masked.replaceAll(MD_IMAGE2, (match, alt, url) => {
     const local = rewrites.get(url);
     return local ? `![${alt}](${local})` : match;
+  }).replaceAll(HTML_VIDEO_SRC, (match, open, url, close) => {
+    const local = rewrites.get(url);
+    return local ? `${open}${local}${close}` : match;
   }).replaceAll(FENCE_TOKEN, (token, index) => fences[Number(index)] ?? token);
   return { diagnostics, markdown: rewritten };
 };
@@ -3886,6 +3978,7 @@ var MAX_RETRIES = 4;
 var BASE_DELAY_MS = 500;
 var SECOND_MS2 = 1000;
 var DEFAULT_CONCURRENCY = 3;
+var ASSET_DOWNLOAD_CONCURRENCY = 4;
 var withNotionRetry = async (call, attempt = 0) => {
   try {
     return await call();
@@ -3911,6 +4004,25 @@ var LIST_BLOCKS = new Set([
   "to_do"
 ]);
 var isListItem = (block) => block !== undefined && LIST_BLOCKS.has(block.type);
+var richToPlain = (rich = []) => rich.map((node) => node.plain_text).join("");
+var jsxString = (value) => `{${JSON.stringify(value)}}`;
+var YOUTUBE_HOST = /(?:^|\.)(?:youtube(?:-nocookie)?\.com|youtu\.be)$/u;
+var isYouTubeUrl = (url) => {
+  const host = URL.parse(url)?.hostname ?? "";
+  return YOUTUBE_HOST.test(host) && parseYouTubeId(url) !== null;
+};
+var renderVideo = (data) => {
+  const url = data.external?.url ?? data.file?.url;
+  if (!url) {
+    return "";
+  }
+  const caption = richToMarkdown(data.caption);
+  const title = caption ? ` title=${jsxString(richToPlain(data.caption))}` : "";
+  const media = isYouTubeUrl(url) ? `<YouTube${title} url=${JSON.stringify(url)} />` : `<video controls src=${JSON.stringify(url)} />`;
+  return caption ? `<Frame caption=${jsxString(caption)}>
+${media}
+</Frame>` : media;
+};
 var renderLeaf = (block) => {
   const data = payloadOf(block) ?? {};
   const text = richToMarkdown(blockField(block));
@@ -3951,6 +4063,9 @@ ${text}
       const url = data.external?.url ?? data.file?.url;
       return url ? `![${richToMarkdown(data.caption)}](${url})` : "";
     }
+    case "video": {
+      return renderVideo(data);
+    }
     default: {
       return null;
     }
@@ -3959,6 +4074,7 @@ ${text}
 var notionSource = (options, ctx) => {
   const props = options.properties ?? {};
   const limit = pLimit(Math.max(1, options.concurrency ?? DEFAULT_CONCURRENCY));
+  const downloads = pLimit(ASSET_DOWNLOAD_CONCURRENCY);
   const notionCall = (call) => withNotionRetry(() => limit(call));
   const cache = snapshotCache(ctx?.cacheDir ?? join6(".blume", "cache", options.name));
   const assetsDir = ctx?.assetsDir ?? join6(".blume", "public", "blume-assets", options.name);
@@ -3998,7 +4114,7 @@ ${body}
 </Callout>`;
     }
     if (block.type === "toggle") {
-      const title = JSON.stringify(richToMarkdown(blockField(block)));
+      const title = jsxString(richToMarkdown(blockField(block)));
       return `<Accordion>
 <AccordionItem title=${title}>
 ${await children(block)}
@@ -4099,7 +4215,8 @@ ${nested}`;
     const assets = await materializeAssets(mdx, {
       assetsBaseUrl,
       assetsDir,
-      fetchImpl: options.fetchImpl
+      fetchImpl: options.fetchImpl,
+      limit: downloads
     });
     const raw = frontmatter_default.stringify(assets.markdown, data);
     return {
@@ -4168,7 +4285,7 @@ ${nested}`;
 
 // src/core/sources/obsidian.ts
 import { existsSync as existsSync3, watch as fsWatch2, statSync } from "node:fs";
-import { readdir, readFile as readFile5, stat } from "node:fs/promises";
+import { readdir as readdir2, readFile as readFile5, stat } from "node:fs/promises";
 import { basename as basename2, isAbsolute as isAbsolute3, join as join7, relative as relative5, resolve as resolve3 } from "pathe";
 var MARKDOWN_FILE = /\.md$/iu;
 var OBSIDIAN_COMMENT = /%%.*?%%/gu;
@@ -4528,7 +4645,7 @@ var classify = async (dir, entry) => {
 var byVaultOrder = (a, b) => Number(b.directory) - Number(a.directory) || a.name.localeCompare(b.name, "en", { numeric: true, sensitivity: "base" }) || (a.name < b.name ? -1 : 1);
 var walkVault = async (dir, root, exclude) => {
   const found = [];
-  const listed = await readdir(dir, { withFileTypes: true });
+  const listed = await readdir2(dir, { withFileTypes: true });
   const entries = await Promise.all(listed.filter((entry) => !(isHidden(entry.name) || exclude.has(entry.name))).map((entry) => classify(dir, entry)));
   for (const entry of entries.toSorted(byVaultOrder)) {
     const full = join7(dir, entry.name);
@@ -5164,7 +5281,7 @@ var scanProject = async (root, options = {}) => {
   };
 };
 
-export { YAML_SCHEMA, frontmatter_default, TOC_HIDDEN_KEY, parseHeadingMarkers, BLUME_IGNORE_DIRS, i18nEnabled, localeCodes, resolveFallbackLocale, localePrefix, localizeRoute, localeTargetPath, validateSearchPopularIcons, validateNavTargets, VERSION_LIKE, versionizeRoute, nextFenceState, HTML_COMMENT, INLINE_CODE, scanBody, MD_IMAGE, targetOffsetIn, hasIncludeStatements, expandIncludes, buildIncludeGraph, contentIndexable, buildManifest, hashText, specOf, operationOf, specAddresses, apiNamePhrase, operationSignature, isOpenApiSource, resolveDocsCollection, isWithin, scanProject };
+export { YAML_SCHEMA, frontmatter_default, TOC_HIDDEN_KEY, parseHeadingMarkers, BLUME_IGNORE_DIRS, i18nEnabled, localeCodes, resolveFallbackLocale, localePrefix, localizeRoute, localeTargetPath, validateSearchPopularIcons, validateNavTargets, VERSION_LIKE, versionizeRoute, nextFenceState, HTML_COMMENT, INLINE_CODE, scanBody, MD_IMAGE, targetOffsetIn, hasIncludeStatements, expandIncludes, buildIncludeGraph, contentIndexable, buildManifest, hashText, specOf, operationOf, specAddresses, apiNamePhrase, operationSignature, isOpenApiSource, parseYouTubeId, resolveDocsCollection, isWithin, scanProject };
 
-//# debugId=3D5AE0D317E6447664756E2164756E21
-//# sourceMappingURL=chunk-etsqspj6.js.map
+//# debugId=A3A6EEB99D149F0C64756E2164756E21
+//# sourceMappingURL=chunk-12dzsn9b.js.map