blume@1.0.4

Patch Changes

• cf8fa22: Fix the spacing inside directive callouts (:::note, :::success, …). The global prose paragraph rule leaks a 1rem margin onto the callout’s paragraphs even though the callout is not-prose, and with a title the body paragraph isn’t the first child — so that margin stacked under the title’s own gap and left a too-large space between the title and the body. The Callout now overrides that margin locally for a uniform, compact gap between the title, paragraphs, and lists. Callouts without a title and normal prose spacing are unchanged.

• bb5944d: Gate the language icon on data-language so it no longer overlaps the first code line on header-less standalone <CodeBlock>s. The icon transformer runs whenever icons are on, but a standalone block without a title never gets data-language (the header bar that reserves the icon’s space), so the absolutely-positioned icon sat on top of the first line. Fenced code and titled blocks are unaffected.

• d59be0a: API references (OpenAPI, AsyncAPI) no longer add a header tab automatically. Point a navigation.tabs entry at the reference route to surface it — this also lets you control the tab label and scopes the operations sidebar for the native renderer.

• f02b94e: Introduce the blume-migrate agent skill. It teaches an AI agent to migrate an existing docs site — Mintlify, Docusaurus, Fumadocs, Nextra, Starlight, or any docs framework — into an idiomatic Blume project: translating the source config to blume.config.ts, restructuring content into filesystem-derived navigation (with redirects for every moved route), rewriting callouts to ::: directives, converting icons to Lucide, inlining snippets, and pointing generated API references at openapi.sources instead of porting endpoint stubs. Ships with per-framework mapping references, a deterministic Mintlify codemod for the icon/frontmatter pass, and monorepo/Vercel integration recipes. The skill is bundled in the package under skills/.

• a421a1e: Make the generated runtime type-check cleanly under blume check --strict --isolated (and any project whose tsconfig includes the generated files). Previously a valid site could fail with dozens of errors in the generated .blume-verify files:

  • The raw-Markdown, RSS, and OG endpoints imported data.json directly, so TypeScript widened the JSON (navigation kind to string, empty arrays to never[], theme mode to string) and rejected it against Blume’s own types. They now import the typed blume:data virtual module.
  • Endpoint handlers (GET, getStaticPaths callbacks) and the changelog/content-page helper functions had implicit-any parameters; they now carry explicit types.
  • The OG endpoint’s PNG Buffer is wrapped in a Uint8Array so it satisfies the Response body type, and the empty component-overrides module and the blume:examples/blume:examples-theme virtual modules now declare types.

  Also stops blume check --isolated from reloading a running blume dev server: .blume-verify is now in Blume’s ignored-directory set, so generating the isolated runtime no longer trips the content watcher.

• 6a97cb2: Reserve space for local per-mode SVG logos before they load.

• 5793ccf: Render Mermaid diagrams in blume dev. Mermaid statically imports dayjs as CommonJS (dayjs/dayjs.min.js), and in dev Vite served that dependency un-pre-bundled, so it exposed no default export and mermaid threw does not provide an export named 'default' — leaving diagrams blank (the production build already handled the interop). Mermaid now goes through Vite’s dependency optimizer, which bundles dayjs with correct CommonJS interop. Because Blume’s import("mermaid") lives inside node_modules/blume — a path Vite’s optimizer scan doesn’t crawl in a standalone install — the diagram library was never discovered on its own, so it’s included explicitly via the nested blume > mermaid form (mermaid isn’t a direct dependency of the generated project).

• 5c0b0f0: Add custom logo and palette settings for generated Open Graph cards.

• 1bdc849: Truncate long page titles in the previous/next pagination links so they no longer overflow their pill container, and allow inline code inside table cells to wrap instead of forcing the whole table to overflow horizontally.

• f2ffcb5: Prerender Cloudflare adapter builds in Node so build-time node: imports resolve. Astro 6 changed the @astrojs/cloudflare default prerender runtime from Node to workerd, which broke Blume prerender on Cloudflare (No such module "node:path" and node:fs usage in Blume’s build-time content tooling). The generated astro.config.mjs now passes prerenderEnvironment: "node" to the Cloudflare adapter. On-demand pages still run in workerd at request time.

• d11a90c: Stop the Prompt component’s copy button from shifting the layout. On copy, the button’s label swapped “Copy prompt” → “Copied”, and because the button was sized to its text, it shrank — giving the description beside it more room and reflowing it (a two-line description would collapse to one line, then jump back). Both labels now share a single grid cell, so the button is always sized to the wider “Copy prompt” and never resizes when the state changes.

• fcdc3b3: Match native browser controls, including scrollbars, to the active color theme.

• 3795fbb: Keep root navigation tabs active on descendant routes unless a more specific tab matches.

• e5aa042: Use the rounded-blume radius token instead of a hardcoded rounded-full on the PageFeedback and Pagination buttons so they respect the configured theme.radius.

• 32e29f0: Keep the text caret inside the search input on mobile. The search dialog was vertically centered, so when the on-screen keyboard opened and the viewport shrank, the dialog re-centered and the input moved up while the native caret stayed put — stranding the cursor below the input, over the results. The dialog is now top-anchored on small screens (like DocSearch/cmdk) so the input sits above where the keyboard appears and doesn’t move, and its height is capped to the dynamic viewport so it fits above the keyboard. Desktop keeps its centered layout.

• 7806565: Resolve a section tab’s link to its first page when the section has no index page, so the tab no longer 404s. A tab’s path still scopes its sidebar section and matches the active tab, but the clickable target now falls back to the first page in the section (sidebar order) when nothing lives at the path itself — e.g. /examples with only /examples/hello-world links to that page instead of a missing /examples.

• fe21c54: Wrap markdown tables in a horizontal-scroll container so wide tables no longer overflow the prose column. The wrapper is framed with a rounded border and cell padding, and header labels stay on one line, so a clipped wide table reads as scrollable rather than cut off.