@ox-content/vite-plugin 3.0.0-alpha.1 → 3.0.0-alpha.11

package/dist/index.d.mts

@@ -48,6 +48,33 @@ 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-fonts.d.ts
+type ThemeFontProvider = "google" | "local";
+type ThemeFontStyle = "normal" | "italic";
+type ThemeFontDisplay = "auto" | "block" | "swap" | "fallback" | "optional";
+/** UnoCSS-inspired family descriptor. The string stack form remains valid. */
+interface ThemeWebFont {
+  /** Family name, e.g. `"Inter"` or `"DM Mono"`. */
+  family: string;
+  /** Defaults to `"local"` when `path` is set, otherwise `"google"`. */
+  provider?: ThemeFontProvider;
+  /** File, directory, or `@fontsource/*` package. Required for `local`. */
+  path?: string;
+  weights?: number[];
+  styles?: ThemeFontStyle[];
+  subsets?: string[];
+  display?: ThemeFontDisplay;
+  /** Copy files into the SSG output and emit `@font-face`. */
+  selfHost?: boolean;
+  /** Extra families after `family` in the emitted CSS stack. */
+  fallbacks?: string[];
+  /** Preload every self-hosted face, or only these weights. */
+  preload?: boolean | number[];
+  /** Optional `unicode-range` for local faces. */
+  unicodeRange?: string;
+}
+type ThemeFontValue = string | ThemeWebFont;
+//#endregion
 //#region src/theme-tokens.d.ts
 /**
  * Free-form `--octc-*` custom properties for themes that need more than the
@@ -100,12 +127,17 @@ interface ThemeLayout {
 }
 /**
  * Theme font configuration.
+ *
+ * `sans` and `mono` accept a CSS stack string or a web-font object. Named
+ * families are extra stacks exposed as `--octc-font-<name>`.
  */
 interface ThemeFonts {
-  /** Sans-serif font stack */
-  sans?: string;
-  /** Monospace font stack */
-  mono?: string;
+  /** Sans-serif font stack or self-hosted family */
+  sans?: ThemeFontValue;
+  /** Monospace font stack or self-hosted family */
+  mono?: ThemeFontValue;
+  /** Additional families, exposed as `--octc-font-<name>` */
+  named?: Record<string, ThemeFontValue>;
 }
 /**
  * Entry page theme configuration.
@@ -225,6 +257,14 @@ interface ThemeConfig {
    * `breadcrumbs: false` still hides it on that page.
    */
   breadcrumbs?: boolean | Record<string, unknown>;
+  /**
+   * Heading permalink visibility. CSS only — the renderer HTML stays
+   * `<a class="header-anchor" href="#id">`.
+   *
+   * `"hover"` (default) reveals the `#` on hover / focus-visible, and
+   * stays visible on touch. `"always"` keeps it visible.
+   */
+  headingPermalink?: "hover" | "always";
   /** Light mode colors (maps to CSS variables) */
   colors?: ThemeColors;
   /** Dark mode colors (maps to CSS variables) */
@@ -279,6 +319,7 @@ interface ResolvedThemeConfig {
   viewTransitions: boolean;
   aside: boolean;
   breadcrumbs: boolean;
+  headingPermalink: "hover" | "always";
   colors: ThemeColors;
   darkColors: ThemeColors;
   fonts: ThemeFonts;
@@ -346,6 +387,377 @@ 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;
+}
+//#endregion
 //#region src/plugins/github/types.d.ts
 interface GitHubRepoData {
   name: string;
@@ -371,6 +783,11 @@ interface GitHubSourceRef {
   permalink: string;
   lines?: GitHubLineRange;
 }
+interface GitHubSourceCommit {
+  sha: string;
+  message: string;
+  html_url: string;
+}
 interface GitHubSourceData {
   repo: string;
   ref: string;
@@ -380,6 +797,7 @@ interface GitHubSourceData {
   size: number;
   html_url: string;
   language: string | null;
+  commit?: GitHubSourceCommit;
 }
 interface GitHubOptions {
   /**
@@ -447,31 +865,7 @@ declare function parseGitHubPermalink(value: string): GitHubSourceRef | null;
  */
 declare function transformGitHub(html: string, repoDataMap?: Map<string, GitHubRepoData | null>, options?: GitHubOptions): Promise<string>;
 //#endregion
-//#region src/plugins/twitter/types.d.ts
-interface TwitterEmbedOptions {
-  /** Fetch the post body, author, and media from X at build time. */
-  fetch?: boolean;
-  /** Language sent to the syndication endpoint. @default "en" */
-  lang?: string;
-  /** Request timeout in milliseconds. @default 10000 */
-  timeout?: number;
-  /** Cache syndication responses in memory and on disk. @default true */
-  cache?: boolean;
-  /** Directory used for the persistent metadata cache. @default ".cache/ox-content/twitter" */
-  cacheDir?: string;
-  /** Directory where avatars and photos are written. @default "public/ox-content/twitter" */
-  mediaOutputDir?: string;
-  /** Public URL prefix for downloaded media. @default "/ox-content/twitter" */
-  mediaPublicPath?: string;
-}
-//#endregion
-//#region src/plugins/ogp.d.ts
-/**
- * OGP Card Plugin - Link card embedding
- *
- * Transforms <OgCard> components into static link preview cards
- * by fetching OGP metadata at build time.
- */
+//#region src/plugins/ogp/types.d.ts
 interface OgpData {
   url: string;
   title: string;
@@ -488,119 +882,45 @@ interface OgpOptions {
   timeout?: number;
   /**
    * Cache fetched Open Graph metadata in memory for the current process.
+   * Persistent disk cache also requires this to be enabled.
    * @default true
    */
   cache?: boolean;
   /**
-   * Cache TTL in milliseconds.
+   * Cache TTL in milliseconds. Fresh memory and disk entries skip the network.
    * @default 3600000
    */
   cacheTTL?: number;
   /**
-   * User agent sent with metadata fetch requests.
-   * @default 'ox-content-ogp-bot/1.0 (compatible; +https://github.com/ubugeeei-prod/ox-content)'
-   */
-  userAgent?: string;
-}
-/**
- * Fetch OGP data for a URL.
- */
-declare function fetchOgpData(url: string, options: Required<OgpOptions>): Promise<OgpData | null>;
-/**
- * Collect all OGP URLs from HTML for pre-fetching.
- */
-declare function collectOgpUrls(html: string): Promise<string[]>;
-/**
- * Pre-fetch all OGP data.
- */
-declare function prefetchOgpData(urls: string[], options?: OgpOptions): Promise<Map<string, OgpData | null>>;
-/**
- * Transform OgCard components in HTML.
- */
-declare function transformOgp(html: string, ogpDataMap?: Map<string, OgpData | null>, options?: OgpOptions): Promise<string>;
-//#endregion
-//#region src/plugins/pm.d.ts
-/**
- * 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.
+   * Persist successful and negative cache entries to disk across builds.
+   * Off by default so existing sites do not write a cache directory.
    * @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.
- *
- * 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;
+  persistCache?: boolean;
   /**
-   * Default iframe aspect ratio.
-   * @default '16/9'
+   * Directory used for the persistent metadata cache when `persistCache` is on.
+   * @default ".cache/ox-content/ogp"
    */
-  aspectRatio?: string;
+  cacheDir?: string;
   /**
-   * Allow fullscreen playback.
-   * @default true
+   * Re-fetch metadata even when a fresh cache entry exists.
+   * @default false
    */
-  allowFullscreen?: boolean;
+  refresh?: boolean;
   /**
-   * Lazy load the iframe.
-   * @default true
+   * User agent sent with metadata fetch requests.
+   * @default 'ox-content-ogp-bot/1.0 (compatible; +https://github.com/ubugeeei-prod/ox-content)'
    */
-  lazyLoad?: boolean;
+  userAgent?: string;
 }
-/**
- * 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/ogp/fetch.d.ts
+declare function fetchOgpData(url: string, options?: OgpOptions): Promise<OgpData | null>;
+//#endregion
+//#region src/plugins/ogp/transform.d.ts
+declare function collectOgpUrls(html: string): Promise<string[]>;
+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/mermaid.d.ts
 /**
@@ -627,12 +947,45 @@ 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
@@ -645,18 +998,127 @@ interface TransformAllOptions {
   ogp?: boolean | OgpOptions;
   openGraph?: boolean | OgpOptions;
   mermaid?: boolean;
+  graphviz?: boolean | GraphvizOptions;
   githubToken?: string;
-  spotify?: boolean;
-  stackBlitz?: boolean;
-  twitter?: boolean | TwitterEmbedOptions;
-  bluesky?: boolean;
-  webContainer?: boolean;
 }
 /**
  * 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
+   */
+  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;
+}
+//#endregion
 //#region src/page-context.d.ts
 /**
  * Base page props available for all pages.
@@ -672,10 +1134,17 @@ interface BasePageProps {
   toc: TocEntry[];
   /** Last git commit timestamp in milliseconds */
   lastUpdated?: number;
+  /** Unique git authors for this page */
+  contributors?: Array<{
+    name: string;
+    avatar?: string;
+  }>;
   /** Source file path (relative to docs root) */
   path: string;
   /** Output URL path */
   url: string;
+  /** Published Markdown companion URL when `ssg.markdownSource` is on */
+  markdownSource?: string;
   /** Raw frontmatter object */
   frontmatter: Record<string, unknown>;
   /** Layout name from frontmatter */
@@ -872,10 +1341,17 @@ interface PageData {
   toc: TocEntry[];
   /** Last git commit timestamp in milliseconds */
   lastUpdated?: number;
+  /** Unique git authors for this page */
+  contributors?: Array<{
+    name: string;
+    avatar?: string;
+  }>;
   /** Source file path */
   path: string;
   /** Output URL path */
   url: string;
+  /** Published Markdown companion URL when `ssg.markdownSource` is on */
+  markdownSource?: string;
   /** Frontmatter */
   frontmatter: Record<string, unknown>;
   /** Layout name */
@@ -1082,6 +1558,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.
@@ -1187,6 +1678,17 @@ interface SsgOptions {
    * @default false
    */
   lastUpdated?: boolean;
+  /**
+   * List unique git authors for each page.
+   *
+   * Off by default. `true` enables names only. An object enables the
+   * feature and can set `ignore` and `avatars`. Missing `.git` (for
+   * example a published tarball) yields an empty list and does not
+   * fail the build.
+   *
+   * @default false
+   */
+  contributors?: boolean | ContributorsOptions;
   /**
    * Show previous/next page links after the article.
    *
@@ -1206,6 +1708,26 @@ interface SsgOptions {
    * @default false
    */
   breadcrumbs?: boolean | Record<string, unknown>;
+  /**
+   * Emit JSON-LD structured data (`TechArticle`, `WebSite`, and optional
+   * `BreadcrumbList`) in the page `<head>`.
+   *
+   * Disabled when omitted or `false`. `true` enables the defaults. An object
+   * enables the feature and can hide BreadcrumbList or supply a publisher.
+   * Publisher fields the site does not set are not invented.
+   *
+   * @default false
+   */
+  jsonLd?: boolean | JsonLdOptions;
+  /**
+   * Validate custom page-head descriptors during SSG.
+   *
+   * `false` / omitted drops invalid values silently. `warn` logs them.
+   * `strict` fails the build on unsafe URLs or invalid hreflang.
+   *
+   * @default false
+   */
+  headValidation?: false | "warn" | "strict";
   /**
    * Opt-in copy buttons, outbound-link icons, and a back-to-top control.
    *
@@ -1246,6 +1768,21 @@ interface SsgOptions {
    * @default false
    */
   pageChrome?: boolean | Record<string, unknown>;
+  /**
+   * Publish the original Markdown beside each generated HTML page.
+   *
+   * Off by default. `true` writes a `.md` companion using the published URL
+   * (permalink, locale, base, and output directory) and adds
+   * `<link rel="alternate" type="text/markdown">`. An object enables the
+   * feature and can turn the alternate link off, or opt in to the default
+   * theme's Copy as Markdown control.
+   *
+   * The companion is a byte-for-byte copy of the source file, including
+   * frontmatter. Draft and unlisted pages are never written.
+   *
+   * @default false
+   */
+  markdownSource?: boolean | MarkdownSourceOptions;
   /**
    * Write a themed 404 page during SSG.
    *
@@ -1267,6 +1804,27 @@ interface SsgOptions {
    * @default false
    */
   team?: boolean | TeamOptions;
+  /**
+   * Opt-in blog index, authors, tags, reading time, and archive.
+   *
+   * Off by default. `true` enables defaults. An object enables the feature
+   * and overrides only the fields you set. Top-level `blog` wins when both
+   * are set.
+   *
+   * @default false
+   */
+  blog?: boolean | BlogOptions;
+  /**
+   * Generate a static index for directories that have child pages but no
+   * `index.md` / `index.mdx`.
+   *
+   * Off by default. `true` enables card listings. An object enables the
+   * feature and can switch the listing to `list`. Existing content indexes
+   * are never overwritten.
+   *
+   * @default false
+   */
+  sectionIndex?: boolean | SectionIndexOptions;
   /**
    * Absolute site URL used when generating social metadata.
    *
@@ -1362,12 +1920,66 @@ interface A11yOptions {
 type ResolvedA11y = false | {
   skipLinkLabel: string;
 };
+/**
+ * Per-control flags for `ssg.jsonLd`.
+ *
+ * Omitted fields keep the defaults when the feature itself is enabled.
+ */
+interface JsonLdOptions {
+  /**
+   * Emit `BreadcrumbList` when a visible breadcrumb trail exists.
+   *
+   * @default true
+   */
+  breadcrumbs?: boolean;
+  /**
+   * Optional publisher. Only configured `name` / `url` are written.
+   * Logo and other Organization fields are never invented.
+   */
+  publisher?: JsonLdPublisherOptions;
+  /**
+   * Page `@type`. Defaults to `TechArticle`.
+   */
+  type?: JsonLdPageType;
+  /**
+   * Extra `@graph` nodes. Only objects are kept. The build does not invent
+   * fields inside them.
+   */
+  graph?: Record<string, unknown>[];
+}
+/** JSON-LD page node `@type`. Unknown values fall back to `TechArticle`. */
+type JsonLdPageType = "TechArticle" | "BlogPosting" | "WebPage";
+/**
+ * Optional JSON-LD publisher. Empty or omitted fields are left out.
+ */
+interface JsonLdPublisherOptions {
+  /** Organization name. */
+  name?: string;
+  /** Organization URL. `javascript:` and other unsafe schemes are dropped. */
+  url?: string;
+}
+/**
+ * Resolved JSON-LD options. `false` means no `<script type="application/ld+json">`.
+ */
+type ResolvedJsonLd = false | {
+  breadcrumbs: boolean;
+  publisher?: {
+    name?: string;
+    url?: string;
+  };
+  type?: JsonLdPageType;
+  graph?: Record<string, unknown>[];
+};
 /**
  * Resolved SSG options.
  */
 interface ResolvedSsgOptions {
   enabled: boolean;
   extension: string;
+  /**
+   * Present after `resolveSsgOptions`. Omitted / empty means off.
+   */
+  routePrefix?: string;
   clean: boolean;
   bare: boolean;
   render?: ThemeComponent;
@@ -1379,12 +1991,25 @@ interface ResolvedSsgOptions {
   ogImage?: string;
   generateOgImage: boolean;
   lastUpdated: boolean;
+  /**
+   * Present after `resolveSsgOptions`. Omitted in hand-built fixtures means off.
+   */
+  contributors?: ResolvedContributors;
   pagination: boolean;
   breadcrumbs: boolean;
+  jsonLd: ResolvedJsonLd;
+  /**
+   * Present after `resolveSsgOptions`. Omitted / `false` means off.
+   */
+  headValidation?: false | "warn" | "strict";
   readerChrome: ResolvedReaderChrome;
   localeSwitcher: boolean;
   a11y: ResolvedA11y;
   pageChrome: boolean;
+  /**
+   * Present after `resolveSsgOptions`. Omitted in hand-built fixtures means off.
+   */
+  markdownSource?: ResolvedMarkdownSourceOptions;
   /**
    * Present after `resolveSsgOptions`. Omitted in hand-built fixtures means off.
    */
@@ -1393,6 +2018,11 @@ interface ResolvedSsgOptions {
    * Present after `resolveSsgOptions`. Omitted in hand-built fixtures means off.
    */
   team?: ResolvedTeamOptions;
+  /**
+   * Present after `resolveSsgOptions`. Omitted in hand-built fixtures means off.
+   */
+  blog?: ResolvedBlogOptions;
+  sectionIndex?: ResolvedSectionIndexOptions;
   siteUrl?: string;
   theme?: ResolvedThemeConfig;
   navigation?: SsgNavigationGroup[];
@@ -1445,6 +2075,29 @@ interface TeamMember {
 /**
  * Opt-in team / members page.
  */
+/**
+ * Opt-in git contributor list.
+ */
+interface ContributorsOptions {
+  /**
+   * Author names or emails to omit. Comparison is case-insensitive and
+   * matches the full name or the full email.
+   */
+  ignore?: string[];
+  /**
+   * When true and a git author email is present, render a Gravatar
+   * image from the MD5 of that email. The raw email is never written
+   * into HTML. Default is names only.
+   */
+  avatars?: boolean;
+}
+/**
+ * Resolved git contributor list. `false` means the feature is off.
+ */
+type ResolvedContributors = false | {
+  ignore: string[];
+  avatars: boolean;
+};
 interface TeamOptions {
   /**
    * People rendered as static cards on `layout: team` pages.
@@ -1460,7 +2113,140 @@ interface ResolvedTeamOptions {
   members: TeamMember[];
 }
 /**
- * Opt-in crawl manifests written during SSG.
+ * Listing style for a generated section index.
+ */
+type SectionIndexStyle = "list" | "cards";
+/**
+ * Opt-in generated section index pages.
+ */
+interface SectionIndexOptions {
+  /**
+   * How children are rendered. `cards` is the default when the feature is on.
+   * @default "cards"
+   */
+  style?: SectionIndexStyle;
+}
+/**
+ * Resolved generated section index options.
+ */
+interface ResolvedSectionIndexOptions {
+  enabled: boolean;
+  style: SectionIndexStyle;
+}
+/**
+ * Opt-in web app manifest and service worker written during SSG.
+ *
+ * Enabling `offline` (the default when the feature is on) injects a tiny
+ * client script that registers `sw.js`. Set `offline: false` to keep the
+ * manifest without that script.
+ */
+interface PwaOptions {
+  /**
+   * Write `sw.js` and register it from themed pages.
+   * @default true
+   */
+  offline?: boolean;
+  /**
+   * Manifest `name`. Falls back to `ssg.siteName` when omitted.
+   */
+  name?: string;
+  /**
+   * Manifest `short_name`. Falls back to `name` when omitted.
+   */
+  shortName?: string;
+  /**
+   * Manifest / meta theme color. Hex (`#rgb` / `#rrggbb`) or a CSS color name.
+   * @default "#000000"
+   */
+  themeColor?: string;
+  /**
+   * Manifest background color. Hex or a CSS color name.
+   * @default "#ffffff"
+   */
+  backgroundColor?: string;
+  /**
+   * Manifest `start_url`. Same-origin site paths only (`/`, `/docs/`).
+   * Defaults to the Vite `base`.
+   */
+  startUrl?: string;
+}
+/**
+ * Resolved PWA options.
+ */
+interface ResolvedPwaOptions {
+  enabled: boolean;
+  offline: boolean;
+  name?: string;
+  shortName?: string;
+  themeColor?: string;
+  backgroundColor?: string;
+  startUrl?: string;
+}
+/**
+ * Opt-in self-hosted Iconify CSS for used icons.
+ *
+ * Off by default. When enabled, the SSG build resolves Iconify names from
+ * installed `@iconify/json` or `@iconify-json/*` packages and emits CSS
+ * masks so the published site does not request `api.iconify.design`.
+ */
+interface IconsOptions {
+  /**
+   * 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.
+ */
+interface MarkdownSourceOptions {
+  /**
+   * Add `<link rel="alternate" type="text/markdown">` to generated HTML.
+   * @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.
+ */
+interface ResolvedMarkdownSourceOptions {
+  enabled: boolean;
+  alternate: boolean;
+  copy: boolean;
+}
+/**
+ * Opt-in crawl manifests written during SSG.
  */
 interface SiteMapsOptions {
   /**
@@ -1548,6 +2334,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.
  *
@@ -1562,10 +2355,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
@@ -1576,6 +2372,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.
@@ -1589,29 +2393,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
@@ -1622,16 +2477,130 @@ 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.
+ */
+interface BlogAuthor {
+  /** Display name. Escaped in HTML. */
+  name: string;
+  /** Optional short bio. Escaped in HTML. */
+  bio?: string;
+  /** Profile URL. Only `https:` or a site-relative `/` path is emitted. */
+  url?: string;
+}
+/**
+ * Opt-in blog index, authors, tags, reading time, and archive.
+ */
+interface BlogOptions {
+  /**
+   * Named collection of posts. Defaults to a collection named `blog`, or
+   * the only configured collection. Required when several collections exist
+   * and none is named `blog`.
+   */
+  collection?: string;
+  /**
+   * Author records keyed by the frontmatter `author` / `authors` value.
+   * @default {}
+   */
+  authors?: Record<string, BlogAuthor>;
+  /**
+   * Posts per index page, newest first.
+   * @default 10
+   */
+  pageSize?: number;
+  /**
+   * External RSS / Atom sources merged into the blog index at build time.
+   * Empty / omitted fetches nothing. Only these URLs are requested.
+   * @default []
+   */
+  feeds?: Array<string | BlogFeedSource>;
+}
+/**
+ * One configured external blog feed.
+ */
+interface BlogFeedSource {
+  /** Absolute `https:` feed URL. */
+  url: string;
+  /** Default language applied when an item omits one. */
+  language?: string;
+  /** Default author applied when an item omits one. */
+  author?: string;
+  /**
+   * Failed fetch / parse handling for this source.
+   * `warn` skips the source. `error` fails the build after other sources run.
+   * @default "warn"
+   */
+  onError?: BlogFeedFailurePolicy;
+}
+/** How a failed external feed source is reported. */
+type BlogFeedFailurePolicy = "warn" | "error";
+/**
+ * Resolved blog options.
+ */
+interface ResolvedBlogOptions {
+  enabled: boolean;
+  collection?: string;
+  authors: Record<string, BlogAuthor>;
+  pageSize: number;
+  feeds: ResolvedBlogFeedSource[];
+}
+/**
+ * Resolved external blog feed source.
+ */
+interface ResolvedBlogFeedSource {
+  url: string;
+  language?: string;
+  author?: string;
+  onError: BlogFeedFailurePolicy;
 }
 /**
  * Opt-in term list pages, per-term pages, and related-page lists.
@@ -1830,6 +2799,18 @@ interface OxContentOptions {
    * @default false
    */
   redirects?: boolean | RedirectsOptions | Record<string, string>;
+  /**
+   * Write a paginated blog index, tag pages, and yearly/monthly archive,
+   * and inject author / reading-time chrome on posts.
+   *
+   * Off by default. `true` uses the `blog` collection when it exists,
+   * otherwise the only configured collection, with pageSize 10.
+   * An object enables the feature and overrides only the fields you set.
+   * Also accepted as `ssg.blog`; the top-level option wins when both are set.
+   *
+   * @default false
+   */
+  blog?: boolean | BlogOptions;
   /**
    * Write RSS, Atom, and/or JSON Feed files from a named collection.
    *
@@ -1842,6 +2823,29 @@ interface OxContentOptions {
    * @default false
    */
   feeds?: boolean | FeedsOptions;
+  /**
+   * Write a web app manifest and an optional service worker.
+   *
+   * Off by default. `true` writes `manifest.webmanifest` and `sw.js`, and
+   * injects a tiny client script that registers the worker on themed pages.
+   * An object enables the feature and can set `offline: false` to keep the
+   * manifest without caching or that script. This adds client JavaScript
+   * when offline is on. Requires `ssg.siteUrl`. When that is missing the
+   * build continues and a warning is emitted instead of writing files.
+   *
+   * @default false
+   */
+  pwa?: boolean | PwaOptions;
+  /**
+   * Generate self-hosted Iconify CSS for used and safelisted icons.
+   *
+   * Off by default. `true` or `{}` enables CSS-mask emission. Install
+   * `@iconify/json` or individual `@iconify-json/*` packages so the build
+   * can resolve collections without a network request.
+   *
+   * @default false
+   */
+  icons?: boolean | IconsOptions;
   /**
    * Write tag/category term pages and inject related-page lists.
    *
@@ -1884,6 +2888,17 @@ interface OxContentOptions {
    * @default true
    */
   footnotes?: boolean;
+  /**
+   * Render footnotes as a semantic ordered section with numeric markers.
+   *
+   * Source identifiers are used only for lookup and slugs. Visible markers
+   * are 1, 2, … in document order, and definitions emit as
+   * `<section class="footnotes"><ol><li>…`.
+   *
+   * Off by default so current alpha HTML stays stable.
+   * @default false
+   */
+  semanticFootnotes?: boolean;
   /**
    * Enable tables.
    * @default true
@@ -1908,9 +2923,9 @@ interface OxContentOptions {
    * Enable syntax highlighting for code blocks.
    *
    * When true, fenced and language-tagged inline code is highlighted with the
-   * native tree-sitter engine. Token colors are `--octc-shiki-*` custom
-   * properties (the `shiki` prefix is historical) so theme-color packages keep
-   * working. Languages with no native grammar stay unhighlighted.
+   * native tree-sitter engine. Token colors are `--octc-syntax-*` custom
+   * properties so theme-color packages resolve highlighting. Languages with no
+   * native grammar stay unhighlighted.
    *
    * @default false
    */
@@ -1960,6 +2975,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.
    *
@@ -1969,6 +3020,62 @@ 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.
+   *
+   * Passing `true` or an options object enables GitHub-user, alias, and
+   * explicit `label|url` forms. Attributes and text are HTML-escaped.
+   * Fenced, indented, inline, and raw code, plus already-linked text, are
+   * skipped. The transform does not make network requests unless an explicit
+   * favicon template is enabled (still URL-only; no fetch at transform time).
+   *
+   * @default false
+   */
+  magicLinks?: boolean | MagicLinkOptions;
   /**
    * Opt-in `::: tip` custom containers.
    *
@@ -1989,6 +3096,57 @@ 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.
+   *
+   * Off by default. `true` or `{}` treats each page directory as a bundle:
+   * sibling images are addressable with relative URLs. Query-string
+   * resize/crop/format transforms run at build time and are cached by
+   * source mtime plus transform params. Paths that leave the page
+   * directory or `srcDir` are rejected. Missing sources fail the build
+   * when `missing` is `"error"` (the default when enabled).
+   * `dedupe` is off unless set; it does not turn on with `true` / `{}`.
+   *
+   * This is separate from `images`, which only adds figures, captions,
+   * and lazy-loading.
+   *
+   * @default false
+   */
+  resources?: boolean | ResourcesOptions;
   /**
    * Import source snippets into fences with `<<< @/path/to/file.ts{region}`.
    *
@@ -2010,6 +3168,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.
    *
@@ -2028,15 +3197,37 @@ 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.
    *
    * Passing `true` or `{}` enables the transform. Names are escaped and never
-   * read from the filesystem.
+   * read from the filesystem. Directories with children open and close with
+   * `<details>`. Icons are on by default and can be replaced from site config.
    *
    * @default false
    */
   fileTree?: boolean | FileTreeOptions;
+  /**
+   * Opt-in static tables from `csv-table` / `json-table` fences.
+   *
+   * Passing `true` or `{}` enables the transform. Inline CSV/JSON becomes a
+   * semantic `<table>` with a responsive wrapper. `src` or a single path body
+   * can import `@/data/options.csv` or `./options.json`. Paths cannot escape
+   * the content/project root with `..`. Missing imports use `missing`.
+   *
+   * @default false
+   */
+  dataTables?: boolean | DataTableOptions;
   /**
    * Sanitize rendered HTML with safe defaults or explicit allow lists.
    *
@@ -2083,6 +3274,16 @@ interface OxContentOptions {
    * @default false
    */
   codeBlockTypecheck?: boolean | CodeBlockTypecheckOptions;
+  /**
+   * Attach build-time TypeScript hover overlays to opted-in fences.
+   *
+   * Off by default. `true` or `{}` enables the feature. Only `ts` / `tsx`
+   * fences tagged `twoslash` receive payloads. Types are generated during
+   * the Markdown transform; no TypeScript compiler is shipped to the browser.
+   *
+   * @default false
+   */
+  typedHover?: boolean | TypedHoverOptions;
   /**
    * Extract runnable fenced examples for Vitest docs-as-tests harnesses.
    *
@@ -2097,6 +3298,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.
    *
@@ -2121,6 +3329,15 @@ interface OxContentOptions {
    * @default 3
    */
   tocMaxDepth?: number;
+  /**
+   * Append a visible heading permalink (`<a class="header-anchor" href="#id">`).
+   *
+   * Reuses the generated heading id. Default off. Theme
+   * `headingPermalink: "hover" | "always"` changes only CSS visibility.
+   *
+   * @default false
+   */
+  headingPermalinks?: boolean | HeadingPermalinksOptions;
   /**
    * Enable OG image generation.
    * @default false
@@ -2194,12 +3411,23 @@ interface ResolvedOptions {
   permalinks?: ResolvedPermalinksOptions;
   cascade?: ResolvedCascadeOptions;
   redirects?: ResolvedRedirectsOptions;
+  blog?: ResolvedBlogOptions;
   feeds?: ResolvedFeedsOptions;
+  pwa?: ResolvedPwaOptions;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  icons?: ResolvedIconsOptions;
   taxonomies?: ResolvedTaxonomiesOptions;
   versions?: ResolvedVersionsOptions;
+  resources?: ResolvedResourcesOptions;
   gfm: boolean;
   mdx?: boolean;
   footnotes: boolean;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  semanticFootnotes?: boolean;
   tables: boolean;
   taskLists: boolean;
   strikethrough: boolean;
@@ -2209,25 +3437,78 @@ 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;
   codeBlockLint: ResolvedCodeBlockLintOptions;
   codeBlockTypecheck: ResolvedCodeBlockTypecheckOptions;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  typedHover?: ResolvedTypedHoverOptions;
   docsTests: ResolvedDocsTestOptions;
   mermaid: boolean;
+  graphviz: ResolvedGraphvizOptions | false;
   math: ResolvedMathOptions;
   frontmatter: boolean;
   toc: boolean;
   tocMaxDepth: number;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  headingPermalinks?: ResolvedHeadingPermalinksOptions;
   ogImage: boolean;
   ogImageOptions: ResolvedOgImageOptions$1;
   transformers: MarkdownTransformer[];
@@ -2269,6 +3550,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
@@ -2281,11 +3584,83 @@ 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
@@ -2310,9 +3685,26 @@ 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;
 }
 /**
@@ -2332,6 +3724,169 @@ 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.
+ */
+interface MagicLinkOptions {
+  /**
+   * Enable the magic-link transform when an options object is supplied.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * Named aliases. A string value is treated as `{ href }`.
+   */
+  aliases?: Record<string, string | MagicLinkAlias>;
+  /**
+   * Emit a favicon URL when a link has no image.
+   *
+   * `true` uses `https://{host}/favicon.ico`. Pass `{ template }` to override.
+   * The transform never fetches; the browser may load the URL later.
+   *
+   * @default false
+   */
+  favicon?: boolean | {
+    template?: string;
+  };
+  /**
+   * Replace the resolved image for matching hrefs.
+   */
+  imageOverrides?: MagicLinkImageOverride[];
+}
+/**
+ * One configured magic-link target.
+ */
+interface MagicLinkAlias {
+  href: string;
+  label?: string;
+  image?: string;
+}
+/**
+ * Replace the image for an exact href or prefix.
+ */
+interface MagicLinkImageOverride {
+  href?: string;
+  prefix?: string;
+  image: string;
+}
+/**
+ * Resolved magic-link transform options.
+ */
+interface ResolvedMagicLinkOptions {
+  enabled: boolean;
+  aliases: Record<string, MagicLinkAlias>;
+  favicon: boolean;
+  faviconTemplate?: string;
+  imageOverrides: MagicLinkImageOverride[];
+}
 /**
  * Options for opt-in `::: type` custom containers.
  */
@@ -2384,6 +3939,159 @@ 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.
+ */
+interface ResourcesOptions {
+  /**
+   * Allowed output formats for `?format=`.
+   *
+   * `jpg` is treated as `jpeg`. Pixel transforms encode `png` and `jpeg`.
+   * `webp` is copied when the source is already webp and no pixel
+   * transform is requested.
+   *
+   * @default ["png", "jpeg", "webp"]
+   */
+  formats?: string[];
+  /**
+   * Allowed `?width=` / `?w=` values. An empty list allows any positive
+   * width.
+   *
+   * @default []
+   */
+  widths?: number[];
+  /**
+   * What to do when a relative resource is missing.
+   *
+   * @default "error"
+   */
+  missing?: "error" | "warn";
+  /**
+   * Emit identical bytes once as `/assets/content/<sha256>.<ext>` and
+   * rewrite `src`, `poster`, and relevant `href` to that URL.
+   *
+   * Off unless this is `true`. `resources: true` and `{}` leave it off.
+   *
+   * @default false
+   */
+  dedupe?: boolean;
+}
+/**
+ * Resolved page-resource options.
+ */
+interface ResolvedResourcesOptions {
+  enabled: boolean;
+  formats: string[];
+  widths: number[];
+  missing: "error" | "warn";
+  dedupe: boolean;
+}
 /**
  * Options for expanding Obsidian-style wiki links.
  *
@@ -2440,6 +4148,10 @@ interface ResolvedEmojiShortcodeOptions {
 }
 /**
  * Options for opt-in `$…$` / `$$…$$` math.
+ *
+ * Delimiter parsing lives in the native transform. Typesetting uses KaTeX at
+ * build time when the optional `katex` peer is installed. Sites that omit
+ * `math` do not need that package.
  */
 interface MathOptions {
   /**
@@ -2479,6 +4191,27 @@ interface AttrsOptions {
 interface ResolvedAttrsOptions {
   enabled: boolean;
 }
+/**
+ * Opt-in visible heading permalinks.
+ *
+ * Headings already have stable `id`s. Enabling this appends a real
+ * `<a class="header-anchor" href="#id">` using that exact id. Off by
+ * default so existing HTML stays byte-stable.
+ */
+interface HeadingPermalinksOptions {
+  /**
+   * Emit the permalink control.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+}
+/**
+ * Resolved heading permalink options.
+ */
+interface ResolvedHeadingPermalinksOptions {
+  enabled: boolean;
+}
 /**
  * Options for importing source snippets into code fences.
  *
@@ -2531,6 +4264,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.
  */
@@ -2565,6 +4340,37 @@ interface StepsOptions {
 interface ResolvedStepsOptions {
   enabled: boolean;
 }
+/**
+ * Options for opt-in `::: code-group` fence groups.
+ */
+interface CodeGroupOptions {
+  /**
+   * Enable the code-group transform when an options object is supplied.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+}
+/**
+ * Resolved code-group transform options.
+ */
+interface ResolvedCodeGroupOptions {
+  enabled: boolean;
+}
+/**
+ * Replaceable file-tree icons. Values are trusted site-config SVG markup or
+ * CSS class tokens, never fence content.
+ */
+interface FileTreeIconOptions {
+  /** Collapsed folder icon. */
+  folder?: string;
+  /** Open folder icon. */
+  folderOpen?: string;
+  /** Default file icon. */
+  file?: string;
+  /** File icons keyed by extension (`ts`, `.json`). */
+  files?: Record<string, string>;
+}
 /**
  * Options for opt-in `file-tree` fences.
  */
@@ -2575,12 +4381,63 @@ interface FileTreeOptions {
    * @default true
    */
   enabled?: boolean;
+  /**
+   * Open directory `<details>` by default.
+   *
+   * @default true
+   */
+  defaultOpen?: boolean;
+  /**
+   * Render folder and file icons. Pass an object to replace the defaults.
+   *
+   * @default true
+   */
+  icons?: boolean | FileTreeIconOptions;
 }
 /**
  * Resolved file-tree transform options.
  */
 interface ResolvedFileTreeOptions {
   enabled: boolean;
+  defaultOpen: boolean;
+  icons: boolean;
+  iconFolder?: string;
+  iconFolderOpen?: string;
+  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.
@@ -2783,6 +4640,43 @@ interface ResolvedCodeBlockTypecheckOptions {
   tsgoCommand: string;
   mode: "warn" | "error";
 }
+/**
+ * Options for opt-in typed hover overlays on TypeScript fences.
+ *
+ * Hover strings are computed at build time with the same TypeScript compiler
+ * family used by `codeBlockTypecheck` (`tsgo` / `typescript`). The browser
+ * only receives JSON payloads and a tiny overlay script.
+ */
+interface TypedHoverOptions {
+  /**
+   * Enable typed hover overlays.
+   *
+   * @default true when the object form is used
+   */
+  enabled?: boolean;
+  /**
+   * Fence languages that can receive hover payloads.
+   *
+   * Language names are compared case-insensitively.
+   *
+   * @default ['ts', 'tsx']
+   */
+  languages?: string[];
+  /**
+   * Path to the `tsgo` binary used to compute hover types.
+   *
+   * When omitted, the bundled `@typescript/native-preview` executable is used.
+   */
+  tsgoCommand?: string;
+}
+/**
+ * Resolved typed-hover options.
+ */
+interface ResolvedTypedHoverOptions {
+  enabled: boolean;
+  languages: string[];
+  tsgoCommand?: string;
+}
 /**
  * Options for extracting fenced examples into docs-as-tests fixtures.
  *
@@ -2865,11 +4759,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`
@@ -2907,17 +4857,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.
@@ -2958,6 +4917,30 @@ interface MarkdownNode {
   value?: string;
   [key: string]: unknown;
 }
+/**
+ * How a specifier was imported from an MDX `import` statement.
+ */
+type MdxImportSpecifierKind = "default" | "named" | "namespace";
+/**
+ * One binding created by an MDX `import` statement.
+ */
+interface MdxImportSpecifier {
+  /** Imported name (`default`, `*`, or the named export). */
+  imported: string;
+  /** Local binding name. */
+  local: string;
+  /** Specifier kind. */
+  kind: MdxImportSpecifierKind;
+}
+/**
+ * One MDX `import` statement collected from the AST.
+ */
+interface MdxImport {
+  /** Module specifier string. */
+  source: string;
+  /** Bindings created by the import. */
+  specifiers: MdxImportSpecifier[];
+}
 /**
  * Transform result.
  */
@@ -2982,6 +4965,30 @@ interface TransformResult {
    * Table of contents.
    */
   toc: TocEntry[];
+  /**
+   * MDX `import` statements (empty when MDX is off or no ESM nodes).
+   */
+  imports: MdxImport[];
+  /**
+   * Export names from MDX ESM (empty when MDX is off or no exports).
+   */
+  exports: string[];
+  /**
+   * Unique JSX component names in document order (empty when none).
+   */
+  components: string[];
+  /**
+   * 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.
@@ -3086,6 +5093,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.
    *
@@ -3273,6 +5289,7 @@ interface ResolvedDocsOptions {
   include: string[];
   exclude: string[];
   entryPoints?: ResolvedDocsEntryPoint[];
+  openapi: ResolvedOpenApiDocsOptions | false;
   format: "markdown" | "json" | "html";
   private: boolean;
   internal: boolean;
@@ -3301,6 +5318,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.
  *
@@ -3583,6 +5642,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.
    *
@@ -3651,6 +5720,7 @@ interface ResolvedSearchOptions {
   enabled: boolean;
   limit: number;
   prefix: boolean;
+  fuzzy: boolean;
   placeholder: string;
   hotkey: string;
   provider?: "local" | "hosted";
@@ -3804,6 +5874,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" {
@@ -3839,18 +5936,53 @@ 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"]): ResolvedTypedHoverOptions;
+//#endregion
 //#region src/environment.d.ts
 /**
  * Creates the Markdown processing environment configuration.
@@ -4017,6 +6149,9 @@ declare function renderMarkdownStream(chunks: MarkdownChunkSource, options?: Inc
  * - `html` (string): Rendered HTML content with all enhancements applied
  * - `frontmatter` (object): Parsed YAML frontmatter as JavaScript object
  * - `toc` (array): Hierarchical table of contents entries
+ * - `imports` (array): MDX import statements (`source` + specifiers)
+ * - `exports` (array): MDX export names
+ * - `components` (array): Unique JSX component names
  * - `render` (function): Client-side render function for dynamic updates
  *
  * ## Markdown Features Supported
@@ -4091,6 +6226,156 @@ interface SsgTransformOptions {
 }
 declare function transformMarkdown(source: string, filePath: string, options: ResolvedOptions, ssgOptions?: SsgTransformOptions): Promise<TransformResult>;
 //#endregion
+//#region src/render-markdown.d.ts
+/**
+ * Processor that resolves `OxContentOptions` once and renders many documents.
+ */
+interface MarkdownProcessor {
+  render(source: string, filePath: string): Promise<TransformResult>;
+}
+/**
+ * Resolves public options once so custom `ssg: false` hosts can reuse the pipeline.
+ */
+declare function createMarkdownProcessor(options?: OxContentOptions): MarkdownProcessor;
+/**
+ * Run the Vite plugin Markdown/MDX pipeline from public `OxContentOptions`.
+ *
+ * Returns structured `TransformResult` fields (`html`, `frontmatter`, `toc`,
+ * MDX metadata) so consumers do not need to cast a Vite hook or parse
+ * generated module source. `.md` / `.mdx` inference matches `oxContent()`.
+ */
+declare function renderMarkdown(source: string, filePath: string, options?: OxContentOptions): Promise<TransformResult>;
+//#endregion
+//#region src/markdown.d.ts
+declare const DEFAULT_MARKDOWN_EXTENSIONS: readonly [".md", ".markdown", ".mdx"];
+declare function normalizeMarkdownExtensions(extensions?: readonly string[]): string[];
+declare function isMarkdownFilePath(filePath: string, extensions?: readonly string[]): boolean;
+/** Returns true when a resource id points at an MDX source file. */
+declare function isMdxFilePath(filePath: string): boolean;
+/** Explicit configuration wins; otherwise MDX follows the source extension. */
+declare function resolveMdxForFilePath(filePath: string, configured?: boolean): boolean;
+declare function stripMarkdownExtension(filePath: string, extensions?: readonly string[]): string;
+//#endregion
+//#region src/mdx-islands.d.ts
+/**
+ * Discover registered MDX islands from the mdast tree or rendered HTML.
+ *
+ * Framework plugins use this instead of a source regex when MDX is on, so
+ * nested JSX, expression attributes, and fragments stay visible. Names that
+ * are not in the global `components` map and are not document-local import
+ * bindings are left as static HTML.
+ */
+/** Global component map: object, Map, or name list. */
+type ComponentRegistry = Readonly<Record<string, unknown>> | ReadonlyMap<string, unknown> | Iterable<string>;
+/**
+ * Collect named MDX JSX tags from a parsed mdast tree (JSON from NAPI `parse()`).
+ * Fragments (`name: null`) and non-JSX nodes are ignored. Walks nested children
+ * so inner islands are found.
+ */
+declare function collectMdxJsxNamesFromAst(ast: unknown): string[];
+/**
+ * Collect `data-ox-island` names from Rust-rendered HTML.
+ * Used when an AST walk is unavailable.
+ */
+declare function collectMdxIslandNamesFromHtml(html: string): string[];
+/** Keep names that exist on the global component map, in first-seen order. */
+declare function intersectRegisteredComponentNames(names: Iterable<string>, components: ComponentRegistry): string[];
+/**
+ * Keep names that are either globally registered or document-local bindings.
+ */
+declare function intersectHydratableComponentNames(names: Iterable<string>, components: ComponentRegistry, localNames?: Iterable<string>): string[];
+interface DiscoverRegisteredMdxComponentsInput {
+  /** Markdown/MDX body (frontmatter already stripped). */
+  source: string;
+  /** Rendered HTML, used when `parse()` is missing or the AST walk fails. */
+  html?: string;
+  components: ComponentRegistry;
+  /** Document-local import bindings. These override the global map for this file. */
+  localNames?: Iterable<string>;
+}
+/**
+ * Resolve registered island names for an MDX document.
+ *
+ * Prefers a NAPI `parse()` AST walk. Falls back to rendered `data-ox-island`
+ * names so plugins still hydrate if #659 metadata is not present.
+ */
+declare function discoverRegisteredMdxComponents(input: DiscoverRegisteredMdxComponentsInput): Promise<string[]>;
+declare function isRegisteredComponent(name: string, components: ComponentRegistry): boolean;
+//#endregion
+//#region src/document-imports.d.ts
+interface ResolveDocumentComponentImportsInput {
+  imports: readonly MdxImport[];
+  documentPath: string;
+  contentRoot?: string;
+  srcDir?: string;
+}
+interface ResolvedDocumentComponentImport {
+  localName: string;
+  specifier: string;
+  resolvedPath: string;
+  importPathRelativeToDocument: string;
+  imported: string;
+  kind: Exclude<MdxImportSpecifierKind, "namespace">;
+}
+type DocumentImportDiagnosticCode = "not-relative" | "escapes-root" | "duplicate-binding";
+interface DocumentImportDiagnostic {
+  code: DocumentImportDiagnosticCode;
+  message: string;
+  specifier: string;
+  localName?: string;
+}
+interface ResolveDocumentComponentImportsResult {
+  bindings: ResolvedDocumentComponentImport[];
+  diagnostics: DocumentImportDiagnostic[];
+}
+declare function resolveContentRootPath(input: {
+  contentRoot?: string;
+  srcDir?: string;
+  root?: string;
+}): string;
+declare function stripViteQuery(id: string): string;
+declare function resolveDocumentComponentImports(input: ResolveDocumentComponentImportsInput): ResolveDocumentComponentImportsResult;
+//#endregion
+//#region src/document-islands.d.ts
+interface DiscoverDocumentMdxIslandsInput {
+  source: string;
+  html?: string;
+  components: ComponentRegistry;
+  imports: readonly MdxImport[];
+  documentPath: string;
+  contentRoot?: string;
+  srcDir?: string;
+  root?: string;
+}
+interface DiscoverDocumentMdxIslandsResult {
+  usedComponents: string[];
+  localBindings: Map<string, ResolvedDocumentComponentImport>;
+  diagnostics: DocumentImportDiagnostic[];
+}
+declare function discoverDocumentMdxIslands(input: DiscoverDocumentMdxIslandsInput): Promise<DiscoverDocumentMdxIslandsResult>;
+//#endregion
+//#region src/island-codegen.d.ts
+type GlobalComponentMap = Readonly<Record<string, string>> | ReadonlyMap<string, string>;
+interface RenderIslandComponentImportsInput {
+  globalComponents: GlobalComponentMap;
+  localBindings?: ReadonlyMap<string, ResolvedDocumentComponentImport>;
+  documentPath: string;
+  root?: string;
+}
+declare function renderIslandComponentImports(usedComponents: readonly string[], input: RenderIslandComponentImportsInput): string;
+//#endregion
+//#region src/island-ssr.d.ts
+/**
+ * Optional adapter-side island SSR.
+ *
+ * Framework plugins may supply `renderIsland` to replace island inner HTML at
+ * transform time. 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, 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
 declare function resolveImageOptions(options: OxContentOptions["images"]): ResolvedOptions["images"];
 //#endregion
@@ -4118,6 +6403,7 @@ interface FrameworkMarkdownOptions {
   math?: boolean | {
     enabled?: boolean;
   };
+  mdx?: boolean;
 }
 interface FrameworkComponentIsland {
   name: string;
@@ -4399,10 +6685,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.
  */
@@ -4727,6 +7017,76 @@ interface SsgBuildResult {
  */
 declare function buildSsg(options: ResolvedOptions, root: string): Promise<SsgBuildResult>;
 //#endregion
+//#region src/page-head.d.ts
+/** How invalid head descriptors are reported. */
+type HeadValidationMode = false | "off" | "warn" | "strict";
+interface SiteHead {
+  name?: string;
+  url?: string;
+  locale?: string;
+  titleTemplate?: string;
+}
+interface HeadMeta {
+  key?: string;
+  name?: string;
+  property?: string;
+  httpEquiv?: string;
+  content: string;
+}
+interface HeadLink {
+  key?: string;
+  rel: string;
+  href: string;
+  hreflang?: string;
+  type?: string;
+  sizes?: string;
+}
+interface HeadAlternate {
+  lang: string;
+  href: string;
+}
+interface HeadJsonLd {
+  key?: string;
+  json: string;
+}
+/**
+ * Build-time page-head input. Unhead-shaped, no client runtime.
+ *
+ * Unknown keys such as `twitter.imggg` are a TypeScript error here. Use
+ * `metas` / `links` for extra tags.
+ */
+interface HeadInput {
+  site?: SiteHead;
+  title?: string;
+  titleTemplate?: string;
+  titleSuffix?: boolean;
+  description?: string;
+  canonical?: string;
+  robots?: string;
+  ogImage?: string;
+  ogType?: string;
+  twitterCard?: "summary" | "summary_large_image" | (string & {});
+  social?: boolean;
+  emitSiteName?: boolean;
+  trusted?: boolean;
+  metas?: HeadMeta[];
+  links?: HeadLink[];
+  alternates?: HeadAlternate[];
+  jsonLd?: HeadJsonLd[];
+  validation?: "off" | "warn" | "strict";
+}
+interface HeadDiagnostic {
+  strict: boolean;
+  message: string;
+}
+interface RenderedHead {
+  html: string;
+  diagnostics: HeadDiagnostic[];
+}
+/** Resolve descriptors to escaped `<head>` markup. Build-time only. */
+declare function renderHead(input: HeadInput): RenderedHead;
+declare function resolveHeadValidation(value: HeadValidationMode | undefined): false | "warn" | "strict";
+//#endregion
 //#region src/not-found.d.ts
 /**
  * Resolves `ssg.notFound` with defaults.
@@ -4737,6 +7097,26 @@ declare function buildSsg(options: ResolvedOptions, root: string): Promise<SsgBu
 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.
  *
@@ -4744,6 +7124,36 @@ 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.
+ *
+ * `false` / omitted stays off. `true` enables companions and the alternate
+ * link. An object enables the feature and overrides only the fields set.
+ */
+declare function resolveMarkdownSourceOptions(value: boolean | MarkdownSourceOptions | undefined): ResolvedMarkdownSourceOptions;
 //#endregion
 //#region src/publish-state.d.ts
 /** Split pages into production output vs listing surfaces. */
@@ -4780,19 +7190,122 @@ 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, env?: NodeJS.ProcessEnv): ResolvedRedirectsOptions;
+//#endregion
+//#region src/markdown-tables.d.ts
+interface MarkdownTableEnhancementOptions {
+  /**
+   * Tables to enhance. Defaults to Markdown content tables styled by
+   * `@ox-content/vite-plugin/styles/core.css`.
+   */
+  selector?: string;
+  /**
+   * Accessible name applied only when an overflowing table has no existing
+   * `aria-label` or `aria-labelledby`.
+   */
+  label?: string;
+}
+declare function markdownTableScrollLabel(locale?: string): string;
+/**
+ * Makes overflowing Markdown tables keyboard-scrollable without wrapping or
+ * replacing the native `<table>` element.
+ *
+ * Run this after rendering Markdown and again after layout-changing updates.
+ * Narrow tables stay out of the tab order when overflow can be measured.
  */
-declare function resolveRedirectsOptions(value: boolean | RedirectsOptions | Record<string, string> | undefined): ResolvedRedirectsOptions;
+declare function enhanceMarkdownTables(root?: ParentNode, options?: MarkdownTableEnhancementOptions): number;
 //#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;
+/**
+ * Picks a collection named `blog`, else the only configured collection.
+ *
+ * An explicit name always wins. Several collections and no `blog` name
+ * require `blog.collection`.
+ */
+declare function resolveBlogCollectionName(requested: string | undefined, collectionNames: readonly string[]): string | undefined;
+//#endregion
+//#region src/blog-feeds.d.ts
+declare class BlogFeedError extends Error {
+  readonly issues: string[];
+  constructor(issues: string[]);
+}
+//#endregion
+//#region src/blog-reading.d.ts
+/**
+ * Deterministic blog reading-time estimates.
+ */
+declare function readingTimeMinutes(markdown: string): number;
+//#endregion
+//#region src/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.
+ *
+ * `false` / omitted stays off. `true` enables the manifest and offline
+ * service worker. An object enables the feature and overrides only the
+ * fields the site set.
+ */
+declare function resolvePwaOptions(value: boolean | PwaOptions | undefined): ResolvedPwaOptions;
 //#endregion
 //#region src/taxonomies.d.ts
 /**
@@ -4810,6 +7323,17 @@ declare function resolveTaxonomiesOptions(value: boolean | TaxonomiesOptions | u
  */
 declare function resolveVersionsOptions(value: boolean | VersionsOptions | undefined): ResolvedVersionsOptions;
 //#endregion
+//#region src/resources.d.ts
+declare class PageResourceError extends Error {
+  readonly issues: string[];
+  constructor(issues: string[]);
+}
+/**
+ * Resolves `resources`. Omitted / `false` stay off. `true` or `{}` enables
+ * defaults. An object enables the feature and overrides only set fields.
+ */
+declare function resolveResourcesOptions(value: boolean | ResourcesOptions | undefined): ResolvedResourcesOptions;
+//#endregion
 //#region src/team.d.ts
 /**
  * Resolves `ssg.team` with defaults.
@@ -4819,6 +7343,15 @@ declare function resolveVersionsOptions(value: boolean | VersionsOptions | undef
  */
 declare function resolveTeamOptions(value: boolean | TeamOptions | undefined): ResolvedTeamOptions;
 //#endregion
+//#region src/section-index.d.ts
+/**
+ * Resolves `ssg.sectionIndex` with defaults.
+ *
+ * `false` / omitted stays off. `true` enables card listings. An object
+ * enables the feature and overrides only the fields the site set.
+ */
+declare function resolveSectionIndexOptions(value: boolean | SectionIndexOptions | undefined): ResolvedSectionIndexOptions;
+//#endregion
 //#region src/search.d.ts
 /**
  * Resolves search options with defaults.
@@ -4831,7 +7364,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.
  */
@@ -4844,12 +7377,6 @@ declare function resolveCollectionsOptions(options: CollectionsOptions | boolean
 declare function buildCollectionManifest(root: string, options: ResolvedOptions): Promise<CollectionManifest>;
 declare function generateCollectionsVirtualModule(root: string, options: ResolvedOptions): Promise<string>;
 //#endregion
-//#region src/markdown.d.ts
-declare const DEFAULT_MARKDOWN_EXTENSIONS: readonly [".md", ".markdown", ".mdx"];
-declare function normalizeMarkdownExtensions(extensions?: readonly string[]): string[];
-declare function isMarkdownFilePath(filePath: string, extensions?: readonly string[]): boolean;
-declare function stripMarkdownExtension(filePath: string, extensions?: readonly string[]): string;
-//#endregion
 //#region src/vitepress.d.ts
 interface VitePressLogo {
   light?: string;
@@ -4982,7 +7509,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.
@@ -5005,10 +7532,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`
@@ -5046,17 +7629,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
@@ -5077,9 +7669,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.
@@ -5101,7 +7690,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.
@@ -5118,6 +7707,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.
@@ -5139,13 +7837,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, BuiltinEmbedOptions, BuiltinPmOptions, CardOptions, CascadeOptions, CodeAnnotationKind, CodeAnnotationSyntax, CodeAnnotationsOptions, type CodeBlockDiagnostic, CodeBlockLintOptions, CodeBlockTypecheckOptions, CodeImportOptions, type CollectedDocsTest, CollectionEntry, CollectionIncludeField, CollectionManifest, CollectionOptions, CollectionQueryBuilder, CollectionQueryOperator, CollectionsOptions, ContainerOptions, ContainerTypeOptions, DEFAULT_HTML_TEMPLATE, DEFAULT_MARKDOWN_EXTENSIONS, DefaultTheme, DocEntry, DocMember, DocsEntryPoint, DocsOptions, DocsSortStrategy, DocsSummary, type DocsTestFileOptions, type DocsTestHarnessOptions, DocsTestOptions, DocsTestRunError, type DocsTestRunResult, type DocsTestSource, type DocsTestWriteResult, EditThisPageOptions, EmojiShortcodeOptions, EntryPageConfig, type ExtractedCodeBlock, ExtractedDocs, FeatureConfig, FeedFormat, FeedsOptions, 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 GitHubSourceData, type GitHubSourceRef, type HeaderNavItem, 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, type LoadStrategy, LocaleConfig, type LocaleLabel, type MarkdownChunkSource, MarkdownDisplayFormat, type MarkdownLintFileDiagnostic as MarkdownLintBatchDiagnostic, type MarkdownLintFileDiagnostic, type MarkdownLintDiagnostic, type MarkdownLintDictionaryOptions, type MarkdownLintFileOptions, type MarkdownLintFileOptions as MarkdownLintProjectOptions, type MarkdownLintFileResult, type MarkdownLintFilesResult, type MarkdownLintLanguage, type MarkdownLintOptions, type MarkdownLintResult, type MarkdownLintRuleOptions, type MarkdownLintSeverity, type MarkdownLintStandardDictionaryOptions, MarkdownNode, MarkdownTransformer, MathOptions, 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, ParamDoc, type ParseIslandsResult, PermalinksOptions, PublishStateOptions, ReaderChromeOptions, RedirectsOptions, type RenderContext, ResolvedA11y, ResolvedAttrsOptions, ResolvedBadgeOptions, ResolvedBuiltinEmbedOptions, ResolvedCardOptions, ResolvedCascadeOptions, ResolvedCodeAnnotationsOptions, ResolvedCodeBlockLintOptions, ResolvedCodeBlockTypecheckOptions, ResolvedCodeImportOptions, ResolvedCollectionOptions, ResolvedCollectionsOptions, ResolvedContainerOptions, ResolvedDocsEntryPoint, ResolvedDocsOptions, ResolvedDocsTestOptions, ResolvedEditThisPageOptions, ResolvedEmojiShortcodeOptions, ResolvedFeedsOptions, ResolvedFileTreeOptions, ResolvedI18nOptions, ResolvedImageOptions, ResolvedIncludeOptions, ResolvedMathOptions, ResolvedNotFoundOptions, ResolvedOgImageOptions, ResolvedOptions, ResolvedPermalinksOptions, ResolvedPublishStateOptions, ResolvedReaderChrome, ResolvedRedirectsOptions, ResolvedSanitizeOptions, ResolvedSearchOptions, ResolvedSiteMapsOptions, ResolvedSsgOptions, ResolvedStepsOptions, ResolvedTaxonomiesOptions, ResolvedTeamOptions, type ResolvedThemeConfig, ResolvedVersionEntry, ResolvedVersionsOptions, ResolvedWikiLinkOptions, ReturnDoc, type RunDocsTestsOptions, SanitizeOptions, ScopedSearchQuery, SearchDocument, SearchOptions, SearchResult, type SidebarItem, type SiteConfig, 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, VersionBannerKind, VersionEntry, VersionsOptions, type VitePressConfig, type VitePressFooter, type VitePressLogo, type VitePressNavItem, type VitePressSidebar, type VitePressSidebarItem, type VitePressSocialLink, type VitePressThemeConfig, WikiLinkOptions, type WrittenDocsTestFile, type YouTubeOptions, buildCollectionManifest, buildSearchIndex, buildSsg, classifyPublishState, clearRenderContext, collectDocsTests, collectGitHubRepos, collectGitHubSources, collectOgpUrls, convertVitePressNav, convertVitePressSidebar, createFrameworkMarkdownOptions, createI18nPlugin, createIncrementalMarkdownParser, createIncrementalMarkdownRenderer, createMarkdownEnvironment, createTheme, defaultTheme, defineCollection, defineCollections, defineTheme, each, escapeSvelteMarkup, extractCodeBlocks, extractDocs, extractDocsTests, extractIslandInfo, extractVideoId, fetchGitHubSource, fetchOgpData, fetchRepoData, fromVitePressConfig, generateCollectionsVirtualModule, generateFrontmatterTypes, generateHydrationScript, generateMarkdown, generateOgImages, generateTabsCSS, generateTypes, generateVirtualModule, generateVitePressMigrationConfig, hasIslands, inferType, isMarkdownFilePath, jsx, jsxs, lintCodeBlocks, lintMarkdown, lintMarkdownAsync, lintMarkdownFile, lintMarkdownFiles, mergeThemes, mermaidClientScript, normalizeMarkdownExtensions, normalizeVitePressFrontmatter, oxContent, parseGitHubLineRange, parseGitHubPermalink, parsePageChromeFlags, partitionPublishedPages, prefetchGitHubRepos, prefetchGitHubSources, prefetchOgpData, raw, renderAllPages, renderHtmlToFrameworkCode, renderHtmlToReactComponent, renderHtmlToReactCreateElement, renderHtmlToSvelteComponent, renderHtmlToVueComponent, renderHtmlToVueH, renderMarkdownStream, renderPage, renderToString, resolveBadgeOptions, resolveBuiltinEmbedOptions, resolveCardOptions, resolveCascadeOptions, resolveCollectionsOptions, resolveDocsOptions, resolveFeedsOptions, resolveFileTreeOptions, resolveHeaderNavItems, resolveI18nOptions, resolveImageOptions, resolveIncludeOptions, resolveLocaleLabel, resolveMathOptions, resolveNotFoundOptions, resolveOgImageOptions, resolvePageChromeOption, resolvePermalinksOptions, resolvePublishStateOptions, resolveRedirectsOptions, resolveSearchOptions, resolveSiteMapsOptions, resolveSsgOptions, resolveStepsOptions, resolveTaxonomiesOptions, resolveTeamOptions, resolveTheme, resolveVersionsOptions, runDocsTests, setRenderContext, shouldLintMarkdownFile, stripMarkdownExtension, transformAllPlugins, transformGitHub, transformIslands, transformMarkdown, transformMermaidStatic, transformOgp, transformTabs, transformYouTube, typecheckCodeBlocks, useIsActive, useNav, usePageProps, useRenderContext, useSiteConfig, when, writeDocs, writeDocsTestFiles, writeSearchIndex };
+export { A11yOptions, AbbreviationsOptions, AttrsOptions, BadgeOptions, type BasePageProps, 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, 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, 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, MathOptions, MdxImport, MdxImportSpecifier, MdxImportSpecifierKind, type MermaidOptions, type NavGroup, NavItem, NotByAiOptions, NotFoundOptions, type OgBrowserSession, OgImageOptions, type OgImagePageEntry, type OgImageOptions$1 as OgImagePluginOptions, OgImageRenderer, type OgImageResult, OgImageSatoriFont, OgImageSatoriFontWeight, OgImageSatoriOptions, type OgImageTemplateFn, type OgImageTemplateProps, type OgpData, type OgpOptions, OpenApiDocsInput, OpenApiDocsOptions, OpenApiDocsSource, OxContentOptions, type PageChromeFlags, type PageData, type PageProps, PageResourceError, ParamDoc, type ParseIslandsResult, PartialsOptions, PermalinksOptions, type PlanSsgOutputsInput, type PlanSsgOutputsOptions, PublishStateOptions, PwaOptions, ReaderChromeOptions, type RedditEmbedOptions, type RedditPostData, type RedditPostReference, RedirectProvider, RedirectsOptions, type RenderContext, type RenderFeedFilesInput, type RenderFeedFilesResult, type RenderIslandComponentImportsInput, type RenderIslandFn, 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, ResolvedReaderChrome, ResolvedRedirectsOptions, ResolvedResourcesOptions, ResolvedSanitizeOptions, ResolvedSearchOptions, ResolvedSectionIndexOptions, ResolvedSiteMapsOptions, ResolvedSsgOptions, ResolvedStepsOptions, ResolvedTaxonomiesOptions, ResolvedTeamOptions, type ResolvedThemeConfig, ResolvedTimelineOptions, ResolvedTypedHoverOptions, ResolvedVersionEntry, ResolvedVersionsOptions, ResolvedWikiLinkOptions, ResourcesOptions, ReturnDoc, type RunDocsTestsOptions, SanitizeOptions, ScopedSearchQuery, SearchDocument, SearchOptions, SearchResult, SectionIndexOptions, SectionIndexStyle, type SidebarItem, type SiteConfig, type SiteHead, SiteMapsOptions, type SocialLinks, SsgNavigationGroup, SsgNavigationItem, SsgOptions, SsgOutputPageInput, type SsgOutputPlan, StepsOptions, TaxonomiesOptions, TeamLink, TeamMember, TeamOptions, type ThemeAnnouncement, type ThemeColors, type ThemeComponent, type ThemeConfig, type ThemeEmbed, type ThemeEntryPage, type ThemeFontValue, type ThemeFonts, type ThemeFooter, type ThemeHeader, type ThemeLayout, type ThemeProps, type ThemeRenderOptions, type ThemeTokens, type ThemeWebFont, ThrowsDoc, TimelineOptions, TocEntry, type TransformAllOptions, TransformContext, TransformResult, type TwitterEmbedOptions, type TypecheckCodeBlockOptions, TypedHoverOptions, VersionBannerKind, VersionEntry, VersionsOptions, type VitePressConfig, type VitePressFooter, type VitePressLogo, type VitePressNavItem, type VitePressSidebar, type VitePressSidebarItem, type VitePressSocialLink, type VitePressThemeConfig, WikiLinkOptions, type WriteFeedFilesInput, type WriteResourceFilesInput, type WriteResourceFilesPage, type WriteResourceFilesResult, type WrittenDocsTestFile, type YouTubeOptions, applyIslandSsrHtml, 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, readingTimeMinutes, renderAllPages, renderFeedFiles, renderHead, renderHtmlToFrameworkCode, renderHtmlToReactComponent, renderHtmlToReactCreateElement, renderHtmlToSvelteComponent, renderHtmlToVueComponent, renderHtmlToVueH, renderIslandComponentImports, renderMarkdown, renderMarkdownStream, renderPage, 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, resolveRedirectsOptions, resolveResourcesOptions, resolveSearchOptions, resolveSectionIndexOptions, resolveSiteMapsOptions, resolveSsgOptions, resolveStepsOptions, resolveTaxonomiesOptions, resolveTeamOptions, resolveTheme, resolveTimelineOptions, resolveTypedHoverOptions, resolveVersionsOptions, runDocsTests, setRenderContext, shouldLintMarkdownFile, stripMarkdownExtension, stripViteQuery, 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.mts.map