blume 0.5.2 → 0.5.4

package/src/components/layout/PageLayout.astro

@@ -190,6 +190,48 @@ const bannerScript = banner?.dismissible
     </Header>
     <main id="blume-content"><slot /></main>
     <slot name="footer" />
+    {
+      // Mobile nav for chrome-only pages: the header's inline tab bar is hidden
+      // below `lg` and there's no sidebar drawer, so surface the tabs in a
+      // slide-in drawer instead. It reuses the header's `data-blume-nav-toggle`
+      // machinery (drawer top, scroll lock, resize-close) — the hamburger button
+      // lives in the header; this is the panel it opens.
+      navigation.tabs.length > 0 && (
+        <>
+          <aside
+            aria-label="Navigation"
+            class="fixed top-[var(--blume-drawer-top,4rem)] start-0 z-[35] h-[calc(100dvh-var(--blume-drawer-top,4rem))] w-64 max-w-[80vw] -translate-x-[105%] overflow-y-auto border-border border-e bg-background px-5 pt-4 pb-6 transition-transform rtl:translate-x-[105%] [:where([data-blume-nav-open])_&]:translate-x-0! lg:hidden"
+          >
+            <nav aria-label="Sections">
+              <ul class="m-0 list-none p-0">
+                {navigation.tabs.map((tab) => (
+                  <li>
+                    <a
+                      aria-current={
+                        route === tab.path ||
+                        (tab.path !== "/" && route.startsWith(tab.path))
+                          ? "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={tab.path}
+                    >
+                      {tab.label}
+                    </a>
+                  </li>
+                ))}
+              </ul>
+            </nav>
+          </aside>
+          <button
+            aria-label="Close navigation"
+            class="fixed inset-0 z-[30] hidden cursor-pointer border-0 bg-black/40 [:where([data-blume-nav-open])_&]:block lg:hidden"
+            data-blume-nav-toggle
+            type="button"
+          />
+        </>
+      )
+    }
     {
       clientDataJson && (
         <script

package/src/components/layout/ReferenceLayout.astro

@@ -18,6 +18,7 @@ interface Props {
     dark?: string;
     alt: string;
     href: string;
+    text?: string;
   } | null;
   favicon?: {
     href: string;

package/src/components/layout/RootLayout.astro

@@ -39,6 +39,7 @@ interface Props {
     dark?: string;
     alt: string;
     href: string;
+    text?: string;
   } | null;
   favicon?: {
     href: string;
@@ -344,8 +345,36 @@ const bannerScript = banner?.dismissible
     <div class:list={["mx-auto grid grid-cols-1 items-start", gridClass]}>
       <aside
         aria-label="Primary"
-        class="fixed top-16 start-0 z-[35] h-[calc(100dvh-4rem)] w-64 max-w-[80vw] -translate-x-[105%] overflow-y-auto border-border border-e bg-background px-5 pt-4 pb-6 transition-transform rtl:translate-x-[105%] [:where([data-blume-nav-open])_&]:translate-x-0! lg:sticky lg:z-auto lg:w-auto lg:max-w-none lg:translate-x-0! lg:border-e-0 lg:bg-transparent lg:px-4"
+        class="fixed top-[var(--blume-drawer-top,4rem)] start-0 z-[35] h-[calc(100dvh-var(--blume-drawer-top,4rem))] w-64 max-w-[80vw] -translate-x-[105%] overflow-y-auto border-border border-e bg-background px-5 pt-4 pb-6 transition-transform rtl:translate-x-[105%] [:where([data-blume-nav-open])_&]:translate-x-0! lg:sticky lg:top-16 lg:z-auto lg:h-[calc(100dvh-4rem)] lg:w-auto lg:max-w-none lg:translate-x-0! lg:border-e-0 lg:bg-transparent lg:px-4"
       >
+        {
+          // The header's tab bar is hidden below `md`, so the drawer is the only
+          // way to move between sections on mobile: list the tabs above the
+          // page tree, separated by a divider. Hidden from `md` up, where the
+          // header tabs take over.
+          navigation.tabs.length > 0 && (
+            <nav aria-label="Sections" class="mb-4 border-border border-b pb-4 md:hidden">
+              <ul class="m-0 list-none p-0">
+                {navigation.tabs.map((tab) => (
+                  <li>
+                    <a
+                      aria-current={
+                        page.route === tab.path ||
+                        (tab.path !== "/" && page.route.startsWith(tab.path))
+                          ? "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={tab.path}
+                    >
+                      {tab.label}
+                    </a>
+                  </li>
+                ))}
+              </ul>
+            </nav>
+          )
+        }
         <nav>
           {
             MobileNavSlot ? (
@@ -363,7 +392,7 @@ const bannerScript = banner?.dismissible
           }
         </nav>
       </aside>
-      <main class="min-w-0 px-6 pt-6 pb-10 lg:px-8 xl:px-10" id="blume-content">
+      <main class="px-6 pt-6 pb-10 lg:px-8 xl:px-10" id="blume-content">
         <BreadcrumbsSlot crumbs={crumbs} wide={isApiOperation} />
         <TableOfContentsSlot
           headings={tocHeadings}

package/src/components/layout/Search.astro

@@ -36,12 +36,12 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
 >
   <button
     aria-label={s.button}
-    class="inline-flex h-9 min-w-0 cursor-pointer items-center gap-2 rounded-full border border-border bg-background px-3 text-muted-foreground text-sm transition-colors hover:border-foreground hover:text-foreground sm:min-w-48"
+    class="inline-flex h-9 cursor-pointer items-center gap-2 rounded-full border border-border bg-background px-3 text-muted-foreground text-sm transition-colors hover:border-foreground hover:text-foreground sm:min-w-48"
     data-blume-search-open
     type="button"
   >
     <Icon name="search" size={16} />
-    <span class="min-w-0 flex-1 text-start max-sm:hidden">{s.button}</span>
+    <span class="flex-1 text-start max-sm:hidden">{s.button}</span>
     <kbd class="font-mono text-[0.7rem] max-sm:hidden" data-blume-search-kbd
       >⌘K</kbd
     >
@@ -296,10 +296,13 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
         this.input.focus();
         this.input.select();
         if (!this.loaded) {
-          this.loaded = true;
           try {
             const { createSearch } = await import("blume:search-client");
             this.searchFn = await createSearch();
+            // Only latch on success — a transient failure (flaky network
+            // fetching the index) must retry on the next open, not disable
+            // search until a full page reload.
+            this.loaded = true;
           } catch {
             this.searchFn = null;
           }
@@ -456,7 +459,7 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
           : "Ask AI";
         el.innerHTML = `
           <span class="mt-0.5 shrink-0 text-accent">${svg("sparkles")}</span>
-          <span class="min-w-0 flex-1">
+          <span class="flex-1">
             <span class="block truncate font-normal text-foreground text-sm">${title}</span>
             <span class="block truncate text-muted-foreground text-sm">Get an instant answer from AI</span>
           </span>`;
@@ -476,7 +479,7 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
           : "";
         el.innerHTML = `
           <span class="mt-0.5 shrink-0 text-muted-foreground">${svg("file")}</span>
-          <span class="min-w-0 flex-1">
+          <span class="flex-1">
             <span class="block truncate font-normal text-foreground text-sm">${hit.title}</span>
             ${excerpt}
           </span>`;
@@ -491,7 +494,7 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
         el.className = ROW_CLASS;
         el.innerHTML = `
           <span class="mt-0.5 shrink-0 text-muted-foreground">${svg("file")}</span>
-          <span class="min-w-0 flex-1">
+          <span class="flex-1">
             <span class="block truncate font-normal text-foreground text-sm">${escapeHtml(label)}</span>
           </span>`;
         const item: Selectable = { el, kind: "link", url };

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

@@ -161,9 +161,14 @@ const withoutTabSections = (nodes: NavNode[], tabs: NavTab[]): NavNode[] => {
  * Adapters / API / AI tabs) drills each tab into its own pages instead of one
  * global tree, the way Fumadocs' root folders do. On a route under no tab (or
  * the root `/` tab), the tab-owned groups are hidden so the root sidebar shows
- * only pages that don't belong to a tab. Falls back to the full sidebar when a
- * matched tab maps to no group, or when hiding the tab sections would blank the
- * sidebar, so a route is never left empty.
+ * only pages that don't belong to a tab.
+ *
+ * When a matched tab owns no sidebar group — a standalone page like the
+ * generated changelog timeline (`/changelog`), or a tab whose source produced
+ * no pages — the sidebar is empty. It must not fall back to the full tree: that
+ * would leak every *other* tab's section (e.g. the OpenAPI operations) onto the
+ * page. On a route under no tab, hiding the tab sections falls back to the full
+ * sidebar only when it would otherwise blank, so an un-tabbed route stays full.
  */
 export const sidebarForRoute = (
   sidebar: NavNode[],
@@ -172,7 +177,7 @@ export const sidebarForRoute = (
 ): NavNode[] => {
   const tab = activeTab(tabs, route);
   if (tab) {
-    return sectionChildren(sidebar, tab.path) ?? sidebar;
+    return sectionChildren(sidebar, tab.path) ?? [];
   }
   const scoped = withoutTabSections(sidebar, tabs);
   return scoped.length > 0 ? scoped : sidebar;

package/src/components/layout/search/types.ts

@@ -74,15 +74,26 @@ const queryTokens = (query: string): string[] =>
     .filter(Boolean)
     .map((token) => token.replaceAll(REGEXP_SPECIAL, String.raw`\$&`));
 
-/** Wrap query matches in `<mark>`, after HTML-escaping the source text. */
+/**
+ * Wrap query matches in `<mark>`, HTML-escaping the source text. Matching runs
+ * on the *raw* text and escaping on each segment — matching after escaping
+ * would let a query like "amp" or "lt" mark the inside of an entity produced
+ * from the source (`&amp;` in "a & b"), corrupting the rendered excerpt.
+ */
 export const highlight = (text: string, query: string): string => {
-  const escaped = escapeHtml(text);
   const tokens = queryTokens(query);
   if (tokens.length === 0) {
-    return escaped;
+    return escapeHtml(text);
   }
-  const pattern = new RegExp(`(?<match>${tokens.join("|")})`, "giu");
-  return escaped.replaceAll(pattern, "<mark>$<match></mark>");
+  const pattern = new RegExp(`(${tokens.join("|")})`, "giu");
+  return text
+    .split(pattern)
+    .map((segment, index) =>
+      index % 2 === 1
+        ? `<mark>${escapeHtml(segment)}</mark>`
+        : escapeHtml(segment)
+    )
+    .join("");
 };
 
 /** First index in `text` where any query token matches (case-insensitive). */

package/src/components/openapi/ApiOverview.astro

@@ -1,28 +1,18 @@
 ---
 import specs from "blume:openapi";
-import MethodBadge from "./MethodBadge.astro";
 
+// The spec-level metadata block (version + base URLs) at the top of an API
+// overview page. The tag sections that follow are emitted by `overviewMdx` as
+// markdown headings plus `<ApiTagOperations>` lists, so they land in the
+// table of contents.
 interface Props {
   source: string;
 }
 
 const { source } = Astro.props;
 const spec = specs[source];
-const operations = Object.values(spec?.operations ?? {});
 const servers =
   ((spec?.document ?? {}) as { servers?: { url?: string }[] }).servers ?? [];
-
-// Tags in declared order, then any operation tag not listed under `tags`.
-const declaredSlugs = new Set(spec?.tags.map((tag) => tag.slug));
-const extraSlugs = new Set<string>();
-const extraTags: { slug: string; name: string; description: string }[] = [];
-for (const operation of operations) {
-  if (!(declaredSlugs.has(operation.tagSlug) || extraSlugs.has(operation.tagSlug))) {
-    extraSlugs.add(operation.tagSlug);
-    extraTags.push({ description: "", name: operation.tag, slug: operation.tagSlug });
-  }
-}
-const sections = [...(spec?.tags ?? []), ...extraTags];
 ---
 
 {
@@ -43,42 +33,6 @@ const sections = [...(spec?.tags ?? []), ...extraTags];
           ))}
         </div>
       )}
-      {sections.map((tag) => {
-        const ops = operations.filter(
-          (operation) => operation.tagSlug === tag.slug
-        );
-        if (ops.length === 0) {
-          return null;
-        }
-        return (
-          <section class="mb-8">
-            <h2 class="mb-1 font-semibold text-foreground text-xl">
-              {tag.name}
-            </h2>
-            {tag.description && (
-              <div class="mb-3 text-muted-foreground text-sm" set:text={tag.description} />
-            )}
-            <ul class="not-prose flex list-none flex-col gap-2 p-0">
-              {ops.map((operation) => (
-                <li>
-                  <a
-                    class="flex items-center gap-3 rounded-blume border border-border p-3 text-inherit no-underline! transition-colors hover:border-accent hover:bg-muted hover:no-underline!"
-                    href={operation.route}
-                  >
-                    <MethodBadge method={operation.method} />
-                    <span class="font-medium text-foreground text-sm">
-                      {operation.summary || operation.path}
-                    </span>
-                    <code class="ml-auto hidden text-muted-foreground text-xs sm:inline">
-                      {operation.path}
-                    </code>
-                  </a>
-                </li>
-              ))}
-            </ul>
-          </section>
-        );
-      })}
     </div>
   )
 }

package/src/components/openapi/ApiTagOperations.astro

@@ -0,0 +1,42 @@
+---
+import specs from "blume:openapi";
+import MethodBadge from "./MethodBadge.astro";
+
+// The operation-link list for one tag section of an API overview page. The
+// section heading itself is emitted by `overviewMdx` as a markdown `##` — so it
+// flows into the table of contents — and this component renders only the list
+// of operations beneath it.
+interface Props {
+  source: string;
+  /** Tag slug (`ApiOperationRef.tagSlug`) selecting this section's operations. */
+  tag: string;
+}
+
+const { source, tag } = Astro.props;
+const operations = Object.values(specs[source]?.operations ?? {}).filter(
+  (operation) => operation.tagSlug === tag
+);
+---
+
+{
+  operations.length > 0 && (
+    <ul class="not-prose my-4 flex list-none flex-col gap-2 p-0">
+      {operations.map((operation) => (
+        <li>
+          <a
+            class="flex items-center gap-3 rounded-blume border border-border p-3 text-inherit no-underline! transition-colors hover:border-accent hover:bg-muted hover:no-underline!"
+            href={operation.route}
+          >
+            <MethodBadge method={operation.method} />
+            <span class="font-medium text-foreground text-sm">
+              {operation.summary || operation.path}
+            </span>
+            <code class="ml-auto hidden text-muted-foreground text-xs sm:inline">
+              {operation.path}
+            </code>
+          </a>
+        </li>
+      ))}
+    </ul>
+  )
+}

package/src/components/openapi/ParametersTable.astro

@@ -48,7 +48,7 @@ const groups = SECTIONS.map((section) => ({
       <div class="not-prose rounded-blume border border-border px-4">
         {group.items.map((param) => {
           const resolved = resolveSchema(schemas, param.schema ?? {});
-          const type = param.schema ? typeLabel(param.schema, schemas) : "string";
+          const type = param.schema ? typeLabel(param.schema) : "string";
           const limits = constraints(resolved);
           const enumValues = Array.isArray(resolved.enum) ? resolved.enum : null;
           return (

package/src/components/openapi/SchemaProperty.astro

@@ -31,7 +31,7 @@ const refLabel = typeof schema.$ref === "string" ? refName(schema.$ref) : null;
 const circular = refLabel !== null && seen.includes(refLabel);
 const resolved = resolveSchema(schemas, schema);
 
-const type = typeLabel(schema, schemas);
+const type = typeLabel(schema);
 const description = resolved.description ?? schema.description ?? "";
 const deprecated = resolved.deprecated === true;
 const nullable = isNullable(resolved);

package/src/components/openapi/SchemaTable.astro

@@ -45,7 +45,7 @@ const { properties, required } = circular
   ) : isArray ? (
     <div>
       <div class="mb-2 text-muted-foreground text-xs">
-        Array of <code class="text-foreground">{typeLabel(items ?? {}, schemas)}</code>
+        Array of <code class="text-foreground">{typeLabel(items ?? {})}</code>
       </div>
       {items && (
         <Astro.self schema={items} schemas={schemas} seen={nextSeen} expandAll={expandAll} />
@@ -59,7 +59,7 @@ const { properties, required } = circular
       {branches.map((branch, index) => (
         <div class="rounded-blume border border-border p-3">
           <div class="mb-2 font-medium text-foreground text-xs">
-            {typeLabel(branch, schemas) || `Option ${index + 1}`}
+            {typeLabel(branch) || `Option ${index + 1}`}
           </div>
           <Astro.self schema={branch} schemas={schemas} seen={nextSeen} expandAll={expandAll} />
         </div>
@@ -80,7 +80,7 @@ const { properties, required } = circular
     </div>
   ) : (
     <div class="text-muted-foreground text-sm">
-      <code class="text-foreground">{typeLabel(resolved, schemas)}</code>
+      <code class="text-foreground">{typeLabel(resolved)}</code>
     </div>
   )
 }

package/src/components/openapi/helpers.ts

@@ -69,17 +69,18 @@ const nonNullTypes = (type: string | string[] | undefined): string[] => {
   return (Array.isArray(type) ? type : [type]).filter((t) => t !== "null");
 };
 
-/** A short, human-readable type label for a schema row. */
-export const typeLabel = (
-  schema: SchemaLike,
-  schemas: Record<string, SchemaLike>
-): string => {
+/**
+ * A short, human-readable type label for a schema row. `$ref`s label by name
+ * (`Pet`, `Pet[]`) without resolving — which also means circular refs through
+ * array items can't recurse forever.
+ */
+export const typeLabel = (schema: SchemaLike): string => {
   if (typeof schema.$ref === "string") {
     return refName(schema.$ref);
   }
   if (schema.oneOf || schema.anyOf) {
     const branches = schema.oneOf ?? schema.anyOf ?? [];
-    const labels = branches.map((branch) => typeLabel(branch, schemas));
+    const labels = branches.map((branch) => typeLabel(branch));
     return [...new Set(labels)].join(" | ") || "any";
   }
   if (schema.allOf) {
@@ -87,8 +88,7 @@ export const typeLabel = (
   }
   const types = nonNullTypes(schema.type);
   if (types.includes("array")) {
-    const item = resolveSchema(schemas, schema.items);
-    return `${typeLabel(item, schemas)}[]`;
+    return `${typeLabel(schema.items ?? {})}[]`;
   }
   const base = types[0] ?? (schema.properties ? "object" : "any");
   return schema.format ? `${base}<${schema.format}>` : base;
@@ -136,8 +136,17 @@ export const objectProperties = (
 ): { properties: [string, SchemaLike][]; required: Set<string> } => {
   const properties = new Map<string, SchemaLike>();
   const required = new Set<string>();
+  // Cycles can only enter through `$ref`s (inline JSON can't self-nest), so
+  // tracking visited refs is enough to stop circular allOf chains recursing.
+  const seen = new Set<string>();
 
   const collect = (node: SchemaLike): void => {
+    if (typeof node.$ref === "string") {
+      if (seen.has(node.$ref)) {
+        return;
+      }
+      seen.add(node.$ref);
+    }
     const resolved = resolveSchema(schemas, node);
     for (const name of resolved.required ?? []) {
       required.add(name);

package/src/components/openapi/snippets.ts

@@ -115,7 +115,9 @@ const curlSnippet = (sample: RequestSample): string => {
     ...headerLines(sample.headers, (key, value) => `  -H "${key}: ${value}"`),
   ];
   if (sample.body) {
-    lines.push(`  -d '${sample.body}'`);
+    // Close-quote/escaped-quote/reopen: the POSIX way to put a literal ' in a
+    // single-quoted string, so an example like "it's" doesn't break the shell.
+    lines.push(`  -d '${sample.body.replaceAll("'", String.raw`'\''`)}'`);
   }
   return lines.join(" \\\n");
 };
@@ -137,12 +139,23 @@ const fetchSnippet = (sample: RequestSample): string => {
   )}\n});`;
 };
 
+// Split-with-capture: odd segments are JSON string literals, kept verbatim so
+// a string *value* containing the words true/false/null isn't rewritten.
+const JSON_STRING = /(?<literal>"(?:\\.|[^"\\])*")/gu;
+
 /** Turn a JSON literal into an equivalent Python literal (`true` -> `True`). */
 const toPython = (json: string): string =>
   json
-    .replaceAll(/\btrue\b/gu, "True")
-    .replaceAll(/\bfalse\b/gu, "False")
-    .replaceAll(/\bnull\b/gu, "None");
+    .split(JSON_STRING)
+    .map((part, index) =>
+      index % 2 === 1
+        ? part
+        : part
+            .replaceAll(/\btrue\b/gu, "True")
+            .replaceAll(/\bfalse\b/gu, "False")
+            .replaceAll(/\bnull\b/gu, "None")
+    )
+    .join("");
 
 const pythonSnippet = (sample: RequestSample): string => {
   const args = [`    "${sample.url}"`];

package/src/core/builtin-tags.ts

@@ -8,6 +8,7 @@ export const BUILTIN_MDX_TAGS = new Set<string>([
   "Accordion",
   "AccordionItem",
   "ApiOverview",
+  "ApiTagOperations",
   "AutoTypeTable",
   "Badge",
   "Callout",
@@ -28,10 +29,7 @@ export const BUILTIN_MDX_TAGS = new Set<string>([
   "Math",
   "Operation",
   "Panel",
-  "ParamField",
   "Prompt",
-  "RequestField",
-  "ResponseField",
   "Step",
   "Steps",
   "Tab",

package/src/core/config.ts

@@ -1,7 +1,5 @@
 import { existsSync, readFileSync } from "node:fs";
 
-import { detectMintlifyBridge } from "./bridge.ts";
-import type { BridgeDetection } from "./bridge.ts";
 import { applyDeploymentEnv } from "./deployment-env.ts";
 import { BlumeError, diagnosticsFromZod } from "./diagnostics.ts";
 import { createModuleLoader } from "./load-module.ts";
@@ -16,20 +14,11 @@ import type { Diagnostic } from "./types.ts";
  */
 export const defineConfig = (config: BlumeConfig): BlumeConfig => config;
 
-/** Bridge mode info: a foreign docs tool Blume is serving without migrating. */
-export interface ConfigBridge {
-  tool: "mintlify";
-  /** Absolute path of the foreign config file (`docs.json`/`mint.json`). */
-  configFile: string;
-}
-
 /** Result of loading + validating a project config. */
 export interface ConfigLoadResult {
   config: ResolvedConfig;
   /** Absolute path of the config file used, or null when defaults were used. */
   configFile: string | null;
-  /** Set when a foreign docs config (e.g. Mintlify) is being bridged. */
-  bridge: ConfigBridge | null;
   diagnostics: Diagnostic[];
 }
 
@@ -50,9 +39,6 @@ export const loadConfig = async (
 ): Promise<ConfigLoadResult> => {
   const configFile = findConfigFile(root);
 
-  // With no Blume config, a Mintlify `docs.json` activates bridge mode: serve
-  // the unconverted project by synthesizing config + a `mintlify` content source.
-  let bridge: BridgeDetection | null = null;
   let raw: unknown = {};
   if (configFile) {
     try {
@@ -65,33 +51,36 @@ export const loadConfig = async (
         severity: "error",
       });
     }
-  } else {
-    bridge = await detectMintlifyBridge(root);
-    if (bridge) {
-      ({ raw } = bridge);
-    }
   }
 
-  const sourceFile = bridge?.configFile ?? configFile;
   const parsed = blumeConfigSchema.safeParse(raw ?? {});
   if (!parsed.success) {
     // Read the raw config text (when on disk) so errors carry a line/column.
     const source =
-      sourceFile && existsSync(sourceFile)
-        ? readFileSync(sourceFile, "utf-8")
+      configFile && existsSync(configFile)
+        ? readFileSync(configFile, "utf-8")
         : undefined;
     const diagnostics = diagnosticsFromZod(parsed.error, {
       code: "BLUME_CONFIG_INVALID",
-      file: sourceFile ?? undefined,
+      file: configFile ?? undefined,
       source,
     });
+    const [first, ...rest] = diagnostics;
+    const primary = first ?? {
+      code: "BLUME_CONFIG_INVALID",
+      file: configFile ?? undefined,
+      message: "Invalid Blume config.",
+      severity: "error" as const,
+    };
+    // Surface every issue in one failing run — reporting only the first turns
+    // a three-mistake config into three fix-rerun-fail loops.
     throw new BlumeError(
-      diagnostics[0] ?? {
-        code: "BLUME_CONFIG_INVALID",
-        file: sourceFile ?? undefined,
-        message: "Invalid Blume config.",
-        severity: "error",
-      }
+      rest.length > 0
+        ? {
+            ...primary,
+            message: `${primary.message}\n${rest.length} more config issue(s):\n${rest.map((d) => `  - ${d.message}`).join("\n")}`,
+          }
+        : primary
     );
   }
 
@@ -106,15 +95,12 @@ export const loadConfig = async (
   const ogEnabled = config.seo.og.enabled ?? Boolean(site);
 
   return {
-    bridge: bridge
-      ? { configFile: bridge.configFile, tool: bridge.tool }
-      : null,
     config: {
       ...config,
       deployment: { ...config.deployment, site },
       seo: { ...config.seo, og: { ...config.seo.og, enabled: ogEnabled } },
     },
-    configFile: sourceFile,
+    configFile,
     diagnostics: [],
   };
 };

package/src/core/data.ts

@@ -17,6 +17,8 @@ export interface BlumeLogo {
   dark?: string;
   alt: string;
   href: string;
+  /** Wordmark text beside the mark; `undefined` falls back to the site title. */
+  text?: string;
 }
 
 /** A favicon or apple-touch-icon: a link href plus an optional MIME type. */
@@ -93,8 +95,6 @@ export interface BlumeDataConfig {
   favicon: BlumeFavicon;
   feedback: boolean;
   i18n: BlumeDataI18n | null;
-  /** Default icon library for bare `icon` names. */
-  icons: ResolvedConfig["icons"];
   /** `markdown.imageZoom`: click-to-zoom content images. */
   imageZoom: boolean;
   logo: BlumeLogo | null;