blume 1.0.2 → 1.0.3

package/dist/types/core/config-input.d.ts

@@ -446,7 +446,21 @@ export interface LlmsTxtConfig {
      */
     openapi?: boolean;
 }
-/** AI-facing features: the Ask AI assistant and an `llms.txt` manifest. */
+/** Expose the docs as an MCP server for connecting agents. */
+export interface McpConfig {
+    /** Turn the MCP server on. Defaults to `false`. */
+    enabled?: boolean;
+    /** Optional system hint passed to connecting agents. */
+    instructions?: string;
+    /** Server name shown to clients; defaults to the site title. */
+    name?: string;
+    /** Route the server mounts at. Defaults to `/mcp`. */
+    route?: string;
+}
+/**
+ * AI-facing features: the Ask AI assistant, an `llms.txt` manifest, and the
+ * hosted MCP server.
+ */
 export interface AiConfig {
     /** The Ask AI chat assistant. */
     ask?: AskConfig;
@@ -474,6 +488,8 @@ export interface AiConfig {
      * ```
      */
     markdownComponents?: Record<string, ComponentMarkdown>;
+    /** Expose the docs as an MCP server for agents. */
+    mcp?: McpConfig;
 }
 /** An arbitrary analytics `<script>`; set exactly one of `src` or `content`. */
 export interface AnalyticsScript {
@@ -500,17 +516,6 @@ export interface AnalyticsConfig {
     /** Enable Vercel Web Analytics. */
     vercel?: boolean;
 }
-/** Expose the docs as an MCP server for connecting agents. */
-export interface McpConfig {
-    /** Turn the MCP server on. Defaults to `false`. */
-    enabled?: boolean;
-    /** Optional system hint passed to connecting agents. */
-    instructions?: string;
-    /** Server name shown to clients; defaults to the site title. */
-    name?: string;
-    /** Route the server mounts at. Defaults to `/mcp`. */
-    route?: string;
-}
 /** A configured locale plus display metadata for the switcher. */
 export interface LocaleConfigInput {
     /** Locale code, e.g. `en`, `fr`, `pt-BR`. */
@@ -829,8 +834,6 @@ export interface BlumeConfig {
     logo?: LogoConfig;
     /** Markdown / MDX rendering behavior. */
     markdown?: MarkdownConfig;
-    /** Expose the docs as an MCP server for agents. */
-    mcp?: McpConfig;
     /** Header, sidebar, tabs, and switchers. */
     navigation?: NavigationConfig;
     /** Native OpenAPI reference. */

package/dist/types/core/config.d.ts

@@ -66,9 +66,9 @@ import type { Diagnostic } from "./types.ts";
  *   `algolia`, `typesense`, `orama-cloud`, `mixedbread`, or `none`) plus its
  *   credential block.
  * - `ai` — `ask` (the Ask AI chat endpoint and its provider/model), `llmsTxt`
- *   (emit `llms.txt`), and `markdownComponents` (Markdown serializers for
- *   custom components in agent-facing output).
- * - `mcp` — expose the docs as an MCP server for connecting agents.
+ *   (emit `llms.txt`), `mcp` (expose the docs as an MCP server for connecting
+ *   agents), and `markdownComponents` (Markdown serializers for custom
+ *   components in agent-facing output).
  *
  * **SEO, feeds & analytics**
  * - `seo` — `og` images, `sitemap`, `robots`, `rss` feeds, `structuredData`

package/dist/types/core/schema.d.ts

@@ -819,12 +819,41 @@ declare const aiConfigSchema: z.ZodObject<{
         openapi?: boolean | undefined;
     } | undefined>;
     markdownComponents: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<ComponentMarkdown, z.ZodTypeDef, ComponentMarkdown>>>;
+    /** Expose the docs as an MCP server for connecting agents. */
+    mcp: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        /** Optional system hint passed to connecting agents. */
+        instructions: z.ZodOptional<z.ZodString>;
+        /** Server name shown to clients; defaults to the site title. */
+        name: z.ZodOptional<z.ZodString>;
+        /**
+         * Normalized like `openapi.route`: a slash-less value would otherwise be
+         * string-concatenated onto the site origin (`https://acme.comdocs-mcp`).
+         */
+        route: z.ZodEffects<z.ZodDefault<z.ZodString>, string, string | undefined>;
+    }, "strict", z.ZodTypeAny, {
+        enabled: boolean;
+        route: string;
+        name?: string | undefined;
+        instructions?: string | undefined;
+    }, {
+        name?: string | undefined;
+        enabled?: boolean | undefined;
+        instructions?: string | undefined;
+        route?: string | undefined;
+    }>>;
 }, "strict", z.ZodTypeAny, {
     llmsTxt: {
         enabled: boolean;
         openapi: boolean;
     };
     markdownComponents: Record<string, ComponentMarkdown>;
+    mcp: {
+        enabled: boolean;
+        route: string;
+        name?: string | undefined;
+        instructions?: string | undefined;
+    };
     ask?: {
         enabled: boolean;
         model: string;
@@ -853,6 +882,12 @@ declare const aiConfigSchema: z.ZodObject<{
         openapi?: boolean | undefined;
     } | undefined;
     markdownComponents?: Record<string, ComponentMarkdown> | undefined;
+    mcp?: {
+        name?: string | undefined;
+        enabled?: boolean | undefined;
+        instructions?: string | undefined;
+        route?: string | undefined;
+    } | undefined;
 }>;
 export type AskAiProvider = (typeof askAiProviders)[number];
 export type AskAiConfig = NonNullable<z.infer<typeof aiConfigSchema>["ask"]>;
@@ -1075,12 +1110,41 @@ export declare const blumeConfigSchema: z.ZodObject<{
             openapi?: boolean | undefined;
         } | undefined>;
         markdownComponents: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<ComponentMarkdown, z.ZodTypeDef, ComponentMarkdown>>>;
+        /** Expose the docs as an MCP server for connecting agents. */
+        mcp: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            /** Optional system hint passed to connecting agents. */
+            instructions: z.ZodOptional<z.ZodString>;
+            /** Server name shown to clients; defaults to the site title. */
+            name: z.ZodOptional<z.ZodString>;
+            /**
+             * Normalized like `openapi.route`: a slash-less value would otherwise be
+             * string-concatenated onto the site origin (`https://acme.comdocs-mcp`).
+             */
+            route: z.ZodEffects<z.ZodDefault<z.ZodString>, string, string | undefined>;
+        }, "strict", z.ZodTypeAny, {
+            enabled: boolean;
+            route: string;
+            name?: string | undefined;
+            instructions?: string | undefined;
+        }, {
+            name?: string | undefined;
+            enabled?: boolean | undefined;
+            instructions?: string | undefined;
+            route?: string | undefined;
+        }>>;
     }, "strict", z.ZodTypeAny, {
         llmsTxt: {
             enabled: boolean;
             openapi: boolean;
         };
         markdownComponents: Record<string, ComponentMarkdown>;
+        mcp: {
+            enabled: boolean;
+            route: string;
+            name?: string | undefined;
+            instructions?: string | undefined;
+        };
         ask?: {
             enabled: boolean;
             model: string;
@@ -1109,6 +1173,12 @@ export declare const blumeConfigSchema: z.ZodObject<{
             openapi?: boolean | undefined;
         } | undefined;
         markdownComponents?: Record<string, ComponentMarkdown> | undefined;
+        mcp?: {
+            name?: string | undefined;
+            enabled?: boolean | undefined;
+            instructions?: string | undefined;
+            route?: string | undefined;
+        } | undefined;
     }>>;
     analytics: z.ZodOptional<z.ZodObject<{
         posthog: z.ZodOptional<z.ZodObject<{
@@ -1895,28 +1965,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
         headingAnchors?: boolean | undefined;
         imageZoom?: boolean | undefined;
     }>>;
-    mcp: z.ZodDefault<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Optional system hint passed to connecting agents. */
-        instructions: z.ZodOptional<z.ZodString>;
-        /** Server name shown to clients; defaults to the site title. */
-        name: z.ZodOptional<z.ZodString>;
-        /**
-         * Normalized like `openapi.route`: a slash-less value would otherwise be
-         * string-concatenated onto the site origin (`https://acme.comdocs-mcp`).
-         */
-        route: z.ZodEffects<z.ZodDefault<z.ZodString>, string, string | undefined>;
-    }, "strict", z.ZodTypeAny, {
-        enabled: boolean;
-        route: string;
-        name?: string | undefined;
-        instructions?: string | undefined;
-    }, {
-        name?: string | undefined;
-        enabled?: boolean | undefined;
-        route?: string | undefined;
-        instructions?: string | undefined;
-    }>>;
     navigation: z.ZodDefault<z.ZodObject<{
         /** Pinned links shown above the generated sidebar sections. */
         featured: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -2692,6 +2740,12 @@ export declare const blumeConfigSchema: z.ZodObject<{
             openapi: boolean;
         };
         markdownComponents: Record<string, ComponentMarkdown>;
+        mcp: {
+            enabled: boolean;
+            route: string;
+            name?: string | undefined;
+            instructions?: string | undefined;
+        };
         ask?: {
             enabled: boolean;
             model: string;
@@ -2835,12 +2889,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
         headingAnchors: boolean;
         imageZoom: boolean;
     };
-    mcp: {
-        enabled: boolean;
-        route: string;
-        name?: string | undefined;
-        instructions?: string | undefined;
-    };
     navigation: {
         sidebar: {
             display: "flat" | "page" | "group";
@@ -3025,6 +3073,12 @@ export declare const blumeConfigSchema: z.ZodObject<{
             openapi?: boolean | undefined;
         } | undefined;
         markdownComponents?: Record<string, ComponentMarkdown> | undefined;
+        mcp?: {
+            name?: string | undefined;
+            enabled?: boolean | undefined;
+            instructions?: string | undefined;
+            route?: string | undefined;
+        } | undefined;
     } | undefined;
     content?: {
         root?: string | undefined;
@@ -3206,12 +3260,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
         headingAnchors?: boolean | undefined;
         imageZoom?: boolean | undefined;
     } | undefined;
-    mcp?: {
-        name?: string | undefined;
-        enabled?: boolean | undefined;
-        route?: string | undefined;
-        instructions?: string | undefined;
-    } | undefined;
     navigation?: {
         sidebar?: SidebarItemConfig[] | {
             display?: "flat" | "page" | "group" | undefined;

package/docs/advanced/custom-pages.mdx

@@ -222,6 +222,8 @@ const { config } = data;
 </PageLayout>
 ```
 
+The header a custom page gets is the same one the docs pages get, so the chrome that lives in it comes along: search, the theme toggle, the language switcher, and — when [Ask AI](/docs/configuration/ai) is configured — the Ask AI trigger. None of it needs wiring up per page. Pass `askEnabled={false}` to leave the Ask trigger off one page while keeping it everywhere else.
+
 Passing `siteUrl` (and `ogEnabled`) derives the page's `canonical` and a generated `og:image` automatically: Blume renders an Open Graph card for every static custom page — the home included, the most-shared URL — served at `/og/<route>.png` (`/og/index.png` for `/`). The home card uses the site title with the description as its eyebrow; a deeper page is titled from its last path segment. Set `ogImage` or `canonical` explicitly to override either. `ogImage` takes a root-relative path — a file in `public/`, resolved against [`deployment.site`](/docs/deployment) to the absolute URL crawlers need — or an external URL, which passes through untouched:
 
 ```astro pages/index.astro lineNumbers

package/docs/configuration/ai.mdx

@@ -198,9 +198,11 @@ The `POST /api/ask` endpoint is **unauthenticated** — it has to be, so the in-
 Host a [Model Context Protocol](https://modelcontextprotocol.io) server so coding agents (Claude Code, Cursor, VS Code, claude.ai connectors) can search and read your docs directly — no scraping:
 
 ```ts blume.config.ts lineNumbers
-mcp: {
-  enabled: true,
-  route: "/mcp", // where the server is mounted
+ai: {
+  mcp: {
+    enabled: true,
+    route: "/mcp", // where the server is mounted
+  },
 }
 ```
 
@@ -227,7 +229,7 @@ deployment: {
 }
 ```
 
-A static build with `mcp.enabled` fails fast with a message telling you to set `deployment.output` to `server`. See [Deployment](/docs/deployment) for the adapters. Once deployed, connect from Claude Code with:
+A static build with `ai.mcp.enabled` fails fast with a message telling you to set `deployment.output` to `server`. See [Deployment](/docs/deployment) for the adapters. Once deployed, connect from Claude Code with:
 
 ```bash
 claude mcp add --transport http my-docs https://docs.example.com/mcp

package/docs/configuration/index.mdx

@@ -64,12 +64,11 @@ export default defineConfig({
   // AI — see the AI guide
   ai: {
     llmsTxt: true,
-  },
-
-  // MCP server (needs server output) — see the AI guide
-  mcp: {
-    enabled: false,
-    route: "/mcp",
+    // MCP server (needs server output)
+    mcp: {
+      enabled: false,
+      route: "/mcp",
+    },
   },
 
   // SEO — OG images, feeds, sitemap, structured data; see the SEO guide
@@ -287,8 +286,7 @@ Each of these has its own guide. The config field is the entry point:
 | `navigation` | Explicit sidebar and header tabs | [Navigation](/docs/content/navigation) |
 | `search` | Provider (Orama, Pagefind, Algolia, and more) and indexing | [Search](/docs/configuration/search) |
 | `markdown` | Markdown rendering options — code blocks, heading anchors, image zoom | [Syntax](/docs/content/syntax) |
-| `ai` | `llms.txt`, Ask AI, and the MCP server | [AI](/docs/configuration/ai) |
-| `mcp` | Hosted MCP server for coding agents | [AI](/docs/configuration/ai#mcp-server) |
+| `ai` | `llms.txt`, Ask AI, and the hosted MCP server for coding agents | [AI](/docs/configuration/ai) |
 | `analytics` | Vercel, PostHog, and custom scripts | [Analytics](/docs/configuration/analytics) |
 | `seo` | Metadata, OG images, feeds, structured data | [SEO](/docs/configuration/seo) |
 | `deployment` | Output mode, adapter, and site URL | [Deployment](/docs/deployment) |

package/docs/content/components.mdx

@@ -532,14 +532,14 @@ export interface ButtonProps {
 
 A card linking to a GitHub repository with its live star and fork counts. Counts are fetched at build time — no client JavaScript — and the card still renders if the API is unreachable. Pass `owner` and `repo`, or omit them to use the repository from your `blume.config`. Set a `GITHUB_TOKEN` environment variable to lift the API rate limit.
 
-<GithubInfo owner="withastro" repo="astro" />
+<GithubInfo owner="haydenbleasel" repo="blume" />
 
 ```astro lineNumbers
 <!-- Uses the repo from blume.config -->
 <GithubInfo />
 
 <!-- Or point it at any repository -->
-<GithubInfo owner="withastro" repo="astro" />
+<GithubInfo owner="haydenbleasel" repo="blume" />
 ```
 
 ## Component
@@ -670,6 +670,28 @@ Diff two files in your project, relative to its root:
 
 <Diff before="diffs/button-before.ts" after="diffs/button-after.ts" />
 
-Or render a unified patch from a file:
+```astro
+<Diff before="diffs/button-before.ts" after="diffs/button-after.ts" />
+```
+
+Or render a unified patch — either from a file with `src`, or inline with `patch`:
 
 <Diff src="diffs/greet.patch" />
+
+```astro
+<Diff src="diffs/greet.patch" />
+```
+
+```astro
+<Diff
+  patch={`--- a/greet.ts
++++ b/greet.ts
+@@ -1,3 +1,4 @@
+-export function greet(name) {
+-  return "Hi, " + name;
++export function greet(name: string): string {
++  const greeting = "Hi, " + name + "!";
++  return greeting;
+ }`}
+/>
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blume",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Documentation that's fast, AI-ready, and zero-config.",
   "keywords": [
     "astro",

package/src/ai/agent-readability.ts

@@ -62,10 +62,10 @@ export const buildAgentReadability = (
     artifacts.llmsFullTxt = abs("/llms-full.txt");
     artifacts.llmsTxt = abs("/llms.txt");
   }
-  if (config.mcp.enabled) {
+  if (config.ai.mcp.enabled) {
     artifacts.mcp = {
       discovery: abs("/.well-known/mcp.json"),
-      url: abs(config.mcp.route),
+      url: abs(config.ai.mcp.route),
     };
   }
   if (config.ai.ask?.enabled) {
@@ -87,7 +87,7 @@ export const buildAgentReadability = (
     artifacts,
     description: config.description,
     generator: version ? `blume@${version}` : undefined,
-    name: config.mcp.name ?? config.title,
+    name: config.ai.mcp.name ?? config.title,
     site,
   };
 

package/src/ai/mcp/data.ts

@@ -88,8 +88,8 @@ export const buildMcpData = async (project: BlumeProject): Promise<McpData> => {
       route: doc.route,
       title: doc.title,
     })),
-    instructions: config.mcp.instructions,
-    name: config.mcp.name ?? config.title,
+    instructions: config.ai.mcp.instructions,
+    name: config.ai.mcp.name ?? config.title,
     navigation: graph.navigation,
     pages,
     routes,

package/src/astro/generate.ts

@@ -61,6 +61,7 @@ import {
   routeIsTaken,
 } from "./pages.ts";
 import {
+  askComponentTemplate,
   askEndpointTemplate,
   astroConfigTemplate,
   catchAllPageTemplate,
@@ -865,8 +866,11 @@ export const buildRuntimeData = (project: BlumeProject): string => {
         : null,
       imageZoom: config.markdown.imageZoom,
       logo: resolveLogo(project),
-      mcp: config.mcp.enabled
-        ? { name: config.mcp.name ?? config.title, route: config.mcp.route }
+      mcp: config.ai.mcp.enabled
+        ? {
+            name: config.ai.mcp.name ?? config.title,
+            route: config.ai.mcp.route,
+          }
         : null,
       // `og.enabled` is resolved to a definite boolean in `loadConfig`; coerce
       // the optional schema type so the serialized shape stays `boolean`.
@@ -939,7 +943,7 @@ const planMcp = (
   userPages: { pattern: string }[]
 ): McpPlan => {
   const { config } = project;
-  const { route } = config.mcp;
+  const { route } = config.ai.mcp;
   const dir = join(srcDir, "blume-mcp");
   const base: McpPlan = {
     dir,
@@ -949,14 +953,14 @@ const planMcp = (
     srcDir,
     warnings: [],
   };
-  if (!config.mcp.enabled) {
+  if (!config.ai.mcp.enabled) {
     return base;
   }
   if (routeIsTaken(userPages, project.graph.pages, route)) {
     return {
       ...base,
       warnings: [
-        `MCP server route "${route}" is already used by a content or custom page; the MCP server was not generated. Set a different "mcp.route" in blume.config.ts.`,
+        `MCP server route "${route}" is already used by a content or custom page; the MCP server was not generated. Set a different "ai.mcp.route" in blume.config.ts.`,
       ],
     };
   }
@@ -1105,6 +1109,7 @@ export const generateRuntime = async (
   const { context, config } = project;
   const out = context.outDir;
   const srcDir = join(out, "src");
+  const askPath = join(srcDir, "generated", "Ask.astro");
   const dataPath = join(srcDir, "generated", "data.json");
   const themePath = join(srcDir, "generated", "app.css");
   const searchClientPath = join(srcDir, "generated", "search-client.ts");
@@ -1205,6 +1210,7 @@ export const generateRuntime = async (
         join(out, "astro.config.mjs"),
         astroConfigTemplate({
           aliases: resolveTsconfigAliases(context.root),
+          askPath,
           config,
           contentRoutes: project.manifest.routes.map((route) => route.path),
           context,
@@ -1242,13 +1248,16 @@ export const generateRuntime = async (
       write(
         join(srcDir, "pages", "[...slug].astro"),
         catchAllPageTemplate({
-          askEnabled,
           exportEpub,
           exportPdf,
           mathEnabled: usesMath,
           needsReact,
         })
       ),
+      // The header's Ask trigger, behind the `blume:ask` alias. Always written
+      // (even when Ask is off, as a component that renders nothing) so the alias
+      // resolves — the same contract as `blume:search-client`.
+      write(askPath, askComponentTemplate(askEnabled)),
       write(join(srcDir, "generated", "components.ts"), slotPlan.module),
       write(
         join(srcDir, "generated", "islands.ts"),
@@ -1336,7 +1345,6 @@ export const generateRuntime = async (
     await write(
       join(srcDir, "pages", "changelog.astro"),
       changelogIndexTemplate({
-        askEnabled,
         exportEpub,
         exportPdf,
         needsReact,

package/src/astro/templates.ts

@@ -222,6 +222,8 @@ export const astroConfigTemplate = (options: {
   needsSvelte?: boolean;
   pages: BlumePageRoute[];
   contentRoutes: string[];
+  /** The generated Ask trigger (`blume:ask`); renders nothing when Ask is off. */
+  askPath: string;
   dataPath: string;
   examplesPath: string;
   /** The example-preview Tailwind entry (`blume:examples-theme`). */
@@ -240,6 +242,7 @@ export const astroConfigTemplate = (options: {
 }): string => {
   const { context, config, needsReact, pages, dataPath, themePath } = options;
   const {
+    askPath,
     contentRoutes,
     examplesPath,
     examplesThemePath,
@@ -425,6 +428,7 @@ export default defineConfig({
     },
     resolve: {
       alias: {
+        "blume:ask": ${JSON.stringify(askPath)},
         "blume:data": ${JSON.stringify(dataPath)},
         "blume:examples": ${JSON.stringify(examplesPath)},
         "blume:examples-theme": ${JSON.stringify(examplesThemePath)},
@@ -694,6 +698,42 @@ ${handler}
 `;
 };
 
+/**
+ * Generate `.blume/src/generated/Ask.astro` — the component behind the
+ * `blume:ask` alias that the shared header renders in place of a per-page slot.
+ *
+ * The header can't import the Ask AI island directly: it's a React component, so
+ * the import alone would drag the JSX renderer into the module graph of every
+ * project — including the ones that never enable Ask AI and therefore have no
+ * React integration wired into their generated Astro config (see `needsReact`).
+ * Routing the import through a generated component keeps that dependency behind
+ * the config switch: enabled projects get the island, disabled ones get a
+ * component that renders nothing and imports no React.
+ *
+ * `strings` comes from the header (the active locale's dictionary); the empty-
+ * state suggestions are read straight from the data snapshot, which is why no
+ * page has to pass them.
+ */
+export const askComponentTemplate = (askEnabled: boolean): string =>
+  askEnabled
+    ? `---
+// Generated by Blume. Do not edit.
+import AskAI from "blume/components/islands/AskAI.astro";
+import data from "blume:data";
+
+const { strings } = Astro.props;
+---
+
+<AskAI strings={strings ?? data.ui.ask} suggestions={data.config.ask?.suggestions ?? []} />
+`
+    : `---
+// Generated by Blume. Do not edit.
+// Ask AI is off (\`ai.ask.enabled\`), so the header's Ask trigger renders nothing.
+// Deliberately imports no React island, keeping the JSX renderer out of projects
+// that don't need it.
+---
+`;
+
 /** Generate the static search index endpoint (`/blume-search.json`). */
 export const searchEndpointTemplate = (): string =>
   `// Generated by Blume. Do not edit.
@@ -1069,19 +1109,12 @@ const htmlLang = i18n ? i18n.defaultLocale : "en";
 `;
 
 export const catchAllPageTemplate = (options: {
-  askEnabled: boolean;
   exportEpub: boolean;
   exportPdf: boolean;
   mathEnabled: boolean;
   /** Serialize the island-hooks snapshot; only needed when React is enabled. */
   needsReact: boolean;
 }): string => {
-  const askImport = options.askEnabled
-    ? 'import AskAI from "blume/components/islands/AskAI.astro";\n'
-    : "";
-  const askSlot = options.askEnabled
-    ? '\n  <AskAI slot="ask" strings={ui.ask} suggestions={data.config.ask?.suggestions ?? []} />'
-    : "";
   const mathImport = options.mathEnabled
     ? 'import Math from "blume/components/content/Math.astro";\n'
     : "";
@@ -1097,7 +1130,6 @@ import { getEntry, render } from "astro:content";
 import RootLayout from "blume/components/layout/RootLayout.astro";
 import { withBase } from "blume/components/islands/base-path.ts";
 import { resolveSlot } from "blume/components/layout/overrides.ts";
-${askImport}
 import Accordion from "blume/components/content/Accordion.astro";
 import AccordionItem from "blume/components/content/AccordionItem.astro";
 import AutoTypeTable from "blume/components/content/AutoTypeTable.astro";
@@ -1334,7 +1366,6 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   canonical={canonical}
   editUrl={editUrl}
   feedback={data.config.feedback}
-  askEnabled={${options.askEnabled}}
   exportPdf={${options.exportPdf}}
   exportEpub={${options.exportEpub}}
   feeds={data.feeds}
@@ -1344,7 +1375,7 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   lastModified={lastModified}
   noindex={seo.noindex}
   structuredDataEnabled={data.config.structuredData}
->${askSlot}
+>
   <h1>{title}</h1>
   {frontmatter.description && <p class="text-lg text-muted-foreground">{frontmatter.description}</p>}
   <Content components={components} />
@@ -1359,7 +1390,6 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
  * by {@link generateAstroProject} when changelog entries exist.
  */
 export const changelogIndexTemplate = (options: {
-  askEnabled: boolean;
   exportEpub: boolean;
   exportPdf: boolean;
   /** Serialize the island-hooks snapshot; only needed when React is enabled. */
@@ -1367,12 +1397,6 @@ export const changelogIndexTemplate = (options: {
   /** Whether a `staged` collection exists (non-filesystem changelog sources). */
   staged: boolean;
 }): string => {
-  const askImport = options.askEnabled
-    ? 'import AskAI from "blume/components/islands/AskAI.astro";\n'
-    : "";
-  const askSlot = options.askEnabled
-    ? '\n  <AskAI slot="ask" strings={data.ui.ask} suggestions={data.config.ask?.suggestions ?? []} />'
-    : "";
   const clientData = options.needsReact
     ? '\n  clientData={{ config: data.config, navigation: data.navigation, page: { route: "/changelog", title: pageTitle } }}'
     : "";
@@ -1390,7 +1414,7 @@ import Update from "blume/components/content/Update.astro";
 import { withBase } from "blume/components/islands/base-path.ts";
 import { resolveSlot } from "blume/components/layout/overrides.ts";
 import { layoutOverrides } from "../generated/components.ts";
-${askImport}import data from "../generated/data.json";
+import data from "../generated/data.json";
 
 export const prerender = true;
 
@@ -1559,14 +1583,13 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   ogImage={null}
   x={data.config.x}
   canonical={canonical}
-  askEnabled={${options.askEnabled}}
   exportPdf={${options.exportPdf}}
   exportEpub={${options.exportEpub}}
   feeds={data.feeds}
   siteUrl={data.config.site}
   noindex={false}
   structuredDataEnabled={data.config.structuredData}
->${askSlot}
+>
   <h1>{changelogTitle}</h1>
   {
     items.length === 0 ? (
@@ -1891,6 +1914,11 @@ export const envTemplate =
   (): string => `/// <reference path="../.astro/types.d.ts" />
 /// <reference types="astro/client" />
 
+declare module "blume:ask" {
+  const Ask: typeof import("blume/components/islands/AskAI.astro").default;
+  export default Ask;
+}
+
 declare module "blume:data" {
   const data: import("blume").BlumeData;
   export default data;