blume 1.7.3 → 2.0.1

package/src/components/layout/Pagination.astro

@@ -26,19 +26,19 @@ const s = { ...EN_UI.page, ...strings };
   (prev || next) && (
     <nav
       aria-label={s.pagination}
-      class="mx-auto mt-12 flex max-w-content justify-between gap-4 border-border border-t pt-6 max-md:flex-col"
+      class="mx-auto mt-12 flex max-w-content justify-between gap-4 border-border border-t pt-6"
     >
       {prev ? (
         <a
-          class="flex max-w-[48%] flex-1 items-center gap-2 rounded-blume border border-border px-4 py-3 text-foreground transition-colors hover:border-foreground max-md:max-w-full"
+          class="flex max-w-[48%] flex-1 items-center gap-2 rounded-blume border border-border px-4 py-3 text-foreground transition-colors hover:border-foreground"
           href={withBase(prev.route)}
         >
           <Icon class="rtl:-scale-x-100" name="arrow-left" size={16} />
           <span class="min-w-0">
-            <span class="block text-muted-foreground text-xs max-md:hidden">
+            <span class="block text-muted-foreground text-xs">
               {s.previous}
             </span>
-            <span class="block truncate font-medium">{prev.label}</span>
+            <span class="block font-medium max-md:line-clamp-2 max-md:wrap-break-word md:truncate">{prev.label}</span>
           </span>
         </a>
       ) : (
@@ -46,14 +46,14 @@ const s = { ...EN_UI.page, ...strings };
       )}
       {next && (
         <a
-          class="ms-auto flex max-w-[48%] flex-1 items-center justify-end gap-2 rounded-blume border border-border px-4 py-3 text-end text-foreground transition-colors hover:border-foreground max-md:max-w-full"
+          class="ms-auto flex max-w-[48%] flex-1 items-center justify-end gap-2 rounded-blume border border-border px-4 py-3 text-end text-foreground transition-colors hover:border-foreground"
           href={withBase(next.route)}
         >
           <span class="min-w-0">
-            <span class="block text-muted-foreground text-xs max-md:hidden">
+            <span class="block text-muted-foreground text-xs">
               {s.next}
             </span>
-            <span class="block truncate font-medium">{next.label}</span>
+            <span class="block font-medium max-md:line-clamp-2 max-md:wrap-break-word md:truncate">{next.label}</span>
           </span>
           <Icon class="rtl:-scale-x-100" name="arrow-right" size={16} />
         </a>

package/src/components/layout/ReferenceLayout.astro

@@ -3,14 +3,20 @@ import IconSprite from "./IconSprite.astro";
 import { createIconSprite } from "../icon-sprite.ts";
 import "blume:theme";
 import data from "blume:data";
-import type { BlumeFavicon } from "../../core/data.ts";
+import type {
+  BlumeDataConfig,
+  BlumeFavicon,
+  DiscoveryHeadLinks,
+} from "../../core/data.ts";
 import { EN_UI } from "../../core/i18n-ui.ts";
 import type { UIStrings } from "../../core/i18n-ui.ts";
+import { NEW_TAB_HINT_ID } from "../../core/new-tab.ts";
 import type { FontHead } from "../../theme/fonts.ts";
 import type { Navigation } from "../../core/types.ts";
 import Analytics from "./Analytics.astro";
 import WebMcp from "./WebMcp.astro";
 import Banner from "./Banner.astro";
+import DiscoveryLinks from "./DiscoveryLinks.astro";
 import Favicon from "./Favicon.astro";
 import Fonts from "./Fonts.astro";
 import {
@@ -50,17 +56,7 @@ interface Props {
     dismissible: boolean;
     key: string;
   } | null;
-  analytics?: {
-    cloudflare?: { token: string };
-    posthog?: { host?: string; key: string };
-    scripts?: {
-      attributes?: Record<string, string>;
-      content?: string;
-      src?: string;
-      strategy?: "async" | "defer";
-    }[];
-    vercel?: boolean;
-  } | null;
+  analytics?: BlumeDataConfig["analytics"] | null;
   navigation: Navigation;
   route: string;
   themeMode: "system" | "light" | "dark";
@@ -69,6 +65,13 @@ interface Props {
   pageTitle: string;
   /** Keep the reference route out of crawler indexes. */
   noindex?: boolean;
+  /**
+   * Which agent-discovery resources exist, advertised in the head by the same
+   * `DiscoveryLinks` partial the docs shells render; defaults to the
+   * `blume:data` snapshot, `null` drops the links. A reference route has no
+   * raw-Markdown mirror, so no `alternate` is emitted here.
+   */
+  discovery?: DiscoveryHeadLinks | null;
   /**
    * Active locale code for `<html lang>`. Defaults to the locale Astro
    * resolved from the URL (`Astro.currentLocale`), then the site default.
@@ -94,6 +97,7 @@ const {
   searchEnabled,
   pageTitle,
   noindex = false,
+  discovery = data.config.discovery,
   locale: localeProp,
   dir: dirProp,
   ui,
@@ -106,6 +110,7 @@ const locale = pageLocale(data.config.i18n, localeProp, Astro.currentLocale);
 const dir = dirProp ?? pageDirection(data.config.i18n, locale);
 
 const strings = ui ?? EN_UI;
+const navStrings = { ...EN_UI.nav, ...strings.nav };
 // Scope search to the reference page's language on a multi-locale site.
 const searchLocale = searchLocaleFor(data.config.i18n, locale);
 
@@ -125,6 +130,7 @@ createIconSprite(Astro.locals);
     <title>{pageTitle}</title>
     <Favicon favicon={favicon} appleIcon={appleIcon} />
     <Fonts cssVars={fontCssVars ?? []} />
+    <DiscoveryLinks discovery={discovery} />
     {
       bannerKey && (
         <script data-key={bannerKey} is:inline set:html={BANNER_INIT_SCRIPT} />
@@ -138,11 +144,14 @@ createIconSprite(Astro.locals);
       class="absolute start-[-999px] top-0 z-[100] bg-accent px-4 py-2 text-accent-foreground focus:start-0"
       href="#blume-content">{strings.page.skipToContent}</a
     >
+    {/* Every new-tab link's aria-describedby target (see core/new-tab.ts). */}
+    <span hidden id={NEW_TAB_HINT_ID}>{navStrings.opensInNewTab}</span>
     <Banner banner={banner} strings={strings.banner} />
     <Header
-      askStrings={strings.ask}
+      assistantStrings={strings.assistant}
       hasDrawer={false}
       hasSidebar={false}
+      locale={locale}
       logo={logo}
       navigation={navigation}
       route={route}

package/src/components/layout/RootLayout.astro

@@ -7,7 +7,12 @@ import type { UIStrings } from "../../core/i18n-ui.ts";
 import { resolveDateFormatOptions } from "../../core/date-format.ts";
 import type { ResolvedDateFormat } from "../../core/schema.ts";
 import type { OpenInChatProvider } from "../../core/open-in-chat.ts";
-import type { BlumeClientData, BlumeFavicon } from "../../core/data.ts";
+import type {
+  BlumeClientData,
+  BlumeDataConfig,
+  BlumeFavicon,
+  DiscoveryHeadLinks,
+} from "../../core/data.ts";
 import type {
   Heading,
   LocaleSwitchOption,
@@ -36,11 +41,13 @@ import { buildStructuredData, toIso } from "../../seo/jsonld.ts";
 import { normalizeXHandle } from "../../seo/x-handle.ts";
 import { withBase } from "../islands/base-path.ts";
 import { isExternalUrl } from "../../core/base-path.ts";
+import { NEW_TAB_HINT_ID, newTabAttrs } from "../../core/new-tab.ts";
 import Analytics from "./Analytics.astro";
 import WebMcp from "./WebMcp.astro";
 import Banner from "./Banner.astro";
 import Breadcrumbs from "./Breadcrumbs.astro";
 import Empty from "./Empty.astro";
+import DiscoveryLinks from "./DiscoveryLinks.astro";
 import Favicon from "./Favicon.astro";
 import Fonts from "./Fonts.astro";
 import {
@@ -87,17 +94,7 @@ interface Props {
     dismissible: boolean;
     key: string;
   } | null;
-  analytics?: {
-    cloudflare?: { token: string };
-    posthog?: { host?: string; key: string };
-    scripts?: {
-      attributes?: Record<string, string>;
-      content?: string;
-      src?: string;
-      strategy?: "async" | "defer";
-    }[];
-    vercel?: boolean;
-  } | null;
+  analytics?: BlumeDataConfig["analytics"] | null;
   navigation: Navigation;
   mcp?: { name: string; route: string } | null;
   page: { title: string; description?: string; route: string };
@@ -125,10 +122,10 @@ interface Props {
   canonical?: string | null;
   editUrl?: string | null;
   /**
-   * Opt this page out of the header's Ask AI trigger. Defaults to whether Ask
-   * AI is configured, so pages never wire the trigger up themselves.
+   * Opt this page out of the header's assistant trigger. Defaults to whether the
+   * assistant is configured, so pages never wire the trigger up themselves.
    */
-  askEnabled?: boolean;
+  assistantEnabled?: boolean;
   /** Show the "Was this page helpful?" rating below the content. */
   feedback?: boolean;
   exportPdf?: boolean;
@@ -144,13 +141,11 @@ interface Props {
    * links on every page — so an agent entering on a deep page (a search
    * result, a shared link) finds the machine-readable surface without probing
    * the site root. The HTML counterpart of the homepage-only HTTP `Link`
-   * header (see `ai/link-headers.ts`).
+   * header (see `ai/link-headers.ts`). Defaults to the `blume:data` snapshot,
+   * so a custom page on this layout gets the links without passing a prop;
+   * `null` drops them for one page.
    */
-  discovery?: {
-    agentReadability: boolean;
-    aiCatalog: boolean;
-    llmsTxt: boolean;
-  } | null;
+  discovery?: DiscoveryHeadLinks | null;
   siteUrl?: string | null;
   pageType?: string;
   published?: string | Date | null;
@@ -170,6 +165,13 @@ interface Props {
    * article so prose punctuation reads correctly; the chrome still mirrors.
    */
   contentDir?: "ltr" | "rtl";
+  /**
+   * Language of the page content itself — the fallback locale on a fallback
+   * page (English content at `/ar/…`). Set as the article's `lang` when it
+   * differs from the page locale, so assistive tech reads the text in its own
+   * language rather than the chrome's.
+   */
+  contentLocale?: string;
   /** Resolved UI dictionary; English baseline when omitted. */
   ui?: UIStrings;
   /** `hreflang` alternates (absolute URLs) for this page's translations. */
@@ -246,13 +248,13 @@ const {
   x,
   canonical,
   editUrl,
-  askEnabled,
+  assistantEnabled,
   feedback = false,
   exportPdf,
   exportEpub,
   openInChat,
   feeds,
-  discovery,
+  discovery = data.config.discovery,
   siteUrl,
   pageType,
   published,
@@ -262,6 +264,7 @@ const {
   locale: localeProp,
   dir: dirProp,
   contentDir,
+  contentLocale,
   ui,
   localeAlternates,
   xDefault,
@@ -349,7 +352,16 @@ if (isBare) {
 } else if (isApiOperation) {
   articleClass = "prose max-w-none";
 }
-const pageTitle = page.title ? `${page.title} - ${site.title}` : site.title;
+// A page titled like the site (a home page often is) takes the bare site title
+// rather than repeating it ("Acme Docs - Acme Docs").
+const pageTitle =
+  page.title && page.title !== site.title
+    ? `${page.title} - ${site.title}`
+    : site.title;
+// The article's own language, when a fallback page renders another locale's
+// content under this one.
+const articleLang =
+  contentLocale && contentLocale !== locale ? contentLocale : undefined;
 const description = page.description ?? site.description;
 // Blog posts and changelog entries are dated writing, so they take `og:type:
 // article` — the same split JSON-LD makes when it picks an article @type. Docs
@@ -534,48 +546,7 @@ createIconSprite(Astro.locals);
         />
       ))
     }
-    {/* Agent discovery on every page, not just the root: an agent that enters
-        on a deep page (a search result, a shared link) never sees the homepage
-        HTTP Link header, so the head carries the same describedby links plus
-        this page's own raw-Markdown mirror. Both rels are IANA-registered. */}
-    {
-      discovery?.agentReadability && (
-        <link
-          href={withBase("/agent-readability.json")}
-          rel="describedby"
-          type="application/json"
-        />
-      )
-    }
-    {
-      discovery?.llmsTxt && (
-        <link href={withBase("/llms.txt")} rel="describedby" type="text/plain" />
-      )
-    }
-    {/* The AI Catalog / ARD manifest under both relations its two specs
-        define: `ai-catalog` (ai-catalog spec) and `ard` (ARD v0.91), each
-        pointing at that spec's own well-known path. */}
-    {
-      discovery?.aiCatalog && (
-        <>
-          <link
-            href={withBase("/.well-known/ai-catalog.json")}
-            rel="ai-catalog"
-            type="application/ai-catalog+json"
-          />
-          <link
-            href={withBase("/.well-known/ard.json")}
-            rel="ard"
-            type="application/json"
-          />
-        </>
-      )
-    }
-    {
-      markdownMirror && (
-        <link href={markdownMirror} rel="alternate" type="text/markdown" />
-      )
-    }
+    <DiscoveryLinks discovery={discovery} markdownMirror={markdownMirror} />
     {
       structuredDataJson && (
         <script
@@ -606,12 +577,15 @@ createIconSprite(Astro.locals);
       class="absolute start-[-999px] top-0 z-[100] bg-accent px-4 py-2 text-accent-foreground focus:start-0"
       href="#blume-content">{strings.page.skipToContent}</a
     >
+    {/* Every new-tab link's aria-describedby target (see core/new-tab.ts). */}
+    <span hidden id={NEW_TAB_HINT_ID}>{navStrings.opensInNewTab}</span>
     <Banner banner={banner} strings={strings.banner} />
     <VersionBanner notice={versionNotice ?? null} />
     <HeaderSlot
-      askEnabled={askEnabled}
-      askStrings={strings.ask}
+      assistantEnabled={assistantEnabled}
+      assistantStrings={strings.assistant}
       layout={layout}
+      locale={locale}
       localeSwitch={localeSwitch}
       versionSelector={versionSelector}
       logo={logo}
@@ -632,6 +606,7 @@ createIconSprite(Astro.locals);
       <aside
         aria-label={navStrings.primary}
         data-blume-nav-drawer
+        id="blume-nav-drawer"
         class:list={[
           "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:scrollbar-thin lg:scrollbar-thumb-border lg:scrollbar-track-transparent lg:border-e-0 lg:bg-transparent lg:px-4",
           // A "bare" landing (the changelog index) has no sidebar column on
@@ -657,8 +632,7 @@ createIconSprite(Astro.locals);
                       <a
                         class="block rounded-[0.65rem] px-2.5 py-1.5 text-muted-foreground text-sm transition-colors hover:bg-muted hover:text-foreground"
                         href={withBase(link.href)}
-                        rel={external ? "noreferrer" : undefined}
-                        target={external ? "_blank" : undefined}
+                        {...newTabAttrs(link.href)}
                       >
                         <span class="flex items-center gap-2">
                           {link.icon && (
@@ -768,7 +742,18 @@ createIconSprite(Astro.locals);
           )
         }
         <PageHeaderSlot headings={tocHeadings} page={page} route={page.route} />
-        <article class:list={[articleClass]} dir={contentDir}>
+        {/* `data-pagefind-body` scopes Pagefind to the page's own text: without
+            it Pagefind indexes the whole <body>, so the header, sidebar, and
+            skip link lead every excerpt and match every query. Once any page
+            carries it, pages without it (landing pages, the 404, the
+            changelog index — none are content routes, which is what site
+            search indexes) drop out of the index entirely. */}
+        <article
+          class:list={[articleClass]}
+          data-pagefind-body={indexable && !isBare ? "" : undefined}
+          dir={contentDir}
+          lang={articleLang}
+        >
           <slot />
         </article>
         {
@@ -837,6 +822,7 @@ createIconSprite(Astro.locals);
       type="button"
     ></button>
     <script>
+      import type { Zoom } from "medium-zoom";
       import { copyText, createCopyFlash } from "../copy-feedback.ts";
       import { syncDrawerInert } from "./drawer-inert.ts";
       import { chromeIcons as icons } from "../../theme/chrome-icons.ts";
@@ -938,6 +924,13 @@ createIconSprite(Astro.locals);
       // client-router swap (which replaces the body with server-rendered
       // markup that has none of this applied). Everything in here binds to
       // elements the swap just created, so nothing double-attaches.
+      // One medium-zoom instance per real page load, re-pointed at each page's
+      // images: every instance adds document keyup/scroll and window resize
+      // listeners it never removes and holds on to the images it was given, so
+      // a fresh instance per client-router swap stacked listeners and kept
+      // every earlier page's images alive.
+      let zoom: Zoom | undefined;
+
       const initPage = async () => {
         // Localized copy-button labels, stamped on <body> by the layout markup
         // (the Search.astro data-attribute channel) since this bundled script
@@ -1056,6 +1049,15 @@ createIconSprite(Astro.locals);
         // via medium-zoom: ESC/scroll/click dismissal, natural-size capping,
         // and the open/close transition races are its problem, not ours.
         // Opt out per-image with `data-no-zoom`.
+        // The previous page's images are gone after a swap; let go of them
+        // before looking at this page. A swap that lands while an image is
+        // zoomed (Back mid-zoom) leaves the instance mid-animation, its overlay
+        // gone with the old body and its close never finishing, so start over
+        // then instead.
+        if (zoom?.getZoomedImage()) {
+          zoom = undefined;
+        }
+        zoom?.detach();
         if (document.body.hasAttribute("data-blume-image-zoom")) {
           const zoomTargets = Array.from(
             document.querySelectorAll<HTMLImageElement>(
@@ -1071,11 +1073,12 @@ createIconSprite(Astro.locals);
             const { default: mediumZoom } = await import(
               "medium-zoom/dist/pure"
             );
-            mediumZoom(zoomTargets, {
+            zoom ??= mediumZoom({
               background:
                 "color-mix(in oklab, var(--color-background) 80%, transparent)",
               margin: 24,
             });
+            zoom.attach(...zoomTargets);
           }
         }
       };

package/src/components/layout/Search.astro

@@ -12,7 +12,7 @@ import { flattenPages } from "./nav-utils.ts";
 // `SearchFn` it returns. Only the configured provider's SDK is bundled.
 
 interface Props {
-  askEnabled?: boolean;
+  assistantEnabled?: boolean;
   navigation?: Navigation;
   /** Curated empty-state pages; falls back to the first sidebar pages when empty or omitted. */
   popularPages?: { icon?: string; label: string; route: string }[];
@@ -27,7 +27,7 @@ interface Props {
 }
 
 const {
-  askEnabled = false,
+  assistantEnabled = false,
   navigation,
   popularPages,
   strings,
@@ -60,10 +60,10 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
 
 <blume-search
   class="contents"
-  data-ask={askEnabled ? "" : undefined}
+  data-ask={assistantEnabled ? "" : undefined}
   data-i18n-all={s.all}
-  data-i18n-ask={s.askAi}
-  data-i18n-ask-hint={s.askAiHint}
+  data-i18n-ask={s.assistant}
+  data-i18n-ask-hint={s.assistantHint}
   data-i18n-dev={s.devOnly}
   data-i18n-empty={s.noResults}
   data-i18n-error={s.error}
@@ -84,8 +84,11 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
   >
     <Icon name="search" size={16} />
     <span class="flex-1 text-start max-lg:hidden">{s.button}</span>
-    <kbd class="font-mono text-[0.7rem] max-lg:hidden" data-blume-search-kbd
-      >⌘K</kbd
+    {/* A key chord reads left to right in every locale ("⌘K", never "K⌘"). */}
+    <kbd
+      class="font-mono text-[0.7rem] max-lg:hidden"
+      data-blume-search-kbd
+      dir="ltr">⌘K</kbd
     >
   </button>
 
@@ -195,8 +198,10 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
           {s.open}
         </span>
         <span class="flex items-center gap-1 max-md:hidden">
-          <kbd class={`${kbd} text-[0.65rem]`} data-blume-search-preview-kbd
-            >⌘J</kbd
+          <kbd
+            class={`${kbd} text-[0.65rem]`}
+            data-blume-search-preview-kbd
+            dir="ltr">⌘J</kbd
           >
           {s.preview}
         </span>
@@ -271,6 +276,26 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
       }
     };
 
+    // The generated client and the index it fetches are the same on every
+    // page (locale and version filters apply per query), but each client-router
+    // swap rebuilds the header, and this element with it. Loading once in
+    // module scope — bundled modules survive swaps — keeps the first search
+    // after a navigation from refetching the index and rebuilding it. A failed
+    // load clears the cache, so the next open retries.
+    let searchClient: Promise<SearchFn> | undefined;
+    const loadSearchClient = (): Promise<SearchFn> => {
+      searchClient ??= (async () => {
+        try {
+          const { createSearch } = await import("blume:search-client");
+          return await createSearch();
+        } catch (error) {
+          searchClient = undefined;
+          throw error;
+        }
+      })();
+      return searchClient;
+    };
+
     class BlumeSearch extends HTMLElement {
       dialog!: HTMLDialogElement;
       input!: HTMLInputElement;
@@ -284,7 +309,7 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
       loadFailed = false;
       /** First-open client/index load still in flight. */
       loading = false;
-      askEnabled = false;
+      assistantEnabled = false;
       popular: PopularPage[] = [];
       selectables: Selectable[] = [];
       selectedIndex = -1;
@@ -298,7 +323,7 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
       devOnlyMsg = "Search is available in the production build.";
       noResultsMsg = "No results found.";
       errorMsg = "Something went wrong. Please try again.";
-      askMsg = "Ask AI";
+      askMsg = "Assistant";
       askHintMsg = "Get an instant answer from AI";
       allMsg = "All";
       popularMsg = "Popular";
@@ -326,7 +351,7 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
           !event.shiftKey &&
           !event.altKey
         ) {
-          // ⌘K toggles, mirroring the Ask AI panel's ⌘I: pressing it with
+          // ⌘K toggles, mirroring the assistant panel's ⌘I: pressing it with
           // the dialog open must close it, not re-showModal an open dialog
           // (an InvalidStateError on older engines).
           event.preventDefault();
@@ -369,7 +394,7 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
         this.results = this.querySelector("[data-blume-search-results]")!;
         this.message = this.querySelector("[data-blume-search-message]")!;
         this.preview = this.querySelector("[data-blume-search-preview]")!;
-        this.askEnabled = this.hasAttribute("data-ask");
+        this.assistantEnabled = this.hasAttribute("data-ask");
 
         const popularScript = this.querySelector(
           "[data-blume-search-popular]"
@@ -481,8 +506,7 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
         if (!this.loaded) {
           this.loading = true;
           try {
-            const { createSearch } = await import("blume:search-client");
-            this.searchFn = await createSearch();
+            this.searchFn = await loadSearchClient();
             // 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.
@@ -612,7 +636,7 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
 
         this.renderFilters(result.sections);
 
-        if (this.askEnabled) {
+        if (this.assistantEnabled) {
           const group = this.addGroup(this.askMsg);
           const ask = this.createAskRow(query);
           group.appendChild(ask.el);
@@ -626,7 +650,7 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
             group.appendChild(item.el);
             this.selectables.push(item);
           }
-        } else if (!this.askEnabled) {
+        } else if (!this.assistantEnabled) {
           this.setMessage(this.noResultsMsg);
         }
 
@@ -634,7 +658,7 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
       }
 
       renderEmpty() {
-        if (this.askEnabled) {
+        if (this.assistantEnabled) {
           const group = this.addGroup(this.askMsg);
           const ask = this.createAskRow("");
           group.appendChild(ask.el);
@@ -850,7 +874,7 @@ const kbd = "rounded border border-border bg-muted px-1 py-0.5 font-mono";
           const query = this.input.value.trim();
           this.dialog.close();
           window.dispatchEvent(
-            new CustomEvent("blume:open-ask-ai", { detail: { query } })
+            new CustomEvent("blume:open-assistant", { detail: { query } })
           );
         } else if (item.url) {
           // Close first so the dialog isn't left open over the transition;

package/src/components/layout/WebMcp.astro

@@ -2,7 +2,7 @@
 // WebMCP: expose the docs' read-only tools (search, page Markdown, the docs
 // index) to agentic browsers via the page's model context. Rendered by
 // PageLayout on every page; the marker element below both gates the script
-// (absent when `ai.webmcp` is off, so it returns immediately) and carries the
+// (absent when `agents.webmcp` is off, so it returns immediately) and carries the
 // two config flags the client needs — importing `blume:data` from the client
 // script would drag the whole navigation snapshot into the bundle.
 import data from "blume:data";