blume 1.0.3 → 1.1.0

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

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import type { ComponentMarkdown } from "../ai/component-markdown.ts";
 import type { ContentSource } from "./sources/types.ts";
+import type { StandardSchema } from "./standard-schema.ts";
 declare const hydrationMode: z.ZodEnum<["load", "idle", "visible", "media", "only"]>;
 export type HydrationMode = z.infer<typeof hydrationMode>;
 /** Frontmatter accepted on any content page. */
@@ -43,12 +44,12 @@ declare const pageMetaBaseSchema: z.ZodObject<{
         version: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
         date?: string | undefined;
-        category?: string | undefined;
         version?: string | undefined;
+        category?: string | undefined;
     }, {
         date?: string | Date | undefined;
-        category?: string | undefined;
         version?: string | undefined;
+        category?: string | undefined;
     }>>;
     /** Publish date for feed-backed content like blog/changelog. */
     date: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodDate]>, string, string | Date>>;
@@ -69,8 +70,8 @@ declare const pageMetaBaseSchema: z.ZodObject<{
         boost?: number | undefined;
         tags?: string[] | undefined;
     }, {
-        boost?: number | undefined;
         exclude?: boolean | undefined;
+        boost?: number | undefined;
         tags?: string[] | undefined;
     }>>;
     seo: z.ZodDefault<z.ZodObject<{
@@ -92,19 +93,19 @@ declare const pageMetaBaseSchema: z.ZodObject<{
         title?: string | undefined;
         image?: string | undefined;
         description?: string | undefined;
-        canonical?: string | undefined;
         x?: {
             creator?: string | undefined;
         } | undefined;
+        canonical?: string | undefined;
     }, {
         title?: string | undefined;
         image?: string | undefined;
         description?: string | undefined;
-        noindex?: boolean | undefined;
-        canonical?: string | undefined;
         x?: {
             creator?: string | undefined;
         } | undefined;
+        noindex?: boolean | undefined;
+        canonical?: string | undefined;
     }>>;
     sidebar: z.ZodDefault<z.ZodObject<{
         badge: z.ZodOptional<z.ZodString>;
@@ -115,24 +116,27 @@ declare const pageMetaBaseSchema: z.ZodObject<{
     }, "strict", z.ZodTypeAny, {
         hidden: boolean;
         icon?: string | undefined;
-        badge?: string | undefined;
         label?: string | undefined;
         order?: number | undefined;
+        badge?: string | undefined;
     }, {
-        hidden?: boolean | undefined;
         icon?: string | undefined;
-        badge?: string | undefined;
         label?: string | undefined;
         order?: number | undefined;
+        hidden?: boolean | undefined;
+        badge?: string | 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;
+    sidebar: {
+        hidden: boolean;
+        icon?: string | undefined;
+        label?: string | undefined;
+        order?: number | undefined;
+        badge?: string | undefined;
+    };
     search: {
         exclude: boolean;
         boost?: number | undefined;
@@ -143,21 +147,27 @@ declare const pageMetaBaseSchema: z.ZodObject<{
         title?: string | undefined;
         image?: string | undefined;
         description?: string | undefined;
-        canonical?: string | undefined;
         x?: {
             creator?: string | undefined;
         } | undefined;
+        canonical?: string | undefined;
     };
-    sidebar: {
-        hidden: boolean;
-        icon?: string | undefined;
-        badge?: string | undefined;
-        label?: string | undefined;
-        order?: number | undefined;
-    };
+    deprecated: boolean;
+    draft: boolean;
+    hidden: boolean;
+    noindex: boolean;
     type?: string | undefined;
     title?: string | undefined;
     date?: string | undefined;
+    icon?: string | undefined;
+    description?: string | undefined;
+    lastModified?: string | undefined;
+    slug?: string | undefined;
+    changelog?: {
+        date?: string | undefined;
+        version?: string | undefined;
+        category?: string | undefined;
+    } | undefined;
     authors?: string | z.objectOutputType<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
@@ -169,65 +179,56 @@ declare const pageMetaBaseSchema: z.ZodObject<{
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
     }, z.ZodUnknown, "strip">)[] | undefined;
-    changelog?: {
-        date?: string | undefined;
-        category?: string | undefined;
-        version?: string | undefined;
-    } | undefined;
-    description?: string | undefined;
-    icon?: string | undefined;
-    lastModified?: string | undefined;
-    slug?: string | undefined;
 }, {
     type?: string | undefined;
     title?: string | undefined;
     date?: string | Date | undefined;
-    authors?: string | z.objectInputType<{
-        avatar: z.ZodOptional<z.ZodString>;
-        image: z.ZodOptional<z.ZodString>;
-        name: z.ZodString;
-        url: z.ZodOptional<z.ZodString>;
-    }, z.ZodUnknown, "strip"> | (string | z.objectInputType<{
-        avatar: z.ZodOptional<z.ZodString>;
-        image: z.ZodOptional<z.ZodString>;
-        name: z.ZodString;
-        url: z.ZodOptional<z.ZodString>;
-    }, z.ZodUnknown, "strip">)[] | undefined;
-    changelog?: {
-        date?: string | Date | undefined;
-        category?: string | undefined;
-        version?: string | undefined;
-    } | undefined;
-    deprecated?: boolean | undefined;
-    description?: string | undefined;
-    draft?: boolean | undefined;
-    hidden?: boolean | undefined;
     icon?: string | undefined;
+    description?: string | undefined;
     lastModified?: string | Date | undefined;
-    noindex?: boolean | undefined;
+    slug?: string | undefined;
+    sidebar?: {
+        icon?: string | undefined;
+        label?: string | undefined;
+        order?: number | undefined;
+        hidden?: boolean | undefined;
+        badge?: string | undefined;
+    } | undefined;
     search?: {
-        boost?: number | undefined;
         exclude?: boolean | undefined;
+        boost?: number | undefined;
         tags?: string[] | undefined;
     } | undefined;
+    changelog?: {
+        date?: string | Date | undefined;
+        version?: string | undefined;
+        category?: string | undefined;
+    } | undefined;
     seo?: {
         title?: string | undefined;
         image?: string | undefined;
         description?: string | undefined;
-        noindex?: boolean | undefined;
-        canonical?: string | undefined;
         x?: {
             creator?: string | undefined;
         } | undefined;
+        noindex?: boolean | undefined;
+        canonical?: string | undefined;
     } | undefined;
-    sidebar?: {
-        hidden?: boolean | undefined;
-        icon?: string | undefined;
-        badge?: string | undefined;
-        label?: string | undefined;
-        order?: number | undefined;
-    } | undefined;
-    slug?: string | undefined;
+    deprecated?: boolean | undefined;
+    authors?: string | z.objectInputType<{
+        avatar: z.ZodOptional<z.ZodString>;
+        image: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.ZodUnknown, "strip"> | (string | z.objectInputType<{
+        avatar: z.ZodOptional<z.ZodString>;
+        image: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.ZodUnknown, "strip">)[] | undefined;
+    draft?: boolean | undefined;
+    hidden?: boolean | undefined;
+    noindex?: boolean | undefined;
 }>;
 export declare const pageMetaSchema: z.ZodObject<{
     /** Post author(s) for blog/changelog content; preserved, not yet rendered. */
@@ -268,12 +269,12 @@ export declare const pageMetaSchema: z.ZodObject<{
         version: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
         date?: string | undefined;
-        category?: string | undefined;
         version?: string | undefined;
+        category?: string | undefined;
     }, {
         date?: string | Date | undefined;
-        category?: string | undefined;
         version?: string | undefined;
+        category?: string | undefined;
     }>>;
     /** Publish date for feed-backed content like blog/changelog. */
     date: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodDate]>, string, string | Date>>;
@@ -294,8 +295,8 @@ export declare const pageMetaSchema: z.ZodObject<{
         boost?: number | undefined;
         tags?: string[] | undefined;
     }, {
-        boost?: number | undefined;
         exclude?: boolean | undefined;
+        boost?: number | undefined;
         tags?: string[] | undefined;
     }>>;
     seo: z.ZodDefault<z.ZodObject<{
@@ -317,19 +318,19 @@ export declare const pageMetaSchema: z.ZodObject<{
         title?: string | undefined;
         image?: string | undefined;
         description?: string | undefined;
-        canonical?: string | undefined;
         x?: {
             creator?: string | undefined;
         } | undefined;
+        canonical?: string | undefined;
     }, {
         title?: string | undefined;
         image?: string | undefined;
         description?: string | undefined;
-        noindex?: boolean | undefined;
-        canonical?: string | undefined;
         x?: {
             creator?: string | undefined;
         } | undefined;
+        noindex?: boolean | undefined;
+        canonical?: string | undefined;
     }>>;
     sidebar: z.ZodDefault<z.ZodObject<{
         badge: z.ZodOptional<z.ZodString>;
@@ -340,24 +341,27 @@ export declare const pageMetaSchema: z.ZodObject<{
     }, "strict", z.ZodTypeAny, {
         hidden: boolean;
         icon?: string | undefined;
-        badge?: string | undefined;
         label?: string | undefined;
         order?: number | undefined;
+        badge?: string | undefined;
     }, {
-        hidden?: boolean | undefined;
         icon?: string | undefined;
-        badge?: string | undefined;
         label?: string | undefined;
         order?: number | undefined;
+        hidden?: boolean | undefined;
+        badge?: string | 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;
+    sidebar: {
+        hidden: boolean;
+        icon?: string | undefined;
+        label?: string | undefined;
+        order?: number | undefined;
+        badge?: string | undefined;
+    };
     search: {
         exclude: boolean;
         boost?: number | undefined;
@@ -368,21 +372,27 @@ export declare const pageMetaSchema: z.ZodObject<{
         title?: string | undefined;
         image?: string | undefined;
         description?: string | undefined;
-        canonical?: string | undefined;
         x?: {
             creator?: string | undefined;
         } | undefined;
+        canonical?: string | undefined;
     };
-    sidebar: {
-        hidden: boolean;
-        icon?: string | undefined;
-        badge?: string | undefined;
-        label?: string | undefined;
-        order?: number | undefined;
-    };
+    deprecated: boolean;
+    draft: boolean;
+    hidden: boolean;
+    noindex: boolean;
     type?: string | undefined;
     title?: string | undefined;
     date?: string | undefined;
+    icon?: string | undefined;
+    description?: string | undefined;
+    lastModified?: string | undefined;
+    slug?: string | undefined;
+    changelog?: {
+        date?: string | undefined;
+        version?: string | undefined;
+        category?: string | undefined;
+    } | undefined;
     authors?: string | z.objectOutputType<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
@@ -394,65 +404,56 @@ export declare const pageMetaSchema: z.ZodObject<{
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
     }, z.ZodUnknown, "strip">)[] | undefined;
-    changelog?: {
-        date?: string | undefined;
-        category?: string | undefined;
-        version?: string | undefined;
-    } | undefined;
-    description?: string | undefined;
-    icon?: string | undefined;
-    lastModified?: string | undefined;
-    slug?: string | undefined;
 }, {
     type?: string | undefined;
     title?: string | undefined;
     date?: string | Date | undefined;
-    authors?: string | z.objectInputType<{
-        avatar: z.ZodOptional<z.ZodString>;
-        image: z.ZodOptional<z.ZodString>;
-        name: z.ZodString;
-        url: z.ZodOptional<z.ZodString>;
-    }, z.ZodUnknown, "strip"> | (string | z.objectInputType<{
-        avatar: z.ZodOptional<z.ZodString>;
-        image: z.ZodOptional<z.ZodString>;
-        name: z.ZodString;
-        url: z.ZodOptional<z.ZodString>;
-    }, z.ZodUnknown, "strip">)[] | undefined;
-    changelog?: {
-        date?: string | Date | undefined;
-        category?: string | undefined;
-        version?: string | undefined;
-    } | undefined;
-    deprecated?: boolean | undefined;
-    description?: string | undefined;
-    draft?: boolean | undefined;
-    hidden?: boolean | undefined;
     icon?: string | undefined;
+    description?: string | undefined;
     lastModified?: string | Date | undefined;
-    noindex?: boolean | undefined;
+    slug?: string | undefined;
+    sidebar?: {
+        icon?: string | undefined;
+        label?: string | undefined;
+        order?: number | undefined;
+        hidden?: boolean | undefined;
+        badge?: string | undefined;
+    } | undefined;
     search?: {
-        boost?: number | undefined;
         exclude?: boolean | undefined;
+        boost?: number | undefined;
         tags?: string[] | undefined;
     } | undefined;
+    changelog?: {
+        date?: string | Date | undefined;
+        version?: string | undefined;
+        category?: string | undefined;
+    } | undefined;
     seo?: {
         title?: string | undefined;
         image?: string | undefined;
         description?: string | undefined;
-        noindex?: boolean | undefined;
-        canonical?: string | undefined;
         x?: {
             creator?: string | undefined;
         } | undefined;
+        noindex?: boolean | undefined;
+        canonical?: string | undefined;
     } | undefined;
-    sidebar?: {
-        hidden?: boolean | undefined;
-        icon?: string | undefined;
-        badge?: string | undefined;
-        label?: string | undefined;
-        order?: number | undefined;
-    } | undefined;
-    slug?: string | undefined;
+    deprecated?: boolean | undefined;
+    authors?: string | z.objectInputType<{
+        avatar: z.ZodOptional<z.ZodString>;
+        image: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.ZodUnknown, "strip"> | (string | z.objectInputType<{
+        avatar: z.ZodOptional<z.ZodString>;
+        image: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.ZodUnknown, "strip">)[] | undefined;
+    draft?: boolean | undefined;
+    hidden?: boolean | undefined;
+    noindex?: boolean | undefined;
 }>;
 export type PageMeta = z.infer<typeof pageMetaBaseSchema>;
 export type PageMetaInput = z.input<typeof pageMetaBaseSchema>;
@@ -475,14 +476,14 @@ export declare const folderMetaSchema: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     title?: string | undefined;
     icon?: string | undefined;
-    order?: number | undefined;
     pages?: string[] | undefined;
+    order?: number | undefined;
     collapsed?: boolean | undefined;
 }, {
     title?: string | undefined;
     icon?: string | undefined;
-    order?: number | undefined;
     pages?: string[] | undefined;
+    order?: number | undefined;
     collapsed?: boolean | undefined;
 }>;
 export type FolderMeta = z.infer<typeof folderMetaSchema>;
@@ -672,14 +673,14 @@ declare const contentSourceSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
         title?: string | undefined;
         status?: string | undefined;
         description?: string | undefined;
-        order?: string | undefined;
         slug?: string | undefined;
+        order?: string | undefined;
     }, {
         title?: string | undefined;
         status?: string | undefined;
         description?: string | undefined;
-        order?: string | undefined;
         slug?: string | undefined;
+        order?: string | undefined;
     }>>;
     /** Status value treated as published; others map to `draft`. Default `Published`. */
     publishedValue: z.ZodOptional<z.ZodString>;
@@ -693,8 +694,8 @@ declare const contentSourceSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
         title?: string | undefined;
         status?: string | undefined;
         description?: string | undefined;
-        order?: string | undefined;
         slug?: string | undefined;
+        order?: string | undefined;
     } | undefined;
     publishedValue?: string | undefined;
 }, {
@@ -706,8 +707,8 @@ declare const contentSourceSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
         title?: string | undefined;
         status?: string | undefined;
         description?: string | undefined;
-        order?: string | undefined;
         slug?: string | undefined;
+        order?: string | undefined;
     } | undefined;
     publishedValue?: string | undefined;
 }>, z.ZodObject<{
@@ -806,17 +807,17 @@ declare const aiConfigSchema: z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         openapi: z.ZodDefault<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
-        enabled: boolean;
         openapi: boolean;
+        enabled: boolean;
     }, {
-        enabled?: boolean | undefined;
         openapi?: boolean | undefined;
+        enabled?: boolean | undefined;
     }>]>>, {
-        enabled: boolean;
         openapi: boolean;
+        enabled: boolean;
     }, boolean | {
-        enabled?: boolean | undefined;
         openapi?: boolean | undefined;
+        enabled?: boolean | undefined;
     } | undefined>;
     markdownComponents: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<ComponentMarkdown, z.ZodTypeDef, ComponentMarkdown>>>;
     /** Expose the docs as an MCP server for connecting agents. */
@@ -844,8 +845,8 @@ declare const aiConfigSchema: z.ZodObject<{
     }>>;
 }, "strict", z.ZodTypeAny, {
     llmsTxt: {
-        enabled: boolean;
         openapi: boolean;
+        enabled: boolean;
     };
     markdownComponents: Record<string, ComponentMarkdown>;
     mcp: {
@@ -878,8 +879,8 @@ declare const aiConfigSchema: z.ZodObject<{
         }[] | undefined;
     } | undefined;
     llmsTxt?: boolean | {
-        enabled?: boolean | undefined;
         openapi?: boolean | undefined;
+        enabled?: boolean | undefined;
     } | undefined;
     markdownComponents?: Record<string, ComponentMarkdown> | undefined;
     mcp?: {
@@ -1097,17 +1098,17 @@ export declare const blumeConfigSchema: z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             openapi: z.ZodDefault<z.ZodBoolean>;
         }, "strict", z.ZodTypeAny, {
-            enabled: boolean;
             openapi: boolean;
+            enabled: boolean;
         }, {
-            enabled?: boolean | undefined;
             openapi?: boolean | undefined;
+            enabled?: boolean | undefined;
         }>]>>, {
-            enabled: boolean;
             openapi: boolean;
+            enabled: boolean;
         }, boolean | {
-            enabled?: boolean | undefined;
             openapi?: boolean | undefined;
+            enabled?: boolean | undefined;
         } | undefined>;
         markdownComponents: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<ComponentMarkdown, z.ZodTypeDef, ComponentMarkdown>>>;
         /** Expose the docs as an MCP server for connecting agents. */
@@ -1135,8 +1136,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
         }>>;
     }, "strict", z.ZodTypeAny, {
         llmsTxt: {
-            enabled: boolean;
             openapi: boolean;
+            enabled: boolean;
         };
         markdownComponents: Record<string, ComponentMarkdown>;
         mcp: {
@@ -1169,8 +1170,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             }[] | undefined;
         } | undefined;
         llmsTxt?: boolean | {
-            enabled?: boolean | undefined;
             openapi?: boolean | undefined;
+            enabled?: boolean | undefined;
         } | undefined;
         markdownComponents?: Record<string, ComponentMarkdown> | undefined;
         mcp?: {
@@ -1521,14 +1522,14 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 title?: string | undefined;
                 status?: string | undefined;
                 description?: string | undefined;
-                order?: string | undefined;
                 slug?: string | undefined;
+                order?: string | undefined;
             }, {
                 title?: string | undefined;
                 status?: string | undefined;
                 description?: string | undefined;
-                order?: string | undefined;
                 slug?: string | undefined;
+                order?: string | undefined;
             }>>;
             /** Status value treated as published; others map to `draft`. Default `Published`. */
             publishedValue: z.ZodOptional<z.ZodString>;
@@ -1542,8 +1543,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 title?: string | undefined;
                 status?: string | undefined;
                 description?: string | undefined;
-                order?: string | undefined;
                 slug?: string | undefined;
+                order?: string | undefined;
             } | undefined;
             publishedValue?: string | undefined;
         }, {
@@ -1555,8 +1556,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 title?: string | undefined;
                 status?: string | undefined;
                 description?: string | undefined;
-                order?: string | undefined;
                 slug?: string | undefined;
+                order?: string | undefined;
             } | undefined;
             publishedValue?: string | undefined;
         }>, z.ZodObject<{
@@ -1571,8 +1572,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
         }>]>, "many">>;
     }, "strict", z.ZodTypeAny, {
         root: string;
-        exclude: string[];
         defaultType: string;
+        exclude: string[];
         include: string[];
         pages: string;
         sources?: ({
@@ -1627,8 +1628,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 title?: string | undefined;
                 status?: string | undefined;
                 description?: string | undefined;
-                order?: string | undefined;
                 slug?: string | undefined;
+                order?: string | undefined;
             } | undefined;
             publishedValue?: string | undefined;
         } | {
@@ -1637,7 +1638,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
         })[] | undefined;
     }, {
         root?: string | undefined;
-        exclude?: string[] | undefined;
         sources?: ({
             type: "filesystem";
             root?: string | undefined;
@@ -1690,8 +1690,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 title?: string | undefined;
                 status?: string | undefined;
                 description?: string | undefined;
-                order?: string | undefined;
                 slug?: string | undefined;
+                order?: string | undefined;
             } | undefined;
             publishedValue?: string | undefined;
         } | {
@@ -1699,6 +1699,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
             source: ContentSource;
         })[] | undefined;
         defaultType?: string | undefined;
+        exclude?: string[] | undefined;
         include?: string[] | undefined;
         pages?: string | undefined;
     }>>;
@@ -1759,6 +1760,14 @@ export declare const blumeConfigSchema: z.ZodObject<{
         pdf?: boolean | undefined;
     }>>;
     feedback: z.ZodDefault<z.ZodBoolean>;
+    /** Opt-in custom frontmatter keys, validated by user-supplied schemas. */
+    frontmatter: z.ZodDefault<z.ZodObject<{
+        extend: z.ZodEffects<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<StandardSchema<unknown, unknown>, z.ZodTypeDef, StandardSchema<unknown, unknown>>>>, Record<string, StandardSchema<unknown, unknown>>, Record<string, StandardSchema<unknown, unknown>> | undefined>;
+    }, "strict", z.ZodTypeAny, {
+        extend: Record<string, StandardSchema<unknown, unknown>>;
+    }, {
+        extend?: Record<string, StandardSchema<unknown, unknown>> | undefined;
+    }>>;
     github: z.ZodOptional<z.ZodObject<{
         branch: z.ZodDefault<z.ZodString>;
         /** Path from the repo root to the project root (for monorepos). */
@@ -1848,9 +1857,9 @@ export declare const blumeConfigSchema: z.ZodObject<{
     lastModified: z.ZodDefault<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
         type: z.ZodDefault<z.ZodEnum<["git", "frontmatter"]>>;
     }, "strict", z.ZodTypeAny, {
-        type: "git" | "frontmatter";
+        type: "frontmatter" | "git";
     }, {
-        type?: "git" | "frontmatter" | undefined;
+        type?: "frontmatter" | "git" | undefined;
     }>]>>;
     logo: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
         href: z.ZodOptional<z.ZodString>;
@@ -1992,14 +2001,14 @@ export declare const blumeConfigSchema: z.ZodObject<{
             }, "strict", z.ZodTypeAny, {
                 path: string;
                 label: string;
-                description?: string | undefined;
                 icon?: string | undefined;
+                description?: string | undefined;
                 tag?: string | undefined;
             }, {
                 path: string;
                 label: string;
-                description?: string | undefined;
                 icon?: string | undefined;
+                description?: string | undefined;
                 tag?: string | undefined;
             }>, "many">>;
             kind: z.ZodEnum<["dropdown", "language", "product", "version"]>;
@@ -2009,19 +2018,19 @@ export declare const blumeConfigSchema: z.ZodObject<{
             items: {
                 path: string;
                 label: string;
-                description?: string | undefined;
                 icon?: string | undefined;
+                description?: string | undefined;
                 tag?: string | undefined;
             }[];
-            kind: "version" | "product" | "dropdown" | "language";
+            kind: "dropdown" | "language" | "product" | "version";
         }, {
             label: string;
-            kind: "version" | "product" | "dropdown" | "language";
+            kind: "dropdown" | "language" | "product" | "version";
             items?: {
                 path: string;
                 label: string;
-                description?: string | undefined;
                 icon?: string | undefined;
+                description?: string | undefined;
                 tag?: string | undefined;
             }[] | undefined;
         }>, "many">>;
@@ -2035,19 +2044,19 @@ export declare const blumeConfigSchema: 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";
+            display: "flat" | "group" | "page";
             items?: SidebarItemConfig[] | undefined;
         }, {
-            display?: "flat" | "page" | "group" | undefined;
+            display?: "flat" | "group" | "page" | undefined;
             items?: SidebarItemConfig[] | undefined;
         }>]>>, {
-            display: "flat" | "page" | "group";
+            display: "flat" | "group" | "page";
             items?: SidebarItemConfig[] | undefined;
         }, SidebarItemConfig[] | {
-            display?: "flat" | "page" | "group" | undefined;
+            display?: "flat" | "group" | "page" | undefined;
             items?: SidebarItemConfig[] | undefined;
         } | undefined>;
-        tabs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        tabs: z.ZodDefault<z.ZodArray<z.ZodObject<{
             icon: z.ZodOptional<z.ZodString>;
             items: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 description: z.ZodOptional<z.ZodString>;
@@ -2058,14 +2067,14 @@ export declare const blumeConfigSchema: z.ZodObject<{
             }, "strict", z.ZodTypeAny, {
                 path: string;
                 label: string;
-                description?: string | undefined;
                 icon?: string | undefined;
+                description?: string | undefined;
                 tag?: string | undefined;
             }, {
                 path: string;
                 label: string;
-                description?: string | undefined;
                 icon?: string | undefined;
+                description?: string | undefined;
                 tag?: string | undefined;
             }>, "many">>;
             label: z.ZodString;
@@ -2077,8 +2086,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             items?: {
                 path: string;
                 label: string;
-                description?: string | undefined;
                 icon?: string | undefined;
+                description?: string | undefined;
                 tag?: string | undefined;
             }[] | undefined;
         }, {
@@ -2088,16 +2097,12 @@ export declare const blumeConfigSchema: z.ZodObject<{
             items?: {
                 path: string;
                 label: string;
-                description?: string | undefined;
                 icon?: string | undefined;
+                description?: string | undefined;
                 tag?: string | undefined;
             }[] | undefined;
         }>, "many">>;
     }, "strict", z.ZodTypeAny, {
-        sidebar: {
-            display: "flat" | "page" | "group";
-            items?: SidebarItemConfig[] | undefined;
-        };
         repo: boolean;
         featured: {
             label: string;
@@ -2109,29 +2114,29 @@ export declare const blumeConfigSchema: z.ZodObject<{
             items: {
                 path: string;
                 label: string;
-                description?: string | undefined;
                 icon?: string | undefined;
+                description?: string | undefined;
                 tag?: string | undefined;
             }[];
-            kind: "version" | "product" | "dropdown" | "language";
+            kind: "dropdown" | "language" | "product" | "version";
         }[];
-        tabs?: {
+        sidebar: {
+            display: "flat" | "group" | "page";
+            items?: SidebarItemConfig[] | undefined;
+        };
+        tabs: {
             path: string;
             label: string;
             icon?: string | undefined;
             items?: {
                 path: string;
                 label: string;
-                description?: string | undefined;
                 icon?: string | undefined;
+                description?: string | undefined;
                 tag?: string | undefined;
             }[] | undefined;
-        }[] | undefined;
+        }[];
     }, {
-        sidebar?: SidebarItemConfig[] | {
-            display?: "flat" | "page" | "group" | undefined;
-            items?: SidebarItemConfig[] | undefined;
-        } | undefined;
         repo?: boolean | undefined;
         featured?: {
             label: string;
@@ -2140,15 +2145,19 @@ export declare const blumeConfigSchema: z.ZodObject<{
         }[] | undefined;
         selectors?: {
             label: string;
-            kind: "version" | "product" | "dropdown" | "language";
+            kind: "dropdown" | "language" | "product" | "version";
             items?: {
                 path: string;
                 label: string;
-                description?: string | undefined;
                 icon?: string | undefined;
+                description?: string | undefined;
                 tag?: string | undefined;
             }[] | undefined;
         }[] | undefined;
+        sidebar?: SidebarItemConfig[] | {
+            display?: "flat" | "group" | "page" | undefined;
+            items?: SidebarItemConfig[] | undefined;
+        } | undefined;
         tabs?: {
             path: string;
             label: string;
@@ -2156,8 +2165,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             items?: {
                 path: string;
                 label: string;
-                description?: string | undefined;
                 icon?: string | undefined;
+                description?: string | undefined;
                 tag?: string | undefined;
             }[] | undefined;
         }[] | undefined;
@@ -2288,6 +2297,20 @@ export declare const blumeConfigSchema: z.ZodObject<{
             endpoint: string;
             indexId?: string | undefined;
         }>>;
+        /** Curated links for the Cmd+K empty state; defaults to the first sidebar pages. */
+        popular: 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">>;
         provider: z.ZodDefault<z.ZodEnum<["orama", "pagefind", "flexsearch", "algolia", "orama-cloud", "typesense", "mixedbread", "none"]>>;
         typesense: z.ZodOptional<z.ZodObject<{
             collection: z.ZodString;
@@ -2309,10 +2332,15 @@ export declare const blumeConfigSchema: z.ZodObject<{
             protocol?: "http" | "https" | undefined;
         }>>;
     }, "strict", z.ZodTypeAny, {
-        provider: "none" | "algolia" | "mixedbread" | "orama" | "pagefind" | "flexsearch" | "orama-cloud" | "typesense";
+        provider: "algolia" | "mixedbread" | "orama" | "pagefind" | "flexsearch" | "orama-cloud" | "typesense" | "none";
         indexing: {
             includeHiddenPages: boolean;
         };
+        popular: {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+        }[];
         algolia?: {
             appId: string;
             indexName: string;
@@ -2334,7 +2362,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
             protocol?: "http" | "https" | undefined;
         } | undefined;
     }, {
-        provider?: "none" | "algolia" | "mixedbread" | "orama" | "pagefind" | "flexsearch" | "orama-cloud" | "typesense" | undefined;
+        provider?: "algolia" | "mixedbread" | "orama" | "pagefind" | "flexsearch" | "orama-cloud" | "typesense" | "none" | undefined;
         algolia?: {
             appId: string;
             indexName: string;
@@ -2351,6 +2379,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
             endpoint: string;
             indexId?: string | undefined;
         } | undefined;
+        popular?: {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+        }[] | undefined;
         typesense?: {
             host: string;
             searchApiKey: string;
@@ -2359,10 +2392,15 @@ export declare const blumeConfigSchema: z.ZodObject<{
             protocol?: "http" | "https" | undefined;
         } | undefined;
     }>, {
-        provider: "none" | "algolia" | "mixedbread" | "orama" | "pagefind" | "flexsearch" | "orama-cloud" | "typesense";
+        provider: "algolia" | "mixedbread" | "orama" | "pagefind" | "flexsearch" | "orama-cloud" | "typesense" | "none";
         indexing: {
             includeHiddenPages: boolean;
         };
+        popular: {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+        }[];
         algolia?: {
             appId: string;
             indexName: string;
@@ -2384,7 +2422,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
             protocol?: "http" | "https" | undefined;
         } | undefined;
     }, {
-        provider?: "none" | "algolia" | "mixedbread" | "orama" | "pagefind" | "flexsearch" | "orama-cloud" | "typesense" | undefined;
+        provider?: "algolia" | "mixedbread" | "orama" | "pagefind" | "flexsearch" | "orama-cloud" | "typesense" | "none" | undefined;
         algolia?: {
             appId: string;
             indexName: string;
@@ -2401,6 +2439,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
             endpoint: string;
             indexId?: string | undefined;
         } | undefined;
+        popular?: {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+        }[] | undefined;
         typesense?: {
             host: string;
             searchApiKey: string;
@@ -2446,10 +2489,76 @@ export declare const blumeConfigSchema: z.ZodObject<{
              * `loadConfig`. An explicit value here always wins.
              */
             enabled: z.ZodOptional<z.ZodBoolean>;
+            /**
+             * Google Font families for the generated card, extending Takumi's Latin-only
+             * default so non-Latin titles (CJK, and so on) render instead of tofu.
+             * Fetched from Google Fonts at build.
+             */
+            fonts: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+                name: z.ZodString;
+                style: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["normal", "italic"]>, z.ZodArray<z.ZodEnum<["normal", "italic"]>, "many">]>>;
+                weight: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">, z.ZodString]>>;
+            }, "strict", z.ZodTypeAny, {
+                name: string;
+                style?: "normal" | "italic" | ("normal" | "italic")[] | undefined;
+                weight?: string | number | number[] | undefined;
+            }, {
+                name: string;
+                style?: "normal" | "italic" | ("normal" | "italic")[] | undefined;
+                weight?: string | number | number[] | undefined;
+            }>]>, "many">>;
+            /** Local SVG used in the generated card instead of the site logo. */
+            logo: z.ZodOptional<z.ZodString>;
+            /** Optional generated-card colors. */
+            palette: z.ZodOptional<z.ZodObject<{
+                accent: z.ZodOptional<z.ZodString>;
+                background: z.ZodOptional<z.ZodString>;
+                border: z.ZodOptional<z.ZodString>;
+                foreground: z.ZodOptional<z.ZodString>;
+                muted: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                accent?: string | undefined;
+                background?: string | undefined;
+                border?: string | undefined;
+                foreground?: string | undefined;
+                muted?: string | undefined;
+            }, {
+                accent?: string | undefined;
+                background?: string | undefined;
+                border?: string | undefined;
+                foreground?: string | undefined;
+                muted?: string | undefined;
+            }>>;
         }, "strict", z.ZodTypeAny, {
             enabled?: boolean | undefined;
+            logo?: string | undefined;
+            fonts?: (string | {
+                name: string;
+                style?: "normal" | "italic" | ("normal" | "italic")[] | undefined;
+                weight?: string | number | number[] | undefined;
+            })[] | undefined;
+            palette?: {
+                accent?: string | undefined;
+                background?: string | undefined;
+                border?: string | undefined;
+                foreground?: string | undefined;
+                muted?: string | undefined;
+            } | undefined;
         }, {
             enabled?: boolean | undefined;
+            logo?: string | undefined;
+            fonts?: (string | {
+                name: string;
+                style?: "normal" | "italic" | ("normal" | "italic")[] | undefined;
+                weight?: string | number | number[] | undefined;
+            })[] | undefined;
+            palette?: {
+                accent?: string | undefined;
+                background?: string | undefined;
+                border?: string | undefined;
+                foreground?: string | undefined;
+                muted?: string | undefined;
+            } | undefined;
         }>>;
         /** Generate robots.txt (with a Sitemap reference when available). */
         robots: z.ZodDefault<z.ZodBoolean>;
@@ -2486,10 +2595,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
             handle?: string | undefined;
         }>>;
     }, "strict", z.ZodTypeAny, {
-        x: {
-            creator?: string | undefined;
-            handle?: string | undefined;
-        };
         agentReadability: boolean;
         contentSignals: {
             search: boolean;
@@ -2498,6 +2603,19 @@ export declare const blumeConfigSchema: z.ZodObject<{
         } | null;
         og: {
             enabled?: boolean | undefined;
+            logo?: string | undefined;
+            fonts?: (string | {
+                name: string;
+                style?: "normal" | "italic" | ("normal" | "italic")[] | undefined;
+                weight?: string | number | number[] | undefined;
+            })[] | undefined;
+            palette?: {
+                accent?: string | undefined;
+                background?: string | undefined;
+                border?: string | undefined;
+                foreground?: string | undefined;
+                muted?: string | undefined;
+            } | undefined;
         };
         robots: boolean;
         rss: {
@@ -2507,11 +2625,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
         };
         sitemap: boolean;
         structuredData: boolean;
-    }, {
-        x?: {
+        x: {
             creator?: string | undefined;
             handle?: string | undefined;
-        } | undefined;
+        };
+    }, {
         agentReadability?: boolean | undefined;
         contentSignals?: boolean | {
             search?: boolean | undefined;
@@ -2520,6 +2638,19 @@ export declare const blumeConfigSchema: z.ZodObject<{
         } | undefined;
         og?: {
             enabled?: boolean | undefined;
+            logo?: string | undefined;
+            fonts?: (string | {
+                name: string;
+                style?: "normal" | "italic" | ("normal" | "italic")[] | undefined;
+                weight?: string | number | number[] | undefined;
+            })[] | undefined;
+            palette?: {
+                accent?: string | undefined;
+                background?: string | undefined;
+                border?: string | undefined;
+                foreground?: string | undefined;
+                muted?: string | undefined;
+            } | undefined;
         } | undefined;
         robots?: boolean | undefined;
         rss?: {
@@ -2529,6 +2660,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
         } | undefined;
         sitemap?: boolean | undefined;
         structuredData?: boolean | undefined;
+        x?: {
+            creator?: string | undefined;
+            handle?: string | undefined;
+        } | undefined;
     }>>;
     theme: z.ZodDefault<z.ZodObject<{
         accent: z.ZodEffects<z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodObject<{
@@ -2597,49 +2732,49 @@ export declare const blumeConfigSchema: z.ZodObject<{
         mode: z.ZodDefault<z.ZodEnum<["system", "light", "dark"]>>;
         radius: z.ZodDefault<z.ZodEnum<["none", "sm", "md", "lg"]>>;
     }, "strict", z.ZodTypeAny, {
-        accent: {
-            dark: string;
-            light: string;
-        };
         fonts: {
             mono: string;
             display: string;
             body: string;
         };
+        accent: {
+            dark: string;
+            light: string;
+        };
         layout: "sidebar";
         mode: "dark" | "light" | "system";
-        radius: "md" | "none" | "sm" | "lg";
-        action?: string | undefined;
+        radius: "none" | "sm" | "md" | "lg";
         background?: {
             dark?: string | undefined;
             light?: string | undefined;
         } | undefined;
+        action?: string | undefined;
         backgroundImage?: {
             dark?: string | undefined;
             light?: string | undefined;
         } | undefined;
     }, {
+        fonts?: {
+            mono?: string | undefined;
+            display?: string | undefined;
+            body?: string | undefined;
+        } | undefined;
         accent?: string | {
             dark: string;
             light: string;
         } | undefined;
-        action?: string | undefined;
         background?: string | {
             dark?: string | undefined;
             light?: string | undefined;
         } | undefined;
+        action?: string | undefined;
         backgroundImage?: string | {
             dark?: string | undefined;
             light?: string | undefined;
         } | undefined;
-        fonts?: {
-            mono?: string | undefined;
-            display?: string | undefined;
-            body?: string | undefined;
-        } | undefined;
         layout?: "sidebar" | undefined;
         mode?: "dark" | "light" | "system" | undefined;
-        radius?: "md" | "none" | "sm" | "lg" | undefined;
+        radius?: "none" | "sm" | "md" | "lg" | undefined;
     }>>;
     title: z.ZodDefault<z.ZodString>;
     toc: z.ZodEffects<z.ZodEffects<z.ZodDefault<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
@@ -2668,58 +2803,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
     } | undefined>;
 }, "strict", z.ZodTypeAny, {
     title: string;
-    lastModified: boolean | {
-        type: "git" | "frontmatter";
-    };
-    search: {
-        provider: "none" | "algolia" | "mixedbread" | "orama" | "pagefind" | "flexsearch" | "orama-cloud" | "typesense";
-        indexing: {
-            includeHiddenPages: boolean;
-        };
-        algolia?: {
-            appId: string;
-            indexName: string;
-            searchApiKey: string;
-        } | undefined;
-        mixedbread?: {
-            storeId: string;
-        } | undefined;
-        oramaCloud?: {
-            apiKey: string;
-            endpoint: string;
-            indexId?: string | undefined;
-        } | undefined;
-        typesense?: {
-            host: string;
-            searchApiKey: string;
-            collection: string;
-            port?: number | undefined;
-            protocol?: "http" | "https" | undefined;
-        } | undefined;
-    };
-    seo: {
-        x: {
-            creator?: string | undefined;
-            handle?: string | undefined;
-        };
-        agentReadability: boolean;
-        contentSignals: {
-            search: boolean;
-            aiInput: boolean;
-            aiTrain: boolean;
-        } | null;
-        og: {
-            enabled?: boolean | undefined;
-        };
-        robots: boolean;
-        rss: {
-            enabled: boolean;
-            limit: number;
-            types: string[];
-        };
-        sitemap: boolean;
-        structuredData: boolean;
-    };
     openapi: {
         enabled: boolean;
         route: string;
@@ -2734,10 +2817,21 @@ export declare const blumeConfigSchema: z.ZodObject<{
         spec?: string | undefined;
         theme?: string | undefined;
     };
+    asyncapi: {
+        enabled: boolean;
+        route: string;
+        sources: {
+            spec: string;
+            label?: string | undefined;
+            route?: string | undefined;
+        }[];
+        spec?: string | undefined;
+        theme?: string | undefined;
+    };
     ai: {
         llmsTxt: {
-            enabled: boolean;
             openapi: boolean;
+            enabled: boolean;
         };
         markdownComponents: Record<string, ComponentMarkdown>;
         mcp: {
@@ -2760,8 +2854,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
     };
     content: {
         root: string;
-        exclude: string[];
         defaultType: string;
+        exclude: string[];
         include: string[];
         pages: string;
         sources?: ({
@@ -2816,8 +2910,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 title?: string | undefined;
                 status?: string | undefined;
                 description?: string | undefined;
-                order?: string | undefined;
                 slug?: string | undefined;
+                order?: string | undefined;
             } | undefined;
             publishedValue?: string | undefined;
         } | {
@@ -2826,40 +2920,32 @@ export declare const blumeConfigSchema: z.ZodObject<{
         })[] | undefined;
     };
     theme: {
-        accent: {
-            dark: string;
-            light: string;
-        };
         fonts: {
             mono: string;
             display: string;
             body: string;
         };
+        accent: {
+            dark: string;
+            light: string;
+        };
         layout: "sidebar";
         mode: "dark" | "light" | "system";
-        radius: "md" | "none" | "sm" | "lg";
-        action?: string | undefined;
+        radius: "none" | "sm" | "md" | "lg";
         background?: {
             dark?: string | undefined;
             light?: string | undefined;
         } | undefined;
+        action?: string | undefined;
         backgroundImage?: {
             dark?: string | undefined;
             light?: string | undefined;
         } | undefined;
     };
-    asyncapi: {
-        enabled: boolean;
-        route: string;
-        sources: {
-            spec: string;
-            label?: string | undefined;
-            route?: string | undefined;
-        }[];
-        spec?: string | undefined;
-        theme?: string | undefined;
-    };
     basePath: string;
+    lastModified: boolean | {
+        type: "frontmatter" | "git";
+    };
     deployment: {
         adapter: "vercel" | "node" | "netlify" | "cloudflare" | null;
         output: "static" | "server";
@@ -2875,6 +2961,9 @@ export declare const blumeConfigSchema: z.ZodObject<{
         pdf: boolean;
     };
     feedback: boolean;
+    frontmatter: {
+        extend: Record<string, StandardSchema<unknown, unknown>>;
+    };
     markdown: {
         code: {
             icons: boolean;
@@ -2890,10 +2979,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
         imageZoom: boolean;
     };
     navigation: {
-        sidebar: {
-            display: "flat" | "page" | "group";
-            items?: SidebarItemConfig[] | undefined;
-        };
         repo: boolean;
         featured: {
             label: string;
@@ -2905,24 +2990,28 @@ export declare const blumeConfigSchema: z.ZodObject<{
             items: {
                 path: string;
                 label: string;
-                description?: string | undefined;
                 icon?: string | undefined;
+                description?: string | undefined;
                 tag?: string | undefined;
             }[];
-            kind: "version" | "product" | "dropdown" | "language";
+            kind: "dropdown" | "language" | "product" | "version";
         }[];
-        tabs?: {
+        sidebar: {
+            display: "flat" | "group" | "page";
+            items?: SidebarItemConfig[] | undefined;
+        };
+        tabs: {
             path: string;
             label: string;
             icon?: string | undefined;
             items?: {
                 path: string;
                 label: string;
-                description?: string | undefined;
                 icon?: string | undefined;
+                description?: string | undefined;
                 tag?: string | undefined;
             }[] | undefined;
-        }[] | undefined;
+        }[];
     };
     react: {
         compiler: boolean;
@@ -2932,12 +3021,78 @@ export declare const blumeConfigSchema: z.ZodObject<{
         from: string;
         to: string;
     }[];
+    search: {
+        provider: "algolia" | "mixedbread" | "orama" | "pagefind" | "flexsearch" | "orama-cloud" | "typesense" | "none";
+        indexing: {
+            includeHiddenPages: boolean;
+        };
+        popular: {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+        }[];
+        algolia?: {
+            appId: string;
+            indexName: string;
+            searchApiKey: string;
+        } | undefined;
+        mixedbread?: {
+            storeId: string;
+        } | undefined;
+        oramaCloud?: {
+            apiKey: string;
+            endpoint: string;
+            indexId?: string | undefined;
+        } | undefined;
+        typesense?: {
+            host: string;
+            searchApiKey: string;
+            collection: string;
+            port?: number | undefined;
+            protocol?: "http" | "https" | undefined;
+        } | undefined;
+    };
+    seo: {
+        agentReadability: boolean;
+        contentSignals: {
+            search: boolean;
+            aiInput: boolean;
+            aiTrain: boolean;
+        } | null;
+        og: {
+            enabled?: boolean | undefined;
+            logo?: string | undefined;
+            fonts?: (string | {
+                name: string;
+                style?: "normal" | "italic" | ("normal" | "italic")[] | undefined;
+                weight?: string | number | number[] | undefined;
+            })[] | undefined;
+            palette?: {
+                accent?: string | undefined;
+                background?: string | undefined;
+                border?: string | undefined;
+                foreground?: string | undefined;
+                muted?: string | undefined;
+            } | undefined;
+        };
+        robots: boolean;
+        rss: {
+            enabled: boolean;
+            limit: number;
+            types: string[];
+        };
+        sitemap: boolean;
+        structuredData: boolean;
+        x: {
+            creator?: string | undefined;
+            handle?: string | undefined;
+        };
+    };
     toc: {
         enabled: boolean;
         maxLevel: number;
         minLevel: number;
     };
-    description?: string | undefined;
     analytics?: {
         posthog?: {
             key: string;
@@ -2966,6 +3121,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
         branch: string;
         dir?: string | undefined;
     } | undefined;
+    description?: string | undefined;
     i18n?: {
         defaultLocale: string;
         hideDefaultLocalePrefix: boolean;
@@ -2989,59 +3145,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
     } | undefined;
 }, {
     title?: string | undefined;
-    description?: string | undefined;
-    lastModified?: boolean | {
-        type?: "git" | "frontmatter" | undefined;
-    } | undefined;
-    search?: {
-        provider?: "none" | "algolia" | "mixedbread" | "orama" | "pagefind" | "flexsearch" | "orama-cloud" | "typesense" | undefined;
-        algolia?: {
-            appId: string;
-            indexName: string;
-            searchApiKey: string;
-        } | undefined;
-        indexing?: {
-            includeHiddenPages?: boolean | undefined;
-        } | undefined;
-        mixedbread?: {
-            storeId: string;
-        } | undefined;
-        oramaCloud?: {
-            apiKey: string;
-            endpoint: string;
-            indexId?: string | undefined;
-        } | undefined;
-        typesense?: {
-            host: string;
-            searchApiKey: string;
-            collection: string;
-            port?: number | undefined;
-            protocol?: "http" | "https" | undefined;
-        } | undefined;
-    } | undefined;
-    seo?: {
-        x?: {
-            creator?: string | undefined;
-            handle?: string | undefined;
-        } | undefined;
-        agentReadability?: boolean | undefined;
-        contentSignals?: boolean | {
-            search?: boolean | undefined;
-            aiInput?: boolean | undefined;
-            aiTrain?: boolean | undefined;
-        } | undefined;
-        og?: {
-            enabled?: boolean | undefined;
-        } | undefined;
-        robots?: boolean | undefined;
-        rss?: {
-            enabled?: boolean | undefined;
-            limit?: number | undefined;
-            types?: string[] | undefined;
-        } | undefined;
-        sitemap?: boolean | undefined;
-        structuredData?: boolean | undefined;
-    } | undefined;
     openapi?: {
         enabled?: boolean | undefined;
         route?: string | undefined;
@@ -3056,6 +3159,17 @@ export declare const blumeConfigSchema: z.ZodObject<{
         expandSchemas?: boolean | undefined;
         renderer?: "blume" | "scalar" | undefined;
     } | undefined;
+    asyncapi?: {
+        enabled?: boolean | undefined;
+        route?: string | undefined;
+        spec?: string | undefined;
+        sources?: {
+            spec: string;
+            label?: string | undefined;
+            route?: string | undefined;
+        }[] | undefined;
+        theme?: string | undefined;
+    } | undefined;
     ai?: {
         ask?: {
             apiKeyEnv?: string | undefined;
@@ -3069,8 +3183,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             }[] | undefined;
         } | undefined;
         llmsTxt?: boolean | {
-            enabled?: boolean | undefined;
             openapi?: boolean | undefined;
+            enabled?: boolean | undefined;
         } | undefined;
         markdownComponents?: Record<string, ComponentMarkdown> | undefined;
         mcp?: {
@@ -3082,7 +3196,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
     } | undefined;
     content?: {
         root?: string | undefined;
-        exclude?: string[] | undefined;
         sources?: ({
             type: "filesystem";
             root?: string | undefined;
@@ -3135,8 +3248,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 title?: string | undefined;
                 status?: string | undefined;
                 description?: string | undefined;
-                order?: string | undefined;
                 slug?: string | undefined;
+                order?: string | undefined;
             } | undefined;
             publishedValue?: string | undefined;
         } | {
@@ -3144,6 +3257,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
             source: ContentSource;
         })[] | undefined;
         defaultType?: string | undefined;
+        exclude?: string[] | undefined;
         include?: string[] | undefined;
         pages?: string | undefined;
     } | undefined;
@@ -3161,38 +3275,27 @@ export declare const blumeConfigSchema: z.ZodObject<{
         vercel?: boolean | undefined;
     } | undefined;
     theme?: {
+        fonts?: {
+            mono?: string | undefined;
+            display?: string | undefined;
+            body?: string | undefined;
+        } | undefined;
         accent?: string | {
             dark: string;
             light: string;
         } | undefined;
-        action?: string | undefined;
         background?: string | {
             dark?: string | undefined;
             light?: string | undefined;
         } | undefined;
+        action?: string | undefined;
         backgroundImage?: string | {
             dark?: string | undefined;
             light?: string | undefined;
         } | undefined;
-        fonts?: {
-            mono?: string | undefined;
-            display?: string | undefined;
-            body?: string | undefined;
-        } | undefined;
         layout?: "sidebar" | undefined;
         mode?: "dark" | "light" | "system" | undefined;
-        radius?: "md" | "none" | "sm" | "lg" | undefined;
-    } | undefined;
-    asyncapi?: {
-        enabled?: boolean | undefined;
-        route?: string | undefined;
-        spec?: string | undefined;
-        sources?: {
-            spec: string;
-            label?: string | undefined;
-            route?: string | undefined;
-        }[] | undefined;
-        theme?: string | undefined;
+        radius?: "none" | "sm" | "md" | "lg" | undefined;
     } | undefined;
     banner?: string | {
         content: string;
@@ -3210,6 +3313,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
         branch?: string | undefined;
         dir?: string | undefined;
     } | undefined;
+    description?: string | undefined;
+    lastModified?: boolean | {
+        type?: "frontmatter" | "git" | undefined;
+    } | undefined;
     deployment?: {
         adapter?: "vercel" | "node" | "netlify" | "cloudflare" | null | undefined;
         base?: string | undefined;
@@ -3225,6 +3332,9 @@ export declare const blumeConfigSchema: z.ZodObject<{
         pdf?: boolean | undefined;
     } | undefined;
     feedback?: boolean | undefined;
+    frontmatter?: {
+        extend?: Record<string, StandardSchema<unknown, unknown>> | undefined;
+    } | undefined;
     i18n?: {
         locales: {
             code: string;
@@ -3261,10 +3371,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
         imageZoom?: boolean | undefined;
     } | undefined;
     navigation?: {
-        sidebar?: SidebarItemConfig[] | {
-            display?: "flat" | "page" | "group" | undefined;
-            items?: SidebarItemConfig[] | undefined;
-        } | undefined;
         repo?: boolean | undefined;
         featured?: {
             label: string;
@@ -3273,15 +3379,19 @@ export declare const blumeConfigSchema: z.ZodObject<{
         }[] | undefined;
         selectors?: {
             label: string;
-            kind: "version" | "product" | "dropdown" | "language";
+            kind: "dropdown" | "language" | "product" | "version";
             items?: {
                 path: string;
                 label: string;
-                description?: string | undefined;
                 icon?: string | undefined;
+                description?: string | undefined;
                 tag?: string | undefined;
             }[] | undefined;
         }[] | undefined;
+        sidebar?: SidebarItemConfig[] | {
+            display?: "flat" | "group" | "page" | undefined;
+            items?: SidebarItemConfig[] | undefined;
+        } | undefined;
         tabs?: {
             path: string;
             label: string;
@@ -3289,8 +3399,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
             items?: {
                 path: string;
                 label: string;
-                description?: string | undefined;
                 icon?: string | undefined;
+                description?: string | undefined;
                 tag?: string | undefined;
             }[] | undefined;
         }[] | undefined;
@@ -3303,6 +3413,73 @@ export declare const blumeConfigSchema: z.ZodObject<{
         to: string;
         status?: 301 | 302 | 307 | 308 | undefined;
     }[] | undefined;
+    search?: {
+        provider?: "algolia" | "mixedbread" | "orama" | "pagefind" | "flexsearch" | "orama-cloud" | "typesense" | "none" | undefined;
+        algolia?: {
+            appId: string;
+            indexName: string;
+            searchApiKey: string;
+        } | undefined;
+        indexing?: {
+            includeHiddenPages?: boolean | undefined;
+        } | undefined;
+        mixedbread?: {
+            storeId: string;
+        } | undefined;
+        oramaCloud?: {
+            apiKey: string;
+            endpoint: string;
+            indexId?: string | undefined;
+        } | undefined;
+        popular?: {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+        }[] | undefined;
+        typesense?: {
+            host: string;
+            searchApiKey: string;
+            collection: string;
+            port?: number | undefined;
+            protocol?: "http" | "https" | undefined;
+        } | undefined;
+    } | undefined;
+    seo?: {
+        agentReadability?: boolean | undefined;
+        contentSignals?: boolean | {
+            search?: boolean | undefined;
+            aiInput?: boolean | undefined;
+            aiTrain?: boolean | undefined;
+        } | undefined;
+        og?: {
+            enabled?: boolean | undefined;
+            logo?: string | undefined;
+            fonts?: (string | {
+                name: string;
+                style?: "normal" | "italic" | ("normal" | "italic")[] | undefined;
+                weight?: string | number | number[] | undefined;
+            })[] | undefined;
+            palette?: {
+                accent?: string | undefined;
+                background?: string | undefined;
+                border?: string | undefined;
+                foreground?: string | undefined;
+                muted?: string | undefined;
+            } | undefined;
+        } | undefined;
+        robots?: boolean | undefined;
+        rss?: {
+            enabled?: boolean | undefined;
+            limit?: number | undefined;
+            types?: string[] | undefined;
+        } | undefined;
+        sitemap?: boolean | undefined;
+        structuredData?: boolean | undefined;
+        x?: {
+            creator?: string | undefined;
+            handle?: string | undefined;
+        } | undefined;
+    } | undefined;
     toc?: boolean | {
         maxHeadingLevel?: number | undefined;
         minHeadingLevel?: number | undefined;
@@ -3310,6 +3487,8 @@ export declare const blumeConfigSchema: z.ZodObject<{
 }>;
 /** Resolved config: every field present after defaults are applied. */
 export type ResolvedConfig = z.infer<typeof blumeConfigSchema>;
+/** Resolved `frontmatter.extend`: custom key → user-supplied schema. */
+export type FrontmatterExtend = Record<string, StandardSchema>;
 /** Resolved i18n block (present only when the project opts into i18n). */
 export type ResolvedI18nConfig = z.infer<typeof i18nConfigSchema>;
 /** A configured locale with display metadata. */