blume 1.0.2 → 1.0.4

package/src/components/layout/PageLayout.astro

@@ -39,7 +39,7 @@ import Favicon from "./Favicon.astro";
 import Fonts from "./Fonts.astro";
 import { BANNER_INIT_SCRIPT, THEME_INIT_SCRIPT } from "./head-scripts.ts";
 import Header from "./Header.astro";
-import { isUnderPath } from "./nav-utils.ts";
+import { activeTabForRoute } from "./nav-utils.ts";
 
 interface Props {
   site: { title: string; description?: string };
@@ -58,6 +58,11 @@ interface Props {
   themeMode: "system" | "light" | "dark";
   fontCssVars?: string[];
   searchEnabled: boolean;
+  /**
+   * Opt this page out of the header's Ask AI trigger. Defaults to whether Ask
+   * AI is configured, so a custom page gets the same trigger the docs pages have
+   * without wiring anything up.
+   */
   askEnabled?: boolean;
   /**
    * Absolute site URL (`data.config.site`). When set, `canonical` and the
@@ -132,6 +137,7 @@ const searchLocale =
 const pageTitle = page?.title ?? site.title;
 const description = page?.description ?? site.description;
 const route = page?.route ?? "/";
+const activeTab = activeTabForRoute(navigation.tabs, route);
 
 // Derive canonical + og:image from the site URL the same way the catch-all does
 // for content pages, so a custom page gets both for free. The matching OG card
@@ -229,6 +235,7 @@ const bannerKey = banner?.dismissible ? banner.key : null;
     <Banner banner={banner} strings={strings.banner} />
     <Header
       askEnabled={askEnabled}
+      askStrings={strings.ask}
       hasSidebar={false}
       localeSwitch={localeSwitch}
       logo={logo}
@@ -240,9 +247,7 @@ const bannerKey = banner?.dismissible ? banner.key : null;
       searchStrings={strings.search}
       site={site}
       switcherStrings={strings.languageSwitcher}
-    >
-      <slot name="ask" slot="ask" />
-    </Header>
+    />
     <main id="blume-content"><slot /></main>
     <slot name="footer" />
     {
@@ -263,14 +268,9 @@ const bannerKey = banner?.dismissible ? banner.key : null;
                 {navigation.tabs.map((tab) => (
                   <li>
                     <a
-                      aria-current={
-                        route === tab.path ||
-                        (tab.path !== "/" && isUnderPath(route, tab.path))
-                          ? "page"
-                          : undefined
-                      }
+                      aria-current={tab === activeTab ? "page" : undefined}
                       class="block rounded-[0.65rem] px-2.5 py-1.5 font-medium text-muted-foreground text-sm transition-colors hover:bg-muted hover:text-foreground aria-[current=page]:bg-muted aria-[current=page]:text-foreground"
-                      href={withBase(tab.path)}
+                      href={withBase(tab.href ?? tab.path)}
                     >
                       {tab.label}
                     </a>

package/src/components/layout/Pagination.astro

@@ -30,15 +30,15 @@ const s = { ...EN_UI.page, ...strings };
     >
       {prev ? (
         <a
-          class="flex max-w-[48%] flex-1 items-center gap-2 rounded-full border border-border px-4 py-3 text-foreground transition-colors hover:border-foreground max-md:max-w-full"
+          class="flex max-w-[48%] flex-1 items-center gap-2 rounded-blume border border-border px-4 py-3 text-foreground transition-colors hover:border-foreground max-md:max-w-full"
           href={withBase(prev.route)}
         >
           <Icon class="rtl:-scale-x-100" name="arrow-left" size={16} />
-          <span>
+          <span class="min-w-0">
             <span class="block text-muted-foreground text-xs max-md:hidden">
               {s.previous}
             </span>
-            <span class="block font-medium">{prev.label}</span>
+            <span class="block truncate font-medium">{prev.label}</span>
           </span>
         </a>
       ) : (
@@ -46,14 +46,14 @@ const s = { ...EN_UI.page, ...strings };
       )}
       {next && (
         <a
-          class="ms-auto flex max-w-[48%] flex-1 items-center justify-end gap-2 rounded-full border border-border px-4 py-3 text-end text-foreground transition-colors hover:border-foreground max-md:max-w-full"
+          class="ms-auto flex max-w-[48%] flex-1 items-center justify-end gap-2 rounded-blume border border-border px-4 py-3 text-end text-foreground transition-colors hover:border-foreground max-md:max-w-full"
           href={withBase(next.route)}
         >
-          <span>
+          <span class="min-w-0">
             <span class="block text-muted-foreground text-xs max-md:hidden">
               {s.next}
             </span>
-            <span class="block font-medium">{next.label}</span>
+            <span class="block truncate font-medium">{next.label}</span>
           </span>
           <Icon class="rtl:-scale-x-100" name="arrow-right" size={16} />
         </a>

package/src/components/layout/ReferenceLayout.astro

@@ -107,6 +107,7 @@ const bannerKey = banner?.dismissible ? banner.key : null;
     >
     <Banner banner={banner} strings={strings.banner} />
     <Header
+      askStrings={strings.ask}
       hasDrawer={false}
       hasSidebar={false}
       logo={logo}

package/src/components/layout/RootLayout.astro

@@ -27,10 +27,10 @@ import { BANNER_INIT_SCRIPT, THEME_INIT_SCRIPT } from "./head-scripts.ts";
 import Header from "./Header.astro";
 import Icon from "../Icon.astro";
 import {
+  activeTabForRoute,
   findBreadcrumbs,
   flattenPages,
   getPagination,
-  isUnderPath,
   sidebarForRoute,
 } from "./nav-utils.ts";
 import NavTree from "./NavTree.astro";
@@ -100,6 +100,10 @@ interface Props {
   x?: { creator?: string; handle?: string };
   canonical?: string | null;
   editUrl?: string | null;
+  /**
+   * Opt this page out of the header's Ask AI trigger. Defaults to whether Ask
+   * AI is configured, so pages never wire the trigger up themselves.
+   */
   askEnabled?: boolean;
   /** Show the "Was this page helpful?" rating below the content. */
   feedback?: boolean;
@@ -303,6 +307,7 @@ const mcpUrl =
 // active tab's section, so a multi-section site drills each tab into its own
 // pages. Without tabs — or on a route under none — this is the full sidebar.
 const sidebar = sidebarForRoute(navigation.sidebar, navigation.tabs, page.route);
+const activeTab = activeTabForRoute(navigation.tabs, page.route);
 const crumbs = findBreadcrumbs(sidebar, page.route);
 const { prev, next } = getPagination(flattenPages(sidebar), page.route);
 
@@ -430,6 +435,7 @@ const bannerKey = banner?.dismissible ? banner.key : null;
     <Banner banner={banner} strings={strings.banner} />
     <HeaderSlot
       askEnabled={askEnabled}
+      askStrings={strings.ask}
       layout={layout}
       localeSwitch={localeSwitch}
       logo={logo}
@@ -441,9 +447,7 @@ const bannerKey = banner?.dismissible ? banner.key : null;
       searchStrings={strings.search}
       site={site}
       switcherStrings={strings.languageSwitcher}
-    >
-      <slot name="ask" slot="ask" />
-    </HeaderSlot>
+    />
     <div
       class:list={["mx-auto grid grid-cols-1 items-start", gridClass]}
       data-blume-doc-grid
@@ -523,14 +527,9 @@ const bannerKey = banner?.dismissible ? banner.key : null;
                 {navigation.tabs.map((tab) => (
                   <li>
                     <a
-                      aria-current={
-                        page.route === tab.path ||
-                        (tab.path !== "/" && isUnderPath(page.route, tab.path))
-                          ? "page"
-                          : undefined
-                      }
+                      aria-current={tab === activeTab ? "page" : undefined}
                       class="block rounded-[0.65rem] px-2.5 py-1.5 font-medium text-muted-foreground text-sm transition-colors hover:bg-muted hover:text-foreground aria-[current=page]:bg-muted aria-[current=page]:text-foreground"
-                      href={withBase(tab.path)}
+                      href={withBase(tab.href ?? tab.path)}
                     >
                       {tab.label}
                     </a>

package/src/components/layout/Search.astro

@@ -58,7 +58,7 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
 
   <dialog
     aria-label={s.label}
-    class="m-auto h-[min(480px,90vh)] w-[min(62.5rem,94vw)] flex-col overflow-hidden rounded-blume border border-border bg-background/80 p-0 text-foreground shadow-2xl outline-none backdrop-blur-xl backdrop:bg-black/30 open:flex"
+    class="mx-auto mt-[8vh] mb-auto h-[min(480px,90dvh)] w-[min(62.5rem,94vw)] flex-col overflow-hidden rounded-blume border border-border bg-background/80 p-0 text-foreground shadow-2xl outline-none backdrop-blur-xl backdrop:bg-black/30 open:flex sm:mt-auto"
     data-blume-search-dialog
   >
     <div

package/src/components/layout/nav-utils.ts

@@ -80,14 +80,16 @@ export const isUnderPath = (route: string, base: string): boolean =>
   base === "/" || route === base || route.startsWith(`${base}/`);
 
 /**
- * The tab whose `path` is the longest prefix of `route`, mirroring the header's
- * active-tab highlight. The root tab (`/`) is skipped — it spans everything and
- * so never scopes the sidebar.
+ * The tab whose `path` is the longest prefix of `route`. The root tab (`/`)
+ * acts as the fallback when no more specific tab matches.
  */
-const activeTab = (tabs: NavTab[], route: string): NavTab | null => {
+export const activeTabForRoute = (
+  tabs: NavTab[],
+  route: string
+): NavTab | null => {
   let match: NavTab | null = null;
   for (const tab of tabs) {
-    if (tab.path === "/" || !isUnderPath(route, tab.path)) {
+    if (!isUnderPath(route, tab.path)) {
       continue;
     }
     if (!match || tab.path.length > match.path.length) {
@@ -187,8 +189,8 @@ export const sidebarForRoute = (
   tabs: NavTab[],
   route: string
 ): NavNode[] => {
-  const tab = activeTab(tabs, route);
-  if (tab) {
+  const tab = activeTabForRoute(tabs, route);
+  if (tab && tab.path !== "/") {
     return sectionChildren(sidebar, tab.path) ?? [];
   }
   const scoped = withoutTabSections(sidebar, tabs);

package/src/core/config-input.ts

@@ -525,7 +525,22 @@ export interface LlmsTxtConfig {
   openapi?: boolean;
 }
 
-/** AI-facing features: the Ask AI assistant and an `llms.txt` manifest. */
+/** Expose the docs as an MCP server for connecting agents. */
+export interface McpConfig {
+  /** Turn the MCP server on. Defaults to `false`. */
+  enabled?: boolean;
+  /** Optional system hint passed to connecting agents. */
+  instructions?: string;
+  /** Server name shown to clients; defaults to the site title. */
+  name?: string;
+  /** Route the server mounts at. Defaults to `/mcp`. */
+  route?: string;
+}
+
+/**
+ * AI-facing features: the Ask AI assistant, an `llms.txt` manifest, and the
+ * hosted MCP server.
+ */
 export interface AiConfig {
   /** The Ask AI chat assistant. */
   ask?: AskConfig;
@@ -553,6 +568,8 @@ export interface AiConfig {
    * ```
    */
   markdownComponents?: Record<string, ComponentMarkdown>;
+  /** Expose the docs as an MCP server for agents. */
+  mcp?: McpConfig;
 }
 
 // ---------------------------------------------------------------------------
@@ -586,22 +603,6 @@ export interface AnalyticsConfig {
   vercel?: boolean;
 }
 
-// ---------------------------------------------------------------------------
-// MCP
-// ---------------------------------------------------------------------------
-
-/** Expose the docs as an MCP server for connecting agents. */
-export interface McpConfig {
-  /** Turn the MCP server on. Defaults to `false`. */
-  enabled?: boolean;
-  /** Optional system hint passed to connecting agents. */
-  instructions?: string;
-  /** Server name shown to clients; defaults to the site title. */
-  name?: string;
-  /** Route the server mounts at. Defaults to `/mcp`. */
-  route?: string;
-}
-
 // ---------------------------------------------------------------------------
 // i18n
 // ---------------------------------------------------------------------------
@@ -710,6 +711,34 @@ export interface RssConfig {
   types?: string[];
 }
 
+/** Colors used by generated Open Graph cards. Values must be hex colors. */
+export interface OgPaletteConfig {
+  /** Fallback mark color. Defaults to the light theme accent. */
+  accent?: string;
+  /** Card background. */
+  background?: string;
+  /** Footer divider. */
+  border?: string;
+  /** Headline and `currentColor` logo color. */
+  foreground?: string;
+  /** Description and footer text. */
+  muted?: string;
+}
+
+/** Per-page Open Graph image generation. */
+export interface OgConfig {
+  /**
+   * Generate an OG image per page. Defaults to on once a deployment `site`
+   * URL is known and off otherwise (`og:image` must be absolute). An explicit
+   * value always wins.
+   */
+  enabled?: boolean;
+  /** Local SVG used in the generated card instead of the site logo. */
+  logo?: string;
+  /** Optional generated-card colors. */
+  palette?: OgPaletteConfig;
+}
+
 /** Discoverability: OG images, feeds, sitemap, robots, and structured data. */
 export interface SeoConfig {
   /**
@@ -720,14 +749,7 @@ export interface SeoConfig {
   /** robots.txt `Content-Signal` usage declaration. Defaults to `true`. */
   contentSignals?: ContentSignalsConfig;
   /** Per-page Open Graph image generation. */
-  og?: {
-    /**
-     * Generate an OG image per page. Defaults to on once a deployment `site`
-     * URL is known and off otherwise (`og:image` must be absolute). An explicit
-     * value always wins.
-     */
-    enabled?: boolean;
-  };
+  og?: OgConfig;
   /** Generate robots.txt (with a Sitemap reference when available). Defaults to `true`. */
   robots?: boolean;
   /** RSS/Atom feeds. */
@@ -979,8 +1001,6 @@ export interface BlumeConfig {
   logo?: LogoConfig;
   /** Markdown / MDX rendering behavior. */
   markdown?: MarkdownConfig;
-  /** Expose the docs as an MCP server for agents. */
-  mcp?: McpConfig;
   /** Header, sidebar, tabs, and switchers. */
   navigation?: NavigationConfig;
   /** Native OpenAPI reference. */

package/src/core/config.ts

@@ -74,9 +74,9 @@ import type { Diagnostic } from "./types.ts";
  *   `algolia`, `typesense`, `orama-cloud`, `mixedbread`, or `none`) plus its
  *   credential block.
  * - `ai` — `ask` (the Ask AI chat endpoint and its provider/model), `llmsTxt`
- *   (emit `llms.txt`), and `markdownComponents` (Markdown serializers for
- *   custom components in agent-facing output).
- * - `mcp` — expose the docs as an MCP server for connecting agents.
+ *   (emit `llms.txt`), `mcp` (expose the docs as an MCP server for connecting
+ *   agents), and `markdownComponents` (Markdown serializers for custom
+ *   components in agent-facing output).
  *
  * **SEO, feeds & analytics**
  * - `seo` — `og` images, `sitemap`, `robots`, `rss` feeds, `structuredData`

package/src/core/data.ts

@@ -15,6 +15,10 @@ export interface BlumeLogo {
   svg?: string;
   light?: string;
   dark?: string;
+  dimensions?: {
+    dark?: { height: number; width: number };
+    light?: { height: number; width: number };
+  };
   alt: string;
   href: string;
   /** Wordmark text beside the mark; `undefined` falls back to the site title. */
@@ -109,7 +113,11 @@ export interface BlumeDataConfig {
   /** Hosted MCP server, or `null` when MCP is off. */
   mcp: { name: string; route: string } | null;
   /** Open Graph image generation. */
-  og: { enabled: boolean };
+  og: {
+    enabled: boolean;
+    logo?: string;
+    palette?: ResolvedConfig["seo"]["og"]["palette"];
+  };
   /** Repository URL for header/edit links, or `null`. */
   repoUrl: string | null;
   search: { enabled: boolean; provider: SearchProvider };

package/src/core/navigation.ts

@@ -433,6 +433,43 @@ const buildConfigSidebar = (
   return nodes;
 };
 
+/**
+ * Resolve a tab's clickable target. A tab's `path` scopes its sidebar section
+ * but need not be a real route — a section with no index page would 404 if the
+ * tab linked straight to it. Prefer an exact page/group at the path; otherwise
+ * fall back to the first linkable route in the section (sidebar order).
+ */
+const resolveTabHref = (sidebar: NavNode[], path: string): string => {
+  let first: string | undefined;
+  const walk = (nodes: NavNode[]): boolean => {
+    for (const node of nodes) {
+      const { route } = node;
+      if (route === path) {
+        return true;
+      }
+      if (
+        first === undefined &&
+        route !== undefined &&
+        route.startsWith(`${path}/`)
+      ) {
+        first = route;
+      }
+      if (node.kind === "group" && walk(node.children)) {
+        return true;
+      }
+    }
+    return false;
+  };
+  return walk(sidebar) ? path : (first ?? path);
+};
+
+/** Attach a resolved `href` to each tab whose section has no index page. */
+const withTabHrefs = (tabs: NavTab[], sidebar: NavNode[]): NavTab[] =>
+  tabs.map((tab) => {
+    const href = resolveTabHref(sidebar, tab.path);
+    return href === tab.path ? tab : { ...tab, href };
+  });
+
 /** Build the complete navigation model from pages, meta, and config. */
 export const buildNavigation = (
   pages: PageRecord[],
@@ -519,11 +556,17 @@ export const buildNavigation = (
   }
 
   if (options.sidebar) {
+    const sidebar = buildConfigSidebar(
+      options.sidebar,
+      byRoute,
+      display,
+      basePath
+    );
     return {
       featured,
       selectors,
-      sidebar: buildConfigSidebar(options.sidebar, byRoute, display, basePath),
-      tabs,
+      sidebar,
+      tabs: withTabHrefs(tabs, sidebar),
     };
   }
 
@@ -534,19 +577,18 @@ export const buildNavigation = (
   // prefix (`/docs`, `/fr`) and a bare `"/"` check would miss the match (or,
   // under a base, falsely scope a group named like the prefix).
   const rootTabPath = withBasePath(basePath, options.localizedRoot ?? "/");
+  const sidebar = buildFileSystemSidebar(
+    pages,
+    options.folderMeta,
+    sharedFolderMeta,
+    metaPrefix,
+    display,
+    new Set(tabs.flatMap((tab) => (tab.path === rootTabPath ? [] : [tab.path])))
+  );
   return {
     featured,
     selectors,
-    sidebar: buildFileSystemSidebar(
-      pages,
-      options.folderMeta,
-      sharedFolderMeta,
-      metaPrefix,
-      display,
-      new Set(
-        tabs.flatMap((tab) => (tab.path === rootTabPath ? [] : [tab.path]))
-      )
-    ),
-    tabs,
+    sidebar,
+    tabs: withTabHrefs(tabs, sidebar),
   };
 };

package/src/core/schema.ts

@@ -550,6 +550,19 @@ export const askAiProviders = [
   "openai-compatible",
 ] as const;
 
+const mcpConfigSchema = z.strictObject({
+  enabled: z.boolean().default(false),
+  /** Optional system hint passed to connecting agents. */
+  instructions: z.string().optional(),
+  /** Server name shown to clients; defaults to the site title. */
+  name: z.string().optional(),
+  /**
+   * Normalized like `openapi.route`: a slash-less value would otherwise be
+   * string-concatenated onto the site origin (`https://acme.comdocs-mcp`).
+   */
+  route: z.string().default("/mcp").transform(normalizeRoute),
+});
+
 const aiConfigSchema = z.strictObject({
   ask: z
     .strictObject({
@@ -620,6 +633,8 @@ const aiConfigSchema = z.strictObject({
       })
     )
     .default({}),
+  /** Expose the docs as an MCP server for connecting agents. */
+  mcp: mcpConfigSchema.default({}),
 });
 
 /**
@@ -657,7 +672,7 @@ const navigationConfigSchema = z.strictObject({
     .transform((value) =>
       Array.isArray(value) ? { display: "flat" as const, items: value } : value
     ),
-  tabs: z.array(navTabSchema).optional(),
+  tabs: z.array(navTabSchema).default([]),
 });
 
 export type AskAiProvider = (typeof askAiProviders)[number];
@@ -679,19 +694,6 @@ const exportConfigSchema = z
     typeof value === "boolean" ? { epub: value, pdf: value } : value
   );
 
-const mcpConfigSchema = z.strictObject({
-  enabled: z.boolean().default(false),
-  /** Optional system hint passed to connecting agents. */
-  instructions: z.string().optional(),
-  /** Server name shown to clients; defaults to the site title. */
-  name: z.string().optional(),
-  /**
-   * Normalized like `openapi.route`: a slash-less value would otherwise be
-   * string-concatenated onto the site origin (`https://acme.comdocs-mcp`).
-   */
-  route: z.string().default("/mcp").transform(normalizeRoute),
-});
-
 /** A configured locale: ISO-ish code plus display metadata for the switcher. */
 const localeSchema = z.strictObject({
   code: z.string().min(1),
@@ -800,6 +802,18 @@ const xConfigSchema = z.strictObject({
   handle: xHandleSchema,
 });
 
+const ogColorSchema = z
+  .string()
+  .regex(/^#(?:[0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/iu);
+
+const ogPaletteSchema = z.strictObject({
+  accent: ogColorSchema.optional(),
+  background: ogColorSchema.optional(),
+  border: ogColorSchema.optional(),
+  foreground: ogColorSchema.optional(),
+  muted: ogColorSchema.optional(),
+});
+
 const ogConfigSchema = z.strictObject({
   /**
    * Generate a per-page Open Graph image. Defaults to on once a deployment
@@ -808,6 +822,10 @@ const ogConfigSchema = z.strictObject({
    * `loadConfig`. An explicit value here always wins.
    */
   enabled: z.boolean().optional(),
+  /** Local SVG used in the generated card instead of the site logo. */
+  logo: z.string().optional(),
+  /** Optional generated-card colors. */
+  palette: ogPaletteSchema.optional(),
 });
 
 const rssConfigSchema = z.strictObject({
@@ -1088,7 +1106,6 @@ export const blumeConfigSchema = z.strictObject({
   lastModified: lastModifiedConfigSchema.default(false),
   logo: logoConfigSchema.optional(),
   markdown: markdownConfigSchema.default({}),
-  mcp: mcpConfigSchema.default({}),
   navigation: navigationConfigSchema.default({}),
   openapi: openapiConfigSchema.default({}),
   react: reactConfigSchema.default({}),

package/src/core/server-features.ts

@@ -11,7 +11,7 @@ export const serverFeatures = (config: ResolvedConfig): string[] => {
     features.push("Ask AI");
   }
   // The hosted MCP server is a live JSON-RPC endpoint, so it needs a runtime.
-  if (config.mcp.enabled) {
+  if (config.ai.mcp.enabled) {
     features.push("MCP server");
   }
   // Mixedbread (and any future provider) that proxies queries through a secret

package/src/core/sources/watch.ts

@@ -23,6 +23,11 @@ import type { WatchListener } from "node:fs";
  */
 export const BLUME_IGNORE_DIRS = [
   ".blume",
+  // The isolated `blume check --isolated` runtime. A sibling of `.blume`, it is
+  // written while a dev server runs; without this the content-layer watcher (or
+  // a `.`-rooted fs.watch) would treat its generation as a content change and
+  // reload — the very thing `--isolated` promises not to do.
+  ".blume-verify",
   ".cache",
   ".git",
   ".next",

package/src/core/types.ts

@@ -159,7 +159,17 @@ export type NavNode =
 /** Top-level tab/section. */
 export interface NavTab {
   label: string;
+  /**
+   * The tab's section prefix, used to scope the sidebar and match the active
+   * tab. Not necessarily a linkable route — a section may have no index page.
+   */
   path: string;
+  /**
+   * The clickable target. Equals `path` when the section has an index page;
+   * otherwise it's resolved to the section's first page so the tab never links
+   * to a 404. Absent when it matches `path`.
+   */
+  href?: string;
   icon?: string;
   items?: NavSelectorItem[];
 }

package/src/deploy/adapter-output.ts

@@ -83,7 +83,17 @@ export const surfaceAdapterOutput = async (
   }
   await mkdir(dirname(to), { recursive: true });
   await rm(to, { force: true, recursive: true });
-  await cp(from, to, { recursive: true });
+  // `verbatimSymlinks` keeps each symlink's target text as written. Without it,
+  // `cp` resolves every relative target against the *source*, rewriting it to an
+  // absolute path under `.blume` — which this function then deletes. Adapters
+  // that trace dependencies into their function bundle link one package to
+  // another that way (under an isolated linker — Bun's `isolated` mode, pnpm —
+  // that is every external dependency the function imports), so the resolved
+  // links leave the deployed function dying on its first external import with
+  // ERR_MODULE_NOT_FOUND. Verbatim, the links stay relative and internal to the
+  // bundle, surviving both this move and the platform's own (Vercel mounts the
+  // bundle at `/var/task`).
+  await cp(from, to, { recursive: true, verbatimSymlinks: true });
   await rm(from, { force: true, recursive: true });
   // The `.gitignore` entry is the surfaced top-level dir (`.vercel`/`.netlify`),
   // never the moved sub-path — the platform's own state (`.vercel/project.json`,

package/src/markdown/index.ts

@@ -17,6 +17,7 @@ import { languageIconTransformer } from "./language-icon.ts";
 import { mathPlugin } from "./math.ts";
 import { mermaidPlugin } from "./mermaid.ts";
 import { packageInstallPlugin } from "./package-install.ts";
+import { tableWrapPlugin } from "./table-wrap.ts";
 import { DEFAULT_CODE_THEMES } from "./themes.ts";
 import type { CodeThemes } from "./themes.ts";
 
@@ -58,6 +59,7 @@ type HastPlugin = NonNullable<
 const blumeHastPlugins = (options: BlumeMarkdownOptions): HastPlugin[] => {
   const plugins: HastPlugin[] = [
     inlineCodeHighlightPlugin(options.codeThemes) as unknown as HastPlugin,
+    tableWrapPlugin() as unknown as HastPlugin,
   ];
   if (options.headingAnchors !== false) {
     plugins.push(headingAnchorPlugin() as unknown as HastPlugin);

package/src/markdown/language-icon.ts

@@ -7,7 +7,8 @@
  * hex colors are skipped because dark-on-dark logos (Next.js, Rust…) vanish.
  *
  * The theme styles `.blume-lang-icon` and shifts the language label
- * (`pre[data-icon]::before`) to make room.
+ * (`pre[data-language][data-icon]::before`) to make room — gated on
+ * `data-language` so the icon only shows when a header bar exists to hold it.
  */
 
 import {