@ox-content/vite-plugin 3.0.0-alpha.8 → 3.0.0-beta.0

package/dist/index.d.cts

@@ -1,4 +1,7 @@
+import { RenderThemeTokenCssOptions, ThemeTokenSource, ThemeTokens, renderThemeTokenCss, tokensToCss } from "./theme-tokens.cjs";
+import { a as readerChromeIsEnabled, c as renderReaderChromeAttributes, d as resolveReaderChromeInput, f as ReaderChromeOptions, i as readerChromeCss, l as renderReaderChromeScriptTag, n as applyReaderChromeHtml, o as readerChromeNeedsJs, p as ResolvedReaderChrome, r as readerChromeAttributes, s as readerChromeScript, t as ReaderChromeInput, u as renderReaderChromeStyleTag } from "./reader-chrome.cjs";
 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.cjs";
+import { MarkdownTableEnhancementOptions, enhanceMarkdownTables, markdownTableScrollLabel } from "./markdown-tables.cjs";
 import { EnvironmentOptions, Plugin } from "vite";
 //#region src/header-chrome.d.ts
 /**
@@ -48,18 +51,32 @@ interface 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-tokens.d.ts
-/**
- * Free-form `--octc-*` custom properties for themes that need more than the
- * typed `colors` / `fonts` / `layout` fields.
- *
- * Keys are written **without** the `--octc-` prefix, so `"surface-glass"`
- * becomes `--octc-surface-glass`. This is the seam that keeps the two theme
- * axes independent: a color package can restyle code-block line markers, brand
- * accents, and surface textures purely through tokens, while a skin package
- * lays out geometry against those same tokens without knowing any color.
- */
-type ThemeTokens = Record<string, string>;
+//#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.d.ts
 /**
@@ -100,12 +117,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.
@@ -211,6 +233,20 @@ interface ThemeConfig {
    * @default true
    */
   viewTransitions?: boolean;
+  /**
+   * Circular reveal for a same-document theme change.
+   *
+   * `"circle"` opts the built-in toggle into the reveal published at
+   * `@ox-content/vite-plugin/theme-transition/client`. Omitted or `false`
+   * leaves the toggle immediate.
+   *
+   * Unrelated to {@link ThemeConfig.viewTransitions}, which covers
+   * cross-document navigation. Browsers without View Transitions, and readers
+   * who ask for reduced motion, always get the immediate switch.
+   *
+   * @default false
+   */
+  toggleTransition?: false | "circle";
   /**
    * Show the right-hand "On this page" outline.
    *
@@ -285,6 +321,7 @@ interface ThemeConfig {
 interface ResolvedThemeConfig {
   name: string;
   viewTransitions: boolean;
+  toggleTransition: false | "circle";
   aside: boolean;
   breadcrumbs: boolean;
   headingPermalink: "hover" | "always";
@@ -355,6 +392,402 @@ 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 a YouTube video ID from a bare ID or a watch / share / embed /
+ * shorts URL.
+ *
+ * The rule lives in Rust so this function and the `<youtube>` rewrite below
+ * cannot disagree about what counts as a video: `transformYoutubeEmbeds`
+ * resolves IDs with the same code.
+ */
+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/provider-articles.d.ts
+interface ProviderArticleEmbedOptions {
+  /** Fetch article metadata at build time. @default true */
+  fetch?: boolean;
+  /** Metadata request timeout in milliseconds. @default 10000 */
+  timeout?: number;
+  /** Cache fetched metadata in memory for the current process. @default true */
+  cache?: boolean;
+  /** Cache TTL in milliseconds. @default 3600000 */
+  cacheTTL?: number;
+  /** Persist metadata across builds. Off by default. */
+  persistCache?: boolean;
+  /** Directory for the persistent cache. */
+  cacheDir?: string;
+}
+//#endregion
+//#region src/plugins/provider-packages.d.ts
+interface ProviderPackageEmbedOptions {
+  /** Fetch package metadata at build time. @default true */
+  fetch?: boolean;
+  /** Metadata request timeout in milliseconds. @default 10000 */
+  timeout?: number;
+  /** Cache fetched metadata in memory for the current process. @default true */
+  cache?: boolean;
+  /** Cache TTL in milliseconds. @default 3600000 */
+  cacheTTL?: number;
+  /** Persist metadata across builds. Off by default. */
+  persistCache?: boolean;
+  /** Directory for the persistent cache. */
+  cacheDir?: string;
+}
+//#endregion
+//#region src/plugins/provider-playgrounds.d.ts
+interface ProviderPlaygroundEmbedOptions {
+  /** Fetch playground metadata at build time where a public endpoint exists. @default true */
+  fetch?: boolean;
+  /** Add provider iframe URLs for supported providers. @default false */
+  iframe?: boolean;
+  /** Metadata request timeout in milliseconds. @default 10000 */
+  timeout?: number;
+  /** Cache fetched metadata in memory for the current process. @default true */
+  cache?: boolean;
+  /** Cache TTL in milliseconds. @default 3600000 */
+  cacheTTL?: number;
+  /** Persist metadata across builds. Off by default. */
+  persistCache?: boolean;
+  /** Directory for the persistent cache. */
+  cacheDir?: string;
+}
+//#endregion
+//#region src/plugins/provider-videos.d.ts
+interface ProviderVideoEmbedOptions {
+  /** Fetch public video metadata at build time where supported. @default true */
+  fetch?: boolean;
+  /** Add lazy provider iframe URLs when supported. @default false */
+  iframe?: boolean;
+  /** Twitch embed parent domain or domains. Required for Twitch iframes. */
+  parent?: string | string[];
+  /** Metadata request timeout in milliseconds. @default 10000 */
+  timeout?: number;
+  /** Cache fetched metadata in memory for the current process. @default true */
+  cache?: boolean;
+  /** Cache TTL in milliseconds. @default 3600000 */
+  cacheTTL?: number;
+  /** Persist metadata across builds. Off by default. */
+  persistCache?: boolean;
+  /** Directory for the persistent cache. */
+  cacheDir?: 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/media.d.ts
+interface MediaEmbedOptions {
+  /**
+   * Render `<Spotify>` embeds.
+   * @default false
+   */
+  spotify?: boolean;
+  /**
+   * Render `<AppleMusic>` embeds.
+   * @default false
+   */
+  appleMusic?: boolean;
+  /**
+   * Render `<SpeakerDeck>` embeds.
+   * @default false
+   */
+  speakerDeck?: boolean;
+  /**
+   * Render `<Audio>` native players.
+   * @default false
+   */
+  audio?: boolean;
+  /**
+   * Render `<Video>` native players.
+   * @default false
+   */
+  video?: boolean;
+  /**
+   * Render `<StackBlitz>` embeds.
+   * @default false
+   */
+  stackBlitz?: boolean;
+  /**
+   * Render `<Tweet>` / `<XPost>` static cards. Pass `{ fetch: true }` to
+   * resolve the post content and self-host its media at build time.
+   * @default false
+   */
+  twitter?: boolean | TwitterEmbedOptions;
+  /**
+   * Render `<Reddit>` static cards with build-time metadata fetch.
+   * @default false
+   */
+  reddit?: boolean | RedditEmbedOptions;
+  /**
+   * Render `<Bluesky>` static cards.
+   * @default false
+   */
+  bluesky?: boolean;
+  /**
+   * Render `<GoogleMaps>` static place cards.
+   * @default false
+   */
+  googleMaps?: boolean;
+  /**
+   * Render `<Qiita>` static article cards.
+   * Pass `{ fetch: false }` to skip metadata fetching and render a link-only card.
+   * @default false
+   */
+  qiita?: boolean | ProviderArticleEmbedOptions;
+  /**
+   * Render `<Zenn>` static article cards.
+   * Pass `{ fetch: false }` to skip metadata fetching and render a link-only card.
+   * @default false
+   */
+  zenn?: boolean | ProviderArticleEmbedOptions;
+  /**
+   * Render `<NpmPackage>`, `<CratesIo>`, `<PyPI>`, and `<DockerHub>` package cards.
+   * Pass `{ fetch: false }` to skip metadata fetching and render link-only cards.
+   * @default false
+   */
+  packageRegistry?: boolean | ProviderPackageEmbedOptions;
+  /**
+   * Render `<CodePen>`, `<JSFiddle>`, and `<Observable>` static playground cards.
+   * Pass `{ iframe: true }` to add lazy provider iframe URLs where supported.
+   * @default false
+   */
+  playgrounds?: boolean | ProviderPlaygroundEmbedOptions;
+  /**
+   * Render `<Vimeo>` static video cards.
+   * Pass `{ iframe: true }` to add lazy player iframe URLs.
+   * @default false
+   */
+  vimeo?: boolean | ProviderVideoEmbedOptions;
+  /**
+   * Render `<Twitch>` static video, clip, and channel cards.
+   * Pass `{ iframe: true, parent: "example.com" }` to add Twitch player iframes.
+   * @default false
+   */
+  twitch?: boolean | ProviderVideoEmbedOptions;
+  /**
+   * Render `<Discord>` static invite/message cards.
+   * @default false
+   */
+  discord?: boolean;
+  /**
+   * Render `<Fediverse>`, `<Mastodon>`, `<Misskey>`, and `<Mixi2>` static cards.
+   * @default false
+   */
+  fediverse?: boolean;
+  /**
+   * Render `<Facebook>` static post cards.
+   * @default false
+   */
+  facebook?: boolean;
+  /**
+   * Render `<Threads>` static post cards.
+   * @default false
+   */
+  threads?: boolean;
+  /**
+   * Render `<Instagram>` static post cards.
+   * @default false
+   */
+  instagram?: boolean;
+  /**
+   * Render `<WebContainer>` lazy placeholder blocks.
+   * @default false
+   */
+  webContainer?: boolean;
+  /**
+   * Render `<Loom>` recording cards.
+   * @default false
+   */
+  loom?: boolean;
+  /**
+   * Render `<Asciinema>` terminal-recording cards.
+   * @default false
+   */
+  asciinema?: boolean;
+  /**
+   * Render `<Figma>` file, design, board, and prototype cards.
+   * @default false
+   */
+  figma?: boolean;
+  /**
+   * Render `<Note>` note.com article cards.
+   * @default false
+   */
+  note?: boolean;
+  /**
+   * Render `<GoogleSlides>` deck cards.
+   * @default false
+   */
+  googleSlides?: boolean;
+}
+//#endregion
 //#region src/plugins/github/types.d.ts
 interface GitHubRepoData {
   name: string;
@@ -462,31 +895,6 @@ 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, 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;
-}
-type TweetAppearance = "compact" | "full";
-//#endregion
 //#region src/plugins/ogp/types.d.ts
 interface OgpData {
   url: string;
@@ -544,90 +952,6 @@ declare function collectOgpUrls(html: string): Promise<string[]>;
 declare function prefetchOgpData(urls: string[], options?: OgpOptions): Promise<Map<string, OgpData | null>>;
 declare function transformOgp(html: string, ogpDataMap?: Map<string, OgpData | null>, options?: OgpOptions): Promise<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/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/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/mermaid.d.ts
 /**
  * Mermaid Plugin - Native Rust renderer via NAPI
@@ -653,35 +977,177 @@ declare function transformMermaidStatic(html: string, _options?: MermaidOptions)
  */
 declare const mermaidClientScript = "";
 //#endregion
+//#region src/plugins/graphviz-renderer.d.ts
+type GraphvizFailureMode = "error" | "warn";
+interface GraphvizOptions {
+  /** Graphviz renderer command. @default 'dot' */
+  command?: string;
+  /** Extra arguments passed before `-Tsvg`. @default [] */
+  args?: string[];
+  /** Behavior when the Graphviz command is not available. @default 'error' */
+  missingRenderer?: GraphvizFailureMode;
+  /** Behavior when Graphviz rejects a DOT source. @default 'error' */
+  renderErrors?: GraphvizFailureMode;
+  /** Per-render timeout in milliseconds. @default 10000 */
+  timeout?: number;
+  /** Cache rendered SVGs in memory for this process. @default true */
+  cache?: boolean;
+  /** Cache TTL in milliseconds. @default 3600000 */
+  cacheTTL?: number;
+}
+interface ResolvedGraphvizOptions {
+  command: string;
+  args: string[];
+  missingRenderer: GraphvizFailureMode;
+  renderErrors: GraphvizFailureMode;
+  timeout: number;
+  cache: boolean;
+  cacheTTL: number;
+}
+declare function clearGraphvizCache(): void;
+declare function resolveGraphvizOptions(options: boolean | GraphvizOptions | undefined): ResolvedGraphvizOptions | false;
+//#endregion
+//#region src/plugins/graphviz.d.ts
+declare function transformGraphvizStatic(html: string, options?: boolean | GraphvizOptions | ResolvedGraphvizOptions): Promise<string>;
+//#endregion
 //#region src/plugins/index.d.ts
 /**
  * Transform all plugin components in HTML.
  * Call this during SSG build to process all plugins at once.
  */
-interface TransformAllOptions {
+interface TransformAllOptions extends MediaEmbedOptions {
   tabs?: boolean;
   /**
-   * Expand `<pm>` package-manager blocks into install tabs. Pass an object to
-   * opt in to synced groups (`{ sync: true }`); syncing is off by default.
-   * @default false
+   * Expand `<pm>` package-manager blocks into install tabs. Pass an object to
+   * opt in to synced groups (`{ sync: true }`); syncing is off by default.
+   * @default false
+   */
+  pm?: boolean | PmOptions;
+  youtube?: boolean;
+  github?: boolean | GitHubOptions;
+  ogp?: boolean | OgpOptions;
+  openGraph?: boolean | OgpOptions;
+  mermaid?: boolean;
+  graphviz?: boolean | GraphvizOptions;
+  githubToken?: string;
+}
+/**
+ * Transform all enabled plugins in HTML content.
+ */
+declare function transformAllPlugins(html: string, options?: TransformAllOptions): Promise<string>;
+//#endregion
+//#region src/cross-reference-types.d.ts
+type CrossReferenceKind = "figure" | "table" | "section";
+type CrossReferenceFailureMode = "error" | "warn";
+interface CrossReferenceLabelOptions {
+  figure?: string;
+  table?: string;
+  section?: string;
+}
+interface CrossReferencesOptions {
+  enabled?: boolean;
+  missing?: CrossReferenceFailureMode;
+  duplicates?: CrossReferenceFailureMode;
+  mismatches?: CrossReferenceFailureMode;
+  labels?: CrossReferenceLabelOptions;
+}
+interface ResolvedCrossReferencesOptions {
+  enabled: boolean;
+  missing: CrossReferenceFailureMode;
+  duplicates: CrossReferenceFailureMode;
+  mismatches: CrossReferenceFailureMode;
+  labels: Required<CrossReferenceLabelOptions>;
+}
+interface CrossReferenceEntry {
+  id: string;
+  kind: CrossReferenceKind;
+  number: string;
+  label: string;
+  text: string;
+  href: string;
+  title?: string;
+}
+//#endregion
+//#region src/citation-types.d.ts
+type CitationFailureMode = "error" | "warn";
+interface CitationsOptions {
+  enabled?: boolean;
+  bibliography?: string | string[];
+  rootDir?: string;
+  appendBibliography?: boolean;
+  missing?: CitationFailureMode;
+  duplicates?: CitationFailureMode;
+  malformed?: CitationFailureMode;
+  bibliographyTitle?: string;
+}
+interface ResolvedCitationsOptions {
+  enabled: boolean;
+  bibliography: string[];
+  rootDir?: string;
+  appendBibliography: boolean;
+  missing: CitationFailureMode;
+  duplicates: CitationFailureMode;
+  malformed: CitationFailureMode;
+  bibliographyTitle: string;
+}
+interface CitationReference {
+  id: string;
+  key: string;
+  index: number;
+  label: string;
+  href: string;
+  bibliographyId: string;
+  suppressAuthor: boolean;
+}
+interface BibliographyEntry {
+  key: string;
+  id: string;
+  index: number;
+  label: string;
+  title: string;
+  authors: string[];
+  year?: string;
+  url?: string;
+  doi?: string;
+  html: string;
+}
+//#endregion
+//#region src/budoux-types.d.ts
+type BudouxLanguage = "ja" | "zh-hans" | "zh-hant" | "th";
+interface BudouxParser {
+  parse(text: string): string[];
+}
+interface BudouxOptions {
+  /**
+   * Enable build-time BudouX segmentation when an options object is supplied.
+   *
+   * @default true
    */
-  pm?: boolean | PmOptions;
-  youtube?: boolean;
-  github?: boolean | GitHubOptions;
-  ogp?: boolean | OgpOptions;
-  openGraph?: boolean | OgpOptions;
-  mermaid?: boolean;
-  githubToken?: string;
-  spotify?: boolean;
-  stackBlitz?: boolean;
-  twitter?: boolean | TwitterEmbedOptions;
-  bluesky?: boolean;
-  webContainer?: boolean;
+  enabled?: boolean;
+  /**
+   * Default BudouX parser language.
+   *
+   * @default "ja"
+   */
+  language?: BudouxLanguage;
+  /**
+   * Separator inserted between BudouX phrases.
+   *
+   * @default "\u200b"
+   */
+  separator?: string;
+  /**
+   * Custom build-time parser. When supplied, ox-content does not import the
+   * `budoux` package.
+   */
+  parser?: BudouxParser;
+}
+interface ResolvedBudouxOptions {
+  enabled: boolean;
+  language: BudouxLanguage;
+  separator: string;
+  parser?: BudouxParser;
 }
-/**
- * Transform all enabled plugins in HTML content.
- */
-declare function transformAllPlugins(html: string, options?: TransformAllOptions): Promise<string>;
 //#endregion
 //#region src/page-context.d.ts
 /**
@@ -1122,6 +1588,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.
@@ -1165,8 +1646,10 @@ interface SsgOptions {
    *
    * The component owns the whole document, so `theme`, `bare` and the head
    * metadata options do not apply — everything from `<html>` down is yours.
-   * Compose one per layout with `createTheme()`, and read the current page
-   * through `usePageProps()` / `useSiteConfig()`.
+   * `ssg.readerChrome`, when enabled, still post-processes the rendered
+   * document so custom themes share the built-in code-copy and outbound-link
+   * implementation. Compose one per layout with `createTheme()`, and read the
+   * current page through `usePageProps()` / `useSiteConfig()`.
    *
    * ```ts
    * ssg: { render: createTheme({ layouts: { default: DefaultLayout } }) }
@@ -1282,7 +1765,8 @@ interface SsgOptions {
    *
    * 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 }`.
+   * `{ copy: false }`. Bare pages and `ssg.render` custom themes can use the
+   * same copy and outbound-link transform without adopting the built-in theme.
    *
    * @default false
    */
@@ -1323,7 +1807,8 @@ interface SsgOptions {
    * 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.
+   * 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.
@@ -1414,41 +1899,6 @@ 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`.
  *
@@ -1524,6 +1974,10 @@ type ResolvedJsonLd = false | {
 interface ResolvedSsgOptions {
   enabled: boolean;
   extension: string;
+  /**
+   * Present after `resolveSsgOptions`. Omitted / empty means off.
+   */
+  routePrefix?: string;
   clean: boolean;
   bare: boolean;
   render?: ThemeComponent;
@@ -1726,6 +2180,44 @@ interface ResolvedPwaOptions {
   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 {
+  /**
+   * CSS emission mode.
+   * @default "css-mask"
+   */
+  mode?: "css-mask";
+  /**
+   * Class syntax. `"unocss"` emits `icon-[prefix--name]`.
+   * @default "unocss"
+   */
+  syntax?: "unocss";
+  /**
+   * Glob patterns to scan, or explicit `prefix:name` icons.
+   * Entries that look like Iconify names are used as-is (no scan).
+   */
+  include?: string[];
+  /**
+   * Iconify names that are always emitted, even when no source mentions them.
+   */
+  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.
  */
@@ -1735,6 +2227,13 @@ interface MarkdownSourceOptions {
    * @default true
    */
   alternate?: boolean;
+  /**
+   * 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
+   */
+  copy?: boolean;
 }
 /**
  * Resolved Markdown source-companion options.
@@ -1742,6 +2241,7 @@ interface MarkdownSourceOptions {
 interface ResolvedMarkdownSourceOptions {
   enabled: boolean;
   alternate: boolean;
+  copy: boolean;
 }
 /**
  * Opt-in crawl manifests written during SSG.
@@ -1832,6 +2332,13 @@ interface CascadeOptions {
 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.
  *
@@ -1846,10 +2353,13 @@ interface RedirectsOptions {
    */
   map?: Record<string, string>;
   /**
-   * Write a Netlify / Cloudflare `_redirects` file next to the HTML pages.
-   * @default false
+   * 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.
    */
-  netlify?: boolean;
+  provider?: RedirectProvider;
   /**
    * Write a `_headers` Location map next to the HTML pages.
    * @default false
@@ -1860,6 +2370,14 @@ interface RedirectsOptions {
    * @default false
    */
   json?: boolean;
+  /**
+   * Write static HTML fallback pages for ordinary redirect sources.
+   *
+   * Set `false` when the selected host should consume `_redirects` directly.
+   * Wildcard sources never write HTML pages because they are host-rule syntax.
+   * @default true
+   */
+  html?: boolean;
   /**
    * Allow `http://` and `https://` destinations. `javascript:`, `data:`, and
    * protocol-relative `//` targets stay rejected.
@@ -1873,29 +2391,80 @@ interface RedirectsOptions {
 interface ResolvedRedirectsOptions {
   enabled: boolean;
   map: Record<string, string>;
-  netlify: boolean;
+  provider?: RedirectProvider;
   headers: boolean;
   json: boolean;
+  html: boolean;
   allowExternal: boolean;
 }
 /**
  * Feed file formats written during SSG.
  */
 type FeedFormat = "rss" | "atom" | "json";
+/** One feed item author accepted by programmatic feeds. */
+interface FeedItemAuthor {
+  name: string;
+  url?: string;
+}
+type FeedItemAuthorInput = string | FeedItemAuthor;
+/** One JSON Feed / enclosure attachment accepted by programmatic feeds. */
+interface FeedItemAttachment {
+  url: string;
+  mimeType?: string;
+  title?: string;
+  sizeInBytes?: number;
+  durationInSeconds?: number;
+}
+/** One collection or programmatic item considered for a generated feed. */
+interface FeedItemInput {
+  title?: string;
+  description?: string;
+  content?: string;
+  path?: string;
+  loc?: string;
+  url?: string;
+  id?: string;
+  date?: unknown;
+  lastUpdated?: unknown;
+  draft?: unknown;
+  unlisted?: unknown;
+  author?: FeedItemAuthorInput;
+  authors?: readonly FeedItemAuthorInput[];
+  image?: string;
+  attachments?: readonly FeedItemAttachment[];
+  language?: string;
+  frontmatter?: Record<string, unknown>;
+}
+interface FeedItemsResolveContext {
+  name?: string;
+  formats: readonly FeedFormat[];
+  path: string;
+  siteUrl?: string;
+  siteName?: string;
+  siteDescription?: string;
+  base: string;
+  outDir?: string;
+}
+type FeedItemsSource = readonly FeedItemInput[] | ((context: FeedItemsResolveContext) => readonly FeedItemInput[] | Promise<readonly FeedItemInput[]>);
 /**
- * Opt-in RSS / Atom / JSON Feed files written during SSG.
+ * One feed's formats, source, output path, and channel metadata.
  */
-interface FeedsOptions {
+interface FeedChannelOptions {
   /**
    * Feed formats to write.
    * @default ["rss", "atom", "json"]
    */
-  formats?: FeedFormat[];
+  formats?: readonly FeedFormat[];
   /**
    * Named collection to publish. Defaults to `content`, or the first
    * configured collection when `content` is absent.
    */
   collection?: string;
+  /**
+   * Programmatic items for this channel. A channel may set either
+   * `collection` or `items`, not both.
+   */
+  items?: FeedItemsSource;
   /**
    * Maximum number of published items, newest first.
    * @default 20
@@ -1906,16 +2475,54 @@ interface FeedsOptions {
    * @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;
 }
 /**
- * Resolved feed options.
+ * 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.
  */
-interface ResolvedFeedsOptions {
-  enabled: boolean;
-  formats: FeedFormat[];
+type FeedsOptions = FeedChannelOptions | readonly FeedChannelOptions[] | {
+  [name: string]: FeedChannelOptions;
+};
+/**
+ * One resolved feed channel.
+ */
+interface ResolvedFeedChannel {
+  name?: string;
+  formats: readonly FeedFormat[];
   collection?: string;
+  items?: FeedItemsSource;
   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.
@@ -2227,6 +2834,16 @@ interface OxContentOptions {
    * @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.
    *
@@ -2356,6 +2973,42 @@ interface OxContentOptions {
    * @default false
    */
   attrs?: boolean | AttrsOptions;
+  /**
+   * Opt-in labeled cross-references for headings, figures/images, and tables.
+   *
+   * References such as `@sec-install`, `@fig-pipeline`, and `@tbl-options`
+   * become links to matching `id` attributes generated by `attrs` or native
+   * Markdown rendering. Missing labels, duplicate labels, and prefix/type
+   * mismatches fail by default and can be downgraded to warnings.
+   *
+   * @default false
+   */
+  crossReferences?: boolean | CrossReferencesOptions;
+  /**
+   * Alias for `crossReferences`.
+   *
+   * @default false
+   */
+  xrefs?: boolean | CrossReferencesOptions;
+  /**
+   * Opt-in bibliography-backed citation references.
+   *
+   * References such as `[@rfc9110]` and `[@smith2024; @doe2023]` become
+   * links to generated bibliography entries loaded from local CSL JSON files.
+   *
+   * @default false
+   */
+  citations?: boolean | CitationsOptions;
+  /**
+   * Opt-in build-time BudouX phrase segmentation.
+   *
+   * Inserts zero-width spaces into visible prose so Japanese text gets better
+   * line-break opportunities without shipping the BudouX parser to the browser.
+   * Install `budoux` when enabling the default parser, or pass a custom parser.
+   *
+   * @default false
+   */
+  budoux?: boolean | BudouxOptions;
   /**
    * Opt-in `{badge:variant}` inline badges.
    *
@@ -2365,6 +3018,50 @@ interface OxContentOptions {
    * @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.
    *
@@ -2397,6 +3094,40 @@ interface OxContentOptions {
    * @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 static `::: if` / `::: else` blocks.
+   *
+   * Conditions are evaluated from `conditionalBlocks.values` and page
+   * frontmatter before Markdown is parsed. Non-selected branches are excluded
+   * from rendered HTML, TOC, and generated search payloads. The expression
+   * language supports `==`, `!=`, `in`, `and`, `or`, parentheses, string /
+   * number / boolean / null literals, and array literals. No JavaScript is
+   * executed.
+   *
+   * @default false
+   */
+  conditionalBlocks?: boolean | ConditionalBlockOptions;
   /**
    * Opt-in page-bundle resources and build-time image processing.
    *
@@ -2435,6 +3166,17 @@ interface OxContentOptions {
    * @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.
    *
@@ -2453,6 +3195,16 @@ interface OxContentOptions {
    * @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.
    *
@@ -2463,6 +3215,17 @@ interface OxContentOptions {
    * @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.
    *
@@ -2533,6 +3296,13 @@ interface OxContentOptions {
    * @default false
    */
   mermaid?: boolean;
+  /**
+   * Render `dot` / `graphviz` fenced blocks to static SVG with Graphviz.
+   * Pass an object to configure the renderer command and failure policy.
+   *
+   * @default false
+   */
+  graphviz?: boolean | GraphvizOptions;
   /**
    * Enable `$…$` inline and `$$…$$` block math.
    *
@@ -2642,6 +3412,10 @@ interface ResolvedOptions {
   blog?: ResolvedBlogOptions;
   feeds?: ResolvedFeedsOptions;
   pwa?: ResolvedPwaOptions;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  icons?: ResolvedIconsOptions;
   taxonomies?: ResolvedTaxonomiesOptions;
   versions?: ResolvedVersionsOptions;
   resources?: ResolvedResourcesOptions;
@@ -2661,18 +3435,58 @@ interface ResolvedOptions {
   wikiLinks: ResolvedWikiLinkOptions;
   emojiShortcodes: ResolvedEmojiShortcodeOptions;
   attrs: ResolvedAttrsOptions;
+  crossReferences: ResolvedCrossReferencesOptions;
+  citations: ResolvedCitationsOptions;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  budoux?: ResolvedBudouxOptions;
   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;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  conditionalBlocks?: ResolvedConditionalBlockOptions;
   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;
@@ -2684,6 +3498,7 @@ interface ResolvedOptions {
   typedHover?: ResolvedTypedHoverOptions;
   docsTests: ResolvedDocsTestOptions;
   mermaid: boolean;
+  graphviz: ResolvedGraphvizOptions | false;
   math: ResolvedMathOptions;
   frontmatter: boolean;
   toc: boolean;
@@ -2733,6 +3548,28 @@ interface BuiltinEmbedOptions {
    * @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
@@ -2745,16 +3582,113 @@ interface BuiltinEmbedOptions {
    * @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 `<GoogleMaps>` as static place cards.
+   * @default false
+   */
+  googleMaps?: boolean;
+  /**
+   * Render `<Qiita>` as static article cards.
+   * Pass `{ fetch: false }` to skip metadata fetching and render a link-only card.
+   * @default false
+   */
+  qiita?: boolean | ProviderArticleEmbedOptions;
+  /**
+   * Render `<Zenn>` as static article cards.
+   * Pass `{ fetch: false }` to skip metadata fetching and render a link-only card.
+   * @default false
+   */
+  zenn?: boolean | ProviderArticleEmbedOptions;
+  /**
+   * Render `<NpmPackage>`, `<CratesIo>`, `<PyPI>`, and `<DockerHub>` as static cards.
+   * Pass `{ fetch: false }` to skip metadata fetching and render link-only cards.
+   * @default false
+   */
+  packageRegistry?: boolean | ProviderPackageEmbedOptions;
+  /**
+   * Render `<CodePen>`, `<JSFiddle>`, and `<Observable>` as static playground cards.
+   * Pass `{ iframe: true }` to include lazy iframe URLs where supported.
+   * @default false
+   */
+  playgrounds?: boolean | ProviderPlaygroundEmbedOptions;
+  /**
+   * Render `<Vimeo>` as static video cards.
+   * Pass `{ iframe: true }` to include lazy player iframe URLs.
+   * @default false
+   */
+  vimeo?: boolean | ProviderVideoEmbedOptions;
+  /**
+   * Render `<Twitch>` as static video, clip, and channel cards.
+   * Pass `{ iframe: true, parent: "example.com" }` to include Twitch iframes.
+   * @default false
+   */
+  twitch?: boolean | ProviderVideoEmbedOptions;
+  /**
+   * Render `<Discord>` as static invite/message cards.
+   * @default false
+   */
+  discord?: boolean;
+  /**
+   * Render `<Fediverse>`, `<Mastodon>`, `<Misskey>`, and `<Mixi2>` as static cards.
+   * @default false
+   */
+  fediverse?: boolean;
+  /**
+   * Render `<Facebook>` as static post cards.
+   * @default false
+   */
+  facebook?: boolean;
+  /**
+   * Render `<Threads>` as static post cards.
+   * @default false
+   */
+  threads?: boolean;
+  /**
+   * Render `<Instagram>` as static post cards.
+   * @default false
+   */
+  instagram?: boolean;
   /**
    * Render `<WebContainer>` lazy placeholders with isolation metadata.
    * @default false
    */
   webContainer?: boolean;
+  /**
+   * Render `<Loom>` recording cards.
+   * @default false
+   */
+  loom?: boolean;
+  /**
+   * Render `<Asciinema>` terminal-recording cards.
+   * @default false
+   */
+  asciinema?: boolean;
+  /**
+   * Render `<Figma>` file, design, board, and prototype cards.
+   * @default false
+   */
+  figma?: boolean;
+  /**
+   * Render `<Note>` note.com article cards.
+   * @default false
+   */
+  note?: boolean;
+  /**
+   * Render `<GoogleSlides>` deck cards.
+   * @default false
+   */
+  googleSlides?: boolean;
 }
 /**
  * Options for the package-manager install-tab transform.
@@ -2774,10 +3708,32 @@ interface ResolvedBuiltinEmbedOptions {
   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;
+  googleMaps?: boolean;
+  qiita?: ProviderArticleEmbedOptions | false;
+  zenn?: ProviderArticleEmbedOptions | false;
+  packageRegistry?: ProviderPackageEmbedOptions | false;
+  playgrounds?: ProviderPlaygroundEmbedOptions | false;
+  vimeo?: ProviderVideoEmbedOptions | false;
+  twitch?: ProviderVideoEmbedOptions | false;
+  discord?: boolean;
+  fediverse?: boolean;
+  facebook?: boolean;
+  threads?: boolean;
+  instagram?: boolean;
   webContainer: boolean;
+  loom?: boolean;
+  asciinema?: boolean;
+  figma?: boolean;
+  note?: boolean;
+  googleSlides?: boolean;
 }
 /**
  * Options for opt-in `{badge:variant}` inline badges.
@@ -2796,6 +3752,113 @@ interface BadgeOptions {
 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.
  */
@@ -2904,6 +3967,112 @@ interface ResolvedImageOptions {
   enabled: boolean;
   lazy: boolean;
 }
+/**
+ * Options for opt-in static image galleries.
+ */
+interface ImageGalleryOptions {
+  /**
+   * 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
+   */
+  ordered?: boolean;
+  /**
+   * Diagnostics for malformed `YYYY`, `YYYY-MM`, or `YYYY-MM-DD` item dates.
+   *
+   * @default "error"
+   */
+  invalidDate?: "error" | "warn" | "ignore";
+  /**
+   * 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 static conditional blocks.
+ */
+interface ConditionalBlockOptions {
+  /**
+   * Enable `::: if` / `::: else` blocks.
+   *
+   * @default true when the options object is supplied.
+   */
+  enabled?: boolean;
+  /**
+   * Build-time values available as `config.*` or bare identifiers. Page
+   * frontmatter wins for bare identifiers; use `config.name` to force config.
+   */
+  values?: Record<string, unknown>;
+}
+/**
+ * Resolved conditional-block transform options.
+ */
+interface ResolvedConditionalBlockOptions {
+  enabled: boolean;
+  values: Record<string, unknown>;
+}
 /**
  * Options for opt-in page-bundle resources and image processing.
  */
@@ -3019,12 +4188,52 @@ interface MathOptions {
    * @default true
    */
   enabled?: boolean;
+  /**
+   * What to do with a `$…$` run KaTeX cannot parse.
+   *
+   * The `$…$` heuristics are good but not perfect, and a page *about* math
+   * syntax is exactly the page that trips them. This decides whether such a
+   * page ships readable prose, red error text, or no build at all.
+   *
+   * - `'literal'` puts the source back the way it was written, delimiters
+   *   included, and warns.
+   * - `'error'` fails the build.
+   * - `'render'` emits KaTeX's own red error markup, which is what the
+   *   feature did before this option existed.
+   *
+   * @default 'literal'
+   */
+  onError?: MathErrorPolicy;
+  /**
+   * Which KaTeX font formats to emit into the output directory.
+   *
+   * `.ttf` and `.woff` are three quarters of KaTeX's font bytes, and no
+   * browser that can run the rest of the site needs them — `@font-face`
+   * lists `woff2` first and stops at the first format it supports. Set
+   * `'all'` for a target that genuinely needs the older formats.
+   *
+   * Either way the fonts are emitted only when a page actually rendered
+   * math.
+   *
+   * @default 'woff2'
+   */
+  fontFormats?: KatexFontFormats;
 }
+/**
+ * What to do with a `$…$` run KaTeX cannot parse.
+ */
+type MathErrorPolicy = "literal" | "error" | "render";
+/**
+ * Which of KaTeX's font formats to emit.
+ */
+type KatexFontFormats = "woff2" | "all";
 /**
  * Resolved math transform options.
  */
 interface ResolvedMathOptions {
   enabled: boolean;
+  onError: MathErrorPolicy;
+  fontFormats: KatexFontFormats;
 }
 /**
  * Options for markdown-it-attrs style attribute blocks.
@@ -3123,6 +4332,48 @@ 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 {
+  /**
+   * Enable the transform when an options object is supplied.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * Directory used to resolve `@/` and absolute partial paths.
+   *
+   * @default undefined
+   */
+  rootDir?: string;
+  /**
+   * Directory used for bare names such as `install.md`.
+   *
+   * @default "_partials"
+   */
+  root?: string;
+  /**
+   * Missing `{{ name }}` substitutions stay literal, or report a diagnostic.
+   *
+   * @default "literal"
+   */
+  missing?: "literal" | "error";
+}
+/**
+ * Resolved parameterized-partial transform options.
+ */
+interface ResolvedPartialsOptions {
+  enabled: boolean;
+  rootDir?: string;
+  root: string;
+  missing: "literal" | "error";
+}
 /**
  * Options for opt-in `::: card` / `::: link-card` / `::: card-grid` blocks.
  */
@@ -3137,24 +4388,41 @@ interface CardOptions {
 /**
  * Resolved card transform options.
  */
-interface ResolvedCardOptions {
+interface ResolvedCardOptions {
+  enabled: boolean;
+}
+/**
+ * Options for opt-in `::: steps` ordered lists.
+ */
+interface StepsOptions {
+  /**
+   * Enable the steps transform when an options object is supplied.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+}
+/**
+ * Resolved step-list transform options.
+ */
+interface ResolvedStepsOptions {
   enabled: boolean;
 }
 /**
- * Options for opt-in `::: steps` ordered lists.
+ * Options for opt-in `::: code-group` fence groups.
  */
-interface StepsOptions {
+interface CodeGroupOptions {
   /**
-   * Enable the steps transform when an options object is supplied.
+   * Enable the code-group transform when an options object is supplied.
    *
    * @default true
    */
   enabled?: boolean;
 }
 /**
- * Resolved step-list transform options.
+ * Resolved code-group transform options.
  */
-interface ResolvedStepsOptions {
+interface ResolvedCodeGroupOptions {
   enabled: boolean;
 }
 /**
@@ -3206,6 +4474,39 @@ interface ResolvedFileTreeOptions {
   iconFile?: string;
   iconFiles?: Record<string, string>;
 }
+/**
+ * Options for opt-in `csv-table` / `json-table` fences.
+ */
+interface DataTableOptions {
+  /**
+   * Enable the data-table transform when an options object is supplied.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * Directory used to resolve `@/` and absolute import paths.
+   *
+   * 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 data-table transform options.
+ */
+interface ResolvedDataTableOptions {
+  enabled: boolean;
+  rootDir?: string;
+  missing: "error" | "warn";
+}
 /**
  * Options for sanitizing rendered HTML.
  *
@@ -3279,11 +4580,51 @@ interface EditThisPageOptions {
   /**
    * Source root inside the repository, used before the page path.
    *
-   * Set this when `srcDir` is nested in a package or docs workspace.
+   * Set this when `srcDir` is nested in a package or docs workspace: the
+   * value says where `srcDir` lives inside the repository, and the page
+   * path is measured from `srcDir` rather than from the directory the build
+   * runs in.
+   *
+   * @example
+   * ```ts
+   * // repository holds packages/site/docs, srcDir is "docs"
+   * rootDir: 'packages/site/docs'
+   * // -> <repoUrl>/edit/<branch>/packages/site/docs/guide/nested.md
+   * ```
    *
    * @default undefined
    */
   rootDir?: string;
+  /**
+   * Forge whose edit-URL shape to use.
+   *
+   * Every forge exposes a web editor at a different path — GitLab puts a
+   * `/-/` scope separator in front of it, Bitbucket edits through its source
+   * view, Gitea and Forgejo use `_edit` — so a site on the wrong shape links
+   * to a 404.
+   *
+   * Inferred from the `repoUrl` host when omitted (`gitlab.com`,
+   * `bitbucket.org`, `codeberg.org`, `gitea.com`), falling back to
+   * `'github'`. Set it explicitly for a self-hosted instance, whose hostname
+   * says nothing about the software behind it.
+   *
+   * @default inferred from `repoUrl`
+   */
+  provider?: EditThisPageProvider;
+  /**
+   * Edit-URL template, for a forge or an instance the shapes above miss.
+   *
+   * Understands `{repoUrl}`, `{branch}`, and `{path}`; other braces are
+   * left as written. Takes precedence over `provider`.
+   *
+   * @example
+   * ```ts
+   * urlPattern: '{repoUrl}/ui/edit?ref={branch}&file={path}'
+   * ```
+   *
+   * @default the pattern for the resolved `provider`
+   */
+  urlPattern?: string;
   /**
    * Link text rendered in the page footer.
    *
@@ -3293,6 +4634,12 @@ interface EditThisPageOptions {
    */
   label?: string;
 }
+/**
+ * Forges with a known edit-URL shape.
+ *
+ * `'gitea'` covers Forgejo, which kept the same path.
+ */
+type EditThisPageProvider = "github" | "gitlab" | "bitbucket" | "gitea";
 /**
  * Resolved edit-link transform options.
  */
@@ -3301,6 +4648,8 @@ interface ResolvedEditThisPageOptions {
   repoUrl?: string;
   branch: string;
   rootDir?: string;
+  provider?: EditThisPageProvider;
+  urlPattern?: string;
   label: string;
 }
 /**
@@ -3526,11 +4875,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`
@@ -3568,17 +4973,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.
@@ -3679,6 +5093,18 @@ interface TransformResult {
    * Unique JSX component names in document order (empty when none).
    */
   components: string[];
+  /**
+   * Labeled cross-reference targets collected during the Markdown transform.
+   */
+  crossReferences: CrossReferenceEntry[];
+  /**
+   * Citation references collected during the Markdown transform.
+   */
+  citations: CitationReference[];
+  /**
+   * Bibliography entries used by this document.
+   */
+  bibliography: BibliographyEntry[];
 }
 /**
  * Table of contents entry.
@@ -3783,6 +5209,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.
    *
@@ -3970,6 +5405,7 @@ interface ResolvedDocsOptions {
   include: string[];
   exclude: string[];
   entryPoints?: ResolvedDocsEntryPoint[];
+  openapi: ResolvedOpenApiDocsOptions | false;
   format: "markdown" | "json" | "html";
   private: boolean;
   internal: boolean;
@@ -3998,6 +5434,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.
  *
@@ -4280,6 +5758,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.
    *
@@ -4348,6 +5836,7 @@ interface ResolvedSearchOptions {
   enabled: boolean;
   limit: number;
   prefix: boolean;
+  fuzzy: boolean;
   placeholder: string;
   hotkey: string;
   provider?: "local" | "hosted";
@@ -4501,6 +5990,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" {
@@ -4536,23 +6052,52 @@ declare module "virtual:ox-content/collections" {
   export default api;
 }
 //#endregion
+//#region src/builtin-embed-options.d.ts
+declare function resolveBuiltinEmbedOptions(options: OxContentOptions["embeds"]): ResolvedOptions["embeds"];
+//#endregion
+//#region src/resolve-options.d.ts
+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"]): ResolvedOptions["typedHover"];
+declare function resolveTypedHoverOptions(options: OxContentOptions["typedHover"]): ResolvedTypedHoverOptions;
 //#endregion
 //#region src/environment.d.ts
 /**
@@ -4794,9 +6339,31 @@ interface SsgTransformOptions {
   baseUrl?: string;
   /** Source file path for relative link resolution */
   sourcePath?: string;
+  /** Absolute source root, used to place pages inside the repository */
+  srcDir?: string;
 }
 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[];
@@ -4920,10 +6487,11 @@ declare function renderIslandComponentImports(usedComponents: readonly string[],
  * 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.
+ * transform time. The hook receives the original slot HTML so adapters can pass
+ * children into their SSR runtime. 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>;
+type RenderIslandFn = (name: string, props: Record<string, unknown>, filePath: string, slotHtml?: 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
@@ -5235,10 +6803,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.
  */
@@ -5643,6 +7215,26 @@ declare function resolveHeadValidation(value: HeadValidationMode | undefined): f
 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.
  *
@@ -5650,8 +7242,29 @@ declare function resolveNotFoundOptions(value: boolean | NotFoundOptions | undef
  * 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.
  *
@@ -5695,19 +7308,63 @@ declare function resolveCascadeOptions(value: boolean | CascadeOptions | undefin
  *
  * `false` / omitted stays off. `true` or `{}` enables empty defaults.
  * A path map (`{ "/old": "/new" }`) enables the feature with that map.
- * `{ map, netlify, headers, json, allowExternal }` overrides only set fields.
+ * `{ map, provider, headers, json, html, 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): ResolvedRedirectsOptions;
+declare function resolveRedirectsOptions(value: boolean | RedirectsOptions | Record<string, string> | undefined, env?: NodeJS.ProcessEnv): ResolvedRedirectsOptions;
 //#endregion
 //#region src/feeds.d.ts
+/** 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;
+}
+/** Rendered feed bodies, or a skip warning. */
+interface FeedsRenderResult {
+  rssXml?: string;
+  atomXml?: string;
+  jsonFeed?: string;
+  warning?: string;
+}
+interface RenderedFeedFile {
+  path: string;
+  contentType: string;
+  content: string;
+}
+interface RenderFeedFilesInput extends FeedsRenderInput {
+  base: string;
+  outDir?: string;
+}
+interface RenderFeedFilesResult {
+  files: RenderedFeedFile[];
+  warning?: string;
+}
+interface WriteFeedFilesInput extends RenderFeedFilesInput {
+  outDir: 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.
- * An object enables the feature and overrides only the fields the site set.
+ * A single object is one default feed. A named record or array writes
+ * multiple feeds.
  */
 declare function resolveFeedsOptions(value: boolean | FeedsOptions | undefined): ResolvedFeedsOptions;
+/** Builds RSS / Atom / JSON Feed bodies without writing files. */
+declare function generateFeeds(input: FeedsRenderInput): FeedsRenderResult;
+declare function renderFeedFiles(input: RenderFeedFilesInput): Promise<RenderFeedFilesResult>;
+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;
@@ -5731,6 +7388,10 @@ declare class BlogFeedError extends Error {
  */
 declare function readingTimeMinutes(markdown: string): number;
 //#endregion
+//#region src/budoux.d.ts
+declare function resolveBudouxOptions(options: OxContentOptions["budoux"]): ResolvedBudouxOptions;
+declare function transformBudouxHtml(html: string, options: ResolvedBudouxOptions | undefined): Promise<string>;
+//#endregion
 //#region src/pwa.d.ts
 /**
  * Resolves `pwa` with defaults.
@@ -5798,7 +7459,7 @@ declare function resolveSearchOptions(options: SearchOptions | boolean | undefin
  * 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[], publishState?: ResolvedPublishStateOptions, excludeDocumentIds?: readonly string[], mdx?: boolean): Promise<string>;
+declare function buildSearchIndex(srcDir: string, base: string, extensions?: readonly string[], publishState?: ResolvedPublishStateOptions, excludeDocumentIds?: readonly string[], mdx?: boolean, conditionalBlocks?: ResolvedConditionalBlockOptions, citations?: ResolvedCitationsOptions): Promise<string>;
 /**
  * Writes the search index to a file.
  */
@@ -5943,7 +7604,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.
@@ -5966,10 +7627,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`
@@ -6007,17 +7724,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
@@ -6038,9 +7764,6 @@ interface OgBrowserSession extends AsyncDisposable {
 }
 //#endregion
 //#region src/og-image/index.d.ts
-/**
- * Resolves user-provided OG image options with defaults.
- */
 declare function resolveOgImageOptions(options: OgImageOptions$1 | undefined): ResolvedOgImageOptions;
 /**
  * A single page entry for batch OG image generation.
@@ -6062,7 +7785,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.
@@ -6079,6 +7802,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.
@@ -6100,13 +7932,10 @@ declare function createI18nPlugin(resolvedOptions: ResolvedOptions): Plugin;
  * ```
  */
 declare function oxContent(options?: OxContentOptions): Plugin[];
-declare function resolveBuiltinEmbedOptions(options: OxContentOptions["embeds"]): ResolvedOptions["embeds"];
-declare function resolveMathOptions(options: OxContentOptions["math"]): ResolvedOptions["math"];
-declare function resolveBadgeOptions(options: OxContentOptions["badges"]): ResolvedOptions["badges"];
 /**
  * Generates virtual module content.
  */
 declare function generateVirtualModule(path: string, options: ResolvedOptions): string;
 //#endregion
-export { A11yOptions, AttrsOptions, BadgeOptions, type BasePageProps, BlogAuthor, BlogFeedError, BlogFeedFailurePolicy, BlogFeedSource, BlogOptions, BuiltinEmbedOptions, BuiltinPmOptions, CardOptions, CascadeOptions, CodeAnnotationKind, CodeAnnotationSyntax, CodeAnnotationsOptions, type CodeBlockDiagnostic, CodeBlockLintOptions, CodeBlockTypecheckOptions, CodeImportOptions, type CollectedDocsTest, CollectionEntry, CollectionIncludeField, CollectionManifest, CollectionOptions, CollectionQueryBuilder, CollectionQueryOperator, CollectionsOptions, type ComponentRegistry, ContainerOptions, ContainerTypeOptions, ContributorsOptions, DEFAULT_HTML_TEMPLATE, DEFAULT_MARKDOWN_EXTENSIONS, DefaultTheme, type DiscoverDocumentMdxIslandsInput, type DiscoverDocumentMdxIslandsResult, type DiscoverRegisteredMdxComponentsInput, DocEntry, DocMember, DocsEntryPoint, 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, FeedFormat, FeedsOptions, FileTreeIconOptions, FileTreeOptions, 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 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, 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, 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, MarkdownSourceOptions, MarkdownTransformer, MathOptions, MdxImport, MdxImportSpecifier, MdxImportSpecifierKind, type MermaidOptions, type NavGroup, NavItem, NotFoundOptions, type OgBrowserSession, OgImageOptions, type OgImagePageEntry, type OgImageOptions$1 as OgImagePluginOptions, type OgImageResult, type OgImageTemplateFn, type OgImageTemplateProps, type OgpData, type OgpOptions, OxContentOptions, type PageChromeFlags, type PageData, type PageProps, PageResourceError, ParamDoc, type ParseIslandsResult, PermalinksOptions, PublishStateOptions, PwaOptions, ReaderChromeOptions, RedirectsOptions, type RenderContext, type RenderIslandComponentImportsInput, type RenderIslandFn, type RenderedHead, type ResolveDocumentComponentImportsInput, type ResolveDocumentComponentImportsResult, ResolvedA11y, ResolvedAttrsOptions, ResolvedBadgeOptions, ResolvedBlogFeedSource, ResolvedBlogOptions, ResolvedBuiltinEmbedOptions, ResolvedCardOptions, ResolvedCascadeOptions, ResolvedCodeAnnotationsOptions, ResolvedCodeBlockLintOptions, ResolvedCodeBlockTypecheckOptions, ResolvedCodeImportOptions, ResolvedCollectionOptions, ResolvedCollectionsOptions, ResolvedContainerOptions, ResolvedContributors, ResolvedDocsEntryPoint, ResolvedDocsOptions, ResolvedDocsTestOptions, type ResolvedDocumentComponentImport, ResolvedEditThisPageOptions, ResolvedEmojiShortcodeOptions, ResolvedFeedsOptions, ResolvedFileTreeOptions, ResolvedHeadingPermalinksOptions, ResolvedI18nOptions, ResolvedImageOptions, ResolvedIncludeOptions, ResolvedJsonLd, ResolvedMagicLinkOptions, ResolvedMarkdownSourceOptions, ResolvedMathOptions, ResolvedNotFoundOptions, ResolvedOgImageOptions, ResolvedOptions, ResolvedPermalinksOptions, ResolvedPublishStateOptions, ResolvedPwaOptions, ResolvedReaderChrome, ResolvedRedirectsOptions, ResolvedResourcesOptions, ResolvedSanitizeOptions, ResolvedSearchOptions, ResolvedSectionIndexOptions, ResolvedSiteMapsOptions, ResolvedSsgOptions, ResolvedStepsOptions, ResolvedTaxonomiesOptions, ResolvedTeamOptions, type ResolvedThemeConfig, 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, StepsOptions, TaxonomiesOptions, TeamLink, TeamMember, TeamOptions, type ThemeAnnouncement, type ThemeColors, type ThemeComponent, type ThemeConfig, type ThemeEmbed, type ThemeEntryPage, type ThemeFonts, type ThemeFooter, type ThemeHeader, type ThemeLayout, type ThemeProps, type ThemeRenderOptions, type ThemeTokens, ThrowsDoc, 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 WrittenDocsTestFile, type YouTubeOptions, applyIslandSsrHtml, buildCollectionManifest, buildSearchIndex, buildSsg, classifyPublishState, clearRenderContext, collectDocsTests, collectGitHubRepos, collectGitHubSources, collectMdxIslandNamesFromHtml, collectMdxJsxNamesFromAst, collectOgpUrls, convertVitePressNav, convertVitePressSidebar, createFrameworkMarkdownOptions, createI18nPlugin, createIncrementalMarkdownParser, createIncrementalMarkdownRenderer, createMarkdownEnvironment, createTheme, defaultTheme, defineCollection, defineCollections, defineTheme, discoverDocumentMdxIslands, discoverRegisteredMdxComponents, each, escapeSvelteMarkup, extractCodeBlocks, extractDocs, extractDocsTests, extractIslandInfo, extractVideoId, fetchGitHubSource, fetchOgpData, fetchRepoData, fromVitePressConfig, generateCollectionsVirtualModule, generateFrontmatterTypes, generateHydrationScript, generateMarkdown, generateOgImages, 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, partitionPublishedPages, prefetchGitHubRepos, prefetchGitHubSources, prefetchOgpData, raw, readingTimeMinutes, renderAllPages, renderHead, renderHtmlToFrameworkCode, renderHtmlToReactComponent, renderHtmlToReactCreateElement, renderHtmlToSvelteComponent, renderHtmlToVueComponent, renderHtmlToVueH, renderIslandComponentImports, renderMarkdownStream, renderPage, renderToString, resolveBadgeOptions, resolveBlogCollectionName, resolveBlogOptions, resolveBuiltinEmbedOptions, resolveCardOptions, resolveCascadeOptions, resolveCollectionsOptions, resolveContentRootPath, resolveDocsOptions, resolveDocumentComponentImports, resolveFeedsOptions, resolveFileTreeOptions, resolveHeadValidation, resolveHeaderNavItems, resolveHeadingPermalinksOptions, resolveI18nOptions, resolveImageOptions, resolveIncludeOptions, resolveLocaleLabel, resolveMarkdownSourceOptions, resolveMathOptions, resolveMdxForFilePath, resolveNotFoundOptions, resolveOgImageOptions, resolvePageChromeOption, resolvePermalinksOptions, resolvePublishStateOptions, resolvePwaOptions, resolveRedirectsOptions, resolveResourcesOptions, resolveSearchOptions, resolveSectionIndexOptions, resolveSiteMapsOptions, resolveSsgOptions, resolveStepsOptions, resolveTaxonomiesOptions, resolveTeamOptions, resolveTheme, resolveTypedHoverOptions, resolveVersionsOptions, runDocsTests, setRenderContext, shouldLintMarkdownFile, stripMarkdownExtension, stripViteQuery, 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, type BibliographyEntry, BlogAuthor, BlogFeedError, BlogFeedFailurePolicy, BlogFeedSource, BlogOptions, type BudouxLanguage, type BudouxOptions, type BudouxParser, BuiltinEmbedOptions, BuiltinPmOptions, CardOptions, CascadeOptions, type CitationFailureMode, type CitationReference, type CitationsOptions, CodeAnnotationKind, CodeAnnotationSyntax, CodeAnnotationsOptions, type CodeBlockDiagnostic, CodeBlockLintOptions, CodeBlockTypecheckOptions, CodeGroupOptions, CodeImportOptions, type CollectedDocsTest, CollectionEntry, CollectionIncludeField, CollectionManifest, CollectionOptions, CollectionQueryBuilder, CollectionQueryOperator, CollectionsOptions, type ComponentRegistry, ConditionalBlockOptions, ContainerOptions, ContainerTypeOptions, ContributorsOptions, type CrossReferenceEntry, type CrossReferenceFailureMode, type CrossReferenceKind, type CrossReferenceLabelOptions, type CrossReferencesOptions, 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, EditThisPageProvider, EmojiShortcodeOptions, EntryPageConfig, type ExtractedCodeBlock, ExtractedDocs, FeatureConfig, FeedChannelOptions, FeedFormat, FeedItemAttachment, FeedItemAuthor, FeedItemAuthorInput, FeedItemInput, FeedItemsResolveContext, FeedItemsSource, FeedsOptions, type FeedsRenderInput, type FeedsRenderResult, 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 GraphvizFailureMode, type GraphvizOptions, 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, KatexFontFormats, 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, type MarkdownTableEnhancementOptions, MarkdownTransformer, MathErrorPolicy, 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, type ReaderChromeInput, type ReaderChromeOptions, type RedditEmbedOptions, type RedditPostData, type RedditPostReference, RedirectProvider, RedirectsOptions, type RenderContext, type RenderFeedFilesInput, type RenderFeedFilesResult, type RenderIslandComponentImportsInput, type RenderIslandFn, type RenderThemeTokenCssOptions, type RenderedFeedFile, type RenderedHead, type ResolveDocumentComponentImportsInput, type ResolveDocumentComponentImportsResult, ResolvedA11y, ResolvedAbbreviationsOptions, ResolvedAttrsOptions, ResolvedBadgeOptions, ResolvedBlogFeedSource, ResolvedBlogOptions, type ResolvedBudouxOptions, ResolvedBuiltinEmbedOptions, ResolvedCardOptions, ResolvedCascadeOptions, type ResolvedCitationsOptions, ResolvedCodeAnnotationsOptions, ResolvedCodeBlockLintOptions, ResolvedCodeBlockTypecheckOptions, ResolvedCodeGroupOptions, ResolvedCodeImportOptions, ResolvedCollectionOptions, ResolvedCollectionsOptions, ResolvedConditionalBlockOptions, ResolvedContainerOptions, ResolvedContributors, type ResolvedCrossReferencesOptions, ResolvedDataTableOptions, ResolvedDefinitionListOptions, ResolvedDocsEntryPoint, ResolvedDocsOptions, ResolvedDocsTestOptions, type ResolvedDocumentComponentImport, ResolvedEditThisPageOptions, ResolvedEmojiShortcodeOptions, ResolvedFeedChannel, ResolvedFeedsOptions, ResolvedFileTreeOptions, type ResolvedGraphvizOptions, ResolvedHeadingPermalinksOptions, ResolvedI18nOptions, ResolvedIconsOptions, ResolvedImageGalleryOptions, ResolvedImageOptions, ResolvedIncludeOptions, ResolvedJsonLd, ResolvedKeyboardKeysOptions, ResolvedMagicLinkOptions, ResolvedMarkdownSourceOptions, ResolvedMathOptions, ResolvedNotByAiOptions, ResolvedNotFoundOptions, ResolvedOgImageOptions, ResolvedOpenApiDocsInput, ResolvedOpenApiDocsOptions, ResolvedOptions, ResolvedPartialsOptions, ResolvedPermalinksOptions, ResolvedPublishStateOptions, ResolvedPwaOptions, type 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 ThemeTokenSource, 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 WriteFeedFilesInput, type WriteResourceFilesInput, type WriteResourceFilesPage, type WriteResourceFilesResult, type WrittenDocsTestFile, type YouTubeOptions, applyIslandSsrHtml, applyReaderChromeHtml, buildCollectionManifest, buildSearchIndex, buildSsg, classifyPublishState, clearGraphvizCache, clearRenderContext, collectDocsTests, collectGitHubRepos, collectGitHubSources, collectMdxIslandNamesFromHtml, collectMdxJsxNamesFromAst, collectOgpUrls, convertVitePressNav, convertVitePressSidebar, createFrameworkMarkdownOptions, createI18nPlugin, createIncrementalMarkdownParser, createIncrementalMarkdownRenderer, createMarkdownEnvironment, createMarkdownProcessor, createTheme, defaultTheme, defineCollection, defineCollections, defineTheme, discoverDocumentMdxIslands, discoverRegisteredMdxComponents, each, enhanceMarkdownTables, escapeSvelteMarkup, extractCodeBlocks, extractDocs, extractDocsTests, extractIslandInfo, extractVideoId, fetchGitHubSource, fetchOgpData, fetchRepoData, fromVitePressConfig, generateCollectionsVirtualModule, generateFeeds, generateFrontmatterTypes, generateHydrationScript, generateMarkdown, generateOgImages, generateOpenApiDocs, generateTabsCSS, generateTypes, generateVirtualModule, generateVitePressMigrationConfig, hasIslands, inferType, intersectHydratableComponentNames, intersectRegisteredComponentNames, isMarkdownFilePath, isMdxFilePath, isRegisteredComponent, jsx, jsxs, lintCodeBlocks, lintMarkdown, lintMarkdownAsync, lintMarkdownFile, lintMarkdownFiles, markdownTableScrollLabel, mergeThemes, mermaidClientScript, normalizeMarkdownExtensions, normalizeVitePressFrontmatter, oxContent, parseGitHubLineRange, parseGitHubPermalink, parsePageChromeFlags, parseRedditPostReference, partitionPublishedPages, planSsgOutputs, prefetchGitHubRepos, prefetchGitHubSources, prefetchOgpData, raw, readerChromeAttributes, readerChromeCss, readerChromeIsEnabled, readerChromeNeedsJs, readerChromeScript, readingTimeMinutes, renderAllPages, renderFeedFiles, renderHead, renderHtmlToFrameworkCode, renderHtmlToReactComponent, renderHtmlToReactCreateElement, renderHtmlToSvelteComponent, renderHtmlToVueComponent, renderHtmlToVueH, renderIslandComponentImports, renderMarkdown, renderMarkdownStream, renderPage, renderReaderChromeAttributes, renderReaderChromeScriptTag, renderReaderChromeStyleTag, renderThemeTokenCss, renderToString, resolveAbbreviationsOptions, resolveBadgeOptions, resolveBlogCollectionName, resolveBlogOptions, resolveBudouxOptions, resolveBuiltinEmbedOptions, resolveCardOptions, resolveCascadeOptions, resolveCodeGroupOptions, resolveCollectionsOptions, resolveContentRootPath, resolveDataTableOptions, resolveDocsOptions, resolveDocumentComponentImports, resolveFeedsOptions, resolveFileTreeOptions, resolveGitLastmod, resolveGraphvizOptions, resolveHeadValidation, resolveHeaderNavItems, resolveHeadingPermalinksOptions, resolveI18nOptions, resolveImageGalleryOptions, resolveImageOptions, resolveIncludeOptions, resolveKeyboardKeysOptions, resolveLocaleLabel, resolveMarkdownSourceOptions, resolveMathOptions, resolveMdxForFilePath, resolveNotByAiOptions, resolveNotFoundOptions, resolveOgImageOptions, resolvePageChromeOption, resolvePartialsOptions, resolvePermalinksOptions, resolvePublishStateOptions, resolvePwaOptions, resolveReaderChromeInput, resolveRedirectsOptions, resolveResourcesOptions, resolveSearchOptions, resolveSectionIndexOptions, resolveSiteMapsOptions, resolveSsgOptions, resolveStepsOptions, resolveTaxonomiesOptions, resolveTeamOptions, resolveTheme, resolveTimelineOptions, resolveTypedHoverOptions, resolveVersionsOptions, runDocsTests, setRenderContext, shouldLintMarkdownFile, stripMarkdownExtension, stripViteQuery, tokensToCss, transformAllPlugins, transformBudouxHtml, transformGitHub, transformGraphvizStatic, transformIslands, transformMarkdown, transformMermaidStatic, transformOgp, transformRedditEmbeds, transformTabs, transformYouTube, typecheckCodeBlocks, useIsActive, useNav, usePageProps, useRenderContext, useSiteConfig, when, writeDocs, writeDocsTestFiles, writeFeedFiles, writeMarkdownCompanions, writeResourceFiles, writeSearchIndex, writeSiteMapFiles };
 //# sourceMappingURL=index.d.cts.map