blume 2.1.1 → 2.1.3

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

@@ -1169,6 +1169,15 @@ export declare const blumeConfigSchema: z.ZodObject<{
         }, z.core.$strict>;
         requiredSecrets: z.ZodArray<z.ZodString>;
         runtimeDeps: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"clics">;
+        options: z.ZodObject<{
+            allowLocalhost: z.ZodOptional<z.ZodBoolean>;
+            disableOutboundLinks: z.ZodOptional<z.ZodBoolean>;
+            projectId: z.ZodString;
+        }, z.core.$strict>;
+        requiredSecrets: z.ZodArray<z.ZodString>;
+        runtimeDeps: z.ZodArray<z.ZodString>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"cloudflare">;
         options: z.ZodObject<{
@@ -1494,6 +1503,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 pollInterval?: number | undefined;
                 prefix?: string | undefined;
                 concurrency?: number | undefined;
+                mdx?: boolean | undefined;
                 properties?: {
                     description?: string | undefined;
                     order?: string | undefined;
@@ -1653,6 +1663,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 pollInterval?: number | undefined;
                 prefix?: string | undefined;
                 concurrency?: number | undefined;
+                mdx?: boolean | undefined;
                 properties?: {
                     description?: string | undefined;
                     order?: string | undefined;
@@ -1812,6 +1823,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 prefix: z.ZodOptional<z.ZodString>;
                 concurrency: z.ZodOptional<z.ZodNumber>;
                 database: z.ZodString;
+                mdx: z.ZodOptional<z.ZodBoolean>;
                 properties: z.ZodOptional<z.ZodObject<{
                     description: z.ZodOptional<z.ZodString>;
                     order: z.ZodOptional<z.ZodString>;
@@ -1971,6 +1983,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 pollInterval?: number | undefined;
                 prefix?: string | undefined;
                 concurrency?: number | undefined;
+                mdx?: boolean | undefined;
                 properties?: {
                     description?: string | undefined;
                     order?: string | undefined;
@@ -2130,6 +2143,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 pollInterval?: number | undefined;
                 prefix?: string | undefined;
                 concurrency?: number | undefined;
+                mdx?: boolean | undefined;
                 properties?: {
                     description?: string | undefined;
                     order?: string | undefined;
@@ -2295,6 +2309,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 pollInterval?: number | undefined;
                 prefix?: string | undefined;
                 concurrency?: number | undefined;
+                mdx?: boolean | undefined;
                 properties?: {
                     description?: string | undefined;
                     order?: string | undefined;
@@ -2471,6 +2486,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 pollInterval?: number | undefined;
                 prefix?: string | undefined;
                 concurrency?: number | undefined;
+                mdx?: boolean | undefined;
                 properties?: {
                     description?: string | undefined;
                     order?: string | undefined;
@@ -2854,11 +2870,11 @@ export declare const blumeConfigSchema: z.ZodObject<{
     }, z.core.$strict>>;
     narration: z.ZodPrefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
-        provider: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodOptional<z.ZodPipe<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"gateway">;
             options: z.ZodObject<{
-                instructions: z.ZodOptional<z.ZodString>;
                 model: z.ZodDefault<z.ZodString>;
+                instructions: z.ZodOptional<z.ZodString>;
                 voice: z.ZodDefault<z.ZodString>;
                 apiKeyEnv: z.ZodDefault<z.ZodString>;
                 headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -2866,7 +2882,70 @@ export declare const blumeConfigSchema: z.ZodObject<{
             }, z.core.$strict>;
             requiredSecrets: z.ZodArray<z.ZodString>;
             runtimeDeps: z.ZodArray<z.ZodString>;
-        }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"openai">;
+            options: z.ZodObject<{
+                apiKeyEnv: z.ZodOptional<z.ZodString>;
+                baseUrl: z.ZodOptional<z.ZodURL>;
+                model: z.ZodString;
+                instructions: z.ZodOptional<z.ZodString>;
+                voice: z.ZodDefault<z.ZodString>;
+                headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
+            }, z.core.$strict>;
+            requiredSecrets: z.ZodArray<z.ZodString>;
+            runtimeDeps: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>], "kind">, z.ZodTransform<{
+            kind: "gateway";
+            options: {
+                model: string;
+                voice: string;
+                apiKeyEnv: string;
+                instructions?: string | undefined;
+                headers?: Record<string, string> | undefined;
+                providerOptions?: Record<string, Record<string, z.core.util.JSONType>> | undefined;
+            };
+            requiredSecrets: string[];
+            runtimeDeps: string[];
+        } | {
+            options: {
+                model: string;
+                voice: string;
+                apiKeyEnv?: string | undefined;
+                baseUrl?: string | undefined;
+                instructions?: string | undefined;
+                headers?: Record<string, string> | undefined;
+                providerOptions?: Record<string, Record<string, z.core.util.JSONType>> | undefined;
+            };
+            requiredSecrets: string[];
+            runtimeDeps: string[];
+            kind: "openai";
+        }, {
+            kind: "gateway";
+            options: {
+                model: string;
+                voice: string;
+                apiKeyEnv: string;
+                instructions?: string | undefined;
+                headers?: Record<string, string> | undefined;
+                providerOptions?: Record<string, Record<string, z.core.util.JSONType>> | undefined;
+            };
+            requiredSecrets: string[];
+            runtimeDeps: string[];
+        } | {
+            kind: "openai";
+            options: {
+                model: string;
+                voice: string;
+                apiKeyEnv?: string | undefined;
+                baseUrl?: string | undefined;
+                instructions?: string | undefined;
+                headers?: Record<string, string> | undefined;
+                providerOptions?: Record<string, Record<string, z.core.util.JSONType>> | undefined;
+            };
+            requiredSecrets: string[];
+            runtimeDeps: string[];
+        }>>>;
     }, z.core.$strict>]>, z.ZodTransform<{
         enabled: boolean;
         provider: {
@@ -2881,6 +2960,19 @@ export declare const blumeConfigSchema: z.ZodObject<{
             };
             requiredSecrets: string[];
             runtimeDeps: string[];
+        } | {
+            options: {
+                model: string;
+                voice: string;
+                apiKeyEnv?: string | undefined;
+                baseUrl?: string | undefined;
+                instructions?: string | undefined;
+                headers?: Record<string, string> | undefined;
+                providerOptions?: Record<string, Record<string, z.core.util.JSONType>> | undefined;
+            };
+            requiredSecrets: string[];
+            runtimeDeps: string[];
+            kind: "openai";
         } | null;
     }, boolean | {
         enabled: boolean;
@@ -2896,6 +2988,19 @@ export declare const blumeConfigSchema: z.ZodObject<{
             };
             requiredSecrets: string[];
             runtimeDeps: string[];
+        } | {
+            options: {
+                model: string;
+                voice: string;
+                apiKeyEnv?: string | undefined;
+                baseUrl?: string | undefined;
+                instructions?: string | undefined;
+                headers?: Record<string, string> | undefined;
+                providerOptions?: Record<string, Record<string, z.core.util.JSONType>> | undefined;
+            };
+            requiredSecrets: string[];
+            runtimeDeps: string[];
+            kind: "openai";
         } | undefined;
     }>>>;
     navigation: z.ZodPrefault<z.ZodObject<{
@@ -2957,6 +3062,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
             path: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
         }, z.core.$strict>>>;
     }, z.core.$strict>>;
+    poweredBy: z.ZodDefault<z.ZodBoolean>;
     rateLimit: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"cloudflare">;
         options: z.ZodObject<{

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

@@ -45,6 +45,13 @@ export declare const codeSpan: (code: string) => string;
 export declare const guardBlockStart: (text: string) => string;
 /** A block's inline content as Markdown. */
 export declare const renderInline: (parts: InlinePart[]) => string;
+/**
+ * A block's inline content as MDX source, for a source whose site author
+ * opted in to reading its text that way: marks still become delimiters and
+ * code stays a code span, but the text goes in as typed, so a component, an
+ * expression, or Markdown written in the CMS renders.
+ */
+export declare const renderInlineMdx: (parts: InlinePart[]) => string;
 /** A link or image destination as Markdown carries it verbatim. */
 export declare const destination: (url: string) => string;
 /**
@@ -54,9 +61,10 @@ export declare const destination: (url: string) => string;
  * `data:`) never becomes a clickable link on the docs site (see
  * `safe-links.ts`). The parts stay parts then, so their runs merge with their
  * neighbors'. A label escapes a bare URL too: GFM autolinks nothing inside a
- * link, so its specials would read as syntax.
+ * link, so its specials would read as syntax — unless `mdx` reads the label
+ * as MDX source, like {@link renderInlineMdx}.
  */
-export declare const linkParts: (parts: InlinePart[], href?: string) => InlinePart[];
+export declare const linkParts: (parts: InlinePart[], href?: string, mdx?: boolean) => InlinePart[];
 /** The ATX prefix for a heading level, clamped to Markdown's six. */
 export declare const headingPrefix: (level: number) => string;
 /** Quote every line of a block. */

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

@@ -115,6 +115,14 @@ export interface NotionSourceOptions {
      * Status/select property are always imported as published.
      */
     publishedValue?: string;
+    /**
+     * Read the text of text blocks (paragraphs, headings, list items, quotes,
+     * callouts) as MDX source, so a component, expression, or Markdown typed in
+     * Notion renders instead of showing as written. MDX runs code at build
+     * time, so this hands everyone who can edit the database the site's build:
+     * set it only when you trust them with that. Default false.
+     */
+    mdx?: boolean;
     /** Opt-in dev polling interval (seconds); omit to freeze for the session. */
     pollInterval?: number;
     /** Injected for tests; otherwise built from `@notionhq/client`. */

package/dist/types/deploy/cloudflare-negotiation.d.ts

@@ -40,8 +40,9 @@
  * Cloudflare does not apply `_headers` to worker-first routes, so the wrapper
  * also re-stamps what the static layer would otherwise add on the routes it
  * takes over: the homepage agent-discovery `Link` header, the Markdown
- * `charset=utf-8`, and the sandbox on the SVGs a content source downloaded
- * (see `deploy/headers.ts`). The raw `.md`/`.mdx` URLs are
+ * `charset=utf-8`, the sandbox on the SVGs a content source downloaded (see
+ * `deploy/headers.ts`), and `X-Powered-By` unless `poweredBy` is `false`. The
+ * raw `.md`/`.mdx` URLs are
  * exempted from worker-first routing with negative rules, keeping their
  * `_headers` treatment and their zero-Worker serving path.
  *
@@ -133,6 +134,8 @@ export interface NegotiationWorkerOptions {
     base?: string;
     /** Homepage agent-discovery `Link` header (see `ai/link-headers.ts`). */
     homeLinkHeader?: string | null;
+    /** Whether responses identify Blume with `X-Powered-By`. Defaults to `true`. */
+    poweredBy?: boolean;
     /** Estimated token count of the homepage Markdown mirror. */
     homeTokens?: number;
     /** Configured redirects the wrapper answers with their exact status. */

package/dist/types/deploy/node-headers.d.ts

@@ -54,6 +54,8 @@ export declare const nodePatternRedirects: (project: BlumeProject) => CompiledRe
 export interface NodeEntryOptions {
     /** `deployment.base`, normalized (`""` at the root). */
     base?: string;
+    /** Whether responses identify Blume with `X-Powered-By`. Defaults to `true`. */
+    poweredBy?: boolean;
     /** The configured redirects, from {@link nodeRedirects}. */
     redirects?: NodeRedirects;
     /** The configured pattern redirects, from {@link nodePatternRedirects}. */
@@ -63,7 +65,12 @@ export interface NodeEntryOptions {
  * The entry that replaces Astro's: it answers a configured redirect with its
  * exact status, and otherwise stamps the rules' headers on the response and
  * hands the request to Astro's handler. `send` leaves a Content-Type that is
- * already set alone, so the registered media type wins.
+ * already set alone, so the registered media type wins. Unless `poweredBy` is
+ * `false`, every answer also names Blume in `X-Powered-By` — the redirects,
+ * and the prerendered pages and files the static handler serves, which
+ * Blume's runtime middleware never sees. A middleware-mode entry leaves that
+ * header to the middleware: Astro hands a request it has no route for back to
+ * the host app through `next()`, and that response is the host's own.
  *
  * A rule matches the file the static handler will serve, not the raw URL:
  * Astro strips the base when it leads the path and serves the rest from the
@@ -81,8 +88,9 @@ export interface NodeEntryOptions {
  */
 export declare const nodeEntryWrapper: (rules: readonly NodeHeaderRule[], options?: NodeEntryOptions) => string;
 /**
- * Put the wrapper in front of a Node server build's entry. A build with no
- * rule (no API catalog, AI catalog, MCP server, signatures directory, or
- * downloaded content assets) and no redirect leaves Astro's entry alone.
+ * Put the wrapper in front of a Node server build's entry. A build with
+ * `poweredBy` off, no rule (no API catalog, AI catalog, MCP server,
+ * signatures directory, or downloaded content assets), and no redirect leaves
+ * Astro's entry alone.
  */
 export declare const wrapNodeEntry: (project: BlumeProject, log: BuildLog) => Promise<void>;

package/dist/types/deploy/platforms/vercel.d.ts

@@ -50,8 +50,8 @@ export declare const rebaseVercelRoutes: (project: BlumeProject, log: BuildLog)
  * hidden runtime silently drops the function's chunks and `node_modules`.
  * Static assets are served from the tree's `static/` half, so the deploy
  * artifacts are written there; headers (the discovery files', the sandbox on
- * downloaded SVGs) arrive through the routing config rather than a
- * `_headers` file, which Vercel never reads. The adapter ignores
+ * downloaded SVGs, `X-Powered-By`) arrive through the routing config rather
+ * than a `_headers` file, which Vercel never reads. The adapter ignores
  * `deployment.base`, so under one the build moves the static files and the
  * routes beneath it.
  */

package/dist/types/deploy/vercel-negotiation.d.ts

@@ -106,14 +106,16 @@ export declare const buildNegotiationRoutes: (routePaths: readonly string[], hom
  * phase right before the adapter's `/404.html` fallback — and nowhere when
  * that fallback is absent, since a `dest` with no file behind it would serve
  * nothing. With `svgAssets`, a main-phase route also sandboxes the SVGs a
- * content source downloaded (see {@link svgAssetRoute}). Under a `base`, every
+ * content source downloaded (see {@link svgAssetRoute}). With `poweredBy`, a
+ * route at the head of the config, ahead of the adapter's redirects, names
+ * Blume on every response (see {@link poweredByRoute}). Under a `base`, every
  * route matches and names paths beneath it, and the fallback anchor is the
  * one {@link rebaseAdapterRoutes} moved there. Returns the updated JSON
  * text (tab-indented, like the adapter's own output), or `null` when there is
  * nowhere safe to splice: an unparsable config, no `routes` array, or no
  * `handle: "filesystem"` marker to anchor the splice.
  */
-export declare const injectNegotiationRoutes: (configText: string, routePaths: readonly string[], homeLinkHeader?: string | null, contentTypeOverrides?: Record<string, string>, homeTokens?: number, notFound?: NotFoundVariants, corsPaths?: readonly string[], svgAssets?: boolean, base?: string) => string | null;
+export declare const injectNegotiationRoutes: (configText: string, routePaths: readonly string[], homeLinkHeader?: string | null, contentTypeOverrides?: Record<string, string>, homeTokens?: number, notFound?: NotFoundVariants, corsPaths?: readonly string[], svgAssets?: boolean, base?: string, poweredBy?: boolean) => string | null;
 /**
  * Splice routes for the pattern redirects (see `vercelPatternRoutes`) into a
  * Build Output `config.json`, in the main phase just ahead of

package/dist/types/narration/build.d.ts

@@ -2,17 +2,18 @@ import { HTMLElement } from "node-html-parser";
 import type { Node } from "node-html-parser";
 import type { BlumeProject } from "../core/project-graph.ts";
 import type { ProjectContext } from "../core/types.ts";
-import type { NarrationProvider } from "./provider.ts";
+import type { GatewayNarrationProvider, NarrationProvider, OpenAINarrationProvider } from "./provider.ts";
 import type { NarrationCues, NarrationTree } from "./script.ts";
 /**
  * Generated narration: after Astro writes the HTML, read every page that
  * carries the player exactly as the browser will (same walker, same blocks),
  * split it into sentences, and give each sentence a clip from the configured
  * speech model. Clips are cached by what decides their sound (text, language,
- * model, voice, instructions, provider options), so a rebuild only pays for
- * sentences that changed, and one sentence shared by many pages is generated
- * once. Each page gets a manifest listing its clips; the player plays them in
- * order and falls back to browser voices wherever a manifest is missing.
+ * model, voice, instructions, provider options, endpoint), so a rebuild only
+ * pays for sentences that changed, and one sentence shared by many pages is
+ * generated once. Each page gets a manifest listing its clips; the player
+ * plays them in order and falls back to browser voices wherever a manifest is
+ * missing.
  */
 /** How the build logs: the integration's Astro logger. */
 export interface NarrationLogger {
@@ -23,7 +24,10 @@ export interface NarrationLogger {
 export type Speak = (text: string, lang: string) => Promise<Uint8Array>;
 /** What a narration build did, for the log line and tests. */
 export interface NarrationBuildResult {
-    /** Clips that failed to generate; their pages get no manifest. */
+    /**
+     * Clips that failed to generate, or that a missing key left ungenerated;
+     * their pages get no manifest.
+     */
     failed: number;
     /** Clips generated by the speech model on this build. */
     generated: number;
@@ -55,16 +59,34 @@ export declare const readPlayerPage: (html: string) => PlayerPage | null;
 /**
  * A clip's cache key: a digest of everything that decides how it sounds. The
  * Blume version is deliberately left out, unlike the OG card's: an upgrade
- * shouldn't pay to regenerate audio that would sound the same.
+ * shouldn't pay to regenerate audio that would sound the same. A build
+ * resolves `endpoint` once and passes it in, rather than reading the
+ * environment for every sentence.
  */
-export declare const clipKey: (provider: NarrationProvider, lang: string, text: string) => string;
+export declare const clipKey: (provider: NarrationProvider, lang: string, text: string, endpoint?: string | undefined) => string;
 /** Speak through the Vercel AI Gateway with the provider's model and voice. */
-export declare const gatewaySpeaker: (provider: NarrationProvider) => Speak;
+export declare const gatewaySpeaker: (provider: GatewayNarrationProvider) => Speak;
+/**
+ * Speak through OpenAI's speech API, or with `baseUrl` through any server
+ * that serves it (`POST /audio/speech`): Kokoro-FastAPI, Speaches, LiteLLM.
+ * That API takes no language, so none is sent and the model or voice
+ * decides it. Without a key, no bearer token is sent (an `Authorization` in
+ * `headers` still is). A build resolves `baseURL` once and passes it in.
+ */
+export declare const openaiSpeaker: (provider: OpenAINarrationProvider, baseURL?: string) => Speak;
+/**
+ * The env var a build needs to generate with `provider` and doesn't have, or
+ * `null` when it can go ahead: the key is set, Vercel's OIDC token stands in
+ * for the gateway's, or the provider names no key (`openai()` with a
+ * `baseUrl` and no `apiKeyEnv`).
+ */
+export declare const missingKey: (provider: NarrationProvider) => string | null;
 /**
  * Generate the narration for a built site in `distDir`: a clip per sentence
- * and a manifest per page. Does nothing unless `narration.provider` is set,
- * and warns instead of generating when the provider's key is missing (the
- * pages then read with browser voices). `speak` replaces the gateway call.
+ * and a manifest per page. Does nothing unless `narration.provider` is set.
+ * When new clips are needed and the provider's key is missing, it warns and
+ * generates nothing, so only pages whose clips are all cached get audio (the
+ * rest read with browser voices). `speak` replaces the provider call.
  */
 export declare const buildNarration: (project: BlumeProject, distDir: string, logger: NarrationLogger, speak?: Speak) => Promise<NarrationBuildResult | null>;
 export {};

package/dist/types/narration/provider.d.ts

@@ -1,19 +1,36 @@
 import { z } from "zod";
 /** The speech model narration uses when `gateway()` names none. */
 export declare const DEFAULT_NARRATION_MODEL = "openai/tts-1-hd";
-/** The voice narration uses when `gateway()` names none. */
+/** The voice narration uses when the provider names none. */
 export declare const DEFAULT_NARRATION_VOICE = "alloy";
 /**
- * `narration.provider`: the `gateway()` descriptor from `blume/ai`, read with
- * speech defaults. `reasoning` is an assistant option and is rejected here;
- * `voice` and `instructions` are narration options and are rejected by the
- * assistant.
+ * The AI SDK provider `openai()` narration speaks through, with or without a
+ * `baseUrl`: `@ai-sdk/openai-compatible` has no speech models.
  */
-export declare const narrationProviderSchema: z.ZodObject<{
+export declare const OPENAI_SPEECH_DEP = "@ai-sdk/openai";
+/**
+ * Whether `url` carries a username or password, which `fetch` refuses to
+ * send and whose error message would print them. A URL that doesn't parse
+ * has none.
+ */
+export declare const hasCredentials: (url: string) => boolean;
+/**
+ * `narration.provider`: the `gateway()` or `openai()` descriptor from
+ * `blume/ai`, read with speech defaults. `reasoning` (and `openai()`'s
+ * `name`, which speech models don't read) are assistant options and are
+ * rejected here; `voice` and `instructions` are narration options and are
+ * rejected by the assistant.
+ *
+ * `openai()` is read for what narration needs, not what the assistant does:
+ * it speaks through `@ai-sdk/openai` whatever the `baseUrl`, and a custom
+ * endpoint gets only the key `apiKeyEnv` names, never `OPENAI_API_KEY` by
+ * default, so it may take none at all. A key that is named is required.
+ */
+export declare const narrationProviderSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"gateway">;
     options: z.ZodObject<{
-        instructions: z.ZodOptional<z.ZodString>;
         model: z.ZodDefault<z.ZodString>;
+        instructions: z.ZodOptional<z.ZodString>;
         voice: z.ZodDefault<z.ZodString>;
         apiKeyEnv: z.ZodDefault<z.ZodString>;
         headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -21,6 +38,77 @@ export declare const narrationProviderSchema: z.ZodObject<{
     }, z.core.$strict>;
     requiredSecrets: z.ZodArray<z.ZodString>;
     runtimeDeps: z.ZodArray<z.ZodString>;
-}, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"openai">;
+    options: z.ZodObject<{
+        apiKeyEnv: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodURL>;
+        model: z.ZodString;
+        instructions: z.ZodOptional<z.ZodString>;
+        voice: z.ZodDefault<z.ZodString>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
+    }, z.core.$strict>;
+    requiredSecrets: z.ZodArray<z.ZodString>;
+    runtimeDeps: z.ZodArray<z.ZodString>;
+}, z.core.$strict>], "kind">, z.ZodTransform<{
+    kind: "gateway";
+    options: {
+        model: string;
+        voice: string;
+        apiKeyEnv: string;
+        instructions?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        providerOptions?: Record<string, Record<string, z.core.util.JSONType>> | undefined;
+    };
+    requiredSecrets: string[];
+    runtimeDeps: string[];
+} | {
+    options: {
+        model: string;
+        voice: string;
+        apiKeyEnv?: string | undefined;
+        baseUrl?: string | undefined;
+        instructions?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        providerOptions?: Record<string, Record<string, z.core.util.JSONType>> | undefined;
+    };
+    requiredSecrets: string[];
+    runtimeDeps: string[];
+    kind: "openai";
+}, {
+    kind: "gateway";
+    options: {
+        model: string;
+        voice: string;
+        apiKeyEnv: string;
+        instructions?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        providerOptions?: Record<string, Record<string, z.core.util.JSONType>> | undefined;
+    };
+    requiredSecrets: string[];
+    runtimeDeps: string[];
+} | {
+    kind: "openai";
+    options: {
+        model: string;
+        voice: string;
+        apiKeyEnv?: string | undefined;
+        baseUrl?: string | undefined;
+        instructions?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        providerOptions?: Record<string, Record<string, z.core.util.JSONType>> | undefined;
+    };
+    requiredSecrets: string[];
+    runtimeDeps: string[];
+}>>;
 /** A validated narration provider, defaults filled in. */
 export type NarrationProvider = z.output<typeof narrationProviderSchema>;
+/** A validated `gateway()` narration provider. */
+export type GatewayNarrationProvider = Extract<NarrationProvider, {
+    kind: "gateway";
+}>;
+/** A validated `openai()` narration provider. */
+export type OpenAINarrationProvider = Extract<NarrationProvider, {
+    kind: "openai";
+}>;

package/dist/types/openapi/sentence.d.ts

@@ -1,7 +1,17 @@
+/** Whether `text` ends in a colon that leads in to what follows it. */
+export declare const endsInLeadIn: (text: string) => boolean;
+/**
+ * Close prose with a period unless it already ends a sentence. A colon at the
+ * end is kept and gains the period: use this when the caller has already told
+ * a lead-in apart from a literal (`tenant:` in inline code). Empty text stays
+ * empty.
+ */
+export declare const closeSentence: (text: string) => string;
 /**
  * Close a fragment of spec prose as a sentence. OpenAPI `summary` values are
  * usually title-like ("Get a flag", no period), so prose that runs straight
  * into the next generated sentence ("Get a flag Reference for …") needs one.
- * Empty text stays empty.
+ * A lead-in colon becomes the period rather than gaining one after it, and
+ * prose that already ended before it ("e.g.:") keeps its own mark.
  */
 export declare const asSentence: (text: string) => string;

package/dist/types/seo/jsonld.d.ts

@@ -11,7 +11,7 @@ export interface PostalAddressIdentity {
 }
 /**
  * `seo.organization`: the organization behind the site, emitted on every page
- * as an `Organization` node the WebSite and article nodes cite as publisher.
+ * as an `Organization` node the WebSite and page nodes cite as publisher.
  */
 export interface OrganizationIdentity {
     address?: PostalAddressIdentity;
@@ -62,6 +62,12 @@ export interface StructuredDataInput {
     description?: string;
     /** Page route, e.g. `/blog/post`. */
     route: string;
+    /**
+     * The route of this page's homepage: the navigation tree root
+     * (`navigation.root` — `/fr` for a locale, `/docs` under a `basePath`,
+     * `/v1.0` in an archived version). Defaults to `/`.
+     */
+    homeRoute?: string;
     /** Deployment base (`import.meta.env.BASE_URL`); prefixed onto absolute URLs. */
     base?: string;
     /** Content type — `blog` and `changelog` map to richer article types. */
@@ -96,10 +102,9 @@ export declare const toIso: (value: DateInput | undefined) => string | undefined
 /**
  * Build a schema.org JSON-LD `@graph` for a page: site identity (the WebSite,
  * plus the configured Organization everywhere and the SoftwareApplication on
- * the homepage), the page as an article, and its breadcrumb trail. Returns
- * null when there is nothing useful to emit (e.g. the homepage without a
- * configured site). URLs are absolute when `siteUrl` is set, otherwise
- * route-relative.
+ * the homepage), the page itself (a WebPage on the homepage, an article
+ * elsewhere), and an article's breadcrumb trail. URLs are absolute when
+ * `siteUrl` is set, otherwise route-relative.
  */
-export declare const buildStructuredData: (input: StructuredDataInput) => JsonLdNode | null;
+export declare const buildStructuredData: (input: StructuredDataInput) => JsonLdNode;
 export {};

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

@@ -7,6 +7,12 @@ export interface NotionOptions extends SharedSourceOptions {
     concurrency?: number;
     /** Notion database id. */
     database: string;
+    /**
+     * Read text typed in Notion as MDX, so components and Markdown in it
+     * render. Anyone who can edit the database can then run code at build
+     * time. Default false: text renders as written.
+     */
+    mdx?: boolean;
     /** Notion property names mapped onto Blume meta. */
     properties?: {
         /** Property holding the page description. */
@@ -28,6 +34,7 @@ export declare const notionOptionsSchema: z.ZodObject<{
     prefix: z.ZodOptional<z.ZodString>;
     concurrency: z.ZodOptional<z.ZodNumber>;
     database: z.ZodString;
+    mdx: z.ZodOptional<z.ZodBoolean>;
     properties: z.ZodOptional<z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         order: z.ZodOptional<z.ZodString>;
@@ -45,6 +52,7 @@ export declare const notionAdapterSchema: z.ZodObject<{
         prefix: z.ZodOptional<z.ZodString>;
         concurrency: z.ZodOptional<z.ZodNumber>;
         database: z.ZodString;
+        mdx: z.ZodOptional<z.ZodBoolean>;
         properties: z.ZodOptional<z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
             order: z.ZodOptional<z.ZodString>;