blume 0.1.0 → 0.1.2

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

@@ -0,0 +1,107 @@
+import type { ResolvedI18nConfig } from "../schema.ts";
+import type { Diagnostic } from "../types.ts";
+/**
+ * A single content item, normalized by a source adapter. Adapters lower their
+ * native shape (files, Portable Text, Notion blocks, remote HTML) to Markdown/MDX
+ * *text* so Blume's markdown processors and component set apply uniformly.
+ */
+export interface SourceEntry {
+    /** Source-local stable id, e.g. `api/auth.mdx` or a CMS document id. */
+    ref: string;
+    /** Logical route input; defaults to `ref` if omitted. May include slashes. */
+    slug?: string;
+    /** Frontmatter-equivalent metadata, validated against the Blume meta schema. */
+    data: Record<string, unknown>;
+    /** The renderable body as Markdown/MDX source text (frontmatter stripped). */
+    body: {
+        format: "md" | "mdx";
+        text: string;
+    };
+    /**
+     * Full source text including frontmatter, written verbatim to the staging
+     * dir so Astro re-parses the same frontmatter. Staged (non-filesystem) sources
+     * set this; filesystem entries (read from disk) omit it.
+     */
+    raw?: string;
+    /**
+     * Absolute filesystem path when the entry originates from disk. Populated by
+     * the filesystem adapter only; powers git last-modified and edit URLs and the
+     * `sourcePath` back-compat window. Omitted by remote/CMS adapters.
+     */
+    sourcePath?: string;
+    /** Optional provenance for "edit this page". */
+    editUrl?: string;
+    /** Optional last-modified ISO date supplied by the adapter (non-filesystem). */
+    lastModified?: string;
+    /** Content hash for cache invalidation / HMR; adapter-computed when cheap. */
+    hash?: string;
+}
+/** The result of a single `ContentSource.load()` call. */
+export interface SourceLoadResult {
+    entries: SourceEntry[];
+    /** Source-level diagnostics (e.g. an offline cache fallback warning). */
+    diagnostics: Diagnostic[];
+}
+/**
+ * Per-source runtime context, handed to an adapter factory at construction so
+ * `load`/`read`/`watch` can close over it without re-threading on every call.
+ */
+export interface SourceContext {
+    projectRoot: string;
+    /** Per-source cache dir under `.blume/cache/<source>/`. */
+    cacheDir: string;
+    mode: "dev" | "build";
+    /** Dir for downloaded assets (served from the site's public dir). */
+    assetsDir?: string;
+    /** Public URL prefix the downloaded assets are served under. */
+    assetsBaseUrl?: string;
+    /**
+     * Re-fetch remote content instead of serving the cached snapshot. True for
+     * builds and `blume sync`; false in dev (cache-first for fast, offline-tolerant
+     * restarts — refresh with `blume sync` or an opt-in `pollInterval`).
+     */
+    refresh?: boolean;
+    /**
+     * Preview unpublished content: drafts are kept and CMS adapters fetch draft
+     * documents (Sanity's `previewDrafts` perspective). Off for production builds.
+     */
+    preview?: boolean;
+}
+/**
+ * A pluggable content source. Adapters enumerate normalized entries and
+ * (optionally) re-read a single entry, validate themselves, and watch for
+ * changes. Identity is the opaque `SourceEntry.ref`, never a filesystem path.
+ */
+export interface ContentSource {
+    /** Unique, stable name; used for id namespacing and diagnostics. */
+    readonly name: string;
+    /**
+     * Whether entries render through the staging collection. Filesystem sources
+     * render through Astro's existing `docs` glob collection (`false`); every
+     * other source materializes MDX into `.blume/content` (`true`).
+     */
+    readonly staged: boolean;
+    /** Optional route prefix; the source's routes namespace under `/<prefix>/`. */
+    readonly prefix?: string;
+    /** Pull every entry. Called once per scan. */
+    load: () => Promise<SourceLoadResult>;
+    /** Validate the source is usable; throws a BlumeError when not. */
+    validate?: () => void;
+    /** Read a single entry's body lazily (search / AI / raw export). */
+    read?: (ref: string) => Promise<string>;
+    /**
+     * Notify on change in dev. Returns a disposer. Filesystem uses `fs.watch`;
+     * remote/static sources omit it (content is frozen for the session).
+     */
+    watch?: (onChange: () => void) => () => void;
+}
+/** Context passed to `normalizeEntry`, describing the owning source. */
+export interface NormalizeContext {
+    source: {
+        name: string;
+        prefix?: string;
+        staged: boolean;
+    };
+    defaultType: string;
+    i18n?: ResolvedI18nConfig;
+}

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

@@ -0,0 +1,245 @@
+import type { DirectoryMode, PageMeta, ResolvedConfig, SidebarDisplay } from "./schema.ts";
+/** Severity levels for Blume diagnostics. */
+export type DiagnosticSeverity = "error" | "warning" | "info";
+/**
+ * A single actionable diagnostic. Diagnostics are printable in the CLI, the
+ * Astro/Vite overlay, and as JSON for editor integrations.
+ */
+export interface Diagnostic {
+    code: string;
+    severity: DiagnosticSeverity;
+    message: string;
+    file?: string;
+    line?: number;
+    column?: number;
+    schemaPath?: string;
+    suggestion?: string;
+    docsUrl?: string;
+}
+/** A heading extracted from page content, used for the TOC and search. */
+export interface Heading {
+    depth: number;
+    text: string;
+    slug: string;
+}
+/** A link target discovered in page content, anchored to its source line. */
+export interface PageLink {
+    /** Raw link target as written, e.g. `./foo`, `/api#auth`, `https://x.dev`. */
+    target: string;
+    /** 1-based line number in the source file. */
+    line: number;
+    /** 1-based column of the target within the line. */
+    column: number;
+}
+/**
+ * Resolved project paths. Computed once per CLI invocation and threaded
+ * through the core pipeline.
+ */
+export interface ProjectContext {
+    /** Absolute path to the user project root. */
+    root: string;
+    /** Absolute path to the content root (e.g. `<root>/docs`). */
+    contentRoot: string;
+    /** Absolute path to the custom pages dir, if it exists. */
+    pagesRoot: string | null;
+    /** Absolute path to the generated runtime (`<root>/.blume`). */
+    outDir: string;
+    /** Absolute path to the user `theme.css`, if present. */
+    themeFile: string | null;
+    /** Absolute path to the user `components.ts`/`.tsx`, if present. */
+    componentsFile: string | null;
+    /** Absolute path to the resolved config file, if any was found. */
+    configFile: string | null;
+}
+/**
+ * A normalized content page. This is the unit the route manifest, nav graph,
+ * and search index are derived from.
+ */
+export interface PageRecord {
+    /** Stable, globally-unique id: `"<source>:<ref>"`, e.g. `filesystem:api/auth.mdx`. */
+    id: string;
+    /** Provenance: the owning source's name and its source-local ref. */
+    source: {
+        name: string;
+        ref: string;
+    };
+    /** Absolute source path. Populated by the filesystem adapter only (back-compat). */
+    sourcePath?: string;
+    /**
+     * Renderable body captured at scan time. Set for staged (non-filesystem)
+     * sources so they can be materialized to `.blume/content` and so soft
+     * consumers need no re-read; omitted for filesystem entries (read from disk).
+     */
+    body?: {
+        format: "md" | "mdx";
+        text: string;
+    };
+    /** Adapter-supplied "edit this page" URL (non-filesystem sources). */
+    editUrl?: string;
+    /** Astro collection this entry renders through; defaults to `"docs"`. */
+    collection?: string;
+    /** Astro collection-relative entry id for `getEntry`; defaults to the ref. */
+    entryId?: string;
+    /** URL route, e.g. `/api/auth`. Always starts with `/`. Locale-prefixed under i18n. */
+    route: string;
+    /** Resolved locale code; the default locale when not under i18n. */
+    locale: string;
+    /**
+     * Locale-agnostic logical route shared by every translation (e.g.
+     * `/guides/x`). Pages with the same key are translations of each other.
+     */
+    translationKey: string;
+    /**
+     * Content-relative path with the leading locale directory stripped, used for
+     * sidebar grouping so the locale dir is not surfaced as a nav group. Equals
+     * `id` for single-locale projects.
+     */
+    navPath: string;
+    /** Path segments without numeric prefixes, e.g. `["api", "auth"]`. */
+    segments: string[];
+    /** Group-folder labels this page lives under, e.g. `["guides"]`. */
+    groups: string[];
+    title: string;
+    description?: string;
+    contentType: string;
+    meta: PageMeta;
+    headings: Heading[];
+    /** Whether the file is `.md`/`.mdx`. */
+    format: "md" | "mdx";
+    /** Internal/asset links discovered in the page (for validation). */
+    links: PageLink[];
+    /** Resolved "last updated" ISO date, when the feature is enabled. */
+    lastModified?: string;
+}
+/** A node in the generated navigation tree. */
+export type NavNode = {
+    kind: "page";
+    label: string;
+    route: string;
+    description?: string;
+    icon?: string;
+    badge?: string;
+    deprecated?: boolean;
+    pageId: string;
+} | {
+    kind: "group";
+    label: string;
+    badge?: string;
+    directory?: DirectoryMode;
+    display?: SidebarDisplay;
+    icon?: string;
+    route?: string;
+    collapsed?: boolean;
+    children: NavNode[];
+};
+/** Top-level tab/section. */
+export interface NavTab {
+    label: string;
+    path: string;
+    icon?: string;
+    items?: NavSelectorItem[];
+}
+/** A selectable navigation option inside a tab menu or top selector. */
+export interface NavSelectorItem {
+    label: string;
+    path: string;
+    description?: string;
+    icon?: string;
+    tag?: string;
+}
+/** Top-level Mintlify-style partition selectors. */
+export interface NavSelector {
+    label: string;
+    kind: "dropdown" | "language" | "product" | "version";
+    items: NavSelectorItem[];
+}
+/** Sidebar tree used when the current route belongs to a nav partition. */
+export interface NavSidebarVariant {
+    path: string;
+    sidebar: NavNode[];
+}
+/** Chrome overrides used when the current route belongs to a nav partition. */
+export interface NavChromeVariant {
+    path: string;
+    banner?: ResolvedConfig["banner"];
+    footer?: ResolvedConfig["footer"];
+    navbar?: ResolvedConfig["navbar"];
+}
+/** The complete navigation model derived from the content graph. */
+export interface Navigation {
+    tabs: NavTab[];
+    selectors: NavSelector[];
+    chromeVariants: NavChromeVariant[];
+    sidebar: NavNode[];
+    sidebarVariants: NavSidebarVariant[];
+    /** Repo URL for the header link, or null when hidden (`navigation.repo`). */
+    repoUrl?: string | null;
+}
+/** The full content graph: the source of truth for generated modules. */
+export interface ContentGraph {
+    pages: PageRecord[];
+    /** Default-locale navigation (the whole site when not under i18n). */
+    navigation: Navigation;
+    /** Navigation per locale; one entry per configured locale under i18n. */
+    navigationByLocale: Record<string, Navigation>;
+    /** Map of route -> pageId for fast lookup and duplicate detection. */
+    routes: Map<string, string>;
+    diagnostics: Diagnostic[];
+}
+/** A locale a logical page exists in, for the switcher and `hreflang`. */
+export interface RouteAlternate {
+    locale: string;
+    path: string;
+}
+/** A resolved language-switcher entry for the current page. */
+export interface LocaleSwitchOption {
+    code: string;
+    label: string;
+    dir: "ltr" | "rtl";
+    /** Target URL: the real translation, or the localized fallback URL. */
+    href: string;
+    current: boolean;
+    /** True when this locale has no real translation (renders fallback content). */
+    untranslated: boolean;
+}
+/** A route entry written to `blume.manifest.json`. */
+export interface RouteManifestEntry {
+    id: string;
+    /** Provenance: the owning source's name and its source-local ref. */
+    source: {
+        name: string;
+        ref: string;
+    };
+    /** Astro collection this entry renders through (`"docs"` | `"staged"`). */
+    collection: string;
+    /** Astro collection-relative entry id, passed to `getEntry`. */
+    entryId: string;
+    path: string;
+    /** Absolute source path; populated for filesystem entries only (back-compat). */
+    sourcePath?: string;
+    /** Adapter-supplied "edit this page" URL (non-filesystem sources). */
+    editUrl?: string;
+    title: string;
+    contentType: string;
+    hidden: boolean;
+    draft: boolean;
+    /** Whether the page should be included in the search index. */
+    indexable: boolean;
+    /** Resolved locale code; the default locale when not under i18n. */
+    locale: string;
+    /** Locales this logical page is genuinely translated into (excludes fallbacks). */
+    alternates: RouteAlternate[];
+    /** True when this route renders fallback content for a missing translation. */
+    fallback?: boolean;
+    /** Resolved "last updated" ISO date, when the feature is enabled. */
+    lastModified?: string;
+}
+/** The generated runtime contract between core and the Astro project. */
+export interface BlumeManifest {
+    version: number;
+    blumeVersion: string;
+    projectRoot: string;
+    contentRoot: string;
+    output: ResolvedConfig["deployment"]["output"];
+    routes: RouteManifestEntry[];
+}

package/dist/types/core/ui-packs/ar.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Arabic (ar) UI strings. */
+export declare const ar: UIStringsOverride;

package/dist/types/core/ui-packs/bg.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Bulgarian (bg) UI strings. */
+export declare const bg: UIStringsOverride;

package/dist/types/core/ui-packs/bn.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Bengali (bn) UI strings. */
+export declare const bn: UIStringsOverride;

package/dist/types/core/ui-packs/ca.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Catalan (ca) UI strings. */
+export declare const ca: UIStringsOverride;

package/dist/types/core/ui-packs/cs.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Czech (cs) UI strings. */
+export declare const cs: UIStringsOverride;

package/dist/types/core/ui-packs/da.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Danish (da) UI strings. */
+export declare const da: UIStringsOverride;

package/dist/types/core/ui-packs/de.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** German (de) UI strings. */
+export declare const de: UIStringsOverride;

package/dist/types/core/ui-packs/el.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Greek (el) UI strings. */
+export declare const el: UIStringsOverride;

package/dist/types/core/ui-packs/es.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Spanish (es) UI strings. */
+export declare const es: UIStringsOverride;

package/dist/types/core/ui-packs/fa.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Persian (fa) UI strings. */
+export declare const fa: UIStringsOverride;

package/dist/types/core/ui-packs/fi.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Finnish (fi) UI strings. */
+export declare const fi: UIStringsOverride;

package/dist/types/core/ui-packs/fr.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** French (fr) UI strings. */
+export declare const fr: UIStringsOverride;

package/dist/types/core/ui-packs/he.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Hebrew (he) UI strings. */
+export declare const he: UIStringsOverride;

package/dist/types/core/ui-packs/hi.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Hindi (hi) UI strings. */
+export declare const hi: UIStringsOverride;

package/dist/types/core/ui-packs/hr.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Croatian (hr) UI strings. */
+export declare const hr: UIStringsOverride;

package/dist/types/core/ui-packs/hu.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Hungarian (hu) UI strings. */
+export declare const hu: UIStringsOverride;

package/dist/types/core/ui-packs/id.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Indonesian (id) UI strings. */
+export declare const id: UIStringsOverride;

package/dist/types/core/ui-packs/index.d.ts

@@ -0,0 +1,13 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/**
+ * Built-in translation packs, one module per locale (`./<code>.ts`). English is
+ * the schema baseline, so it has no pack; every other locale ships a starter
+ * pack so adopters get translated chrome out of the box. Brand names (Cursor,
+ * VS Code, MCP, Claude Code, Markdown, GitHub) are kept verbatim. Packs are
+ * community-maintained — open a PR to add a locale or sharpen a translation.
+ *
+ * Keyed by locale code; regional variants use the BCP 47 form (`pt-BR`,
+ * `zh-TW`). A locale's pack is merged onto English by {@link resolveUIStrings},
+ * so a pack only needs the keys it translates.
+ */
+export declare const UI_PACKS: Record<string, UIStringsOverride>;

package/dist/types/core/ui-packs/it.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Italian (it) UI strings. */
+export declare const it: UIStringsOverride;

package/dist/types/core/ui-packs/ja.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Japanese (ja) UI strings. */
+export declare const ja: UIStringsOverride;

package/dist/types/core/ui-packs/ko.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Korean (ko) UI strings. */
+export declare const ko: UIStringsOverride;

package/dist/types/core/ui-packs/nl.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Dutch (nl) UI strings. */
+export declare const nl: UIStringsOverride;

package/dist/types/core/ui-packs/no.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Norwegian Bokmål (no) UI strings. */
+export declare const no: UIStringsOverride;

package/dist/types/core/ui-packs/pl.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Polish (pl) UI strings. */
+export declare const pl: UIStringsOverride;

package/dist/types/core/ui-packs/pt-br.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Portuguese — Brazil (pt-BR) UI strings. */
+export declare const ptBR: UIStringsOverride;

package/dist/types/core/ui-packs/pt.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Portuguese (pt) UI strings. */
+export declare const pt: UIStringsOverride;

package/dist/types/core/ui-packs/ro.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Romanian (ro) UI strings. */
+export declare const ro: UIStringsOverride;

package/dist/types/core/ui-packs/ru.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Russian (ru) UI strings. */
+export declare const ru: UIStringsOverride;

package/dist/types/core/ui-packs/sk.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Slovak (sk) UI strings. */
+export declare const sk: UIStringsOverride;

package/dist/types/core/ui-packs/sr.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Serbian (sr) UI strings. */
+export declare const sr: UIStringsOverride;

package/dist/types/core/ui-packs/sv.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Swedish (sv) UI strings. */
+export declare const sv: UIStringsOverride;

package/dist/types/core/ui-packs/th.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Thai (th) UI strings. */
+export declare const th: UIStringsOverride;

package/dist/types/core/ui-packs/tr.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Turkish (tr) UI strings. */
+export declare const tr: UIStringsOverride;

package/dist/types/core/ui-packs/uk.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Ukrainian (uk) UI strings. */
+export declare const uk: UIStringsOverride;

package/dist/types/core/ui-packs/vi.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Vietnamese (vi) UI strings. */
+export declare const vi: UIStringsOverride;

package/dist/types/core/ui-packs/zh-tw.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Chinese — Traditional (zh-TW) UI strings. */
+export declare const zhTW: UIStringsOverride;

package/dist/types/core/ui-packs/zh.d.ts

@@ -0,0 +1,3 @@
+import type { UIStringsOverride } from "../i18n-ui.ts";
+/** Chinese — Simplified (zh) UI strings. */
+export declare const zh: UIStringsOverride;

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

@@ -0,0 +1,8 @@
+/**
+ * The installed Blume package version, read lazily from its `package.json`.
+ *
+ * Computed on demand (not at module load) so importing the `blume` barrel has no
+ * filesystem side effect, and anchored at the package root so it resolves the
+ * same whether running from source or the bundled CLI.
+ */
+export declare const getBlumeVersion: () => string;

package/dist/types/index.d.ts

@@ -0,0 +1,10 @@
+export { defineConfig } from "./core/config.ts";
+export type { BlumeBanner, BlumeData, BlumeDataConfig, BlumeDataI18n, BlumeDataLocale, BlumeFavicon, BlumeFeed, BlumeLogo, BlumeRoute, } from "./core/data.ts";
+export { defineComponents } from "./core/define-components.ts";
+export type { ComponentOverride, ComponentOverrides, IslandDescriptor, } from "./core/define-components.ts";
+export { defineMeta } from "./core/define-meta.ts";
+export type { FolderMetaDefinition, FolderMetaFactory, } from "./core/define-meta.ts";
+export type { UIStrings } from "./core/i18n-ui.ts";
+export type { BlumeConfig, FolderMeta, HydrationMode, ResolvedConfig, } from "./core/schema.ts";
+export type { Diagnostic, Heading, NavNode, Navigation, NavTab, PageRecord, } from "./core/types.ts";
+export { getBlumeVersion } from "./core/version.ts";

package/dist/types/migrate/mintlify/config.d.ts

@@ -0,0 +1,2 @@
+import type { BlumeConfig } from "../../core/schema.ts";
+export declare const loadMintlifyConfig: (root: string, file: string) => Promise<BlumeConfig>;

package/dist/types/migrate/mintlify/i18n.d.ts

@@ -0,0 +1,7 @@
+import type { BlumeConfig } from "../../core/schema.ts";
+/**
+ * Map a Mintlify `navigation.languages[]` array to a Blume `i18n` config. The
+ * entry marked `default: true` becomes `defaultLocale`; translated content
+ * already lives in ISO-code directories, which match Blume's `dir` parser.
+ */
+export declare const mintlifyI18n: (spec: Record<string, unknown>) => BlumeConfig["i18n"] | null;