blume 1.2.0 → 1.3.0

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

@@ -330,14 +330,50 @@ export interface NavigationConfig {
     /** Top-level tabs shown in the header. */
     tabs?: NavTab[];
 }
-/** The three type roles, each a curated Google Font slug. */
+/** Fallback stack category for a custom font. */
+export type FontFallback = "sans" | "serif" | "mono";
+/**
+ * Any family from a zero-config Astro font provider, by name. Self-hosted and
+ * optimized like the curated slugs.
+ */
+export interface RemoteFontInput {
+    /** Fallback stack. Defaults to `mono` for the mono role, `sans` otherwise. */
+    fallback?: FontFallback;
+    /** Family name as the provider lists it, e.g. `"Noto Sans JP"`. */
+    name: string;
+    /** Which provider serves the family. Defaults to `google`. */
+    provider?: "google" | "fontsource" | "bunny" | "fontshare";
+    /** Weights (or variable ranges like `"100..900"`) to load. Defaults to `[400, 500, 600, 700]`. */
+    weights?: (number | string)[];
+}
+/** One local `@font-face`: a file plus optional weight/style (else inferred). */
+export interface LocalFontVariantInput {
+    /** Font file path, relative to the project root. */
+    src: string;
+    /** Face style; inferred from the file when omitted. */
+    style?: "normal" | "italic" | "oblique";
+    /** Face weight (a number or `"100..900"` range); inferred when omitted. */
+    weight?: number | string;
+}
+/** A self-hosted family loaded from font files in the project. */
+export interface LocalFontInput {
+    /** Fallback stack. Defaults to `mono` for the mono role, `sans` otherwise. */
+    fallback?: FontFallback;
+    /** Family name used in CSS and the OG card. */
+    name: string;
+    /** The faces to declare (at least one). */
+    variants: LocalFontVariantInput[];
+}
+/** A role's font: curated slug, remote-provider family, or local files. */
+export type FontInput = LiteralUnion<FontSlug> | RemoteFontInput | LocalFontInput;
+/** The three type roles: a curated slug, any provider family, or local files. */
 export interface FontsConfig {
     /** Body / prose font. Defaults to `inter`. */
-    body?: LiteralUnion<FontSlug>;
+    body?: FontInput;
     /** Display / heading font. Defaults to `inter-tight`. */
-    display?: LiteralUnion<FontSlug>;
+    display?: FontInput;
     /** Monospace / code font. Defaults to `ibm-plex-mono`. */
-    mono?: LiteralUnion<FontSlug>;
+    mono?: FontInput;
 }
 /** Colors, fonts, radius, and color-mode behavior. */
 /** Corner radius scale (`none`/`sm` tighter, `md`/`lg` rounder). */
@@ -524,6 +560,39 @@ export interface AiConfig {
     markdownComponents?: Record<string, ComponentMarkdown>;
     /** Expose the docs as an MCP server for agents. */
     mcp?: McpConfig;
+    /**
+     * Publish Agent Skills for discovery: a directory (resolved against the
+     * project root) whose subdirectories each hold a `SKILL.md`. Skills are
+     * copied under `/.well-known/agent-skills/` — single-file skills verbatim,
+     * skills with supporting resources as `.tar.gz` archives — and enumerated
+     * in a discovery index with SHA-256 digests (Agent Skills Discovery RFC).
+     *
+     * ```ts
+     * ai: {
+     *   skills: "./skills",
+     * }
+     * ```
+     */
+    skills?: string;
+    /**
+     * Web Bot Auth: publish the org's HTTP Message Signature public keys at
+     * `/.well-known/http-message-signatures-directory`, so sites receiving
+     * requests from your agents can verify them. Public keys only — a key
+     * containing private material (`d`, `p`, `q`, …) is rejected.
+     */
+    webBotAuth?: WebBotAuthConfig;
+    /**
+     * WebMCP: register in-page tools (search, page Markdown, the docs index)
+     * on the browser's model context, so agentic browsers can drive the docs
+     * without a separate MCP connection. The script is tiny and no-ops in
+     * browsers without the API. Defaults to `true`; set `false` to opt out.
+     */
+    webmcp?: boolean;
+}
+/** Web Bot Auth signature directory. Off until at least one key is listed. */
+export interface WebBotAuthConfig {
+    /** Public JWKs to publish (e.g. an Ed25519 key: `kty: "OKP"`, `crv: "Ed25519"`, `x: …`). */
+    keys?: Record<string, unknown>[];
 }
 /** An arbitrary analytics `<script>`; set exactly one of `src` or `content`. */
 export interface AnalyticsScript {
@@ -601,6 +670,32 @@ export interface DeploymentConfig {
      */
     site?: string;
 }
+/**
+ * One authorized remote image source, passed through to Astro's
+ * `image.remotePatterns`. Hostnames accept `*.` (one level) and `**.` (any
+ * depth) wildcards; pathnames accept `/dir/*` and `/dir/**` the same way.
+ */
+export interface ImageRemotePattern {
+    /** Hostname pattern, e.g. `"**.example.com"`. */
+    hostname?: string;
+    /** Pathname pattern, e.g. `"/images/**"`. */
+    pathname?: string;
+    /** Port, e.g. `"8080"`. */
+    port?: string;
+    /** URL scheme, e.g. `"https"`. */
+    protocol?: string;
+}
+/**
+ * Image optimization. Local images referenced by relative path are optimized
+ * automatically; remote images are only optimized when their host is
+ * authorized here. Both fields map directly onto Astro's `image` config.
+ */
+export interface ImageConfig {
+    /** Hosts whose remote images may be optimized, e.g. `["cdn.example.com"]`. */
+    domains?: string[];
+    /** Pattern-based host authorization, for wildcards `domains` can't express. */
+    remotePatterns?: ImageRemotePattern[];
+}
 /** HTTP redirect status codes: permanent (301/308) and temporary (302/307). */
 type RedirectStatusPermanent = 301 | 308;
 type RedirectStatusTemporary = 302 | 307;
@@ -651,6 +746,11 @@ export interface OgPaletteConfig {
 }
 /** Per-page Open Graph image generation. */
 export interface OgConfig {
+    /**
+     * Card subtitle. Defaults to the site description; a string overrides it,
+     * `false` renders the card without one.
+     */
+    description?: string | false;
     /**
      * 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
@@ -658,21 +758,39 @@ export interface OgConfig {
      */
     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 for the generated card, extending Takumi's Latin-only default so
+     * non-Latin titles (CJK, and so on) render instead of tofu. A bare string is
+     * a Google Fonts family fetched at build; the name-only object form pins
+     * weights (`700`, `[400, 700]`, or a `"100..900"` variable range) and
+     * styles; the `src` form reads a local font file from the project instead.
+     * When omitted and `theme.fonts` is explicitly configured, the theme's
+     * display and body fonts are used automatically — pass `[]` to opt out.
      */
     fonts?: (string | {
         name: string;
         style?: "normal" | "italic" | ("normal" | "italic")[];
         weight?: number | number[] | string;
+    } | {
+        /** Family name registered for the file's faces. */
+        name: string;
+        /** Font file path, relative to the project root. */
+        src: string;
+        style?: "normal" | "italic";
+        weight?: number;
     })[];
-    /** Local SVG used in the generated card instead of the site logo. */
-    logo?: string;
+    /**
+     * Local SVG used in the generated card instead of the site logo; `false`
+     * renders the card without any brand mark.
+     */
+    logo?: string | false;
     /** Optional generated-card colors. */
     palette?: OgPaletteConfig;
+    /**
+     * Footer site text. Defaults to the deployment site's host plus
+     * `deployment.base` (`docs.acme.com`, `user.github.io/repo`); a string
+     * overrides it, `false` hides it.
+     */
+    site?: string | false;
     /**
      * Card headlines for custom `.astro` pages, keyed by route (`"/"`, `"/cli"`).
      * A custom page has no frontmatter to read, so its card is otherwise titled
@@ -977,6 +1095,8 @@ export interface BlumeConfig {
     github?: GithubConfig;
     /** Internationalization (opt-in multi-locale). */
     i18n?: I18nConfig;
+    /** Image optimization: remote-host authorization for the image service. */
+    image?: ImageConfig;
     /** Astro integrations appended after Blume's built-ins, in declaration order. */
     integrations?: AstroIntegration[];
     /** "Last updated" timestamps from git history or frontmatter. Defaults to `false`. */

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

@@ -47,7 +47,8 @@ import type { Diagnostic } from "./types.ts";
  *   and the header repo link.
  *
  * **Appearance**
- * - `theme` — `accent` color, `fonts` (curated Google Font slugs), `radius`,
+ * - `theme` — `accent` color, `fonts` (curated slugs, any provider family, or
+ *   local font files), `radius`,
  *   `mode` (`system`/`light`/`dark`), and `background`.
  * - `markdown` — `code` (language icons, inline highlighting, line wrap),
  *   `headingAnchors`, `imageZoom`, and opt-in KaTeX `math`.
@@ -140,6 +141,13 @@ export interface ConfigLoadResult {
     /** Absolute path of the config file used, or null when defaults were used. */
     configFile: string | null;
     diagnostics: Diagnostic[];
+    /**
+     * Whether the config file set `theme.fonts` itself. The schema always fills
+     * the roles with defaults, so the resolved config can't tell an intentional
+     * font choice from the fallback — and only intentional choices should flow
+     * into derived surfaces like OG card fonts.
+     */
+    themeFontsConfigured: boolean;
 }
 /**
  * Load and validate the project config. When no config file exists, schema

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

@@ -1,4 +1,3 @@
-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";
@@ -119,13 +118,25 @@ export interface BlumeDataConfig {
         name: string;
         route: string;
     } | null;
-    /** Open Graph image generation. */
+    /**
+     * Open Graph image generation. Card fonts are baked into the generated OG
+     * endpoint (they can carry absolute build-machine paths) and deliberately
+     * kept out of this snapshot, which pages serialize into HTML.
+     */
     og: {
+        /** Card subtitle: `seo.og.description` (`false` omits it) over the site description. */
+        description?: string;
         enabled: boolean;
-        /** Extra Google Font family specs for the card renderer, fetched at build. */
-        fonts?: OgFont[];
-        logo?: string;
+        /** Inlined SVG brand mark; `false` renders the card without any mark. */
+        logo?: string | false;
         palette?: ResolvedConfig["seo"]["og"]["palette"];
+        /**
+         * Footer site text: `seo.og.site` if set (`false` hides it), otherwise
+         * the deployment site's host plus `deployment.base` (`docs.acme.com`,
+         * `user.github.io/repo`) — so a subpath deploy's card names the actual
+         * site rather than the platform's shared apex host.
+         */
+        site?: string;
     };
     /** Repository URL for header/edit links, or `null`. */
     repoUrl: string | null;
@@ -146,6 +157,14 @@ export interface BlumeDataConfig {
     title: string;
     /** Table-of-contents settings: whether to show it and the heading range. */
     toc: ResolvedConfig["toc"];
+    /**
+     * WebMCP in-page tools (`ai.webmcp`), plus whether llms.txt exists for the
+     * list tool to fetch (`ai.llmsTxt.enabled`).
+     */
+    webmcp: {
+        enabled: boolean;
+        llms: boolean;
+    };
     /** X (Twitter) attribution: the site's account, and a default creator. */
     x: {
         creator?: string;