blume 1.1.4 → 1.2.1

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

@@ -1,3 +1,4 @@
+import type { AstroIntegration } from "astro";
 import type { ComponentMarkdown } from "../ai/component-markdown.ts";
 import type { CodeTheme } from "../markdown/themes.ts";
 import type { FontSlug } from "../theme/fonts.ts";
@@ -241,6 +242,15 @@ export interface NavTabItem {
 }
 /** A top-level tab in the header, optionally opening a dropdown of items. */
 export interface NavTab {
+    /**
+     * Where the tab links to, when that differs from `path`. `path` scopes the
+     * sidebar section and matches the active tab; without `href`, a section whose
+     * `path` isn't itself a page falls back to the section's first page, or keeps
+     * `path` when the section has no linkable page at all. Set this to send
+     * readers somewhere else — e.g. a generated `/changelog` index, or a custom
+     * `.astro` landing page, neither of which is part of the content tree.
+     */
+    href?: string;
     /** Lucide icon name shown beside the label. */
     icon?: string;
     /** Dropdown items; omit for a plain link tab. */
@@ -444,6 +454,12 @@ export interface AskConfig {
     baseUrl?: string;
     /** Turn Ask AI on. Defaults to `false`. */
     enabled?: boolean;
+    /**
+     * Existing Ask AI endpoint to call instead of generating one. This keeps a
+     * Blume site static while an API backend owns retrieval, model access, rate
+     * limiting, and streaming. Accepts an absolute URL or root-relative path.
+     */
+    endpoint?: string;
     /** Model id to use. Defaults to `openai/gpt-5.5`. */
     model?: string;
     /** Which backend routes the request. Defaults to `gateway`. */
@@ -961,6 +977,8 @@ export interface BlumeConfig {
     github?: GithubConfig;
     /** Internationalization (opt-in multi-locale). */
     i18n?: I18nConfig;
+    /** Astro integrations appended after Blume's built-ins, in declaration order. */
+    integrations?: AstroIntegration[];
     /** "Last updated" timestamps from git history or frontmatter. Defaults to `false`. */
     lastModified?: LastModifiedConfig;
     /** Site logo / brand mark. */

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

@@ -76,6 +76,10 @@ import type { Diagnostic } from "./types.ts";
  * - `analytics` — PostHog, Vercel, or arbitrary `scripts` (Plausible, Fathom,
  *   GA, …).
  *
+ * **Astro**
+ * - `integrations` — Astro integrations appended after Blume's built-ins, in
+ *   declaration order. Install and maintain each integration in the site.
+ *
  * **Deployment & i18n**
  * - `deployment` — `site` URL (needed for absolute links, sitemaps, and OG),
  *   `adapter` (`vercel`/`node`/`netlify`/`cloudflare`), `output`

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

@@ -95,6 +95,7 @@ export interface BlumeDataConfig {
     appleIcon: BlumeFavicon | null;
     /** Ask AI empty-state suggestions, or `null` when Ask AI is off. */
     ask: {
+        endpoint: string | null;
         suggestions: NonNullable<ResolvedConfig["ai"]["ask"]>["suggestions"];
     } | null;
     banner: BlumeBanner | null;

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

@@ -1,3 +1,4 @@
+import type { AstroIntegration } from "astro";
 import { z } from "zod";
 import type { ComponentMarkdown } from "../ai/component-markdown.ts";
 import type { CodeTheme } from "../markdown/themes.ts";
@@ -7,6 +8,14 @@ declare const hydrationMode: z.ZodEnum<["load", "idle", "visible", "media", "onl
 export type HydrationMode = z.infer<typeof hydrationMode>;
 /** Frontmatter accepted on any content page. */
 declare const pageMetaBaseSchema: z.ZodObject<{
+    ai: z.ZodDefault<z.ZodObject<{
+        /** Exclude this page from llms.txt and llms-full.txt. */
+        exclude: z.ZodDefault<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        exclude: boolean;
+    }, {
+        exclude?: boolean | undefined;
+    }>>;
     /** Post author(s) for blog/changelog content; preserved, not yet rendered. */
     authors: z.ZodOptional<z.ZodUnion<[z.ZodUnion<[z.ZodString, z.ZodObject<{
         avatar: z.ZodOptional<z.ZodString>;
@@ -99,6 +108,7 @@ declare const pageMetaBaseSchema: z.ZodObject<{
         } | undefined;
         canonical?: string | undefined;
     }, {
+        noindex?: boolean | undefined;
         description?: string | undefined;
         title?: string | undefined;
         image?: string | undefined;
@@ -106,7 +116,6 @@ declare const pageMetaBaseSchema: z.ZodObject<{
             creator?: string | undefined;
         } | undefined;
         canonical?: string | undefined;
-        noindex?: boolean | undefined;
     }>>;
     sidebar: z.ZodDefault<z.ZodObject<{
         badge: z.ZodOptional<z.ZodString>;
@@ -131,6 +140,10 @@ declare const pageMetaBaseSchema: z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
     type: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
+    ai: {
+        exclude: boolean;
+    };
+    noindex: boolean;
     sidebar: {
         hidden: boolean;
         icon?: string | undefined;
@@ -155,7 +168,6 @@ declare const pageMetaBaseSchema: z.ZodObject<{
     };
     deprecated: boolean;
     hidden: boolean;
-    noindex: boolean;
     draft: boolean;
     type?: string | undefined;
     date?: string | undefined;
@@ -184,6 +196,10 @@ declare const pageMetaBaseSchema: z.ZodObject<{
     type?: string | undefined;
     date?: string | Date | undefined;
     icon?: string | undefined;
+    ai?: {
+        exclude?: boolean | undefined;
+    } | undefined;
+    noindex?: boolean | undefined;
     description?: string | undefined;
     lastModified?: string | Date | undefined;
     slug?: string | undefined;
@@ -206,6 +222,7 @@ declare const pageMetaBaseSchema: z.ZodObject<{
         category?: string | undefined;
     } | undefined;
     seo?: {
+        noindex?: boolean | undefined;
         description?: string | undefined;
         title?: string | undefined;
         image?: string | undefined;
@@ -213,11 +230,9 @@ declare const pageMetaBaseSchema: z.ZodObject<{
             creator?: string | undefined;
         } | undefined;
         canonical?: string | undefined;
-        noindex?: boolean | undefined;
     } | undefined;
     deprecated?: boolean | undefined;
     hidden?: boolean | undefined;
-    noindex?: boolean | undefined;
     authors?: string | z.objectInputType<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
@@ -232,6 +247,14 @@ declare const pageMetaBaseSchema: z.ZodObject<{
     draft?: boolean | undefined;
 }>;
 export declare const pageMetaSchema: z.ZodObject<{
+    ai: z.ZodDefault<z.ZodObject<{
+        /** Exclude this page from llms.txt and llms-full.txt. */
+        exclude: z.ZodDefault<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        exclude: boolean;
+    }, {
+        exclude?: boolean | undefined;
+    }>>;
     /** Post author(s) for blog/changelog content; preserved, not yet rendered. */
     authors: z.ZodOptional<z.ZodUnion<[z.ZodUnion<[z.ZodString, z.ZodObject<{
         avatar: z.ZodOptional<z.ZodString>;
@@ -324,6 +347,7 @@ export declare const pageMetaSchema: z.ZodObject<{
         } | undefined;
         canonical?: string | undefined;
     }, {
+        noindex?: boolean | undefined;
         description?: string | undefined;
         title?: string | undefined;
         image?: string | undefined;
@@ -331,7 +355,6 @@ export declare const pageMetaSchema: z.ZodObject<{
             creator?: string | undefined;
         } | undefined;
         canonical?: string | undefined;
-        noindex?: boolean | undefined;
     }>>;
     sidebar: z.ZodDefault<z.ZodObject<{
         badge: z.ZodOptional<z.ZodString>;
@@ -356,6 +379,10 @@ export declare const pageMetaSchema: z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
     type: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
+    ai: {
+        exclude: boolean;
+    };
+    noindex: boolean;
     sidebar: {
         hidden: boolean;
         icon?: string | undefined;
@@ -380,7 +407,6 @@ export declare const pageMetaSchema: z.ZodObject<{
     };
     deprecated: boolean;
     hidden: boolean;
-    noindex: boolean;
     draft: boolean;
     type?: string | undefined;
     date?: string | undefined;
@@ -409,6 +435,10 @@ export declare const pageMetaSchema: z.ZodObject<{
     type?: string | undefined;
     date?: string | Date | undefined;
     icon?: string | undefined;
+    ai?: {
+        exclude?: boolean | undefined;
+    } | undefined;
+    noindex?: boolean | undefined;
     description?: string | undefined;
     lastModified?: string | Date | undefined;
     slug?: string | undefined;
@@ -431,6 +461,7 @@ export declare const pageMetaSchema: z.ZodObject<{
         category?: string | undefined;
     } | undefined;
     seo?: {
+        noindex?: boolean | undefined;
         description?: string | undefined;
         title?: string | undefined;
         image?: string | undefined;
@@ -438,11 +469,9 @@ export declare const pageMetaSchema: z.ZodObject<{
             creator?: string | undefined;
         } | undefined;
         canonical?: string | undefined;
-        noindex?: boolean | undefined;
     } | undefined;
     deprecated?: boolean | undefined;
     hidden?: boolean | undefined;
-    noindex?: boolean | undefined;
     authors?: string | z.objectInputType<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
@@ -746,6 +775,7 @@ declare const aiConfigSchema: z.ZodObject<{
         apiKeyEnv: z.ZodOptional<z.ZodString>;
         baseUrl: z.ZodOptional<z.ZodString>;
         enabled: z.ZodDefault<z.ZodBoolean>;
+        endpoint: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
         model: z.ZodDefault<z.ZodString>;
         provider: z.ZodDefault<z.ZodEnum<["gateway", "openrouter", "llmgateway", "inkeep", "openai-compatible"]>>;
         suggestions: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -768,10 +798,12 @@ declare const aiConfigSchema: z.ZodObject<{
         }[];
         apiKeyEnv?: string | undefined;
         baseUrl?: string | undefined;
+        endpoint?: string | undefined;
     }, {
         apiKeyEnv?: string | undefined;
         baseUrl?: string | undefined;
         enabled?: boolean | undefined;
+        endpoint?: string | undefined;
         model?: string | undefined;
         provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
         suggestions?: {
@@ -788,10 +820,12 @@ declare const aiConfigSchema: z.ZodObject<{
         }[];
         apiKeyEnv?: string | undefined;
         baseUrl?: string | undefined;
+        endpoint?: string | undefined;
     }, {
         apiKeyEnv?: string | undefined;
         baseUrl?: string | undefined;
         enabled?: boolean | undefined;
+        endpoint?: string | undefined;
         model?: string | undefined;
         provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
         suggestions?: {
@@ -866,12 +900,14 @@ declare const aiConfigSchema: z.ZodObject<{
         }[];
         apiKeyEnv?: string | undefined;
         baseUrl?: string | undefined;
+        endpoint?: string | undefined;
     } | undefined;
 }, {
     ask?: {
         apiKeyEnv?: string | undefined;
         baseUrl?: string | undefined;
         enabled?: boolean | undefined;
+        endpoint?: string | undefined;
         model?: string | undefined;
         provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
         suggestions?: {
@@ -1083,13 +1119,22 @@ declare const dateFormatConfigSchema: z.ZodEffects<z.ZodObject<{
  * `http(s)` URL (OpenAPI for the Blume renderer; OpenAPI or AsyncAPI for Scalar).
  */
 declare const openapiSourceSchema: z.ZodObject<{
+    /** Include generated pages from this spec in llms.txt/llms-full.txt. */
+    includeInLlms: z.ZodDefault<z.ZodBoolean>;
+    /** Include generated pages from this spec in site search. */
+    includeInSearch: z.ZodDefault<z.ZodBoolean>;
     /** Nav/section label for this source. */
     label: z.ZodOptional<z.ZodString>;
+    /** Emit noindex metadata and omit generated pages from the sitemap. */
+    noindex: z.ZodDefault<z.ZodBoolean>;
     /** Per-source route; defaults to the block's `route` (or a derived path). */
     route: z.ZodOptional<z.ZodString>;
     /** Local path or `http(s)` URL to the spec. */
     spec: z.ZodString;
 }, "strict", z.ZodTypeAny, {
+    includeInLlms: boolean;
+    includeInSearch: boolean;
+    noindex: boolean;
     spec: string;
     label?: string | undefined;
     route?: string | undefined;
@@ -1097,14 +1142,18 @@ declare const openapiSourceSchema: z.ZodObject<{
     spec: string;
     label?: string | undefined;
     route?: string | undefined;
+    includeInLlms?: boolean | undefined;
+    includeInSearch?: boolean | undefined;
+    noindex?: boolean | undefined;
 }>;
-export type OpenApiSource = z.infer<typeof openapiSourceSchema>;
+export type OpenApiSource = z.input<typeof openapiSourceSchema>;
 export declare const blumeConfigSchema: z.ZodObject<{
     ai: z.ZodDefault<z.ZodObject<{
         ask: z.ZodOptional<z.ZodEffects<z.ZodObject<{
             apiKeyEnv: z.ZodOptional<z.ZodString>;
             baseUrl: z.ZodOptional<z.ZodString>;
             enabled: z.ZodDefault<z.ZodBoolean>;
+            endpoint: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
             model: z.ZodDefault<z.ZodString>;
             provider: z.ZodDefault<z.ZodEnum<["gateway", "openrouter", "llmgateway", "inkeep", "openai-compatible"]>>;
             suggestions: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -1127,10 +1176,12 @@ export declare const blumeConfigSchema: z.ZodObject<{
             }[];
             apiKeyEnv?: string | undefined;
             baseUrl?: string | undefined;
+            endpoint?: string | undefined;
         }, {
             apiKeyEnv?: string | undefined;
             baseUrl?: string | undefined;
             enabled?: boolean | undefined;
+            endpoint?: string | undefined;
             model?: string | undefined;
             provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
             suggestions?: {
@@ -1147,10 +1198,12 @@ export declare const blumeConfigSchema: z.ZodObject<{
             }[];
             apiKeyEnv?: string | undefined;
             baseUrl?: string | undefined;
+            endpoint?: string | undefined;
         }, {
             apiKeyEnv?: string | undefined;
             baseUrl?: string | undefined;
             enabled?: boolean | undefined;
+            endpoint?: string | undefined;
             model?: string | undefined;
             provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
             suggestions?: {
@@ -1225,12 +1278,14 @@ export declare const blumeConfigSchema: z.ZodObject<{
             }[];
             apiKeyEnv?: string | undefined;
             baseUrl?: string | undefined;
+            endpoint?: string | undefined;
         } | undefined;
     }, {
         ask?: {
             apiKeyEnv?: string | undefined;
             baseUrl?: string | undefined;
             enabled?: boolean | undefined;
+            endpoint?: string | undefined;
             model?: string | undefined;
             provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
             suggestions?: {
@@ -1319,13 +1374,22 @@ export declare const blumeConfigSchema: z.ZodObject<{
         /** Extra Scalar config forwarded to `<ScalarComponent>`. */
         scalar: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         sources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            /** Include generated pages from this spec in llms.txt/llms-full.txt. */
+            includeInLlms: z.ZodDefault<z.ZodBoolean>;
+            /** Include generated pages from this spec in site search. */
+            includeInSearch: z.ZodDefault<z.ZodBoolean>;
             /** Nav/section label for this source. */
             label: z.ZodOptional<z.ZodString>;
+            /** Emit noindex metadata and omit generated pages from the sitemap. */
+            noindex: z.ZodDefault<z.ZodBoolean>;
             /** Per-source route; defaults to the block's `route` (or a derived path). */
             route: z.ZodOptional<z.ZodString>;
             /** Local path or `http(s)` URL to the spec. */
             spec: z.ZodString;
         }, "strict", z.ZodTypeAny, {
+            includeInLlms: boolean;
+            includeInSearch: boolean;
+            noindex: boolean;
             spec: string;
             label?: string | undefined;
             route?: string | undefined;
@@ -1333,6 +1397,9 @@ export declare const blumeConfigSchema: z.ZodObject<{
             spec: string;
             label?: string | undefined;
             route?: string | undefined;
+            includeInLlms?: boolean | undefined;
+            includeInSearch?: boolean | undefined;
+            noindex?: boolean | undefined;
         }>, "many">>;
         spec: z.ZodOptional<z.ZodString>;
         theme: z.ZodOptional<z.ZodString>;
@@ -1340,6 +1407,9 @@ export declare const blumeConfigSchema: z.ZodObject<{
         enabled: boolean;
         route: string;
         sources: {
+            includeInLlms: boolean;
+            includeInSearch: boolean;
+            noindex: boolean;
             spec: string;
             label?: string | undefined;
             route?: string | undefined;
@@ -1356,6 +1426,9 @@ export declare const blumeConfigSchema: z.ZodObject<{
             spec: string;
             label?: string | undefined;
             route?: string | undefined;
+            includeInLlms?: boolean | undefined;
+            includeInSearch?: boolean | undefined;
+            noindex?: boolean | undefined;
         }[] | undefined;
         theme?: string | undefined;
     }>>;
@@ -1991,6 +2064,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
         parser?: "dir" | "dot" | undefined;
         ui?: Record<string, Record<string, Record<string, string>>> | undefined;
     }>>;
+    integrations: z.ZodDefault<z.ZodArray<z.ZodType<AstroIntegration, z.ZodTypeDef, AstroIntegration>, "many">>;
     lastModified: z.ZodDefault<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
         type: z.ZodDefault<z.ZodEnum<["git", "frontmatter"]>>;
     }, "strict", z.ZodTypeAny, {
@@ -2194,6 +2268,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
             display?: "flat" | "group" | "page" | undefined;
         } | undefined>;
         tabs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            href: z.ZodOptional<z.ZodString>;
             icon: z.ZodOptional<z.ZodString>;
             items: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 description: z.ZodOptional<z.ZodString>;
@@ -2220,6 +2295,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
             path: string;
             label: string;
             icon?: string | undefined;
+            href?: string | undefined;
             items?: {
                 path: string;
                 label: string;
@@ -2231,6 +2307,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
             path: string;
             label: string;
             icon?: string | undefined;
+            href?: string | undefined;
             items?: {
                 path: string;
                 label: string;
@@ -2265,6 +2342,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
             path: string;
             label: string;
             icon?: string | undefined;
+            href?: string | undefined;
             items?: {
                 path: string;
                 label: string;
@@ -2299,6 +2377,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
             path: string;
             label: string;
             icon?: string | undefined;
+            href?: string | undefined;
             items?: {
                 path: string;
                 label: string;
@@ -2322,13 +2401,22 @@ export declare const blumeConfigSchema: z.ZodObject<{
         scalar: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         /** One or more specs; each renders on its own route by default. */
         sources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            /** Include generated pages from this spec in llms.txt/llms-full.txt. */
+            includeInLlms: z.ZodDefault<z.ZodBoolean>;
+            /** Include generated pages from this spec in site search. */
+            includeInSearch: z.ZodDefault<z.ZodBoolean>;
             /** Nav/section label for this source. */
             label: z.ZodOptional<z.ZodString>;
+            /** Emit noindex metadata and omit generated pages from the sitemap. */
+            noindex: z.ZodDefault<z.ZodBoolean>;
             /** Per-source route; defaults to the block's `route` (or a derived path). */
             route: z.ZodOptional<z.ZodString>;
             /** Local path or `http(s)` URL to the spec. */
             spec: z.ZodString;
         }, "strict", z.ZodTypeAny, {
+            includeInLlms: boolean;
+            includeInSearch: boolean;
+            noindex: boolean;
             spec: string;
             label?: string | undefined;
             route?: string | undefined;
@@ -2336,6 +2424,9 @@ export declare const blumeConfigSchema: z.ZodObject<{
             spec: string;
             label?: string | undefined;
             route?: string | undefined;
+            includeInLlms?: boolean | undefined;
+            includeInSearch?: boolean | undefined;
+            noindex?: boolean | undefined;
         }>, "many">>;
         /** Shorthand for a single source: `sources: [{ spec }]`. */
         spec: z.ZodOptional<z.ZodString>;
@@ -2345,6 +2436,9 @@ export declare const blumeConfigSchema: z.ZodObject<{
         enabled: boolean;
         route: string;
         sources: {
+            includeInLlms: boolean;
+            includeInSearch: boolean;
+            noindex: boolean;
             spec: string;
             label?: string | undefined;
             route?: string | undefined;
@@ -2364,6 +2458,9 @@ export declare const blumeConfigSchema: z.ZodObject<{
             spec: string;
             label?: string | undefined;
             route?: string | undefined;
+            includeInLlms?: boolean | undefined;
+            includeInSearch?: boolean | undefined;
+            noindex?: boolean | undefined;
         }[] | undefined;
         theme?: string | undefined;
         codeSamples?: string[] | undefined;
@@ -2430,12 +2527,12 @@ export declare const blumeConfigSchema: z.ZodObject<{
             /** Index id used by the build-time sync (with `ORAMA_PRIVATE_API_KEY`). */
             indexId: z.ZodOptional<z.ZodString>;
         }, "strict", z.ZodTypeAny, {
-            apiKey: string;
             endpoint: string;
+            apiKey: string;
             indexId?: string | undefined;
         }, {
-            apiKey: string;
             endpoint: string;
+            apiKey: string;
             indexId?: string | undefined;
         }>>;
         /** Curated links for the Cmd+K empty state; defaults to the first sidebar pages. */
@@ -2491,8 +2588,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             storeId: string;
         } | undefined;
         oramaCloud?: {
-            apiKey: string;
             endpoint: string;
+            apiKey: string;
             indexId?: string | undefined;
         } | undefined;
         typesense?: {
@@ -2516,8 +2613,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             storeId: string;
         } | undefined;
         oramaCloud?: {
-            apiKey: string;
             endpoint: string;
+            apiKey: string;
             indexId?: string | undefined;
         } | undefined;
         popular?: {
@@ -2551,8 +2648,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             storeId: string;
         } | undefined;
         oramaCloud?: {
-            apiKey: string;
             endpoint: string;
+            apiKey: string;
             indexId?: string | undefined;
         } | undefined;
         typesense?: {
@@ -2576,8 +2673,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             storeId: string;
         } | undefined;
         oramaCloud?: {
-            apiKey: string;
             endpoint: string;
+            apiKey: string;
             indexId?: string | undefined;
         } | undefined;
         popular?: {
@@ -2958,6 +3055,9 @@ export declare const blumeConfigSchema: z.ZodObject<{
         enabled: boolean;
         route: string;
         sources: {
+            includeInLlms: boolean;
+            includeInSearch: boolean;
+            noindex: boolean;
             spec: string;
             label?: string | undefined;
             route?: string | undefined;
@@ -2973,6 +3073,9 @@ export declare const blumeConfigSchema: z.ZodObject<{
         enabled: boolean;
         route: string;
         sources: {
+            includeInLlms: boolean;
+            includeInSearch: boolean;
+            noindex: boolean;
             spec: string;
             label?: string | undefined;
             route?: string | undefined;
@@ -3003,6 +3106,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
             }[];
             apiKeyEnv?: string | undefined;
             baseUrl?: string | undefined;
+            endpoint?: string | undefined;
         } | undefined;
     };
     content: {
@@ -3129,6 +3233,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
     frontmatter: {
         extend: Record<string, StandardSchema<unknown, unknown>>;
     };
+    integrations: AstroIntegration[];
     markdown: {
         code: {
             icons: boolean;
@@ -3169,6 +3274,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
             path: string;
             label: string;
             icon?: string | undefined;
+            href?: string | undefined;
             items?: {
                 path: string;
                 label: string;
@@ -3205,8 +3311,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             storeId: string;
         } | undefined;
         oramaCloud?: {
-            apiKey: string;
             endpoint: string;
+            apiKey: string;
             indexId?: string | undefined;
         } | undefined;
         typesense?: {
@@ -3319,6 +3425,9 @@ export declare const blumeConfigSchema: z.ZodObject<{
             spec: string;
             label?: string | undefined;
             route?: string | undefined;
+            includeInLlms?: boolean | undefined;
+            includeInSearch?: boolean | undefined;
+            noindex?: boolean | undefined;
         }[] | undefined;
         theme?: string | undefined;
         codeSamples?: string[] | undefined;
@@ -3334,6 +3443,9 @@ export declare const blumeConfigSchema: z.ZodObject<{
             spec: string;
             label?: string | undefined;
             route?: string | undefined;
+            includeInLlms?: boolean | undefined;
+            includeInSearch?: boolean | undefined;
+            noindex?: boolean | undefined;
         }[] | undefined;
         theme?: string | undefined;
     } | undefined;
@@ -3342,6 +3454,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
             apiKeyEnv?: string | undefined;
             baseUrl?: string | undefined;
             enabled?: boolean | undefined;
+            endpoint?: string | undefined;
             model?: string | undefined;
             provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
             suggestions?: {
@@ -3526,6 +3639,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
         parser?: "dir" | "dot" | undefined;
         ui?: Record<string, Record<string, Record<string, string>>> | undefined;
     } | undefined;
+    integrations?: AstroIntegration[] | undefined;
     logo?: string | {
         href?: string | undefined;
         text?: string | undefined;
@@ -3575,6 +3689,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
             path: string;
             label: string;
             icon?: string | undefined;
+            href?: string | undefined;
             items?: {
                 path: string;
                 label: string;
@@ -3606,8 +3721,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             storeId: string;
         } | undefined;
         oramaCloud?: {
-            apiKey: string;
             endpoint: string;
+            apiKey: string;
             indexId?: string | undefined;
         } | undefined;
         popular?: {

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

@@ -190,9 +190,11 @@ export interface NavTab {
      */
     path: string;
     /**
-     * The clickable target. Equals `path` when the section has an index page;
-     * otherwise it's resolved to the section's first page so the tab never links
-     * to a 404. Absent when it matches `path`.
+     * The clickable target. Author-declared when the config sets it; otherwise
+     * equals `path` when the section has an index page, and resolves to the
+     * section's first page when it doesn't, so the tab doesn't link to a 404 as
+     * long as the section has a page to offer — a section with no linkable page at
+     * all keeps `path`. Absent when a resolved target matches `path`.
      */
     href?: string;
     icon?: string;