blume 2.0.1 → 2.0.3

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

@@ -48,9 +48,20 @@ export declare const isExternalUrl: (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`.
+ * the base by hand (`/docs/x`, `/docs#install`) aren't double-prefixed to
+ * `/docs/docs/x`.
  */
 export declare const withBasePath: (basePath: string, route: string) => string;
+/**
+ * Mount a route Blume generates under a base, unconditionally: `basePath` for
+ * a content route, `deployment.base` for any generated URL (a sitemap entry,
+ * a feed item). {@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 generated 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` — and likewise under `deployment.base: "/docs"`.
+ */
+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
@@ -60,6 +71,18 @@ export declare const withBasePath: (basePath: string, route: string) => string;
  * and a route already under the full composite is returned unchanged.
  */
 export declare const withComposedBasePath: (deployBase: string, basePath: string, route: string) => string;
+/**
+ * Base a root-relative link an author wrote as if mounted at root — a content
+ * link (`markdown/base-links.ts`, `components/content/base-href.ts`) or a
+ * redirect target (`deploy/redirects.ts`) — by what it names. A page gains the
+ * composed stack ({@link withComposedBasePath}). A public asset — a path whose
+ * final segment carries a file extension, with no page served there (a dotted
+ * route like `/releases/v1.2` is still a page) — gains the deployment base
+ * alone: Astro serves `public/` under `deployment.base`, but never under
+ * `basePath`. `servesPage` answers whether a page is served at a
+ * `basePath`-prefixed, fragment-less path. Other targets pass through.
+ */
+export declare const withAuthoredBasePath: (deployBase: string, basePath: string, target: string, servesPage: (route: string) => boolean) => string;
 /**
  * Remove `basePath` from the front of a route (`/docs/guide` -> `/guide`,
  * `/docs` -> `/`). A route not under the base is returned unchanged. Inverse of

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…",
      *   },
      * }
      * ```
@@ -850,13 +850,15 @@ export interface OgConfig {
      */
     enabled?: boolean;
     /**
-     * Fonts for the generated card, extending Takumi's Latin-only default so
-     * non-Latin titles (CJK, and so on) render instead of tofu. A bare string is
-     * a Google Fonts family fetched at build; the name-only object form pins
-     * weights (`700`, `[400, 700]`, or a `"100..900"` variable range) and
-     * styles; the `src` form reads a local font file from the project instead.
-     * When omitted and `theme.fonts` is explicitly configured, the theme's
-     * display and body fonts are used automatically — pass `[]` to opt out.
+     * Fonts for the generated card, replacing the default stack: Takumi's
+     * Latin-only built-in font plus a Noto fallback per script, which a card
+     * fetches only when its text needs one. A bare string is a Google Fonts
+     * family fetched at build; the name-only object form pins weights (`700`,
+     * `[400, 700]`, or a `"100..900"` variable range) and styles; the `src`
+     * form reads a local font file from the project instead. When omitted and
+     * `theme.fonts` is explicitly configured, the theme's display and body
+     * fonts are used automatically, ahead of the fallbacks — pass `[]` to opt
+     * out of both.
      */
     fonts?: (string | {
         name: string;

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/directive-diagnostics.d.ts

@@ -0,0 +1,12 @@
+import type { SourceEntry } from "./sources/types.ts";
+import type { Diagnostic } from "./types.ts";
+/**
+ * Warn about each `:::name` container in an `.mdx` entry that isn't a callout.
+ * The page keeps its content — the body renders between the literal `:::`
+ * lines (see `markdown/directives.ts`) — but a typo like `:::warnig`, or a
+ * `:::details` carried over from another docs tool, should read as the
+ * mistake it is rather than as a finished page. Lines point into the file
+ * the author wrote, a partial's own file for a container an `<include>`
+ * brought in.
+ */
+export declare const unknownDirectiveDiagnostics: (entry: SourceEntry, sourceName: string) => Diagnostic[];

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/heading-markers.d.ts

@@ -44,11 +44,9 @@ export interface HeadingMarkers {
  * the heading count (mid-text brackets are ordinary prose); when a marker kind
  * repeats, the last one written wins.
  *
- * `isRefDefined` reports whether a link-reference definition exists for a
- * bracket's label (`toc`, `!toc`, `#id`): a defined bracket is a CommonMark
- * shortcut link, not a marker — the renderer sees a resolved `<a>` element
- * there and strips nothing at or before it, so the parse stops the same way.
- * The render-time hast plugin never passes it (resolved links are already
- * elements by the time it runs); the raw-source scanner does.
+ * Callers pass the heading's trailing text node after a Markdown parse, so a
+ * bracket that a link-reference definition turns into a CommonMark shortcut
+ * link (`[toc]` with a `[toc]: …` definition) is already an element there and
+ * never reaches this parse.
  */
-export declare const parseHeadingMarkers: (text: string, isRefDefined?: (label: string) => boolean) => HeadingMarkers;
+export declare const parseHeadingMarkers: (text: string) => HeadingMarkers;

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,12 +76,20 @@ 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
  * silently treated as default-locale content under a `/<code>/…` route, which
  * is almost never intended — usually a translation that wasn't registered.
+ * A folder named after the default locale gets the same treatment (see
+ * {@link defaultLocaleFolderDiagnostic}).
  */
 export declare const i18nDiagnostics: (pages: PageRecord[], i18n: ResolvedI18nConfig, versions?: ResolvedVersionsConfig) => Diagnostic[];

package/dist/types/core/last-modified.d.ts

@@ -13,6 +13,16 @@ export declare const resolveLastModifiedConfig: (value: false | "git" | "frontma
  * newest-first, the first date seen for a path wins. Blank lines are ignored.
  */
 export declare const parseGitLog: (output: string) => Map<string, string>;
+/**
+ * `path` with every symlink resolved, the spelling git prints paths in: a
+ * project opened through a link (`/tmp/site` on macOS, where `/tmp` links to
+ * `/private/tmp`) gets `/private/tmp/site` from `rev-parse --show-toplevel`,
+ * so the project's own spelling would compare as outside the repository and
+ * every page would go undated. The native realpath also expands a Windows
+ * 8.3 short name (`RUNNER~1`), which git does too. A path that doesn't exist
+ * stays as written.
+ */
+export declare const realPath: (path: string) => string;
 /**
  * The toplevel of the repository containing `root`, or null when git is
  * unavailable or the project isn't a repo. Callers use it to decide which

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,11 +2,23 @@ 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[];
 }
+/**
+ * The folder-meta files a filesystem source contributes: `patterns` (every
+ * meta module name, shared `meta.$.*` included, by default) under the source's
+ * root, minus its `exclude` globs, dependencies, and build output, and only in
+ * folders its `include` globs reach. `blume translate` finds the meta files it
+ * translates through this too, so it covers exactly the ones the scan reads.
+ */
+export declare const findFolderMetaFiles: (source: FolderMetaSource, patterns?: readonly string[]) => Promise<string[]>;
 /**
  * Discover `meta.{ts,js,mjs}` files across the given filesystem sources. Keys are
  * the source's route prefix joined with the directory relative to that source's

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<{
@@ -995,6 +1014,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<"one-dollar-stats">;
+        options: z.ZodObject<{
+            hostname: z.ZodOptional<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<"pirsch">;
         options: z.ZodObject<{
@@ -2164,7 +2190,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 +2225,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 +2487,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