blume 0.7.0 → 1.0.0

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

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import type { ComponentMarkdown } from "../ai/component-markdown.ts";
 import type { ContentSource } from "./sources/types.ts";
 declare const hydrationMode: z.ZodEnum<["load", "idle", "visible", "media", "only"]>;
 export type HydrationMode = z.infer<typeof hydrationMode>;
@@ -78,18 +79,32 @@ declare const pageMetaBaseSchema: z.ZodObject<{
         image: z.ZodOptional<z.ZodString>;
         noindex: z.ZodDefault<z.ZodBoolean>;
         title: z.ZodOptional<z.ZodString>;
+        /** Per-page X attribution — a guest post credits its own author. */
+        x: z.ZodOptional<z.ZodObject<{
+            creator: z.ZodOptional<z.ZodEffects<z.ZodString, string | undefined, string>>;
+        }, "strict", z.ZodTypeAny, {
+            creator?: string | undefined;
+        }, {
+            creator?: string | undefined;
+        }>>;
     }, "strict", z.ZodTypeAny, {
         noindex: boolean;
         title?: string | undefined;
-        description?: string | undefined;
         image?: string | undefined;
+        description?: string | undefined;
         canonical?: string | undefined;
+        x?: {
+            creator?: string | undefined;
+        } | undefined;
     }, {
         title?: string | undefined;
-        description?: string | undefined;
         image?: string | undefined;
+        description?: string | undefined;
         noindex?: boolean | undefined;
         canonical?: string | undefined;
+        x?: {
+            creator?: string | undefined;
+        } | undefined;
     }>>;
     sidebar: z.ZodDefault<z.ZodObject<{
         badge: z.ZodOptional<z.ZodString>;
@@ -99,48 +114,50 @@ declare const pageMetaBaseSchema: z.ZodObject<{
         order: z.ZodOptional<z.ZodNumber>;
     }, "strict", z.ZodTypeAny, {
         hidden: boolean;
-        label?: string | undefined;
         icon?: string | undefined;
         badge?: string | undefined;
+        label?: string | undefined;
         order?: number | undefined;
     }, {
-        label?: string | undefined;
         hidden?: boolean | undefined;
         icon?: string | undefined;
         badge?: string | undefined;
+        label?: string | undefined;
         order?: number | undefined;
     }>>;
     slug: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     type: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
+    deprecated: boolean;
+    draft: boolean;
+    hidden: boolean;
+    noindex: boolean;
     search: {
         exclude: boolean;
         boost?: number | undefined;
         tags?: string[] | undefined;
     };
-    deprecated: boolean;
-    draft: boolean;
-    hidden: boolean;
-    noindex: boolean;
     seo: {
         noindex: boolean;
         title?: string | undefined;
-        description?: string | undefined;
         image?: string | undefined;
+        description?: string | undefined;
         canonical?: string | undefined;
+        x?: {
+            creator?: string | undefined;
+        } | undefined;
     };
     sidebar: {
         hidden: boolean;
-        label?: string | undefined;
         icon?: string | undefined;
         badge?: string | undefined;
+        label?: string | undefined;
         order?: number | undefined;
     };
     type?: string | undefined;
-    date?: string | undefined;
     title?: string | undefined;
-    description?: string | undefined;
+    date?: string | undefined;
     authors?: string | z.objectOutputType<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
@@ -157,19 +174,14 @@ declare const pageMetaBaseSchema: z.ZodObject<{
         category?: string | undefined;
         version?: string | undefined;
     } | undefined;
+    description?: string | undefined;
     icon?: string | undefined;
     lastModified?: string | undefined;
     slug?: string | undefined;
 }, {
     type?: string | undefined;
-    date?: string | Date | undefined;
     title?: string | undefined;
-    search?: {
-        boost?: number | undefined;
-        exclude?: boolean | undefined;
-        tags?: string[] | undefined;
-    } | undefined;
-    description?: string | undefined;
+    date?: string | Date | undefined;
     authors?: string | z.objectInputType<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
@@ -187,23 +199,32 @@ declare const pageMetaBaseSchema: z.ZodObject<{
         version?: string | undefined;
     } | undefined;
     deprecated?: boolean | undefined;
+    description?: string | undefined;
     draft?: boolean | undefined;
     hidden?: boolean | undefined;
     icon?: string | undefined;
     lastModified?: string | Date | undefined;
     noindex?: boolean | undefined;
+    search?: {
+        boost?: number | undefined;
+        exclude?: boolean | undefined;
+        tags?: string[] | undefined;
+    } | undefined;
     seo?: {
         title?: string | undefined;
-        description?: string | undefined;
         image?: string | undefined;
+        description?: string | undefined;
         noindex?: boolean | undefined;
         canonical?: string | undefined;
+        x?: {
+            creator?: string | undefined;
+        } | undefined;
     } | undefined;
     sidebar?: {
-        label?: string | undefined;
         hidden?: boolean | undefined;
         icon?: string | undefined;
         badge?: string | undefined;
+        label?: string | undefined;
         order?: number | undefined;
     } | undefined;
     slug?: string | undefined;
@@ -283,18 +304,32 @@ export declare const pageMetaSchema: z.ZodObject<{
         image: z.ZodOptional<z.ZodString>;
         noindex: z.ZodDefault<z.ZodBoolean>;
         title: z.ZodOptional<z.ZodString>;
+        /** Per-page X attribution — a guest post credits its own author. */
+        x: z.ZodOptional<z.ZodObject<{
+            creator: z.ZodOptional<z.ZodEffects<z.ZodString, string | undefined, string>>;
+        }, "strict", z.ZodTypeAny, {
+            creator?: string | undefined;
+        }, {
+            creator?: string | undefined;
+        }>>;
     }, "strict", z.ZodTypeAny, {
         noindex: boolean;
         title?: string | undefined;
-        description?: string | undefined;
         image?: string | undefined;
+        description?: string | undefined;
         canonical?: string | undefined;
+        x?: {
+            creator?: string | undefined;
+        } | undefined;
     }, {
         title?: string | undefined;
-        description?: string | undefined;
         image?: string | undefined;
+        description?: string | undefined;
         noindex?: boolean | undefined;
         canonical?: string | undefined;
+        x?: {
+            creator?: string | undefined;
+        } | undefined;
     }>>;
     sidebar: z.ZodDefault<z.ZodObject<{
         badge: z.ZodOptional<z.ZodString>;
@@ -304,48 +339,50 @@ export declare const pageMetaSchema: z.ZodObject<{
         order: z.ZodOptional<z.ZodNumber>;
     }, "strict", z.ZodTypeAny, {
         hidden: boolean;
-        label?: string | undefined;
         icon?: string | undefined;
         badge?: string | undefined;
+        label?: string | undefined;
         order?: number | undefined;
     }, {
-        label?: string | undefined;
         hidden?: boolean | undefined;
         icon?: string | undefined;
         badge?: string | undefined;
+        label?: string | undefined;
         order?: number | undefined;
     }>>;
     slug: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     type: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
+    deprecated: boolean;
+    draft: boolean;
+    hidden: boolean;
+    noindex: boolean;
     search: {
         exclude: boolean;
         boost?: number | undefined;
         tags?: string[] | undefined;
     };
-    deprecated: boolean;
-    draft: boolean;
-    hidden: boolean;
-    noindex: boolean;
     seo: {
         noindex: boolean;
         title?: string | undefined;
-        description?: string | undefined;
         image?: string | undefined;
+        description?: string | undefined;
         canonical?: string | undefined;
+        x?: {
+            creator?: string | undefined;
+        } | undefined;
     };
     sidebar: {
         hidden: boolean;
-        label?: string | undefined;
         icon?: string | undefined;
         badge?: string | undefined;
+        label?: string | undefined;
         order?: number | undefined;
     };
     type?: string | undefined;
-    date?: string | undefined;
     title?: string | undefined;
-    description?: string | undefined;
+    date?: string | undefined;
     authors?: string | z.objectOutputType<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
@@ -362,19 +399,14 @@ export declare const pageMetaSchema: z.ZodObject<{
         category?: string | undefined;
         version?: string | undefined;
     } | undefined;
+    description?: string | undefined;
     icon?: string | undefined;
     lastModified?: string | undefined;
     slug?: string | undefined;
 }, {
     type?: string | undefined;
-    date?: string | Date | undefined;
     title?: string | undefined;
-    search?: {
-        boost?: number | undefined;
-        exclude?: boolean | undefined;
-        tags?: string[] | undefined;
-    } | undefined;
-    description?: string | undefined;
+    date?: string | Date | undefined;
     authors?: string | z.objectInputType<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
@@ -392,23 +424,32 @@ export declare const pageMetaSchema: z.ZodObject<{
         version?: string | undefined;
     } | undefined;
     deprecated?: boolean | undefined;
+    description?: string | undefined;
     draft?: boolean | undefined;
     hidden?: boolean | undefined;
     icon?: string | undefined;
     lastModified?: string | Date | undefined;
     noindex?: boolean | undefined;
+    search?: {
+        boost?: number | undefined;
+        exclude?: boolean | undefined;
+        tags?: string[] | undefined;
+    } | undefined;
     seo?: {
         title?: string | undefined;
-        description?: string | undefined;
         image?: string | undefined;
+        description?: string | undefined;
         noindex?: boolean | undefined;
         canonical?: string | undefined;
+        x?: {
+            creator?: string | undefined;
+        } | undefined;
     } | undefined;
     sidebar?: {
-        label?: string | undefined;
         hidden?: boolean | undefined;
         icon?: string | undefined;
         badge?: string | undefined;
+        label?: string | undefined;
         order?: number | undefined;
     } | undefined;
     slug?: string | undefined;
@@ -455,15 +496,15 @@ declare const contentSourceSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
     type: z.ZodLiteral<"filesystem">;
 }, "strict", z.ZodTypeAny, {
     type: "filesystem";
+    root: string;
     exclude: string[];
     include: string[];
-    root: string;
     prefix?: string | undefined;
 }, {
     type: "filesystem";
+    root?: string | undefined;
     exclude?: string[] | undefined;
     include?: string[] | undefined;
-    root?: string | undefined;
     prefix?: string | undefined;
 }>, z.ZodObject<{
     /** Explicit list of source-relative file paths to fetch from `url`. */
@@ -566,14 +607,14 @@ declare const contentSourceSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
         slug: z.ZodOptional<z.ZodString>;
         title: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
-        body?: string | undefined;
         title?: string | undefined;
+        body?: string | undefined;
         description?: string | undefined;
         lastModified?: string | undefined;
         slug?: string | undefined;
     }, {
-        body?: string | undefined;
         title?: string | undefined;
+        body?: string | undefined;
         description?: string | undefined;
         lastModified?: string | undefined;
         slug?: string | undefined;
@@ -594,8 +635,8 @@ declare const contentSourceSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
     pollInterval?: number | undefined;
     apiVersion?: string | undefined;
     fields?: {
-        body?: string | undefined;
         title?: string | undefined;
+        body?: string | undefined;
         description?: string | undefined;
         lastModified?: string | undefined;
         slug?: string | undefined;
@@ -609,8 +650,8 @@ declare const contentSourceSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
     pollInterval?: number | undefined;
     apiVersion?: string | undefined;
     fields?: {
-        body?: string | undefined;
         title?: string | undefined;
+        body?: string | undefined;
         description?: string | undefined;
         lastModified?: string | undefined;
         slug?: string | undefined;
@@ -628,14 +669,14 @@ declare const contentSourceSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
         status: z.ZodOptional<z.ZodString>;
         title: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
-        status?: string | undefined;
         title?: string | undefined;
+        status?: string | undefined;
         description?: string | undefined;
         order?: string | undefined;
         slug?: string | undefined;
     }, {
-        status?: string | undefined;
         title?: string | undefined;
+        status?: string | undefined;
         description?: string | undefined;
         order?: string | undefined;
         slug?: string | undefined;
@@ -649,8 +690,8 @@ declare const contentSourceSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
     prefix?: string | undefined;
     pollInterval?: number | undefined;
     properties?: {
-        status?: string | undefined;
         title?: string | undefined;
+        status?: string | undefined;
         description?: string | undefined;
         order?: string | undefined;
         slug?: string | undefined;
@@ -662,8 +703,8 @@ declare const contentSourceSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
     prefix?: string | undefined;
     pollInterval?: number | undefined;
     properties?: {
-        status?: string | undefined;
         title?: string | undefined;
+        status?: string | undefined;
         description?: string | undefined;
         order?: string | undefined;
         slug?: string | undefined;
@@ -756,9 +797,34 @@ declare const aiConfigSchema: z.ZodObject<{
             icon?: string | undefined;
         }[] | undefined;
     }>>;
-    llmsTxt: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * `llms.txt`/`llms-full.txt` emission. A bare boolean toggles it; the object
+     * form adds `openapi: false` to keep generated API reference pages out of
+     * both files (e.g. when the configured spec is example content).
+     */
+    llmsTxt: z.ZodEffects<z.ZodDefault<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        openapi: z.ZodDefault<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        enabled: boolean;
+        openapi: boolean;
+    }, {
+        enabled?: boolean | undefined;
+        openapi?: boolean | undefined;
+    }>]>>, {
+        enabled: boolean;
+        openapi: boolean;
+    }, boolean | {
+        enabled?: boolean | undefined;
+        openapi?: boolean | undefined;
+    } | undefined>;
+    markdownComponents: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<ComponentMarkdown, z.ZodTypeDef, ComponentMarkdown>>>;
 }, "strict", z.ZodTypeAny, {
-    llmsTxt: boolean;
+    llmsTxt: {
+        enabled: boolean;
+        openapi: boolean;
+    };
+    markdownComponents: Record<string, ComponentMarkdown>;
     ask?: {
         enabled: boolean;
         model: string;
@@ -782,7 +848,11 @@ declare const aiConfigSchema: z.ZodObject<{
             icon?: string | undefined;
         }[] | undefined;
     } | undefined;
-    llmsTxt?: boolean | undefined;
+    llmsTxt?: boolean | {
+        enabled?: boolean | undefined;
+        openapi?: boolean | undefined;
+    } | undefined;
+    markdownComponents?: Record<string, ComponentMarkdown> | undefined;
 }>;
 export type AskAiProvider = (typeof askAiProviders)[number];
 export type AskAiConfig = NonNullable<z.infer<typeof aiConfigSchema>["ask"]>;
@@ -983,9 +1053,34 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 icon?: string | undefined;
             }[] | undefined;
         }>>;
-        llmsTxt: z.ZodDefault<z.ZodBoolean>;
+        /**
+         * `llms.txt`/`llms-full.txt` emission. A bare boolean toggles it; the object
+         * form adds `openapi: false` to keep generated API reference pages out of
+         * both files (e.g. when the configured spec is example content).
+         */
+        llmsTxt: z.ZodEffects<z.ZodDefault<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            openapi: z.ZodDefault<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            enabled: boolean;
+            openapi: boolean;
+        }, {
+            enabled?: boolean | undefined;
+            openapi?: boolean | undefined;
+        }>]>>, {
+            enabled: boolean;
+            openapi: boolean;
+        }, boolean | {
+            enabled?: boolean | undefined;
+            openapi?: boolean | undefined;
+        } | undefined>;
+        markdownComponents: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<ComponentMarkdown, z.ZodTypeDef, ComponentMarkdown>>>;
     }, "strict", z.ZodTypeAny, {
-        llmsTxt: boolean;
+        llmsTxt: {
+            enabled: boolean;
+            openapi: boolean;
+        };
+        markdownComponents: Record<string, ComponentMarkdown>;
         ask?: {
             enabled: boolean;
             model: string;
@@ -1009,7 +1104,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 icon?: string | undefined;
             }[] | undefined;
         } | undefined;
-        llmsTxt?: boolean | undefined;
+        llmsTxt?: boolean | {
+            enabled?: boolean | undefined;
+            openapi?: boolean | undefined;
+        } | undefined;
+        markdownComponents?: Record<string, ComponentMarkdown> | undefined;
     }>>;
     analytics: z.ZodOptional<z.ZodObject<{
         posthog: z.ZodOptional<z.ZodObject<{
@@ -1126,28 +1225,28 @@ export declare const blumeConfigSchema: z.ZodObject<{
             href: z.ZodString;
             text: z.ZodString;
         }, "strict", z.ZodTypeAny, {
-            href: string;
             text: string;
-        }, {
             href: string;
+        }, {
             text: string;
+            href: string;
         }>>;
     }, "strict", z.ZodTypeAny, {
         content: string;
         dismissible: boolean;
         id?: string | undefined;
         link?: {
-            href: string;
             text: string;
+            href: string;
         } | undefined;
     }, {
         content: string;
         id?: string | undefined;
-        dismissible?: boolean | undefined;
         link?: {
-            href: string;
             text: string;
+            href: string;
         } | undefined;
+        dismissible?: boolean | undefined;
     }>]>>;
     /**
      * Site-wide mount point prepended to every generated route (e.g. `/docs`),
@@ -1176,15 +1275,15 @@ export declare const blumeConfigSchema: z.ZodObject<{
             type: z.ZodLiteral<"filesystem">;
         }, "strict", z.ZodTypeAny, {
             type: "filesystem";
+            root: string;
             exclude: string[];
             include: string[];
-            root: string;
             prefix?: string | undefined;
         }, {
             type: "filesystem";
+            root?: string | undefined;
             exclude?: string[] | undefined;
             include?: string[] | undefined;
-            root?: string | undefined;
             prefix?: string | undefined;
         }>, z.ZodObject<{
             /** Explicit list of source-relative file paths to fetch from `url`. */
@@ -1287,14 +1386,14 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 slug: z.ZodOptional<z.ZodString>;
                 title: z.ZodOptional<z.ZodString>;
             }, "strict", z.ZodTypeAny, {
-                body?: string | undefined;
                 title?: string | undefined;
+                body?: string | undefined;
                 description?: string | undefined;
                 lastModified?: string | undefined;
                 slug?: string | undefined;
             }, {
-                body?: string | undefined;
                 title?: string | undefined;
+                body?: string | undefined;
                 description?: string | undefined;
                 lastModified?: string | undefined;
                 slug?: string | undefined;
@@ -1315,8 +1414,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             pollInterval?: number | undefined;
             apiVersion?: string | undefined;
             fields?: {
-                body?: string | undefined;
                 title?: string | undefined;
+                body?: string | undefined;
                 description?: string | undefined;
                 lastModified?: string | undefined;
                 slug?: string | undefined;
@@ -1330,8 +1429,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             pollInterval?: number | undefined;
             apiVersion?: string | undefined;
             fields?: {
-                body?: string | undefined;
                 title?: string | undefined;
+                body?: string | undefined;
                 description?: string | undefined;
                 lastModified?: string | undefined;
                 slug?: string | undefined;
@@ -1349,14 +1448,14 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 status: z.ZodOptional<z.ZodString>;
                 title: z.ZodOptional<z.ZodString>;
             }, "strict", z.ZodTypeAny, {
-                status?: string | undefined;
                 title?: string | undefined;
+                status?: string | undefined;
                 description?: string | undefined;
                 order?: string | undefined;
                 slug?: string | undefined;
             }, {
-                status?: string | undefined;
                 title?: string | undefined;
+                status?: string | undefined;
                 description?: string | undefined;
                 order?: string | undefined;
                 slug?: string | undefined;
@@ -1370,8 +1469,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             prefix?: string | undefined;
             pollInterval?: number | undefined;
             properties?: {
-                status?: string | undefined;
                 title?: string | undefined;
+                status?: string | undefined;
                 description?: string | undefined;
                 order?: string | undefined;
                 slug?: string | undefined;
@@ -1383,8 +1482,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             prefix?: string | undefined;
             pollInterval?: number | undefined;
             properties?: {
-                status?: string | undefined;
                 title?: string | undefined;
+                status?: string | undefined;
                 description?: string | undefined;
                 order?: string | undefined;
                 slug?: string | undefined;
@@ -1401,16 +1500,16 @@ export declare const blumeConfigSchema: z.ZodObject<{
             source: ContentSource;
         }>]>, "many">>;
     }, "strict", z.ZodTypeAny, {
+        root: string;
         exclude: string[];
         defaultType: string;
         include: string[];
         pages: string;
-        root: string;
         sources?: ({
             type: "filesystem";
+            root: string;
             exclude: string[];
             include: string[];
-            root: string;
             prefix?: string | undefined;
         } | {
             type: "mdx-remote";
@@ -1443,8 +1542,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             pollInterval?: number | undefined;
             apiVersion?: string | undefined;
             fields?: {
-                body?: string | undefined;
                 title?: string | undefined;
+                body?: string | undefined;
                 description?: string | undefined;
                 lastModified?: string | undefined;
                 slug?: string | undefined;
@@ -1455,8 +1554,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             prefix?: string | undefined;
             pollInterval?: number | undefined;
             properties?: {
-                status?: string | undefined;
                 title?: string | undefined;
+                status?: string | undefined;
                 description?: string | undefined;
                 order?: string | undefined;
                 slug?: string | undefined;
@@ -1467,12 +1566,13 @@ export declare const blumeConfigSchema: z.ZodObject<{
             source: ContentSource;
         })[] | undefined;
     }, {
+        root?: string | undefined;
         exclude?: string[] | undefined;
         sources?: ({
             type: "filesystem";
+            root?: string | undefined;
             exclude?: string[] | undefined;
             include?: string[] | undefined;
-            root?: string | undefined;
             prefix?: string | undefined;
         } | {
             type: "mdx-remote";
@@ -1505,8 +1605,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             pollInterval?: number | undefined;
             apiVersion?: string | undefined;
             fields?: {
-                body?: string | undefined;
                 title?: string | undefined;
+                body?: string | undefined;
                 description?: string | undefined;
                 lastModified?: string | undefined;
                 slug?: string | undefined;
@@ -1517,8 +1617,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             prefix?: string | undefined;
             pollInterval?: number | undefined;
             properties?: {
-                status?: string | undefined;
                 title?: string | undefined;
+                status?: string | undefined;
                 description?: string | undefined;
                 order?: string | undefined;
                 slug?: string | undefined;
@@ -1531,7 +1631,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
         defaultType?: string | undefined;
         include?: string[] | undefined;
         pages?: string | undefined;
-        root?: string | undefined;
     }>>;
     deployment: z.ZodDefault<z.ZodObject<{
         adapter: z.ZodDefault<z.ZodNullable<z.ZodEnum<["vercel", "node", "netlify", "cloudflare"]>>>;
@@ -1705,16 +1804,16 @@ export declare const blumeConfigSchema: z.ZodObject<{
             dark?: string | undefined;
             light?: string | undefined;
         } | undefined;
-        href?: string | undefined;
         text?: string | undefined;
+        href?: string | undefined;
     }, {
         image?: string | {
             alt?: string | undefined;
             dark?: string | undefined;
             light?: string | undefined;
         } | undefined;
-        href?: string | undefined;
         text?: string | undefined;
+        href?: string | undefined;
     }>]>>;
     markdown: z.ZodDefault<z.ZodObject<{
         /** Code-block rendering: language icons and line wrapping. */
@@ -1802,7 +1901,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
         instructions: z.ZodOptional<z.ZodString>;
         /** Server name shown to clients; defaults to the site title. */
         name: z.ZodOptional<z.ZodString>;
-        route: z.ZodDefault<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;
@@ -2321,7 +2424,24 @@ export declare const blumeConfigSchema: z.ZodObject<{
         sitemap: z.ZodDefault<z.ZodBoolean>;
         /** Emit schema.org JSON-LD in each page's <head>. */
         structuredData: z.ZodDefault<z.ZodBoolean>;
+        /** X (Twitter) account attribution for share cards. */
+        x: z.ZodDefault<z.ZodObject<{
+            /** The author's account, overridable per page via `seo.x.creator`. */
+            creator: z.ZodOptional<z.ZodEffects<z.ZodString, string | undefined, string>>;
+            /** The site's own account, e.g. `@blume`. */
+            handle: z.ZodOptional<z.ZodEffects<z.ZodString, string | undefined, string>>;
+        }, "strict", z.ZodTypeAny, {
+            creator?: string | undefined;
+            handle?: string | undefined;
+        }, {
+            creator?: string | undefined;
+            handle?: string | undefined;
+        }>>;
     }, "strict", z.ZodTypeAny, {
+        x: {
+            creator?: string | undefined;
+            handle?: string | undefined;
+        };
         agentReadability: boolean;
         contentSignals: {
             search: boolean;
@@ -2340,6 +2460,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
         sitemap: boolean;
         structuredData: boolean;
     }, {
+        x?: {
+            creator?: string | undefined;
+            handle?: string | undefined;
+        } | undefined;
         agentReadability?: boolean | undefined;
         contentSignals?: boolean | {
             search?: boolean | undefined;
@@ -2470,7 +2594,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
         radius?: "md" | "none" | "sm" | "lg" | undefined;
     }>>;
     title: z.ZodDefault<z.ZodString>;
-    toc: z.ZodEffects<z.ZodDefault<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
+    toc: z.ZodEffects<z.ZodEffects<z.ZodDefault<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
         maxHeadingLevel: z.ZodOptional<z.ZodNumber>;
         minHeadingLevel: z.ZodOptional<z.ZodNumber>;
     }, "strict", z.ZodTypeAny, {
@@ -2486,10 +2610,19 @@ export declare const blumeConfigSchema: z.ZodObject<{
     }, boolean | {
         maxHeadingLevel?: number | undefined;
         minHeadingLevel?: number | undefined;
+    } | undefined>, {
+        enabled: boolean;
+        maxLevel: number;
+        minLevel: number;
+    }, boolean | {
+        maxHeadingLevel?: number | undefined;
+        minHeadingLevel?: number | undefined;
     } | undefined>;
 }, "strict", z.ZodTypeAny, {
     title: string;
-    feedback: boolean;
+    lastModified: boolean | {
+        type: "git" | "frontmatter";
+    };
     search: {
         provider: "none" | "algolia" | "mixedbread" | "orama" | "pagefind" | "flexsearch" | "orama-cloud" | "typesense";
         indexing: {
@@ -2516,15 +2649,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
             protocol?: "http" | "https" | undefined;
         } | undefined;
     };
-    toc: {
-        enabled: boolean;
-        maxLevel: number;
-        minLevel: number;
-    };
-    lastModified: boolean | {
-        type: "git" | "frontmatter";
-    };
     seo: {
+        x: {
+            creator?: string | undefined;
+            handle?: string | undefined;
+        };
         agentReadability: boolean;
         contentSignals: {
             search: boolean;
@@ -2543,8 +2672,26 @@ export declare const blumeConfigSchema: z.ZodObject<{
         sitemap: boolean;
         structuredData: boolean;
     };
+    openapi: {
+        enabled: boolean;
+        route: string;
+        sources: {
+            spec: string;
+            label?: string | undefined;
+            route?: string | undefined;
+        }[];
+        codeSamples: string[];
+        expandSchemas: boolean;
+        renderer: "blume" | "scalar";
+        spec?: string | undefined;
+        theme?: string | undefined;
+    };
     ai: {
-        llmsTxt: boolean;
+        llmsTxt: {
+            enabled: boolean;
+            openapi: boolean;
+        };
+        markdownComponents: Record<string, ComponentMarkdown>;
         ask?: {
             enabled: boolean;
             model: string;
@@ -2558,16 +2705,16 @@ export declare const blumeConfigSchema: z.ZodObject<{
         } | undefined;
     };
     content: {
+        root: string;
         exclude: string[];
         defaultType: string;
         include: string[];
         pages: string;
-        root: string;
         sources?: ({
             type: "filesystem";
+            root: string;
             exclude: string[];
             include: string[];
-            root: string;
             prefix?: string | undefined;
         } | {
             type: "mdx-remote";
@@ -2600,8 +2747,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             pollInterval?: number | undefined;
             apiVersion?: string | undefined;
             fields?: {
-                body?: string | undefined;
                 title?: string | undefined;
+                body?: string | undefined;
                 description?: string | undefined;
                 lastModified?: string | undefined;
                 slug?: string | undefined;
@@ -2612,8 +2759,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             prefix?: string | undefined;
             pollInterval?: number | undefined;
             properties?: {
-                status?: string | undefined;
                 title?: string | undefined;
+                status?: string | undefined;
                 description?: string | undefined;
                 order?: string | undefined;
                 slug?: string | undefined;
@@ -2673,6 +2820,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
         epub: boolean;
         pdf: boolean;
     };
+    feedback: boolean;
     markdown: {
         code: {
             icons: boolean;
@@ -2728,20 +2876,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
             }[] | undefined;
         }[] | undefined;
     };
-    openapi: {
-        enabled: boolean;
-        route: string;
-        sources: {
-            spec: string;
-            label?: string | undefined;
-            route?: string | undefined;
-        }[];
-        codeSamples: string[];
-        expandSchemas: boolean;
-        renderer: "blume" | "scalar";
-        spec?: string | undefined;
-        theme?: string | undefined;
-    };
     react: {
         compiler: boolean;
     };
@@ -2750,6 +2884,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
         from: string;
         to: string;
     }[];
+    toc: {
+        enabled: boolean;
+        maxLevel: number;
+        minLevel: number;
+    };
     description?: string | undefined;
     analytics?: {
         posthog?: {
@@ -2769,8 +2908,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
         dismissible: boolean;
         id?: string | undefined;
         link?: {
-            href: string;
             text: string;
+            href: string;
         } | undefined;
     } | undefined;
     github?: {
@@ -2797,12 +2936,15 @@ export declare const blumeConfigSchema: z.ZodObject<{
             dark?: string | undefined;
             light?: string | undefined;
         } | undefined;
-        href?: string | undefined;
         text?: string | undefined;
+        href?: string | undefined;
     } | undefined;
 }, {
     title?: string | undefined;
-    feedback?: boolean | undefined;
+    description?: string | undefined;
+    lastModified?: boolean | {
+        type?: "git" | "frontmatter" | undefined;
+    } | undefined;
     search?: {
         provider?: "none" | "algolia" | "mixedbread" | "orama" | "pagefind" | "flexsearch" | "orama-cloud" | "typesense" | undefined;
         algolia?: {
@@ -2829,15 +2971,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
             protocol?: "http" | "https" | undefined;
         } | undefined;
     } | undefined;
-    toc?: boolean | {
-        maxHeadingLevel?: number | undefined;
-        minHeadingLevel?: number | undefined;
-    } | undefined;
-    description?: string | undefined;
-    lastModified?: boolean | {
-        type?: "git" | "frontmatter" | undefined;
-    } | undefined;
     seo?: {
+        x?: {
+            creator?: string | undefined;
+            handle?: string | undefined;
+        } | undefined;
         agentReadability?: boolean | undefined;
         contentSignals?: boolean | {
             search?: boolean | undefined;
@@ -2856,6 +2994,20 @@ export declare const blumeConfigSchema: z.ZodObject<{
         sitemap?: boolean | undefined;
         structuredData?: boolean | undefined;
     } | undefined;
+    openapi?: {
+        enabled?: boolean | undefined;
+        route?: string | undefined;
+        spec?: string | undefined;
+        sources?: {
+            spec: string;
+            label?: string | undefined;
+            route?: string | undefined;
+        }[] | undefined;
+        theme?: string | undefined;
+        codeSamples?: string[] | undefined;
+        expandSchemas?: boolean | undefined;
+        renderer?: "blume" | "scalar" | undefined;
+    } | undefined;
     ai?: {
         ask?: {
             apiKeyEnv?: string | undefined;
@@ -2868,15 +3020,20 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 icon?: string | undefined;
             }[] | undefined;
         } | undefined;
-        llmsTxt?: boolean | undefined;
+        llmsTxt?: boolean | {
+            enabled?: boolean | undefined;
+            openapi?: boolean | undefined;
+        } | undefined;
+        markdownComponents?: Record<string, ComponentMarkdown> | undefined;
     } | undefined;
     content?: {
+        root?: string | undefined;
         exclude?: string[] | undefined;
         sources?: ({
             type: "filesystem";
+            root?: string | undefined;
             exclude?: string[] | undefined;
             include?: string[] | undefined;
-            root?: string | undefined;
             prefix?: string | undefined;
         } | {
             type: "mdx-remote";
@@ -2909,8 +3066,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             pollInterval?: number | undefined;
             apiVersion?: string | undefined;
             fields?: {
-                body?: string | undefined;
                 title?: string | undefined;
+                body?: string | undefined;
                 description?: string | undefined;
                 lastModified?: string | undefined;
                 slug?: string | undefined;
@@ -2921,8 +3078,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             prefix?: string | undefined;
             pollInterval?: number | undefined;
             properties?: {
-                status?: string | undefined;
                 title?: string | undefined;
+                status?: string | undefined;
                 description?: string | undefined;
                 order?: string | undefined;
                 slug?: string | undefined;
@@ -2935,7 +3092,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
         defaultType?: string | undefined;
         include?: string[] | undefined;
         pages?: string | undefined;
-        root?: string | undefined;
     } | undefined;
     analytics?: {
         posthog?: {
@@ -2987,11 +3143,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
     banner?: string | {
         content: string;
         id?: string | undefined;
-        dismissible?: boolean | undefined;
         link?: {
-            href: string;
             text: string;
+            href: string;
         } | undefined;
+        dismissible?: boolean | undefined;
     } | undefined;
     basePath?: string | undefined;
     github?: {
@@ -3014,6 +3170,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
         epub?: boolean | undefined;
         pdf?: boolean | undefined;
     } | undefined;
+    feedback?: boolean | undefined;
     i18n?: {
         locales: {
             code: string;
@@ -3032,8 +3189,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             dark?: string | undefined;
             light?: string | undefined;
         } | undefined;
-        href?: string | undefined;
         text?: string | undefined;
+        href?: string | undefined;
     } | undefined;
     markdown?: {
         code?: {
@@ -3090,20 +3247,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
             }[] | undefined;
         }[] | undefined;
     } | undefined;
-    openapi?: {
-        enabled?: boolean | undefined;
-        route?: string | undefined;
-        spec?: string | undefined;
-        sources?: {
-            spec: string;
-            label?: string | undefined;
-            route?: string | undefined;
-        }[] | undefined;
-        theme?: string | undefined;
-        codeSamples?: string[] | undefined;
-        expandSchemas?: boolean | undefined;
-        renderer?: "blume" | "scalar" | undefined;
-    } | undefined;
     react?: {
         compiler?: boolean | undefined;
     } | undefined;
@@ -3112,6 +3255,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
         to: string;
         status?: 301 | 302 | 307 | 308 | undefined;
     }[] | undefined;
+    toc?: boolean | {
+        maxHeadingLevel?: number | undefined;
+        minHeadingLevel?: number | undefined;
+    } | undefined;
 }>;
 /** Resolved config: every field present after defaults are applied. */
 export type ResolvedConfig = z.infer<typeof blumeConfigSchema>;