blume 2.0.1 → 2.0.2

package/dist/types/analytics/databuddy.d.ts

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import type { AdapterDescriptor } from "../core/adapter.ts";
+import type { HeadScript } from "./head.ts";
+/** The script Databuddy's install snippet loads. */
+export declare const DATABUDDY_SCRIPT_SRC = "https://cdn.databuddy.cc/databuddy.js";
+/** The options {@link databuddy} maps itself. */
+export interface DatabuddyNamedOptions {
+    /** Client ID, from the website's settings in the Databuddy dashboard. */
+    clientId: string;
+}
+/**
+ * Options for {@link databuddy}: the client ID plus any other tracker setting,
+ * forwarded as a `data-` attribute on the tag (`"track-web-vitals"` →
+ * `data-track-web-vitals`, `"track-errors"`, `"track-outgoing-links"`,
+ * `"api-url"`, …).
+ */
+export type DatabuddyOptions = DatabuddyNamedOptions & {
+    [setting: string]: string;
+};
+export declare const databuddyOptionsSchema: z.ZodObject<{
+    clientId: z.ZodString;
+}, z.core.$catchall<z.ZodString>>;
+export type DatabuddyAdapter = AdapterDescriptor<"databuddy", DatabuddyOptions>;
+export declare const databuddyAdapterSchema: 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>;
+/**
+ * Databuddy. The client ID is public — it's in the tag on every page.
+ */
+export declare const databuddy: (options: DatabuddyOptions) => DatabuddyAdapter;
+/**
+ * The async tag from the install instructions, with `clientId` as
+ * `data-client-id` and every other option as its own `data-` attribute. The
+ * tracker skips setup when `window.databuddy` already exists, so there is no
+ * queue stub. Databuddy's script tracks history changes on its own, so
+ * client-router navigations need no extra hook.
+ */
+export declare const databuddyHead: (options: DatabuddyOptions) => HeadScript[];

package/dist/types/analytics/index.d.ts

@@ -30,6 +30,8 @@ export { clearbit } from "./clearbit.ts";
 export type { ClearbitAdapter, ClearbitOptions } from "./clearbit.ts";
 export { cloudflare } from "./cloudflare.ts";
 export type { CloudflareAdapter, CloudflareOptions } from "./cloudflare.ts";
+export { databuddy } from "./databuddy.ts";
+export type { DatabuddyAdapter, DatabuddyOptions } from "./databuddy.ts";
 export { fathom } from "./fathom.ts";
 export type { FathomAdapter, FathomOptions } from "./fathom.ts";
 export { googleAnalytics } from "./google-analytics.ts";

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

@@ -35,6 +35,13 @@ export declare const analyticsAdapterSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
     }, 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<{
@@ -197,6 +204,13 @@ export declare const analyticsConfigSchema: z.ZodDefault<z.ZodArray<z.ZodDiscrim
     }, 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<{

package/dist/types/cli/env.d.ts

@@ -8,5 +8,10 @@
  * these files at build time, so a value means the same thing to the pre-boot
  * content scan and the built site — including multi-line double-quoted values
  * (PEM keys), which a line-based parser silently truncates.
+ *
+ * `NODE_ENV` is never taken from these files: it picks the mode Vite and Astro
+ * run in, so a monorepo root `.env` that sets it for another app would turn
+ * every `blume build` into a development build (or `blume dev` into a
+ * production one).
  */
 export declare const loadEnvFiles: (startDir: string) => void;

package/dist/types/cli/init/scaffold.d.ts

@@ -33,6 +33,10 @@ export declare const STARTERS: {
             content: string;
             path: string;
         }[];
+        projectFiles: {
+            content: string;
+            path: string;
+        }[];
     };
     changelog: {
         configExtra: string;
@@ -71,6 +75,11 @@ export declare const commandsFor: (pm: PackageManager) => {
     exec: string;
     install: string;
 };
+/**
+ * The `cd` into the new project, quoting a directory a shell would split or
+ * expand: `blume init "my docs"` prints `cd "my docs"`, not `cd my docs`.
+ */
+export declare const cdCommand: (directory: string) => string;
 /**
  * Derive the package manager from an npm user-agent string (the first
  * `name/version` token of `npm_config_user_agent`), falling back to npm.
@@ -97,6 +106,12 @@ export declare const validateContentDir: (root: string, dir: string) => string |
 export declare const titleize: (raw: string) => string;
 /** The full `blume.config.ts` text for the chosen answers. */
 export declare const buildConfig: (answers: InitAnswers) => string;
+/**
+ * Whether `init` installs with pnpm into a folder that sits inside a pnpm
+ * workspace without being one of its packages. pnpm would install that
+ * workspace's own packages from there and exit 0, leaving `blume` uninstalled.
+ */
+export declare const outsidePnpmWorkspace: (root: string, answers: InitAnswers) => boolean;
 /**
  * The major version of the Yarn that ran `init`, read off the npm user agent
  * (`yarn/4.5.1 npm/? node/v22…`), or undefined when something else ran it.
@@ -108,9 +123,10 @@ export interface PlanEnvironment {
     userAgent?: string;
 }
 /**
- * What the project still needs from a workspace it joins, when `init` left
- * that workspace's config alone: pnpm's approval for esbuild's build script
- * (pnpm 10 and later fail the install without it), or Yarn Berry's
+ * What the project still needs from a workspace it sits in, when `init` left
+ * that workspace's config alone: a place in a pnpm workspace's `packages`
+ * (pnpm skips a folder it doesn't list), pnpm's approval for esbuild's build
+ * script (pnpm 10 and later fail the install without it), or Yarn Berry's
  * `node_modules` linker. Undefined when the workspace already has it, or the
  * project doesn't sit in one.
  */

package/dist/types/cli/init/starter-spec.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The OpenAPI document the `api` starter writes beside `blume.config.ts`, so a
+ * new project's first build reads a local file instead of depending on a
+ * third-party server. Small, but it exercises what a real reference renders:
+ * path and query parameters, request bodies, shared schemas, error responses,
+ * and bearer auth. Each operation's description is sized so its page's meta
+ * description, with the endpoint sentence Blume appends, fits the range
+ * `blume audit` checks.
+ */
+/** The starter spec as the `openapi.json` text `init` writes. */
+export declare const STARTER_OPENAPI_JSON: string;

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

@@ -51,6 +51,15 @@ export declare const isExternalUrl: (target: string) => boolean;
  * the base by hand (`/docs/x`) aren't double-prefixed to `/docs/docs/x`.
  */
 export declare const withBasePath: (basePath: string, route: string) => string;
+/**
+ * Mount a route Blume generates from content under `basePath`,
+ * unconditionally. {@link withBasePath} leaves a route that already starts
+ * with the base alone, which is right for a link an author based by hand but
+ * wrong for a content route: with `basePath: "/docs"`, `docs/guide.md` routes
+ * to `/docs/guide` before the base and publishes at `/docs/docs/guide`, not on
+ * top of the root `guide.md`.
+ */
+export declare const mountBasePath: (basePath: string, route: string) => string;
 /**
  * {@link withBasePath} for the composed `deployment.base` + `basePath` stack
  * (`/base` + `/docs` serves pages at `/base/docs/x`). The hand-written-base

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

@@ -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…",
      *   },
      * }
      * ```

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).

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

@@ -51,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>;
@@ -103,8 +114,10 @@ declare const uiStringsObject: z.ZodObject<{
         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>;
@@ -166,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>;
@@ -218,8 +242,10 @@ export declare const uiStringsSchema: z.ZodPrefault<z.ZodObject<{
         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>;
@@ -268,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

@@ -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>;
@@ -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

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

@@ -18,6 +18,15 @@ export interface InlineMarks {
  * CommonMark rule that keeps the padding out of the rendered code).
  */
 export declare const codeSpan: (code: string) => string;
+/**
+ * A block's inline text, guarded where only the whole block can tell. Runs
+ * are escaped one at a time, but "import" ending one run and a space or code
+ * span opening the next form an MDX `import` statement only once they are
+ * joined, and whitespace the first runs put in front of a block turns it into
+ * an indented code block. Apply it to the joined text of a paragraph,
+ * heading, quote, or list item — never to code.
+ */
+export declare const guardBlockStart: (text: string) => string;
 /**
  * Wrap a text run in the Markdown for its marks. Code stays verbatim inside
  * the backticks (an escape would render as a backslash); everything else is
@@ -26,7 +35,7 @@ export declare const codeSpan: (code: string) => string;
  * routinely bold a word together with the space after it.
  */
 export declare const renderInline: (text: string, marks: InlineMarks) => string;
-/** A link or image destination as Markdown can carry it verbatim. */
+/** A link or image destination as Markdown carries it verbatim. */
 export declare const destination: (url: string) => string;
 /**
  * A Markdown link, or the label alone when the target is missing — or unsafe:
@@ -46,7 +55,10 @@ export declare const blockquote: (text: string) => string;
 export declare const listItem: (marker: string, body: string) => string;
 /** Indent every non-empty line, for a nested list hanging off an item. */
 export declare const indent: (text: string, width: number) => string;
-/** A fenced code block whose fence outruns any backtick run in the code. */
+/**
+ * A fenced code block whose fence outruns any backtick run in the code,
+ * labeled with its language when that is one word a fence can carry.
+ */
 export declare const codeFence: (code: string, language?: string) => string;
 /** A Markdown image; the alt is escaped so a `]` in a caption can't close it. */
 export declare const image: (alt: string, url: string) => string;