blume 1.0.4 → 1.1.0

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

@@ -2,6 +2,7 @@ import type { ComponentMarkdown } from "../ai/component-markdown.ts";
 import type { FontSlug } from "../theme/fonts.ts";
 import type { OpenApiSource, SearchProvider, SidebarDisplay, SidebarItemConfig } from "./schema.ts";
 import type { ContentSource } from "./sources/types.ts";
+import type { StandardSchema } from "./standard-schema.ts";
 /**
  * The public, hand-documented authoring type for `blume.config.ts`.
  *
@@ -382,6 +383,15 @@ export interface TypesenseSearch {
 export interface MixedbreadSearch {
     storeId: string;
 }
+/** A curated link for the search dialog empty state. */
+export interface SearchPopularLink {
+    /** Internal route or external URL. */
+    href: string;
+    /** Built-in icon name shown beside the label; defaults to the file glyph. */
+    icon?: string;
+    /** Link label shown in the dialog. */
+    label: string;
+}
 /**
  * Search backend. The default `orama` builds a local index at build time (and
  * runs in dev); hosted providers need their credential block below. `none`
@@ -399,6 +409,11 @@ export interface SearchConfig {
     mixedbread?: MixedbreadSearch;
     /** Orama Cloud credentials (required when `provider` is `orama-cloud`). */
     oramaCloud?: OramaCloudSearch;
+    /**
+     * Curated links for the Cmd+K empty state. When omitted or empty, the first
+     * sidebar pages are shown instead.
+     */
+    popular?: SearchPopularLink[];
     /** Which backend powers search. Defaults to `orama`. */
     provider?: SearchProvider;
     /** Typesense credentials (required when `provider` is `typesense`). */
@@ -602,7 +617,7 @@ export interface RssConfig {
     /** Content types that each get a feed at `/<type>/rss.xml`. Defaults to blog + changelog. */
     types?: string[];
 }
-/** Colors used by generated Open Graph cards. Values must be hex colors. */
+/** Colors used by generated Open Graph cards. Any CSS color — hex, `oklch(…)`, `rgb(…)`, named. */
 export interface OgPaletteConfig {
     /** Fallback mark color. Defaults to the light theme accent. */
     accent?: string;
@@ -623,6 +638,18 @@ export interface OgConfig {
      * value always wins.
      */
     enabled?: boolean;
+    /**
+     * 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. A bare string loads the family's
+     * default weights; the object form pins weights (`700`, `[400, 700]`, or a
+     * `"100..900"` variable range) and styles.
+     */
+    fonts?: (string | {
+        name: string;
+        style?: "normal" | "italic" | ("normal" | "italic")[];
+        weight?: number | number[] | string;
+    })[];
     /** Local SVG used in the generated card instead of the site logo. */
     logo?: string;
     /** Optional generated-card colors. */
@@ -780,6 +807,37 @@ export type ExportConfig = boolean | {
     /** Offer PDF export (via print). Defaults to `false`. */
     pdf?: boolean;
 };
+/**
+ * Opt-in custom frontmatter keys. Page frontmatter is strictly validated —
+ * an unknown key fails the build so typos are caught — and `extend` carves
+ * out project-specific keys from that rule, each validated by a schema you
+ * supply.
+ */
+export interface FrontmatterConfig {
+    /**
+     * Extra frontmatter keys pages may carry, mapped to their validation
+     * schemas — any library implementing Standard Schema works (Zod — the
+     * version your project installs, 3.24+ or 4 — Valibot, ArkType):
+     *
+     * ```ts
+     * import { z } from "zod";
+     *
+     * frontmatter: {
+     *   extend: {
+     *     owner: z.string(),
+     *     reviewedAt: z.coerce.date().optional(),
+     *   },
+     * },
+     * ```
+     *
+     * Every declared key is validated on every page — absent ones included —
+     * so a required schema enforces the key site-wide; mark it `.optional()`
+     * to validate only when present. Validated values are preserved on each
+     * page record's `custom` field. Built-in frontmatter fields cannot be
+     * redeclared.
+     */
+    extend?: Record<string, StandardSchema>;
+}
 /**
  * "Last updated" timestamps. `false` (default) disables them; `true` derives
  * each date from git history; the object form selects the source. A page's
@@ -843,6 +901,8 @@ export interface BlumeConfig {
     export?: ExportConfig;
     /** Show the per-page "Was this helpful?" widget. Defaults to `true`. */
     feedback?: boolean;
+    /** Opt-in custom frontmatter keys, validated by schemas you supply. */
+    frontmatter?: FrontmatterConfig;
     /** Source repository (Edit-this-page links and the header repo link). */
     github?: GithubConfig;
     /** Internationalization (opt-in multi-locale). */

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

@@ -1,3 +1,4 @@
+import type { OgFont } from "../og/card.ts";
 import type { UIStrings } from "./i18n-ui.ts";
 import type { ResolvedConfig, SearchProvider } from "./schema.ts";
 import type { Navigation, RouteAlternate } from "./types.ts";
@@ -118,6 +119,8 @@ export interface BlumeDataConfig {
     /** Open Graph image generation. */
     og: {
         enabled: boolean;
+        /** Extra Google Font family specs for the card renderer, fetched at build. */
+        fonts?: OgFont[];
         logo?: string;
         palette?: ResolvedConfig["seo"]["og"]["palette"];
     };
@@ -125,6 +128,12 @@ export interface BlumeDataConfig {
     repoUrl: string | null;
     search: {
         enabled: boolean;
+        /** Resolved empty-state links; empty when unset (Search falls back to sidebar). */
+        popular: {
+            icon?: string;
+            label: string;
+            route: string;
+        }[];
         provider: SearchProvider;
     };
     /** Deployment site URL, or `null` when none is configured/detected. */

package/dist/types/core/deployment-env.d.ts

@@ -1,4 +1,10 @@
 import type { ResolvedConfig } from "./schema.ts";
+/**
+ * Adapters whose `deployment.site` arrives from platform env vars at deploy
+ * time. Consumers (e.g. the audit) use this to tell "site is missing" apart
+ * from "site is missing *here*, but the platform will set it".
+ */
+export declare const SITE_INFERRING_ADAPTERS: ReadonlySet<string>;
 /**
  * Fill in `deployment.adapter` and `deployment.site` from platform env vars
  * (Vercel, Netlify, Cloudflare Pages) when the user hasn't set them. Explicit

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

@@ -10,6 +10,29 @@ export declare const createDiagnostic: (diagnostic: Diagnostic) => Diagnostic;
 export declare const resolveDocsUrl: (code: string) => string | undefined;
 /** Fill in `docsUrl` from the code map where a diagnostic doesn't set its own. */
 export declare const enrichDiagnostic: (diagnostic: Diagnostic) => Diagnostic;
+/**
+ * Locate a front matter key in a content file, e.g. `["seo", "description"]` in
+ * `docs/api.mdx`. Scoped to the front matter block so a `title:` written in the
+ * page body can't be mistaken for the front matter key of the same name; returns
+ * undefined when the file has no front matter or the key isn't set (a missing
+ * key has no line to point at — callers anchor to the file instead).
+ */
+export declare const locateFrontmatterKey: (source: string, path: readonly (string | number)[]) => {
+    column: number;
+    line: number;
+} | undefined;
+/**
+ * Convert generic validation issues (message + path, the shape shared by Zod
+ * and Standard Schema issues) into Blume diagnostics, anchored to a file.
+ */
+export declare const diagnosticsFromIssues: (issues: readonly {
+    message: string;
+    path: readonly (string | number)[];
+}[], options: {
+    code: string;
+    file?: string;
+    source?: string;
+}) => Diagnostic[];
 /** Convert a ZodError into Blume diagnostics, anchored to a file. */
 export declare const diagnosticsFromZod: (error: ZodError, options: {
     code: string;

package/dist/types/core/i18n-ui.d.ts

@@ -243,6 +243,7 @@ declare const uiStringsObject: z.ZodObject<{
         results: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         label: string;
+        popular: string;
         error: string;
         placeholder: string;
         all: string;
@@ -254,11 +255,11 @@ declare const uiStringsObject: z.ZodObject<{
         askAiHint: string;
         navigate: string;
         open: string;
-        popular: string;
         preview: string;
         results: string;
     }, {
         label?: string | undefined;
+        popular?: string | undefined;
         error?: string | undefined;
         placeholder?: string | undefined;
         all?: string | undefined;
@@ -270,7 +271,6 @@ declare const uiStringsObject: z.ZodObject<{
         askAiHint?: string | undefined;
         navigate?: string | undefined;
         open?: string | undefined;
-        popular?: string | undefined;
         preview?: string | undefined;
         results?: string | undefined;
     }>>;
@@ -317,6 +317,7 @@ declare const uiStringsObject: z.ZodObject<{
     };
     search: {
         label: string;
+        popular: string;
         error: string;
         placeholder: string;
         all: string;
@@ -328,7 +329,6 @@ declare const uiStringsObject: z.ZodObject<{
         askAiHint: string;
         navigate: string;
         open: string;
-        popular: string;
         preview: string;
         results: string;
     };
@@ -417,6 +417,7 @@ declare const uiStringsObject: z.ZodObject<{
     } | undefined;
     search?: {
         label?: string | undefined;
+        popular?: string | undefined;
         error?: string | undefined;
         placeholder?: string | undefined;
         all?: string | undefined;
@@ -428,7 +429,6 @@ declare const uiStringsObject: z.ZodObject<{
         askAiHint?: string | undefined;
         navigate?: string | undefined;
         open?: string | undefined;
-        popular?: string | undefined;
         preview?: string | undefined;
         results?: string | undefined;
     } | undefined;
@@ -718,6 +718,7 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
         results: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         label: string;
+        popular: string;
         error: string;
         placeholder: string;
         all: string;
@@ -729,11 +730,11 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
         askAiHint: string;
         navigate: string;
         open: string;
-        popular: string;
         preview: string;
         results: string;
     }, {
         label?: string | undefined;
+        popular?: string | undefined;
         error?: string | undefined;
         placeholder?: string | undefined;
         all?: string | undefined;
@@ -745,7 +746,6 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
         askAiHint?: string | undefined;
         navigate?: string | undefined;
         open?: string | undefined;
-        popular?: string | undefined;
         preview?: string | undefined;
         results?: string | undefined;
     }>>;
@@ -792,6 +792,7 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
     };
     search: {
         label: string;
+        popular: string;
         error: string;
         placeholder: string;
         all: string;
@@ -803,7 +804,6 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
         askAiHint: string;
         navigate: string;
         open: string;
-        popular: string;
         preview: string;
         results: string;
     };
@@ -892,6 +892,7 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
     } | undefined;
     search?: {
         label?: string | undefined;
+        popular?: string | undefined;
         error?: string | undefined;
         placeholder?: string | undefined;
         all?: string | undefined;
@@ -903,7 +904,6 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
         askAiHint?: string | undefined;
         navigate?: string | undefined;
         open?: string | undefined;
-        popular?: string | undefined;
         preview?: string | undefined;
         results?: string | undefined;
     } | undefined;

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. */
@@ -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>;
@@ -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;
@@ -2313,6 +2336,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
         indexing: {
             includeHiddenPages: boolean;
         };
+        popular: {
+            label: string;
+            href: string;
+            icon?: string | 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;
@@ -2363,6 +2396,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
         indexing: {
             includeHiddenPages: boolean;
         };
+        popular: {
+            label: string;
+            href: string;
+            icon?: string | 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,6 +2489,24 @@ 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. */
@@ -2471,6 +2532,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
         }, "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;
@@ -2481,6 +2547,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
         }, {
             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;
@@ -2533,6 +2604,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
         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;
@@ -2563,6 +2639,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
         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;
@@ -2651,15 +2732,15 @@ 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: "none" | "sm" | "md" | "lg";
@@ -2673,6 +2754,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
             light?: string | undefined;
         } | undefined;
     }, {
+        fonts?: {
+            mono?: string | undefined;
+            display?: string | undefined;
+            body?: string | undefined;
+        } | undefined;
         accent?: string | {
             dark: string;
             light: string;
@@ -2686,11 +2772,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
             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?: "none" | "sm" | "md" | "lg" | undefined;
@@ -2839,15 +2920,15 @@ 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: "none" | "sm" | "md" | "lg";
@@ -2863,7 +2944,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
     };
     basePath: string;
     lastModified: boolean | {
-        type: "git" | "frontmatter";
+        type: "frontmatter" | "git";
     };
     deployment: {
         adapter: "vercel" | "node" | "netlify" | "cloudflare" | null;
@@ -2880,6 +2961,9 @@ export declare const blumeConfigSchema: z.ZodObject<{
         pdf: boolean;
     };
     feedback: boolean;
+    frontmatter: {
+        extend: Record<string, StandardSchema<unknown, unknown>>;
+    };
     markdown: {
         code: {
             icons: boolean;
@@ -2942,6 +3026,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
         indexing: {
             includeHiddenPages: boolean;
         };
+        popular: {
+            label: string;
+            href: string;
+            icon?: string | undefined;
+        }[];
         algolia?: {
             appId: string;
             indexName: string;
@@ -2973,6 +3062,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
         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;
@@ -3181,6 +3275,11 @@ 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;
@@ -3194,11 +3293,6 @@ export declare const blumeConfigSchema: z.ZodObject<{
             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?: "none" | "sm" | "md" | "lg" | undefined;
@@ -3221,7 +3315,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
     } | undefined;
     description?: string | undefined;
     lastModified?: boolean | {
-        type?: "git" | "frontmatter" | undefined;
+        type?: "frontmatter" | "git" | undefined;
     } | undefined;
     deployment?: {
         adapter?: "vercel" | "node" | "netlify" | "cloudflare" | null | undefined;
@@ -3238,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;
@@ -3334,6 +3431,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;
@@ -3352,6 +3454,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
         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;
@@ -3380,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. */

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

@@ -1,4 +1,4 @@
-import type { ResolvedI18nConfig } from "../schema.ts";
+import type { FrontmatterExtend, ResolvedI18nConfig } from "../schema.ts";
 import type { Diagnostic } from "../types.ts";
 /**
  * A single content item, normalized by a source adapter. Adapters lower their
@@ -111,5 +111,7 @@ export interface NormalizeContext {
     /** Site-wide route mount point (`""` or `/seg`), prepended to every route. */
     basePath?: string;
     defaultType: string;
+    /** Opt-in custom frontmatter keys (`frontmatter.extend`), schema per key. */
+    frontmatterExtend?: FrontmatterExtend;
     i18n?: ResolvedI18nConfig;
 }