npm - blume - Versions diffs - 0.5.2 → 0.5.4 - Mend

blume 0.5.2 → 0.5.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (137) hide show

package/dist/cli/index.js +2235 -5942
package/dist/cli/index.js.map +36 -65
package/dist/types/core/config.d.ts +0 -8
package/dist/types/core/data.d.ts +2 -2
package/dist/types/core/schema.d.ts +58 -453
package/dist/types/core/types.d.ts +1 -7
package/docs/advanced/meta.ts +1 -8
package/docs/advanced/skills.mdx +28 -0
package/docs/configuration/ai.mdx +3 -1
package/docs/configuration/index.mdx +13 -17
package/docs/configuration/theming.mdx +3 -11
package/docs/content/components.mdx +2 -53
package/docs/content/i18n.mdx +1 -5
package/docs/content/sources.mdx +1 -1
package/docs/content/syntax.mdx +1 -1
package/docs/index.mdx +0 -1
package/docs/reference/cli.mdx +12 -13
package/package.json +4 -6
package/skills/blume/SKILL.md +71 -0
package/skills/blume-update-docs/SKILL.md +52 -0
package/skills/blume-update-docs/references/audit-checklist.md +46 -0
package/src/ai/mcp/discovery.ts +3 -1
package/src/ai/mcp/server.ts +3 -1
package/src/astro/component-slots.ts +10 -2
package/src/astro/generate.ts +15 -12
package/src/astro/integration.ts +0 -21
package/src/astro/templates.ts +62 -37
package/src/cli/coalesce.ts +43 -0
package/src/cli/commands/dev.ts +30 -22
package/src/cli/commands/validate.ts +0 -2
package/src/cli/dev-lock.ts +4 -2
package/src/cli/index.ts +0 -2
package/src/components/BlumePage.astro +0 -6
package/src/components/Icon.astro +1 -12
package/src/components/content/AccordionItem.astro +3 -6
package/src/components/content/Badge.astro +1 -3
package/src/components/content/Callout.astro +3 -9
package/src/components/content/Card.astro +2 -3
package/src/components/content/ColorItem.astro +8 -5
package/src/components/content/Column.astro +1 -1
package/src/components/content/Prompt.astro +8 -4
package/src/components/content/Step.astro +3 -4
package/src/components/content/Tab.astro +2 -3
package/src/components/content/Tabs.astro +13 -2
package/src/components/content/TypeTable.astro +5 -5
package/src/components/content/Update.astro +1 -1
package/src/components/content/mermaid-element.ts +20 -2
package/src/components/islands/ask-ai.tsx +4 -8
package/src/components/islands/base-path.ts +30 -0
package/src/components/islands/hooks.ts +12 -8
package/src/components/layout/Header.astro +26 -3
package/src/components/layout/Logo.astro +5 -1
package/src/components/layout/NavSelector.astro +1 -1
package/src/components/layout/NavTree.astro +14 -14
package/src/components/layout/PageActions.astro +17 -11
package/src/components/layout/PageLayout.astro +42 -0
package/src/components/layout/ReferenceLayout.astro +1 -0
package/src/components/layout/RootLayout.astro +31 -2
package/src/components/layout/Search.astro +9 -6
package/src/components/layout/nav-utils.ts +9 -4
package/src/components/layout/search/types.ts +16 -5
package/src/components/openapi/ApiOverview.astro +4 -50
package/src/components/openapi/ApiTagOperations.astro +42 -0
package/src/components/openapi/ParametersTable.astro +1 -1
package/src/components/openapi/SchemaProperty.astro +1 -1
package/src/components/openapi/SchemaTable.astro +3 -3
package/src/components/openapi/helpers.ts +17 -8
package/src/components/openapi/snippets.ts +17 -4
package/src/core/builtin-tags.ts +1 -3
package/src/core/config.ts +19 -33
package/src/core/data.ts +2 -2
package/src/core/graph.ts +7 -5
package/src/core/links.ts +5 -19
package/src/core/meta.ts +1 -1
package/src/core/navigation.ts +5 -6
package/src/core/project-graph.ts +0 -5
package/src/core/schema.ts +13 -90
package/src/core/sources/filesystem.ts +19 -1
package/src/core/sources/mdx-remote.ts +20 -4
package/src/core/sources/normalize.ts +28 -6
package/src/core/sources/resolve.ts +0 -13
package/src/core/sources/watch.ts +45 -0
package/src/core/types.ts +1 -8
package/src/markdown/code-title.ts +6 -3
package/src/markdown/package-install.ts +3 -1
package/src/og/card.ts +16 -4
package/src/openapi/parse.ts +197 -14
package/src/openapi/render-mdx.ts +54 -11
package/src/openapi/source.ts +19 -2
package/src/search/sync/orama-cloud.ts +2 -0
package/src/search/sync/typesense.ts +4 -0
package/src/theme/entry.ts +45 -17
package/src/theme/icons.ts +22 -104
package/src/theme/palette.ts +35 -47
package/src/theme/twoslash.ts +6 -1
package/dist/types/core/bridge.d.ts +0 -24
package/dist/types/migrate/mintlify/assets.d.ts +0 -8
package/dist/types/migrate/mintlify/config.d.ts +0 -16
package/dist/types/migrate/mintlify/i18n.d.ts +0 -7
package/docs/advanced/bridge.mdx +0 -76
package/docs/advanced/migrate.mdx +0 -123
package/src/astro/static-assets.ts +0 -117
package/src/cli/commands/migrate.ts +0 -39
package/src/components/content/ApiField.astro +0 -75
package/src/components/content/ParamField.astro +0 -39
package/src/components/content/RequestField.astro +0 -23
package/src/components/content/ResponseField.astro +0 -23
package/src/components/content/Warning.astro +0 -9
package/src/core/assets.ts +0 -31
package/src/core/bridge.ts +0 -102
package/src/core/sources/mintlify.ts +0 -204
package/src/migrate/fumadocs/config.ts +0 -155
package/src/migrate/fumadocs/content.ts +0 -378
package/src/migrate/fumadocs/frontmatter.ts +0 -18
package/src/migrate/fumadocs/groups.ts +0 -237
package/src/migrate/fumadocs/index.ts +0 -340
package/src/migrate/fumadocs/meta.ts +0 -244
package/src/migrate/migrate.ts +0 -53
package/src/migrate/mintlify/assets.ts +0 -46
package/src/migrate/mintlify/config.ts +0 -958
package/src/migrate/mintlify/content.ts +0 -120
package/src/migrate/mintlify/frontmatter.ts +0 -126
package/src/migrate/mintlify/i18n.ts +0 -51
package/src/migrate/mintlify/icons.ts +0 -128
package/src/migrate/mintlify/index.ts +0 -372
package/src/migrate/mintlify/snippets.ts +0 -306
package/src/migrate/mintlify/transform.ts +0 -82
package/src/migrate/nextra/content.ts +0 -46
package/src/migrate/nextra/frontmatter.ts +0 -40
package/src/migrate/nextra/index.ts +0 -374
package/src/migrate/nextra/meta.ts +0 -266
package/src/migrate/shared.ts +0 -728
package/src/migrate/starlight/config.ts +0 -455
package/src/migrate/starlight/content.ts +0 -78
package/src/migrate/starlight/frontmatter.ts +0 -111
package/src/migrate/starlight/i18n.ts +0 -54
package/src/migrate/starlight/index.ts +0 -131

package/src/components/content/ColorItem.astro CHANGED Viewed

@@ -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>
@@ -46,7 +46,8 @@ const displayValue =
 </button>
 <style>
-  :global(.dark) [data-blume-color-swatch] {
+  /* Dark mode is data-theme="dark" on <html> (see theme/entry.ts), not a class. */
+  :global([data-theme="dark"]) [data-blume-color-swatch] {
     background: var(--blume-color-dark, var(--blume-color-light));
   }
 </style>
@@ -77,10 +78,12 @@ const displayValue =
         return;
       }
-      const original = status.textContent;
+      // Remember the real value once — capturing at click time would capture
+      // "Copied" on a double-click and stick until reload.
+      status.dataset.blumeLabel ??= status.textContent ?? "";
       status.textContent = "Copied";
       window.setTimeout(() => {
-        status.textContent = original;
+        status.textContent = status.dataset.blumeLabel ?? "";
       }, 1500);
     });
   }

package/src/components/content/Column.astro CHANGED Viewed

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

package/src/components/content/Prompt.astro CHANGED Viewed

@@ -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}
     />
@@ -110,14 +110,18 @@ const secondaryButton =
           return;
         }
-        const label = copy.querySelector("[data-blume-prompt-copy-label]");
+        const label = copy.querySelector<HTMLElement>(
+          "[data-blume-prompt-copy-label]"
+        );
         if (!label) {
           return;
         }
-        const previous = label.textContent ?? "Copy prompt";
+        // Remember the real label once — capturing at click time would
+        // capture "Copied" on a double-click and stick until reload.
+        label.dataset.blumeLabel ??= label.textContent ?? "Copy prompt";
         label.textContent = "Copied";
         setTimeout(() => {
-          label.textContent = previous;
+          label.textContent = label.dataset.blumeLabel ?? "Copy prompt";
         }, 1500);
       });
     }

package/src/components/content/Step.astro CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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/Tabs.astro CHANGED Viewed

@@ -3,7 +3,7 @@ interface Props {
   borderBottom?: boolean;
   defaultTabIndex?: number;
   dropdown?: boolean;
-  hash?: boolean;
+  hash?: boolean | "false" | "true";
   sync?: boolean;
 }
@@ -14,6 +14,10 @@ const {
   hash = true,
   sync = true,
 } = Astro.props;
+// MDX string attributes (`hash="false"` from generated markup) must read as
+// their boolean meaning — the string "false" is truthy.
+const hashEnabled = String(hash) !== "false";
 ---
 <blume-tabs
@@ -21,7 +25,7 @@ const {
   data-border-bottom={borderBottom ? "true" : "false"}
   data-default-tab-index={defaultTabIndex}
   data-dropdown={dropdown ? "true" : "false"}
-  data-hash={hash ? "true" : "false"}
+  data-hash={hashEnabled ? "true" : "false"}
   data-sync={sync ? "true" : "false"}
 >
   <div class:list={[dropdown ? "" : "overflow-x-auto"]}>
@@ -100,6 +104,13 @@ const {
         return;
       }
       if (this.dataset.blumeTabsReady === "true") {
+        // The built DOM survives a move; the listeners removed by
+        // disconnectedCallback don't — re-attach them (addEventListener with
+        // the same reference is idempotent).
+        if (this.#syncEnabled()) {
+          document.addEventListener(SYNC_EVENT, this.#sync);
+        }
+        window.addEventListener("hashchange", this.#hashChange);
         return;
       }
       this.dataset.blumeTabsReady = "true";

package/src/components/content/TypeTable.astro CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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/content/mermaid-element.ts CHANGED Viewed

@@ -24,6 +24,9 @@ const prefersDark = () => document.documentElement.dataset.theme === "dark";
 let counter = 0;
 class BlumeMermaid extends HTMLElement {
+  #observer: MutationObserver | null = null;
+  #renderToken = 0;
   connectedCallback() {
     const source = this.dataset.source ?? "";
     if (!source.trim()) {
@@ -35,6 +38,8 @@ class BlumeMermaid extends HTMLElement {
     this.replaceChildren(output);
     const render = async () => {
+      this.#renderToken += 1;
+      const token = this.#renderToken;
       const mermaid = await loadMermaid();
       mermaid.initialize({
         securityLevel: "strict",
@@ -47,7 +52,11 @@ class BlumeMermaid extends HTMLElement {
           `blume-mermaid-${counter}`,
           source
         );
-        output.innerHTML = svg;
+        // A newer render (rapid theme toggles) superseded this one — dropping
+        // the stale result keeps the diagram in the latest theme.
+        if (token === this.#renderToken) {
+          output.innerHTML = svg;
+        }
       } catch {
         output.textContent = "Could not render this diagram.";
       }
@@ -57,10 +66,19 @@ class BlumeMermaid extends HTMLElement {
     render();
     // Re-render on color-theme changes so the diagram tracks light and dark.
-    new MutationObserver(() => render()).observe(document.documentElement, {
+    // One observer per connection, disconnected on removal — otherwise every
+    // DOM move stacks another observer that renders into detached DOM forever.
+    this.#observer?.disconnect();
+    this.#observer = new MutationObserver(() => render());
+    this.#observer.observe(document.documentElement, {
       attributeFilter: ["data-theme"],
     });
   }
+  disconnectedCallback() {
+    this.#observer?.disconnect();
+    this.#observer = null;
+  }
 }
 if (!customElements.get("blume-mermaid")) {

package/src/components/islands/ask-ai.tsx CHANGED Viewed

@@ -2,6 +2,7 @@ import { useEffect, useState } from "react";
 import type { FormEvent } from "react";
 import type { UIStrings } from "../../core/i18n-ui.ts";
+import { joinBase, stripBase } from "./base-path.ts";
 interface ChatMessage {
   id: number;
@@ -27,16 +28,11 @@ const nextId = (): number => {
 // The endpoint and page path both honor the deployment `base` so grounding works
 // under a non-root base path (the server matches base-less document routes).
-const ASK_ENDPOINT = `${import.meta.env.BASE_URL}api/ask`.replace("//", "/");
+const ASK_ENDPOINT = joinBase(import.meta.env.BASE_URL, "api/ask");
 /** The current route with the deployment base stripped, for page-context lookup. */
-const currentPath = (): string => {
-  const base = import.meta.env.BASE_URL;
-  const path = window.location.pathname;
-  return base.length > 1 && path.startsWith(base)
-    ? `/${path.slice(base.length)}`
-    : path;
-};
+const currentPath = (): string =>
+  stripBase(import.meta.env.BASE_URL, window.location.pathname);
 const BUTTON_CLASS =
   "inline-flex h-9 cursor-pointer items-center gap-2 rounded-blume border border-border bg-muted px-2.5 text-muted-foreground text-sm hover:border-accent disabled:opacity-50";

package/src/components/islands/base-path.ts ADDED Viewed

@@ -0,0 +1,30 @@
+/**
+ * Base-path helpers for client islands. Astro's default `trailingSlash:
+ * "ignore"` passes `deployment.base` through as-is, so `BASE_URL` may arrive
+ * with or without a trailing slash (`/docs` or `/docs/`); every consumer must
+ * treat both forms the same or endpoints/grounding break under a base path.
+ */
+/** The base with a guaranteed trailing slash (`/docs` -> `/docs/`). */
+export const withTrailingSlash = (base: string): string =>
+  base.endsWith("/") ? base : `${base}/`;
+/** Join a base-relative path (`api/ask`) onto the deployment base. */
+export const joinBase = (base: string, path: string): string =>
+  `${withTrailingSlash(base)}${path}`;
+/**
+ * A pathname with the deployment base stripped (`/docs/guide` -> `/guide`),
+ * for page-context lookups against base-less document routes.
+ */
+export const stripBase = (base: string, pathname: string): string => {
+  const slashed = withTrailingSlash(base);
+  if (slashed === "/") {
+    return pathname;
+  }
+  if (pathname.startsWith(slashed)) {
+    return `/${pathname.slice(slashed.length)}`;
+  }
+  // The bare base itself ("/docs") is the base-less root.
+  return `${pathname}/` === slashed ? "/" : pathname;
+};

package/src/components/islands/hooks.ts CHANGED Viewed

@@ -2,6 +2,7 @@ import { useCallback, useEffect, useRef, useState } from "react";
 import type { BlumeClientData } from "../../core/data.ts";
 import type { SearchFn, SearchResult } from "../layout/search/types.ts";
+import { joinBase, stripBase } from "./base-path.ts";
 /**
  * React hooks for Blume islands.
@@ -117,16 +118,11 @@ export interface UseAskAI {
   reset: () => void;
 }
-const ASK_ENDPOINT = `${import.meta.env.BASE_URL}api/ask`.replace("//", "/");
+const ASK_ENDPOINT = joinBase(import.meta.env.BASE_URL, "api/ask");
 /** The current route with the deployment base stripped, for page grounding. */
-const currentPath = (): string => {
-  const base = import.meta.env.BASE_URL;
-  const path = window.location.pathname;
-  return base.length > 1 && path.startsWith(base)
-    ? `/${path.slice(base.length)}`
-    : path;
-};
+const currentPath = (): string =>
+  stripBase(import.meta.env.BASE_URL, window.location.pathname);
 /**
  * Stream answers from the Ask AI endpoint. Mirrors the built-in Ask AI island so
@@ -158,6 +154,14 @@ export const useAskAI = (): UseAskAI => {
           headers: { "content-type": "application/json" },
           method: "POST",
         });
+        if (!response.ok) {
+          // An error body (JSON, HTML error page) must not stream in as the
+          // assistant's answer.
+          assistant.content =
+            "Something went wrong answering that. Please try again.";
+          setMessages([...history, { ...assistant }]);
+          return;
+        }
         const reader = response.body?.getReader();
         const decoder = new TextDecoder();
         if (reader) {

package/src/components/layout/Header.astro CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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.

package/src/components/layout/NavTree.astro CHANGED Viewed

@@ -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/PageActions.astro CHANGED Viewed

@@ -311,7 +311,9 @@ hr { border: 0; border-top: 1px solid #ddd; margin: 2em 0; }`;
           .replace(/[^a-z0-9]+/gu, "-")
           .replace(/^-+|-+$/gu, "") || "docs";
-      const cursorConfig = btoa(JSON.stringify({ url: mcpUrl }));
+      // Base64 output can contain `+`/`=`, which a query string mangles
+      // (`+` decodes as a space) — it must be URL-encoded like any other value.
+      const cursorConfig = encodeURIComponent(btoa(JSON.stringify({ url: mcpUrl })));
       root
         .querySelector("[data-mcp-cursor]")
         ?.setAttribute(
@@ -325,20 +327,22 @@ hr { border: 0; border-top: 1px solid #ddd; margin: 2em 0; }`;
           `vscode:mcp/install?${encodeURIComponent(JSON.stringify({ name: id, type: "http", url: mcpUrl }))}`
         );
-      const flash = (el: Element | null, text: string, reset: string) => {
-        if (el) {
-          el.textContent = text;
-          setTimeout(() => {
-            el.textContent = reset;
-          }, 1500);
+      const flash = (el: Element | null, text: string) => {
+        if (!(el instanceof HTMLElement)) {
+          return;
         }
+        // Remember the element's own (localized) label once — capturing it at
+        // click time would capture "Copied!" on a double-click and stick.
+        el.dataset.blumeLabel ??= el.textContent ?? "";
+        el.textContent = text;
+        setTimeout(() => {
+          el.textContent = el.dataset.blumeLabel ?? "";
+        }, 1500);
       };
       const copy = async (value: string, el: Element | null) => {
-        // Restore the element's own label, so localized text round-trips.
-        const reset = el?.textContent ?? "";
         try {
           await navigator.clipboard.writeText(value);
-          flash(el, copiedLabel, reset);
+          flash(el, copiedLabel);
         } catch {
           // Clipboard unavailable; nothing to do.
         }
@@ -359,10 +363,12 @@ hr { border: 0; border-top: 1px solid #ddd; margin: 2em 0; }`;
     }
     const label = root.querySelector("[data-blume-copy-label]");
+    // Captured once — inside the handler a double-click would capture and
+    // permanently restore "Copied!".
+    const original = label?.textContent ?? "";
     root
       .querySelector("[data-blume-copy-page]")
       ?.addEventListener("click", async () => {
-        const original = label?.textContent ?? "";
         try {
           const response = await fetch(md);
           await navigator.clipboard.writeText(await response.text());