blume 2.0.0 → 2.0.2

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

@@ -1,5 +1,5 @@
 import type { AstroIntegration } from "astro";
-import type { AskAdapter } from "../ai/ask.ts";
+import type { AssistantAdapter } from "../ai/ask.ts";
 import type { ComponentMarkdown } from "../ai/component-markdown.ts";
 import type { AnalyticsAdapter } from "../analytics/schema.ts";
 import type { DeploymentInput } from "../deploy/adapters/registry.ts";
@@ -420,15 +420,15 @@ export interface SearchOptions {
  * links and `indexing` settings.
  */
 export type SearchConfig = SearchProviderConfig | SearchOptions;
-/** An empty-state prompt shown before the first Ask AI question. */
-export interface AskSuggestion {
+/** An empty-state prompt shown before the first question to the assistant. */
+export interface AssistantSuggestion {
     /** Lucide icon name shown beside the suggestion. */
     icon?: string;
     /** The clickable suggestion text. */
     label: string;
 }
-/** How much retrieved documentation each Ask AI question carries. */
-export interface AskRetrievalConfig {
+/** How much retrieved documentation each question to the assistant carries. */
+export interface AssistantRetrievalConfig {
     /**
      * Total injected documentation characters, across all excerpts. Defaults to
      * `10000`. The single biggest lever on time-to-first-token — the model reads
@@ -448,8 +448,8 @@ export interface AskRetrievalConfig {
      */
     maxResults?: number;
 }
-/** The Ask AI chat assistant. */
-export interface AskConfig {
+/** The chat assistant. */
+export interface AssistantConfig {
     /**
      * Origins allowed to call the generated endpoint from another site — a
      * marketing page that embeds an ask box, for example — or `"*"` to allow
@@ -462,10 +462,10 @@ export interface AskConfig {
      * combined with it.
      */
     cors?: string[];
-    /** Turn Ask AI on. Defaults to `false`. */
+    /** Turn the assistant on. Defaults to `false`. */
     enabled?: boolean;
     /**
-     * Existing Ask AI endpoint to call instead of generating one. This keeps a
+     * Existing assistant endpoint to call instead of generating one. This keeps a
      * Blume site static while an API backend owns retrieval, model access, rate
      * limiting, and streaming. Accepts an absolute URL or root-relative path.
      */
@@ -485,15 +485,15 @@ export interface AskConfig {
      * mapping, and `providerOptions` passthrough. Defaults to
      * `gateway({ model: "openai/gpt-5.5" })`.
      */
-    provider?: AskAdapter;
+    provider?: AssistantAdapter;
     /**
      * How much documentation each question carries into the model's prompt.
      * Lower values cut time-to-first-token — which dominates on a self-hosted
      * backend — at the cost of recall. Defaults keep the built-in behavior.
      */
-    retrieval?: AskRetrievalConfig;
+    retrieval?: AssistantRetrievalConfig;
     /** Starter prompts shown before the first question. */
-    suggestions?: AskSuggestion[];
+    suggestions?: AssistantSuggestion[];
 }
 /** What the AI Catalog (ARD) manifest carries. */
 export interface AiCatalogConfig {
@@ -524,14 +524,14 @@ export interface LlmsTxtConfig {
     /**
      * Markdown placed after the title and summary in `llms.txt`, before the
      * page sections — the llms.txt spec's "details" block. Use it to tell
-     * agents when to reach for the product and how to call it (a "When to use"
-     * heading, the install command, the package name). Blank values are
-     * dropped.
+     * agents when to reach for the product and how to call it (the install
+     * command, the package name). The spec allows any Markdown there but
+     * headings. Blank values are dropped.
      *
      * ```ts
      * agents: {
      *   llmsTxt: {
-     *     details: "## When to use Acme\n\nUse Acme when…",
+     *     details: "Use Acme when…",
      *   },
      * }
      * ```
@@ -557,10 +557,10 @@ export interface McpConfig {
     /** Route the server mounts at. Defaults to `/mcp`. */
     route?: string;
 }
-/** Model-facing features: the Ask AI assistant and the "Open in chat" action. */
+/** Model-facing features: the assistant and the "Open in chat" action. */
 export interface AiConfig {
-    /** The Ask AI chat assistant. */
-    ask?: AskConfig;
+    /** The chat assistant. */
+    assistant?: AssistantConfig;
     /**
      * The "Open in chat" page action, which opens the current page in an AI
      * assistant pre-filled with a prompt pointing at its raw Markdown.
@@ -728,7 +728,7 @@ export type ContentSignalsConfig = boolean | {
 /**
  * The machine-readable surface agents consume: the JSON API, `llms.txt`, the
  * MCP server, published skills, discovery manifests, and the robots.txt usage
- * policy. The reader-facing model features (Ask AI, Open in chat) live under
+ * policy. The reader-facing model features (the assistant, Open in chat) live under
  * `ai`.
  */
 export interface AgentsConfig {
@@ -1184,7 +1184,7 @@ export type TocConfig = boolean | {
 export interface BlumeConfig {
     /** The machine-readable surface for agents: JSON API, `llms.txt`, MCP, skills, discovery. */
     agents?: AgentsConfig;
-    /** Model-facing features: the Ask AI assistant and the "Open in chat" action. */
+    /** Model-facing features: the assistant and the "Open in chat" action. */
     ai?: AiConfig;
     /**
      * Analytics adapters from `blume/analytics`, emitted into `<head>` of every

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

@@ -55,8 +55,8 @@ import type { Diagnostic } from "./types.ts";
  * - `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`.
+ * - `markdown` — `code` (language icons, light/dark Shiki `theme`, line
+ *   `wrap`), `externalLinks`, `headingAnchors`, and `imageZoom`.
  * - `toc` — on-page table of contents; `true`/`false` or a heading-level range.
  * - `lastModified` — "Last updated" stamps from `git` history or frontmatter.
  * - `feedback` — the per-page "Was this helpful?" widget (on by default).
@@ -74,7 +74,7 @@ import type { Diagnostic } from "./types.ts";
  *   `flexsearch()`, `pagefind()`, `algolia({…})`, `oramaCloud({…})`,
  *   `typesense({…})`, `mixedbread({…})`, or `false`), or `{ provider,
  *   popular, indexing }` to add curated links and indexing settings.
- * - `ai` — what faces a model at read time: `ask` (the Ask AI assistant, with
+ * - `ai` — what faces a model at read time: `assistant` (the chat assistant, with
  *   a provider adapter from `blume/ai` such as `gateway()` or `openrouter()`)
  *   and `openInChat` (the "Open in chat" page action).
  * - `agents` — the machine-readable surface: `llmsTxt`, the JSON `api`, the
@@ -133,7 +133,7 @@ import type { Diagnostic } from "./types.ts";
  * });
  * ```
  *
- * @example An OpenAPI reference with the Ask AI assistant enabled.
+ * @example An OpenAPI reference with the assistant enabled.
  * ```ts
  * import { openapi } from "blume/reference";
  *
@@ -146,7 +146,7 @@ import type { Diagnostic } from "./types.ts";
  *     }),
  *   ],
  *   agents: { llmsTxt: true },
- *   ai: { ask: { enabled: true } },
+ *   ai: { assistant: { enabled: true } },
  * });
  * ```
  *

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

@@ -125,10 +125,10 @@ export interface BlumeDataConfig {
     analytics: ResolvedConfig["analytics"];
     /** Apple touch icon, or `null` when none is configured/detected. */
     appleIcon: BlumeFavicon | null;
-    /** Ask AI empty-state suggestions, or `null` when Ask AI is off. */
-    ask: {
+    /** The assistant's empty-state suggestions, or `null` when the assistant is off. */
+    assistant: {
         endpoint: string | null;
-        suggestions: NonNullable<ResolvedConfig["ai"]["ask"]>["suggestions"];
+        suggestions: NonNullable<ResolvedConfig["ai"]["assistant"]>["suggestions"];
     } | null;
     banner: BlumeBanner | null;
     /** Site-wide route mount point, normalized to `""` or `/seg` (see config). */

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

@@ -1,6 +1,8 @@
 import type { FolderMeta, ResolvedConfig, ResolvedI18nConfig, ResolvedVersionsConfig } from "./schema.ts";
 import type { ContentGraph, PageRecord } from "./types.ts";
 interface BuildContentGraphOptions {
+    /** The banner's link target as configured (`banner.link.href`), if any. */
+    bannerHref?: string;
     /** Site-wide route mount point (`""` or `/seg`); invisible to the nav tree. */
     basePath?: string;
     /** The header brand link as configured (`logo.href`, default `/`). */

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

@@ -11,7 +11,6 @@ declare const uiStringsObject: z.ZodObject<{
     actions: z.ZodPrefault<z.ZodObject<{
         addToCursor: z.ZodDefault<z.ZodString>;
         addToVscode: z.ZodDefault<z.ZodString>;
-        askAI: z.ZodDefault<z.ZodString>;
         connectMcp: z.ZodDefault<z.ZodString>;
         copied: z.ZodDefault<z.ZodString>;
         copyClaudeCode: z.ZodDefault<z.ZodString>;
@@ -30,7 +29,7 @@ declare const uiStringsObject: z.ZodObject<{
         openInChatPrompt: z.ZodDefault<z.ZodString>;
         scrollToTop: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
-    ask: z.ZodPrefault<z.ZodObject<{
+    assistant: z.ZodPrefault<z.ZodObject<{
         ai: z.ZodDefault<z.ZodString>;
         clear: z.ZodDefault<z.ZodString>;
         close: z.ZodDefault<z.ZodString>;
@@ -52,9 +51,20 @@ declare const uiStringsObject: z.ZodObject<{
         title: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     content: z.ZodPrefault<z.ZodObject<{
+        code: z.ZodDefault<z.ZodString>;
         copyColor: z.ZodDefault<z.ZodString>;
         copyPrompt: z.ZodDefault<z.ZodString>;
+        default: z.ZodDefault<z.ZodString>;
         diagramError: z.ZodDefault<z.ZodString>;
+        forks: z.ZodDefault<z.ZodString>;
+        preview: z.ZodDefault<z.ZodString>;
+        prop: z.ZodDefault<z.ZodString>;
+        selectTab: z.ZodDefault<z.ZodString>;
+        showMore: z.ZodDefault<z.ZodString>;
+        stars: z.ZodDefault<z.ZodString>;
+        tab: z.ZodDefault<z.ZodString>;
+        type: z.ZodDefault<z.ZodString>;
+        update: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     feedback: z.ZodPrefault<z.ZodObject<{
         no: z.ZodDefault<z.ZodString>;
@@ -100,12 +110,14 @@ declare const uiStringsObject: z.ZodObject<{
         all: z.ZodDefault<z.ZodString>;
         allLanguages: z.ZodDefault<z.ZodString>;
         allVersions: z.ZodDefault<z.ZodString>;
-        askAi: z.ZodDefault<z.ZodString>;
-        askAiHint: z.ZodDefault<z.ZodString>;
+        assistant: z.ZodDefault<z.ZodString>;
+        assistantHint: z.ZodDefault<z.ZodString>;
         button: z.ZodDefault<z.ZodString>;
         devOnly: z.ZodDefault<z.ZodString>;
+        docs: z.ZodDefault<z.ZodString>;
         error: z.ZodDefault<z.ZodString>;
         label: z.ZodDefault<z.ZodString>;
+        latest: z.ZodDefault<z.ZodString>;
         navigate: z.ZodDefault<z.ZodString>;
         noResults: z.ZodDefault<z.ZodString>;
         open: z.ZodDefault<z.ZodString>;
@@ -127,7 +139,6 @@ export declare const uiStringsSchema: z.ZodPrefault<z.ZodObject<{
     actions: z.ZodPrefault<z.ZodObject<{
         addToCursor: z.ZodDefault<z.ZodString>;
         addToVscode: z.ZodDefault<z.ZodString>;
-        askAI: z.ZodDefault<z.ZodString>;
         connectMcp: z.ZodDefault<z.ZodString>;
         copied: z.ZodDefault<z.ZodString>;
         copyClaudeCode: z.ZodDefault<z.ZodString>;
@@ -146,7 +157,7 @@ export declare const uiStringsSchema: z.ZodPrefault<z.ZodObject<{
         openInChatPrompt: z.ZodDefault<z.ZodString>;
         scrollToTop: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
-    ask: z.ZodPrefault<z.ZodObject<{
+    assistant: z.ZodPrefault<z.ZodObject<{
         ai: z.ZodDefault<z.ZodString>;
         clear: z.ZodDefault<z.ZodString>;
         close: z.ZodDefault<z.ZodString>;
@@ -168,9 +179,20 @@ export declare const uiStringsSchema: z.ZodPrefault<z.ZodObject<{
         title: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     content: z.ZodPrefault<z.ZodObject<{
+        code: z.ZodDefault<z.ZodString>;
         copyColor: z.ZodDefault<z.ZodString>;
         copyPrompt: z.ZodDefault<z.ZodString>;
+        default: z.ZodDefault<z.ZodString>;
         diagramError: z.ZodDefault<z.ZodString>;
+        forks: z.ZodDefault<z.ZodString>;
+        preview: z.ZodDefault<z.ZodString>;
+        prop: z.ZodDefault<z.ZodString>;
+        selectTab: z.ZodDefault<z.ZodString>;
+        showMore: z.ZodDefault<z.ZodString>;
+        stars: z.ZodDefault<z.ZodString>;
+        tab: z.ZodDefault<z.ZodString>;
+        type: z.ZodDefault<z.ZodString>;
+        update: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     feedback: z.ZodPrefault<z.ZodObject<{
         no: z.ZodDefault<z.ZodString>;
@@ -216,12 +238,14 @@ export declare const uiStringsSchema: z.ZodPrefault<z.ZodObject<{
         all: z.ZodDefault<z.ZodString>;
         allLanguages: z.ZodDefault<z.ZodString>;
         allVersions: z.ZodDefault<z.ZodString>;
-        askAi: z.ZodDefault<z.ZodString>;
-        askAiHint: z.ZodDefault<z.ZodString>;
+        assistant: z.ZodDefault<z.ZodString>;
+        assistantHint: z.ZodDefault<z.ZodString>;
         button: z.ZodDefault<z.ZodString>;
         devOnly: z.ZodDefault<z.ZodString>;
+        docs: z.ZodDefault<z.ZodString>;
         error: z.ZodDefault<z.ZodString>;
         label: z.ZodDefault<z.ZodString>;
+        latest: z.ZodDefault<z.ZodString>;
         navigate: z.ZodDefault<z.ZodString>;
         noResults: z.ZodDefault<z.ZodString>;
         open: z.ZodDefault<z.ZodString>;
@@ -270,6 +294,11 @@ export { UI_PACKS } from "./ui-packs/index.ts";
  * English baseline ← default-locale pack ← default-locale override ←
  * locale pack ← locale override. So a missing key falls back to the default
  * locale's translation, then to English.
+ *
+ * English has no pack because the baseline is its complete translation, so an
+ * English locale (`en`, `en-GB`) skips the default-locale layers: on a site
+ * whose default is German, English pages keep English chrome instead of
+ * inheriting the German strings.
  */
 export declare const resolveUIStrings: (locale: string, options: {
     defaultLocale: string;

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

@@ -76,8 +76,14 @@ export declare const localePlacement: (rel: string, ext: string, i18n: ResolvedI
  * (`x.en.mdx`) swaps it for the target's (`x.fr.mdx`) — same case-insensitive
  * last-dot-inside-filename logic as `localePlacement`, so both spellings of a
  * default-locale file resolve to one canonical target.
+ *
+ * Under `dir`, `folders` are the content root's existing top-level folders: one
+ * that names the locale in another casing (`pt-br/` for a configured `pt-BR`)
+ * is the locale's folder already, since {@link detectLocale} matches it case-
+ * insensitively. Writing beside it into a second `pt-BR/` would, on a case-
+ * sensitive filesystem, publish the page twice.
  */
-export declare const localeTargetPath: (rel: string, ext: string, locale: string, i18n: ResolvedI18nConfig) => string;
+export declare const localeTargetPath: (rel: string, ext: string, locale: string, i18n: ResolvedI18nConfig, folders?: readonly string[]) => string;
 /**
  * Warn about top-level content folders that look like a locale (a code Blume
  * recognizes) but aren't declared in `i18n.locales`. Without this they're

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

@@ -35,7 +35,9 @@ export declare const resolveRelativeHref: (href: string, from: RelativeLinkBase,
  * Whether a content file is its folder's index, from its name as written on
  * disk: `index.md(x)` after an ordering prefix, optionally carrying one of
  * `localeTokens` before the extension (`index.fr.mdx` under the `dot` locale
- * parser, `index.$.mdx` for a file shared by every locale).
+ * parser, `index.$.mdx` for a file shared by every locale). The `index` itself
+ * is case-sensitive, as route mapping reads it: `Index.md` is a page named
+ * `Index`, not its folder's index.
  */
 export declare const isIndexFileName: (name: string, localeTokens?: readonly string[]) => boolean;
 /** Where content files publish, for resolving file links (`./setup.mdx`). */

package/dist/types/core/load-module.d.ts

@@ -5,3 +5,13 @@
  * which is what makes dev-server regeneration reflect config/meta changes.
  */
 export declare const createModuleLoader: () => ((file: string) => Promise<unknown>);
+/**
+ * Create a loader for a module whose default export is its whole value
+ * (`blume.config.ts`). Unlike {@link createModuleLoader}, it never falls back
+ * to the module's namespace: a module with no default export, or one that
+ * exports `null`/`undefined`, resolves to `undefined` so the caller can say
+ * so, instead of validating `{}` (a bare `defineConfig({…})` call) or
+ * `{ config }` (a named export). jiti's default interop is off because it
+ * throws on `export default null`.
+ */
+export declare const createDefaultExportLoader: typeof createModuleLoader;

package/dist/types/core/locale-links.d.ts

@@ -33,6 +33,11 @@ export interface LocalizeLinkOptions {
     /** Every served route, base-prefixed like `path` (no `deployment.base`). */
     routes: RouteSet;
 }
+/**
+ * Whether `routes` serves `route` (base-prefixed, fragment-less). Routes are
+ * stored decoded, so a browser-copied `/caf%C3%A9` still finds its page.
+ */
+export declare const servesRoute: (routes: RouteSet, route: string) => boolean;
 /**
  * Move a base-prefixed, fragment-less internal path into `locale` when that
  * route is served, else return it unchanged. Idempotent: a path already under
@@ -44,9 +49,14 @@ export interface LocalizeHrefOptions extends LocalizeLinkOptions {
     deployBase: string;
 }
 /**
- * Localize a rendered `href`: external URLs, relative paths, bare fragments, and
- * asset links pass through; a root-relative page link keeps its `?query` and
+ * Localize a rendered `href`: external URLs, relative paths, and bare
+ * fragments pass through; a root-relative page link keeps its `?query` and
  * `#fragment` and its `deployment.base` layer around the localized path.
+ *
+ * Asset links (`/logo.png`, a raw `.md` twin) pass through too, because no
+ * page is served at their localized path — the same served-route test the
+ * link checker applies. A file extension alone doesn't mark an asset: a
+ * dotted page route (`/releases/v1.2`) is localized like any other page.
  */
 export declare const localizeHref: (href: string, options: LocalizeHrefOptions) => string;
 /**

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

@@ -2,10 +2,14 @@ import type { FolderMeta } from "./schema.ts";
 import type { Diagnostic } from "./types.ts";
 /** A filesystem content source to scan for folder meta: its on-disk root and
  * optional route prefix. The prefix is folded into every key so meta lines up
- * with the sidebar group path, which carries the same prefix. */
+ * with the sidebar group path, which carries the same prefix. `include` and
+ * `exclude` are the source's content globs, which scope the scan to the
+ * folders the source reads. */
 export interface FolderMetaSource {
     root: string;
     prefix?: string;
+    include?: readonly string[];
+    exclude?: readonly string[];
 }
 /**
  * Discover `meta.{ts,js,mjs}` files across the given filesystem sources. Keys are

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

@@ -1,3 +1,4 @@
+import type { SidebarItemConfig } from "./schema.ts";
 import type { Diagnostic, Navigation, PageRecord } from "./types.ts";
 /** Warn about icon names that aren't in Blume's set (skipping image/SVG icons). */
 export declare const validateNavIcons: (navigation: Navigation) => Diagnostic[];
@@ -16,6 +17,15 @@ export declare const validateSearchPopularIcons: (popular: {
  * not in the content-only graph build.
  */
 export declare const validateNavTargets: (navigation: Navigation, routes: Set<string>) => Diagnostic[];
+/**
+ * Warn about explicit `navigation.sidebar` items that can't render as written,
+ * instead of dropping them without a word: a page ref that matches no page
+ * (left out of the sidebar), a `root` that matches no page (its link leads
+ * nowhere), and an item with no page, `href`, `root`, or `items` (left out).
+ * `resolves` answers whether a normalized ref (`/guides`) names a page — in
+ * any locale — or a route served outside the content tree.
+ */
+export declare const validateSidebarItems: (items: SidebarItemConfig[], resolves: (route: string) => boolean) => Diagnostic[];
 /**
  * Structural navigation diagnostics that need only the built navigation +
  * content pages: duplicate sidebar labels at a level, and hidden pages that

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

@@ -18,6 +18,29 @@ export declare const isUnderPath: (route: string, base: string) => boolean;
  * sidebar or highlight the wrong tab over it.
  */
 export declare const isRootTab: (tab: NavTab, root: string) => boolean;
+/**
+ * Capitalize one word of a slug-like name for display, spelling the acronyms
+ * and brand casings in {@link WORD_FORMS} their own way (`api` → "API").
+ * Shared with page titles derived from file names, so a page and a folder
+ * named alike read alike.
+ */
+export declare const titleWord: (word: string) => string;
+/**
+ * An explicit-sidebar ref (`"guides/"`, `"/guides/index"`, `"index"`) in the
+ * slashless route form pages are keyed by (`/guides`, `/`).
+ */
+export declare const normalizeRef: (ref: string) => string;
+/** An explicit-config sidebar item written as a bare page-ref string. */
+export declare const isPageRef: (item: SidebarItemConfig) => item is string;
+/**
+ * Pages keyed the way explicit-sidebar refs look them up: by the
+ * locale-agnostic `translationKey` under i18n (`byLogical`), so one authored
+ * sidebar maps onto every locale's pages, else by route. Refs are authored as
+ * if mounted at root while `page.route` carries the base, so each page is also
+ * aliased under its base-less route (the `translationKey` is base-less
+ * already).
+ */
+export declare const pagesByRef: (pages: PageRecord[], basePath: string, byLogical: boolean) => Map<string, PageRecord>;
 /** Build the complete navigation model from pages, meta, and config. */
 export declare const buildNavigation: (pages: PageRecord[], options: {
     /** Plain links in the header, left of the icon buttons. */
@@ -39,6 +62,13 @@ export declare const buildNavigation: (pages: PageRecord[], options: {
      * group path, e.g. `fr`, `v1.0`, or `v1.0/fr`.
      */
     metaPrefix?: string;
+    /**
+     * Folder-meta lookup prefix of the i18n fallback locale, whose untranslated
+     * pages pad this tree (`""` for the default locale of the current
+     * version). A group with no meta of this locale's mirrors the fallback
+     * locale's. Unset for the fallback locale itself, and without i18n.
+     */
+    fallbackMetaPrefix?: string;
     /**
      * Prefix for shared `meta.$.*` lookups — the version dir inside a
      * snapshot (`v1.0`), since shared meta is locale-agnostic but still
@@ -60,6 +90,14 @@ export declare const buildNavigation: (pages: PageRecord[], options: {
      * scoping.
      */
     localizedRoot?: string;
+    /**
+     * The root of the space tab paths are written in, before `basePath`: the
+     * current docs' localized root (`"/"`, `/fr`). Defaults to
+     * `localizedRoot`; an archived version tree passes it because its own
+     * root is versionized (`/fr/v1.0`) while tab paths are not, so a tab's
+     * section can be found under the version.
+     */
+    tabRoot?: string;
     /**
      * Sink for diagnostics produced while building the tree (duplicate sidebar
      * `order` values, index-page title/folder-meta-title mismatches). Pushed

package/dist/types/core/ordering-prefix.d.ts

@@ -0,0 +1,4 @@
+/** The digits of `name`'s ordering prefix (`01` of `01-intro`), if it has one. */
+export declare const orderingPrefix: (name: string) => string | undefined;
+/** `name` without its ordering prefix (`01-intro` -> `intro`). */
+export declare const stripOrderingPrefix: (name: string) => string;

package/dist/types/core/safe-links.d.ts

@@ -21,6 +21,8 @@ export declare const unsafeLinkSpans: (tree: Root) => UnsafeLinkSpan[];
 /**
  * Markdown with every unsafe link reduced to its label text and every unsafe
  * link definition removed. Everything else — safe links, raw HTML, code —
- * passes through as written.
+ * passes through as written. The Markdown is read as GitHub-flavored, the way
+ * the site renders it: a link inside a footnote definition or a table cell is
+ * only a link to a GFM parser.
  */
 export declare const neutralizeUnsafeLinks: (markdown: string) => string;

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

@@ -471,7 +471,7 @@ type SearchOptionsInput = z.input<typeof searchOptionsSchema>;
 /** What `search` accepts: an adapter (or `false`) directly, or the object form. */
 type SearchConfigInput = false | SearchAdapterInput | SearchOptionsInput;
 declare const aiConfigSchema: z.ZodObject<{
-    ask: z.ZodOptional<z.ZodObject<{
+    assistant: z.ZodOptional<z.ZodObject<{
         cors: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodPipe<z.ZodURL, z.ZodTransform<string, string>>]>>>;
         enabled: z.ZodDefault<z.ZodBoolean>;
         endpoint: z.ZodOptional<z.ZodString>;
@@ -582,9 +582,9 @@ declare const aiConfigSchema: z.ZodObject<{
         cursor: "cursor";
     }>>]>>, z.ZodTransform<("v0" | "chatgpt" | "claude" | "t3" | "scira" | "cursor")[], boolean | ("v0" | "chatgpt" | "claude" | "t3" | "scira" | "cursor")[]>>;
 }, z.core.$strict>;
-export { askReasoningLevels } from "../ai/ask.ts";
-export type { AskReasoning } from "../ai/ask.ts";
-export type AskAiConfig = NonNullable<z.infer<typeof aiConfigSchema>["ask"]>;
+export { assistantReasoningLevels } from "../ai/ask.ts";
+export type { AssistantReasoning } from "../ai/ask.ts";
+export type AssistantConfig = NonNullable<z.infer<typeof aiConfigSchema>["assistant"]>;
 export { openInChatProviders } from "./open-in-chat.ts";
 export type { OpenInChatProvider } from "./open-in-chat.ts";
 /** A configured locale: ISO-ish code plus display metadata for the switcher. */
@@ -687,15 +687,7 @@ declare const contentSignalsSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean,
     aiTrain: boolean;
     search: boolean;
 }>>;
-/**
- * How the "last updated" stamp and the changelog timeline render their dates —
- * a curated pass-through to `Intl.DateTimeFormat`, shared by both surfaces so
- * they read alike. Defaults to `{ dateStyle: "long" }`. Both stamps format in
- * UTC unless a `timeZone` is given, so a date reads the same regardless of the
- * build machine's zone. `dateStyle` is a preset that can't be combined with the
- * individual component fields (`year`, `month`, …), matching `Intl`'s own rule.
- */
-declare const dateFormatConfigSchema: z.ZodObject<{
+declare const dateFormatConfigSchema: z.ZodPipe<z.ZodObject<{
     calendar: z.ZodOptional<z.ZodString>;
     dateStyle: z.ZodOptional<z.ZodEnum<{
         medium: "medium";
@@ -730,7 +722,27 @@ declare const dateFormatConfigSchema: z.ZodObject<{
         numeric: "numeric";
         "2-digit": "2-digit";
     }>>;
-}, z.core.$strict>;
+}, z.core.$strict>, z.ZodTransform<{
+    calendar?: string | undefined;
+    dateStyle?: "medium" | "full" | "long" | "short" | undefined;
+    day?: "numeric" | "2-digit" | undefined;
+    era?: "long" | "short" | "narrow" | undefined;
+    month?: "long" | "short" | "numeric" | "2-digit" | "narrow" | undefined;
+    numberingSystem?: string | undefined;
+    timeZone?: string | undefined;
+    weekday?: "long" | "short" | "narrow" | undefined;
+    year?: "numeric" | "2-digit" | undefined;
+}, {
+    calendar?: string | undefined;
+    dateStyle?: "medium" | "full" | "long" | "short" | undefined;
+    day?: "numeric" | "2-digit" | undefined;
+    era?: "long" | "short" | "narrow" | undefined;
+    month?: "long" | "short" | "numeric" | "2-digit" | "narrow" | undefined;
+    numberingSystem?: string | undefined;
+    timeZone?: string | undefined;
+    weekday?: "long" | "short" | "narrow" | undefined;
+    year?: "numeric" | "2-digit" | undefined;
+}>>;
 export declare const blumeConfigSchema: z.ZodObject<{
     agents: z.ZodPrefault<z.ZodObject<{
         agentReadability: z.ZodDefault<z.ZodBoolean>;
@@ -785,7 +797,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
         webmcp: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
     ai: z.ZodPrefault<z.ZodObject<{
-        ask: z.ZodOptional<z.ZodObject<{
+        assistant: z.ZodOptional<z.ZodObject<{
             cors: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodPipe<z.ZodURL, z.ZodTransform<string, string>>]>>>;
             enabled: z.ZodDefault<z.ZodBoolean>;
             endpoint: z.ZodOptional<z.ZodString>;
@@ -931,6 +943,13 @@ export declare const blumeConfigSchema: z.ZodObject<{
         }, z.core.$catchall<z.ZodJSONSchema>>;
         requiredSecrets: z.ZodArray<z.ZodString>;
         runtimeDeps: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"databuddy">;
+        options: z.ZodObject<{
+            clientId: z.ZodString;
+        }, z.core.$catchall<z.ZodString>>;
+        requiredSecrets: z.ZodArray<z.ZodString>;
+        runtimeDeps: z.ZodArray<z.ZodString>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"fathom">;
         options: z.ZodObject<{
@@ -2164,7 +2183,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
             runtimeDeps: string[];
         })[] | undefined;
     }>>>;
-    dateFormat: z.ZodDefault<z.ZodObject<{
+    dateFormat: z.ZodDefault<z.ZodPipe<z.ZodObject<{
         calendar: z.ZodOptional<z.ZodString>;
         dateStyle: z.ZodOptional<z.ZodEnum<{
             medium: "medium";
@@ -2199,7 +2218,27 @@ export declare const blumeConfigSchema: z.ZodObject<{
             numeric: "numeric";
             "2-digit": "2-digit";
         }>>;
-    }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodTransform<{
+        calendar?: string | undefined;
+        dateStyle?: "medium" | "full" | "long" | "short" | undefined;
+        day?: "numeric" | "2-digit" | undefined;
+        era?: "long" | "short" | "narrow" | undefined;
+        month?: "long" | "short" | "numeric" | "2-digit" | "narrow" | undefined;
+        numberingSystem?: string | undefined;
+        timeZone?: string | undefined;
+        weekday?: "long" | "short" | "narrow" | undefined;
+        year?: "numeric" | "2-digit" | undefined;
+    }, {
+        calendar?: string | undefined;
+        dateStyle?: "medium" | "full" | "long" | "short" | undefined;
+        day?: "numeric" | "2-digit" | undefined;
+        era?: "long" | "short" | "narrow" | undefined;
+        month?: "long" | "short" | "numeric" | "2-digit" | "narrow" | undefined;
+        numberingSystem?: string | undefined;
+        timeZone?: string | undefined;
+        weekday?: "long" | "short" | "narrow" | undefined;
+        year?: "numeric" | "2-digit" | undefined;
+    }>>>;
     deployment: z.ZodPrefault<z.ZodPipe<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"cloudflare">;
         options: z.ZodObject<{
@@ -2441,7 +2480,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
                 tag: z.ZodOptional<z.ZodString>;
             }, z.core.$strict>>>;
             label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
-            path: z.ZodString;
+            path: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
         }, z.core.$strict>>>;
     }, z.core.$strict>>;
     react: z.ZodPrefault<z.ZodObject<{

package/dist/types/core/sources/github-releases.d.ts

@@ -20,6 +20,11 @@ export interface GithubReleasesSourceOptions {
     prereleases?: boolean;
     /** Repository name. */
     repo: string;
+    /**
+     * The site's own URL (`deployment.site`). A link in the notes back to it
+     * becomes root-relative, the way a page links to another page.
+     */
+    site?: string;
 }
 /**
  * GitHub Releases content source. Pulls a repo's releases from the REST API and