blume 1.0.2 → 1.0.4

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

@@ -446,7 +446,21 @@ export interface LlmsTxtConfig {
      */
     openapi?: boolean;
 }
-/** AI-facing features: the Ask AI assistant and an `llms.txt` manifest. */
+/** Expose the docs as an MCP server for connecting agents. */
+export interface McpConfig {
+    /** Turn the MCP server on. Defaults to `false`. */
+    enabled?: boolean;
+    /** Optional system hint passed to connecting agents. */
+    instructions?: string;
+    /** Server name shown to clients; defaults to the site title. */
+    name?: string;
+    /** Route the server mounts at. Defaults to `/mcp`. */
+    route?: string;
+}
+/**
+ * AI-facing features: the Ask AI assistant, an `llms.txt` manifest, and the
+ * hosted MCP server.
+ */
 export interface AiConfig {
     /** The Ask AI chat assistant. */
     ask?: AskConfig;
@@ -474,6 +488,8 @@ export interface AiConfig {
      * ```
      */
     markdownComponents?: Record<string, ComponentMarkdown>;
+    /** Expose the docs as an MCP server for agents. */
+    mcp?: McpConfig;
 }
 /** An arbitrary analytics `<script>`; set exactly one of `src` or `content`. */
 export interface AnalyticsScript {
@@ -500,17 +516,6 @@ export interface AnalyticsConfig {
     /** Enable Vercel Web Analytics. */
     vercel?: boolean;
 }
-/** Expose the docs as an MCP server for connecting agents. */
-export interface McpConfig {
-    /** Turn the MCP server on. Defaults to `false`. */
-    enabled?: boolean;
-    /** Optional system hint passed to connecting agents. */
-    instructions?: string;
-    /** Server name shown to clients; defaults to the site title. */
-    name?: string;
-    /** Route the server mounts at. Defaults to `/mcp`. */
-    route?: string;
-}
 /** A configured locale plus display metadata for the switcher. */
 export interface LocaleConfigInput {
     /** Locale code, e.g. `en`, `fr`, `pt-BR`. */
@@ -597,6 +602,32 @@ 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. */
+export interface OgPaletteConfig {
+    /** Fallback mark color. Defaults to the light theme accent. */
+    accent?: string;
+    /** Card background. */
+    background?: string;
+    /** Footer divider. */
+    border?: string;
+    /** Headline and `currentColor` logo color. */
+    foreground?: string;
+    /** Description and footer text. */
+    muted?: string;
+}
+/** Per-page Open Graph image generation. */
+export interface OgConfig {
+    /**
+     * Generate an OG image per page. Defaults to on once a deployment `site`
+     * URL is known and off otherwise (`og:image` must be absolute). An explicit
+     * value always wins.
+     */
+    enabled?: boolean;
+    /** Local SVG used in the generated card instead of the site logo. */
+    logo?: string;
+    /** Optional generated-card colors. */
+    palette?: OgPaletteConfig;
+}
 /** Discoverability: OG images, feeds, sitemap, robots, and structured data. */
 export interface SeoConfig {
     /**
@@ -607,14 +638,7 @@ export interface SeoConfig {
     /** robots.txt `Content-Signal` usage declaration. Defaults to `true`. */
     contentSignals?: ContentSignalsConfig;
     /** Per-page Open Graph image generation. */
-    og?: {
-        /**
-         * Generate an OG image per page. Defaults to on once a deployment `site`
-         * URL is known and off otherwise (`og:image` must be absolute). An explicit
-         * value always wins.
-         */
-        enabled?: boolean;
-    };
+    og?: OgConfig;
     /** Generate robots.txt (with a Sitemap reference when available). Defaults to `true`. */
     robots?: boolean;
     /** RSS/Atom feeds. */
@@ -829,8 +853,6 @@ export interface BlumeConfig {
     logo?: LogoConfig;
     /** Markdown / MDX rendering behavior. */
     markdown?: MarkdownConfig;
-    /** Expose the docs as an MCP server for agents. */
-    mcp?: McpConfig;
     /** Header, sidebar, tabs, and switchers. */
     navigation?: NavigationConfig;
     /** Native OpenAPI reference. */

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

@@ -66,9 +66,9 @@ import type { Diagnostic } from "./types.ts";
  *   `algolia`, `typesense`, `orama-cloud`, `mixedbread`, or `none`) plus its
  *   credential block.
  * - `ai` — `ask` (the Ask AI chat endpoint and its provider/model), `llmsTxt`
- *   (emit `llms.txt`), and `markdownComponents` (Markdown serializers for
- *   custom components in agent-facing output).
- * - `mcp` — expose the docs as an MCP server for connecting agents.
+ *   (emit `llms.txt`), `mcp` (expose the docs as an MCP server for connecting
+ *   agents), and `markdownComponents` (Markdown serializers for custom
+ *   components in agent-facing output).
  *
  * **SEO, feeds & analytics**
  * - `seo` — `og` images, `sitemap`, `robots`, `rss` feeds, `structuredData`

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

@@ -13,6 +13,16 @@ export interface BlumeLogo {
     svg?: string;
     light?: string;
     dark?: string;
+    dimensions?: {
+        dark?: {
+            height: number;
+            width: number;
+        };
+        light?: {
+            height: number;
+            width: number;
+        };
+    };
     alt: string;
     href: string;
     /** Wordmark text beside the mark; `undefined` falls back to the site title. */
@@ -108,6 +118,8 @@ export interface BlumeDataConfig {
     /** Open Graph image generation. */
     og: {
         enabled: boolean;
+        logo?: string;
+        palette?: ResolvedConfig["seo"]["og"]["palette"];
     };
     /** Repository URL for header/edit links, or `null`. */
     repoUrl: string | null;

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

@@ -78,10 +78,10 @@ declare const uiStringsObject: z.ZodObject<{
         you: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         title: string;
-        error: string;
         label: string;
         ai: string;
         empty: string;
+        error: string;
         placeholder: string;
         send: string;
         clear: string;
@@ -91,10 +91,10 @@ declare const uiStringsObject: z.ZodObject<{
         you: string;
     }, {
         title?: string | undefined;
-        error?: string | undefined;
         label?: string | undefined;
         ai?: string | undefined;
         empty?: string | undefined;
+        error?: string | undefined;
         placeholder?: string | undefined;
         send?: string | undefined;
         clear?: string | undefined;
@@ -169,24 +169,24 @@ declare const uiStringsObject: z.ZodObject<{
         toggleNavigation: z.ZodDefault<z.ZodString>;
         toggleTheme: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        deprecated: string;
         featured: string;
         navigation: string;
         breadcrumb: string;
         back: string;
         closeNavigation: string;
+        deprecated: string;
         githubRepository: string;
         primary: string;
         sections: string;
         toggleNavigation: string;
         toggleTheme: string;
     }, {
-        deprecated?: string | undefined;
         featured?: string | undefined;
         navigation?: string | undefined;
         breadcrumb?: string | undefined;
         back?: string | undefined;
         closeNavigation?: string | undefined;
+        deprecated?: string | undefined;
         githubRepository?: string | undefined;
         primary?: string | undefined;
         sections?: string | undefined;
@@ -242,8 +242,8 @@ declare const uiStringsObject: z.ZodObject<{
         preview: z.ZodDefault<z.ZodString>;
         results: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        error: string;
         label: string;
+        error: string;
         placeholder: string;
         all: string;
         button: string;
@@ -258,8 +258,8 @@ declare const uiStringsObject: z.ZodObject<{
         preview: string;
         results: string;
     }, {
-        error?: string | undefined;
         label?: string | undefined;
+        error?: string | undefined;
         placeholder?: string | undefined;
         all?: string | undefined;
         button?: string | undefined;
@@ -282,41 +282,12 @@ declare const uiStringsObject: z.ZodObject<{
         title?: string | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    changelog: {
-        title: string;
-        description: string;
-        showReleases: string;
-    };
-    search: {
-        error: string;
-        label: string;
-        placeholder: string;
-        all: string;
-        button: string;
-        devOnly: string;
-        noResults: string;
-        allLanguages: string;
-        askAi: string;
-        askAiHint: string;
-        navigate: string;
-        open: string;
-        popular: string;
-        preview: string;
-        results: string;
-    };
-    page: {
-        lastUpdated: string;
-        next: string;
-        pagination: string;
-        previous: string;
-        skipToContent: string;
-    };
     ask: {
         title: string;
-        error: string;
         label: string;
         ai: string;
         empty: string;
+        error: string;
         placeholder: string;
         send: string;
         clear: string;
@@ -337,6 +308,35 @@ declare const uiStringsObject: z.ZodObject<{
         thanks: string;
         yes: string;
     };
+    page: {
+        lastUpdated: string;
+        next: string;
+        pagination: string;
+        previous: string;
+        skipToContent: string;
+    };
+    search: {
+        label: string;
+        error: string;
+        placeholder: string;
+        all: string;
+        button: string;
+        devOnly: string;
+        noResults: string;
+        allLanguages: string;
+        askAi: string;
+        askAiHint: string;
+        navigate: string;
+        open: string;
+        popular: string;
+        preview: string;
+        results: string;
+    };
+    changelog: {
+        title: string;
+        description: string;
+        showReleases: string;
+    };
     toc: {
         title: string;
     };
@@ -364,12 +364,12 @@ declare const uiStringsObject: z.ZodObject<{
         untranslated: string;
     };
     nav: {
-        deprecated: string;
         featured: string;
         navigation: string;
         breadcrumb: string;
         back: string;
         closeNavigation: string;
+        deprecated: string;
         githubRepository: string;
         primary: string;
         sections: string;
@@ -382,41 +382,12 @@ declare const uiStringsObject: z.ZodObject<{
         home: string;
     };
 }, {
-    changelog?: {
-        title?: string | undefined;
-        description?: string | undefined;
-        showReleases?: string | undefined;
-    } | undefined;
-    search?: {
-        error?: string | undefined;
-        label?: string | undefined;
-        placeholder?: string | undefined;
-        all?: string | undefined;
-        button?: string | undefined;
-        devOnly?: string | undefined;
-        noResults?: string | undefined;
-        allLanguages?: string | undefined;
-        askAi?: string | undefined;
-        askAiHint?: string | undefined;
-        navigate?: string | undefined;
-        open?: string | undefined;
-        popular?: string | undefined;
-        preview?: string | undefined;
-        results?: string | undefined;
-    } | undefined;
-    page?: {
-        lastUpdated?: string | undefined;
-        next?: string | undefined;
-        pagination?: string | undefined;
-        previous?: string | undefined;
-        skipToContent?: string | undefined;
-    } | undefined;
     ask?: {
         title?: string | undefined;
-        error?: string | undefined;
         label?: string | undefined;
         ai?: string | undefined;
         empty?: string | undefined;
+        error?: string | undefined;
         placeholder?: string | undefined;
         send?: string | undefined;
         clear?: string | undefined;
@@ -437,6 +408,35 @@ declare const uiStringsObject: z.ZodObject<{
         thanks?: string | undefined;
         yes?: string | undefined;
     } | undefined;
+    page?: {
+        lastUpdated?: string | undefined;
+        next?: string | undefined;
+        pagination?: string | undefined;
+        previous?: string | undefined;
+        skipToContent?: string | undefined;
+    } | undefined;
+    search?: {
+        label?: string | undefined;
+        error?: string | undefined;
+        placeholder?: string | undefined;
+        all?: string | undefined;
+        button?: string | undefined;
+        devOnly?: string | undefined;
+        noResults?: string | undefined;
+        allLanguages?: string | undefined;
+        askAi?: string | undefined;
+        askAiHint?: string | undefined;
+        navigate?: string | undefined;
+        open?: string | undefined;
+        popular?: string | undefined;
+        preview?: string | undefined;
+        results?: string | undefined;
+    } | undefined;
+    changelog?: {
+        title?: string | undefined;
+        description?: string | undefined;
+        showReleases?: string | undefined;
+    } | undefined;
     toc?: {
         title?: string | undefined;
     } | undefined;
@@ -464,12 +464,12 @@ declare const uiStringsObject: z.ZodObject<{
         untranslated?: string | undefined;
     } | undefined;
     nav?: {
-        deprecated?: string | undefined;
         featured?: string | undefined;
         navigation?: string | undefined;
         breadcrumb?: string | undefined;
         back?: string | undefined;
         closeNavigation?: string | undefined;
+        deprecated?: string | undefined;
         githubRepository?: string | undefined;
         primary?: string | undefined;
         sections?: string | undefined;
@@ -553,10 +553,10 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
         you: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         title: string;
-        error: string;
         label: string;
         ai: string;
         empty: string;
+        error: string;
         placeholder: string;
         send: string;
         clear: string;
@@ -566,10 +566,10 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
         you: string;
     }, {
         title?: string | undefined;
-        error?: string | undefined;
         label?: string | undefined;
         ai?: string | undefined;
         empty?: string | undefined;
+        error?: string | undefined;
         placeholder?: string | undefined;
         send?: string | undefined;
         clear?: string | undefined;
@@ -644,24 +644,24 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
         toggleNavigation: z.ZodDefault<z.ZodString>;
         toggleTheme: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        deprecated: string;
         featured: string;
         navigation: string;
         breadcrumb: string;
         back: string;
         closeNavigation: string;
+        deprecated: string;
         githubRepository: string;
         primary: string;
         sections: string;
         toggleNavigation: string;
         toggleTheme: string;
     }, {
-        deprecated?: string | undefined;
         featured?: string | undefined;
         navigation?: string | undefined;
         breadcrumb?: string | undefined;
         back?: string | undefined;
         closeNavigation?: string | undefined;
+        deprecated?: string | undefined;
         githubRepository?: string | undefined;
         primary?: string | undefined;
         sections?: string | undefined;
@@ -717,8 +717,8 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
         preview: z.ZodDefault<z.ZodString>;
         results: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        error: string;
         label: string;
+        error: string;
         placeholder: string;
         all: string;
         button: string;
@@ -733,8 +733,8 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
         preview: string;
         results: string;
     }, {
-        error?: string | undefined;
         label?: string | undefined;
+        error?: string | undefined;
         placeholder?: string | undefined;
         all?: string | undefined;
         button?: string | undefined;
@@ -757,41 +757,12 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
         title?: string | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    changelog: {
-        title: string;
-        description: string;
-        showReleases: string;
-    };
-    search: {
-        error: string;
-        label: string;
-        placeholder: string;
-        all: string;
-        button: string;
-        devOnly: string;
-        noResults: string;
-        allLanguages: string;
-        askAi: string;
-        askAiHint: string;
-        navigate: string;
-        open: string;
-        popular: string;
-        preview: string;
-        results: string;
-    };
-    page: {
-        lastUpdated: string;
-        next: string;
-        pagination: string;
-        previous: string;
-        skipToContent: string;
-    };
     ask: {
         title: string;
-        error: string;
         label: string;
         ai: string;
         empty: string;
+        error: string;
         placeholder: string;
         send: string;
         clear: string;
@@ -812,6 +783,35 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
         thanks: string;
         yes: string;
     };
+    page: {
+        lastUpdated: string;
+        next: string;
+        pagination: string;
+        previous: string;
+        skipToContent: string;
+    };
+    search: {
+        label: string;
+        error: string;
+        placeholder: string;
+        all: string;
+        button: string;
+        devOnly: string;
+        noResults: string;
+        allLanguages: string;
+        askAi: string;
+        askAiHint: string;
+        navigate: string;
+        open: string;
+        popular: string;
+        preview: string;
+        results: string;
+    };
+    changelog: {
+        title: string;
+        description: string;
+        showReleases: string;
+    };
     toc: {
         title: string;
     };
@@ -839,12 +839,12 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
         untranslated: string;
     };
     nav: {
-        deprecated: string;
         featured: string;
         navigation: string;
         breadcrumb: string;
         back: string;
         closeNavigation: string;
+        deprecated: string;
         githubRepository: string;
         primary: string;
         sections: string;
@@ -857,41 +857,12 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
         home: string;
     };
 }, {
-    changelog?: {
-        title?: string | undefined;
-        description?: string | undefined;
-        showReleases?: string | undefined;
-    } | undefined;
-    search?: {
-        error?: string | undefined;
-        label?: string | undefined;
-        placeholder?: string | undefined;
-        all?: string | undefined;
-        button?: string | undefined;
-        devOnly?: string | undefined;
-        noResults?: string | undefined;
-        allLanguages?: string | undefined;
-        askAi?: string | undefined;
-        askAiHint?: string | undefined;
-        navigate?: string | undefined;
-        open?: string | undefined;
-        popular?: string | undefined;
-        preview?: string | undefined;
-        results?: string | undefined;
-    } | undefined;
-    page?: {
-        lastUpdated?: string | undefined;
-        next?: string | undefined;
-        pagination?: string | undefined;
-        previous?: string | undefined;
-        skipToContent?: string | undefined;
-    } | undefined;
     ask?: {
         title?: string | undefined;
-        error?: string | undefined;
         label?: string | undefined;
         ai?: string | undefined;
         empty?: string | undefined;
+        error?: string | undefined;
         placeholder?: string | undefined;
         send?: string | undefined;
         clear?: string | undefined;
@@ -912,6 +883,35 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
         thanks?: string | undefined;
         yes?: string | undefined;
     } | undefined;
+    page?: {
+        lastUpdated?: string | undefined;
+        next?: string | undefined;
+        pagination?: string | undefined;
+        previous?: string | undefined;
+        skipToContent?: string | undefined;
+    } | undefined;
+    search?: {
+        label?: string | undefined;
+        error?: string | undefined;
+        placeholder?: string | undefined;
+        all?: string | undefined;
+        button?: string | undefined;
+        devOnly?: string | undefined;
+        noResults?: string | undefined;
+        allLanguages?: string | undefined;
+        askAi?: string | undefined;
+        askAiHint?: string | undefined;
+        navigate?: string | undefined;
+        open?: string | undefined;
+        popular?: string | undefined;
+        preview?: string | undefined;
+        results?: string | undefined;
+    } | undefined;
+    changelog?: {
+        title?: string | undefined;
+        description?: string | undefined;
+        showReleases?: string | undefined;
+    } | undefined;
     toc?: {
         title?: string | undefined;
     } | undefined;
@@ -939,12 +939,12 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
         untranslated?: string | undefined;
     } | undefined;
     nav?: {
-        deprecated?: string | undefined;
         featured?: string | undefined;
         navigation?: string | undefined;
         breadcrumb?: string | undefined;
         back?: string | undefined;
         closeNavigation?: string | undefined;
+        deprecated?: string | undefined;
         githubRepository?: string | undefined;
         primary?: string | undefined;
         sections?: string | undefined;