blume 0.5.3 → 0.5.4

package/src/components/layout/NavTree.astro

@@ -129,13 +129,13 @@ const initialId =
             {panel.route ? (
               <a
                 aria-current={panel.route === currentRoute ? "page" : undefined}
-                class="min-w-0 flex-1 truncate font-semibold text-foreground text-sm hover:underline"
+                class="flex-1 truncate font-semibold text-foreground text-sm hover:underline"
                 href={panel.route}
               >
                 {panel.label}
               </a>
             ) : (
-              <span class="min-w-0 flex-1 truncate font-semibold text-foreground text-sm">
+              <span class="flex-1 truncate font-semibold text-foreground text-sm">
                 {panel.label}
               </span>
             )}
@@ -161,7 +161,7 @@ const initialId =
                 class="block rounded-[0.65rem] px-2.5 py-1.5 text-muted-foreground text-sm transition-colors hover:bg-muted hover:text-foreground aria-[current=page]:bg-muted aria-[current=page]:font-medium aria-[current=page]:text-foreground"
                 href={item.route}
               >
-                <span class="flex min-w-0 items-center gap-2">
+                <span class="flex items-center gap-2">
                   {item.icon && (
                     <Icon
                       class="shrink-0 text-muted-foreground"
@@ -169,7 +169,7 @@ const initialId =
                       size={14}
                     />
                   )}
-                  <span class="min-w-0 flex-1 truncate">{item.label}</span>
+                  <span class="flex-1 truncate">{item.label}</span>
                   {item.badge && <span class={badgeClassFor(item.badge)}>{item.badge}</span>}
                   {item.deprecated && (
                     <span class={deprecatedClass}>deprecated</span>
@@ -192,7 +192,7 @@ const initialId =
           return (
             <li class={spacing}>
               <button
-                class="flex w-full min-w-0 items-center gap-2 rounded-[0.65rem] px-2.5 py-1.5 text-left font-medium text-foreground text-sm transition-colors hover:bg-muted"
+                class="flex w-full items-center gap-2 rounded-[0.65rem] px-2.5 py-1.5 text-left font-medium text-foreground text-sm transition-colors hover:bg-muted"
                 data-nav-to={id}
                 type="button"
               >
@@ -203,7 +203,7 @@ const initialId =
                     size={14}
                   />
                 )}
-                <span class="min-w-0 flex-1 truncate">{item.label}</span>
+                <span class="flex-1 truncate">{item.label}</span>
                 {item.badge && <span class={badgeClassFor(item.badge)}>{item.badge}</span>}
                 <Icon
                   class="shrink-0 text-muted-foreground"
@@ -222,13 +222,13 @@ const initialId =
           return (
             <li class={spacing}>
               <details class="group" open={open}>
-                <summary class="mb-1 flex cursor-pointer list-none items-center gap-1.5 rounded-[0.65rem] px-2.5 py-1.5 font-medium text-foreground text-sm transition-colors hover:bg-muted [&::-webkit-details-marker]:hidden">
+                <summary class="flex cursor-pointer list-none items-center gap-1.5 rounded-[0.65rem] px-2.5 py-1.5 text-muted-foreground text-sm transition-colors hover:bg-muted hover:text-foreground [&::-webkit-details-marker]:hidden">
                   {item.route ? (
                     <a
                       aria-current={
                         item.route === currentRoute ? "page" : undefined
                       }
-                      class="-my-1 flex min-w-0 flex-1 items-center gap-1.5 rounded py-1 text-foreground transition-colors aria-[current=page]:font-semibold"
+                      class="-my-1 flex flex-1 items-center gap-1.5 rounded py-1 transition-colors aria-[current=page]:text-foreground aria-[current=page]:font-semibold"
                       href={item.route}
                     >
                       {item.icon && (
@@ -238,7 +238,7 @@ const initialId =
                           size={14}
                         />
                       )}
-                      <span class="min-w-0 flex-1 truncate">{item.label}</span>
+                      <span class="flex-1 truncate">{item.label}</span>
                       {item.badge && (
                         <span class={badgeClassFor(item.badge)}>{item.badge}</span>
                       )}
@@ -252,7 +252,7 @@ const initialId =
                           size={14}
                         />
                       )}
-                      <span class="min-w-0 flex-1 truncate">{item.label}</span>
+                      <span class="flex-1 truncate">{item.label}</span>
                       {item.badge && (
                         <span class={badgeClassFor(item.badge)}>{item.badge}</span>
                       )}
@@ -279,11 +279,11 @@ const initialId =
         // `flat` (default): a non-collapsible header with its items beneath.
         return (
           <li class={spacing}>
-            <p class="mb-2 flex min-w-0 items-center gap-1.5 px-2.5 font-medium text-foreground text-sm">
+            <p class="mb-2 flex items-center gap-1.5 px-2.5 font-medium text-foreground text-sm">
               {item.route ? (
                 <a
                   aria-current={item.route === currentRoute ? "page" : undefined}
-                  class="-ml-1 flex min-w-0 flex-1 items-center gap-1.5 rounded px-1 py-0.5 text-foreground transition-colors hover:bg-muted aria-[current=page]:bg-muted"
+                  class="-ml-1 flex flex-1 items-center gap-1.5 rounded px-1 py-0.5 text-foreground transition-colors hover:bg-muted aria-[current=page]:bg-muted"
                   href={item.route}
                 >
                   {item.icon && (
@@ -293,7 +293,7 @@ const initialId =
                       size={14}
                     />
                   )}
-                  <span class="min-w-0 truncate">{item.label}</span>
+                  <span class="truncate">{item.label}</span>
                   {item.badge && (
                     <span class={`ml-auto ${badgeClassFor(item.badge)}`}>{item.badge}</span>
                   )}
@@ -307,7 +307,7 @@ const initialId =
                       size={14}
                     />
                   )}
-                  <span class="min-w-0 truncate">{item.label}</span>
+                  <span class="truncate">{item.label}</span>
                   {item.badge && (
                     <span class={`ml-auto ${badgeClassFor(item.badge)}`}>{item.badge}</span>
                   )}

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
     >
@@ -459,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>`;
@@ -479,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>`;
@@ -494,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/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/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,30 +51,24 @@ 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: sourceFile ?? undefined,
+      file: configFile ?? undefined,
       message: "Invalid Blume config.",
       severity: "error" as const,
     };
@@ -115,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;

package/src/core/graph.ts

@@ -60,7 +60,7 @@ export const buildContentGraph = (
     }
 
     // Each locale gets an independent tree from its own pages and folder meta,
-    // so navigation may diverge per language (Mintlify-style).
+    // so navigation may diverge per language.
     for (const { code } of i18n.locales) {
       // Localize internal tab paths so a header tab points to its in-locale
       // route (e.g. `/docs` -> `/fr/docs`); external paths pass through.
@@ -89,7 +89,6 @@ export const buildContentGraph = (
       }
 
       navigationByLocale[code] = buildNavigation(localePages, {
-        chromeVariants: options.navigation.chromeVariants,
         folderMeta: options.folderMeta,
         // Meta files live in locale directories only under the `dir` parser
         // (`fr/guides/meta.ts` -> key `fr/guides`). Under `dot`, translations
@@ -105,14 +104,12 @@ export const buildContentGraph = (
       });
     }
     navigation = navigationByLocale[i18n.defaultLocale] ?? {
-      chromeVariants: [],
       selectors: [],
       sidebar: [],
       tabs: [],
     };
   } else {
     navigation = buildNavigation(pages, {
-      chromeVariants: options.navigation.chromeVariants,
       folderMeta: options.folderMeta,
       selectors: options.navigation.selectors,
       sharedFolderMeta: options.sharedFolderMeta,

package/src/core/links.ts

@@ -2,7 +2,6 @@ import { existsSync } from "node:fs";
 
 import { basename, join } from "pathe";
 
-import type { AssetMount } from "./assets.ts";
 import type {
   ContentGraph,
   Diagnostic,
@@ -38,25 +37,15 @@ interface ExternalRef extends LinkSite {
 /** Lookups derived once from the content graph. */
 interface LinkContext {
   anchors: Map<string, Set<string>>;
-  /** `content.assets` mounts served alongside `public/` (checked in place). */
-  assetMounts: AssetMount[];
   publicDir: string | null;
   /** Normalized `redirect.from` paths — valid targets that resolve at runtime. */
   redirects: Set<string>;
   routes: Set<string>;
 }
 
-/** Whether a resolved asset path exists under `public/` or an asset mount. */
-const assetIsPresent = (resolved: string, ctx: LinkContext): boolean => {
-  if (ctx.publicDir && existsSync(join(ctx.publicDir, resolved))) {
-    return true;
-  }
-  return ctx.assetMounts.some(
-    (mount) =>
-      (resolved === mount.url || resolved.startsWith(`${mount.url}/`)) &&
-      existsSync(join(mount.dir, resolved.slice(mount.url.length)))
-  );
-};
+/** Whether a resolved asset path exists under `public/`. */
+const assetIsPresent = (resolved: string, ctx: LinkContext): boolean =>
+  ctx.publicDir !== null && existsSync(join(ctx.publicDir, resolved));
 
 /** Outcome of classifying one link target. */
 type LinkResult = Diagnostic | "asset-unchecked" | null;
@@ -165,8 +154,8 @@ const checkPathLink = (
     if (assetIsPresent(resolved, ctx)) {
       return null;
     }
-    // Nowhere to look: no `public/` and no asset mounts configured.
-    if (ctx.publicDir === null && ctx.assetMounts.length === 0) {
+    // Nowhere to look: no `public/` directory.
+    if (ctx.publicDir === null) {
       return "asset-unchecked";
     }
     return {
@@ -347,15 +336,12 @@ export const validateLinks = async (
   options: {
     publicDir: string | null;
     checkExternal?: boolean;
-    /** `content.assets` mounts served alongside `public/`. */
-    assetMounts?: AssetMount[];
     /** Configured redirects; their `from` paths count as valid link targets. */
     redirects?: { from: string }[];
   }
 ): Promise<Diagnostic[]> => {
   const ctx: LinkContext = {
     anchors: buildAnchorIndex(graph.pages),
-    assetMounts: options.assetMounts ?? [],
     publicDir: options.publicDir,
     redirects: new Set(
       (options.redirects ?? []).map((redirect) => toRoute(redirect.from))

package/src/core/meta.ts

@@ -39,7 +39,7 @@ export const discoverFolderMeta = async (
     absolute: true,
     cwd: contentRoot,
     // Never descend into dependencies or build output — relevant when the
-    // content root is the project root (e.g. a migrated Mintlify project).
+    // content root is the project root (e.g. a `.`-rooted or all-staged project).
     ignore: ["**/node_modules/**", "**/.blume/**", "**/dist/**"],
     onlyFiles: true,
   });