@ox-content/vite-plugin 2.90.0 → 3.0.0-alpha.10

package/dist/index.d.mts

@@ -1,6 +1,80 @@
 import { a as JSXProps, c as jsxs, d as when, i as JSXNode, l as raw, n as JSXChild, o as each, r as JSXElementType, s as jsx, t as Fragment, u as renderToString } from "./jsx-html.mjs";
-import { LanguageRegistration, LanguageRegistration as LanguageRegistration$1, ThemeRegistration, ThemeRegistration as ThemeRegistration$1 } from "shiki";
 import { EnvironmentOptions, Plugin } from "vite";
+//#region src/header-chrome.d.ts
+/**
+ * Opt-in header nav, announcement, and per-page chrome helpers.
+ */
+/** Plain label or locale map (`{ en: "Guide", ja: "ガイド" }`). */
+type LocaleLabel = string | Record<string, string>;
+/** Header nav link or dropdown. */
+interface HeaderNavItem {
+  text: LocaleLabel;
+  link?: string;
+  items?: HeaderNavItem[];
+}
+/** Announcement bar. Text is escaped; no raw HTML slot. */
+interface ThemeAnnouncement {
+  text: string;
+  /** https or same-origin only. */
+  link?: string;
+  /** Best-effort localStorage key for dismiss. */
+  dismissKey?: string;
+}
+/** Per-page frontmatter chrome flags. `false` hides that region. */
+interface PageChromeFlags {
+  sidebar?: boolean;
+  outline?: boolean;
+  aside?: boolean;
+  footer?: boolean;
+  navbar?: boolean;
+  lastUpdated?: boolean;
+  editLink?: boolean;
+}
+/** `false` or omitted stays off. `true` or `{}` enables default flag reading. */
+declare function resolvePageChromeOption(value: boolean | Record<string, unknown> | undefined): boolean;
+/** Reads hide flags from frontmatter. Non-boolean values are ignored. */
+declare function parsePageChromeFlags(frontmatter: Record<string, unknown>): PageChromeFlags;
+/**
+ * Picks the exact locale, its language, the default locale, then the first
+ * non-empty own string in declaration order.
+ */
+declare function resolveLocaleLabel(text: LocaleLabel, locale?: string, defaultLocale?: string): string;
+/** Nav item after locale maps are flattened to strings. */
+interface ResolvedHeaderNavItem {
+  text: string;
+  link?: string;
+  items?: ResolvedHeaderNavItem[];
+}
+/** Resolves locale maps so NAPI always receives string labels. */
+declare function resolveHeaderNavItems(items: HeaderNavItem[] | undefined, locale?: string, defaultLocale?: string): ResolvedHeaderNavItem[] | undefined;
+//#endregion
+//#region src/theme-fonts.d.ts
+type ThemeFontProvider = "google" | "local";
+type ThemeFontStyle = "normal" | "italic";
+type ThemeFontDisplay = "auto" | "block" | "swap" | "fallback" | "optional";
+/** UnoCSS-inspired family descriptor. The string stack form remains valid. */
+interface ThemeWebFont {
+  /** Family name, e.g. `"Inter"` or `"DM Mono"`. */
+  family: string;
+  /** Defaults to `"local"` when `path` is set, otherwise `"google"`. */
+  provider?: ThemeFontProvider;
+  /** File, directory, or `@fontsource/*` package. Required for `local`. */
+  path?: string;
+  weights?: number[];
+  styles?: ThemeFontStyle[];
+  subsets?: string[];
+  display?: ThemeFontDisplay;
+  /** Copy files into the SSG output and emit `@font-face`. */
+  selfHost?: boolean;
+  /** Extra families after `family` in the emitted CSS stack. */
+  fallbacks?: string[];
+  /** Preload every self-hosted face, or only these weights. */
+  preload?: boolean | number[];
+  /** Optional `unicode-range` for local faces. */
+  unicodeRange?: string;
+}
+type ThemeFontValue = string | ThemeWebFont;
+//#endregion
 //#region src/theme-tokens.d.ts
 /**
  * Free-form `--octc-*` custom properties for themes that need more than the
@@ -53,12 +127,17 @@ interface ThemeLayout {
 }
 /**
  * Theme font configuration.
+ *
+ * `sans` and `mono` accept a CSS stack string or a web-font object. Named
+ * families are extra stacks exposed as `--octc-font-<name>`.
  */
 interface ThemeFonts {
-  /** Sans-serif font stack */
-  sans?: string;
-  /** Monospace font stack */
-  mono?: string;
+  /** Sans-serif font stack or self-hosted family */
+  sans?: ThemeFontValue;
+  /** Monospace font stack or self-hosted family */
+  mono?: ThemeFontValue;
+  /** Additional families, exposed as `--octc-font-<name>` */
+  named?: Record<string, ThemeFontValue>;
 }
 /**
  * Entry page theme configuration.
@@ -137,8 +216,10 @@ interface ThemeEmbed {
   /** Custom footer content (replaces default footer) */
   footer?: string;
 }
+/** Sidebar group or link, including recursively nested localized labels. */
 interface SidebarItem {
-  text?: string;
+  /** Plain label or locale map (`{ en: "Guide", ja: "ガイド" }`). */
+  text?: LocaleLabel;
   link?: string;
   items?: SidebarItem[];
   collapsed?: boolean;
@@ -152,6 +233,38 @@ interface ThemeConfig {
   name?: string;
   /** Base theme to extend */
   extends?: ThemeConfig;
+  /**
+   * Preserve the current surface during same-origin MPA navigation with the
+   * browser's cross-document View Transition API.
+   *
+   * Unsupported browsers use normal navigation. Reduced-motion preferences
+   * never enable the transition. Set `false` to opt out.
+   *
+   * @default true
+   */
+  viewTransitions?: boolean;
+  /**
+   * Show the right-hand "On this page" outline.
+   *
+   * Default `false`. When `true`, the outline is rendered only on pages
+   * that have TOC entries, using the existing `<aside class="toc">` markup.
+   */
+  aside?: boolean;
+  /**
+   * Show a breadcrumb trail from the site root through sidebar ancestors.
+   *
+   * Default `false`. `true` or an object enables the trail. Frontmatter
+   * `breadcrumbs: false` still hides it on that page.
+   */
+  breadcrumbs?: boolean | Record<string, unknown>;
+  /**
+   * Heading permalink visibility. CSS only — the renderer HTML stays
+   * `<a class="header-anchor" href="#id">`.
+   *
+   * `"hover"` (default) reveals the `#` on hover / focus-visible, and
+   * stays visible on touch. `"always"` keeps it visible.
+   */
+  headingPermalink?: "hover" | "always";
   /** Light mode colors (maps to CSS variables) */
   colors?: ThemeColors;
   /** Dark mode colors (maps to CSS variables) */
@@ -164,6 +277,17 @@ interface ThemeConfig {
   layout?: ThemeLayout;
   /** Header configuration */
   header?: ThemeHeader;
+  /**
+   * Opt-in header nav. Each item is `{ text, link }` or a dropdown
+   * `{ text, items }`. Labels are escaped. `javascript:`, `data:`,
+   * `vbscript:`, and protocol-relative `//` links are omitted.
+   */
+  nav?: HeaderNavItem[];
+  /**
+   * Opt-in announcement bar above the header. Text is escaped.
+   * Optional `link` must be https or same-origin.
+   */
+  announcement?: ThemeAnnouncement;
   /** Footer configuration */
   footer?: ThemeFooter;
   /** Social links configuration */
@@ -192,12 +316,18 @@ interface ThemeConfig {
  */
 interface ResolvedThemeConfig {
   name: string;
+  viewTransitions: boolean;
+  aside: boolean;
+  breadcrumbs: boolean;
+  headingPermalink: "hover" | "always";
   colors: ThemeColors;
   darkColors: ThemeColors;
   fonts: ThemeFonts;
   entryPage: ThemeEntryPage;
   layout: ThemeLayout;
   header: ThemeHeader;
+  nav?: HeaderNavItem[];
+  announcement?: ThemeAnnouncement;
   footer: ThemeFooter;
   socialLinks: SocialLinks;
   sidebar: SidebarItem[];
@@ -257,6 +387,181 @@ declare function mergeThemes(...themes: (ThemeConfig | ThemeConfig[])[]): ThemeC
  */
 declare function resolveTheme(config?: ThemeConfig | ThemeConfig[]): ResolvedThemeConfig;
 //#endregion
+//#region src/plugins/tabs.d.ts
+/**
+ * Transform Tabs components in HTML.
+ */
+declare function transformTabs(html: string): Promise<string>;
+/**
+ * Generate dynamic CSS for :has() based tab switching.
+ * This is needed because :has() selectors need unique IDs.
+ */
+declare function generateTabsCSS(groupCount: number): string;
+//#endregion
+//#region src/plugins/pm.d.ts
+/**
+ * Package Manager Tabs Plugin
+ *
+ * Transforms <pm>npm install …</pm> blocks into a tab group with one tab per
+ * package manager (npm/pnpm/yarn/bun). The single npm-style command is converted
+ * to each package manager's equivalent natively in Rust (`transformPmEmbeds` in
+ * @ox-content/napi), and the result reuses the same `ox-tabs` widget markup as
+ * the generic `<tabs>` plugin so styling and keyboard navigation are consistent.
+ *
+ * Syncing is opt-in (off by default): when enabled, the rendered group carries a
+ * `data-ox-tab-group="pkg-manager"` attribute so the client runtime can keep
+ * every package-manager group on the page in sync via localStorage.
+ *
+ * Package-manager groups share the tab-group counter with the `<tabs>` plugin so
+ * `data-group` ids (and the CSS produced by `generateTabsCSS`) stay unique.
+ */
+/** Options for {@link transformPm}. */
+interface PmOptions {
+  /**
+   * Enable opt-in synced package-manager tab groups. When `true`, a
+   * `data-ox-tab-group="pkg-manager"` attribute is emitted so the client runtime
+   * syncs the active package manager across every pm group on the page and
+   * persists the choice in localStorage.
+   * @default false
+   */
+  sync?: boolean;
+}
+//#endregion
+//#region src/plugins/youtube.d.ts
+/**
+ * YouTube Plugin - Privacy-enhanced iframe embedding
+ *
+ * Transforms <YouTube> components into responsive iframe embeds using
+ * youtube-nocookie.com for enhanced privacy. A digits-only `start` attribute
+ * becomes `?start=` on the iframe URL.
+ *
+ * The HTML rewrite is performed in Rust (`transformYoutubeEmbeds` in
+ * @ox-content/napi), replacing the previous rehype parse/stringify
+ * round-trip. This module keeps the public TS surface and a cheap marker
+ * check so pages without a `<youtube>` element never cross the NAPI boundary.
+ */
+interface YouTubeOptions {
+  /**
+   * Use privacy-enhanced mode (`youtube-nocookie.com`).
+   * @default true
+   */
+  privacyEnhanced?: boolean;
+  /**
+   * Default iframe aspect ratio.
+   * @default '16/9'
+   */
+  aspectRatio?: string;
+  /**
+   * Allow fullscreen playback.
+   * @default true
+   */
+  allowFullscreen?: boolean;
+  /**
+   * Lazy load the iframe.
+   * @default true
+   */
+  lazyLoad?: boolean;
+}
+/**
+ * Extract YouTube video ID from various URL formats.
+ */
+declare function extractVideoId(input: string): string | null;
+/**
+ * Transform YouTube components in HTML.
+ */
+declare function transformYouTube(html: string, options?: YouTubeOptions): Promise<string>;
+//#endregion
+//#region src/plugins/reddit/types.d.ts
+interface RedditEmbedOptions {
+  /**
+   * Fetch Reddit post metadata at build time.
+   * @default true
+   */
+  fetch?: boolean;
+  /**
+   * Metadata request timeout in milliseconds.
+   * @default 10000
+   */
+  timeout?: number;
+  /**
+   * Cache fetched post metadata in memory for the current process.
+   * @default true
+   */
+  cache?: boolean;
+  /**
+   * Cache TTL in milliseconds. Fresh memory entries skip the network.
+   * @default 3600000
+   */
+  cacheTTL?: number;
+  /**
+   * User agent sent to Reddit's JSON endpoint.
+   * @default 'ox-content-reddit-bot/1.0 (compatible; +https://github.com/ubugeeei-prod/ox-content)'
+   */
+  userAgent?: string;
+}
+interface RedditPostReference {
+  url: string;
+  id?: string;
+  subreddit?: string;
+  slug?: string;
+  shareId?: string;
+  apiUrl?: string;
+}
+interface RedditPostImage {
+  url: string;
+  width?: number;
+  height?: number;
+}
+interface RedditPostData {
+  permalink: string;
+  subreddit: string;
+  title: string;
+  author?: string;
+  body?: string;
+  score?: number;
+  commentCount?: number;
+  createdAt?: string;
+  originalUrl?: string;
+  image?: RedditPostImage;
+}
+//#endregion
+//#region src/plugins/reddit/transform.d.ts
+declare function transformRedditEmbeds(html: string, options?: RedditEmbedOptions): Promise<string>;
+//#endregion
+//#region src/plugins/reddit/url.d.ts
+declare function parseRedditPostReference(value: string): RedditPostReference | null;
+//#endregion
+//#region src/plugins/twitter/types.d.ts
+interface TwitterEmbedOptions {
+  /** Fetch the post body, author, and media from X at build time. */
+  fetch?: boolean;
+  /** Language sent to the syndication endpoint. @default "en" */
+  lang?: string;
+  /** Request timeout in milliseconds. @default 10000 */
+  timeout?: number;
+  /** Cache syndication responses in memory and on disk. @default true */
+  cache?: boolean;
+  /** Directory used for the persistent metadata cache. @default ".cache/ox-content/twitter" */
+  cacheDir?: string;
+  /** Directory where avatars, photos, and videos are written. @default "public/ox-content/twitter" */
+  mediaOutputDir?: string;
+  /** Public URL prefix for downloaded media. @default "/ox-content/twitter" */
+  mediaPublicPath?: string;
+  /** Download MP4 video and animated GIF assets at build time. @default false */
+  downloadVideo?: boolean;
+  /** Maximum video size in bytes. Oversized assets are skipped. @default 8388608 */
+  maxVideoBytes?: number;
+  /** Fetched-card chrome. `"full"` matches sveltweet / react-tweet. @default "compact" */
+  appearance?: TweetAppearance;
+  /**
+   * IANA timezone for full-card timestamps.
+   * Invalid values fall back to UTC so build output stays deterministic.
+   * @default "UTC"
+   */
+  timeZone?: string;
+}
+type TweetAppearance = "compact" | "full";
+//#endregion
 //#region src/plugins/github/types.d.ts
 interface GitHubRepoData {
   name: string;
@@ -282,6 +587,11 @@ interface GitHubSourceRef {
   permalink: string;
   lines?: GitHubLineRange;
 }
+interface GitHubSourceCommit {
+  sha: string;
+  message: string;
+  html_url: string;
+}
 interface GitHubSourceData {
   repo: string;
   ref: string;
@@ -291,6 +601,7 @@ interface GitHubSourceData {
   size: number;
   html_url: string;
   language: string | null;
+  commit?: GitHubSourceCommit;
 }
 interface GitHubOptions {
   /**
@@ -358,31 +669,7 @@ declare function parseGitHubPermalink(value: string): GitHubSourceRef | null;
  */
 declare function transformGitHub(html: string, repoDataMap?: Map<string, GitHubRepoData | null>, options?: GitHubOptions): Promise<string>;
 //#endregion
-//#region src/plugins/twitter/types.d.ts
-interface TwitterEmbedOptions {
-  /** Fetch the post body, author, and media from X at build time. */
-  fetch?: boolean;
-  /** Language sent to the syndication endpoint. @default "en" */
-  lang?: string;
-  /** Request timeout in milliseconds. @default 10000 */
-  timeout?: number;
-  /** Cache syndication responses in memory and on disk. @default true */
-  cache?: boolean;
-  /** Directory used for the persistent metadata cache. @default ".cache/ox-content/twitter" */
-  cacheDir?: string;
-  /** Directory where avatars and photos are written. @default "public/ox-content/twitter" */
-  mediaOutputDir?: string;
-  /** Public URL prefix for downloaded media. @default "/ox-content/twitter" */
-  mediaPublicPath?: string;
-}
-//#endregion
-//#region src/plugins/ogp.d.ts
-/**
- * OGP Card Plugin - Link card embedding
- *
- * Transforms <OgCard> components into static link preview cards
- * by fetching OGP metadata at build time.
- */
+//#region src/plugins/ogp/types.d.ts
 interface OgpData {
   url: string;
   title: string;
@@ -399,142 +686,68 @@ interface OgpOptions {
   timeout?: number;
   /**
    * Cache fetched Open Graph metadata in memory for the current process.
+   * Persistent disk cache also requires this to be enabled.
    * @default true
    */
   cache?: boolean;
   /**
-   * Cache TTL in milliseconds.
+   * Cache TTL in milliseconds. Fresh memory and disk entries skip the network.
    * @default 3600000
    */
   cacheTTL?: number;
+  /**
+   * Persist successful and negative cache entries to disk across builds.
+   * Off by default so existing sites do not write a cache directory.
+   * @default false
+   */
+  persistCache?: boolean;
+  /**
+   * Directory used for the persistent metadata cache when `persistCache` is on.
+   * @default ".cache/ox-content/ogp"
+   */
+  cacheDir?: string;
+  /**
+   * Re-fetch metadata even when a fresh cache entry exists.
+   * @default false
+   */
+  refresh?: boolean;
   /**
    * User agent sent with metadata fetch requests.
    * @default 'ox-content-ogp-bot/1.0 (compatible; +https://github.com/ubugeeei-prod/ox-content)'
    */
   userAgent?: string;
 }
-/**
- * Fetch OGP data for a URL.
- */
-declare function fetchOgpData(url: string, options: Required<OgpOptions>): Promise<OgpData | null>;
-/**
- * Collect all OGP URLs from HTML for pre-fetching.
- */
+//#endregion
+//#region src/plugins/ogp/fetch.d.ts
+declare function fetchOgpData(url: string, options?: OgpOptions): Promise<OgpData | null>;
+//#endregion
+//#region src/plugins/ogp/transform.d.ts
 declare function collectOgpUrls(html: string): Promise<string[]>;
-/**
- * Pre-fetch all OGP data.
- */
 declare function prefetchOgpData(urls: string[], options?: OgpOptions): Promise<Map<string, OgpData | null>>;
-/**
- * Transform OgCard components in HTML.
- */
 declare function transformOgp(html: string, ogpDataMap?: Map<string, OgpData | null>, options?: OgpOptions): Promise<string>;
 //#endregion
-//#region src/plugins/pm.d.ts
+//#region src/plugins/mermaid.d.ts
 /**
- * Package Manager Tabs Plugin
- *
- * Transforms <pm>npm install …</pm> blocks into a tab group with one tab per
- * package manager (npm/pnpm/yarn/bun). The single npm-style command is converted
- * to each package manager's equivalent natively in Rust (`transformPmEmbeds` in
- * @ox-content/napi), and the result reuses the same `ox-tabs` widget markup as
- * the generic `<tabs>` plugin so styling and keyboard navigation are consistent.
- *
- * Syncing is opt-in (off by default): when enabled, the rendered group carries a
- * `data-ox-tab-group="pkg-manager"` attribute so the client runtime can keep
- * every package-manager group on the page in sync via localStorage.
+ * Mermaid Plugin - Native Rust renderer via NAPI
  *
- * Package-manager groups share the tab-group counter with the `<tabs>` plugin so
- * `data-group` ids (and the CSS produced by `generateTabsCSS`) stay unique.
+ * Renders mermaid code blocks to SVG using the native Rust renderer
+ * via NAPI. Delegates to the NAPI `transformMermaid` function which
+ * extracts mermaid code blocks from HTML and renders them using mmdc.
  */
-/** Options for {@link transformPm}. */
-interface PmOptions {
+interface MermaidOptions {
   /**
-   * Enable opt-in synced package-manager tab groups. When `true`, a
-   * `data-ox-tab-group="pkg-manager"` attribute is emitted so the client runtime
-   * syncs the active package manager across every pm group on the page and
-   * persists the choice in localStorage.
-   * @default false
+   * Mermaid theme used by the CLI renderer.
+   * @default 'neutral'
    */
-  sync?: boolean;
+  theme?: "default" | "dark" | "forest" | "neutral" | "base";
 }
-//#endregion
-//#region src/plugins/tabs.d.ts
 /**
- * Transform Tabs components in HTML.
+ * Transforms mermaid code blocks in HTML to rendered SVG diagrams.
+ * Uses the native Rust NAPI transformMermaid function.
  */
-declare function transformTabs(html: string): Promise<string>;
+declare function transformMermaidStatic(html: string, _options?: MermaidOptions): Promise<string>;
 /**
- * Generate dynamic CSS for :has() based tab switching.
- * This is needed because :has() selectors need unique IDs.
- */
-declare function generateTabsCSS(groupCount: number): string;
-//#endregion
-//#region src/plugins/youtube.d.ts
-/**
- * YouTube Plugin - Privacy-enhanced iframe embedding
- *
- * Transforms <YouTube> components into responsive iframe embeds using
- * youtube-nocookie.com for enhanced privacy.
- *
- * The HTML rewrite is performed in Rust (`transformYoutubeEmbeds` in
- * @ox-content/napi), replacing the previous rehype parse/stringify
- * round-trip. This module keeps the public TS surface and a cheap marker
- * check so pages without a `<youtube>` element never cross the NAPI boundary.
- */
-interface YouTubeOptions {
-  /**
-   * Use privacy-enhanced mode (`youtube-nocookie.com`).
-   * @default true
-   */
-  privacyEnhanced?: boolean;
-  /**
-   * Default iframe aspect ratio.
-   * @default '16/9'
-   */
-  aspectRatio?: string;
-  /**
-   * Allow fullscreen playback.
-   * @default true
-   */
-  allowFullscreen?: boolean;
-  /**
-   * Lazy load the iframe.
-   * @default true
-   */
-  lazyLoad?: boolean;
-}
-/**
- * Extract YouTube video ID from various URL formats.
- */
-declare function extractVideoId(input: string): string | null;
-/**
- * Transform YouTube components in HTML.
- */
-declare function transformYouTube(html: string, options?: YouTubeOptions): Promise<string>;
-//#endregion
-//#region src/plugins/mermaid.d.ts
-/**
- * Mermaid Plugin - Native Rust renderer via NAPI
- *
- * Renders mermaid code blocks to SVG using the native Rust renderer
- * via NAPI. Delegates to the NAPI `transformMermaid` function which
- * extracts mermaid code blocks from HTML and renders them using mmdc.
- */
-interface MermaidOptions {
-  /**
-   * Mermaid theme used by the CLI renderer.
-   * @default 'neutral'
-   */
-  theme?: "default" | "dark" | "forest" | "neutral" | "base";
-}
-/**
- * Transforms mermaid code blocks in HTML to rendered SVG diagrams.
- * Uses the native Rust NAPI transformMermaid function.
- */
-declare function transformMermaidStatic(html: string, _options?: MermaidOptions): Promise<string>;
-/**
- * @deprecated No longer used. Mermaid rendering is now done at build time via NAPI.
+ * @deprecated No longer used. Mermaid rendering is now done at build time via NAPI.
  */
 declare const mermaidClientScript = "";
 //#endregion
@@ -558,8 +771,13 @@ interface TransformAllOptions {
   mermaid?: boolean;
   githubToken?: string;
   spotify?: boolean;
+  appleMusic?: boolean;
+  speakerDeck?: boolean;
+  audio?: boolean;
+  video?: boolean;
   stackBlitz?: boolean;
   twitter?: boolean | TwitterEmbedOptions;
+  reddit?: boolean | RedditEmbedOptions;
   bluesky?: boolean;
   webContainer?: boolean;
 }
@@ -583,10 +801,17 @@ interface BasePageProps {
   toc: TocEntry[];
   /** Last git commit timestamp in milliseconds */
   lastUpdated?: number;
+  /** Unique git authors for this page */
+  contributors?: Array<{
+    name: string;
+    avatar?: string;
+  }>;
   /** Source file path (relative to docs root) */
   path: string;
   /** Output URL path */
   url: string;
+  /** Published Markdown companion URL when `ssg.markdownSource` is on */
+  markdownSource?: string;
   /** Raw frontmatter object */
   frontmatter: Record<string, unknown>;
   /** Layout name from frontmatter */
@@ -783,10 +1008,17 @@ interface PageData {
   toc: TocEntry[];
   /** Last git commit timestamp in milliseconds */
   lastUpdated?: number;
+  /** Unique git authors for this page */
+  contributors?: Array<{
+    name: string;
+    avatar?: string;
+  }>;
   /** Source file path */
   path: string;
   /** Output URL path */
   url: string;
+  /** Published Markdown companion URL when `ssg.markdownSource` is on */
+  markdownSource?: string;
   /** Frontmatter */
   frontmatter: Record<string, unknown>;
   /** Layout name */
@@ -993,6 +1225,21 @@ interface SsgOptions {
    * @default '.html'
    */
   extension?: string;
+  /**
+   * Mount generated page routes under this path, independent from `base` and
+   * `outDir`.
+   *
+   * `blog`, `/blog`, and `/blog/` all mount under `/blog`. Page HTML and
+   * page-level assets follow the prefix. Root host files (`_redirects`,
+   * `_headers`, root feeds, sitemap index) stay at `outDir`. `base` remains
+   * the public deployment prefix and is not used as an output mount.
+   * Frontmatter `permalink` still wins when permalinks are enabled.
+   *
+   * Off when omitted.
+   *
+   * @default undefined
+   */
+  routePrefix?: string;
   /**
    * Remove previously generated files from the output directory before writing
    * the new SSG result.
@@ -1098,6 +1345,153 @@ interface SsgOptions {
    * @default false
    */
   lastUpdated?: boolean;
+  /**
+   * List unique git authors for each page.
+   *
+   * Off by default. `true` enables names only. An object enables the
+   * feature and can set `ignore` and `avatars`. Missing `.git` (for
+   * example a published tarball) yields an empty list and does not
+   * fail the build.
+   *
+   * @default false
+   */
+  contributors?: boolean | ContributorsOptions;
+  /**
+   * Show previous/next page links after the article.
+   *
+   * Disabled when omitted or `false`. `true` enables the default pager.
+   * An object also enables the feature.
+   *
+   * @default false
+   */
+  pagination?: boolean | Record<string, unknown>;
+  /**
+   * Show a breadcrumb trail from the site root through sidebar ancestors.
+   *
+   * Disabled when omitted or `false`. `true` enables the default trail.
+   * An object also enables the feature. Frontmatter `breadcrumbs: false`
+   * hides the trail on that page.
+   *
+   * @default false
+   */
+  breadcrumbs?: boolean | Record<string, unknown>;
+  /**
+   * Emit JSON-LD structured data (`TechArticle`, `WebSite`, and optional
+   * `BreadcrumbList`) in the page `<head>`.
+   *
+   * Disabled when omitted or `false`. `true` enables the defaults. An object
+   * enables the feature and can hide BreadcrumbList or supply a publisher.
+   * Publisher fields the site does not set are not invented.
+   *
+   * @default false
+   */
+  jsonLd?: boolean | JsonLdOptions;
+  /**
+   * Validate custom page-head descriptors during SSG.
+   *
+   * `false` / omitted drops invalid values silently. `warn` logs them.
+   * `strict` fails the build on unsafe URLs or invalid hreflang.
+   *
+   * @default false
+   */
+  headValidation?: false | "warn" | "strict";
+  /**
+   * Opt-in copy buttons, outbound-link icons, and a back-to-top control.
+   *
+   * Disabled when omitted or `false`. `true` enables all three with defaults.
+   * An object enables the feature and can turn one control off, for example
+   * `{ copy: false }`.
+   *
+   * @default false
+   */
+  readerChrome?: boolean | ReaderChromeOptions;
+  /**
+   * Show a header locale switcher in the default theme.
+   *
+   * Disabled when omitted or `false`, even if `i18n.locales` is set.
+   * `true` or an object enables the control when available locales are
+   * non-empty. Links use the sibling page when it exists, otherwise the
+   * locale root (`/{locale}/` or a configured root).
+   *
+   * @default false
+   */
+  localeSwitcher?: boolean | Record<string, unknown>;
+  /**
+   * Opt-in skip link and print styles.
+   *
+   * Disabled when omitted or `false`. `true` enables the default skip link
+   * and print CSS. An object enables the feature and can override the label.
+   *
+   * @default false
+   */
+  a11y?: boolean | A11yOptions;
+  /**
+   * Honor per-page frontmatter chrome flags (`sidebar`, `outline` / `aside`,
+   * `footer`, `navbar`, `lastUpdated`, `editLink`).
+   *
+   * Disabled when omitted or `false`. `true` or `{}` enables the defaults:
+   * omitted flags keep current chrome, and `false` hides that region.
+   *
+   * @default false
+   */
+  pageChrome?: boolean | Record<string, unknown>;
+  /**
+   * Publish the original Markdown beside each generated HTML page.
+   *
+   * Off by default. `true` writes a `.md` companion using the published URL
+   * (permalink, locale, base, and output directory) and adds
+   * `<link rel="alternate" type="text/markdown">`. An object enables the
+   * feature and can turn the alternate link off, or opt in to the default
+   * theme's Copy as Markdown control.
+   *
+   * The companion is a byte-for-byte copy of the source file, including
+   * frontmatter. Draft and unlisted pages are never written.
+   *
+   * @default false
+   */
+  markdownSource?: boolean | MarkdownSourceOptions;
+  /**
+   * Write a themed 404 page during SSG.
+   *
+   * Off by default. `true` reads `404.md` from `srcDir` and writes `404.html`.
+   * An object enables the feature and overrides only the fields you set.
+   * When the source file is missing, a built-in "Page not found" page is
+   * written instead. The page is omitted from the search index and sitemap.
+   *
+   * @default false
+   */
+  notFound?: boolean | NotFoundOptions;
+  /**
+   * Render a static members card grid on pages with `layout: team`.
+   *
+   * Off by default. `true` enables an empty list. An object enables the
+   * feature and supplies `members`. When the option is off, `layout: team`
+   * is ignored and the page stays ordinary.
+   *
+   * @default false
+   */
+  team?: boolean | TeamOptions;
+  /**
+   * Opt-in blog index, authors, tags, reading time, and archive.
+   *
+   * Off by default. `true` enables defaults. An object enables the feature
+   * and overrides only the fields you set. Top-level `blog` wins when both
+   * are set.
+   *
+   * @default false
+   */
+  blog?: boolean | BlogOptions;
+  /**
+   * Generate a static index for directories that have child pages but no
+   * `index.md` / `index.mdx`.
+   *
+   * Off by default. `true` enables card listings. An object enables the
+   * feature and can switch the listing to `list`. Existing content indexes
+   * are never overwritten.
+   *
+   * @default false
+   */
+  sectionIndex?: boolean | SectionIndexOptions;
   /**
    * Absolute site URL used when generating social metadata.
    *
@@ -1139,12 +1533,120 @@ interface SsgOptions {
    */
   navigation?: SsgNavigationGroup[];
 }
+/**
+ * Per-control flags for `ssg.readerChrome`.
+ *
+ * Omitted fields stay on when the feature itself is enabled.
+ */
+interface ReaderChromeOptions {
+  /**
+   * Copy button on fenced code blocks. The clipboard is read in the browser,
+   * never at build time.
+   *
+   * @default true
+   */
+  copy?: boolean;
+  /**
+   * Icon and `rel="noopener noreferrer"` on outbound `http(s)` links.
+   * Relative, hash, and same-document links are left alone.
+   *
+   * @default true
+   */
+  externalLinks?: boolean;
+  /**
+   * Back-to-top control that appears after the page is scrolled.
+   *
+   * @default true
+   */
+  backToTop?: boolean;
+}
+/**
+ * Resolved reader chrome. `false` means no extra markup or JS.
+ */
+type ResolvedReaderChrome = false | {
+  copy: boolean;
+  externalLinks: boolean;
+  backToTop: boolean;
+};
+/**
+ * Per-control flags for `ssg.a11y`.
+ *
+ * Omitted fields keep the defaults when the feature itself is enabled.
+ */
+interface A11yOptions {
+  /**
+   * Visible label for the skip link. Escaped in HTML.
+   *
+   * @default "Skip to content"
+   */
+  skipLinkLabel?: string;
+}
+/**
+ * Resolved skip-link / print styles. `false` means no extra markup or CSS.
+ */
+type ResolvedA11y = false | {
+  skipLinkLabel: string;
+};
+/**
+ * Per-control flags for `ssg.jsonLd`.
+ *
+ * Omitted fields keep the defaults when the feature itself is enabled.
+ */
+interface JsonLdOptions {
+  /**
+   * Emit `BreadcrumbList` when a visible breadcrumb trail exists.
+   *
+   * @default true
+   */
+  breadcrumbs?: boolean;
+  /**
+   * Optional publisher. Only configured `name` / `url` are written.
+   * Logo and other Organization fields are never invented.
+   */
+  publisher?: JsonLdPublisherOptions;
+  /**
+   * Page `@type`. Defaults to `TechArticle`.
+   */
+  type?: JsonLdPageType;
+  /**
+   * Extra `@graph` nodes. Only objects are kept. The build does not invent
+   * fields inside them.
+   */
+  graph?: Record<string, unknown>[];
+}
+/** JSON-LD page node `@type`. Unknown values fall back to `TechArticle`. */
+type JsonLdPageType = "TechArticle" | "BlogPosting" | "WebPage";
+/**
+ * Optional JSON-LD publisher. Empty or omitted fields are left out.
+ */
+interface JsonLdPublisherOptions {
+  /** Organization name. */
+  name?: string;
+  /** Organization URL. `javascript:` and other unsafe schemes are dropped. */
+  url?: string;
+}
+/**
+ * Resolved JSON-LD options. `false` means no `<script type="application/ld+json">`.
+ */
+type ResolvedJsonLd = false | {
+  breadcrumbs: boolean;
+  publisher?: {
+    name?: string;
+    url?: string;
+  };
+  type?: JsonLdPageType;
+  graph?: Record<string, unknown>[];
+};
 /**
  * Resolved SSG options.
  */
 interface ResolvedSsgOptions {
   enabled: boolean;
   extension: string;
+  /**
+   * Present after `resolveSsgOptions`. Omitted / empty means off.
+   */
+  routePrefix?: string;
   clean: boolean;
   bare: boolean;
   render?: ThemeComponent;
@@ -1156,538 +1658,2225 @@ interface ResolvedSsgOptions {
   ogImage?: string;
   generateOgImage: boolean;
   lastUpdated: boolean;
-  siteUrl?: string;
-  theme?: ResolvedThemeConfig;
-  navigation?: SsgNavigationGroup[];
-}
-/**
- * Options for the core `oxContent()` Vite plugin.
- *
- * The top-level options describe where content lives, which Markdown features
- * are enabled, and which build-time features should run. Feature toggles that
- * accept `boolean | Options` follow the same convention:
- *
- * - `false` disables the feature.
- * - `true` enables the feature with its documented defaults.
- * - an object enables the feature and overrides only the provided fields.
- */
-interface OxContentOptions {
-  /**
-   * Directory containing Markdown source files.
-   *
-   * The path is resolved from the Vite project root. SSG, search indexing, and
-   * dev-server routing all use this directory as the content root.
-   *
-   * @default 'content'
-   */
-  srcDir?: string;
   /**
-   * Directory where generated files are written.
-   *
-   * SSG HTML, search indexes, and generated assets are emitted under this
-   * directory during production builds.
-   *
-   * @default 'dist'
+   * Present after `resolveSsgOptions`. Omitted in hand-built fixtures means off.
    */
-  outDir?: string;
+  contributors?: ResolvedContributors;
+  pagination: boolean;
+  breadcrumbs: boolean;
+  jsonLd: ResolvedJsonLd;
   /**
-   * Base path prepended to generated internal URLs.
-   *
-   * Use this when the site is deployed below a sub-path, such as GitHub Pages or
-   * a documentation route inside a larger application.
-   *
-   * @default '/'
+   * Present after `resolveSsgOptions`. Omitted / `false` means off.
    */
-  base?: string;
+  headValidation?: false | "warn" | "strict";
+  readerChrome: ResolvedReaderChrome;
+  localeSwitcher: boolean;
+  a11y: ResolvedA11y;
+  pageChrome: boolean;
   /**
-   * Markdown-like file extensions to process.
-   *
-   * Extensions are normalized with a leading dot and matched case-insensitively.
-   * Add custom extensions when another authoring format is compiled to Markdown
-   * before ox-content sees it.
-   *
-   * @default ['.md', '.markdown', '.mdx']
+   * Present after `resolveSsgOptions`. Omitted in hand-built fixtures means off.
    */
-  extensions?: string[];
+  markdownSource?: ResolvedMarkdownSourceOptions;
   /**
-   * Static Site Generation options.
-   *
-   * Passing `true` or omitting this option enables SSG with defaults. Passing
-   * `false` disables the SSG plugin while still allowing Markdown module
-   * transforms to run.
-   *
-   * @default { enabled: true }
+   * Present after `resolveSsgOptions`. Omitted in hand-built fixtures means off.
    */
-  ssg?: SsgOptions | boolean;
+  notFound?: ResolvedNotFoundOptions;
   /**
-   * Enable GitHub Flavored Markdown extensions.
-   * @default true
+   * Present after `resolveSsgOptions`. Omitted in hand-built fixtures means off.
    */
-  gfm?: boolean;
+  team?: ResolvedTeamOptions;
   /**
-   * Enable footnotes.
-   * @default true
+   * Present after `resolveSsgOptions`. Omitted in hand-built fixtures means off.
    */
-  footnotes?: boolean;
+  blog?: ResolvedBlogOptions;
+  sectionIndex?: ResolvedSectionIndexOptions;
+  siteUrl?: string;
+  theme?: ResolvedThemeConfig;
+  navigation?: SsgNavigationGroup[];
+}
+/**
+ * Opt-in custom 404 page written during SSG.
+ */
+interface NotFoundOptions {
   /**
-   * Enable tables.
-   * @default true
+   * Markdown source relative to `srcDir`.
+   * @default "404.md"
    */
-  tables?: boolean;
+  source?: string;
   /**
-   * Enable task lists.
-   * @default true
+   * Output file relative to `outDir`.
+   * @default "404.html"
    */
-  taskLists?: boolean;
+  output?: string;
+}
+/**
+ * Resolved custom 404 options.
+ */
+interface ResolvedNotFoundOptions {
+  enabled: boolean;
+  source: string;
+  output: string;
+}
+/**
+ * One link on a team member card.
+ */
+interface TeamLink {
+  /** Visible label. Escaped in HTML. */
+  label: string;
+  /** Destination. Only `https:` or a site-relative `/` path is emitted. */
+  href: string;
+}
+/**
+ * One person on the team page.
+ */
+interface TeamMember {
+  /** Display name. Escaped in HTML. */
+  name: string;
+  /** Optional role or title. Escaped in HTML. */
+  role?: string;
+  /** Avatar URL. Only `https:` or a site-relative `/` path is emitted. */
+  avatar?: string;
+  /** Optional profile or social links. */
+  links?: TeamLink[];
+}
+/**
+ * Opt-in team / members page.
+ */
+/**
+ * Opt-in git contributor list.
+ */
+interface ContributorsOptions {
   /**
-   * Enable strikethrough.
-   * @default true
+   * Author names or emails to omit. Comparison is case-insensitive and
+   * matches the full name or the full email.
    */
-  strikethrough?: boolean;
+  ignore?: string[];
   /**
-   * Enable GFM autolinks and linkify bare URLs.
-   * @default true
+   * When true and a git author email is present, render a Gravatar
+   * image from the MD5 of that email. The raw email is never written
+   * into HTML. Default is names only.
    */
-  autolinks?: boolean;
+  avatars?: boolean;
+}
+/**
+ * Resolved git contributor list. `false` means the feature is off.
+ */
+type ResolvedContributors = false | {
+  ignore: string[];
+  avatars: boolean;
+};
+interface TeamOptions {
   /**
-   * Enable syntax highlighting for code blocks.
-   * @default false
+   * People rendered as static cards on `layout: team` pages.
+   * @default []
    */
-  highlight?: boolean;
+  members?: TeamMember[];
+}
+/**
+ * Resolved team page options.
+ */
+interface ResolvedTeamOptions {
+  enabled: boolean;
+  members: TeamMember[];
+}
+/**
+ * Listing style for a generated section index.
+ */
+type SectionIndexStyle = "list" | "cards";
+/**
+ * Opt-in generated section index pages.
+ */
+interface SectionIndexOptions {
   /**
-   * Syntax highlighting theme.
-   *
-   * Defaults to `'css-variables'`, which renders token colors as `--octc-shiki-*`
-   * custom properties so highlighting follows the active color scheme in both
-   * light and dark from one build. Without a `@ox-content/theme-color-*`
-   * package installed the properties fall back to GitHub Dark. Pass any bundled
-   * Shiki theme name to opt out and bake fixed colors in instead.
-   *
-   * @default 'css-variables'
+   * How children are rendered. `cards` is the default when the feature is on.
+   * @default "cards"
    */
-  highlightTheme?: string | ThemeRegistration$1;
+  style?: SectionIndexStyle;
+}
+/**
+ * Resolved generated section index options.
+ */
+interface ResolvedSectionIndexOptions {
+  enabled: boolean;
+  style: SectionIndexStyle;
+}
+/**
+ * Opt-in web app manifest and service worker written during SSG.
+ *
+ * Enabling `offline` (the default when the feature is on) injects a tiny
+ * client script that registers `sw.js`. Set `offline: false` to keep the
+ * manifest without that script.
+ */
+interface PwaOptions {
   /**
-   * Additional languages for syntax highlighting.
-   * Accepts Shiki LanguageRegistration objects (e.g., TextMate grammars).
-   * These are loaded alongside the built-in languages.
-   * @default []
+   * Write `sw.js` and register it from themed pages.
+   * @default true
    */
-  highlightLangs?: LanguageRegistration$1[];
+  offline?: boolean;
   /**
-   * Code block line annotations for fenced code blocks.
-   *
-   * This feature is opt-in because it changes rendered code-block markup. Pass
-   * `true` to enable ox-content's attribute syntax, or pass an options object to
-   * change the meta key or enable VitePress-compatible notation.
-   *
-   * @example
-   * ~~~md
-   * ```ts annotate="highlight:1,3-4;warning:6;error:7"
-   * const value = compute()
-   * ```
-   * ~~~
-   *
-   * @default false
+   * Manifest `name`. Falls back to `ssg.siteName` when omitted.
    */
-  codeAnnotations?: boolean | CodeAnnotationsOptions;
+  name?: string;
   /**
-   * Expand Obsidian-style `[[page]]` and `[[page|label]]` links.
-   *
-   * Use this for knowledge-base style content where authors prefer short,
-   * document-relative link syntax. Pass an object to override the base URL used
-   * when resolving generated hrefs.
-   *
-   * @default false
+   * Manifest `short_name`. Falls back to `name` when omitted.
    */
-  wikiLinks?: boolean | WikiLinkOptions;
+  shortName?: string;
   /**
-   * Expand `:shortcode:` emoji aliases to Unicode.
-   *
-   * Built-in aliases cover common emoji names. Provide `custom` entries for
-   * project-specific aliases or to override a built-in mapping.
-   *
-   * @default false
+   * Manifest / meta theme color. Hex (`#rgb` / `#rrggbb`) or a CSS color name.
+   * @default "#000000"
    */
-  emojiShortcodes?: boolean | EmojiShortcodeOptions;
+  themeColor?: string;
   /**
-   * Enable markdown-it-attrs style `{#id .class key=value}` attributes.
-   *
-   * Attribute blocks can be attached to headings, paragraphs, links, images, and
-   * other supported Markdown nodes depending on parser context.
-   *
-   * @default false
+   * Manifest background color. Hex or a CSS color name.
+   * @default "#ffffff"
    */
-  attrs?: boolean | AttrsOptions;
+  backgroundColor?: string;
   /**
-   * Import source snippets into fences with `<<< @/path/to/file.ts{region}`.
-   *
-   * This is useful for documentation that must stay synchronized with examples
-   * in the repository. Use `rootDir` when snippets should resolve from a
-   * directory other than the Vite project root.
-   *
-   * @default false
+   * Manifest `start_url`. Same-origin site paths only (`/`, `/docs/`).
+   * Defaults to the Vite `base`.
    */
-  codeImports?: boolean | CodeImportOptions;
+  startUrl?: string;
+}
+/**
+ * Resolved PWA options.
+ */
+interface ResolvedPwaOptions {
+  enabled: boolean;
+  offline: boolean;
+  name?: string;
+  shortName?: string;
+  themeColor?: string;
+  backgroundColor?: string;
+  startUrl?: string;
+}
+/**
+ * Opt-in self-hosted Iconify CSS for used icons.
+ *
+ * Off by default. When enabled, the SSG build resolves Iconify names from
+ * installed `@iconify/json` or `@iconify-json/*` packages and emits CSS
+ * masks so the published site does not request `api.iconify.design`.
+ */
+interface IconsOptions {
   /**
-   * Sanitize rendered HTML with safe defaults or explicit allow lists.
-   *
-   * Enable this for untrusted Markdown. The default allow lists are conservative;
-   * pass an options object only when the content model intentionally needs extra
-   * tags, attributes, or URL schemes.
-   *
-   * @default false
+   * CSS emission mode.
+   * @default "css-mask"
    */
-  sanitize?: boolean | SanitizeOptions;
+  mode?: "css-mask";
   /**
-   * Append an "edit this page" link to rendered Markdown.
-   *
-   * The feature is enabled only when `repoUrl` is provided in the options object.
-   * Passing `true` keeps the feature disabled because there is not enough
-   * repository information to generate valid links.
-   *
-   * @default false
+   * Class syntax. `"unocss"` emits `icon-[prefix--name]`.
+   * @default "unocss"
    */
-  editThisPage?: boolean | EditThisPageOptions;
+  syntax?: "unocss";
   /**
-   * Recognize emphasis adjacent to CJK text. The native parser already supports
-   * this behavior; the option documents the compatibility contract.
-   * @default false
+   * Glob patterns to scan, or explicit `prefix:name` icons.
+   * Entries that look like Iconify names are used as-is (no scan).
    */
-  cjkEmphasis?: boolean;
+  include?: string[];
   /**
-   * Lint fenced code blocks during Markdown transforms.
-   *
-   * Use this as a lightweight authoring check for missing languages or trailing
-   * whitespace inside fences. For project-wide linting, prefer the exported
-   * `lintCodeBlocks()` helper or the Markdown lint APIs.
-   *
-   * @default false
+   * Iconify names that are always emitted, even when no source mentions them.
    */
-  codeBlockLint?: boolean | CodeBlockLintOptions;
+  safelist?: string[];
+}
+/**
+ * Resolved icon asset options.
+ */
+interface ResolvedIconsOptions {
+  enabled: boolean;
+  mode: "css-mask";
+  syntax: "unocss";
+  include: string[];
+  safelist: string[];
+}
+/**
+ * Opt-in Markdown source companions written beside generated HTML.
+ */
+interface MarkdownSourceOptions {
   /**
-   * Type-check TypeScript/TSX code fences via tsgo.
-   *
-   * By default only fences with explicit opt-in metadata are checked. This keeps
-   * incidental examples cheap while allowing docs-as-code snippets to fail the
-   * build when configured with `mode: 'error'`.
-   *
-   * @default false
+   * Add `<link rel="alternate" type="text/markdown">` to generated HTML.
+   * @default true
    */
-  codeBlockTypecheck?: boolean | CodeBlockTypecheckOptions;
+  alternate?: boolean;
   /**
-   * Extract runnable fenced examples for Vitest docs-as-tests harnesses.
-   *
-   * Collected examples can be written by the docs test helpers and executed as
-   * part of a normal Vitest suite.
-   *
+   * Show a page-level Copy as Markdown control in the default theme.
+   * The control copies or opens the published companion bytes, including
+   * frontmatter. Off unless set, even when companions are enabled.
    * @default false
    */
-  docsTests?: boolean | DocsTestOptions;
+  copy?: boolean;
+}
+/**
+ * Resolved Markdown source-companion options.
+ */
+interface ResolvedMarkdownSourceOptions {
+  enabled: boolean;
+  alternate: boolean;
+  copy: boolean;
+}
+/**
+ * Opt-in crawl manifests written during SSG.
+ */
+interface SiteMapsOptions {
   /**
-   * Enable mermaid diagram rendering.
-   * @default false
+   * Write `robots.txt` with a Sitemap line.
+   * @default true
    */
-  mermaid?: boolean;
+  robots?: boolean;
   /**
-   * Parse YAML frontmatter.
+   * Write `llms.txt` with the site title, description, and page URLs.
    * @default true
    */
-  frontmatter?: boolean;
+  llms?: boolean;
+}
+/**
+ * Resolved crawl-manifest options.
+ */
+interface ResolvedSiteMapsOptions {
+  enabled: boolean;
+  robots: boolean;
+  llms: boolean;
+}
+/**
+ * Opt-in draft / unlisted / scheduled page filtering.
+ */
+interface PublishStateOptions {
   /**
-   * Generate table of contents.
-   * @default true
+   * When `false`, frontmatter publish fields are ignored.
+   * @default true when the option is an object
    */
-  toc?: boolean;
+  enabled?: boolean;
   /**
-   * Maximum heading depth for TOC.
-   * @default 3
+   * Injected ISO-8601 clock compared against `scheduled`, `date`, and `expiry`.
+   * Invalid values fall back to the system clock.
    */
-  tocMaxDepth?: number;
+  now?: string;
   /**
-   * Enable OG image generation.
+   * Keep draft and not-yet-scheduled pages in output. The dev server sets this.
    * @default false
    */
-  ogImage?: boolean;
+  includeDrafts?: boolean;
+}
+/**
+ * Resolved publish-state options.
+ */
+interface ResolvedPublishStateOptions {
+  enabled: boolean;
+  now?: string;
+  includeDrafts: boolean;
+}
+/**
+ * Opt-in frontmatter `permalink` / `slug` routing.
+ *
+ * `false` or omitted stays off. `true` or `{}` enables defaults.
+ * Set `enabled: false` on the object to turn the feature back off.
+ */
+interface PermalinksOptions {
   /**
-   * OG image generation options.
-   * Ignored unless `ogImage` or `ssg.generateOgImage` is enabled.
-   * @default { vuePlugin: 'vitejs', width: 1200, height: 630, cache: true, concurrency: 1 }
+   * Enable permalink / slug routing.
+   * @default true
    */
-  ogImageOptions?: OgImageOptions;
+  enabled?: boolean;
+}
+/**
+ * Resolved permalink options.
+ */
+interface ResolvedPermalinksOptions {
+  enabled: boolean;
+}
+/**
+ * Opt-in `_index` directory frontmatter cascade.
+ *
+ * `false` or omitted stays off. `true` or `{}` enables defaults.
+ * Set `enabled: false` on the object to turn the feature back off.
+ */
+interface CascadeOptions {
   /**
-   * Custom AST transformers.
-   * Transformers run after parsing and before the final JavaScript module is emitted.
-   * @default []
+   * Enable directory-level frontmatter inheritance.
+   * @default true
    */
-  transformers?: MarkdownTransformer[];
+  enabled?: boolean;
+}
+/**
+ * Resolved cascade options.
+ */
+interface ResolvedCascadeOptions {
+  enabled: boolean;
+}
+/**
+ * Host that consumes the generated `_redirects` file.
+ *
+ * Both values write the same `_redirects` body today. The distinct names
+ * leave room for provider-specific limits and diagnostics later.
+ */
+type RedirectProvider = "netlify" | "cloudflare";
+/**
+ * Opt-in static redirects, aliases, and path rewrites.
+ *
+ * A path map such as `{ "/old-guide": "/guide" }` is also accepted in place
+ * of this object and enables the feature with that map.
+ */
+interface RedirectsOptions {
   /**
-   * Source documentation generation options.
-   * Set to false to disable (opt-out).
-   * @default { enabled: true }
+   * Old path to new path. Destinations must be same-origin (`/` but not `//`)
+   * unless `allowExternal` is set.
+   * @default {}
    */
-  docs?: DocsOptions | false;
+  map?: Record<string, string>;
   /**
-   * Full-text search options.
-   * Set to false to disable search.
-   * @default { enabled: true }
+   * Host that should receive a `_redirects` file.
+   *
+   * Omit the field to detect `CF_PAGES=1`, `WORKERS_CI=1`, or `NETLIFY=true`.
+   * Local builds and GitHub Actions should set this explicitly. HTML redirect
+   * pages are independent of this selector.
    */
-  search?: SearchOptions | boolean;
+  provider?: RedirectProvider;
   /**
-   * Markdown collection query options.
-   *
-   * Collections are exposed through `virtual:ox-content/collections`. The
+   * Write a `_headers` Location map next to the HTML pages.
+   * @default false
+   */
+  headers?: boolean;
+  /**
+   * Write a machine-readable `redirects.json` map.
+   * @default false
+   */
+  json?: boolean;
+  /**
+   * Allow `http://` and `https://` destinations. `javascript:`, `data:`, and
+   * protocol-relative `//` targets stay rejected.
+   * @default false
+   */
+  allowExternal?: boolean;
+}
+/**
+ * Resolved redirect options.
+ */
+interface ResolvedRedirectsOptions {
+  enabled: boolean;
+  map: Record<string, string>;
+  provider?: RedirectProvider;
+  headers: boolean;
+  json: boolean;
+  allowExternal: boolean;
+}
+/**
+ * Feed file formats written during SSG.
+ */
+type FeedFormat = "rss" | "atom" | "json";
+/**
+ * One feed's formats, source, output path, and channel metadata.
+ */
+interface FeedChannelOptions {
+  /**
+   * Feed formats to write.
+   * @default ["rss", "atom", "json"]
+   */
+  formats?: readonly FeedFormat[];
+  /**
+   * Named collection to publish. Defaults to `content`, or the first
+   * configured collection when `content` is absent.
+   */
+  collection?: string;
+  /**
+   * Maximum number of published items, newest first.
+   * @default 20
+   */
+  limit?: number;
+  /**
+   * Site-relative directory for the generated files.
+   * @default "/"
+   */
+  path?: string;
+  /** Channel title. Defaults to the SSG site name. */
+  title?: string;
+  /** Channel description. Defaults to the SSG site description. */
+  description?: string;
+  /** Channel language (`en`, `ja`, …). Omitted when unset. */
+  language?: string;
+  /** Channel image URL (RSS image / Atom logo / JSON Feed icon). */
+  image?: string;
+  /** Favicon URL (Atom icon / JSON Feed favicon). */
+  favicon?: string;
+  /** Copyright / rights notice. Omitted from JSON Feed. */
+  copyright?: string;
+}
+/**
+ * Opt-in RSS / Atom / JSON Feed files written during SSG.
+ *
+ * A single object is one default feed. A named record or array writes
+ * multiple feeds with their own paths and channel metadata.
+ */
+type FeedsOptions = FeedChannelOptions | readonly FeedChannelOptions[] | {
+  [name: string]: FeedChannelOptions;
+};
+/**
+ * One resolved feed channel.
+ */
+interface ResolvedFeedChannel {
+  name?: string;
+  formats: readonly FeedFormat[];
+  collection?: string;
+  limit: number;
+  path: string;
+  title?: string;
+  description?: string;
+  language?: string;
+  image?: string;
+  favicon?: string;
+  copyright?: string;
+}
+/**
+ * Resolved feed options.
+ *
+ * Legacy `true` / single-object configs keep one channel on the top-level
+ * fields. A named record or array also sets `feeds` to every channel.
+ */
+interface ResolvedFeedsOptions extends ResolvedFeedChannel {
+  enabled: boolean;
+  feeds?: ResolvedFeedChannel[];
+}
+/**
+ * One person in the `blog.authors` map.
+ */
+interface BlogAuthor {
+  /** Display name. Escaped in HTML. */
+  name: string;
+  /** Optional short bio. Escaped in HTML. */
+  bio?: string;
+  /** Profile URL. Only `https:` or a site-relative `/` path is emitted. */
+  url?: string;
+}
+/**
+ * Opt-in blog index, authors, tags, reading time, and archive.
+ */
+interface BlogOptions {
+  /**
+   * Named collection of posts. Defaults to a collection named `blog`, or
+   * the only configured collection. Required when several collections exist
+   * and none is named `blog`.
+   */
+  collection?: string;
+  /**
+   * Author records keyed by the frontmatter `author` / `authors` value.
+   * @default {}
+   */
+  authors?: Record<string, BlogAuthor>;
+  /**
+   * Posts per index page, newest first.
+   * @default 10
+   */
+  pageSize?: number;
+  /**
+   * External RSS / Atom sources merged into the blog index at build time.
+   * Empty / omitted fetches nothing. Only these URLs are requested.
+   * @default []
+   */
+  feeds?: Array<string | BlogFeedSource>;
+}
+/**
+ * One configured external blog feed.
+ */
+interface BlogFeedSource {
+  /** Absolute `https:` feed URL. */
+  url: string;
+  /** Default language applied when an item omits one. */
+  language?: string;
+  /** Default author applied when an item omits one. */
+  author?: string;
+  /**
+   * Failed fetch / parse handling for this source.
+   * `warn` skips the source. `error` fails the build after other sources run.
+   * @default "warn"
+   */
+  onError?: BlogFeedFailurePolicy;
+}
+/** How a failed external feed source is reported. */
+type BlogFeedFailurePolicy = "warn" | "error";
+/**
+ * Resolved blog options.
+ */
+interface ResolvedBlogOptions {
+  enabled: boolean;
+  collection?: string;
+  authors: Record<string, BlogAuthor>;
+  pageSize: number;
+  feeds: ResolvedBlogFeedSource[];
+}
+/**
+ * Resolved external blog feed source.
+ */
+interface ResolvedBlogFeedSource {
+  url: string;
+  language?: string;
+  author?: string;
+  onError: BlogFeedFailurePolicy;
+}
+/**
+ * Opt-in term list pages, per-term pages, and related-page lists.
+ */
+interface TaxonomiesOptions {
+  /**
+   * Frontmatter keys (and URL prefixes) to read terms from.
+   * @default ["tags", "categories"]
+   */
+  taxonomies?: string[];
+  /**
+   * Maximum related pages injected into a source page.
+   * @default 5
+   */
+  relatedLimit?: number;
+}
+/**
+ * Resolved taxonomy options.
+ */
+interface ResolvedTaxonomiesOptions {
+  enabled: boolean;
+  taxonomies: string[];
+  relatedLimit: number;
+}
+/** Banner shown on pages that belong to one documented version. */
+type VersionBannerKind = "unreleased" | "unmaintained";
+/**
+ * One published or snapshot version of a docs tree.
+ */
+interface VersionEntry {
+  /** Stable id used as `versions.current`. */
+  id: string;
+  /** Header label. Escaped before it is rendered. */
+  label: string;
+  /**
+   * URL prefix without slashes (`"2.90"`, `"next"`). Empty string is the
+   * site root.
+   */
+  prefix: string;
+  /**
+   * Snapshot directory relative to the Vite root. Omitted entries use the
+   * live `srcDir` and are not copied. Historical dirs are read-only.
+   */
+  dir?: string;
+  /** Optional status banner for pages in this version. */
+  banner?: VersionBannerKind | false;
+}
+/**
+ * Opt-in documentation versioning.
+ *
+ * Off by default. `true` enables a single current entry. An object enables
+ * the feature and overrides only the fields you set.
+ */
+interface VersionsOptions {
+  /** Id of the live tree being built from `srcDir`. */
+  current?: string;
+  /** Render the header version dropdown. @default true */
+  switcher?: boolean;
+  /** Show unreleased / unmaintained badges in the dropdown. @default true */
+  badge?: boolean;
+  /** Declared versions. Historical snapshots must set `dir`. */
+  entries?: VersionEntry[];
+}
+/**
+ * Resolved documentation versioning.
+ */
+interface ResolvedVersionsOptions {
+  enabled: boolean;
+  current: string;
+  switcher: boolean;
+  badge: boolean;
+  entries: ResolvedVersionEntry[];
+}
+/**
+ * One resolved version after prefix and banner sanitization.
+ */
+interface ResolvedVersionEntry {
+  id: string;
+  label: string;
+  prefix: string;
+  dir?: string;
+  banner: VersionBannerKind | false;
+}
+/**
+ * Options for the core `oxContent()` Vite plugin.
+ *
+ * The top-level options describe where content lives, which Markdown features
+ * are enabled, and which build-time features should run. Feature toggles that
+ * accept `boolean | Options` follow the same convention:
+ *
+ * - `false` disables the feature.
+ * - `true` enables the feature with its documented defaults.
+ * - an object enables the feature and overrides only the provided fields.
+ */
+interface OxContentOptions {
+  /**
+   * Directory containing Markdown source files.
+   *
+   * The path is resolved from the Vite project root. SSG, search indexing, and
+   * dev-server routing all use this directory as the content root.
+   *
+   * @default 'content'
+   */
+  srcDir?: string;
+  /**
+   * Directory where generated files are written.
+   *
+   * SSG HTML, search indexes, and generated assets are emitted under this
+   * directory during production builds.
+   *
+   * @default 'dist'
+   */
+  outDir?: string;
+  /**
+   * Base path prepended to generated internal URLs.
+   *
+   * Use this when the site is deployed below a sub-path, such as GitHub Pages or
+   * a documentation route inside a larger application.
+   *
+   * @default '/'
+   */
+  base?: string;
+  /**
+   * Markdown-like file extensions to process.
+   *
+   * Extensions are normalized with a leading dot and matched case-insensitively.
+   * Add custom extensions when another authoring format is compiled to Markdown
+   * before ox-content sees it.
+   *
+   * @default ['.md', '.markdown', '.mdx']
+   */
+  extensions?: string[];
+  /**
+   * Static Site Generation options.
+   *
+   * Passing `true` or omitting this option enables SSG with defaults. Passing
+   * `false` disables the SSG plugin while still allowing Markdown module
+   * transforms to run.
+   *
+   * @default { enabled: true }
+   */
+  ssg?: SsgOptions | boolean;
+  /**
+   * Write crawl manifests next to generated HTML.
+   *
+   * Off by default. `true` writes `sitemap.xml`, `robots.txt`, and `llms.txt`.
+   * An object enables the feature and overrides only the fields you set.
+   * Requires `ssg.siteUrl`. When that is missing the build continues and a
+   * warning is emitted instead of writing files.
+   *
+   * @default false
+   */
+  siteMaps?: boolean | SiteMapsOptions;
+  /**
+   * Honor frontmatter draft / unlisted / scheduled publish states.
+   *
+   * Off by default. `true` omits drafts and future-scheduled pages from
+   * production HTML, search, and sitemaps. Unlisted pages still build and
+   * remain reachable by URL. An object enables the feature and can inject
+   * `now` for a deterministic build-time clock.
+   *
+   * @default false
+   */
+  publishState?: boolean | PublishStateOptions;
+  /**
+   * Honor frontmatter `permalink` / `slug` when resolving page URLs.
+   *
+   * Off by default. `true` or `{}` replaces the file-tree URL with
+   * `permalink`, or the last path segment with `slug`. Path escape
+   * (`../`, absolute filesystem paths, `javascript:`, protocol-relative
+   * `//`) is rejected and the file-tree URL is kept. Two pages that
+   * resolve to the same URL produce an error; the first page is kept and
+   * the later page is skipped.
+   *
+   * @default false
+   */
+  permalinks?: boolean | PermalinksOptions;
+  /**
+   * Inherit missing frontmatter keys from ancestor `_index` files.
+   *
+   * Off by default. `true` or `{}` fills keys a child does not set.
+   * `permalink` and `slug` are never inherited.
+   *
+   * @default false
+   */
+  cascade?: boolean | CascadeOptions;
+  /**
+   * Write static HTML redirect pages for frontmatter aliases and a config map.
+   *
+   * Off by default. `true` or `{}` enables empty defaults. A path map such as
+   * `{ "/old-guide": "/guide" }` enables the feature with that map. Destinations
+   * must be same-origin paths (`/` but not `//`) unless `allowExternal` is set.
+   * `javascript:`, `data:`, and protocol-relative URLs are ignored.
+   * Overlapping sources last-win after trailing slashes are folded.
+   *
+   * @default false
+   */
+  redirects?: boolean | RedirectsOptions | Record<string, string>;
+  /**
+   * Write a paginated blog index, tag pages, and yearly/monthly archive,
+   * and inject author / reading-time chrome on posts.
+   *
+   * Off by default. `true` uses the `blog` collection when it exists,
+   * otherwise the only configured collection, with pageSize 10.
+   * An object enables the feature and overrides only the fields you set.
+   * Also accepted as `ssg.blog`; the top-level option wins when both are set.
+   *
+   * @default false
+   */
+  blog?: boolean | BlogOptions;
+  /**
+   * Write RSS, Atom, and/or JSON Feed files from a named collection.
+   *
+   * Off by default. `true` writes all three formats from the `content`
+   * collection (or the first configured collection) with a 20-item limit.
+   * An object enables the feature and overrides only the fields you set.
+   * Requires `ssg.siteUrl`. When that is missing the build continues and a
+   * warning is emitted instead of writing files.
+   *
+   * @default false
+   */
+  feeds?: boolean | FeedsOptions;
+  /**
+   * Write a web app manifest and an optional service worker.
+   *
+   * Off by default. `true` writes `manifest.webmanifest` and `sw.js`, and
+   * injects a tiny client script that registers the worker on themed pages.
+   * An object enables the feature and can set `offline: false` to keep the
+   * manifest without caching or that script. This adds client JavaScript
+   * when offline is on. Requires `ssg.siteUrl`. When that is missing the
+   * build continues and a warning is emitted instead of writing files.
+   *
+   * @default false
+   */
+  pwa?: boolean | PwaOptions;
+  /**
+   * Generate self-hosted Iconify CSS for used and safelisted icons.
+   *
+   * Off by default. `true` or `{}` enables CSS-mask emission. Install
+   * `@iconify/json` or individual `@iconify-json/*` packages so the build
+   * can resolve collections without a network request.
+   *
+   * @default false
+   */
+  icons?: boolean | IconsOptions;
+  /**
+   * Write tag/category term pages and inject related-page lists.
+   *
+   * Off by default. `true` reads frontmatter `tags` and `categories` and
+   * writes list pages, per-term pages, and up to 5 related links on pages
+   * that share a term. An object enables the feature and overrides only
+   * the fields you set. Term slugs are `[a-z0-9-]` and every label is
+   * HTML-escaped.
+   *
+   * @default false
+   */
+  taxonomies?: boolean | TaxonomiesOptions;
+  /**
+   * Prefix live docs, emit frozen snapshot trees, and render a header
+   * version dropdown.
+   *
+   * Off by default. `true` enables a single current entry. An object
+   * enables the feature and lists additional versions. Historical
+   * snapshot directories are read, never rewritten.
+   *
+   * @default false
+   */
+  versions?: boolean | VersionsOptions;
+  /**
+   * Enable GitHub Flavored Markdown extensions.
+   * @default true
+   */
+  gfm?: boolean;
+  /**
+   * Enable MDX JSX, ESM, and expressions.
+   *
+   * When omitted, MDX is enabled for `.mdx` files only. Set `true` to enable
+   * it for every configured extension or `false` to keep `.mdx` on the plain
+   * Markdown path.
+   * @default inferred from the source extension
+   */
+  mdx?: boolean;
+  /**
+   * Enable footnotes.
+   * @default true
+   */
+  footnotes?: boolean;
+  /**
+   * Render footnotes as a semantic ordered section with numeric markers.
+   *
+   * Source identifiers are used only for lookup and slugs. Visible markers
+   * are 1, 2, … in document order, and definitions emit as
+   * `<section class="footnotes"><ol><li>…`.
+   *
+   * Off by default so current alpha HTML stays stable.
+   * @default false
+   */
+  semanticFootnotes?: boolean;
+  /**
+   * Enable tables.
+   * @default true
+   */
+  tables?: boolean;
+  /**
+   * Enable task lists.
+   * @default true
+   */
+  taskLists?: boolean;
+  /**
+   * Enable strikethrough.
+   * @default true
+   */
+  strikethrough?: boolean;
+  /**
+   * Enable GFM autolinks and linkify bare URLs.
+   * @default true
+   */
+  autolinks?: boolean;
+  /**
+   * Enable syntax highlighting for code blocks.
+   *
+   * When true, fenced and language-tagged inline code is highlighted with the
+   * native tree-sitter engine. Token colors are `--octc-syntax-*` custom
+   * properties so theme-color packages resolve highlighting. Languages with no
+   * native grammar stay unhighlighted.
+   *
+   * @default false
+   */
+  highlight?: boolean;
+  /**
+   * Code block line annotations for fenced code blocks.
+   *
+   * This feature is opt-in because it changes rendered code-block markup. Pass
+   * `true` to enable ox-content's attribute syntax, or pass an options object to
+   * change the meta key or enable VitePress-compatible notation.
+   *
+   * @example
+   * ~~~md
+   * ```ts annotate="highlight:1,3-4;warning:6;error:7"
+   * const value = compute()
+   * ```
+   * ~~~
+   *
+   * @default false
+   */
+  codeAnnotations?: boolean | CodeAnnotationsOptions;
+  /**
+   * Expand Obsidian-style `[[page]]` and `[[page|label]]` links.
+   *
+   * Use this for knowledge-base style content where authors prefer short,
+   * document-relative link syntax. Pass an object to override the base URL used
+   * when resolving generated hrefs.
+   *
+   * @default false
+   */
+  wikiLinks?: boolean | WikiLinkOptions;
+  /**
+   * Expand `:shortcode:` emoji aliases to Unicode.
+   *
+   * Built-in aliases cover common emoji names. Provide `custom` entries for
+   * project-specific aliases or to override a built-in mapping.
+   *
+   * @default false
+   */
+  emojiShortcodes?: boolean | EmojiShortcodeOptions;
+  /**
+   * Enable markdown-it-attrs style `{#id .class key=value}` attributes.
+   *
+   * Attribute blocks can be attached to headings, paragraphs, links, images, and
+   * other supported Markdown nodes depending on parser context.
+   *
+   * @default false
+   */
+  attrs?: boolean | AttrsOptions;
+  /**
+   * Opt-in `{badge:variant}` inline badges.
+   *
+   * Passing `true` or an options object enables the built-in variants.
+   * Badge text is HTML-escaped. Fenced, indented, and inline code are skipped.
+   *
+   * @default false
+   */
+  badges?: boolean | BadgeOptions;
+  /**
+   * Opt-in `<NotByAI />` authorship disclosure badge.
+   *
+   * Passing `true` or an options object emits the official Not By AI light/dark
+   * artwork as static HTML. This is not a status badge — see `badges` for
+   * `{badge:tip}` labels. Disabled when omitted. Fenced, indented, and inline
+   * code plus HTML comments are skipped.
+   *
+   * @default false
+   */
+  notByAi?: boolean | NotByAiOptions;
+  /**
+   * Opt-in `{kbd:...}` inline keyboard keys.
+   *
+   * Passing `true` or an options object enables `{kbd:Ctrl+K}` and
+   * `{kbd:Cmd Shift P}`. Key labels are HTML-escaped. Fenced, indented,
+   * inline, and raw code, plus HTML comments, are skipped. Aliases come
+   * from build config, not the runtime user agent.
+   *
+   * @default false
+   */
+  keyboardKeys?: boolean | KeyboardKeysOptions;
+  /**
+   * Opt-in abbreviation and glossary expansion.
+   *
+   * Passing `true` or an options object expands `*[LSP]: Language Server Protocol`
+   * and config `terms` into `<abbr class="ox-abbr">`. Matching uses Unicode word
+   * boundaries. Fenced, indented, inline, and raw code, HTML comments, and
+   * existing links are skipped. There is no client JavaScript.
+   *
+   * @default false
+   */
+  abbreviations?: boolean | AbbreviationsOptions;
+  /**
+   * Opt-in PHP Markdown Extra / mdBook-style definition lists.
+   *
+   * Passing `true` or an options object turns
+   * `Term` / `: definition` source into semantic `<dl>` markup.
+   * Disabled when omitted. Fenced, indented, and inline code are skipped.
+   * Invalid or ambiguous forms stay ordinary paragraphs or lists.
+   *
+   * @default false
+   */
+  definitionLists?: boolean | DefinitionListOptions;
+  /**
+   * Opt-in `{link:...}` rich magic links.
+   *
+   * Passing `true` or an options object enables GitHub-user, alias, and
+   * explicit `label|url` forms. Attributes and text are HTML-escaped.
+   * Fenced, indented, inline, and raw code, plus already-linked text, are
+   * skipped. The transform does not make network requests unless an explicit
+   * favicon template is enabled (still URL-only; no fetch at transform time).
+   *
+   * @default false
+   */
+  magicLinks?: boolean | MagicLinkOptions;
+  /**
+   * Opt-in `::: tip` custom containers.
+   *
+   * GitHub-style `> [!NOTE]` callouts stay available without this option.
+   * Passing `true` enables the built-in types. Pass an object to register extra
+   * types or override titles.
+   *
+   * @default false
+   */
+  containers?: boolean | ContainerOptions;
+  /**
+   * Opt-in figures, captions, and lazy-loaded images.
+   *
+   * Title text becomes a `<figcaption>`. Optional `{width=N height=M}` on the
+   * image is consumed by this feature and does not require `attrs`. Passing
+   * `true` or `{}` enables defaults (`lazy: true`).
+   *
+   * @default false
+   */
+  images?: boolean | ImageOptions;
+  /**
+   * Opt-in static `::: gallery` image groups.
+   *
+   * Each non-empty line inside the block must be a Markdown image, optionally
+   * as a list item. Image titles become item captions, and the block title or
+   * caption metadata becomes the gallery caption. Passing `true` or `{}`
+   * enables strict empty-gallery and missing-alt diagnostics.
+   *
+   * @default false
+   */
+  imageGalleries?: boolean | ImageGalleryOptions;
+  /**
+   * Opt-in static `::: timeline` milestone lists.
+   *
+   * Timeline blocks render dated or undated milestones from Markdown-only
+   * `::: timeline` blocks. Items can carry `status`, `label`, and `href`
+   * metadata while nested Markdown stays searchable and static.
+   *
+   * @default false
+   */
+  timelines?: boolean | TimelineOptions;
+  /**
+   * Opt-in page-bundle resources and build-time image processing.
+   *
+   * Off by default. `true` or `{}` treats each page directory as a bundle:
+   * sibling images are addressable with relative URLs. Query-string
+   * resize/crop/format transforms run at build time and are cached by
+   * source mtime plus transform params. Paths that leave the page
+   * directory or `srcDir` are rejected. Missing sources fail the build
+   * when `missing` is `"error"` (the default when enabled).
+   * `dedupe` is off unless set; it does not turn on with `true` / `{}`.
+   *
+   * This is separate from `images`, which only adds figures, captions,
+   * and lazy-loading.
+   *
+   * @default false
+   */
+  resources?: boolean | ResourcesOptions;
+  /**
+   * Import source snippets into fences with `<<< @/path/to/file.ts{region}`.
+   *
+   * This is useful for documentation that must stay synchronized with examples
+   * in the repository. Use `rootDir` when snippets should resolve from a
+   * directory other than the Vite project root.
+   *
+   * @default false
+   */
+  codeImports?: boolean | CodeImportOptions;
+  /**
+   * Inline another Markdown file with `<!-- @include: ./path.md -->`.
+   *
+   * Expansion happens before Markdown is parsed, so included headings and
+   * lists become part of the host document. Relative paths resolve from the
+   * current file. `@/` and `/` resolve from `rootDir`. Paths outside
+   * `rootDir` are rejected and reported as transform errors.
+   *
+   * @default false
+   */
+  includes?: boolean | IncludeOptions;
+  /**
+   * Inline a parameterized Markdown partial with
+   * `<!-- @partial: ./_partials/install.md package="ox-content" -->`.
+   *
+   * Disabled when omitted. `{{ name }}` substitutions are HTML-escaped.
+   * Missing parameters stay literal unless `missing` is `"error"`. Existing
+   * `<!-- @include: -->` behavior is unchanged.
+   *
+   * @default false
+   */
+  partials?: boolean | PartialsOptions;
+  /**
+   * Opt-in `::: card` / `::: link-card` / `::: card-grid` blocks.
+   *
+   * Passing `true` enables the defaults. Pass an object to keep the option
+   * shape while overriding `enabled`.
+   *
+   * @default false
+   */
+  cards?: boolean | CardOptions;
+  /**
+   * Restyle a `::: steps` wrapper around an ordered list.
+   *
+   * Disabled when omitted or `false`. `true` and `{}` enable the default
+   * step-list markup. Ordinary ordered lists outside `::: steps` are unchanged.
+   *
+   * @default false
+   */
+  steps?: boolean | StepsOptions;
+  /**
+   * Opt-in VitePress-style `::: code-group` fence groups.
+   *
+   * Passing `true` or `{}` enables rewriting labeled fences into the
+   * existing no-JS tab widget. Omitted or `false` leaves the source on
+   * the normal Markdown/container path.
+   *
+   * @default false
+   */
+  codeGroups?: boolean | CodeGroupOptions;
+  /**
+   * Opt-in static directory trees from `file-tree` fences.
+   *
+   * Passing `true` or `{}` enables the transform. Names are escaped and never
+   * read from the filesystem. Directories with children open and close with
+   * `<details>`. Icons are on by default and can be replaced from site config.
+   *
+   * @default false
+   */
+  fileTree?: boolean | FileTreeOptions;
+  /**
+   * Opt-in static tables from `csv-table` / `json-table` fences.
+   *
+   * Passing `true` or `{}` enables the transform. Inline CSV/JSON becomes a
+   * semantic `<table>` with a responsive wrapper. `src` or a single path body
+   * can import `@/data/options.csv` or `./options.json`. Paths cannot escape
+   * the content/project root with `..`. Missing imports use `missing`.
+   *
+   * @default false
+   */
+  dataTables?: boolean | DataTableOptions;
+  /**
+   * Sanitize rendered HTML with safe defaults or explicit allow lists.
+   *
+   * Enable this for untrusted Markdown. The default allow lists are conservative;
+   * pass an options object only when the content model intentionally needs extra
+   * tags, attributes, or URL schemes.
+   *
+   * @default false
+   */
+  sanitize?: boolean | SanitizeOptions;
+  /**
+   * Append an "edit this page" link to rendered Markdown.
+   *
+   * The feature is enabled only when `repoUrl` is provided in the options object.
+   * Passing `true` keeps the feature disabled because there is not enough
+   * repository information to generate valid links.
+   *
+   * @default false
+   */
+  editThisPage?: boolean | EditThisPageOptions;
+  /**
+   * Recognize emphasis adjacent to CJK text. The native parser already supports
+   * this behavior; the option documents the compatibility contract.
+   * @default false
+   */
+  cjkEmphasis?: boolean;
+  /**
+   * Lint fenced code blocks during Markdown transforms.
+   *
+   * Use this as a lightweight authoring check for missing languages or trailing
+   * whitespace inside fences. For project-wide linting, prefer the exported
+   * `lintCodeBlocks()` helper or the Markdown lint APIs.
+   *
+   * @default false
+   */
+  codeBlockLint?: boolean | CodeBlockLintOptions;
+  /**
+   * Type-check TypeScript/TSX code fences via tsgo.
+   *
+   * By default only fences with explicit opt-in metadata are checked. This keeps
+   * incidental examples cheap while allowing docs-as-code snippets to fail the
+   * build when configured with `mode: 'error'`.
+   *
+   * @default false
+   */
+  codeBlockTypecheck?: boolean | CodeBlockTypecheckOptions;
+  /**
+   * Attach build-time TypeScript hover overlays to opted-in fences.
+   *
+   * Off by default. `true` or `{}` enables the feature. Only `ts` / `tsx`
+   * fences tagged `twoslash` receive payloads. Types are generated during
+   * the Markdown transform; no TypeScript compiler is shipped to the browser.
+   *
+   * @default false
+   */
+  typedHover?: boolean | TypedHoverOptions;
+  /**
+   * Extract runnable fenced examples for Vitest docs-as-tests harnesses.
+   *
+   * Collected examples can be written by the docs test helpers and executed as
+   * part of a normal Vitest suite.
+   *
+   * @default false
+   */
+  docsTests?: boolean | DocsTestOptions;
+  /**
+   * Enable mermaid diagram rendering.
+   * @default false
+   */
+  mermaid?: boolean;
+  /**
+   * Enable `$…$` inline and `$$…$$` block math.
+   *
+   * Currency-like `$` runs, fenced code, indented code, and inline code stay
+   * literal. TeX is HTML-escaped into accessible MathML `mtext`.
+   *
+   * @default false
+   */
+  math?: boolean | MathOptions;
+  /**
+   * Parse YAML frontmatter.
+   * @default true
+   */
+  frontmatter?: boolean;
+  /**
+   * Generate table of contents.
+   * @default true
+   */
+  toc?: boolean;
+  /**
+   * Maximum heading depth for TOC.
+   * @default 3
+   */
+  tocMaxDepth?: number;
+  /**
+   * Append a visible heading permalink (`<a class="header-anchor" href="#id">`).
+   *
+   * Reuses the generated heading id. Default off. Theme
+   * `headingPermalink: "hover" | "always"` changes only CSS visibility.
+   *
+   * @default false
+   */
+  headingPermalinks?: boolean | HeadingPermalinksOptions;
+  /**
+   * Enable OG image generation.
+   * @default false
+   */
+  ogImage?: boolean;
+  /**
+   * OG image generation options.
+   * Ignored unless `ogImage` or `ssg.generateOgImage` is enabled.
+   * @default { vuePlugin: 'vitejs', width: 1200, height: 630, cache: true, concurrency: 1 }
+   */
+  ogImageOptions?: OgImageOptions;
+  /**
+   * Custom AST transformers.
+   * Transformers run after parsing and before the final JavaScript module is emitted.
+   * @default []
+   */
+  transformers?: MarkdownTransformer[];
+  /**
+   * Source documentation generation options.
+   * Set to false to disable (opt-out).
+   * @default { enabled: true }
+   */
+  docs?: DocsOptions | false;
+  /**
+   * Full-text search options.
+   * Set to false to disable search.
+   * @default { enabled: true }
+   */
+  search?: SearchOptions | boolean;
+  /**
+   * Markdown collection query options.
+   *
+   * Collections are exposed through `virtual:ox-content/collections`. The
    * default collection is metadata-only and is built by the native Rust
    * manifest builder without rendering every document; add `include` fields
    * only for routes that need raw or rendered content in the query payload.
    *
-   * @default content collection for all Markdown files
+   * @default content collection for all Markdown files
+   */
+  collections?: CollectionsOptions | boolean;
+  /**
+   * Enable OG Viewer dev tool.
+   * Accessible at /__og-viewer during development.
+   * @default true
+   */
+  ogViewer?: boolean;
+  /**
+   * Built-in static embeds rendered during Markdown transformation.
+   * Set to `false` to disable all built-in embeds.
+   * @default { github: true, openGraph: true }
+   */
+  embeds?: BuiltinEmbedOptions | false;
+  /**
+   * i18n (internationalization) options.
+   * Set to false to disable i18n.
+   * @default false
+   */
+  i18n?: I18nOptions | false;
+}
+/**
+ * Resolved options with all defaults applied.
+ */
+interface ResolvedOptions {
+  srcDir: string;
+  outDir: string;
+  base: string;
+  extensions: string[];
+  ssg: ResolvedSsgOptions;
+  siteMaps?: ResolvedSiteMapsOptions;
+  publishState?: ResolvedPublishStateOptions;
+  permalinks?: ResolvedPermalinksOptions;
+  cascade?: ResolvedCascadeOptions;
+  redirects?: ResolvedRedirectsOptions;
+  blog?: ResolvedBlogOptions;
+  feeds?: ResolvedFeedsOptions;
+  pwa?: ResolvedPwaOptions;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  icons?: ResolvedIconsOptions;
+  taxonomies?: ResolvedTaxonomiesOptions;
+  versions?: ResolvedVersionsOptions;
+  resources?: ResolvedResourcesOptions;
+  gfm: boolean;
+  mdx?: boolean;
+  footnotes: boolean;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  semanticFootnotes?: boolean;
+  tables: boolean;
+  taskLists: boolean;
+  strikethrough: boolean;
+  autolinks: boolean;
+  highlight: boolean;
+  codeAnnotations: ResolvedCodeAnnotationsOptions;
+  wikiLinks: ResolvedWikiLinkOptions;
+  emojiShortcodes: ResolvedEmojiShortcodeOptions;
+  attrs: ResolvedAttrsOptions;
+  badges: ResolvedBadgeOptions;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  notByAi?: ResolvedNotByAiOptions;
+  keyboardKeys?: ResolvedKeyboardKeysOptions;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  abbreviations?: ResolvedAbbreviationsOptions;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  definitionLists?: ResolvedDefinitionListOptions;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  magicLinks?: ResolvedMagicLinkOptions;
+  containers: ResolvedContainerOptions;
+  images: ResolvedImageOptions;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  imageGalleries?: ResolvedImageGalleryOptions;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  timelines?: ResolvedTimelineOptions;
+  codeImports: ResolvedCodeImportOptions;
+  includes: ResolvedIncludeOptions;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  partials?: ResolvedPartialsOptions;
+  cards: ResolvedCardOptions;
+  steps: ResolvedStepsOptions;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  codeGroups?: ResolvedCodeGroupOptions;
+  fileTree: ResolvedFileTreeOptions;
+  dataTables: ResolvedDataTableOptions;
+  sanitize: ResolvedSanitizeOptions;
+  editThisPage: ResolvedEditThisPageOptions;
+  cjkEmphasis: boolean;
+  codeBlockLint: ResolvedCodeBlockLintOptions;
+  codeBlockTypecheck: ResolvedCodeBlockTypecheckOptions;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  typedHover?: ResolvedTypedHoverOptions;
+  docsTests: ResolvedDocsTestOptions;
+  mermaid: boolean;
+  math: ResolvedMathOptions;
+  frontmatter: boolean;
+  toc: boolean;
+  tocMaxDepth: number;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  headingPermalinks?: ResolvedHeadingPermalinksOptions;
+  ogImage: boolean;
+  ogImageOptions: ResolvedOgImageOptions$1;
+  transformers: MarkdownTransformer[];
+  docs: ResolvedDocsOptions | false;
+  search: ResolvedSearchOptions;
+  collections: ResolvedCollectionsOptions;
+  ogViewer: boolean;
+  embeds: ResolvedBuiltinEmbedOptions;
+  i18n: ResolvedI18nOptions | false;
+}
+/**
+ * Built-in embed configuration.
+ */
+interface BuiltinEmbedOptions {
+  /**
+   * Render `<GitHub repo="owner/name" />` repository cards.
+   * Pass an options object to configure fetching.
+   * @default true
+   */
+  github?: boolean | GitHubOptions;
+  /**
+   * Render `<OgCard url="https://example.com" />` Open Graph link cards.
+   * Pass an options object to configure fetching.
+   * @default true
+   */
+  openGraph?: boolean | OgpOptions;
+  /**
+   * Expand `<pm>npm install …</pm>` blocks into npm/pnpm/yarn/bun install tabs.
+   *
+   * Accepts a boolean to toggle the feature, or an options object to opt in to
+   * synced tab groups. Synced groups are OFF by default; when enabled with
+   * `{ sync: true }`, selecting a package manager in one block selects it in
+   * every other package-manager block on the page (persisted in localStorage).
+   * @default false
+   */
+  pm?: boolean | BuiltinPmOptions;
+  /**
+   * Render `<Spotify url="https://open.spotify.com/track/...">` iframes.
+   * @default false
+   */
+  spotify?: boolean;
+  /**
+   * Render `<AppleMusic url="https://music.apple.com/...">` iframes.
+   * @default false
+   */
+  appleMusic?: boolean;
+  /**
+   * Render `<SpeakerDeck url="https://speakerdeck.com/...">` cards.
+   * Player URLs and oEmbed-resolved share URLs render a lazy iframe plus
+   * title/author metadata. Fetch or parse failures become a link card.
+   * @default false
+   */
+  speakerDeck?: boolean;
+  /**
+   * Render `<Audio src="https://...">` native audio players.
+   * @default false
+   */
+  audio?: boolean;
+  /**
+   * Render `<Video src="https://...">` native video players.
+   * @default false
+   */
+  video?: boolean;
+  /**
+   * Render `<StackBlitz url="https://stackblitz.com/edit/...">` iframes.
+   * @default false
+   */
+  stackBlitz?: boolean;
+  /**
+   * Render `<Tweet>` / `<XPost>` as static privacy-conscious cards.
+   * Pass `{ fetch: true }` to fetch the post body, author, and self-hosted
+   * media at build time. Fetch failures fall back to the link-only card.
+   * @default false
+   */
+  twitter?: boolean | TwitterEmbedOptions;
+  /**
+   * Render `<Reddit>` as a static post card.
+   * Pass `{ fetch: false }` to skip metadata fetching and render a link-only card.
+   * @default false
+   */
+  reddit?: boolean | RedditEmbedOptions;
+  /**
+   * Render `<Bluesky>` as static cards.
+   * @default false
+   */
+  bluesky?: boolean;
+  /**
+   * Render `<WebContainer>` lazy placeholders with isolation metadata.
+   * @default false
+   */
+  webContainer?: boolean;
+}
+/**
+ * Options for the package-manager install-tab transform.
+ */
+interface BuiltinPmOptions {
+  /**
+   * Enable opt-in synced package-manager tab groups.
+   * @default false
+   */
+  sync?: boolean;
+}
+/**
+ * Resolved built-in embed configuration.
+ */
+interface ResolvedBuiltinEmbedOptions {
+  github: GitHubOptions | false;
+  openGraph: OgpOptions | false;
+  pm: BuiltinPmOptions | false;
+  spotify: boolean;
+  appleMusic: boolean;
+  speakerDeck: boolean;
+  audio?: boolean;
+  video?: boolean;
+  stackBlitz: boolean;
+  twitter: TwitterEmbedOptions | false;
+  reddit?: RedditEmbedOptions | false;
+  bluesky: boolean;
+  webContainer: boolean;
+}
+/**
+ * Options for opt-in `{badge:variant}` inline badges.
+ */
+interface BadgeOptions {
+  /**
+   * Enable the badge transform when an options object is supplied.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+}
+/**
+ * Resolved inline-badge transform options.
+ */
+interface ResolvedBadgeOptions {
+  enabled: boolean;
+}
+/**
+ * Options for opt-in PHP Markdown Extra / mdBook-style definition lists.
+ */
+interface DefinitionListOptions {
+  /**
+   * Enable the definition-list transform when an options object is supplied.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+}
+/**
+ * Resolved definition-list transform options.
+ */
+interface ResolvedDefinitionListOptions {
+  enabled: boolean;
+}
+/**
+ * Options for the opt-in `<NotByAI />` authorship badge.
+ */
+interface NotByAiOptions {
+  /**
+   * Enable the badge transform when an options object is supplied.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * Accessible label for the badge link.
+   *
+   * @default "Written by human, not by AI"
+   */
+  label?: string;
+  /**
+   * Destination URL. Unsafe values fall back to `https://notbyai.fyi`.
+   *
+   * @default "https://notbyai.fyi"
+   */
+  href?: string;
+}
+/**
+ * Resolved NotByAI authorship-badge options.
+ */
+interface ResolvedNotByAiOptions {
+  enabled: boolean;
+  label: string;
+  href: string;
+}
+/**
+ * Options for opt-in `{kbd:...}` inline keyboard keys.
+ */
+interface KeyboardKeysOptions {
+  /**
+   * Enable the keyboard-key transform when an options object is supplied.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * Build-time aliases. Keys are matched case-insensitively and override
+   * the built-in `cmd` / `ctrl` table.
+   */
+  aliases?: Record<string, string>;
+  /**
+   * Built-in alias labels. `"words"` emits `Command`; `"symbols"` emits `⌘`.
+   *
+   * @default "words"
+   */
+  style?: "words" | "symbols";
+}
+/**
+ * Resolved inline keyboard-key transform options.
+ */
+interface ResolvedKeyboardKeysOptions {
+  enabled: boolean;
+  aliases: Record<string, string>;
+  style: "words" | "symbols";
+}
+/**
+ * Options for opt-in abbreviation and glossary expansion.
+ */
+interface AbbreviationsOptions {
+  /**
+   * Enable the transform when an options object is supplied.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * Central glossary. Keys are matched with Unicode word boundaries.
+   */
+  terms?: Record<string, string>;
+  /**
+   * Wrap only the first occurrence of each term.
+   *
+   * @default false
+   */
+  firstUseOnly?: boolean;
+}
+/**
+ * Resolved abbreviation / glossary transform options.
+ */
+interface ResolvedAbbreviationsOptions {
+  enabled: boolean;
+  terms: Record<string, string>;
+  firstUseOnly: boolean;
+}
+/**
+ * Options for opt-in `{link:...}` rich magic links.
+ */
+interface MagicLinkOptions {
+  /**
+   * Enable the magic-link transform when an options object is supplied.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * Named aliases. A string value is treated as `{ href }`.
+   */
+  aliases?: Record<string, string | MagicLinkAlias>;
+  /**
+   * Emit a favicon URL when a link has no image.
+   *
+   * `true` uses `https://{host}/favicon.ico`. Pass `{ template }` to override.
+   * The transform never fetches; the browser may load the URL later.
+   *
+   * @default false
+   */
+  favicon?: boolean | {
+    template?: string;
+  };
+  /**
+   * Replace the resolved image for matching hrefs.
+   */
+  imageOverrides?: MagicLinkImageOverride[];
+}
+/**
+ * One configured magic-link target.
+ */
+interface MagicLinkAlias {
+  href: string;
+  label?: string;
+  image?: string;
+}
+/**
+ * Replace the image for an exact href or prefix.
+ */
+interface MagicLinkImageOverride {
+  href?: string;
+  prefix?: string;
+  image: string;
+}
+/**
+ * Resolved magic-link transform options.
+ */
+interface ResolvedMagicLinkOptions {
+  enabled: boolean;
+  aliases: Record<string, MagicLinkAlias>;
+  favicon: boolean;
+  faviconTemplate?: string;
+  imageOverrides: MagicLinkImageOverride[];
+}
+/**
+ * Options for opt-in `::: type` custom containers.
+ */
+interface ContainerOptions {
+  /**
+   * Enable the container transform when an options object is supplied.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * Extra or overriding container types.
+   *
+   * Keys must be ASCII identifiers (`[A-Za-z0-9_-]+`). Unknown hostile names
+   * are ignored.
+   */
+  types?: Record<string, ContainerTypeOptions>;
+}
+/**
+ * Per-type container presentation.
+ */
+interface ContainerTypeOptions {
+  /** Title used when the opener does not set one. */
+  title?: string;
+  /** `"details"` renders `<details>`/`<summary>`; anything else is a `<div>`. */
+  tag?: "div" | "details";
+}
+/**
+ * Resolved custom-container transform options.
+ */
+interface ResolvedContainerOptions {
+  enabled: boolean;
+  types: Record<string, ContainerTypeOptions>;
+}
+/**
+ * Options for opt-in figures, captions, and lazy images.
+ */
+interface ImageOptions {
+  /**
+   * Add `loading="lazy"` to transformed images.
+   *
+   * @default true
    */
-  collections?: CollectionsOptions | boolean;
+  lazy?: boolean;
+}
+/**
+ * Resolved image transform options.
+ */
+interface ResolvedImageOptions {
+  enabled: boolean;
+  lazy: boolean;
+}
+/**
+ * Options for opt-in static image galleries.
+ */
+interface ImageGalleryOptions {
   /**
-   * Enable OG Viewer dev tool.
-   * Accessible at /__og-viewer during development.
+   * Enable `::: gallery` blocks.
+   *
+   * @default true when the options object is supplied.
+   */
+  enabled?: boolean;
+  /**
+   * Add `loading="lazy"` to gallery images.
+   *
+   * @default follows `images.lazy`, or true when `images` is disabled.
+   */
+  lazy?: boolean;
+  /**
+   * Diagnostics for image items without alt text.
+   *
+   * @default "error"
+   */
+  missingAlt?: "error" | "warn" | "ignore";
+  /**
+   * Diagnostics for galleries without image items.
+   *
+   * @default "error"
+   */
+  empty?: "error" | "warn" | "ignore";
+}
+/**
+ * Resolved image gallery transform options.
+ */
+interface ResolvedImageGalleryOptions {
+  enabled: boolean;
+  lazy?: boolean;
+  missingAlt: "error" | "warn" | "ignore";
+  empty: "error" | "warn" | "ignore";
+}
+/**
+ * Options for opt-in static timelines.
+ */
+interface TimelineOptions {
+  /**
+   * Enable `::: timeline` blocks.
+   *
+   * @default true when the options object is supplied.
+   */
+  enabled?: boolean;
+  /**
+   * Render timelines as ordered lists unless a block overrides it.
+   *
    * @default true
    */
-  ogViewer?: boolean;
+  ordered?: boolean;
   /**
-   * Built-in static embeds rendered during Markdown transformation.
-   * Set to `false` to disable all built-in embeds.
-   * @default { github: true, openGraph: true }
+   * Diagnostics for malformed `YYYY`, `YYYY-MM`, or `YYYY-MM-DD` item dates.
+   *
+   * @default "error"
    */
-  embeds?: BuiltinEmbedOptions | false;
+  invalidDate?: "error" | "warn" | "ignore";
   /**
-   * i18n (internationalization) options.
-   * Set to false to disable i18n.
+   * Diagnostics for unsupported item metadata.
+   *
+   * @default "error"
+   */
+  unknownMeta?: "error" | "warn" | "ignore";
+  /**
+   * Diagnostics for timeline blocks without items.
+   *
+   * @default "error"
+   */
+  empty?: "error" | "warn" | "ignore";
+}
+/**
+ * Resolved timeline transform options.
+ */
+interface ResolvedTimelineOptions {
+  enabled: boolean;
+  ordered: boolean;
+  invalidDate: "error" | "warn" | "ignore";
+  unknownMeta: "error" | "warn" | "ignore";
+  empty: "error" | "warn" | "ignore";
+}
+/**
+ * Options for opt-in page-bundle resources and image processing.
+ */
+interface ResourcesOptions {
+  /**
+   * Allowed output formats for `?format=`.
+   *
+   * `jpg` is treated as `jpeg`. Pixel transforms encode `png` and `jpeg`.
+   * `webp` is copied when the source is already webp and no pixel
+   * transform is requested.
+   *
+   * @default ["png", "jpeg", "webp"]
+   */
+  formats?: string[];
+  /**
+   * Allowed `?width=` / `?w=` values. An empty list allows any positive
+   * width.
+   *
+   * @default []
+   */
+  widths?: number[];
+  /**
+   * What to do when a relative resource is missing.
+   *
+   * @default "error"
+   */
+  missing?: "error" | "warn";
+  /**
+   * Emit identical bytes once as `/assets/content/<sha256>.<ext>` and
+   * rewrite `src`, `poster`, and relevant `href` to that URL.
+   *
+   * Off unless this is `true`. `resources: true` and `{}` leave it off.
+   *
    * @default false
    */
-  i18n?: I18nOptions | false;
+  dedupe?: boolean;
 }
 /**
- * Resolved options with all defaults applied.
+ * Resolved page-resource options.
  */
-interface ResolvedOptions {
-  srcDir: string;
-  outDir: string;
-  base: string;
-  extensions: string[];
-  ssg: ResolvedSsgOptions;
-  gfm: boolean;
-  footnotes: boolean;
-  tables: boolean;
-  taskLists: boolean;
-  strikethrough: boolean;
-  autolinks: boolean;
-  highlight: boolean;
-  highlightTheme: string | ThemeRegistration$1;
-  highlightLangs: LanguageRegistration$1[];
-  codeAnnotations: ResolvedCodeAnnotationsOptions;
-  wikiLinks: ResolvedWikiLinkOptions;
-  emojiShortcodes: ResolvedEmojiShortcodeOptions;
-  attrs: ResolvedAttrsOptions;
-  codeImports: ResolvedCodeImportOptions;
-  sanitize: ResolvedSanitizeOptions;
-  editThisPage: ResolvedEditThisPageOptions;
-  cjkEmphasis: boolean;
-  codeBlockLint: ResolvedCodeBlockLintOptions;
-  codeBlockTypecheck: ResolvedCodeBlockTypecheckOptions;
-  docsTests: ResolvedDocsTestOptions;
-  mermaid: boolean;
-  frontmatter: boolean;
-  toc: boolean;
-  tocMaxDepth: number;
-  ogImage: boolean;
-  ogImageOptions: ResolvedOgImageOptions$1;
-  transformers: MarkdownTransformer[];
-  docs: ResolvedDocsOptions | false;
-  search: ResolvedSearchOptions;
-  collections: ResolvedCollectionsOptions;
-  ogViewer: boolean;
-  embeds: ResolvedBuiltinEmbedOptions;
-  i18n: ResolvedI18nOptions | false;
+interface ResolvedResourcesOptions {
+  enabled: boolean;
+  formats: string[];
+  widths: number[];
+  missing: "error" | "warn";
+  dedupe: boolean;
 }
 /**
- * Built-in embed configuration.
+ * Options for expanding Obsidian-style wiki links.
+ *
+ * The transform accepts `[[target]]` and `[[target|label]]` syntax and rewrites
+ * it to regular links before rendering. It is intentionally small: path
+ * resolution is based on the configured base URL rather than a full backlink
+ * graph.
  */
-interface BuiltinEmbedOptions {
+interface WikiLinkOptions {
   /**
-   * Render `<GitHub repo="owner/name" />` repository cards.
-   * Pass an options object to configure fetching.
+   * Base URL prepended to resolved wiki-link targets.
+   *
+   * When omitted, the top-level `base` option is used.
+   *
+   * @default options.base
+   */
+  baseUrl?: string;
+}
+/**
+ * Resolved wiki-link transform options.
+ */
+interface ResolvedWikiLinkOptions {
+  enabled: boolean;
+  baseUrl: string;
+}
+/**
+ * Options for expanding `:shortcode:` emoji aliases.
+ *
+ * The transform replaces recognized shortcode tokens with their Unicode emoji
+ * equivalents during Markdown transformation. Unknown shortcodes are left
+ * untouched so colon-delimited text can still be used by other tools.
+ */
+interface EmojiShortcodeOptions {
+  /**
+   * Custom shortcode map merged with the built-in emoji aliases.
+   *
+   * Keys should omit the surrounding colons.
+   *
+   * @example
+   * ```ts
+   * custom: { shipit: '\u{1F6A2}' }
+   * ```
+   *
+   * @default {}
+   */
+  custom?: Record<string, string>;
+}
+/**
+ * Resolved emoji-shortcode transform options.
+ */
+interface ResolvedEmojiShortcodeOptions {
+  enabled: boolean;
+  custom: Record<string, string>;
+}
+/**
+ * Options for opt-in `$…$` / `$$…$$` math.
+ *
+ * Delimiter parsing lives in the native transform. Typesetting uses KaTeX at
+ * build time when the optional `katex` peer is installed. Sites that omit
+ * `math` do not need that package.
+ */
+interface MathOptions {
+  /**
+   * Enable the math transform when an options object is supplied.
+   *
    * @default true
    */
-  github?: boolean | GitHubOptions;
+  enabled?: boolean;
+}
+/**
+ * Resolved math transform options.
+ */
+interface ResolvedMathOptions {
+  enabled: boolean;
+}
+/**
+ * Options for markdown-it-attrs style attribute blocks.
+ *
+ * Attribute blocks let authors attach IDs, classes, and key/value attributes to
+ * nearby Markdown nodes with syntax such as `{#install .lead}`.
+ */
+interface AttrsOptions {
   /**
-   * Render `<OgCard url="https://example.com" />` Open Graph link cards.
-   * Pass an options object to configure fetching.
+   * Enable the attrs transform when an options object is supplied.
+   *
+   * Set to `false` to keep the object shape while disabling the transform.
+   * This is mainly useful for config merging where callers want to preserve a
+   * stable object structure.
+   *
    * @default true
    */
-  openGraph?: boolean | OgpOptions;
+  enabled?: boolean;
+}
+/**
+ * Resolved attrs transform options.
+ */
+interface ResolvedAttrsOptions {
+  enabled: boolean;
+}
+/**
+ * Opt-in visible heading permalinks.
+ *
+ * Headings already have stable `id`s. Enabling this appends a real
+ * `<a class="header-anchor" href="#id">` using that exact id. Off by
+ * default so existing HTML stays byte-stable.
+ */
+interface HeadingPermalinksOptions {
   /**
-   * Expand `<pm>npm install …</pm>` blocks into npm/pnpm/yarn/bun install tabs.
+   * Emit the permalink control.
    *
-   * Accepts a boolean to toggle the feature, or an options object to opt in to
-   * synced tab groups. Synced groups are OFF by default; when enabled with
-   * `{ sync: true }`, selecting a package manager in one block selects it in
-   * every other package-manager block on the page (persisted in localStorage).
-   * @default false
+   * @default true
    */
-  pm?: boolean | BuiltinPmOptions;
+  enabled?: boolean;
+}
+/**
+ * Resolved heading permalink options.
+ */
+interface ResolvedHeadingPermalinksOptions {
+  enabled: boolean;
+}
+/**
+ * Options for importing source snippets into code fences.
+ *
+ * The transform resolves `<<<` imports before code highlighting and other
+ * code-block features run. Imported snippets therefore behave like ordinary
+ * fenced code in later stages.
+ */
+interface CodeImportOptions {
   /**
-   * Render `<Spotify url="https://open.spotify.com/track/...">` iframes.
-   * @default false
+   * Directory used to resolve `<<<` imports.
+   *
+   * When omitted, imports resolve from the Vite project root and configured aliases.
+   *
+   * @example
+   * ```ts
+   * rootDir: 'examples'
+   * ```
+   *
+   * @default undefined
+   */
+  rootDir?: string;
+}
+/**
+ * Resolved code-import transform options.
+ */
+interface ResolvedCodeImportOptions {
+  enabled: boolean;
+  rootDir?: string;
+}
+/**
+ * Options for inlining Markdown files with `<!-- @include: PATH -->`.
+ *
+ * Relative paths resolve from the current file. `@/` and leading `/` resolve
+ * from `rootDir`. After canonicalize, paths outside `rootDir` are rejected.
+ */
+interface IncludeOptions {
+  /**
+   * Directory used to resolve `@/` and absolute include paths.
+   *
+   * When omitted, includes resolve from the Vite project root.
+   *
+   * @default undefined
    */
-  spotify?: boolean;
+  rootDir?: string;
+}
+/**
+ * Resolved Markdown-include transform options.
+ */
+interface ResolvedIncludeOptions {
+  enabled: boolean;
+  rootDir?: string;
+}
+/**
+ * Options for parameterized Markdown partials with `<!-- @partial: PATH k="v" -->`.
+ *
+ * Bare names resolve under `root` (`_partials` by default). Relative `./` and
+ * `../` paths resolve from the current file. `@/` and leading `/` resolve from
+ * `rootDir`. After canonicalize, paths outside `rootDir` are rejected.
+ */
+interface PartialsOptions {
   /**
-   * Render `<StackBlitz url="https://stackblitz.com/edit/...">` iframes.
-   * @default false
+   * Enable the transform when an options object is supplied.
+   *
+   * @default true
    */
-  stackBlitz?: boolean;
+  enabled?: boolean;
   /**
-   * Render `<Tweet>` / `<XPost>` as static privacy-conscious cards.
-   * Pass `{ fetch: true }` to fetch the post body, author, and self-hosted
-   * media at build time. Fetch failures fall back to the link-only card.
-   * @default false
+   * Directory used to resolve `@/` and absolute partial paths.
+   *
+   * @default undefined
    */
-  twitter?: boolean | TwitterEmbedOptions;
+  rootDir?: string;
   /**
-   * Render `<Bluesky>` as static cards.
-   * @default false
+   * Directory used for bare names such as `install.md`.
+   *
+   * @default "_partials"
    */
-  bluesky?: boolean;
+  root?: string;
   /**
-   * Render `<WebContainer>` lazy placeholders with isolation metadata.
-   * @default false
+   * Missing `{{ name }}` substitutions stay literal, or report a diagnostic.
+   *
+   * @default "literal"
    */
-  webContainer?: boolean;
+  missing?: "literal" | "error";
 }
 /**
- * Options for the package-manager install-tab transform.
+ * Resolved parameterized-partial transform options.
  */
-interface BuiltinPmOptions {
+interface ResolvedPartialsOptions {
+  enabled: boolean;
+  rootDir?: string;
+  root: string;
+  missing: "literal" | "error";
+}
+/**
+ * Options for opt-in `::: card` / `::: link-card` / `::: card-grid` blocks.
+ */
+interface CardOptions {
   /**
-   * Enable opt-in synced package-manager tab groups.
-   * @default false
+   * Enable the card transform when an options object is supplied.
+   *
+   * @default true
    */
-  sync?: boolean;
+  enabled?: boolean;
 }
 /**
- * Resolved built-in embed configuration.
+ * Resolved card transform options.
  */
-interface ResolvedBuiltinEmbedOptions {
-  github: GitHubOptions | false;
-  openGraph: OgpOptions | false;
-  pm: BuiltinPmOptions | false;
-  spotify: boolean;
-  stackBlitz: boolean;
-  twitter: TwitterEmbedOptions | false;
-  bluesky: boolean;
-  webContainer: boolean;
+interface ResolvedCardOptions {
+  enabled: boolean;
 }
 /**
- * Options for expanding Obsidian-style wiki links.
- *
- * The transform accepts `[[target]]` and `[[target|label]]` syntax and rewrites
- * it to regular links before rendering. It is intentionally small: path
- * resolution is based on the configured base URL rather than a full backlink
- * graph.
+ * Options for opt-in `::: steps` ordered lists.
  */
-interface WikiLinkOptions {
+interface StepsOptions {
   /**
-   * Base URL prepended to resolved wiki-link targets.
-   *
-   * When omitted, the top-level `base` option is used.
+   * Enable the steps transform when an options object is supplied.
    *
-   * @default options.base
+   * @default true
    */
-  baseUrl?: string;
+  enabled?: boolean;
 }
 /**
- * Resolved wiki-link transform options.
+ * Resolved step-list transform options.
  */
-interface ResolvedWikiLinkOptions {
+interface ResolvedStepsOptions {
   enabled: boolean;
-  baseUrl: string;
 }
 /**
- * Options for expanding `:shortcode:` emoji aliases.
- *
- * The transform replaces recognized shortcode tokens with their Unicode emoji
- * equivalents during Markdown transformation. Unknown shortcodes are left
- * untouched so colon-delimited text can still be used by other tools.
+ * Options for opt-in `::: code-group` fence groups.
  */
-interface EmojiShortcodeOptions {
+interface CodeGroupOptions {
   /**
-   * Custom shortcode map merged with the built-in emoji aliases.
-   *
-   * Keys should omit the surrounding colons.
-   *
-   * @example
-   * ```ts
-   * custom: { shipit: '\u{1F6A2}' }
-   * ```
+   * Enable the code-group transform when an options object is supplied.
    *
-   * @default {}
+   * @default true
    */
-  custom?: Record<string, string>;
+  enabled?: boolean;
 }
 /**
- * Resolved emoji-shortcode transform options.
+ * Resolved code-group transform options.
  */
-interface ResolvedEmojiShortcodeOptions {
+interface ResolvedCodeGroupOptions {
   enabled: boolean;
-  custom: Record<string, string>;
 }
 /**
- * Options for markdown-it-attrs style attribute blocks.
- *
- * Attribute blocks let authors attach IDs, classes, and key/value attributes to
- * nearby Markdown nodes with syntax such as `{#install .lead}`.
+ * Replaceable file-tree icons. Values are trusted site-config SVG markup or
+ * CSS class tokens, never fence content.
  */
-interface AttrsOptions {
+interface FileTreeIconOptions {
+  /** Collapsed folder icon. */
+  folder?: string;
+  /** Open folder icon. */
+  folderOpen?: string;
+  /** Default file icon. */
+  file?: string;
+  /** File icons keyed by extension (`ts`, `.json`). */
+  files?: Record<string, string>;
+}
+/**
+ * Options for opt-in `file-tree` fences.
+ */
+interface FileTreeOptions {
   /**
-   * Enable the attrs transform when an options object is supplied.
-   *
-   * Set to `false` to keep the object shape while disabling the transform.
-   * This is mainly useful for config merging where callers want to preserve a
-   * stable object structure.
+   * Enable the file-tree transform when an options object is supplied.
    *
    * @default true
    */
   enabled?: boolean;
+  /**
+   * Open directory `<details>` by default.
+   *
+   * @default true
+   */
+  defaultOpen?: boolean;
+  /**
+   * Render folder and file icons. Pass an object to replace the defaults.
+   *
+   * @default true
+   */
+  icons?: boolean | FileTreeIconOptions;
 }
 /**
- * Resolved attrs transform options.
+ * Resolved file-tree transform options.
  */
-interface ResolvedAttrsOptions {
+interface ResolvedFileTreeOptions {
   enabled: boolean;
+  defaultOpen: boolean;
+  icons: boolean;
+  iconFolder?: string;
+  iconFolderOpen?: string;
+  iconFile?: string;
+  iconFiles?: Record<string, string>;
 }
 /**
- * Options for importing source snippets into code fences.
- *
- * The transform resolves `<<<` imports before code highlighting and other
- * code-block features run. Imported snippets therefore behave like ordinary
- * fenced code in later stages.
+ * Options for opt-in `csv-table` / `json-table` fences.
  */
-interface CodeImportOptions {
+interface DataTableOptions {
   /**
-   * Directory used to resolve `<<<` imports.
+   * Enable the data-table transform when an options object is supplied.
    *
-   * When omitted, imports resolve from the Vite project root and configured aliases.
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * Directory used to resolve `@/` and absolute import paths.
    *
-   * @example
-   * ```ts
-   * rootDir: 'examples'
-   * ```
+   * When omitted, imports resolve from the Vite project root.
    *
    * @default undefined
    */
   rootDir?: string;
+  /**
+   * What to do when an imported CSV/JSON file is missing.
+   *
+   * @default "error"
+   */
+  missing?: "error" | "warn";
 }
 /**
- * Resolved code-import transform options.
+ * Resolved data-table transform options.
  */
-interface ResolvedCodeImportOptions {
+interface ResolvedDataTableOptions {
   enabled: boolean;
   rootDir?: string;
+  missing: "error" | "warn";
 }
 /**
  * Options for sanitizing rendered HTML.
@@ -1890,6 +4079,43 @@ interface ResolvedCodeBlockTypecheckOptions {
   tsgoCommand: string;
   mode: "warn" | "error";
 }
+/**
+ * Options for opt-in typed hover overlays on TypeScript fences.
+ *
+ * Hover strings are computed at build time with the same TypeScript compiler
+ * family used by `codeBlockTypecheck` (`tsgo` / `typescript`). The browser
+ * only receives JSON payloads and a tiny overlay script.
+ */
+interface TypedHoverOptions {
+  /**
+   * Enable typed hover overlays.
+   *
+   * @default true when the object form is used
+   */
+  enabled?: boolean;
+  /**
+   * Fence languages that can receive hover payloads.
+   *
+   * Language names are compared case-insensitively.
+   *
+   * @default ['ts', 'tsx']
+   */
+  languages?: string[];
+  /**
+   * Path to the `tsgo` binary used to compute hover types.
+   *
+   * When omitted, the bundled `@typescript/native-preview` executable is used.
+   */
+  tsgoCommand?: string;
+}
+/**
+ * Resolved typed-hover options.
+ */
+interface ResolvedTypedHoverOptions {
+  enabled: boolean;
+  languages: string[];
+  tsgoCommand?: string;
+}
 /**
  * Options for extracting fenced examples into docs-as-tests fixtures.
  *
@@ -1972,11 +4198,67 @@ interface ResolvedCodeAnnotationsOptions {
   metaKey: string;
   defaultLineNumbers: boolean;
 }
+/**
+ * OG image rendering backend.
+ */
+type OgImageRenderer = "chromium" | "satori";
+/**
+ * Font weight values supported by Satori.
+ */
+type OgImageSatoriFontWeight = 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+/**
+ * Font file loaded by the Satori renderer.
+ */
+interface OgImageSatoriFont {
+  /**
+   * Absolute path, or a path relative to the project root.
+   */
+  path: string;
+  /**
+   * Font family name used by template CSS.
+   */
+  name?: string;
+  /**
+   * Font weight.
+   * @default 400
+   */
+  weight?: OgImageSatoriFontWeight;
+  /**
+   * Font style.
+   * @default "normal"
+   */
+  style?: "normal" | "italic";
+}
+/**
+ * Satori renderer options.
+ */
+interface OgImageSatoriOptions {
+  /**
+   * Font files passed to Satori.
+   *
+   * Satori cannot render text without at least one font. When omitted,
+   * Ox Content tries a small set of system font paths unless
+   * `systemFontFallback` is disabled.
+   */
+  fonts?: OgImageSatoriFont[];
+  /**
+   * Try known OS font paths when `fonts` is empty.
+   * @default true
+   */
+  systemFontFallback?: boolean;
+}
 /**
  * OG image generation options.
- * Uses Chromium-based rendering with customizable templates.
+ * Uses Chromium or Satori rendering with customizable templates.
  */
 interface OgImageOptions {
+  /**
+   * Rendering backend.
+   * - `"chromium"`: full browser rendering, best template compatibility
+   * - `"satori"`: fast HTML-to-SVG-to-PNG rendering, limited CSS subset
+   * @default "chromium"
+   */
+  renderer?: OgImageRenderer;
   /**
    * Path to a custom template file (.ts, .vue, .svelte, .tsx/.jsx).
    * - `.ts`: default-export a function `(props) => string`
@@ -2014,17 +4296,26 @@ interface OgImageOptions {
    * @default 1
    */
   concurrency?: number;
+  /**
+   * Options for the Satori renderer.
+   */
+  satori?: OgImageSatoriOptions;
 }
 /**
  * Resolved OG image options with all defaults applied.
  */
 interface ResolvedOgImageOptions$1 {
+  renderer: OgImageRenderer;
   template?: string;
   vuePlugin: "vitejs" | "vizejs";
   width: number;
   height: number;
   cache: boolean;
   concurrency: number;
+  satori: {
+    fonts: OgImageSatoriFont[];
+    systemFontFallback: boolean;
+  };
 }
 /**
  * Custom AST transformer.
@@ -2065,6 +4356,30 @@ interface MarkdownNode {
   value?: string;
   [key: string]: unknown;
 }
+/**
+ * How a specifier was imported from an MDX `import` statement.
+ */
+type MdxImportSpecifierKind = "default" | "named" | "namespace";
+/**
+ * One binding created by an MDX `import` statement.
+ */
+interface MdxImportSpecifier {
+  /** Imported name (`default`, `*`, or the named export). */
+  imported: string;
+  /** Local binding name. */
+  local: string;
+  /** Specifier kind. */
+  kind: MdxImportSpecifierKind;
+}
+/**
+ * One MDX `import` statement collected from the AST.
+ */
+interface MdxImport {
+  /** Module specifier string. */
+  source: string;
+  /** Bindings created by the import. */
+  specifiers: MdxImportSpecifier[];
+}
 /**
  * Transform result.
  */
@@ -2089,6 +4404,18 @@ interface TransformResult {
    * Table of contents.
    */
   toc: TocEntry[];
+  /**
+   * MDX `import` statements (empty when MDX is off or no ESM nodes).
+   */
+  imports: MdxImport[];
+  /**
+   * Export names from MDX ESM (empty when MDX is off or no exports).
+   */
+  exports: string[];
+  /**
+   * Unique JSX component names in document order (empty when none).
+   */
+  components: string[];
 }
 /**
  * Table of contents entry.
@@ -2193,6 +4520,15 @@ interface DocsOptions {
    * @default undefined
    */
   entryPoints?: DocsEntryPoint[];
+  /**
+   * Local OpenAPI 3.0/3.1 JSON or YAML files to render as static REST API docs.
+   *
+   * Generated pages are written under `out/openapi/<spec>/` and use the same
+   * Markdown, stale-file cleanup, SSG, and search pipeline as source docs.
+   *
+   * @default false
+   */
+  openapi?: OpenApiDocsSource | OpenApiDocsSource[] | OpenApiDocsOptions | false;
   /**
    * Output format.
    *
@@ -2380,6 +4716,7 @@ interface ResolvedDocsOptions {
   include: string[];
   exclude: string[];
   entryPoints?: ResolvedDocsEntryPoint[];
+  openapi: ResolvedOpenApiDocsOptions | false;
   format: "markdown" | "json" | "html";
   private: boolean;
   internal: boolean;
@@ -2408,6 +4745,48 @@ interface ResolvedDocsOptions {
   singleEntryRoot: "preserve" | "flatten";
   generateNav: boolean;
 }
+/** OpenAPI docs shorthand accepted by `docs.openapi`. */
+type OpenApiDocsSource = string | OpenApiDocsInput;
+/** One local OpenAPI file consumed by generated REST API docs. */
+interface OpenApiDocsInput {
+  /** JSON or YAML file path, resolved from the Vite project root. */
+  path: string;
+  /** Optional display name. Defaults to `info.title` or the file name. */
+  name?: string;
+  /** Fail on unresolved or remote `$ref` values. Defaults to `true`. */
+  failOnUnresolvedRefs?: boolean;
+}
+/** Object form for configuring generated OpenAPI docs. */
+interface OpenApiDocsOptions {
+  /** Local OpenAPI files to render. */
+  src?: OpenApiDocsSource | OpenApiDocsSource[];
+  /** Route prefix used by generated OpenAPI nav metadata. Defaults to `basePath` or `/api`. */
+  basePath?: string;
+  /** Default unresolved `$ref` policy for sources. Defaults to `true`. */
+  failOnUnresolvedRefs?: boolean;
+}
+/** Resolved local OpenAPI file input. */
+interface ResolvedOpenApiDocsInput {
+  path: string;
+  name?: string;
+  failOnUnresolvedRefs: boolean;
+}
+/** Resolved generated OpenAPI docs options. */
+interface ResolvedOpenApiDocsOptions {
+  src: ResolvedOpenApiDocsInput[];
+  basePath?: string;
+}
+/** Navigation item emitted for generated docs sidebars. */
+interface DocsNavigationItem {
+  title: string;
+  path: string;
+  children?: DocsNavigationItem[];
+}
+/** Generated OpenAPI Markdown pages and sidebar metadata. */
+interface GeneratedOpenApiDocs {
+  pages: Record<string, string>;
+  nav: DocsNavigationItem[];
+}
 /**
  * A single documentation entry extracted from source.
  *
@@ -2690,6 +5069,16 @@ interface SearchOptions {
    * @default true
    */
   prefix?: boolean;
+  /**
+   * Enable fuzzy typo-tolerant matching.
+   *
+   * Fuzzy matching is off by default so large static indexes keep the fastest
+   * exact/prefix path. When enabled, local BM25 also considers near matches
+   * for tokens with at least three characters.
+   *
+   * @default false
+   */
+  fuzzy?: boolean;
   /**
    * Placeholder text for the search input.
    *
@@ -2706,6 +5095,50 @@ interface SearchOptions {
    * @default '/'
    */
   hotkey?: string;
+  /**
+   * Search backend used by `virtual:ox-content/search`.
+   *
+   * `"local"` (the default) keeps the static BM25 `search-index.json` client.
+   * `"hosted"` sends queries to a remote index with a public search-only key.
+   * Hosted search is used only when this is set to `"hosted"`.
+   *
+   * @default 'local'
+   */
+  provider?: "local" | "hosted";
+  /**
+   * Hosted search application id.
+   *
+   * Required when `provider` is `"hosted"`. Also read from
+   * `OX_CONTENT_SEARCH_APP_ID` when omitted here.
+   */
+  appId?: string;
+  /**
+   * Hosted search index name.
+   *
+   * Required when `provider` is `"hosted"`. Also read from
+   * `OX_CONTENT_SEARCH_INDEX_NAME` when omitted here.
+   */
+  indexName?: string;
+  /**
+   * Public search-only key for the hosted provider.
+   *
+   * Write and admin keys are rejected. Also read from `OX_CONTENT_SEARCH_KEY`
+   * when omitted here.
+   */
+  searchKey?: string;
+  /**
+   * Alias for `searchKey`.
+   *
+   * Also read from `OX_CONTENT_SEARCH_PUBLIC_KEY` when omitted here.
+   */
+  publicKey?: string;
+  /**
+   * HTTP endpoint that receives hosted search queries.
+   *
+   * Also read from `OX_CONTENT_SEARCH_ENDPOINT`. Defaults to `/search` when
+   * hosted credentials are present.
+   */
+  endpoint?: string;
 }
 /**
  * Resolved search options.
@@ -2714,8 +5147,15 @@ interface ResolvedSearchOptions {
   enabled: boolean;
   limit: number;
   prefix: boolean;
+  fuzzy: boolean;
   placeholder: string;
   hotkey: string;
+  provider?: "local" | "hosted";
+  appId?: string;
+  indexName?: string;
+  searchKey?: string;
+  publicKey?: string;
+  endpoint?: string;
 }
 /**
  * Search document structure.
@@ -2861,6 +5301,33 @@ interface ResolvedI18nOptions {
   check: boolean;
   functionNames: string[];
 }
+/**
+ * One host-owned page for composable SSG outputs (`ssg: false`).
+ *
+ * The host renders HTML. Ox Content plans and emits resources, Markdown
+ * companions, feeds, and sitemap metadata from these fields.
+ */
+interface SsgOutputPageInput {
+  /** Source file used for git lastmod and companion identity. */
+  inputPath: string;
+  /** Published URL path (`guide` or `/`). */
+  urlPath: string;
+  /** Filesystem path of the host-rendered HTML page. */
+  outputPath?: string;
+  /** Host-rendered HTML. Required for resource fingerprinting. */
+  html?: string;
+  /** Already-read Markdown source bytes for companions. */
+  source?: string;
+  title?: string;
+  description?: string;
+  /** Absolute page URL. When omitted, `siteUrl` + `base` + `urlPath` is used. */
+  loc?: string;
+  /** Git commit time in milliseconds, or a host-supplied timestamp. */
+  lastUpdated?: number;
+  draft?: boolean;
+  unlisted?: boolean;
+  frontmatter?: Record<string, unknown>;
+}
 //#endregion
 //#region src/virtual.d.ts
 declare module "virtual:ox-content/collections" {
@@ -2896,6 +5363,51 @@ declare module "virtual:ox-content/collections" {
   export default api;
 }
 //#endregion
+//#region src/resolve-options.d.ts
+declare function resolveBuiltinEmbedOptions(options: OxContentOptions["embeds"]): ResolvedOptions["embeds"];
+declare function resolveMathOptions(options: OxContentOptions["math"]): ResolvedOptions["math"];
+declare function resolveBadgeOptions(options: OxContentOptions["badges"]): ResolvedOptions["badges"];
+declare function resolveKeyboardKeysOptions(options: OxContentOptions["keyboardKeys"]): NonNullable<ResolvedOptions["keyboardKeys"]>;
+//#endregion
+//#region src/abbreviations-options.d.ts
+declare function resolveAbbreviationsOptions(options: OxContentOptions["abbreviations"]): ResolvedAbbreviationsOptions;
+//#endregion
+//#region src/not-by-ai-options.d.ts
+declare function resolveNotByAiOptions(options: OxContentOptions["notByAi"]): ResolvedOptions["notByAi"];
+//#endregion
+//#region src/card-options.d.ts
+declare function resolveCardOptions(options: OxContentOptions["cards"]): ResolvedOptions["cards"];
+//#endregion
+//#region src/include-options.d.ts
+declare function resolveIncludeOptions(options: OxContentOptions["includes"]): ResolvedOptions["includes"];
+//#endregion
+//#region src/partials-options.d.ts
+declare function resolvePartialsOptions(options: OxContentOptions["partials"]): NonNullable<ResolvedOptions["partials"]>;
+//#endregion
+//#region src/step-options.d.ts
+declare function resolveStepsOptions(options: OxContentOptions["steps"]): ResolvedOptions["steps"];
+//#endregion
+//#region src/code-group-options.d.ts
+declare function resolveCodeGroupOptions(options: OxContentOptions["codeGroups"]): ResolvedCodeGroupOptions;
+//#endregion
+//#region src/file-tree-options.d.ts
+declare function resolveFileTreeOptions(options: OxContentOptions["fileTree"]): ResolvedOptions["fileTree"];
+//#endregion
+//#region src/data-table-options.d.ts
+declare function resolveDataTableOptions(options: OxContentOptions["dataTables"]): ResolvedOptions["dataTables"];
+//#endregion
+//#region src/image-gallery-options.d.ts
+declare function resolveImageGalleryOptions(options: OxContentOptions["imageGalleries"]): ResolvedImageGalleryOptions;
+//#endregion
+//#region src/timeline-options.d.ts
+declare function resolveTimelineOptions(options: OxContentOptions["timelines"]): ResolvedTimelineOptions;
+//#endregion
+//#region src/heading-permalinks-options.d.ts
+declare function resolveHeadingPermalinksOptions(options: OxContentOptions["headingPermalinks"]): ResolvedOptions["headingPermalinks"];
+//#endregion
+//#region src/typed-hover.d.ts
+declare function resolveTypedHoverOptions(options: OxContentOptions["typedHover"]): ResolvedTypedHoverOptions;
+//#endregion
 //#region src/environment.d.ts
 /**
  * Creates the Markdown processing environment configuration.
@@ -2928,6 +5440,11 @@ interface IncrementalMarkdownParserOptions {
    * @default true
    */
   gfm?: boolean;
+  /**
+   * Enable MDX JSX, ESM, and expression nodes.
+   * @default false
+   */
+  mdx?: boolean;
   /**
    * Enable footnotes.
    * @default true
@@ -3057,6 +5574,9 @@ declare function renderMarkdownStream(chunks: MarkdownChunkSource, options?: Inc
  * - `html` (string): Rendered HTML content with all enhancements applied
  * - `frontmatter` (object): Parsed YAML frontmatter as JavaScript object
  * - `toc` (array): Hierarchical table of contents entries
+ * - `imports` (array): MDX import statements (`source` + specifiers)
+ * - `exports` (array): MDX export names
+ * - `components` (array): Unique JSX component names
  * - `render` (function): Client-side render function for dynamic updates
  *
  * ## Markdown Features Supported
@@ -3104,7 +5624,6 @@ declare function renderMarkdownStream(chunks: MarkdownChunkSource, options?: Inc
  *
  * const options = resolveOptions({
  *   highlight: true,
- *   highlightTheme: 'github-dark',
  *   toc: true,
  *   gfm: true,
  *   mermaid: true,
@@ -3132,6 +5651,158 @@ interface SsgTransformOptions {
 }
 declare function transformMarkdown(source: string, filePath: string, options: ResolvedOptions, ssgOptions?: SsgTransformOptions): Promise<TransformResult>;
 //#endregion
+//#region src/render-markdown.d.ts
+/**
+ * Processor that resolves `OxContentOptions` once and renders many documents.
+ */
+interface MarkdownProcessor {
+  render(source: string, filePath: string): Promise<TransformResult>;
+}
+/**
+ * Resolves public options once so custom `ssg: false` hosts can reuse the pipeline.
+ */
+declare function createMarkdownProcessor(options?: OxContentOptions): MarkdownProcessor;
+/**
+ * Run the Vite plugin Markdown/MDX pipeline from public `OxContentOptions`.
+ *
+ * Returns structured `TransformResult` fields (`html`, `frontmatter`, `toc`,
+ * MDX metadata) so consumers do not need to cast a Vite hook or parse
+ * generated module source. `.md` / `.mdx` inference matches `oxContent()`.
+ */
+declare function renderMarkdown(source: string, filePath: string, options?: OxContentOptions): Promise<TransformResult>;
+//#endregion
+//#region src/markdown.d.ts
+declare const DEFAULT_MARKDOWN_EXTENSIONS: readonly [".md", ".markdown", ".mdx"];
+declare function normalizeMarkdownExtensions(extensions?: readonly string[]): string[];
+declare function isMarkdownFilePath(filePath: string, extensions?: readonly string[]): boolean;
+/** Returns true when a resource id points at an MDX source file. */
+declare function isMdxFilePath(filePath: string): boolean;
+/** Explicit configuration wins; otherwise MDX follows the source extension. */
+declare function resolveMdxForFilePath(filePath: string, configured?: boolean): boolean;
+declare function stripMarkdownExtension(filePath: string, extensions?: readonly string[]): string;
+//#endregion
+//#region src/mdx-islands.d.ts
+/**
+ * Discover registered MDX islands from the mdast tree or rendered HTML.
+ *
+ * Framework plugins use this instead of a source regex when MDX is on, so
+ * nested JSX, expression attributes, and fragments stay visible. Names that
+ * are not in the global `components` map and are not document-local import
+ * bindings are left as static HTML.
+ */
+/** Global component map: object, Map, or name list. */
+type ComponentRegistry = Readonly<Record<string, unknown>> | ReadonlyMap<string, unknown> | Iterable<string>;
+/**
+ * Collect named MDX JSX tags from a parsed mdast tree (JSON from NAPI `parse()`).
+ * Fragments (`name: null`) and non-JSX nodes are ignored. Walks nested children
+ * so inner islands are found.
+ */
+declare function collectMdxJsxNamesFromAst(ast: unknown): string[];
+/**
+ * Collect `data-ox-island` names from Rust-rendered HTML.
+ * Used when an AST walk is unavailable.
+ */
+declare function collectMdxIslandNamesFromHtml(html: string): string[];
+/** Keep names that exist on the global component map, in first-seen order. */
+declare function intersectRegisteredComponentNames(names: Iterable<string>, components: ComponentRegistry): string[];
+/**
+ * Keep names that are either globally registered or document-local bindings.
+ */
+declare function intersectHydratableComponentNames(names: Iterable<string>, components: ComponentRegistry, localNames?: Iterable<string>): string[];
+interface DiscoverRegisteredMdxComponentsInput {
+  /** Markdown/MDX body (frontmatter already stripped). */
+  source: string;
+  /** Rendered HTML, used when `parse()` is missing or the AST walk fails. */
+  html?: string;
+  components: ComponentRegistry;
+  /** Document-local import bindings. These override the global map for this file. */
+  localNames?: Iterable<string>;
+}
+/**
+ * Resolve registered island names for an MDX document.
+ *
+ * Prefers a NAPI `parse()` AST walk. Falls back to rendered `data-ox-island`
+ * names so plugins still hydrate if #659 metadata is not present.
+ */
+declare function discoverRegisteredMdxComponents(input: DiscoverRegisteredMdxComponentsInput): Promise<string[]>;
+declare function isRegisteredComponent(name: string, components: ComponentRegistry): boolean;
+//#endregion
+//#region src/document-imports.d.ts
+interface ResolveDocumentComponentImportsInput {
+  imports: readonly MdxImport[];
+  documentPath: string;
+  contentRoot?: string;
+  srcDir?: string;
+}
+interface ResolvedDocumentComponentImport {
+  localName: string;
+  specifier: string;
+  resolvedPath: string;
+  importPathRelativeToDocument: string;
+  imported: string;
+  kind: Exclude<MdxImportSpecifierKind, "namespace">;
+}
+type DocumentImportDiagnosticCode = "not-relative" | "escapes-root" | "duplicate-binding";
+interface DocumentImportDiagnostic {
+  code: DocumentImportDiagnosticCode;
+  message: string;
+  specifier: string;
+  localName?: string;
+}
+interface ResolveDocumentComponentImportsResult {
+  bindings: ResolvedDocumentComponentImport[];
+  diagnostics: DocumentImportDiagnostic[];
+}
+declare function resolveContentRootPath(input: {
+  contentRoot?: string;
+  srcDir?: string;
+  root?: string;
+}): string;
+declare function stripViteQuery(id: string): string;
+declare function resolveDocumentComponentImports(input: ResolveDocumentComponentImportsInput): ResolveDocumentComponentImportsResult;
+//#endregion
+//#region src/document-islands.d.ts
+interface DiscoverDocumentMdxIslandsInput {
+  source: string;
+  html?: string;
+  components: ComponentRegistry;
+  imports: readonly MdxImport[];
+  documentPath: string;
+  contentRoot?: string;
+  srcDir?: string;
+  root?: string;
+}
+interface DiscoverDocumentMdxIslandsResult {
+  usedComponents: string[];
+  localBindings: Map<string, ResolvedDocumentComponentImport>;
+  diagnostics: DocumentImportDiagnostic[];
+}
+declare function discoverDocumentMdxIslands(input: DiscoverDocumentMdxIslandsInput): Promise<DiscoverDocumentMdxIslandsResult>;
+//#endregion
+//#region src/island-codegen.d.ts
+type GlobalComponentMap = Readonly<Record<string, string>> | ReadonlyMap<string, string>;
+interface RenderIslandComponentImportsInput {
+  globalComponents: GlobalComponentMap;
+  localBindings?: ReadonlyMap<string, ResolvedDocumentComponentImport>;
+  documentPath: string;
+  root?: string;
+}
+declare function renderIslandComponentImports(usedComponents: readonly string[], input: RenderIslandComponentImportsInput): string;
+//#endregion
+//#region src/island-ssr.d.ts
+/**
+ * Optional adapter-side island SSR.
+ *
+ * Framework plugins may supply `renderIsland` to replace island inner HTML at
+ * transform time. This helper stays framework-neutral and does not import a
+ * framework SSR runtime.
+ */
+type RenderIslandFn = (name: string, props: Record<string, unknown>, filePath: string) => string | Promise<string>;
+declare function applyIslandSsrHtml(html: string, renderIsland: RenderIslandFn, filePath: string, names?: Iterable<string>): Promise<string>;
+//#endregion
+//#region src/resolve-image-options.d.ts
+declare function resolveImageOptions(options: OxContentOptions["images"]): ResolvedOptions["images"];
+//#endregion
 //#region src/framework.d.ts
 type FrameworkRenderTarget = "html" | "native";
 type FrameworkCodegenTarget = "react" | "vue" | "svelte";
@@ -3153,6 +5824,10 @@ interface FrameworkMarkdownOptions {
     github?: ResolvedOptions["embeds"]["github"];
     openGraph?: ResolvedOptions["embeds"]["openGraph"];
   };
+  math?: boolean | {
+    enabled?: boolean;
+  };
+  mdx?: boolean;
 }
 interface FrameworkComponentIsland {
   name: string;
@@ -3434,10 +6109,14 @@ declare function extractDocs(srcDirs: string[], options: ResolvedDocsOptions): P
  * Generates Markdown documentation from extracted docs.
  */
 declare function generateMarkdown(docs: ExtractedDocs[], options: ResolvedDocsOptions): Record<string, string>;
+/**
+ * Generates Markdown documentation from local OpenAPI 3.0/3.1 files.
+ */
+declare function generateOpenApiDocs(options: ResolvedDocsOptions, root?: string): GeneratedOpenApiDocs;
 /**
  * Writes generated documentation to the output directory.
  */
-declare function writeDocs(docs: Record<string, string>, outDir: string, extractedDocs?: ExtractedDocs[], options?: ResolvedDocsOptions): Promise<void>;
+declare function writeDocs(docs: Record<string, string>, outDir: string, extractedDocs?: ExtractedDocs[], options?: ResolvedDocsOptions, extraNav?: DocsNavigationItem[]): Promise<void>;
 /**
  * Resolves docs options with defaults.
  */
@@ -3579,6 +6258,12 @@ interface MarkdownLintOptions {
    * @default {}
    */
   dictionary?: MarkdownLintDictionaryOptions;
+  /**
+   * Enable MDX-aware syntax masking while linting visible prose.
+   * File-oriented APIs infer this from `.mdx` when omitted.
+   * @default false for content APIs; inferred for file APIs
+   */
+  mdx?: boolean;
 }
 /**
  * A single Markdown lint diagnostic.
@@ -3756,6 +6441,306 @@ interface SsgBuildResult {
  */
 declare function buildSsg(options: ResolvedOptions, root: string): Promise<SsgBuildResult>;
 //#endregion
+//#region src/page-head.d.ts
+/** How invalid head descriptors are reported. */
+type HeadValidationMode = false | "off" | "warn" | "strict";
+interface SiteHead {
+  name?: string;
+  url?: string;
+  locale?: string;
+  titleTemplate?: string;
+}
+interface HeadMeta {
+  key?: string;
+  name?: string;
+  property?: string;
+  httpEquiv?: string;
+  content: string;
+}
+interface HeadLink {
+  key?: string;
+  rel: string;
+  href: string;
+  hreflang?: string;
+  type?: string;
+  sizes?: string;
+}
+interface HeadAlternate {
+  lang: string;
+  href: string;
+}
+interface HeadJsonLd {
+  key?: string;
+  json: string;
+}
+/**
+ * Build-time page-head input. Unhead-shaped, no client runtime.
+ *
+ * Unknown keys such as `twitter.imggg` are a TypeScript error here. Use
+ * `metas` / `links` for extra tags.
+ */
+interface HeadInput {
+  site?: SiteHead;
+  title?: string;
+  titleTemplate?: string;
+  titleSuffix?: boolean;
+  description?: string;
+  canonical?: string;
+  robots?: string;
+  ogImage?: string;
+  ogType?: string;
+  twitterCard?: "summary" | "summary_large_image" | (string & {});
+  social?: boolean;
+  emitSiteName?: boolean;
+  trusted?: boolean;
+  metas?: HeadMeta[];
+  links?: HeadLink[];
+  alternates?: HeadAlternate[];
+  jsonLd?: HeadJsonLd[];
+  validation?: "off" | "warn" | "strict";
+}
+interface HeadDiagnostic {
+  strict: boolean;
+  message: string;
+}
+interface RenderedHead {
+  html: string;
+  diagnostics: HeadDiagnostic[];
+}
+/** Resolve descriptors to escaped `<head>` markup. Build-time only. */
+declare function renderHead(input: HeadInput): RenderedHead;
+declare function resolveHeadValidation(value: HeadValidationMode | undefined): false | "warn" | "strict";
+//#endregion
+//#region src/not-found.d.ts
+/**
+ * Resolves `ssg.notFound` with defaults.
+ *
+ * `false` / omitted stays off. `true` enables `404.md` → `404.html`. An object
+ * enables the feature and overrides only the fields the site set.
+ */
+declare function resolveNotFoundOptions(value: boolean | NotFoundOptions | undefined): ResolvedNotFoundOptions;
+//#endregion
+//#region src/site-maps.d.ts
+/** One page considered for crawl manifests. */
+interface SiteMapPageInput {
+  loc: string;
+  title: string;
+  description?: string;
+  /** Source-file git commit time in milliseconds. Omitted when Git has no history. */
+  lastUpdated?: number;
+  draft?: boolean;
+  unlisted?: boolean;
+}
+/** Inputs for writing crawl manifests next to generated HTML. */
+interface WriteSiteMapFilesInput {
+  outDir: string;
+  siteUrl?: string;
+  base: string;
+  siteName?: string;
+  siteDescription?: string;
+  options?: ResolvedSiteMapsOptions;
+  pages: readonly SiteMapPageInput[];
+}
+/**
+ * Resolves `siteMaps` with defaults.
+ *
+ * `false` / omitted stays off. `true` enables all three files. An object
+ * enables the feature and overrides only the fields the site set.
+ */
+declare function resolveSiteMapsOptions(value: boolean | SiteMapsOptions | undefined): ResolvedSiteMapsOptions;
+/** Writes enabled crawl manifests into `outDir`. */
+declare function writeSiteMapFiles(input: WriteSiteMapFilesInput): Promise<{
+  files: string[];
+  warning?: string;
+}>;
+//#endregion
+//#region src/markdown-source.d.ts
+/** One page that may receive a source companion. */
+interface MarkdownSourcePageInput {
+  inputPath: string;
+  /** Already-read source bytes. Omitted pages are skipped. */
+  source?: string;
+  urlPath: string;
+  frontmatter: Record<string, unknown>;
+}
+/** Inputs for writing companions next to generated HTML. */
+interface WriteMarkdownSourceFilesInput {
+  outDir: string;
+  base: string;
+  options?: ResolvedMarkdownSourceOptions | null;
+  publishState?: ResolvedPublishStateOptions;
+  pages: readonly MarkdownSourcePageInput[];
+}
+/**
+ * Resolves `ssg.markdownSource` with defaults.
+ *
+ * `false` / omitted stays off. `true` enables companions and the alternate
+ * link. An object enables the feature and overrides only the fields set.
+ */
+declare function resolveMarkdownSourceOptions(value: boolean | MarkdownSourceOptions | undefined): ResolvedMarkdownSourceOptions;
+//#endregion
+//#region src/publish-state.d.ts
+/** Split pages into production output vs listing surfaces. */
+interface PartitionedPages<T> {
+  output: T[];
+  listed: T[];
+}
+/**
+ * Resolves `publishState` with defaults.
+ *
+ * `false` / omitted stays off. `true` enables production filtering. An object
+ * enables the feature and overrides only the fields the site set.
+ */
+declare function resolvePublishStateOptions(value: boolean | PublishStateOptions | undefined): ResolvedPublishStateOptions;
+/** Classifies one frontmatter object. Never throws. */
+declare function classifyPublishState(frontmatter: Record<string, unknown>, options: ResolvedPublishStateOptions | undefined): {
+  output: boolean;
+  listed: boolean;
+};
+/** Splits pages into those that write HTML and those that appear in listings. */
+declare function partitionPublishedPages<T extends {
+  frontmatter: Record<string, unknown>;
+}>(pages: readonly T[], options: ResolvedPublishStateOptions | undefined): PartitionedPages<T>;
+//#endregion
+//#region src/permalinks.d.ts
+/** Resolves `permalinks`. `false` / omitted stays off. `true` / `{}` enables. */
+declare function resolvePermalinksOptions(value: boolean | PermalinksOptions | undefined): ResolvedPermalinksOptions;
+/** Resolves `cascade`. `false` / omitted stays off. `true` / `{}` enables. */
+declare function resolveCascadeOptions(value: boolean | CascadeOptions | undefined): ResolvedCascadeOptions;
+//#endregion
+//#region src/redirects.d.ts
+/**
+ * Resolves `redirects` with defaults.
+ *
+ * `false` / omitted stays off. `true` or `{}` enables empty defaults.
+ * A path map (`{ "/old": "/new" }`) enables the feature with that map.
+ * `{ map, provider, headers, json, allowExternal }` overrides only set fields.
+ * Pass `env` to inject CI detection without reading the real `process.env`.
+ */
+declare function resolveRedirectsOptions(value: boolean | RedirectsOptions | Record<string, string> | undefined, env?: NodeJS.ProcessEnv): ResolvedRedirectsOptions;
+//#endregion
+//#region src/feeds.d.ts
+/** One collection entry considered for a feed. */
+interface FeedItemInput {
+  title?: string;
+  description?: string;
+  path?: string;
+  loc?: string;
+  date?: unknown;
+  lastUpdated?: unknown;
+  draft?: unknown;
+  unlisted?: unknown;
+  frontmatter?: Record<string, unknown>;
+}
+/** Inputs for rendering feed bodies. */
+interface FeedsRenderInput {
+  options?: ResolvedFeedsOptions | null;
+  siteUrl?: string;
+  siteName?: string;
+  siteDescription?: string;
+  base?: string;
+  collections?: Record<string, readonly FeedItemInput[]>;
+  collectionNames?: readonly string[];
+  items?: readonly FeedItemInput[];
+  publishState?: ResolvedPublishStateOptions;
+}
+/** Inputs for writing feeds next to generated HTML. */
+interface WriteFeedFilesInput extends FeedsRenderInput {
+  outDir: string;
+  base: string;
+}
+/**
+ * Resolves `feeds` with defaults.
+ *
+ * `false` / omitted stays off. `true` enables all three formats with
+ * collection `content` (or the first configured collection) and limit 20.
+ * A single object is one default feed. A named record or array writes
+ * multiple feeds.
+ */
+declare function resolveFeedsOptions(value: boolean | FeedsOptions | undefined): ResolvedFeedsOptions;
+/** Writes enabled feed files into `outDir`. */
+declare function writeFeedFiles(input: WriteFeedFilesInput): Promise<{
+  files: string[];
+  warning?: string;
+}>;
+//#endregion
+//#region src/blog-options.d.ts
+declare function resolveBlogOptions(value: boolean | BlogOptions | undefined): ResolvedBlogOptions;
+/**
+ * Picks a collection named `blog`, else the only configured collection.
+ *
+ * An explicit name always wins. Several collections and no `blog` name
+ * require `blog.collection`.
+ */
+declare function resolveBlogCollectionName(requested: string | undefined, collectionNames: readonly string[]): string | undefined;
+//#endregion
+//#region src/blog-feeds.d.ts
+declare class BlogFeedError extends Error {
+  readonly issues: string[];
+  constructor(issues: string[]);
+}
+//#endregion
+//#region src/blog-reading.d.ts
+/**
+ * Deterministic blog reading-time estimates.
+ */
+declare function readingTimeMinutes(markdown: string): number;
+//#endregion
+//#region src/pwa.d.ts
+/**
+ * Resolves `pwa` with defaults.
+ *
+ * `false` / omitted stays off. `true` enables the manifest and offline
+ * service worker. An object enables the feature and overrides only the
+ * fields the site set.
+ */
+declare function resolvePwaOptions(value: boolean | PwaOptions | undefined): ResolvedPwaOptions;
+//#endregion
+//#region src/taxonomies.d.ts
+/**
+ * Resolves `taxonomies` with defaults.
+ *
+ * `false` / omitted stays off. `true` enables `tags` and `categories` with
+ * relatedLimit 5. An object enables the feature and overrides only set fields.
+ */
+declare function resolveTaxonomiesOptions(value: boolean | TaxonomiesOptions | undefined): ResolvedTaxonomiesOptions;
+//#endregion
+//#region src/versions.d.ts
+/**
+ * Resolves `versions`. Omitted / `false` stay off. `true` enables a single
+ * current entry. An object enables the feature and overrides set fields.
+ */
+declare function resolveVersionsOptions(value: boolean | VersionsOptions | undefined): ResolvedVersionsOptions;
+//#endregion
+//#region src/resources.d.ts
+declare class PageResourceError extends Error {
+  readonly issues: string[];
+  constructor(issues: string[]);
+}
+/**
+ * Resolves `resources`. Omitted / `false` stay off. `true` or `{}` enables
+ * defaults. An object enables the feature and overrides only set fields.
+ */
+declare function resolveResourcesOptions(value: boolean | ResourcesOptions | undefined): ResolvedResourcesOptions;
+//#endregion
+//#region src/team.d.ts
+/**
+ * Resolves `ssg.team` with defaults.
+ *
+ * `false` / omitted stays off. `true` enables an empty member list.
+ * An object enables the feature and keeps the members the site set.
+ */
+declare function resolveTeamOptions(value: boolean | TeamOptions | undefined): ResolvedTeamOptions;
+//#endregion
+//#region src/section-index.d.ts
+/**
+ * Resolves `ssg.sectionIndex` with defaults.
+ *
+ * `false` / omitted stays off. `true` enables card listings. An object
+ * enables the feature and overrides only the fields the site set.
+ */
+declare function resolveSectionIndexOptions(value: boolean | SectionIndexOptions | undefined): ResolvedSectionIndexOptions;
+//#endregion
 //#region src/search.d.ts
 /**
  * Resolves search options with defaults.
@@ -3763,8 +6748,12 @@ declare function buildSsg(options: ResolvedOptions, root: string): Promise<SsgBu
 declare function resolveSearchOptions(options: SearchOptions | boolean | undefined): ResolvedSearchOptions;
 /**
  * Builds the search index from Markdown files.
+ *
+ * `publishState` is forwarded to the native indexer. `excludeDocumentIds`
+ * then drops matching documents and rebuilds the BM25 index so omitted
+ * pages (such as the opt-in 404 source) are not searchable.
  */
-declare function buildSearchIndex(srcDir: string, base: string, extensions?: readonly string[]): Promise<string>;
+declare function buildSearchIndex(srcDir: string, base: string, extensions?: readonly string[], publishState?: ResolvedPublishStateOptions, excludeDocumentIds?: readonly string[], mdx?: boolean): Promise<string>;
 /**
  * Writes the search index to a file.
  */
@@ -3777,12 +6766,6 @@ declare function resolveCollectionsOptions(options: CollectionsOptions | boolean
 declare function buildCollectionManifest(root: string, options: ResolvedOptions): Promise<CollectionManifest>;
 declare function generateCollectionsVirtualModule(root: string, options: ResolvedOptions): Promise<string>;
 //#endregion
-//#region src/markdown.d.ts
-declare const DEFAULT_MARKDOWN_EXTENSIONS: readonly [".md", ".markdown", ".mdx"];
-declare function normalizeMarkdownExtensions(extensions?: readonly string[]): string[];
-declare function isMarkdownFilePath(filePath: string, extensions?: readonly string[]): boolean;
-declare function stripMarkdownExtension(filePath: string, extensions?: readonly string[]): string;
-//#endregion
 //#region src/vitepress.d.ts
 interface VitePressLogo {
   light?: string;
@@ -3915,7 +6898,7 @@ declare function generateHydrationScript(components: string[]): string;
 //#endregion
 //#region src/og-image/types.d.ts
 /**
- * Type definitions for Chromium-based OG image generation.
+ * Type definitions for OG image generation.
  */
 /**
  * Props passed to OG image template functions.
@@ -3938,10 +6921,66 @@ interface OgImageTemplateProps {
  * Template function that receives page metadata and returns an HTML string.
  */
 type OgImageTemplateFn = (props: OgImageTemplateProps) => string | Promise<string>;
+/**
+ * OG image rendering backend.
+ */
+type OgImageRenderer$1 = "chromium" | "satori";
+/**
+ * Font weight values supported by Satori.
+ */
+type OgImageSatoriFontWeight$1 = 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+/**
+ * Font file loaded by the Satori renderer.
+ */
+interface OgImageSatoriFont$1 {
+  /**
+   * Absolute path, or a path relative to the project root.
+   */
+  path: string;
+  /**
+   * Font family name used by template CSS.
+   */
+  name?: string;
+  /**
+   * Font weight.
+   * @default 400
+   */
+  weight?: OgImageSatoriFontWeight$1;
+  /**
+   * Font style.
+   * @default "normal"
+   */
+  style?: "normal" | "italic";
+}
+/**
+ * Satori renderer options.
+ */
+interface OgImageSatoriOptions$1 {
+  /**
+   * Font files passed to Satori.
+   *
+   * Satori cannot render text without at least one font. When omitted,
+   * Ox Content tries a small set of system font paths unless
+   * `systemFontFallback` is disabled.
+   */
+  fonts?: OgImageSatoriFont$1[];
+  /**
+   * Try known OS font paths when `fonts` is empty.
+   * @default true
+   */
+  systemFontFallback?: boolean;
+}
 /**
  * OG image generation options (user-facing).
  */
 interface OgImageOptions$1 {
+  /**
+   * Rendering backend.
+   * - `"chromium"`: full browser rendering, best template compatibility
+   * - `"satori"`: fast HTML-to-SVG-to-PNG rendering, limited CSS subset
+   * @default "chromium"
+   */
+  renderer?: OgImageRenderer$1;
   /**
    * Path to a custom template file (.ts, .vue, .svelte, .tsx/.jsx).
    * - `.ts`: default-export a function `(props) => string`
@@ -3979,17 +7018,26 @@ interface OgImageOptions$1 {
    * @default 1
    */
   concurrency?: number;
+  /**
+   * Options for the Satori renderer.
+   */
+  satori?: OgImageSatoriOptions$1;
 }
 /**
  * Resolved OG image options with all defaults applied.
  */
 interface ResolvedOgImageOptions {
+  renderer: OgImageRenderer$1;
   template?: string;
   vuePlugin: "vitejs" | "vizejs";
   width: number;
   height: number;
   cache: boolean;
   concurrency: number;
+  satori: {
+    fonts: OgImageSatoriFont$1[];
+    systemFontFallback: boolean;
+  };
 }
 //#endregion
 //#region src/og-image/browser.d.ts
@@ -4034,7 +7082,7 @@ interface OgImageResult {
 /**
  * Generates OG images for a batch of pages.
  *
- * Manages the full lifecycle: resolve template → launch browser (with `using`) →
+ * Manages the full lifecycle: resolve template → select renderer →
  * render each page (with caching and concurrency).
  *
  * All errors are non-fatal: failures are reported in results but never throw.
@@ -4051,6 +7099,115 @@ declare function resolveI18nOptions(options: I18nOptions | false | undefined): R
  */
 declare function createI18nPlugin(resolvedOptions: ResolvedOptions): Plugin;
 //#endregion
+//#region src/ssg-output-write.d.ts
+/** One host-rendered page that may receive resource fingerprinting. */
+interface WriteResourceFilesPage {
+  html: string;
+  inputPath: string;
+  outputPath: string;
+}
+/** Inputs for writing fingerprinted page resources from host HTML. */
+interface WriteResourceFilesInput {
+  pages: readonly WriteResourceFilesPage[];
+  srcDir: string;
+  outDir: string;
+  root?: string;
+  base?: string;
+  options?: ResolvedResourcesOptions | null;
+  cacheDir?: string;
+}
+/** Rewritten host pages plus emitted resource paths. */
+interface WriteResourceFilesResult {
+  pages: WriteResourceFilesPage[];
+  files: string[];
+  errors: string[];
+}
+/**
+ * Fingerprint, rewrite, and emit page resources for host-rendered HTML.
+ *
+ * Uses the same `resources` option object and emit path as `buildSsg()`.
+ * Throws `PageResourceError` when `missing: "error"` hits a fatal issue.
+ */
+declare function writeResourceFiles(input: WriteResourceFilesInput): Promise<WriteResourceFilesResult>;
+/**
+ * Write Markdown companions for host-rendered pages.
+ *
+ * Reuses `writeMarkdownSourceFiles` from the copy-as-markdown pipeline.
+ */
+declare function writeMarkdownCompanions(input: WriteMarkdownSourceFilesInput): Promise<{
+  files: string[];
+  errors: string[];
+}>;
+/**
+ * Git last-commit time for `filePath` in milliseconds.
+ *
+ * Same lookup `buildSsg()` uses for `ssg.lastUpdated` and sitemap `<lastmod>`.
+ * Returns `undefined` when `root` is missing, Git has no history, or NAPI is unavailable.
+ */
+declare function resolveGitLastmod(filePath: string, root?: string): number | undefined;
+//#endregion
+//#region src/ssg-output.d.ts
+/** Same option objects `oxContent()` / `buildSsg()` accept. `ssg.enabled` is ignored. */
+interface PlanSsgOutputsOptions {
+  base?: string;
+  resources?: boolean | ResourcesOptions;
+  feeds?: boolean | FeedsOptions;
+  siteMaps?: boolean | SiteMapsOptions;
+  publishState?: boolean | PublishStateOptions;
+  ssg?: boolean | SsgOptions;
+}
+/** Inputs for planning composable SSG outputs from host-rendered pages. */
+interface PlanSsgOutputsInput {
+  pages: readonly SsgOutputPageInput[];
+  outDir: string;
+  srcDir?: string;
+  root?: string;
+  siteDescription?: string;
+  collections?: Record<string, readonly FeedItemInput[]>;
+  collectionNames?: readonly string[];
+  items?: readonly FeedItemInput[];
+  options?: PlanSsgOutputsOptions | Pick<OxContentOptions, keyof PlanSsgOutputsOptions>;
+}
+/** Planned writer inputs. Call the matching `write*` function for each feature. */
+interface SsgOutputPlan {
+  resources: WriteResourceFilesInput;
+  markdownCompanions: {
+    outDir: string;
+    base: string;
+    options: ResolvedMarkdownSourceOptions;
+    publishState: ResolvedPublishStateOptions;
+    pages: MarkdownSourcePageInput[];
+  };
+  feeds: {
+    outDir: string;
+    base: string;
+    siteUrl?: string;
+    siteName?: string;
+    siteDescription?: string;
+    options: ResolvedFeedsOptions;
+    publishState: ResolvedPublishStateOptions;
+    collections?: Record<string, readonly FeedItemInput[]>;
+    collectionNames?: readonly string[];
+    items?: readonly FeedItemInput[];
+  };
+  siteMaps: {
+    outDir: string;
+    base: string;
+    siteUrl?: string;
+    siteName?: string;
+    siteDescription?: string;
+    options: ResolvedSiteMapsOptions;
+    pages: SiteMapPageInput[];
+  };
+}
+/**
+ * Plan resource, companion, feed, and sitemap outputs without rendering pages.
+ *
+ * `ssg.enabled` is ignored. Use `ssg: { enabled: false, markdownSource, lastUpdated, siteUrl }`
+ * so those fields still resolve. `lastUpdated` on a page wins over git.
+ */
+declare function planSsgOutputs(input: PlanSsgOutputsInput): SsgOutputPlan;
+//#endregion
 //#region src/index.d.ts
 /**
  * Creates the Ox Content Vite plugin.
@@ -4072,11 +7229,10 @@ declare function createI18nPlugin(resolvedOptions: ResolvedOptions): Plugin;
  * ```
  */
 declare function oxContent(options?: OxContentOptions): Plugin[];
-declare function resolveBuiltinEmbedOptions(options: OxContentOptions["embeds"]): ResolvedOptions["embeds"];
 /**
  * Generates virtual module content.
  */
 declare function generateVirtualModule(path: string, options: ResolvedOptions): string;
 //#endregion
-export { AttrsOptions, type BasePageProps, BuiltinEmbedOptions, BuiltinPmOptions, CodeAnnotationKind, CodeAnnotationSyntax, CodeAnnotationsOptions, type CodeBlockDiagnostic, CodeBlockLintOptions, CodeBlockTypecheckOptions, CodeImportOptions, type CollectedDocsTest, CollectionEntry, CollectionIncludeField, CollectionManifest, CollectionOptions, CollectionQueryBuilder, CollectionQueryOperator, CollectionsOptions, DEFAULT_HTML_TEMPLATE, DEFAULT_MARKDOWN_EXTENSIONS, DefaultTheme, DocEntry, DocMember, DocsEntryPoint, DocsOptions, DocsSortStrategy, DocsSummary, type DocsTestFileOptions, type DocsTestHarnessOptions, DocsTestOptions, DocsTestRunError, type DocsTestRunResult, type DocsTestSource, type DocsTestWriteResult, EditThisPageOptions, EmojiShortcodeOptions, EntryPageConfig, type ExtractedCodeBlock, ExtractedDocs, FeatureConfig, Fragment, type FrameworkCodegenMode, type FrameworkCodegenTarget, type FrameworkComponentIsland, type FrameworkMarkdownOptions, type FrameworkRenderTarget, type FrameworkTransformData, type FrontmatterSchema, type GenerateVitePressMigrationConfigOptions, GeneratedDocsData, type GitHubLineRange, type GitHubOptions, type GitHubRepoData, type GitHubSourceData, type GitHubSourceRef, HeroAction, HeroConfig, HeroImage, HeroNotice, I18nOptions, type IncrementalMarkdownParseAppendOptions, type IncrementalMarkdownParseResult, IncrementalMarkdownParser, type IncrementalMarkdownParserOptions, type IncrementalMarkdownRenderAppendOptions, type IncrementalMarkdownRenderResult, IncrementalMarkdownRenderer, type IncrementalMarkdownRendererOptions, type IslandInfo, type JSXChild, type JSXElementType, type JSXNode, type JSXProps, type LanguageRegistration, type LoadStrategy, LocaleConfig, type MarkdownChunkSource, MarkdownDisplayFormat, type MarkdownLintFileDiagnostic as MarkdownLintBatchDiagnostic, type MarkdownLintFileDiagnostic, type MarkdownLintDiagnostic, type MarkdownLintDictionaryOptions, type MarkdownLintFileOptions, type MarkdownLintFileOptions as MarkdownLintProjectOptions, type MarkdownLintFileResult, type MarkdownLintFilesResult, type MarkdownLintLanguage, type MarkdownLintOptions, type MarkdownLintResult, type MarkdownLintRuleOptions, type MarkdownLintSeverity, type MarkdownLintStandardDictionaryOptions, MarkdownNode, MarkdownTransformer, type MermaidOptions, type NavGroup, NavItem, type OgBrowserSession, OgImageOptions, type OgImagePageEntry, type OgImageOptions$1 as OgImagePluginOptions, type OgImageResult, type OgImageTemplateFn, type OgImageTemplateProps, type OgpData, type OgpOptions, OxContentOptions, type PageData, type PageProps, ParamDoc, type ParseIslandsResult, type RenderContext, ResolvedAttrsOptions, ResolvedBuiltinEmbedOptions, ResolvedCodeAnnotationsOptions, ResolvedCodeBlockLintOptions, ResolvedCodeBlockTypecheckOptions, ResolvedCodeImportOptions, ResolvedCollectionOptions, ResolvedCollectionsOptions, ResolvedDocsEntryPoint, ResolvedDocsOptions, ResolvedDocsTestOptions, ResolvedEditThisPageOptions, ResolvedEmojiShortcodeOptions, ResolvedI18nOptions, ResolvedOgImageOptions, ResolvedOptions, ResolvedSanitizeOptions, ResolvedSearchOptions, ResolvedSsgOptions, type ResolvedThemeConfig, ResolvedWikiLinkOptions, ReturnDoc, type RunDocsTestsOptions, SanitizeOptions, ScopedSearchQuery, SearchDocument, SearchOptions, SearchResult, type SiteConfig, type SocialLinks, SsgNavigationGroup, SsgNavigationItem, SsgOptions, type ThemeColors, type ThemeComponent, type ThemeConfig, type ThemeEmbed, type ThemeEntryPage, type ThemeFonts, type ThemeFooter, type ThemeHeader, type ThemeLayout, type ThemeProps, type ThemeRegistration, type ThemeRenderOptions, type ThemeTokens, ThrowsDoc, TocEntry, type TransformAllOptions, TransformContext, TransformResult, type TwitterEmbedOptions, type TypecheckCodeBlockOptions, type VitePressConfig, type VitePressFooter, type VitePressLogo, type VitePressNavItem, type VitePressSidebar, type VitePressSidebarItem, type VitePressSocialLink, type VitePressThemeConfig, WikiLinkOptions, type WrittenDocsTestFile, type YouTubeOptions, buildCollectionManifest, buildSearchIndex, buildSsg, clearRenderContext, collectDocsTests, collectGitHubRepos, collectGitHubSources, collectOgpUrls, convertVitePressNav, convertVitePressSidebar, createFrameworkMarkdownOptions, createI18nPlugin, createIncrementalMarkdownParser, createIncrementalMarkdownRenderer, createMarkdownEnvironment, createTheme, defaultTheme, defineCollection, defineCollections, defineTheme, each, escapeSvelteMarkup, extractCodeBlocks, extractDocs, extractDocsTests, extractIslandInfo, extractVideoId, fetchGitHubSource, fetchOgpData, fetchRepoData, fromVitePressConfig, generateCollectionsVirtualModule, generateFrontmatterTypes, generateHydrationScript, generateMarkdown, generateOgImages, generateTabsCSS, generateTypes, generateVirtualModule, generateVitePressMigrationConfig, hasIslands, inferType, isMarkdownFilePath, jsx, jsxs, lintCodeBlocks, lintMarkdown, lintMarkdownAsync, lintMarkdownFile, lintMarkdownFiles, mergeThemes, mermaidClientScript, normalizeMarkdownExtensions, normalizeVitePressFrontmatter, oxContent, parseGitHubLineRange, parseGitHubPermalink, prefetchGitHubRepos, prefetchGitHubSources, prefetchOgpData, raw, renderAllPages, renderHtmlToFrameworkCode, renderHtmlToReactComponent, renderHtmlToReactCreateElement, renderHtmlToSvelteComponent, renderHtmlToVueComponent, renderHtmlToVueH, renderMarkdownStream, renderPage, renderToString, resolveBuiltinEmbedOptions, resolveCollectionsOptions, resolveDocsOptions, resolveI18nOptions, resolveOgImageOptions, resolveSearchOptions, resolveSsgOptions, resolveTheme, runDocsTests, setRenderContext, shouldLintMarkdownFile, stripMarkdownExtension, transformAllPlugins, transformGitHub, transformIslands, transformMarkdown, transformMermaidStatic, transformOgp, transformTabs, transformYouTube, typecheckCodeBlocks, useIsActive, useNav, usePageProps, useRenderContext, useSiteConfig, when, writeDocs, writeDocsTestFiles, writeSearchIndex };
+export { A11yOptions, AbbreviationsOptions, AttrsOptions, BadgeOptions, type BasePageProps, BlogAuthor, BlogFeedError, BlogFeedFailurePolicy, BlogFeedSource, BlogOptions, BuiltinEmbedOptions, BuiltinPmOptions, CardOptions, CascadeOptions, CodeAnnotationKind, CodeAnnotationSyntax, CodeAnnotationsOptions, type CodeBlockDiagnostic, CodeBlockLintOptions, CodeBlockTypecheckOptions, CodeGroupOptions, CodeImportOptions, type CollectedDocsTest, CollectionEntry, CollectionIncludeField, CollectionManifest, CollectionOptions, CollectionQueryBuilder, CollectionQueryOperator, CollectionsOptions, type ComponentRegistry, ContainerOptions, ContainerTypeOptions, ContributorsOptions, DEFAULT_HTML_TEMPLATE, DEFAULT_MARKDOWN_EXTENSIONS, DataTableOptions, DefaultTheme, DefinitionListOptions, type DiscoverDocumentMdxIslandsInput, type DiscoverDocumentMdxIslandsResult, type DiscoverRegisteredMdxComponentsInput, DocEntry, DocMember, DocsEntryPoint, DocsNavigationItem, DocsOptions, DocsSortStrategy, DocsSummary, type DocsTestFileOptions, type DocsTestHarnessOptions, DocsTestOptions, DocsTestRunError, type DocsTestRunResult, type DocsTestSource, type DocsTestWriteResult, type DocumentImportDiagnostic, type DocumentImportDiagnosticCode, EditThisPageOptions, EmojiShortcodeOptions, EntryPageConfig, type ExtractedCodeBlock, ExtractedDocs, FeatureConfig, FeedChannelOptions, FeedFormat, FeedsOptions, FileTreeIconOptions, FileTreeOptions, Fragment, type FrameworkCodegenMode, type FrameworkCodegenTarget, type FrameworkComponentIsland, type FrameworkMarkdownOptions, type FrameworkRenderTarget, type FrameworkTransformData, type FrontmatterSchema, type GenerateVitePressMigrationConfigOptions, GeneratedDocsData, GeneratedOpenApiDocs, type GitHubLineRange, type GitHubOptions, type GitHubRepoData, type GitHubSourceCommit, type GitHubSourceData, type GitHubSourceRef, type GlobalComponentMap, type HeadAlternate, type HeadDiagnostic, type HeadInput, type HeadJsonLd, type HeadLink, type HeadMeta, type HeadValidationMode, type HeaderNavItem, HeadingPermalinksOptions, HeroAction, HeroConfig, HeroImage, HeroNotice, I18nOptions, IconsOptions, ImageGalleryOptions, ImageOptions, IncludeOptions, type IncrementalMarkdownParseAppendOptions, type IncrementalMarkdownParseResult, IncrementalMarkdownParser, type IncrementalMarkdownParserOptions, type IncrementalMarkdownRenderAppendOptions, type IncrementalMarkdownRenderResult, IncrementalMarkdownRenderer, type IncrementalMarkdownRendererOptions, type IslandInfo, type JSXChild, type JSXElementType, type JSXNode, type JSXProps, JsonLdOptions, JsonLdPageType, JsonLdPublisherOptions, KeyboardKeysOptions, type LoadStrategy, LocaleConfig, type LocaleLabel, MagicLinkAlias, MagicLinkImageOverride, MagicLinkOptions, type MarkdownChunkSource, MarkdownDisplayFormat, type MarkdownLintFileDiagnostic as MarkdownLintBatchDiagnostic, type MarkdownLintFileDiagnostic, type MarkdownLintDiagnostic, type MarkdownLintDictionaryOptions, type MarkdownLintFileOptions, type MarkdownLintFileOptions as MarkdownLintProjectOptions, type MarkdownLintFileResult, type MarkdownLintFilesResult, type MarkdownLintLanguage, type MarkdownLintOptions, type MarkdownLintResult, type MarkdownLintRuleOptions, type MarkdownLintSeverity, type MarkdownLintStandardDictionaryOptions, MarkdownNode, type MarkdownProcessor, MarkdownSourceOptions, MarkdownTransformer, MathOptions, MdxImport, MdxImportSpecifier, MdxImportSpecifierKind, type MermaidOptions, type NavGroup, NavItem, NotByAiOptions, NotFoundOptions, type OgBrowserSession, OgImageOptions, type OgImagePageEntry, type OgImageOptions$1 as OgImagePluginOptions, OgImageRenderer, type OgImageResult, OgImageSatoriFont, OgImageSatoriFontWeight, OgImageSatoriOptions, type OgImageTemplateFn, type OgImageTemplateProps, type OgpData, type OgpOptions, OpenApiDocsInput, OpenApiDocsOptions, OpenApiDocsSource, OxContentOptions, type PageChromeFlags, type PageData, type PageProps, PageResourceError, ParamDoc, type ParseIslandsResult, PartialsOptions, PermalinksOptions, type PlanSsgOutputsInput, type PlanSsgOutputsOptions, PublishStateOptions, PwaOptions, ReaderChromeOptions, type RedditEmbedOptions, type RedditPostData, type RedditPostReference, RedirectProvider, RedirectsOptions, type RenderContext, type RenderIslandComponentImportsInput, type RenderIslandFn, type RenderedHead, type ResolveDocumentComponentImportsInput, type ResolveDocumentComponentImportsResult, ResolvedA11y, ResolvedAbbreviationsOptions, ResolvedAttrsOptions, ResolvedBadgeOptions, ResolvedBlogFeedSource, ResolvedBlogOptions, ResolvedBuiltinEmbedOptions, ResolvedCardOptions, ResolvedCascadeOptions, ResolvedCodeAnnotationsOptions, ResolvedCodeBlockLintOptions, ResolvedCodeBlockTypecheckOptions, ResolvedCodeGroupOptions, ResolvedCodeImportOptions, ResolvedCollectionOptions, ResolvedCollectionsOptions, ResolvedContainerOptions, ResolvedContributors, ResolvedDataTableOptions, ResolvedDefinitionListOptions, ResolvedDocsEntryPoint, ResolvedDocsOptions, ResolvedDocsTestOptions, type ResolvedDocumentComponentImport, ResolvedEditThisPageOptions, ResolvedEmojiShortcodeOptions, ResolvedFeedChannel, ResolvedFeedsOptions, ResolvedFileTreeOptions, ResolvedHeadingPermalinksOptions, ResolvedI18nOptions, ResolvedIconsOptions, ResolvedImageGalleryOptions, ResolvedImageOptions, ResolvedIncludeOptions, ResolvedJsonLd, ResolvedKeyboardKeysOptions, ResolvedMagicLinkOptions, ResolvedMarkdownSourceOptions, ResolvedMathOptions, ResolvedNotByAiOptions, ResolvedNotFoundOptions, ResolvedOgImageOptions, ResolvedOpenApiDocsInput, ResolvedOpenApiDocsOptions, ResolvedOptions, ResolvedPartialsOptions, ResolvedPermalinksOptions, ResolvedPublishStateOptions, ResolvedPwaOptions, ResolvedReaderChrome, ResolvedRedirectsOptions, ResolvedResourcesOptions, ResolvedSanitizeOptions, ResolvedSearchOptions, ResolvedSectionIndexOptions, ResolvedSiteMapsOptions, ResolvedSsgOptions, ResolvedStepsOptions, ResolvedTaxonomiesOptions, ResolvedTeamOptions, type ResolvedThemeConfig, ResolvedTimelineOptions, ResolvedTypedHoverOptions, ResolvedVersionEntry, ResolvedVersionsOptions, ResolvedWikiLinkOptions, ResourcesOptions, ReturnDoc, type RunDocsTestsOptions, SanitizeOptions, ScopedSearchQuery, SearchDocument, SearchOptions, SearchResult, SectionIndexOptions, SectionIndexStyle, type SidebarItem, type SiteConfig, type SiteHead, SiteMapsOptions, type SocialLinks, SsgNavigationGroup, SsgNavigationItem, SsgOptions, SsgOutputPageInput, type SsgOutputPlan, StepsOptions, TaxonomiesOptions, TeamLink, TeamMember, TeamOptions, type ThemeAnnouncement, type ThemeColors, type ThemeComponent, type ThemeConfig, type ThemeEmbed, type ThemeEntryPage, type ThemeFontValue, type ThemeFonts, type ThemeFooter, type ThemeHeader, type ThemeLayout, type ThemeProps, type ThemeRenderOptions, type ThemeTokens, type ThemeWebFont, ThrowsDoc, TimelineOptions, TocEntry, type TransformAllOptions, TransformContext, TransformResult, type TwitterEmbedOptions, type TypecheckCodeBlockOptions, TypedHoverOptions, VersionBannerKind, VersionEntry, VersionsOptions, type VitePressConfig, type VitePressFooter, type VitePressLogo, type VitePressNavItem, type VitePressSidebar, type VitePressSidebarItem, type VitePressSocialLink, type VitePressThemeConfig, WikiLinkOptions, type WriteResourceFilesInput, type WriteResourceFilesPage, type WriteResourceFilesResult, type WrittenDocsTestFile, type YouTubeOptions, applyIslandSsrHtml, buildCollectionManifest, buildSearchIndex, buildSsg, classifyPublishState, clearRenderContext, collectDocsTests, collectGitHubRepos, collectGitHubSources, collectMdxIslandNamesFromHtml, collectMdxJsxNamesFromAst, collectOgpUrls, convertVitePressNav, convertVitePressSidebar, createFrameworkMarkdownOptions, createI18nPlugin, createIncrementalMarkdownParser, createIncrementalMarkdownRenderer, createMarkdownEnvironment, createMarkdownProcessor, createTheme, defaultTheme, defineCollection, defineCollections, defineTheme, discoverDocumentMdxIslands, discoverRegisteredMdxComponents, each, escapeSvelteMarkup, extractCodeBlocks, extractDocs, extractDocsTests, extractIslandInfo, extractVideoId, fetchGitHubSource, fetchOgpData, fetchRepoData, fromVitePressConfig, generateCollectionsVirtualModule, generateFrontmatterTypes, generateHydrationScript, generateMarkdown, generateOgImages, generateOpenApiDocs, generateTabsCSS, generateTypes, generateVirtualModule, generateVitePressMigrationConfig, hasIslands, inferType, intersectHydratableComponentNames, intersectRegisteredComponentNames, isMarkdownFilePath, isMdxFilePath, isRegisteredComponent, jsx, jsxs, lintCodeBlocks, lintMarkdown, lintMarkdownAsync, lintMarkdownFile, lintMarkdownFiles, mergeThemes, mermaidClientScript, normalizeMarkdownExtensions, normalizeVitePressFrontmatter, oxContent, parseGitHubLineRange, parseGitHubPermalink, parsePageChromeFlags, parseRedditPostReference, partitionPublishedPages, planSsgOutputs, prefetchGitHubRepos, prefetchGitHubSources, prefetchOgpData, raw, readingTimeMinutes, renderAllPages, renderHead, renderHtmlToFrameworkCode, renderHtmlToReactComponent, renderHtmlToReactCreateElement, renderHtmlToSvelteComponent, renderHtmlToVueComponent, renderHtmlToVueH, renderIslandComponentImports, renderMarkdown, renderMarkdownStream, renderPage, renderToString, resolveAbbreviationsOptions, resolveBadgeOptions, resolveBlogCollectionName, resolveBlogOptions, resolveBuiltinEmbedOptions, resolveCardOptions, resolveCascadeOptions, resolveCodeGroupOptions, resolveCollectionsOptions, resolveContentRootPath, resolveDataTableOptions, resolveDocsOptions, resolveDocumentComponentImports, resolveFeedsOptions, resolveFileTreeOptions, resolveGitLastmod, resolveHeadValidation, resolveHeaderNavItems, resolveHeadingPermalinksOptions, resolveI18nOptions, resolveImageGalleryOptions, resolveImageOptions, resolveIncludeOptions, resolveKeyboardKeysOptions, resolveLocaleLabel, resolveMarkdownSourceOptions, resolveMathOptions, resolveMdxForFilePath, resolveNotByAiOptions, resolveNotFoundOptions, resolveOgImageOptions, resolvePageChromeOption, resolvePartialsOptions, resolvePermalinksOptions, resolvePublishStateOptions, resolvePwaOptions, resolveRedirectsOptions, resolveResourcesOptions, resolveSearchOptions, resolveSectionIndexOptions, resolveSiteMapsOptions, resolveSsgOptions, resolveStepsOptions, resolveTaxonomiesOptions, resolveTeamOptions, resolveTheme, resolveTimelineOptions, resolveTypedHoverOptions, resolveVersionsOptions, runDocsTests, setRenderContext, shouldLintMarkdownFile, stripMarkdownExtension, stripViteQuery, transformAllPlugins, transformGitHub, transformIslands, transformMarkdown, transformMermaidStatic, transformOgp, transformRedditEmbeds, transformTabs, transformYouTube, typecheckCodeBlocks, useIsActive, useNav, usePageProps, useRenderContext, useSiteConfig, when, writeDocs, writeDocsTestFiles, writeFeedFiles, writeMarkdownCompanions, writeResourceFiles, writeSearchIndex, writeSiteMapFiles };
 //# sourceMappingURL=index.d.mts.map