blume 0.5.3 → 0.5.4

package/src/astro/templates.ts

@@ -4,7 +4,6 @@ import { dirname, isAbsolute, join, relative } from "pathe";
 
 import { askBackendRuntimeDep } from "../ai/ask.ts";
 import type { AskBackend } from "../ai/ask.ts";
-import { resolveAssetMounts } from "../core/assets.ts";
 import type { ResolvedConfig } from "../core/schema.ts";
 import type { ProjectContext } from "../core/types.ts";
 import { hasScalarReferences } from "../openapi/references.ts";
@@ -313,12 +312,10 @@ export const astroConfigTemplate = (options: {
   if (needsSvelte) {
     integrations.push("svelte()");
   }
-  // Always mounted: injects user pages (a no-op when there are none), serves
-  // `content.assets` mounts, and wires up dev-server `Accept: text/markdown`
-  // negotiation over the content routes.
-  const assets = resolveAssetMounts(context.root, config.content.assets);
+  // Always mounted: injects user pages (a no-op when there are none) and wires
+  // up dev-server `Accept: text/markdown` negotiation over the content routes.
   integrations.push(
-    `blumeIntegration(${JSON.stringify({ assets, base: deployment.base, contentRoutes, pages })})`
+    `blumeIntegration(${JSON.stringify({ base: deployment.base, contentRoutes, pages })})`
   );
 
   return `// Generated by Blume. Do not edit; this file is recreated on each run.
@@ -403,8 +400,8 @@ export const contentConfigTemplate = (options: {
   stagedBase?: string;
   /**
    * Whether any filesystem (non-staged) source feeds the `docs` collection.
-   * When false (e.g. Mintlify bridge mode, where every page is staged), the
-   * collection globs nothing — see below.
+   * When false (e.g. an all-staged project where every page is materialized by
+   * a non-filesystem source), the collection globs nothing — see below.
    */
   filesystem?: boolean;
 }): string => {
@@ -423,8 +420,8 @@ export const contentConfigTemplate = (options: {
 
   // With no filesystem source, no route renders through `docs`, so glob nothing.
   // Beyond skipping wasted work, this is the only thing that keeps Astro's
-  // content-layer *watcher* out of `.blume/`: bridge mode roots the collection
-  // at the project dir (which contains `.blume/.astro/fonts`, rewritten on every
+  // content-layer *watcher* out of `.blume/`: an all-staged project roots the
+  // collection at the project dir (which contains `.blume/.astro/fonts`, rewritten on every
   // request), and the watcher's match test is `picomatch.isMatch(path, pattern)`
   // — with array-OR semantics, any `!ignored/**` negation *matches* unrelated
   // files, so negative patterns can't exclude a subtree there. An empty pattern
@@ -980,10 +977,7 @@ import FileTree from "blume/components/content/FileTree.astro";
 import Frame from "blume/components/content/Frame.astro";
 import GithubInfo from "blume/components/content/GithubInfo.astro";
 import Panel from "blume/components/content/Panel.astro";
-import ParamField from "blume/components/content/ParamField.astro";
 import Prompt from "blume/components/content/Prompt.astro";
-import RequestField from "blume/components/content/RequestField.astro";
-import ResponseField from "blume/components/content/ResponseField.astro";
 import Step from "blume/components/content/Step.astro";
 import Steps from "blume/components/content/Steps.astro";
 import Tab from "blume/components/content/Tab.astro";
@@ -998,6 +992,7 @@ import Visibility from "blume/components/content/Visibility.astro";
 import YouTube from "blume/components/content/YouTube.astro";
 import Icon from "blume/components/Icon.astro";
 import ApiOverview from "blume/components/openapi/ApiOverview.astro";
+import ApiTagOperations from "blume/components/openapi/ApiTagOperations.astro";
 import Operation from "blume/components/openapi/Operation.astro";
 ${mathImport}import { mdxComponents as userMdx, layoutOverrides } from "../generated/components.ts";
 import { islandComponents } from "../generated/islands.ts";
@@ -1016,6 +1011,7 @@ const components = {
   Accordion,
   AccordionItem,
   ApiOverview,
+  ApiTagOperations,
   AutoTypeTable,
   Badge,
   Callout,
@@ -1035,10 +1031,7 @@ const components = {
   Icon,
   Operation,
   Panel,
-  ParamField,
   Prompt,
-  RequestField,
-  ResponseField,
   Step,
   Steps,
   Tab,

package/src/cli/commands/dev.ts

@@ -56,12 +56,6 @@ export const devCommand = defineCommand({
       strict: args.strict,
     });
 
-    if (project.bridge) {
-      logger.info(
-        'Detected docs.json — running in Mintlify bridge mode (no migration). Run "blume migrate mintlify" to convert permanently.'
-      );
-    }
-
     // Claim the shared `.blume` dir so a concurrent build/eject/sync refuses
     // rather than regenerating or deleting it out from under this server. A
     // second dev server would fight over the same generated tree the same

package/src/cli/commands/validate.ts

@@ -3,7 +3,6 @@ import { existsSync } from "node:fs";
 import { defineCommand } from "citty";
 import { join } from "pathe";
 
-import { resolveAssetMounts } from "../../core/assets.ts";
 import { BlumeError } from "../../core/diagnostics.ts";
 import { validateLinks } from "../../core/links.ts";
 import { scanProject } from "../../core/project-graph.ts";
@@ -48,7 +47,6 @@ export const validateCommand = defineCommand({
       const publicDir = join(root, "public");
       diagnostics.push(
         ...(await validateLinks(project.graph, {
-          assetMounts: resolveAssetMounts(root, project.config.content.assets),
           checkExternal: Boolean(args.external),
           publicDir: existsSync(publicDir) ? publicDir : null,
           redirects: project.config.redirects,

package/src/cli/index.ts

@@ -8,7 +8,6 @@ import { devCommand } from "./commands/dev.ts";
 import { doctorCommand } from "./commands/doctor.ts";
 import { ejectCommand } from "./commands/eject.ts";
 import { initCommand } from "./commands/init.ts";
-import { migrateCommand } from "./commands/migrate.ts";
 import { previewCommand } from "./commands/preview.ts";
 import { syncCommand } from "./commands/sync.ts";
 import { validateCommand } from "./commands/validate.ts";
@@ -29,7 +28,6 @@ const main = defineCommand({
     doctor: doctorCommand,
     eject: ejectCommand,
     init: initCommand,
-    migrate: migrateCommand,
     preview: previewCommand,
     sync: syncCommand,
     validate: validateCommand,

package/src/components/BlumePage.astro

@@ -38,10 +38,7 @@ import FileTree from "./content/FileTree.astro";
 import Frame from "./content/Frame.astro";
 import GithubInfo from "./content/GithubInfo.astro";
 import Panel from "./content/Panel.astro";
-import ParamField from "./content/ParamField.astro";
 import Prompt from "./content/Prompt.astro";
-import RequestField from "./content/RequestField.astro";
-import ResponseField from "./content/ResponseField.astro";
 import Step from "./content/Step.astro";
 import Steps from "./content/Steps.astro";
 import Tab from "./content/Tab.astro";
@@ -90,10 +87,7 @@ const components = {
   GithubInfo,
   Icon,
   Panel,
-  ParamField,
   Prompt,
-  RequestField,
-  ResponseField,
   Step,
   Steps,
   Tab,

package/src/components/Icon.astro

@@ -1,13 +1,9 @@
 ---
-import data from "blume:data";
 import { resolveIcon } from "../theme/icons.ts";
 
 interface Props {
   name?: unknown;
   icon?: unknown;
-  iconType?: string;
-  /** Icon library for a bare name; defaults to the project's `icons.library`. */
-  library?: string;
   size?: number;
   class?: string;
   className?: string;
@@ -18,8 +14,6 @@ interface Props {
 const {
   color,
   icon,
-  iconType,
-  library,
   name,
   size = 16,
   class: astroClass,
@@ -41,12 +35,7 @@ const isImageIcon = (value: string): boolean =>
   /\.(?:avif|gif|jpe?g|png|svg|webp)$/iu.test(value);
 const imageSrc = iconName && !rawSvg && isImageIcon(iconName) ? iconName : null;
 const resolvedIcon =
-  iconName && !(imageSrc || rawSvg)
-    ? resolveIcon(iconName, {
-        iconType,
-        library: library ?? data.config.icons.library,
-      })
-    : null;
+  iconName && !(imageSrc || rawSvg) ? resolveIcon(iconName) : null;
 const resolvedClass = astroClass ?? className;
 const customStyle = `display:inline-flex;width:${size}px;height:${size}px;${
   color ? `color:${color}` : ""

package/src/components/content/AccordionItem.astro

@@ -7,11 +7,9 @@ interface Props {
   defaultOpen?: boolean;
   id?: string;
   icon?: string;
-  iconType?: string;
 }
 
-const { defaultOpen = false, description, icon, iconType, id, title } =
-  Astro.props;
+const { defaultOpen = false, description, icon, id, title } = Astro.props;
 const slugify = (value: string): string =>
   value
     .toLowerCase()
@@ -32,18 +30,17 @@ const accordionId = id ?? slugify(title);
   <summary
     class="flex cursor-pointer list-none items-center justify-between p-4 font-medium [&::-webkit-details-marker]:hidden"
   >
-    <span class="flex min-w-0 items-start gap-2">
+    <span class="flex items-start gap-2">
       {
         icon && (
           <Icon
             class="mt-0.5 shrink-0 text-muted-foreground"
-            iconType={iconType}
             name={icon}
             size={16}
           />
         )
       }
-      <span class="min-w-0">
+      <span>
         <span class="block">{title}</span>
         {
           description && (

package/src/components/content/Badge.astro

@@ -10,7 +10,6 @@ interface Props {
   color?: string;
   disabled?: boolean | string;
   icon?: unknown;
-  iconType?: string;
   shape?: BadgeShape;
   size?: BadgeSize;
   stroke?: boolean | string;
@@ -23,7 +22,6 @@ const {
   color,
   disabled = false,
   icon,
-  iconType,
   shape = "rounded",
   size = "md",
   stroke = false,
@@ -119,6 +117,6 @@ const customStyle = customColor
   style={customStyle}
   title={tooltip}
 >
-  {icon && <Icon icon={icon} iconType={iconType} size={iconSize[size]} />}
+  {icon && <Icon icon={icon} size={iconSize[size]} />}
   <slot />
 </span>

package/src/components/content/Callout.astro

@@ -14,11 +14,10 @@ interface Props {
   type?: CalloutType;
   title?: string;
   icon?: unknown;
-  iconType?: string;
   color?: string;
 }
 
-const { color, icon, iconType, type = "info", title } = Astro.props;
+const { color, icon, type = "info", title } = Astro.props;
 
 const iconByType: Record<CalloutType, string> = {
   check: "circle-check",
@@ -59,14 +58,9 @@ const iconClass: Record<CalloutType, string> = {
   style={color ? `border:1px solid ${color};color:${color}` : undefined}
 >
   <span class:list={["mt-0.5 shrink-0", color ? "" : iconClass[type]]}>
-    <Icon
-      color={color}
-      icon={icon ?? iconByType[type]}
-      iconType={iconType}
-      size={16}
-    />
+    <Icon color={color} icon={icon ?? iconByType[type]} size={16} />
   </span>
-  <div class="min-w-0 flex-1 [&>:first-child]:mt-0! [&>:last-child]:mb-0!">
+  <div class="flex-1 [&>:first-child]:mt-0! [&>:last-child]:mb-0!">
     {title && <p class="mb-1 font-semibold text-foreground">{title}</p>}
     <slot />
   </div>

package/src/components/content/Card.astro

@@ -5,7 +5,6 @@ interface Props {
   title?: string;
   href?: string;
   icon?: string;
-  iconType?: string;
   img?: string;
   horizontal?: boolean | string;
   cta?: string;
@@ -14,7 +13,7 @@ interface Props {
   color?: string;
 }
 
-const { arrow, color, cta, horizontal, href, icon, iconType, img, title, type } =
+const { arrow, color, cta, horizontal, href, icon, img, title, type } =
   Astro.props;
 const Tag = href ? "a" : "div";
 const external = href?.startsWith("http");
@@ -75,7 +74,7 @@ const variantClass = {
   {
     iconName && (
       <div class:list={["mb-2.5", color ? "" : type ? iconClass[type] : "text-accent"]}>
-        <Icon color={color} iconType={iconType} name={iconName} size={20} />
+        <Icon color={color} name={iconName} size={20} />
       </div>
     )
   }

package/src/components/content/ColorItem.astro

@@ -21,7 +21,7 @@ const displayValue =
 
 <button
   aria-label={`Copy ${name} color ${displayValue}`}
-  class="group flex w-full min-w-0 cursor-pointer flex-col gap-2.5 text-center focus:outline-none"
+  class="group flex w-full cursor-pointer flex-col gap-2.5 text-center focus:outline-none"
   data-blume-color-copy={displayValue}
   style={`--blume-color-light:${lightValue};--blume-color-dark:${darkValue};`}
   type="button"
@@ -32,7 +32,7 @@ const displayValue =
     style="background:var(--blume-color-light)"
   >
   </span>
-  <span class="block min-w-0 leading-tight">
+  <span class="block leading-tight">
     <span class="block truncate font-semibold text-foreground text-sm">
       {name}
     </span>

package/src/components/content/Column.astro

@@ -1,6 +1,6 @@
 ---
 ---
 
-<div class="min-w-0">
+<div>
   <slot />
 </div>

package/src/components/content/Prompt.astro

@@ -45,7 +45,7 @@ const secondaryButton =
 >
   <div class="flex items-center justify-between gap-3 px-4 py-3">
     <p
-      class="m-0! min-w-0 text-foreground text-sm [&_a]:font-medium [&_a]:text-foreground [&_a]:underline [&_code]:rounded [&_code]:bg-muted [&_code]:px-1 [&_strong]:font-semibold [&_strong]:text-foreground"
+      class="m-0! text-foreground text-sm [&_a]:font-medium [&_a]:text-foreground [&_a]:underline [&_code]:rounded [&_code]:bg-muted [&_code]:px-1 [&_strong]:font-semibold [&_strong]:text-foreground"
       data-blume-prompt-description
       set:html={descriptionHtml}
     />

package/src/components/content/Step.astro

@@ -4,11 +4,10 @@ import { hasIcon } from "../../theme/icons.ts";
 
 interface Props {
   icon?: string;
-  iconType?: string;
   title?: string;
 }
 
-const { icon, iconType, title } = Astro.props;
+const { icon, title } = Astro.props;
 const markerClass =
   "absolute top-0 -start-[2.75rem] flex size-6 items-center justify-center rounded-full bg-accent text-center font-semibold text-accent-foreground text-xs";
 const isImageIcon = (value: string): boolean =>
@@ -18,14 +17,14 @@ const canRenderIcon =
   icon !== undefined &&
   (/^\s*<svg[\s\S]*<\/svg>\s*$/u.test(icon) ||
     isImageIcon(icon) ||
-    hasIcon(icon, { iconType }));
+    hasIcon(icon));
 ---
 
 <div
   class="relative [counter-increment:blume-step]"
 >
   <span class:list={[markerClass, !canRenderIcon && "before:[content:counter(blume-step)]"]}>
-    {canRenderIcon && <Icon iconType={iconType} name={icon} size={14} />}
+    {canRenderIcon && <Icon name={icon} size={14} />}
   </span>
   {title && <p class="mb-1.5 font-semibold">{title}</p>}
   <div class="[&>:first-child]:mt-0! [&>:last-child]:mb-0!">

package/src/components/content/Tab.astro

@@ -4,13 +4,12 @@ import Icon from "../Icon.astro";
 interface Props {
   class?: string;
   icon?: string;
-  iconType?: string;
   id?: string;
   style?: string;
   title: string;
 }
 
-const { class: className, icon, iconType, id, style, title } = Astro.props;
+const { class: className, icon, id, style, title } = Astro.props;
 const slugify = (value: string): string =>
   value
     .toLowerCase()
@@ -39,7 +38,7 @@ const tabId = id ?? slugify(title);
   {
     icon && (
       <template data-blume-tab-icon>
-        <Icon class="shrink-0" iconType={iconType} name={icon} size={14} />
+        <Icon class="shrink-0" name={icon} size={14} />
       </template>
     )
   }

package/src/components/content/TypeTable.astro

@@ -37,19 +37,19 @@ const columns = "grid grid-cols-[1fr_2fr_auto] items-center gap-4";
         {entries.map(([name, info]) => (
         <details class="group/tt border-border border-t [[open]+&]:border-t-transparent open:rounded-blume open:border-transparent open:bg-background open:shadow-sm open:ring-1 open:ring-border">
           <summary class={`${columns} cursor-pointer list-none px-3 py-2.5 [&::-webkit-details-marker]:hidden`}>
-            <code class="min-w-0 break-words font-mono text-accent text-xs">
+            <code class="break-words font-mono text-accent text-xs">
               {name}
               {info.required ? "" : "?"}
             </code>
             {info.typeDescriptionLink ? (
               <a
-                class="min-w-0 break-words font-mono text-foreground text-xs underline-offset-2 hover:underline"
+                class="break-words font-mono text-foreground text-xs underline-offset-2 hover:underline"
                 href={info.typeDescriptionLink}
               >
                 {info.type}
               </a>
             ) : (
-              <code class="min-w-0 break-words font-mono text-foreground text-xs">
+              <code class="break-words font-mono text-foreground text-xs">
                 {info.type}
               </code>
             )}
@@ -81,7 +81,7 @@ const columns = "grid grid-cols-[1fr_2fr_auto] items-center gap-4";
             <div class="space-y-1.5">
               <div class={columns}>
                 <span class="text-muted-foreground">Type</span>
-                <code class="min-w-0 break-words font-mono text-foreground">
+                <code class="break-words font-mono text-foreground">
                   {info.type}
                 </code>
                 <span aria-hidden="true" class="size-3.5" />
@@ -89,7 +89,7 @@ const columns = "grid grid-cols-[1fr_2fr_auto] items-center gap-4";
               {info.default && (
                 <div class={columns}>
                   <span class="text-muted-foreground">Default</span>
-                  <code class="min-w-0 break-words font-mono text-foreground">
+                  <code class="break-words font-mono text-foreground">
                     {info.default}
                   </code>
                   <span aria-hidden="true" class="size-3.5" />

package/src/components/content/Update.astro

@@ -60,7 +60,7 @@ const tagList = Array.isArray(tags) ? tags : tags ? [tags] : [];
       )
     }
   </header>
-  <div class="min-w-0 text-muted-foreground text-sm leading-6 [&_a]:font-medium [&_a]:text-foreground [&_a]:underline [&_code]:rounded [&_code]:bg-muted [&_code]:px-1 [&_h2]:mt-0! [&_h2]:border-t-0! [&_h2]:pt-0! [&_h2]:text-base [&_h2]:font-semibold [&_h2]:text-foreground [&_h3]:font-semibold [&_h3]:text-foreground [&_img]:rounded-blume [&_li]:my-1 [&_p:first-child]:mt-0! [&_p:last-child]:mb-0!">
+  <div class="text-muted-foreground text-sm leading-6 [&_a]:font-medium [&_a]:text-foreground [&_a]:underline [&_code]:rounded [&_code]:bg-muted [&_code]:px-1 [&_h2]:mt-0! [&_h2]:border-t-0! [&_h2]:pt-0! [&_h2]:text-base [&_h2]:font-semibold [&_h2]:text-foreground [&_h3]:font-semibold [&_h3]:text-foreground [&_img]:rounded-blume [&_li]:my-1 [&_p:first-child]:mt-0! [&_p:last-child]:mb-0!">
     <slot />
   </div>
 </article>

package/src/components/layout/Header.astro

@@ -18,6 +18,7 @@ interface Props {
     dark?: string;
     alt: string;
     href: string;
+    text?: string;
   } | null;
   navigation: Navigation;
   route: string;
@@ -57,6 +58,19 @@ const {
 const LogoSlot = resolveSlot(layout.Logo, Logo);
 const SearchSlot = resolveSlot(layout.Search, Search);
 
+// The mobile nav-toggle opens a drawer of navigation. On docs pages that drawer
+// is the sidebar tree (`hasSidebar`); on chrome-only pages (a landing page via
+// PageLayout) it's a tabs-only drawer the layout renders — so the button is also
+// needed whenever there are tabs to reveal.
+const showNavToggle = hasSidebar || navigation.tabs.length > 0;
+// Where the header's inline tab bar appears. With a sidebar it shares the `md`
+// breakpoint with the docs drawer; without one, the tabs-only drawer is the sole
+// mobile nav below `lg`, so the inline tabs wait until `lg` to avoid duplicating
+// the drawer's links between `md` and `lg`.
+const tabsNavClass = hasSidebar
+  ? "hidden gap-1 md:flex"
+  : "hidden gap-1 lg:flex";
+
 const iconButton =
   "inline-flex size-9 cursor-pointer items-center justify-center rounded-full text-muted-foreground transition-colors hover:bg-muted hover:text-foreground";
 
@@ -68,14 +82,23 @@ const iconButton =
 // styles fade while the non-animated ones snap, so we disable all transitions
 // for the swap (next-themes' disableTransitionOnChange trick), force a
 // synchronous style flush, then restore them on the next tick.
-const clickScript = `document.addEventListener("click",(e)=>{const t=e.target.closest("[data-blume-theme-toggle]");if(t){const d=document.documentElement;const next=d.dataset.theme==="dark"?"light":"dark";const s=document.createElement("style");s.appendChild(document.createTextNode("*,*::before,*::after{transition:none!important}"));document.head.appendChild(s);d.dataset.theme=next;localStorage.setItem("blume-theme",next);window.getComputedStyle(d).opacity;setTimeout(()=>document.head.removeChild(s),1);}const n=e.target.closest("[data-blume-nav-toggle]");if(n){document.documentElement.toggleAttribute("data-blume-nav-open");}const b=e.target.closest("[data-blume-banner-dismiss]");if(b){const bar=b.closest("[data-blume-banner]");const k=bar&&bar.getAttribute("data-banner-key");if(k){localStorage.setItem("blume-banner:"+k,"1");}document.documentElement.setAttribute("data-blume-banner-hidden","");}});`;
+//
+// The mobile drawer sits below the sticky header, but the banner above the
+// header has no fixed height (its text wraps), so the drawer's top offset can't
+// be static: on open we measure the header's on-screen bottom edge into
+// `--blume-drawer-top` (read by the drawer's `top`/`height`), lock page scroll
+// so the offset can't drift while open, and re-measure when a banner dismiss or
+// a resize/rotation moves the header. Crossing into the desktop breakpoint
+// (64rem, Tailwind `lg`) closes the drawer so the scroll lock can't outlive it.
+const clickScript = `(()=>{const dr=()=>{const h=document.querySelector("[data-blume-header]");if(h){document.documentElement.style.setProperty("--blume-drawer-top",h.getBoundingClientRect().bottom+"px");}};document.addEventListener("click",(e)=>{const t=e.target.closest("[data-blume-theme-toggle]");if(t){const d=document.documentElement;const next=d.dataset.theme==="dark"?"light":"dark";const s=document.createElement("style");s.appendChild(document.createTextNode("*,*::before,*::after{transition:none!important}"));document.head.appendChild(s);d.dataset.theme=next;localStorage.setItem("blume-theme",next);window.getComputedStyle(d).opacity;setTimeout(()=>document.head.removeChild(s),1);}const n=e.target.closest("[data-blume-nav-toggle]");if(n){const d=document.documentElement;const open=d.toggleAttribute("data-blume-nav-open");if(open){dr();}d.style.overflow=open?"hidden":"";}const b=e.target.closest("[data-blume-banner-dismiss]");if(b){const bar=b.closest("[data-blume-banner]");const k=bar&&bar.getAttribute("data-banner-key");if(k){localStorage.setItem("blume-banner:"+k,"1");}document.documentElement.setAttribute("data-blume-banner-hidden","");requestAnimationFrame(dr);}});addEventListener("resize",()=>{const d=document.documentElement;if(!d.hasAttribute("data-blume-nav-open")){return;}if(matchMedia("(min-width:64rem)").matches){d.removeAttribute("data-blume-nav-open");d.style.overflow="";}else{dr();}});})();`;
 ---
 
 <header
   class="sticky top-0 z-40 flex h-16 items-center gap-3 bg-background/90 px-4 backdrop-blur md:px-6"
+  data-blume-header
 >
   {
-    hasSidebar && (
+    showNavToggle && (
       <button
         aria-label="Toggle navigation"
         class={`${iconButton} lg:hidden`}
@@ -98,7 +121,7 @@ const clickScript = `document.addEventListener("click",(e)=>{const t=e.target.cl
   }
   {
     navigation.tabs.length > 0 && (
-      <nav aria-label="Sections" class="hidden gap-1 md:flex">
+      <nav aria-label="Sections" class={tabsNavClass}>
         {navigation.tabs.map((tab) => (
           <a
             aria-current={

package/src/components/layout/Logo.astro

@@ -19,6 +19,10 @@ const logoLight = logo?.light;
 const logoDark = logo?.dark ?? logo?.light;
 const logoAlt = logo?.alt ?? "";
 const brandHref = logo?.href ?? "/";
+// Wordmark beside the mark: the configured `logo.text`, or the site title when
+// it's omitted. An explicit `""` hides it (an image-only logo whose mark already
+// carries the wordmark).
+const brandText = logo?.text ?? site.title;
 ---
 
 <a
@@ -46,5 +50,5 @@ const brandHref = logo?.href ?? "/";
         </>
       ))
   }
-  {site.title}
+  {brandText && <span>{brandText}</span>}
 </a>

package/src/components/layout/NavSelector.astro

@@ -1,5 +1,5 @@
 ---
-// A top-level navigation selector (Mintlify-style): a dropdown that switches
+// A top-level navigation selector: a dropdown that switches
 // between partitions of the site — a product, a version, or any grouped set of
 // destinations (`navigation.selectors` in the config). Zero-JS, built on
 // <details>/<summary> like the language switcher.