blume 0.6.6 → 0.7.0

package/dist/types/core/base-path.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The site-wide `basePath` — a mount point that prepends a segment to every
+ * generated route (`/docs/getting-started`) while staying invisible to the
+ * navigation tree (see `core/navigation.ts`, which builds groups from a page's
+ * base-less `navPath` and takes URLs from its based `route`). This is distinct
+ * from a per-source `prefix` (a namespace that *does* create a sidebar group)
+ * and from `deployment.base` (Astro's host-subdirectory base); the two compose,
+ * stacking as `{deployment.base}/{basePath}/page`.
+ *
+ * These helpers run server-side (config, route construction, the link checker,
+ * redirects, the markdown link plugin). The client-side counterpart lives in
+ * `components/islands/base-path.ts` and serves `deployment.base` via `BASE_URL`.
+ */
+/**
+ * Canonicalize a configured base path to either `""` (none) or `/seg[/seg…]`
+ * (leading slash, no trailing slash, collapsed inner slashes). A blank value or
+ * bare `/` normalizes to `""`, so an unset/`"/"` base is a clean no-op.
+ */
+export declare const normalizeBasePath: (input?: string) => string;
+/**
+ * Whether a link target is a root-relative internal path (`/x`) — the only
+ * shape a base path applies to. Protocol-relative (`//host`), absolute URLs,
+ * other schemes (`mailto:`), fragments (`#x`), and relative paths are excluded.
+ */
+export declare const isInternalPath: (target: string) => boolean;
+/**
+ * Idempotently prepend `basePath` to a root-relative route. A route already
+ * equal to or nested under the base is returned unchanged, so authors who write
+ * the base by hand (`/docs/x`) aren't double-prefixed to `/docs/docs/x`.
+ */
+export declare const withBasePath: (basePath: string, route: string) => string;
+/**
+ * Remove `basePath` from the front of a route (`/docs/guide` -> `/guide`,
+ * `/docs` -> `/`). A route not under the base is returned unchanged. Inverse of
+ * {@link withBasePath}; used to resolve public assets, which live at the site
+ * root regardless of the base.
+ */
+export declare const stripBasePath: (basePath: string, route: string) => string;

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

@@ -264,11 +264,15 @@ export interface NavSelectorItem {
  * A header dropdown for switching context — versions, languages, products, or a
  * generic dropdown. `kind` drives the icon and a11y labeling.
  */
+/** Context-partition selector kinds (a versioned/localized/multi-product site). */
+type NavSelectorContextKind = "product" | "version";
+/** What a header selector switches between. */
+type NavSelectorKind = "dropdown" | "language" | NavSelectorContextKind;
 export interface NavSelector {
     /** The options shown in the dropdown. */
     items?: NavSelectorItem[];
     /** What the selector switches between. */
-    kind: "dropdown" | "language" | "product" | "version";
+    kind: NavSelectorKind;
     /** Selector label / current value. */
     label: string;
 }
@@ -323,6 +327,10 @@ export interface FontsConfig {
     mono?: LiteralUnion<FontSlug>;
 }
 /** Colors, fonts, radius, and color-mode behavior. */
+/** Corner radius scale (`none`/`sm` tighter, `md`/`lg` rounder). */
+type RadiusScaleTight = "none" | "sm";
+type RadiusScaleRound = "md" | "lg";
+type RadiusScale = RadiusScaleTight | RadiusScaleRound;
 export interface ThemeConfig {
     /**
      * Accent color. A palette name (`blue`, `violet`, `green`, …) or any CSS
@@ -346,7 +354,7 @@ export interface ThemeConfig {
     /** Initial color mode. Defaults to `system`. */
     mode?: "system" | "light" | "dark";
     /** Corner radius scale. Defaults to `md`. */
-    radius?: "none" | "sm" | "md" | "lg";
+    radius?: RadiusScale;
 }
 /** Public credentials for the Algolia backend (the sync key stays an env var). */
 export interface AlgoliaSearch {
@@ -403,6 +411,9 @@ export interface AskSuggestion {
     label: string;
 }
 /** The Ask AI chat assistant. */
+/** Backends that can route an Ask AI request. */
+type AskProviderGateway = "gateway" | "openrouter" | "llmgateway";
+type AskProvider = AskProviderGateway | "inkeep" | "openai-compatible";
 export interface AskConfig {
     /**
      * Name of the env var holding the provider API key. Each provider has a
@@ -419,7 +430,7 @@ export interface AskConfig {
     /** Model id to use. Defaults to `openai/gpt-5.5`. */
     model?: string;
     /** Which backend routes the request. Defaults to `gateway`. */
-    provider?: "gateway" | "openrouter" | "llmgateway" | "inkeep" | "openai-compatible";
+    provider?: AskProvider;
     /** Starter prompts shown before the first question. */
     suggestions?: AskSuggestion[];
 }
@@ -501,9 +512,12 @@ export interface I18nConfig {
  * Where and how the site deploys. `site` (and `adapter`) are auto-detected from
  * the platform env on Vercel, Netlify, and Cloudflare.
  */
+/** Astro server-output adapters, by hosting platform. */
+type CloudDeploymentAdapter = "netlify" | "cloudflare";
+type DeploymentAdapter = "vercel" | "node" | CloudDeploymentAdapter;
 export interface DeploymentConfig {
     /** Astro adapter for server output. `null` (default) keeps a static build. */
-    adapter?: "vercel" | "node" | "netlify" | "cloudflare" | null;
+    adapter?: DeploymentAdapter | null;
     /** Base path when the site is served from a subdirectory. */
     base?: string;
     /** Build output mode. Defaults to `static`. */
@@ -514,12 +528,16 @@ export interface DeploymentConfig {
      */
     site?: string;
 }
+/** HTTP redirect status codes: permanent (301/308) and temporary (302/307). */
+type RedirectStatusPermanent = 301 | 308;
+type RedirectStatusTemporary = 302 | 307;
+type RedirectStatus = RedirectStatusPermanent | RedirectStatusTemporary;
 /** A URL redirect rule. */
 export interface RedirectConfig {
     /** Path to redirect from. */
     from: string;
     /** HTTP status. Defaults to `301`. */
-    status?: 301 | 302 | 307 | 308;
+    status?: RedirectStatus;
     /** Path or URL to redirect to. */
     to: string;
 }
@@ -594,7 +612,10 @@ export interface CodeConfig {
 export interface MarkdownConfig {
     /** Code-block rendering: language icons, line wrap. */
     code?: CodeConfig;
-    /** Syntax-highlighting themes for fenced code blocks. */
+    /**
+     * Syntax-highlighting themes for every code surface — fenced blocks, inline
+     * `` `code`{:lang} ``, `<CodeBlock>`, and `<Diff>`.
+     */
     codeBlocks?: {
         /** Shiki theme names per color mode. */
         theme?: {
@@ -612,6 +633,15 @@ export interface MarkdownConfig {
     /** Make content images click-to-zoom (lightbox). Defaults to `true`. */
     imageZoom?: boolean;
 }
+/** React island behavior. */
+export interface ReactConfig {
+    /**
+     * Auto-memoize React components/hooks with the React Compiler
+     * (`babel-plugin-react-compiler`). On by default whenever React is enabled;
+     * set to `false` to skip the compiler's babel pass. Defaults to `true`.
+     */
+    compiler?: boolean;
+}
 /**
  * OpenAPI reference. By default (`renderer: "blume"`) Blume renders its own UI:
  * one real page per operation, grouped by tag in the sidebar and included in
@@ -653,6 +683,24 @@ export interface AsyncApiConfig {
     /** Scalar theme name. */
     theme?: string;
 }
+/** `<Component />` example previews (the object form of `examples`). */
+export interface ExamplesConfig {
+    /**
+     * A stylesheet, relative to the project root, injected into every preview
+     * frame after Blume's default tokens. Previews render inside an isolated
+     * iframe the docs styles never reach, so design tokens for the previewed
+     * components — shadcn variables, `@theme` mappings, custom fonts — live
+     * here. Tailwind is already provided in the frame; the file should hold
+     * tokens and styles, not another `@import "tailwindcss"`.
+     */
+    css?: string;
+    /**
+     * Where example files live, relative to the project root. Defaults to
+     * `examples`; may be a glob to target a registry that colocates component
+     * sources with their examples (e.g. `registry/<pkg>/**\/examples/*`).
+     */
+    source?: string;
+}
 /**
  * Reader-facing "Export" page actions. A boolean toggles both formats; the
  * object form enables each individually. Defaults to `false`.
@@ -696,6 +744,16 @@ export interface BlumeConfig {
     asyncapi?: AsyncApiConfig;
     /** Site-wide announcement banner shown above the header. */
     banner?: BannerConfig;
+    /**
+     * Site-wide mount point prepended to every generated route (e.g. `/docs`) —
+     * pages, links, redirects, sitemap, OG images, `llms.txt`, and the search
+     * index — while staying invisible to the sidebar/nav tree (no wrapper group).
+     * Distinct from a per-source `prefix` (which namespaces one source *and*
+     * creates a group) and from `deployment.base` (Astro's host-subdirectory
+     * base, for serving the whole site — root included — from a subpath). The two
+     * compose: with both set, a page lands at `{deployment.base}/{basePath}/page`.
+     */
+    basePath?: string;
     /** Where content lives and how it's discovered. */
     content?: ContentConfig;
     /** Where and how the site deploys (site URL, adapter, output mode). */
@@ -703,11 +761,15 @@ export interface BlumeConfig {
     /** Default meta description, used where a page sets none. */
     description?: string;
     /**
-     * Where `<Component path>` resolves live previews and their source from,
-     * relative to the project root. Defaults to `examples`. May be a glob to
-     * target a registry that colocates component sources with their examples.
+     * `<Component path>` example previews. A string is shorthand for
+     * `{ source }`: where examples live, relative to the project root (defaults
+     * to `examples`; may be a glob to target a registry that colocates
+     * component sources with their examples). The object form adds `css` — a
+     * stylesheet injected into every preview frame (previews render in an
+     * iframe the docs theme never reaches), for the previewed components'
+     * design tokens, e.g. shadcn variables.
      */
-    examples?: string;
+    examples?: string | ExamplesConfig;
     /** Reader-facing PDF/EPUB export actions. Defaults to `false`. */
     export?: ExportConfig;
     /** Show the per-page "Was this helpful?" widget. Defaults to `true`. */
@@ -728,6 +790,8 @@ export interface BlumeConfig {
     navigation?: NavigationConfig;
     /** Native OpenAPI reference. */
     openapi?: OpenApiConfig;
+    /** React island behavior (compiler auto-memoization). */
+    react?: ReactConfig;
     /** URL redirect rules. */
     redirects?: RedirectConfig[];
     /** Search backend and credentials. */

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

@@ -83,8 +83,9 @@ import type { Diagnostic } from "./types.ts";
  * - `i18n` — opt-in multi-locale: `locales`, `defaultLocale`, `parser`
  *   (`dir` vs filename `dot` suffix), and per-locale UI overrides.
  *
- * - `examples` — where `<Component path>` previews resolve their source from
- *   (defaults to `examples/`; supports a glob for colocated registries).
+ * - `examples` — `<Component path>` previews: `source` (default `examples/`;
+ *   supports a glob for colocated registries) and `css`, a stylesheet injected
+ *   into the isolated preview frames (e.g. shadcn variables).
  *
  * @example Zero-config — just render the Markdown under `docs/`.
  * ```ts

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

@@ -87,6 +87,8 @@ export interface BlumeDataConfig {
         suggestions: NonNullable<ResolvedConfig["ai"]["ask"]>["suggestions"];
     } | null;
     banner: BlumeBanner | null;
+    /** `markdown.codeBlocks.theme`: light/dark Shiki themes for code surfaces. */
+    codeThemes: ResolvedConfig["markdown"]["codeBlocks"]["theme"];
     /** `markdown.code.wrap`: wrap long code lines instead of scrolling. */
     codeWrap: boolean;
     description: string | undefined;

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

@@ -1,5 +1,4 @@
 import { z } from "zod";
-import { UI_PACKS } from "./ui-packs/index.ts";
 /**
  * Translatable UI chrome strings.
  *
@@ -566,7 +565,6 @@ export declare const uiStringsSchema: z.ZodDefault<z.ZodObject<{
 }>>;
 /** A fully-resolved dictionary; every key present. */
 export type UIStrings = z.infer<typeof uiStringsObject>;
-/** The English baseline, derived from the schema defaults. */
 export declare const EN_UI: UIStrings;
 /**
  * A partial override: `{ group: { key: "translation" } }`. Validated loosely
@@ -583,7 +581,7 @@ export declare const uiLocaleOverridesSchema: z.ZodRecord<z.ZodString, z.ZodReco
  * pack so adopters get translated chrome out of the box. Re-exported here so the
  * resolver and existing imports keep a single entry point.
  */
-export { UI_PACKS };
+export { UI_PACKS } from "./ui-packs/index.ts";
 /**
  * Resolve the active dictionary for a locale. Layers, in order:
  * English baseline ← default-locale pack ← default-locale override ←

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

@@ -10,32 +10,32 @@ declare const pageMetaBaseSchema: z.ZodObject<{
         image: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    }, "strip", z.ZodUnknown, z.objectOutputType<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    }, z.ZodUnknown, "strip">, z.objectInputType<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">>]>, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+    }, z.ZodUnknown, "strip">>]>, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    }, "strip", z.ZodUnknown, z.objectOutputType<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    }, z.ZodUnknown, "strip">, z.objectInputType<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">>]>, "many">]>>;
+    }, z.ZodUnknown, "strip">>]>, "many">]>>;
     changelog: z.ZodOptional<z.ZodObject<{
         category: z.ZodOptional<z.ZodString>;
         date: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodDate]>, string, string | Date>>;
@@ -146,12 +146,12 @@ declare const pageMetaBaseSchema: z.ZodObject<{
         image: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough"> | (string | z.objectOutputType<{
+    }, z.ZodUnknown, "strip"> | (string | z.objectOutputType<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">)[] | undefined;
+    }, z.ZodUnknown, "strip">)[] | undefined;
     changelog?: {
         date?: string | undefined;
         category?: string | undefined;
@@ -175,12 +175,12 @@ declare const pageMetaBaseSchema: z.ZodObject<{
         image: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough"> | (string | z.objectInputType<{
+    }, z.ZodUnknown, "strip"> | (string | z.objectInputType<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">)[] | undefined;
+    }, z.ZodUnknown, "strip">)[] | undefined;
     changelog?: {
         date?: string | Date | undefined;
         category?: string | undefined;
@@ -215,32 +215,32 @@ export declare const pageMetaSchema: z.ZodObject<{
         image: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    }, "strip", z.ZodUnknown, z.objectOutputType<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    }, z.ZodUnknown, "strip">, z.objectInputType<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">>]>, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+    }, z.ZodUnknown, "strip">>]>, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    }, "strip", z.ZodUnknown, z.objectOutputType<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    }, z.ZodUnknown, "strip">, z.objectInputType<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">>]>, "many">]>>;
+    }, z.ZodUnknown, "strip">>]>, "many">]>>;
     changelog: z.ZodOptional<z.ZodObject<{
         category: z.ZodOptional<z.ZodString>;
         date: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodDate]>, string, string | Date>>;
@@ -351,12 +351,12 @@ export declare const pageMetaSchema: z.ZodObject<{
         image: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough"> | (string | z.objectOutputType<{
+    }, z.ZodUnknown, "strip"> | (string | z.objectOutputType<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">)[] | undefined;
+    }, z.ZodUnknown, "strip">)[] | undefined;
     changelog?: {
         date?: string | undefined;
         category?: string | undefined;
@@ -380,12 +380,12 @@ export declare const pageMetaSchema: z.ZodObject<{
         image: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough"> | (string | z.objectInputType<{
+    }, z.ZodUnknown, "strip"> | (string | z.objectInputType<{
         avatar: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">)[] | undefined;
+    }, z.ZodUnknown, "strip">)[] | undefined;
     changelog?: {
         date?: string | Date | undefined;
         category?: string | undefined;
@@ -1149,6 +1149,13 @@ export declare const blumeConfigSchema: z.ZodObject<{
             text: string;
         } | undefined;
     }>]>>;
+    /**
+     * Site-wide mount point prepended to every generated route (e.g. `/docs`),
+     * while staying invisible to the sidebar/nav tree. Distinct from a per-source
+     * `prefix` (which creates a group) and from `deployment.base` (Astro's
+     * host-subdirectory base); the two compose. Normalized to `""` or `/seg`.
+     */
+    basePath: z.ZodEffects<z.ZodOptional<z.ZodString>, string, string | undefined>;
     content: z.ZodDefault<z.ZodObject<{
         defaultType: z.ZodDefault<z.ZodString>;
         exclude: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -1544,19 +1551,28 @@ export declare const blumeConfigSchema: z.ZodObject<{
     }>>;
     description: z.ZodOptional<z.ZodString>;
     /**
-     * Where `<Component path>` resolves live previews and their source from,
-     * relative to the project root. Defaults to the `examples` directory; point
-     * it elsewhere when examples live outside a top-level `examples/`.
-     *
-     * May be a glob (anything with `*`/`?`/`[]`/`{}`/`!`), in which case only
-     * matching files are discovered and a `<Component path>` key is relative to
-     * the glob's static prefix. Use this for a registry layout that colocates
-     * component sources with their examples — `registry/<pkg>/**\/examples/*`
-     * targets just the examples, leaving the sources (which have no default
-     * export to wrap) out, so the registry needn't be forked into its own
-     * examples directory.
+     * Where `<Component path>` resolves live previews and their source from.
+     * A string is shorthand for `{ source }` — the directory (or glob, for
+     * colocated registry layouts) under the project root that holds example
+     * files. The object form adds `css`: a stylesheet injected into every
+     * preview frame (design tokens, shadcn variables, `@theme` mappings).
      */
-    examples: z.ZodDefault<z.ZodString>;
+    examples: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        css: z.ZodOptional<z.ZodString>;
+        source: z.ZodDefault<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        source: string;
+        css?: string | undefined;
+    }, {
+        source?: string | undefined;
+        css?: string | undefined;
+    }>]>, {
+        css?: string;
+        source: string;
+    }, string | {
+        source?: string | undefined;
+        css?: string | undefined;
+    }>>;
     export: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
         epub: z.ZodDefault<z.ZodBoolean>;
         pdf: z.ZodDefault<z.ZodBoolean>;
@@ -1846,10 +1862,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 icon?: string | undefined;
                 tag?: string | undefined;
             }[];
-            kind: "version" | "dropdown" | "language" | "product";
+            kind: "version" | "product" | "dropdown" | "language";
         }, {
             label: string;
-            kind: "version" | "dropdown" | "language" | "product";
+            kind: "version" | "product" | "dropdown" | "language";
             items?: {
                 path: string;
                 label: string;
@@ -1946,7 +1962,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 icon?: string | undefined;
                 tag?: string | undefined;
             }[];
-            kind: "version" | "dropdown" | "language" | "product";
+            kind: "version" | "product" | "dropdown" | "language";
         }[];
         tabs?: {
             path: string;
@@ -1973,7 +1989,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
         }[] | undefined;
         selectors?: {
             label: string;
-            kind: "version" | "dropdown" | "language" | "product";
+            kind: "version" | "product" | "dropdown" | "language";
             items?: {
                 path: string;
                 label: string;
@@ -2053,6 +2069,19 @@ export declare const blumeConfigSchema: z.ZodObject<{
         expandSchemas?: boolean | undefined;
         renderer?: "blume" | "scalar" | undefined;
     }>>;
+    react: z.ZodDefault<z.ZodObject<{
+        /**
+         * Auto-memoize React components/hooks with the React Compiler
+         * (`babel-plugin-react-compiler`). On by default whenever React is enabled
+         * (a project `.tsx`/`.jsx`, a React island/example/override, or Ask AI); set
+         * to `false` to skip the compiler's babel pass.
+         */
+        compiler: z.ZodDefault<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        compiler: boolean;
+    }, {
+        compiler?: boolean | undefined;
+    }>>;
     redirects: z.ZodDefault<z.ZodArray<z.ZodObject<{
         from: z.ZodString;
         status: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<301>, z.ZodLiteral<302>, z.ZodLiteral<307>, z.ZodLiteral<308>]>>;
@@ -2380,13 +2409,13 @@ export declare const blumeConfigSchema: z.ZodObject<{
             light?: string | undefined;
         } | undefined>;
         fonts: z.ZodDefault<z.ZodObject<{
-            body: z.ZodDefault<z.ZodEffects<z.ZodString, "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans", string>>;
-            display: z.ZodDefault<z.ZodEffects<z.ZodString, "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans", string>>;
-            mono: z.ZodDefault<z.ZodEffects<z.ZodString, "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans", string>>;
+            body: z.ZodDefault<z.ZodEffects<z.ZodString, string, string>>;
+            display: z.ZodDefault<z.ZodEffects<z.ZodString, string, string>>;
+            mono: z.ZodDefault<z.ZodEffects<z.ZodString, string, string>>;
         }, "strict", z.ZodTypeAny, {
-            mono: "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans";
-            display: "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans";
-            body: "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans";
+            mono: string;
+            display: string;
+            body: string;
         }, {
             mono?: string | undefined;
             display?: string | undefined;
@@ -2401,9 +2430,9 @@ export declare const blumeConfigSchema: z.ZodObject<{
             light: string;
         };
         fonts: {
-            mono: "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans";
-            display: "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans";
-            body: "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans";
+            mono: string;
+            display: string;
+            body: string;
         };
         layout: "sidebar";
         mode: "dark" | "light" | "system";
@@ -2601,9 +2630,9 @@ export declare const blumeConfigSchema: z.ZodObject<{
             light: string;
         };
         fonts: {
-            mono: "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans";
-            display: "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans";
-            body: "dm-sans" | "figtree" | "fira-code" | "geist" | "geist-mono" | "ibm-plex-mono" | "ibm-plex-sans" | "ibm-plex-serif" | "inter" | "inter-tight" | "jetbrains-mono" | "lora" | "manrope" | "merriweather" | "open-sans" | "playfair-display" | "plus-jakarta-sans" | "roboto" | "roboto-mono" | "source-code-pro" | "source-sans-3" | "source-serif-4" | "space-grotesk" | "space-mono" | "work-sans";
+            mono: string;
+            display: string;
+            body: string;
         };
         layout: "sidebar";
         mode: "dark" | "light" | "system";
@@ -2629,13 +2658,17 @@ export declare const blumeConfigSchema: z.ZodObject<{
         spec?: string | undefined;
         theme?: string | undefined;
     };
+    basePath: string;
     deployment: {
         adapter: "vercel" | "node" | "netlify" | "cloudflare" | null;
         output: "static" | "server";
         base?: string | undefined;
         site?: string | undefined;
     };
-    examples: string;
+    examples: {
+        css?: string;
+        source: string;
+    };
     export: {
         epub: boolean;
         pdf: boolean;
@@ -2680,7 +2713,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 icon?: string | undefined;
                 tag?: string | undefined;
             }[];
-            kind: "version" | "dropdown" | "language" | "product";
+            kind: "version" | "product" | "dropdown" | "language";
         }[];
         tabs?: {
             path: string;
@@ -2709,6 +2742,9 @@ export declare const blumeConfigSchema: z.ZodObject<{
         spec?: string | undefined;
         theme?: string | undefined;
     };
+    react: {
+        compiler: boolean;
+    };
     redirects: {
         status: 301 | 302 | 307 | 308;
         from: string;
@@ -2957,6 +2993,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
             text: string;
         } | undefined;
     } | undefined;
+    basePath?: string | undefined;
     github?: {
         owner: string;
         repo: string;
@@ -2969,7 +3006,10 @@ export declare const blumeConfigSchema: z.ZodObject<{
         output?: "static" | "server" | undefined;
         site?: string | undefined;
     } | undefined;
-    examples?: string | undefined;
+    examples?: string | {
+        source?: string | undefined;
+        css?: string | undefined;
+    } | undefined;
     export?: boolean | {
         epub?: boolean | undefined;
         pdf?: boolean | undefined;
@@ -3028,7 +3068,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
         }[] | undefined;
         selectors?: {
             label: string;
-            kind: "version" | "dropdown" | "language" | "product";
+            kind: "version" | "product" | "dropdown" | "language";
             items?: {
                 path: string;
                 label: string;
@@ -3064,6 +3104,9 @@ export declare const blumeConfigSchema: z.ZodObject<{
         expandSchemas?: boolean | undefined;
         renderer?: "blume" | "scalar" | undefined;
     } | undefined;
+    react?: {
+        compiler?: boolean | undefined;
+    } | undefined;
     redirects?: {
         from: string;
         to: string;

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

@@ -108,6 +108,8 @@ export interface NormalizeContext {
         prefix?: string;
         staged: boolean;
     };
+    /** Site-wide route mount point (`""` or `/seg`), prepended to every route. */
+    basePath?: string;
     defaultType: string;
     i18n?: ResolvedI18nConfig;
 }