blume 0.5.4 → 0.6.0

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

@@ -426,21 +426,18 @@ declare const sidebarDisplaySchema: z.ZodEnum<["flat", "group", "page"]>;
 export type SidebarDisplay = z.infer<typeof sidebarDisplaySchema>;
 export declare const folderMetaSchema: z.ZodObject<{
     collapsed: z.ZodOptional<z.ZodBoolean>;
-    display: z.ZodOptional<z.ZodEnum<["flat", "group", "page"]>>;
     icon: z.ZodOptional<z.ZodString>;
     order: z.ZodOptional<z.ZodNumber>;
     /** Explicit child ordering by slug segment (without numeric prefix). */
     pages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     title: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
-    display?: "flat" | "page" | "group" | undefined;
     title?: string | undefined;
     icon?: string | undefined;
     order?: number | undefined;
     pages?: string[] | undefined;
     collapsed?: boolean | undefined;
 }, {
-    display?: "flat" | "page" | "group" | undefined;
     title?: string | undefined;
     icon?: string | undefined;
     order?: number | undefined;
@@ -708,10 +705,24 @@ declare const aiConfigSchema: z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         model: z.ZodDefault<z.ZodString>;
         provider: z.ZodDefault<z.ZodEnum<["gateway", "openrouter", "llmgateway", "inkeep", "openai-compatible"]>>;
+        suggestions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            icon: z.ZodOptional<z.ZodString>;
+            label: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            label: string;
+            icon?: string | undefined;
+        }, {
+            label: string;
+            icon?: string | undefined;
+        }>, "many">>;
     }, "strict", z.ZodTypeAny, {
         enabled: boolean;
         model: string;
         provider: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible";
+        suggestions: {
+            label: string;
+            icon?: string | undefined;
+        }[];
         apiKeyEnv?: string | undefined;
         baseUrl?: string | undefined;
     }, {
@@ -720,10 +731,18 @@ declare const aiConfigSchema: z.ZodObject<{
         enabled?: boolean | undefined;
         model?: string | undefined;
         provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
+        suggestions?: {
+            label: string;
+            icon?: string | undefined;
+        }[] | undefined;
     }>, {
         enabled: boolean;
         model: string;
         provider: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible";
+        suggestions: {
+            label: string;
+            icon?: string | undefined;
+        }[];
         apiKeyEnv?: string | undefined;
         baseUrl?: string | undefined;
     }, {
@@ -732,6 +751,10 @@ declare const aiConfigSchema: z.ZodObject<{
         enabled?: boolean | undefined;
         model?: string | undefined;
         provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
+        suggestions?: {
+            label: string;
+            icon?: string | undefined;
+        }[] | undefined;
     }>>;
     llmsTxt: z.ZodDefault<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
@@ -740,6 +763,10 @@ declare const aiConfigSchema: z.ZodObject<{
         enabled: boolean;
         model: string;
         provider: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible";
+        suggestions: {
+            label: string;
+            icon?: string | undefined;
+        }[];
         apiKeyEnv?: string | undefined;
         baseUrl?: string | undefined;
     } | undefined;
@@ -750,6 +777,10 @@ declare const aiConfigSchema: z.ZodObject<{
         enabled?: boolean | undefined;
         model?: string | undefined;
         provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
+        suggestions?: {
+            label: string;
+            icon?: string | undefined;
+        }[] | undefined;
     } | undefined;
     llmsTxt?: boolean | undefined;
 }>;
@@ -844,6 +875,34 @@ declare const i18nConfigSchema: z.ZodEffects<z.ZodObject<{
     parser?: "dir" | "dot" | undefined;
     ui?: Record<string, Record<string, Record<string, string>>> | undefined;
 }>;
+/**
+ * Content signals accept a boolean shorthand or a per-signal object, and
+ * normalize to `{ search, aiInput, aiTrain }` — or `null` when disabled, so
+ * robots.txt omits the declaration entirely. On by default (`true`): Blume
+ * declares the docs open to search and agents. `false` opts out; an object
+ * restricts individual signals (unset signals stay `yes`).
+ */
+declare const contentSignalsSchema: z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
+    aiInput: z.ZodDefault<z.ZodBoolean>;
+    aiTrain: z.ZodDefault<z.ZodBoolean>;
+    search: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    search: boolean;
+    aiInput: boolean;
+    aiTrain: boolean;
+}, {
+    search?: boolean | undefined;
+    aiInput?: boolean | undefined;
+    aiTrain?: boolean | undefined;
+}>]>, {
+    search: boolean;
+    aiInput: boolean;
+    aiTrain: boolean;
+} | null, boolean | {
+    search?: boolean | undefined;
+    aiInput?: boolean | undefined;
+    aiTrain?: boolean | undefined;
+}>;
 /**
  * A single spec rendered by the API reference. `spec` is a local path or an
  * `http(s)` URL (OpenAPI for the Blume renderer; OpenAPI or AsyncAPI for Scalar).
@@ -873,10 +932,24 @@ export declare const blumeConfigSchema: z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             model: z.ZodDefault<z.ZodString>;
             provider: z.ZodDefault<z.ZodEnum<["gateway", "openrouter", "llmgateway", "inkeep", "openai-compatible"]>>;
+            suggestions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                icon: z.ZodOptional<z.ZodString>;
+                label: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                label: string;
+                icon?: string | undefined;
+            }, {
+                label: string;
+                icon?: string | undefined;
+            }>, "many">>;
         }, "strict", z.ZodTypeAny, {
             enabled: boolean;
             model: string;
             provider: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible";
+            suggestions: {
+                label: string;
+                icon?: string | undefined;
+            }[];
             apiKeyEnv?: string | undefined;
             baseUrl?: string | undefined;
         }, {
@@ -885,10 +958,18 @@ export declare const blumeConfigSchema: z.ZodObject<{
             enabled?: boolean | undefined;
             model?: string | undefined;
             provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
+            suggestions?: {
+                label: string;
+                icon?: string | undefined;
+            }[] | undefined;
         }>, {
             enabled: boolean;
             model: string;
             provider: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible";
+            suggestions: {
+                label: string;
+                icon?: string | undefined;
+            }[];
             apiKeyEnv?: string | undefined;
             baseUrl?: string | undefined;
         }, {
@@ -897,6 +978,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
             enabled?: boolean | undefined;
             model?: string | undefined;
             provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
+            suggestions?: {
+                label: string;
+                icon?: string | undefined;
+            }[] | undefined;
         }>>;
         llmsTxt: z.ZodDefault<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
@@ -905,6 +990,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
             enabled: boolean;
             model: string;
             provider: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible";
+            suggestions: {
+                label: string;
+                icon?: string | undefined;
+            }[];
             apiKeyEnv?: string | undefined;
             baseUrl?: string | undefined;
         } | undefined;
@@ -915,6 +1004,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
             enabled?: boolean | undefined;
             model?: string | undefined;
             provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
+            suggestions?: {
+                label: string;
+                icon?: string | undefined;
+            }[] | undefined;
         } | undefined;
         llmsTxt?: boolean | undefined;
     }>>;
@@ -1723,6 +1816,20 @@ export declare const blumeConfigSchema: z.ZodObject<{
         instructions?: string | undefined;
     }>>;
     navigation: z.ZodDefault<z.ZodObject<{
+        /** Pinned links shown above the generated sidebar sections. */
+        featured: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            href: z.ZodString;
+            icon: z.ZodOptional<z.ZodString>;
+            label: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+        }, {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+        }>, "many">>;
         /** Show a GitHub repo link in the header (requires `github` configured). */
         repo: z.ZodDefault<z.ZodBoolean>;
         selectors: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -1768,8 +1875,28 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 tag?: string | undefined;
             }[] | undefined;
         }>, "many">>;
-        /** Explicit sidebar override; when omitted the sidebar is generated. */
-        sidebar: z.ZodOptional<z.ZodArray<z.ZodType<SidebarItemConfig, z.ZodTypeDef, SidebarItemConfig>, "many">>;
+        /**
+         * Sidebar behavior. `display` sets how every group renders (a group in an
+         * explicit `items` config may still override it); `items` is an explicit
+         * sidebar — when omitted the sidebar is generated from the content tree.
+         * A bare array is shorthand for `{ items }`.
+         */
+        sidebar: z.ZodEffects<z.ZodDefault<z.ZodUnion<[z.ZodArray<z.ZodType<SidebarItemConfig, z.ZodTypeDef, SidebarItemConfig>, "many">, z.ZodObject<{
+            display: z.ZodDefault<z.ZodEnum<["flat", "group", "page"]>>;
+            items: z.ZodOptional<z.ZodArray<z.ZodType<SidebarItemConfig, z.ZodTypeDef, SidebarItemConfig>, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            display: "flat" | "page" | "group";
+            items?: SidebarItemConfig[] | undefined;
+        }, {
+            display?: "flat" | "page" | "group" | undefined;
+            items?: SidebarItemConfig[] | undefined;
+        }>]>>, {
+            display: "flat" | "page" | "group";
+            items?: SidebarItemConfig[] | undefined;
+        }, SidebarItemConfig[] | {
+            display?: "flat" | "page" | "group" | undefined;
+            items?: SidebarItemConfig[] | undefined;
+        } | undefined>;
         tabs: z.ZodOptional<z.ZodArray<z.ZodObject<{
             icon: z.ZodOptional<z.ZodString>;
             items: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -1817,7 +1944,16 @@ export declare const blumeConfigSchema: z.ZodObject<{
             }[] | undefined;
         }>, "many">>;
     }, "strict", z.ZodTypeAny, {
+        sidebar: {
+            display: "flat" | "page" | "group";
+            items?: SidebarItemConfig[] | undefined;
+        };
         repo: boolean;
+        featured: {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+        }[];
         selectors: {
             label: string;
             items: {
@@ -1829,7 +1965,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
             }[];
             kind: "version" | "dropdown" | "language" | "product";
         }[];
-        sidebar?: SidebarItemConfig[] | undefined;
         tabs?: {
             path: string;
             label: string;
@@ -1843,8 +1978,16 @@ export declare const blumeConfigSchema: z.ZodObject<{
             }[] | undefined;
         }[] | undefined;
     }, {
-        sidebar?: SidebarItemConfig[] | undefined;
+        sidebar?: SidebarItemConfig[] | {
+            display?: "flat" | "page" | "group" | undefined;
+            items?: SidebarItemConfig[] | undefined;
+        } | undefined;
         repo?: boolean | undefined;
+        featured?: {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+        }[] | undefined;
         selectors?: {
             label: string;
             kind: "version" | "dropdown" | "language" | "product";
@@ -2104,6 +2247,34 @@ export declare const blumeConfigSchema: z.ZodObject<{
         } | undefined;
     }>>;
     seo: z.ZodDefault<z.ZodObject<{
+        /**
+         * Emit `agent-readability.json` at the site root: a manifest that indexes
+         * the agent-facing surface (llms.txt, Markdown mirrors, MCP server, feeds)
+         * so agents can discover it without scraping HTML.
+         */
+        agentReadability: z.ZodDefault<z.ZodBoolean>;
+        /** robots.txt `Content-Signal` usage declaration (on by default). */
+        contentSignals: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
+            aiInput: z.ZodDefault<z.ZodBoolean>;
+            aiTrain: z.ZodDefault<z.ZodBoolean>;
+            search: z.ZodDefault<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            search: boolean;
+            aiInput: boolean;
+            aiTrain: boolean;
+        }, {
+            search?: boolean | undefined;
+            aiInput?: boolean | undefined;
+            aiTrain?: boolean | undefined;
+        }>]>, {
+            search: boolean;
+            aiInput: boolean;
+            aiTrain: boolean;
+        } | null, boolean | {
+            search?: boolean | undefined;
+            aiInput?: boolean | undefined;
+            aiTrain?: boolean | undefined;
+        }>>;
         og: z.ZodDefault<z.ZodObject<{
             /**
              * Generate a per-page Open Graph image. Defaults to on once a deployment
@@ -2139,6 +2310,12 @@ export declare const blumeConfigSchema: z.ZodObject<{
         /** Emit schema.org JSON-LD in each page's <head>. */
         structuredData: z.ZodDefault<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
+        agentReadability: boolean;
+        contentSignals: {
+            search: boolean;
+            aiInput: boolean;
+            aiTrain: boolean;
+        } | null;
         og: {
             enabled?: boolean | undefined;
         };
@@ -2151,6 +2328,12 @@ export declare const blumeConfigSchema: z.ZodObject<{
         sitemap: boolean;
         structuredData: boolean;
     }, {
+        agentReadability?: boolean | undefined;
+        contentSignals?: boolean | {
+            search?: boolean | undefined;
+            aiInput?: boolean | undefined;
+            aiTrain?: boolean | undefined;
+        } | undefined;
         og?: {
             enabled?: boolean | undefined;
         } | undefined;
@@ -2164,13 +2347,55 @@ export declare const blumeConfigSchema: z.ZodObject<{
         structuredData?: boolean | undefined;
     }>>;
     theme: z.ZodDefault<z.ZodObject<{
-        accent: z.ZodDefault<z.ZodString>;
-        accentDark: z.ZodOptional<z.ZodString>;
+        accent: z.ZodEffects<z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            dark: z.ZodString;
+            light: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            dark: string;
+            light: string;
+        }, {
+            dark: string;
+            light: string;
+        }>]>>, {
+            dark: string;
+            light: string;
+        }, string | {
+            dark: string;
+            light: string;
+        } | undefined>;
         action: z.ZodOptional<z.ZodString>;
-        background: z.ZodOptional<z.ZodString>;
-        backgroundDark: z.ZodOptional<z.ZodString>;
-        backgroundImage: z.ZodOptional<z.ZodString>;
-        backgroundImageDark: z.ZodOptional<z.ZodString>;
+        background: z.ZodEffects<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            dark: z.ZodOptional<z.ZodString>;
+            light: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            dark?: string | undefined;
+            light?: string | undefined;
+        }, {
+            dark?: string | undefined;
+            light?: string | undefined;
+        }>]>>, {
+            dark?: string | undefined;
+            light?: string | undefined;
+        } | undefined, string | {
+            dark?: string | undefined;
+            light?: string | undefined;
+        } | undefined>;
+        backgroundImage: z.ZodEffects<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            dark: z.ZodOptional<z.ZodString>;
+            light: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            dark?: string | undefined;
+            light?: string | undefined;
+        }, {
+            dark?: string | undefined;
+            light?: string | undefined;
+        }>]>>, {
+            dark?: string | undefined;
+            light?: string | undefined;
+        } | undefined, string | {
+            dark?: string | undefined;
+            light?: string | undefined;
+        } | undefined>;
         fonts: z.ZodDefault<z.ZodObject<{
             body: z.ZodDefault<z.ZodEffects<z.ZodString, "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans", string>>;
             display: z.ZodDefault<z.ZodEffects<z.ZodString, "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans", string>>;
@@ -2190,7 +2415,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
         strict: z.ZodDefault<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         strict: boolean;
-        accent: string;
+        accent: {
+            dark: string;
+            light: string;
+        };
         fonts: {
             mono: "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans";
             display: "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans";
@@ -2199,21 +2427,30 @@ export declare const blumeConfigSchema: z.ZodObject<{
         layout: "sidebar";
         mode: "dark" | "light" | "system";
         radius: "md" | "none" | "sm" | "lg";
-        accentDark?: string | undefined;
         action?: string | undefined;
-        background?: string | undefined;
-        backgroundDark?: string | undefined;
-        backgroundImage?: string | undefined;
-        backgroundImageDark?: string | undefined;
+        background?: {
+            dark?: string | undefined;
+            light?: string | undefined;
+        } | undefined;
+        backgroundImage?: {
+            dark?: string | undefined;
+            light?: string | undefined;
+        } | undefined;
     }, {
         strict?: boolean | undefined;
-        accent?: string | undefined;
-        accentDark?: string | undefined;
+        accent?: string | {
+            dark: string;
+            light: string;
+        } | undefined;
         action?: string | undefined;
-        background?: string | undefined;
-        backgroundDark?: string | undefined;
-        backgroundImage?: string | undefined;
-        backgroundImageDark?: string | undefined;
+        background?: string | {
+            dark?: string | undefined;
+            light?: string | undefined;
+        } | undefined;
+        backgroundImage?: string | {
+            dark?: string | undefined;
+            light?: string | undefined;
+        } | undefined;
         fonts?: {
             mono?: string | undefined;
             display?: string | undefined;
@@ -2279,6 +2516,12 @@ export declare const blumeConfigSchema: z.ZodObject<{
         type: "git" | "frontmatter";
     };
     seo: {
+        agentReadability: boolean;
+        contentSignals: {
+            search: boolean;
+            aiInput: boolean;
+            aiTrain: boolean;
+        } | null;
         og: {
             enabled?: boolean | undefined;
         };
@@ -2297,6 +2540,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
             enabled: boolean;
             model: string;
             provider: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible";
+            suggestions: {
+                label: string;
+                icon?: string | undefined;
+            }[];
             apiKeyEnv?: string | undefined;
             baseUrl?: string | undefined;
         } | undefined;
@@ -2370,7 +2617,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
     };
     theme: {
         strict: boolean;
-        accent: string;
+        accent: {
+            dark: string;
+            light: string;
+        };
         fonts: {
             mono: "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans";
             display: "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans";
@@ -2379,12 +2629,15 @@ export declare const blumeConfigSchema: z.ZodObject<{
         layout: "sidebar";
         mode: "dark" | "light" | "system";
         radius: "md" | "none" | "sm" | "lg";
-        accentDark?: string | undefined;
         action?: string | undefined;
-        background?: string | undefined;
-        backgroundDark?: string | undefined;
-        backgroundImage?: string | undefined;
-        backgroundImageDark?: string | undefined;
+        background?: {
+            dark?: string | undefined;
+            light?: string | undefined;
+        } | undefined;
+        backgroundImage?: {
+            dark?: string | undefined;
+            light?: string | undefined;
+        } | undefined;
     };
     asyncapi: {
         enabled: boolean;
@@ -2431,7 +2684,16 @@ export declare const blumeConfigSchema: z.ZodObject<{
         instructions?: string | undefined;
     };
     navigation: {
+        sidebar: {
+            display: "flat" | "page" | "group";
+            items?: SidebarItemConfig[] | undefined;
+        };
         repo: boolean;
+        featured: {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+        }[];
         selectors: {
             label: string;
             items: {
@@ -2443,7 +2705,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
             }[];
             kind: "version" | "dropdown" | "language" | "product";
         }[];
-        sidebar?: SidebarItemConfig[] | undefined;
         tabs?: {
             path: string;
             label: string;
@@ -2564,6 +2825,12 @@ export declare const blumeConfigSchema: z.ZodObject<{
         type?: "git" | "frontmatter" | undefined;
     } | undefined;
     seo?: {
+        agentReadability?: boolean | undefined;
+        contentSignals?: boolean | {
+            search?: boolean | undefined;
+            aiInput?: boolean | undefined;
+            aiTrain?: boolean | undefined;
+        } | undefined;
         og?: {
             enabled?: boolean | undefined;
         } | undefined;
@@ -2583,6 +2850,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
             enabled?: boolean | undefined;
             model?: string | undefined;
             provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible" | undefined;
+            suggestions?: {
+                label: string;
+                icon?: string | undefined;
+            }[] | undefined;
         } | undefined;
         llmsTxt?: boolean | undefined;
     } | undefined;
@@ -2668,13 +2939,19 @@ export declare const blumeConfigSchema: z.ZodObject<{
     } | undefined;
     theme?: {
         strict?: boolean | undefined;
-        accent?: string | undefined;
-        accentDark?: string | undefined;
+        accent?: string | {
+            dark: string;
+            light: string;
+        } | undefined;
         action?: string | undefined;
-        background?: string | undefined;
-        backgroundDark?: string | undefined;
-        backgroundImage?: string | undefined;
-        backgroundImageDark?: string | undefined;
+        background?: string | {
+            dark?: string | undefined;
+            light?: string | undefined;
+        } | undefined;
+        backgroundImage?: string | {
+            dark?: string | undefined;
+            light?: string | undefined;
+        } | undefined;
         fonts?: {
             mono?: string | undefined;
             display?: string | undefined;
@@ -2765,8 +3042,16 @@ export declare const blumeConfigSchema: z.ZodObject<{
         instructions?: string | undefined;
     } | undefined;
     navigation?: {
-        sidebar?: SidebarItemConfig[] | undefined;
+        sidebar?: SidebarItemConfig[] | {
+            display?: "flat" | "page" | "group" | undefined;
+            items?: SidebarItemConfig[] | undefined;
+        } | undefined;
         repo?: boolean | undefined;
+        featured?: {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+        }[] | undefined;
         selectors?: {
             label: string;
             kind: "version" | "dropdown" | "language" | "product";
@@ -2821,4 +3106,8 @@ export type LocaleConfig = z.infer<typeof localeSchema>;
 export type BlumeConfig = z.input<typeof blumeConfigSchema>;
 /** A configured search backend. */
 export type SearchProvider = (typeof searchProviders)[number];
+/** Resolved robots.txt `Content-Signal` preferences (`null` when disabled). */
+export type ContentSignals = z.infer<typeof contentSignalsSchema>;
+/** The resolved per-signal policy object (present when signals are enabled). */
+export type ContentSignalPolicy = NonNullable<ContentSignals>;
 export {};

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

@@ -168,11 +168,19 @@ export interface NavSelector {
     kind: "dropdown" | "language" | "product" | "version";
     items: NavSelectorItem[];
 }
+/** A pinned link rendered above the sidebar sections (external or internal). */
+export interface FeaturedLink {
+    label: string;
+    href: string;
+    icon?: string;
+}
 /** The complete navigation model derived from the content graph. */
 export interface Navigation {
     tabs: NavTab[];
     selectors: NavSelector[];
     sidebar: NavNode[];
+    /** Pinned links shown above the sidebar sections, unscoped by tab. */
+    featured: FeaturedLink[];
     /** Repo URL for the header link, or null when hidden (`navigation.repo`). */
     repoUrl?: string | null;
 }