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

package/dist/index.d.mts

@@ -1,6 +1,53 @@
 import { a as JSXProps, c as jsxs, d as when, i as JSXNode, l as raw, n as JSXChild, o as each, r as JSXElementType, s as jsx, t as Fragment, u as renderToString } from "./jsx-html.mjs";
-import { LanguageRegistration, LanguageRegistration as LanguageRegistration$1, ThemeRegistration, ThemeRegistration as ThemeRegistration$1 } from "shiki";
 import { EnvironmentOptions, Plugin } from "vite";
+//#region src/header-chrome.d.ts
+/**
+ * Opt-in header nav, announcement, and per-page chrome helpers.
+ */
+/** Plain label or locale map (`{ en: "Guide", ja: "ガイド" }`). */
+type LocaleLabel = string | Record<string, string>;
+/** Header nav link or dropdown. */
+interface HeaderNavItem {
+  text: LocaleLabel;
+  link?: string;
+  items?: HeaderNavItem[];
+}
+/** Announcement bar. Text is escaped; no raw HTML slot. */
+interface ThemeAnnouncement {
+  text: string;
+  /** https or same-origin only. */
+  link?: string;
+  /** Best-effort localStorage key for dismiss. */
+  dismissKey?: string;
+}
+/** Per-page frontmatter chrome flags. `false` hides that region. */
+interface PageChromeFlags {
+  sidebar?: boolean;
+  outline?: boolean;
+  aside?: boolean;
+  footer?: boolean;
+  navbar?: boolean;
+  lastUpdated?: boolean;
+  editLink?: boolean;
+}
+/** `false` or omitted stays off. `true` or `{}` enables default flag reading. */
+declare function resolvePageChromeOption(value: boolean | Record<string, unknown> | undefined): boolean;
+/** Reads hide flags from frontmatter. Non-boolean values are ignored. */
+declare function parsePageChromeFlags(frontmatter: Record<string, unknown>): PageChromeFlags;
+/**
+ * Picks the exact locale, its language, the default locale, then the first
+ * non-empty own string in declaration order.
+ */
+declare function resolveLocaleLabel(text: LocaleLabel, locale?: string, defaultLocale?: string): string;
+/** Nav item after locale maps are flattened to strings. */
+interface ResolvedHeaderNavItem {
+  text: string;
+  link?: string;
+  items?: ResolvedHeaderNavItem[];
+}
+/** Resolves locale maps so NAPI always receives string labels. */
+declare function resolveHeaderNavItems(items: HeaderNavItem[] | undefined, locale?: string, defaultLocale?: string): ResolvedHeaderNavItem[] | undefined;
+//#endregion
 //#region src/theme-tokens.d.ts
 /**
  * Free-form `--octc-*` custom properties for themes that need more than the
@@ -137,8 +184,10 @@ interface ThemeEmbed {
   /** Custom footer content (replaces default footer) */
   footer?: string;
 }
+/** Sidebar group or link, including recursively nested localized labels. */
 interface SidebarItem {
-  text?: string;
+  /** Plain label or locale map (`{ en: "Guide", ja: "ガイド" }`). */
+  text?: LocaleLabel;
   link?: string;
   items?: SidebarItem[];
   collapsed?: boolean;
@@ -152,6 +201,30 @@ interface ThemeConfig {
   name?: string;
   /** Base theme to extend */
   extends?: ThemeConfig;
+  /**
+   * Preserve the current surface during same-origin MPA navigation with the
+   * browser's cross-document View Transition API.
+   *
+   * Unsupported browsers use normal navigation. Reduced-motion preferences
+   * never enable the transition. Set `false` to opt out.
+   *
+   * @default true
+   */
+  viewTransitions?: boolean;
+  /**
+   * Show the right-hand "On this page" outline.
+   *
+   * Default `false`. When `true`, the outline is rendered only on pages
+   * that have TOC entries, using the existing `<aside class="toc">` markup.
+   */
+  aside?: boolean;
+  /**
+   * Show a breadcrumb trail from the site root through sidebar ancestors.
+   *
+   * Default `false`. `true` or an object enables the trail. Frontmatter
+   * `breadcrumbs: false` still hides it on that page.
+   */
+  breadcrumbs?: boolean | Record<string, unknown>;
   /** Light mode colors (maps to CSS variables) */
   colors?: ThemeColors;
   /** Dark mode colors (maps to CSS variables) */
@@ -164,6 +237,17 @@ interface ThemeConfig {
   layout?: ThemeLayout;
   /** Header configuration */
   header?: ThemeHeader;
+  /**
+   * Opt-in header nav. Each item is `{ text, link }` or a dropdown
+   * `{ text, items }`. Labels are escaped. `javascript:`, `data:`,
+   * `vbscript:`, and protocol-relative `//` links are omitted.
+   */
+  nav?: HeaderNavItem[];
+  /**
+   * Opt-in announcement bar above the header. Text is escaped.
+   * Optional `link` must be https or same-origin.
+   */
+  announcement?: ThemeAnnouncement;
   /** Footer configuration */
   footer?: ThemeFooter;
   /** Social links configuration */
@@ -192,12 +276,17 @@ interface ThemeConfig {
  */
 interface ResolvedThemeConfig {
   name: string;
+  viewTransitions: boolean;
+  aside: boolean;
+  breadcrumbs: boolean;
   colors: ThemeColors;
   darkColors: ThemeColors;
   fonts: ThemeFonts;
   entryPage: ThemeEntryPage;
   layout: ThemeLayout;
   header: ThemeHeader;
+  nav?: HeaderNavItem[];
+  announcement?: ThemeAnnouncement;
   footer: ThemeFooter;
   socialLinks: SocialLinks;
   sidebar: SidebarItem[];
@@ -282,6 +371,11 @@ interface GitHubSourceRef {
   permalink: string;
   lines?: GitHubLineRange;
 }
+interface GitHubSourceCommit {
+  sha: string;
+  message: string;
+  html_url: string;
+}
 interface GitHubSourceData {
   repo: string;
   ref: string;
@@ -291,6 +385,7 @@ interface GitHubSourceData {
   size: number;
   html_url: string;
   language: string | null;
+  commit?: GitHubSourceCommit;
 }
 interface GitHubOptions {
   /**
@@ -583,6 +678,11 @@ 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 */
@@ -783,6 +883,11 @@ 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 */
@@ -1098,6 +1203,129 @@ interface SsgOptions {
    * @default false
    */
   lastUpdated?: boolean;
+  /**
+   * List unique git authors for each page.
+   *
+   * Off by default. `true` enables names only. An object enables the
+   * feature and can set `ignore` and `avatars`. Missing `.git` (for
+   * example a published tarball) yields an empty list and does not
+   * fail the build.
+   *
+   * @default false
+   */
+  contributors?: boolean | ContributorsOptions;
+  /**
+   * Show previous/next page links after the article.
+   *
+   * Disabled when omitted or `false`. `true` enables the default pager.
+   * An object also enables the feature.
+   *
+   * @default false
+   */
+  pagination?: boolean | Record<string, unknown>;
+  /**
+   * Show a breadcrumb trail from the site root through sidebar ancestors.
+   *
+   * Disabled when omitted or `false`. `true` enables the default trail.
+   * An object also enables the feature. Frontmatter `breadcrumbs: false`
+   * hides the trail on that page.
+   *
+   * @default false
+   */
+  breadcrumbs?: boolean | Record<string, unknown>;
+  /**
+   * Emit JSON-LD structured data (`TechArticle`, `WebSite`, and optional
+   * `BreadcrumbList`) in the page `<head>`.
+   *
+   * Disabled when omitted or `false`. `true` enables the defaults. An object
+   * enables the feature and can hide BreadcrumbList or supply a publisher.
+   * Publisher fields the site does not set are not invented.
+   *
+   * @default false
+   */
+  jsonLd?: boolean | JsonLdOptions;
+  /**
+   * Opt-in copy buttons, outbound-link icons, and a back-to-top control.
+   *
+   * Disabled when omitted or `false`. `true` enables all three with defaults.
+   * An object enables the feature and can turn one control off, for example
+   * `{ copy: false }`.
+   *
+   * @default false
+   */
+  readerChrome?: boolean | ReaderChromeOptions;
+  /**
+   * Show a header locale switcher in the default theme.
+   *
+   * Disabled when omitted or `false`, even if `i18n.locales` is set.
+   * `true` or an object enables the control when available locales are
+   * non-empty. Links use the sibling page when it exists, otherwise the
+   * locale root (`/{locale}/` or a configured root).
+   *
+   * @default false
+   */
+  localeSwitcher?: boolean | Record<string, unknown>;
+  /**
+   * Opt-in skip link and print styles.
+   *
+   * Disabled when omitted or `false`. `true` enables the default skip link
+   * and print CSS. An object enables the feature and can override the label.
+   *
+   * @default false
+   */
+  a11y?: boolean | A11yOptions;
+  /**
+   * Honor per-page frontmatter chrome flags (`sidebar`, `outline` / `aside`,
+   * `footer`, `navbar`, `lastUpdated`, `editLink`).
+   *
+   * Disabled when omitted or `false`. `true` or `{}` enables the defaults:
+   * omitted flags keep current chrome, and `false` hides that region.
+   *
+   * @default false
+   */
+  pageChrome?: boolean | Record<string, unknown>;
+  /**
+   * Write a themed 404 page during SSG.
+   *
+   * Off by default. `true` reads `404.md` from `srcDir` and writes `404.html`.
+   * An object enables the feature and overrides only the fields you set.
+   * When the source file is missing, a built-in "Page not found" page is
+   * written instead. The page is omitted from the search index and sitemap.
+   *
+   * @default false
+   */
+  notFound?: boolean | NotFoundOptions;
+  /**
+   * Render a static members card grid on pages with `layout: team`.
+   *
+   * Off by default. `true` enables an empty list. An object enables the
+   * feature and supplies `members`. When the option is off, `layout: team`
+   * is ignored and the page stays ordinary.
+   *
+   * @default false
+   */
+  team?: boolean | TeamOptions;
+  /**
+   * Opt-in blog index, authors, tags, reading time, and archive.
+   *
+   * Off by default. `true` enables defaults. An object enables the feature
+   * and overrides only the fields you set. Top-level `blog` wins when both
+   * are set.
+   *
+   * @default false
+   */
+  blog?: boolean | BlogOptions;
+  /**
+   * Generate a static index for directories that have child pages but no
+   * `index.md` / `index.mdx`.
+   *
+   * Off by default. `true` enables card listings. An object enables the
+   * feature and can switch the listing to `list`. Existing content indexes
+   * are never overwritten.
+   *
+   * @default false
+   */
+  sectionIndex?: boolean | SectionIndexOptions;
   /**
    * Absolute site URL used when generating social metadata.
    *
@@ -1139,6 +1367,97 @@ interface SsgOptions {
    */
   navigation?: SsgNavigationGroup[];
 }
+/**
+ * Per-control flags for `ssg.readerChrome`.
+ *
+ * Omitted fields stay on when the feature itself is enabled.
+ */
+interface ReaderChromeOptions {
+  /**
+   * Copy button on fenced code blocks. The clipboard is read in the browser,
+   * never at build time.
+   *
+   * @default true
+   */
+  copy?: boolean;
+  /**
+   * Icon and `rel="noopener noreferrer"` on outbound `http(s)` links.
+   * Relative, hash, and same-document links are left alone.
+   *
+   * @default true
+   */
+  externalLinks?: boolean;
+  /**
+   * Back-to-top control that appears after the page is scrolled.
+   *
+   * @default true
+   */
+  backToTop?: boolean;
+}
+/**
+ * Resolved reader chrome. `false` means no extra markup or JS.
+ */
+type ResolvedReaderChrome = false | {
+  copy: boolean;
+  externalLinks: boolean;
+  backToTop: boolean;
+};
+/**
+ * Per-control flags for `ssg.a11y`.
+ *
+ * Omitted fields keep the defaults when the feature itself is enabled.
+ */
+interface A11yOptions {
+  /**
+   * Visible label for the skip link. Escaped in HTML.
+   *
+   * @default "Skip to content"
+   */
+  skipLinkLabel?: string;
+}
+/**
+ * Resolved skip-link / print styles. `false` means no extra markup or CSS.
+ */
+type ResolvedA11y = false | {
+  skipLinkLabel: string;
+};
+/**
+ * Per-control flags for `ssg.jsonLd`.
+ *
+ * Omitted fields keep the defaults when the feature itself is enabled.
+ */
+interface JsonLdOptions {
+  /**
+   * Emit `BreadcrumbList` when a visible breadcrumb trail exists.
+   *
+   * @default true
+   */
+  breadcrumbs?: boolean;
+  /**
+   * Optional publisher. Only configured `name` / `url` are written.
+   * Logo and other Organization fields are never invented.
+   */
+  publisher?: JsonLdPublisherOptions;
+}
+/**
+ * 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;
+  };
+};
 /**
  * Resolved SSG options.
  */
@@ -1156,123 +1475,711 @@ 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;
+  readerChrome: ResolvedReaderChrome;
+  localeSwitcher: boolean;
+  a11y: ResolvedA11y;
+  pageChrome: boolean;
+  /**
+   * Present after `resolveSsgOptions`. Omitted in hand-built fixtures means off.
+   */
+  notFound?: ResolvedNotFoundOptions;
+  /**
+   * 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[];
 }
 /**
- * Options for the core `oxContent()` Vite plugin.
- *
- * The top-level options describe where content lives, which Markdown features
- * are enabled, and which build-time features should run. Feature toggles that
- * accept `boolean | Options` follow the same convention:
- *
- * - `false` disables the feature.
- * - `true` enables the feature with its documented defaults.
- * - an object enables the feature and overrides only the provided fields.
+ * Opt-in custom 404 page written during SSG.
  */
-interface OxContentOptions {
+interface NotFoundOptions {
   /**
-   * Directory containing Markdown source files.
-   *
-   * The path is resolved from the Vite project root. SSG, search indexing, and
-   * dev-server routing all use this directory as the content root.
-   *
-   * @default 'content'
+   * Markdown source relative to `srcDir`.
+   * @default "404.md"
    */
-  srcDir?: string;
+  source?: string;
   /**
-   * Directory where generated files are written.
-   *
-   * SSG HTML, search indexes, and generated assets are emitted under this
-   * directory during production builds.
-   *
-   * @default 'dist'
+   * Output file relative to `outDir`.
+   * @default "404.html"
    */
-  outDir?: string;
+  output?: string;
+}
+/**
+ * Resolved custom 404 options.
+ */
+interface ResolvedNotFoundOptions {
+  enabled: boolean;
+  source: string;
+  output: string;
+}
+/**
+ * One link on a team member card.
+ */
+interface TeamLink {
+  /** Visible label. Escaped in HTML. */
+  label: string;
+  /** Destination. Only `https:` or a site-relative `/` path is emitted. */
+  href: string;
+}
+/**
+ * One person on the team page.
+ */
+interface TeamMember {
+  /** Display name. Escaped in HTML. */
+  name: string;
+  /** Optional role or title. Escaped in HTML. */
+  role?: string;
+  /** Avatar URL. Only `https:` or a site-relative `/` path is emitted. */
+  avatar?: string;
+  /** Optional profile or social links. */
+  links?: TeamLink[];
+}
+/**
+ * Opt-in team / members page.
+ */
+/**
+ * Opt-in git contributor list.
+ */
+interface ContributorsOptions {
   /**
-   * Base path prepended to generated internal URLs.
-   *
-   * Use this when the site is deployed below a sub-path, such as GitHub Pages or
-   * a documentation route inside a larger application.
-   *
-   * @default '/'
+   * Author names or emails to omit. Comparison is case-insensitive and
+   * matches the full name or the full email.
    */
-  base?: string;
+  ignore?: string[];
   /**
-   * Markdown-like file extensions to process.
-   *
-   * Extensions are normalized with a leading dot and matched case-insensitively.
-   * Add custom extensions when another authoring format is compiled to Markdown
-   * before ox-content sees it.
-   *
-   * @default ['.md', '.markdown', '.mdx']
+   * 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.
    */
-  extensions?: string[];
+  avatars?: boolean;
+}
+/**
+ * Resolved git contributor list. `false` means the feature is off.
+ */
+type ResolvedContributors = false | {
+  ignore: string[];
+  avatars: boolean;
+};
+interface TeamOptions {
   /**
-   * Static Site Generation options.
-   *
-   * Passing `true` or omitting this option enables SSG with defaults. Passing
-   * `false` disables the SSG plugin while still allowing Markdown module
-   * transforms to run.
-   *
-   * @default { enabled: true }
+   * People rendered as static cards on `layout: team` pages.
+   * @default []
    */
-  ssg?: SsgOptions | boolean;
+  members?: TeamMember[];
+}
+/**
+ * Resolved team page options.
+ */
+interface ResolvedTeamOptions {
+  enabled: boolean;
+  members: TeamMember[];
+}
+/**
+ * Listing style for a generated section index.
+ */
+type SectionIndexStyle = "list" | "cards";
+/**
+ * Opt-in generated section index pages.
+ */
+interface SectionIndexOptions {
   /**
-   * Enable GitHub Flavored Markdown extensions.
-   * @default true
+   * How children are rendered. `cards` is the default when the feature is on.
+   * @default "cards"
    */
-  gfm?: boolean;
+  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 {
   /**
-   * Enable footnotes.
+   * Write `sw.js` and register it from themed pages.
    * @default true
    */
-  footnotes?: boolean;
+  offline?: boolean;
   /**
-   * Enable tables.
-   * @default true
+   * Manifest `name`. Falls back to `ssg.siteName` when omitted.
    */
-  tables?: boolean;
+  name?: string;
   /**
-   * Enable task lists.
-   * @default true
+   * Manifest `short_name`. Falls back to `name` when omitted.
    */
-  taskLists?: boolean;
+  shortName?: string;
   /**
-   * Enable strikethrough.
-   * @default true
+   * Manifest / meta theme color. Hex (`#rgb` / `#rrggbb`) or a CSS color name.
+   * @default "#000000"
    */
-  strikethrough?: boolean;
+  themeColor?: string;
   /**
-   * Enable GFM autolinks and linkify bare URLs.
-   * @default true
+   * Manifest background color. Hex or a CSS color name.
+   * @default "#ffffff"
    */
-  autolinks?: boolean;
+  backgroundColor?: string;
   /**
-   * Enable syntax highlighting for code blocks.
+   * 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 crawl manifests written during SSG.
+ */
+interface SiteMapsOptions {
+  /**
+   * Write `robots.txt` with a Sitemap line.
+   * @default true
+   */
+  robots?: boolean;
+  /**
+   * Write `llms.txt` with the site title, description, and page URLs.
+   * @default true
+   */
+  llms?: boolean;
+}
+/**
+ * Resolved crawl-manifest options.
+ */
+interface ResolvedSiteMapsOptions {
+  enabled: boolean;
+  robots: boolean;
+  llms: boolean;
+}
+/**
+ * Opt-in draft / unlisted / scheduled page filtering.
+ */
+interface PublishStateOptions {
+  /**
+   * When `false`, frontmatter publish fields are ignored.
+   * @default true when the option is an object
+   */
+  enabled?: boolean;
+  /**
+   * Injected ISO-8601 clock compared against `scheduled`, `date`, and `expiry`.
+   * Invalid values fall back to the system clock.
+   */
+  now?: string;
+  /**
+   * Keep draft and not-yet-scheduled pages in output. The dev server sets this.
    * @default false
    */
-  highlight?: boolean;
+  includeDrafts?: boolean;
+}
+/**
+ * Resolved publish-state options.
+ */
+interface ResolvedPublishStateOptions {
+  enabled: boolean;
+  now?: string;
+  includeDrafts: boolean;
+}
+/**
+ * Opt-in frontmatter `permalink` / `slug` routing.
+ *
+ * `false` or omitted stays off. `true` or `{}` enables defaults.
+ * Set `enabled: false` on the object to turn the feature back off.
+ */
+interface PermalinksOptions {
+  /**
+   * Enable permalink / slug routing.
+   * @default true
+   */
+  enabled?: boolean;
+}
+/**
+ * Resolved permalink options.
+ */
+interface ResolvedPermalinksOptions {
+  enabled: boolean;
+}
+/**
+ * Opt-in `_index` directory frontmatter cascade.
+ *
+ * `false` or omitted stays off. `true` or `{}` enables defaults.
+ * Set `enabled: false` on the object to turn the feature back off.
+ */
+interface CascadeOptions {
+  /**
+   * Enable directory-level frontmatter inheritance.
+   * @default true
+   */
+  enabled?: boolean;
+}
+/**
+ * Resolved cascade options.
+ */
+interface ResolvedCascadeOptions {
+  enabled: boolean;
+}
+/**
+ * Opt-in static redirects, aliases, and path rewrites.
+ *
+ * A path map such as `{ "/old-guide": "/guide" }` is also accepted in place
+ * of this object and enables the feature with that map.
+ */
+interface RedirectsOptions {
+  /**
+   * Old path to new path. Destinations must be same-origin (`/` but not `//`)
+   * unless `allowExternal` is set.
+   * @default {}
+   */
+  map?: Record<string, string>;
+  /**
+   * Write a Netlify / Cloudflare `_redirects` file next to the HTML pages.
+   * @default false
+   */
+  netlify?: boolean;
+  /**
+   * Write a `_headers` Location map next to the HTML pages.
+   * @default false
+   */
+  headers?: boolean;
+  /**
+   * Write a machine-readable `redirects.json` map.
+   * @default false
+   */
+  json?: boolean;
+  /**
+   * Allow `http://` and `https://` destinations. `javascript:`, `data:`, and
+   * protocol-relative `//` targets stay rejected.
+   * @default false
+   */
+  allowExternal?: boolean;
+}
+/**
+ * Resolved redirect options.
+ */
+interface ResolvedRedirectsOptions {
+  enabled: boolean;
+  map: Record<string, string>;
+  netlify: boolean;
+  headers: boolean;
+  json: boolean;
+  allowExternal: boolean;
+}
+/**
+ * Feed file formats written during SSG.
+ */
+type FeedFormat = "rss" | "atom" | "json";
+/**
+ * Opt-in RSS / Atom / JSON Feed files written during SSG.
+ */
+interface FeedsOptions {
+  /**
+   * Feed formats to write.
+   * @default ["rss", "atom", "json"]
+   */
+  formats?: FeedFormat[];
+  /**
+   * Named collection to publish. Defaults to `content`, or the first
+   * configured collection when `content` is absent.
+   */
+  collection?: string;
+  /**
+   * Maximum number of published items, newest first.
+   * @default 20
+   */
+  limit?: number;
+  /**
+   * Site-relative directory for the generated files.
+   * @default "/"
+   */
+  path?: string;
+}
+/**
+ * Resolved feed options.
+ */
+interface ResolvedFeedsOptions {
+  enabled: boolean;
+  formats: FeedFormat[];
+  collection?: string;
+  limit: number;
+  path: string;
+}
+/**
+ * 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;
+}
+/**
+ * Resolved blog options.
+ */
+interface ResolvedBlogOptions {
+  enabled: boolean;
+  collection?: string;
+  authors: Record<string, BlogAuthor>;
+  pageSize: number;
+}
+/**
+ * Opt-in term list pages, per-term pages, and related-page lists.
+ */
+interface TaxonomiesOptions {
+  /**
+   * Frontmatter keys (and URL prefixes) to read terms from.
+   * @default ["tags", "categories"]
+   */
+  taxonomies?: string[];
   /**
-   * Syntax highlighting theme.
+   * Maximum related pages injected into a source page.
+   * @default 5
+   */
+  relatedLimit?: number;
+}
+/**
+ * Resolved taxonomy options.
+ */
+interface ResolvedTaxonomiesOptions {
+  enabled: boolean;
+  taxonomies: string[];
+  relatedLimit: number;
+}
+/** Banner shown on pages that belong to one documented version. */
+type VersionBannerKind = "unreleased" | "unmaintained";
+/**
+ * One published or snapshot version of a docs tree.
+ */
+interface VersionEntry {
+  /** Stable id used as `versions.current`. */
+  id: string;
+  /** Header label. Escaped before it is rendered. */
+  label: string;
+  /**
+   * URL prefix without slashes (`"2.90"`, `"next"`). Empty string is the
+   * site root.
+   */
+  prefix: string;
+  /**
+   * Snapshot directory relative to the Vite root. Omitted entries use the
+   * live `srcDir` and are not copied. Historical dirs are read-only.
+   */
+  dir?: string;
+  /** Optional status banner for pages in this version. */
+  banner?: VersionBannerKind | false;
+}
+/**
+ * Opt-in documentation versioning.
+ *
+ * Off by default. `true` enables a single current entry. An object enables
+ * the feature and overrides only the fields you set.
+ */
+interface VersionsOptions {
+  /** Id of the live tree being built from `srcDir`. */
+  current?: string;
+  /** Render the header version dropdown. @default true */
+  switcher?: boolean;
+  /** Show unreleased / unmaintained badges in the dropdown. @default true */
+  badge?: boolean;
+  /** Declared versions. Historical snapshots must set `dir`. */
+  entries?: VersionEntry[];
+}
+/**
+ * Resolved documentation versioning.
+ */
+interface ResolvedVersionsOptions {
+  enabled: boolean;
+  current: string;
+  switcher: boolean;
+  badge: boolean;
+  entries: ResolvedVersionEntry[];
+}
+/**
+ * One resolved version after prefix and banner sanitization.
+ */
+interface ResolvedVersionEntry {
+  id: string;
+  label: string;
+  prefix: string;
+  dir?: string;
+  banner: VersionBannerKind | false;
+}
+/**
+ * Options for the core `oxContent()` Vite plugin.
+ *
+ * The top-level options describe where content lives, which Markdown features
+ * are enabled, and which build-time features should run. Feature toggles that
+ * accept `boolean | Options` follow the same convention:
+ *
+ * - `false` disables the feature.
+ * - `true` enables the feature with its documented defaults.
+ * - an object enables the feature and overrides only the provided fields.
+ */
+interface OxContentOptions {
+  /**
+   * Directory containing Markdown source files.
    *
-   * Defaults to `'css-variables'`, which renders token colors as `--octc-shiki-*`
-   * custom properties so highlighting follows the active color scheme in both
-   * light and dark from one build. Without a `@ox-content/theme-color-*`
-   * package installed the properties fall back to GitHub Dark. Pass any bundled
-   * Shiki theme name to opt out and bake fixed colors in instead.
+   * The path is resolved from the Vite project root. SSG, search indexing, and
+   * dev-server routing all use this directory as the content root.
    *
-   * @default 'css-variables'
+   * @default 'content'
    */
-  highlightTheme?: string | ThemeRegistration$1;
+  srcDir?: string;
   /**
-   * Additional languages for syntax highlighting.
-   * Accepts Shiki LanguageRegistration objects (e.g., TextMate grammars).
-   * These are loaded alongside the built-in languages.
-   * @default []
+   * Directory where generated files are written.
+   *
+   * SSG HTML, search indexes, and generated assets are emitted under this
+   * directory during production builds.
+   *
+   * @default 'dist'
+   */
+  outDir?: string;
+  /**
+   * Base path prepended to generated internal URLs.
+   *
+   * Use this when the site is deployed below a sub-path, such as GitHub Pages or
+   * a documentation route inside a larger application.
+   *
+   * @default '/'
+   */
+  base?: string;
+  /**
+   * Markdown-like file extensions to process.
+   *
+   * Extensions are normalized with a leading dot and matched case-insensitively.
+   * Add custom extensions when another authoring format is compiled to Markdown
+   * before ox-content sees it.
+   *
+   * @default ['.md', '.markdown', '.mdx']
+   */
+  extensions?: string[];
+  /**
+   * Static Site Generation options.
+   *
+   * Passing `true` or omitting this option enables SSG with defaults. Passing
+   * `false` disables the SSG plugin while still allowing Markdown module
+   * transforms to run.
+   *
+   * @default { enabled: true }
+   */
+  ssg?: SsgOptions | boolean;
+  /**
+   * Write crawl manifests next to generated HTML.
+   *
+   * Off by default. `true` writes `sitemap.xml`, `robots.txt`, and `llms.txt`.
+   * An object enables the feature and overrides only the fields you set.
+   * Requires `ssg.siteUrl`. When that is missing the build continues and a
+   * warning is emitted instead of writing files.
+   *
+   * @default false
    */
-  highlightLangs?: LanguageRegistration$1[];
+  siteMaps?: boolean | SiteMapsOptions;
+  /**
+   * Honor frontmatter draft / unlisted / scheduled publish states.
+   *
+   * Off by default. `true` omits drafts and future-scheduled pages from
+   * production HTML, search, and sitemaps. Unlisted pages still build and
+   * remain reachable by URL. An object enables the feature and can inject
+   * `now` for a deterministic build-time clock.
+   *
+   * @default false
+   */
+  publishState?: boolean | PublishStateOptions;
+  /**
+   * Honor frontmatter `permalink` / `slug` when resolving page URLs.
+   *
+   * Off by default. `true` or `{}` replaces the file-tree URL with
+   * `permalink`, or the last path segment with `slug`. Path escape
+   * (`../`, absolute filesystem paths, `javascript:`, protocol-relative
+   * `//`) is rejected and the file-tree URL is kept. Two pages that
+   * resolve to the same URL produce an error; the first page is kept and
+   * the later page is skipped.
+   *
+   * @default false
+   */
+  permalinks?: boolean | PermalinksOptions;
+  /**
+   * Inherit missing frontmatter keys from ancestor `_index` files.
+   *
+   * Off by default. `true` or `{}` fills keys a child does not set.
+   * `permalink` and `slug` are never inherited.
+   *
+   * @default false
+   */
+  cascade?: boolean | CascadeOptions;
+  /**
+   * Write static HTML redirect pages for frontmatter aliases and a config map.
+   *
+   * Off by default. `true` or `{}` enables empty defaults. A path map such as
+   * `{ "/old-guide": "/guide" }` enables the feature with that map. Destinations
+   * must be same-origin paths (`/` but not `//`) unless `allowExternal` is set.
+   * `javascript:`, `data:`, and protocol-relative URLs are ignored.
+   * Overlapping sources last-win after trailing slashes are folded.
+   *
+   * @default false
+   */
+  redirects?: boolean | RedirectsOptions | Record<string, string>;
+  /**
+   * Write a paginated blog index, tag pages, and yearly/monthly archive,
+   * and inject author / reading-time chrome on posts.
+   *
+   * Off by default. `true` uses the `blog` collection when it exists,
+   * otherwise the only configured collection, with pageSize 10.
+   * An object enables the feature and overrides only the fields you set.
+   * Also accepted as `ssg.blog`; the top-level option wins when both are set.
+   *
+   * @default false
+   */
+  blog?: boolean | BlogOptions;
+  /**
+   * Write RSS, Atom, and/or JSON Feed files from a named collection.
+   *
+   * Off by default. `true` writes all three formats from the `content`
+   * collection (or the first configured collection) with a 20-item limit.
+   * An object enables the feature and overrides only the fields you set.
+   * Requires `ssg.siteUrl`. When that is missing the build continues and a
+   * warning is emitted instead of writing files.
+   *
+   * @default false
+   */
+  feeds?: boolean | FeedsOptions;
+  /**
+   * Write a web app manifest and an optional service worker.
+   *
+   * Off by default. `true` writes `manifest.webmanifest` and `sw.js`, and
+   * injects a tiny client script that registers the worker on themed pages.
+   * An object enables the feature and can set `offline: false` to keep the
+   * manifest without caching or that script. This adds client JavaScript
+   * when offline is on. Requires `ssg.siteUrl`. When that is missing the
+   * build continues and a warning is emitted instead of writing files.
+   *
+   * @default false
+   */
+  pwa?: boolean | PwaOptions;
+  /**
+   * Write tag/category term pages and inject related-page lists.
+   *
+   * Off by default. `true` reads frontmatter `tags` and `categories` and
+   * writes list pages, per-term pages, and up to 5 related links on pages
+   * that share a term. An object enables the feature and overrides only
+   * the fields you set. Term slugs are `[a-z0-9-]` and every label is
+   * HTML-escaped.
+   *
+   * @default false
+   */
+  taxonomies?: boolean | TaxonomiesOptions;
+  /**
+   * Prefix live docs, emit frozen snapshot trees, and render a header
+   * version dropdown.
+   *
+   * Off by default. `true` enables a single current entry. An object
+   * enables the feature and lists additional versions. Historical
+   * snapshot directories are read, never rewritten.
+   *
+   * @default false
+   */
+  versions?: boolean | VersionsOptions;
+  /**
+   * Enable GitHub Flavored Markdown extensions.
+   * @default true
+   */
+  gfm?: boolean;
+  /**
+   * Enable MDX JSX, ESM, and expressions.
+   *
+   * When omitted, MDX is enabled for `.mdx` files only. Set `true` to enable
+   * it for every configured extension or `false` to keep `.mdx` on the plain
+   * Markdown path.
+   * @default inferred from the source extension
+   */
+  mdx?: boolean;
+  /**
+   * Enable footnotes.
+   * @default true
+   */
+  footnotes?: boolean;
+  /**
+   * Enable tables.
+   * @default true
+   */
+  tables?: boolean;
+  /**
+   * Enable task lists.
+   * @default true
+   */
+  taskLists?: boolean;
+  /**
+   * Enable strikethrough.
+   * @default true
+   */
+  strikethrough?: boolean;
+  /**
+   * Enable GFM autolinks and linkify bare URLs.
+   * @default true
+   */
+  autolinks?: boolean;
+  /**
+   * Enable syntax highlighting for code blocks.
+   *
+   * When true, fenced and language-tagged inline code is highlighted with the
+   * native tree-sitter engine. Token colors are `--octc-shiki-*` custom
+   * properties (the `shiki` prefix is historical) so theme-color packages keep
+   * working. Languages with no native grammar stay unhighlighted.
+   *
+   * @default false
+   */
+  highlight?: boolean;
   /**
    * Code block line annotations for fenced code blocks.
    *
@@ -1318,6 +2225,51 @@ interface OxContentOptions {
    * @default false
    */
   attrs?: boolean | AttrsOptions;
+  /**
+   * Opt-in `{badge:variant}` inline badges.
+   *
+   * Passing `true` or an options object enables the built-in variants.
+   * Badge text is HTML-escaped. Fenced, indented, and inline code are skipped.
+   *
+   * @default false
+   */
+  badges?: boolean | BadgeOptions;
+  /**
+   * Opt-in `::: tip` custom containers.
+   *
+   * GitHub-style `> [!NOTE]` callouts stay available without this option.
+   * Passing `true` enables the built-in types. Pass an object to register extra
+   * types or override titles.
+   *
+   * @default false
+   */
+  containers?: boolean | ContainerOptions;
+  /**
+   * Opt-in figures, captions, and lazy-loaded images.
+   *
+   * Title text becomes a `<figcaption>`. Optional `{width=N height=M}` on the
+   * image is consumed by this feature and does not require `attrs`. Passing
+   * `true` or `{}` enables defaults (`lazy: true`).
+   *
+   * @default false
+   */
+  images?: boolean | ImageOptions;
+  /**
+   * Opt-in 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).
+   *
+   * 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}`.
    *
@@ -1328,6 +2280,45 @@ interface OxContentOptions {
    * @default false
    */
   codeImports?: boolean | CodeImportOptions;
+  /**
+   * Inline another Markdown file with `<!-- @include: ./path.md -->`.
+   *
+   * Expansion happens before Markdown is parsed, so included headings and
+   * lists become part of the host document. Relative paths resolve from the
+   * current file. `@/` and `/` resolve from `rootDir`. Paths outside
+   * `rootDir` are rejected and reported as transform errors.
+   *
+   * @default false
+   */
+  includes?: boolean | IncludeOptions;
+  /**
+   * Opt-in `::: card` / `::: link-card` / `::: card-grid` blocks.
+   *
+   * Passing `true` enables the defaults. Pass an object to keep the option
+   * shape while overriding `enabled`.
+   *
+   * @default false
+   */
+  cards?: boolean | CardOptions;
+  /**
+   * Restyle a `::: steps` wrapper around an ordered list.
+   *
+   * Disabled when omitted or `false`. `true` and `{}` enable the default
+   * step-list markup. Ordinary ordered lists outside `::: steps` are unchanged.
+   *
+   * @default false
+   */
+  steps?: boolean | StepsOptions;
+  /**
+   * Opt-in static directory trees from `file-tree` fences.
+   *
+   * Passing `true` or `{}` enables the transform. Names are escaped and never
+   * read from the filesystem. Directories with children open and close with
+   * `<details>`. Icons are on by default and can be replaced from site config.
+   *
+   * @default false
+   */
+  fileTree?: boolean | FileTreeOptions;
   /**
    * Sanitize rendered HTML with safe defaults or explicit allow lists.
    *
@@ -1374,6 +2365,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.
    *
@@ -1388,6 +2389,15 @@ interface OxContentOptions {
    * @default false
    */
   mermaid?: boolean;
+  /**
+   * Enable `$…$` inline and `$$…$$` block math.
+   *
+   * Currency-like `$` runs, fenced code, indented code, and inline code stay
+   * literal. TeX is HTML-escaped into accessible MathML `mtext`.
+   *
+   * @default false
+   */
+  math?: boolean | MathOptions;
   /**
    * Parse YAML frontmatter.
    * @default true
@@ -1471,27 +2481,49 @@ interface ResolvedOptions {
   base: string;
   extensions: string[];
   ssg: ResolvedSsgOptions;
+  siteMaps?: ResolvedSiteMapsOptions;
+  publishState?: ResolvedPublishStateOptions;
+  permalinks?: ResolvedPermalinksOptions;
+  cascade?: ResolvedCascadeOptions;
+  redirects?: ResolvedRedirectsOptions;
+  blog?: ResolvedBlogOptions;
+  feeds?: ResolvedFeedsOptions;
+  pwa?: ResolvedPwaOptions;
+  taxonomies?: ResolvedTaxonomiesOptions;
+  versions?: ResolvedVersionsOptions;
+  resources?: ResolvedResourcesOptions;
   gfm: boolean;
+  mdx?: boolean;
   footnotes: boolean;
   tables: boolean;
   taskLists: boolean;
   strikethrough: boolean;
   autolinks: boolean;
   highlight: boolean;
-  highlightTheme: string | ThemeRegistration$1;
-  highlightLangs: LanguageRegistration$1[];
   codeAnnotations: ResolvedCodeAnnotationsOptions;
   wikiLinks: ResolvedWikiLinkOptions;
   emojiShortcodes: ResolvedEmojiShortcodeOptions;
   attrs: ResolvedAttrsOptions;
+  badges: ResolvedBadgeOptions;
+  containers: ResolvedContainerOptions;
+  images: ResolvedImageOptions;
   codeImports: ResolvedCodeImportOptions;
+  includes: ResolvedIncludeOptions;
+  cards: ResolvedCardOptions;
+  steps: ResolvedStepsOptions;
+  fileTree: ResolvedFileTreeOptions;
   sanitize: ResolvedSanitizeOptions;
   editThisPage: ResolvedEditThisPageOptions;
   cjkEmphasis: boolean;
   codeBlockLint: ResolvedCodeBlockLintOptions;
   codeBlockTypecheck: ResolvedCodeBlockTypecheckOptions;
+  /**
+   * Present after `resolveOptions`. Omitted in hand-built fixtures means off.
+   */
+  typedHover?: ResolvedTypedHoverOptions;
   docsTests: ResolvedDocsTestOptions;
   mermaid: boolean;
+  math: ResolvedMathOptions;
   frontmatter: boolean;
   toc: boolean;
   tocMaxDepth: number;
@@ -1582,6 +2614,112 @@ interface ResolvedBuiltinEmbedOptions {
   bluesky: boolean;
   webContainer: boolean;
 }
+/**
+ * Options for opt-in `{badge:variant}` inline badges.
+ */
+interface BadgeOptions {
+  /**
+   * Enable the badge transform when an options object is supplied.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+}
+/**
+ * Resolved inline-badge transform options.
+ */
+interface ResolvedBadgeOptions {
+  enabled: boolean;
+}
+/**
+ * Options for opt-in `::: type` custom containers.
+ */
+interface ContainerOptions {
+  /**
+   * Enable the container transform when an options object is supplied.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * Extra or overriding container types.
+   *
+   * Keys must be ASCII identifiers (`[A-Za-z0-9_-]+`). Unknown hostile names
+   * are ignored.
+   */
+  types?: Record<string, ContainerTypeOptions>;
+}
+/**
+ * Per-type container presentation.
+ */
+interface ContainerTypeOptions {
+  /** Title used when the opener does not set one. */
+  title?: string;
+  /** `"details"` renders `<details>`/`<summary>`; anything else is a `<div>`. */
+  tag?: "div" | "details";
+}
+/**
+ * Resolved custom-container transform options.
+ */
+interface ResolvedContainerOptions {
+  enabled: boolean;
+  types: Record<string, ContainerTypeOptions>;
+}
+/**
+ * Options for opt-in figures, captions, and lazy images.
+ */
+interface ImageOptions {
+  /**
+   * Add `loading="lazy"` to transformed images.
+   *
+   * @default true
+   */
+  lazy?: boolean;
+}
+/**
+ * Resolved image transform options.
+ */
+interface ResolvedImageOptions {
+  enabled: boolean;
+  lazy: boolean;
+}
+/**
+ * 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";
+}
+/**
+ * Resolved page-resource options.
+ */
+interface ResolvedResourcesOptions {
+  enabled: boolean;
+  formats: string[];
+  widths: number[];
+  missing: "error" | "warn";
+}
 /**
  * Options for expanding Obsidian-style wiki links.
  *
@@ -1636,6 +2774,27 @@ interface ResolvedEmojiShortcodeOptions {
   enabled: boolean;
   custom: Record<string, string>;
 }
+/**
+ * Options for opt-in `$…$` / `$$…$$` math.
+ *
+ * Delimiter parsing lives in the native transform. Typesetting uses KaTeX at
+ * build time when the optional `katex` peer is installed. Sites that omit
+ * `math` do not need that package.
+ */
+interface MathOptions {
+  /**
+   * Enable the math transform when an options object is supplied.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+}
+/**
+ * Resolved math transform options.
+ */
+interface ResolvedMathOptions {
+  enabled: boolean;
+}
 /**
  * Options for markdown-it-attrs style attribute blocks.
  *
@@ -1689,6 +2848,112 @@ interface ResolvedCodeImportOptions {
   enabled: boolean;
   rootDir?: string;
 }
+/**
+ * Options for inlining Markdown files with `<!-- @include: PATH -->`.
+ *
+ * Relative paths resolve from the current file. `@/` and leading `/` resolve
+ * from `rootDir`. After canonicalize, paths outside `rootDir` are rejected.
+ */
+interface IncludeOptions {
+  /**
+   * Directory used to resolve `@/` and absolute include paths.
+   *
+   * When omitted, includes resolve from the Vite project root.
+   *
+   * @default undefined
+   */
+  rootDir?: string;
+}
+/**
+ * Resolved Markdown-include transform options.
+ */
+interface ResolvedIncludeOptions {
+  enabled: boolean;
+  rootDir?: string;
+}
+/**
+ * Options for opt-in `::: card` / `::: link-card` / `::: card-grid` blocks.
+ */
+interface CardOptions {
+  /**
+   * Enable the card transform when an options object is supplied.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+}
+/**
+ * Resolved card transform options.
+ */
+interface ResolvedCardOptions {
+  enabled: boolean;
+}
+/**
+ * Options for opt-in `::: steps` ordered lists.
+ */
+interface StepsOptions {
+  /**
+   * Enable the steps transform when an options object is supplied.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+}
+/**
+ * Resolved step-list transform options.
+ */
+interface ResolvedStepsOptions {
+  enabled: boolean;
+}
+/**
+ * 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.
+ */
+interface FileTreeOptions {
+  /**
+   * Enable the file-tree transform when an options object is supplied.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * Open directory `<details>` by default.
+   *
+   * @default true
+   */
+  defaultOpen?: boolean;
+  /**
+   * Render folder and file icons. Pass an object to replace the defaults.
+   *
+   * @default true
+   */
+  icons?: boolean | FileTreeIconOptions;
+}
+/**
+ * Resolved file-tree transform options.
+ */
+interface ResolvedFileTreeOptions {
+  enabled: boolean;
+  defaultOpen: boolean;
+  icons: boolean;
+  iconFolder?: string;
+  iconFolderOpen?: string;
+  iconFile?: string;
+  iconFiles?: Record<string, string>;
+}
 /**
  * Options for sanitizing rendered HTML.
  *
@@ -1890,6 +3155,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.
  *
@@ -2065,6 +3367,30 @@ interface MarkdownNode {
   value?: string;
   [key: string]: unknown;
 }
+/**
+ * How a specifier was imported from an MDX `import` statement.
+ */
+type MdxImportSpecifierKind = "default" | "named" | "namespace";
+/**
+ * One binding created by an MDX `import` statement.
+ */
+interface MdxImportSpecifier {
+  /** Imported name (`default`, `*`, or the named export). */
+  imported: string;
+  /** Local binding name. */
+  local: string;
+  /** Specifier kind. */
+  kind: MdxImportSpecifierKind;
+}
+/**
+ * One MDX `import` statement collected from the AST.
+ */
+interface MdxImport {
+  /** Module specifier string. */
+  source: string;
+  /** Bindings created by the import. */
+  specifiers: MdxImportSpecifier[];
+}
 /**
  * Transform result.
  */
@@ -2089,6 +3415,18 @@ interface TransformResult {
    * Table of contents.
    */
   toc: TocEntry[];
+  /**
+   * MDX `import` statements (empty when MDX is off or no ESM nodes).
+   */
+  imports: MdxImport[];
+  /**
+   * Export names from MDX ESM (empty when MDX is off or no exports).
+   */
+  exports: string[];
+  /**
+   * Unique JSX component names in document order (empty when none).
+   */
+  components: string[];
 }
 /**
  * Table of contents entry.
@@ -2706,6 +4044,50 @@ interface SearchOptions {
    * @default '/'
    */
   hotkey?: string;
+  /**
+   * Search backend used by `virtual:ox-content/search`.
+   *
+   * `"local"` (the default) keeps the static BM25 `search-index.json` client.
+   * `"hosted"` sends queries to a remote index with a public search-only key.
+   * Hosted search is used only when this is set to `"hosted"`.
+   *
+   * @default 'local'
+   */
+  provider?: "local" | "hosted";
+  /**
+   * Hosted search application id.
+   *
+   * Required when `provider` is `"hosted"`. Also read from
+   * `OX_CONTENT_SEARCH_APP_ID` when omitted here.
+   */
+  appId?: string;
+  /**
+   * Hosted search index name.
+   *
+   * Required when `provider` is `"hosted"`. Also read from
+   * `OX_CONTENT_SEARCH_INDEX_NAME` when omitted here.
+   */
+  indexName?: string;
+  /**
+   * Public search-only key for the hosted provider.
+   *
+   * Write and admin keys are rejected. Also read from `OX_CONTENT_SEARCH_KEY`
+   * when omitted here.
+   */
+  searchKey?: string;
+  /**
+   * Alias for `searchKey`.
+   *
+   * Also read from `OX_CONTENT_SEARCH_PUBLIC_KEY` when omitted here.
+   */
+  publicKey?: string;
+  /**
+   * HTTP endpoint that receives hosted search queries.
+   *
+   * Also read from `OX_CONTENT_SEARCH_ENDPOINT`. Defaults to `/search` when
+   * hosted credentials are present.
+   */
+  endpoint?: string;
 }
 /**
  * Resolved search options.
@@ -2716,6 +4098,12 @@ interface ResolvedSearchOptions {
   prefix: boolean;
   placeholder: string;
   hotkey: string;
+  provider?: "local" | "hosted";
+  appId?: string;
+  indexName?: string;
+  searchKey?: string;
+  publicKey?: string;
+  endpoint?: string;
 }
 /**
  * Search document structure.
@@ -2896,6 +4284,21 @@ declare module "virtual:ox-content/collections" {
   export default api;
 }
 //#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/step-options.d.ts
+declare function resolveStepsOptions(options: OxContentOptions["steps"]): ResolvedOptions["steps"];
+//#endregion
+//#region src/file-tree-options.d.ts
+declare function resolveFileTreeOptions(options: OxContentOptions["fileTree"]): ResolvedOptions["fileTree"];
+//#endregion
+//#region src/typed-hover.d.ts
+declare function resolveTypedHoverOptions(options: OxContentOptions["typedHover"]): ResolvedOptions["typedHover"];
+//#endregion
 //#region src/environment.d.ts
 /**
  * Creates the Markdown processing environment configuration.
@@ -2928,6 +4331,11 @@ interface IncrementalMarkdownParserOptions {
    * @default true
    */
   gfm?: boolean;
+  /**
+   * Enable MDX JSX, ESM, and expression nodes.
+   * @default false
+   */
+  mdx?: boolean;
   /**
    * Enable footnotes.
    * @default true
@@ -3057,6 +4465,9 @@ declare function renderMarkdownStream(chunks: MarkdownChunkSource, options?: Inc
  * - `html` (string): Rendered HTML content with all enhancements applied
  * - `frontmatter` (object): Parsed YAML frontmatter as JavaScript object
  * - `toc` (array): Hierarchical table of contents entries
+ * - `imports` (array): MDX import statements (`source` + specifiers)
+ * - `exports` (array): MDX export names
+ * - `components` (array): Unique JSX component names
  * - `render` (function): Client-side render function for dynamic updates
  *
  * ## Markdown Features Supported
@@ -3104,7 +4515,6 @@ declare function renderMarkdownStream(chunks: MarkdownChunkSource, options?: Inc
  *
  * const options = resolveOptions({
  *   highlight: true,
- *   highlightTheme: 'github-dark',
  *   toc: true,
  *   gfm: true,
  *   mermaid: true,
@@ -3132,6 +4542,138 @@ interface SsgTransformOptions {
 }
 declare function transformMarkdown(source: string, filePath: string, options: ResolvedOptions, ssgOptions?: SsgTransformOptions): Promise<TransformResult>;
 //#endregion
+//#region src/markdown.d.ts
+declare const DEFAULT_MARKDOWN_EXTENSIONS: readonly [".md", ".markdown", ".mdx"];
+declare function normalizeMarkdownExtensions(extensions?: readonly string[]): string[];
+declare function isMarkdownFilePath(filePath: string, extensions?: readonly string[]): boolean;
+/** Returns true when a resource id points at an MDX source file. */
+declare function isMdxFilePath(filePath: string): boolean;
+/** Explicit configuration wins; otherwise MDX follows the source extension. */
+declare function resolveMdxForFilePath(filePath: string, configured?: boolean): boolean;
+declare function stripMarkdownExtension(filePath: string, extensions?: readonly string[]): string;
+//#endregion
+//#region src/mdx-islands.d.ts
+/**
+ * Discover registered MDX islands from the mdast tree or rendered HTML.
+ *
+ * Framework plugins use this instead of a source regex when MDX is on, so
+ * nested JSX, expression attributes, and fragments stay visible. Names that
+ * are not in the global `components` map and are not document-local import
+ * bindings are left as static HTML.
+ */
+/** Global component map: object, Map, or name list. */
+type ComponentRegistry = Readonly<Record<string, unknown>> | ReadonlyMap<string, unknown> | Iterable<string>;
+/**
+ * Collect named MDX JSX tags from a parsed mdast tree (JSON from NAPI `parse()`).
+ * Fragments (`name: null`) and non-JSX nodes are ignored. Walks nested children
+ * so inner islands are found.
+ */
+declare function collectMdxJsxNamesFromAst(ast: unknown): string[];
+/**
+ * Collect `data-ox-island` names from Rust-rendered HTML.
+ * Used when an AST walk is unavailable.
+ */
+declare function collectMdxIslandNamesFromHtml(html: string): string[];
+/** Keep names that exist on the global component map, in first-seen order. */
+declare function intersectRegisteredComponentNames(names: Iterable<string>, components: ComponentRegistry): string[];
+/**
+ * Keep names that are either globally registered or document-local bindings.
+ */
+declare function intersectHydratableComponentNames(names: Iterable<string>, components: ComponentRegistry, localNames?: Iterable<string>): string[];
+interface DiscoverRegisteredMdxComponentsInput {
+  /** Markdown/MDX body (frontmatter already stripped). */
+  source: string;
+  /** Rendered HTML, used when `parse()` is missing or the AST walk fails. */
+  html?: string;
+  components: ComponentRegistry;
+  /** Document-local import bindings. These override the global map for this file. */
+  localNames?: Iterable<string>;
+}
+/**
+ * Resolve registered island names for an MDX document.
+ *
+ * Prefers a NAPI `parse()` AST walk. Falls back to rendered `data-ox-island`
+ * names so plugins still hydrate if #659 metadata is not present.
+ */
+declare function discoverRegisteredMdxComponents(input: DiscoverRegisteredMdxComponentsInput): Promise<string[]>;
+declare function isRegisteredComponent(name: string, components: ComponentRegistry): boolean;
+//#endregion
+//#region src/document-imports.d.ts
+interface ResolveDocumentComponentImportsInput {
+  imports: readonly MdxImport[];
+  documentPath: string;
+  contentRoot?: string;
+  srcDir?: string;
+}
+interface ResolvedDocumentComponentImport {
+  localName: string;
+  specifier: string;
+  resolvedPath: string;
+  importPathRelativeToDocument: string;
+  imported: string;
+  kind: Exclude<MdxImportSpecifierKind, "namespace">;
+}
+type DocumentImportDiagnosticCode = "not-relative" | "escapes-root" | "duplicate-binding";
+interface DocumentImportDiagnostic {
+  code: DocumentImportDiagnosticCode;
+  message: string;
+  specifier: string;
+  localName?: string;
+}
+interface ResolveDocumentComponentImportsResult {
+  bindings: ResolvedDocumentComponentImport[];
+  diagnostics: DocumentImportDiagnostic[];
+}
+declare function resolveContentRootPath(input: {
+  contentRoot?: string;
+  srcDir?: string;
+  root?: string;
+}): string;
+declare function stripViteQuery(id: string): string;
+declare function resolveDocumentComponentImports(input: ResolveDocumentComponentImportsInput): ResolveDocumentComponentImportsResult;
+//#endregion
+//#region src/document-islands.d.ts
+interface DiscoverDocumentMdxIslandsInput {
+  source: string;
+  html?: string;
+  components: ComponentRegistry;
+  imports: readonly MdxImport[];
+  documentPath: string;
+  contentRoot?: string;
+  srcDir?: string;
+  root?: string;
+}
+interface DiscoverDocumentMdxIslandsResult {
+  usedComponents: string[];
+  localBindings: Map<string, ResolvedDocumentComponentImport>;
+  diagnostics: DocumentImportDiagnostic[];
+}
+declare function discoverDocumentMdxIslands(input: DiscoverDocumentMdxIslandsInput): Promise<DiscoverDocumentMdxIslandsResult>;
+//#endregion
+//#region src/island-codegen.d.ts
+type GlobalComponentMap = Readonly<Record<string, string>> | ReadonlyMap<string, string>;
+interface RenderIslandComponentImportsInput {
+  globalComponents: GlobalComponentMap;
+  localBindings?: ReadonlyMap<string, ResolvedDocumentComponentImport>;
+  documentPath: string;
+  root?: string;
+}
+declare function renderIslandComponentImports(usedComponents: readonly string[], input: RenderIslandComponentImportsInput): string;
+//#endregion
+//#region src/island-ssr.d.ts
+/**
+ * Optional adapter-side island SSR.
+ *
+ * Framework plugins may supply `renderIsland` to replace island inner HTML at
+ * transform time. This helper stays framework-neutral and does not import a
+ * framework SSR runtime.
+ */
+type RenderIslandFn = (name: string, props: Record<string, unknown>, filePath: string) => string | Promise<string>;
+declare function applyIslandSsrHtml(html: string, renderIsland: RenderIslandFn, filePath: string, names?: Iterable<string>): Promise<string>;
+//#endregion
+//#region src/resolve-image-options.d.ts
+declare function resolveImageOptions(options: OxContentOptions["images"]): ResolvedOptions["images"];
+//#endregion
 //#region src/framework.d.ts
 type FrameworkRenderTarget = "html" | "native";
 type FrameworkCodegenTarget = "react" | "vue" | "svelte";
@@ -3153,6 +4695,10 @@ interface FrameworkMarkdownOptions {
     github?: ResolvedOptions["embeds"]["github"];
     openGraph?: ResolvedOptions["embeds"]["openGraph"];
   };
+  math?: boolean | {
+    enabled?: boolean;
+  };
+  mdx?: boolean;
 }
 interface FrameworkComponentIsland {
   name: string;
@@ -3579,6 +5125,12 @@ interface MarkdownLintOptions {
    * @default {}
    */
   dictionary?: MarkdownLintDictionaryOptions;
+  /**
+   * Enable MDX-aware syntax masking while linting visible prose.
+   * File-oriented APIs infer this from `.mdx` when omitted.
+   * @default false for content APIs; inferred for file APIs
+   */
+  mdx?: boolean;
 }
 /**
  * A single Markdown lint diagnostic.
@@ -3756,6 +5308,144 @@ interface SsgBuildResult {
  */
 declare function buildSsg(options: ResolvedOptions, root: string): Promise<SsgBuildResult>;
 //#endregion
+//#region src/not-found.d.ts
+/**
+ * Resolves `ssg.notFound` with defaults.
+ *
+ * `false` / omitted stays off. `true` enables `404.md` → `404.html`. An object
+ * enables the feature and overrides only the fields the site set.
+ */
+declare function resolveNotFoundOptions(value: boolean | NotFoundOptions | undefined): ResolvedNotFoundOptions;
+//#endregion
+//#region src/site-maps.d.ts
+/**
+ * Resolves `siteMaps` with defaults.
+ *
+ * `false` / omitted stays off. `true` enables all three files. An object
+ * enables the feature and overrides only the fields the site set.
+ */
+declare function resolveSiteMapsOptions(value: boolean | SiteMapsOptions | undefined): ResolvedSiteMapsOptions;
+//#endregion
+//#region src/publish-state.d.ts
+/** Split pages into production output vs listing surfaces. */
+interface PartitionedPages<T> {
+  output: T[];
+  listed: T[];
+}
+/**
+ * Resolves `publishState` with defaults.
+ *
+ * `false` / omitted stays off. `true` enables production filtering. An object
+ * enables the feature and overrides only the fields the site set.
+ */
+declare function resolvePublishStateOptions(value: boolean | PublishStateOptions | undefined): ResolvedPublishStateOptions;
+/** Classifies one frontmatter object. Never throws. */
+declare function classifyPublishState(frontmatter: Record<string, unknown>, options: ResolvedPublishStateOptions | undefined): {
+  output: boolean;
+  listed: boolean;
+};
+/** Splits pages into those that write HTML and those that appear in listings. */
+declare function partitionPublishedPages<T extends {
+  frontmatter: Record<string, unknown>;
+}>(pages: readonly T[], options: ResolvedPublishStateOptions | undefined): PartitionedPages<T>;
+//#endregion
+//#region src/permalinks.d.ts
+/** Resolves `permalinks`. `false` / omitted stays off. `true` / `{}` enables. */
+declare function resolvePermalinksOptions(value: boolean | PermalinksOptions | undefined): ResolvedPermalinksOptions;
+/** Resolves `cascade`. `false` / omitted stays off. `true` / `{}` enables. */
+declare function resolveCascadeOptions(value: boolean | CascadeOptions | undefined): ResolvedCascadeOptions;
+//#endregion
+//#region src/redirects.d.ts
+/**
+ * Resolves `redirects` with defaults.
+ *
+ * `false` / omitted stays off. `true` or `{}` enables empty defaults.
+ * A path map (`{ "/old": "/new" }`) enables the feature with that map.
+ * `{ map, netlify, headers, json, allowExternal }` overrides only set fields.
+ */
+declare function resolveRedirectsOptions(value: boolean | RedirectsOptions | Record<string, string> | undefined): ResolvedRedirectsOptions;
+//#endregion
+//#region src/feeds.d.ts
+/**
+ * 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.
+ */
+declare function resolveFeedsOptions(value: boolean | FeedsOptions | undefined): ResolvedFeedsOptions;
+//#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-reading.d.ts
+/**
+ * Deterministic blog reading-time estimates.
+ */
+declare function readingTimeMinutes(markdown: string): number;
+//#endregion
+//#region src/pwa.d.ts
+/**
+ * Resolves `pwa` with defaults.
+ *
+ * `false` / omitted stays off. `true` enables the manifest and offline
+ * service worker. An object enables the feature and overrides only the
+ * fields the site set.
+ */
+declare function resolvePwaOptions(value: boolean | PwaOptions | undefined): ResolvedPwaOptions;
+//#endregion
+//#region src/taxonomies.d.ts
+/**
+ * Resolves `taxonomies` with defaults.
+ *
+ * `false` / omitted stays off. `true` enables `tags` and `categories` with
+ * relatedLimit 5. An object enables the feature and overrides only set fields.
+ */
+declare function resolveTaxonomiesOptions(value: boolean | TaxonomiesOptions | undefined): ResolvedTaxonomiesOptions;
+//#endregion
+//#region src/versions.d.ts
+/**
+ * Resolves `versions`. Omitted / `false` stay off. `true` enables a single
+ * current entry. An object enables the feature and overrides set fields.
+ */
+declare function resolveVersionsOptions(value: boolean | VersionsOptions | undefined): ResolvedVersionsOptions;
+//#endregion
+//#region src/resources.d.ts
+declare class PageResourceError extends Error {
+  readonly issues: string[];
+  constructor(issues: string[]);
+}
+/**
+ * Resolves `resources`. Omitted / `false` stay off. `true` or `{}` enables
+ * defaults. An object enables the feature and overrides only set fields.
+ */
+declare function resolveResourcesOptions(value: boolean | ResourcesOptions | undefined): ResolvedResourcesOptions;
+//#endregion
+//#region src/team.d.ts
+/**
+ * Resolves `ssg.team` with defaults.
+ *
+ * `false` / omitted stays off. `true` enables an empty member list.
+ * An object enables the feature and keeps the members the site set.
+ */
+declare function resolveTeamOptions(value: boolean | TeamOptions | undefined): ResolvedTeamOptions;
+//#endregion
+//#region src/section-index.d.ts
+/**
+ * Resolves `ssg.sectionIndex` with defaults.
+ *
+ * `false` / omitted stays off. `true` enables card listings. An object
+ * enables the feature and overrides only the fields the site set.
+ */
+declare function resolveSectionIndexOptions(value: boolean | SectionIndexOptions | undefined): ResolvedSectionIndexOptions;
+//#endregion
 //#region src/search.d.ts
 /**
  * Resolves search options with defaults.
@@ -3763,8 +5453,12 @@ declare function buildSsg(options: ResolvedOptions, root: string): Promise<SsgBu
 declare function resolveSearchOptions(options: SearchOptions | boolean | undefined): ResolvedSearchOptions;
 /**
  * Builds the search index from Markdown files.
+ *
+ * `publishState` is forwarded to the native indexer. `excludeDocumentIds`
+ * then drops matching documents and rebuilds the BM25 index so omitted
+ * pages (such as the opt-in 404 source) are not searchable.
  */
-declare function buildSearchIndex(srcDir: string, base: string, extensions?: readonly string[]): Promise<string>;
+declare function buildSearchIndex(srcDir: string, base: string, extensions?: readonly string[], publishState?: ResolvedPublishStateOptions, excludeDocumentIds?: readonly string[], mdx?: boolean): Promise<string>;
 /**
  * Writes the search index to a file.
  */
@@ -3777,12 +5471,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;
@@ -4073,10 +5761,12 @@ 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 { AttrsOptions, type BasePageProps, BuiltinEmbedOptions, BuiltinPmOptions, CodeAnnotationKind, CodeAnnotationSyntax, CodeAnnotationsOptions, type CodeBlockDiagnostic, CodeBlockLintOptions, CodeBlockTypecheckOptions, CodeImportOptions, type CollectedDocsTest, CollectionEntry, CollectionIncludeField, CollectionManifest, CollectionOptions, CollectionQueryBuilder, CollectionQueryOperator, CollectionsOptions, DEFAULT_HTML_TEMPLATE, DEFAULT_MARKDOWN_EXTENSIONS, DefaultTheme, DocEntry, DocMember, DocsEntryPoint, DocsOptions, DocsSortStrategy, DocsSummary, type DocsTestFileOptions, type DocsTestHarnessOptions, DocsTestOptions, DocsTestRunError, type DocsTestRunResult, type DocsTestSource, type DocsTestWriteResult, EditThisPageOptions, EmojiShortcodeOptions, EntryPageConfig, type ExtractedCodeBlock, ExtractedDocs, FeatureConfig, Fragment, type FrameworkCodegenMode, type FrameworkCodegenTarget, type FrameworkComponentIsland, type FrameworkMarkdownOptions, type FrameworkRenderTarget, type FrameworkTransformData, type FrontmatterSchema, type GenerateVitePressMigrationConfigOptions, GeneratedDocsData, type GitHubLineRange, type GitHubOptions, type GitHubRepoData, type GitHubSourceData, type GitHubSourceRef, HeroAction, HeroConfig, HeroImage, HeroNotice, I18nOptions, type IncrementalMarkdownParseAppendOptions, type IncrementalMarkdownParseResult, IncrementalMarkdownParser, type IncrementalMarkdownParserOptions, type IncrementalMarkdownRenderAppendOptions, type IncrementalMarkdownRenderResult, IncrementalMarkdownRenderer, type IncrementalMarkdownRendererOptions, type IslandInfo, type JSXChild, type JSXElementType, type JSXNode, type JSXProps, type LanguageRegistration, type LoadStrategy, LocaleConfig, type MarkdownChunkSource, MarkdownDisplayFormat, type MarkdownLintFileDiagnostic as MarkdownLintBatchDiagnostic, type MarkdownLintFileDiagnostic, type MarkdownLintDiagnostic, type MarkdownLintDictionaryOptions, type MarkdownLintFileOptions, type MarkdownLintFileOptions as MarkdownLintProjectOptions, type MarkdownLintFileResult, type MarkdownLintFilesResult, type MarkdownLintLanguage, type MarkdownLintOptions, type MarkdownLintResult, type MarkdownLintRuleOptions, type MarkdownLintSeverity, type MarkdownLintStandardDictionaryOptions, MarkdownNode, MarkdownTransformer, type MermaidOptions, type NavGroup, NavItem, type OgBrowserSession, OgImageOptions, type OgImagePageEntry, type OgImageOptions$1 as OgImagePluginOptions, type OgImageResult, type OgImageTemplateFn, type OgImageTemplateProps, type OgpData, type OgpOptions, OxContentOptions, type PageData, type PageProps, ParamDoc, type ParseIslandsResult, type RenderContext, ResolvedAttrsOptions, ResolvedBuiltinEmbedOptions, ResolvedCodeAnnotationsOptions, ResolvedCodeBlockLintOptions, ResolvedCodeBlockTypecheckOptions, ResolvedCodeImportOptions, ResolvedCollectionOptions, ResolvedCollectionsOptions, ResolvedDocsEntryPoint, ResolvedDocsOptions, ResolvedDocsTestOptions, ResolvedEditThisPageOptions, ResolvedEmojiShortcodeOptions, ResolvedI18nOptions, ResolvedOgImageOptions, ResolvedOptions, ResolvedSanitizeOptions, ResolvedSearchOptions, ResolvedSsgOptions, type ResolvedThemeConfig, ResolvedWikiLinkOptions, ReturnDoc, type RunDocsTestsOptions, SanitizeOptions, ScopedSearchQuery, SearchDocument, SearchOptions, SearchResult, type SiteConfig, type SocialLinks, SsgNavigationGroup, SsgNavigationItem, SsgOptions, type ThemeColors, type ThemeComponent, type ThemeConfig, type ThemeEmbed, type ThemeEntryPage, type ThemeFonts, type ThemeFooter, type ThemeHeader, type ThemeLayout, type ThemeProps, type ThemeRegistration, type ThemeRenderOptions, type ThemeTokens, ThrowsDoc, TocEntry, type TransformAllOptions, TransformContext, TransformResult, type TwitterEmbedOptions, type TypecheckCodeBlockOptions, type VitePressConfig, type VitePressFooter, type VitePressLogo, type VitePressNavItem, type VitePressSidebar, type VitePressSidebarItem, type VitePressSocialLink, type VitePressThemeConfig, WikiLinkOptions, type WrittenDocsTestFile, type YouTubeOptions, buildCollectionManifest, buildSearchIndex, buildSsg, clearRenderContext, collectDocsTests, collectGitHubRepos, collectGitHubSources, collectOgpUrls, convertVitePressNav, convertVitePressSidebar, createFrameworkMarkdownOptions, createI18nPlugin, createIncrementalMarkdownParser, createIncrementalMarkdownRenderer, createMarkdownEnvironment, createTheme, defaultTheme, defineCollection, defineCollections, defineTheme, each, escapeSvelteMarkup, extractCodeBlocks, extractDocs, extractDocsTests, extractIslandInfo, extractVideoId, fetchGitHubSource, fetchOgpData, fetchRepoData, fromVitePressConfig, generateCollectionsVirtualModule, generateFrontmatterTypes, generateHydrationScript, generateMarkdown, generateOgImages, generateTabsCSS, generateTypes, generateVirtualModule, generateVitePressMigrationConfig, hasIslands, inferType, isMarkdownFilePath, jsx, jsxs, lintCodeBlocks, lintMarkdown, lintMarkdownAsync, lintMarkdownFile, lintMarkdownFiles, mergeThemes, mermaidClientScript, normalizeMarkdownExtensions, normalizeVitePressFrontmatter, oxContent, parseGitHubLineRange, parseGitHubPermalink, prefetchGitHubRepos, prefetchGitHubSources, prefetchOgpData, raw, renderAllPages, renderHtmlToFrameworkCode, renderHtmlToReactComponent, renderHtmlToReactCreateElement, renderHtmlToSvelteComponent, renderHtmlToVueComponent, renderHtmlToVueH, renderMarkdownStream, renderPage, renderToString, resolveBuiltinEmbedOptions, resolveCollectionsOptions, resolveDocsOptions, resolveI18nOptions, resolveOgImageOptions, resolveSearchOptions, resolveSsgOptions, resolveTheme, runDocsTests, setRenderContext, shouldLintMarkdownFile, stripMarkdownExtension, transformAllPlugins, transformGitHub, transformIslands, transformMarkdown, transformMermaidStatic, transformOgp, transformTabs, transformYouTube, typecheckCodeBlocks, useIsActive, useNav, usePageProps, useRenderContext, useSiteConfig, when, writeDocs, writeDocsTestFiles, writeSearchIndex };
+export { A11yOptions, AttrsOptions, BadgeOptions, type BasePageProps, BlogAuthor, BlogOptions, BuiltinEmbedOptions, BuiltinPmOptions, CardOptions, CascadeOptions, CodeAnnotationKind, CodeAnnotationSyntax, CodeAnnotationsOptions, type CodeBlockDiagnostic, CodeBlockLintOptions, CodeBlockTypecheckOptions, CodeImportOptions, type CollectedDocsTest, CollectionEntry, CollectionIncludeField, CollectionManifest, CollectionOptions, CollectionQueryBuilder, CollectionQueryOperator, CollectionsOptions, type ComponentRegistry, ContainerOptions, ContainerTypeOptions, ContributorsOptions, DEFAULT_HTML_TEMPLATE, DEFAULT_MARKDOWN_EXTENSIONS, DefaultTheme, type DiscoverDocumentMdxIslandsInput, type DiscoverDocumentMdxIslandsResult, type DiscoverRegisteredMdxComponentsInput, DocEntry, DocMember, DocsEntryPoint, DocsOptions, DocsSortStrategy, DocsSummary, type DocsTestFileOptions, type DocsTestHarnessOptions, DocsTestOptions, DocsTestRunError, type DocsTestRunResult, type DocsTestSource, type DocsTestWriteResult, type DocumentImportDiagnostic, type DocumentImportDiagnosticCode, EditThisPageOptions, EmojiShortcodeOptions, EntryPageConfig, type ExtractedCodeBlock, ExtractedDocs, FeatureConfig, FeedFormat, FeedsOptions, FileTreeIconOptions, FileTreeOptions, Fragment, type FrameworkCodegenMode, type FrameworkCodegenTarget, type FrameworkComponentIsland, type FrameworkMarkdownOptions, type FrameworkRenderTarget, type FrameworkTransformData, type FrontmatterSchema, type GenerateVitePressMigrationConfigOptions, GeneratedDocsData, type GitHubLineRange, type GitHubOptions, type GitHubRepoData, type GitHubSourceCommit, type GitHubSourceData, type GitHubSourceRef, type GlobalComponentMap, type 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, JsonLdOptions, JsonLdPublisherOptions, 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, MdxImport, MdxImportSpecifier, MdxImportSpecifierKind, type MermaidOptions, type NavGroup, NavItem, NotFoundOptions, type OgBrowserSession, OgImageOptions, type OgImagePageEntry, type OgImageOptions$1 as OgImagePluginOptions, type OgImageResult, type OgImageTemplateFn, type OgImageTemplateProps, type OgpData, type OgpOptions, OxContentOptions, type PageChromeFlags, type PageData, type PageProps, PageResourceError, ParamDoc, type ParseIslandsResult, PermalinksOptions, PublishStateOptions, PwaOptions, ReaderChromeOptions, RedirectsOptions, type RenderContext, type RenderIslandComponentImportsInput, type RenderIslandFn, type ResolveDocumentComponentImportsInput, type ResolveDocumentComponentImportsResult, ResolvedA11y, ResolvedAttrsOptions, ResolvedBadgeOptions, ResolvedBlogOptions, ResolvedBuiltinEmbedOptions, ResolvedCardOptions, ResolvedCascadeOptions, ResolvedCodeAnnotationsOptions, ResolvedCodeBlockLintOptions, ResolvedCodeBlockTypecheckOptions, ResolvedCodeImportOptions, ResolvedCollectionOptions, ResolvedCollectionsOptions, ResolvedContainerOptions, ResolvedContributors, ResolvedDocsEntryPoint, ResolvedDocsOptions, ResolvedDocsTestOptions, type ResolvedDocumentComponentImport, ResolvedEditThisPageOptions, ResolvedEmojiShortcodeOptions, ResolvedFeedsOptions, ResolvedFileTreeOptions, ResolvedI18nOptions, ResolvedImageOptions, ResolvedIncludeOptions, ResolvedJsonLd, ResolvedMathOptions, ResolvedNotFoundOptions, ResolvedOgImageOptions, ResolvedOptions, ResolvedPermalinksOptions, ResolvedPublishStateOptions, ResolvedPwaOptions, ResolvedReaderChrome, ResolvedRedirectsOptions, ResolvedResourcesOptions, ResolvedSanitizeOptions, ResolvedSearchOptions, ResolvedSectionIndexOptions, ResolvedSiteMapsOptions, ResolvedSsgOptions, ResolvedStepsOptions, ResolvedTaxonomiesOptions, ResolvedTeamOptions, type ResolvedThemeConfig, ResolvedTypedHoverOptions, ResolvedVersionEntry, ResolvedVersionsOptions, ResolvedWikiLinkOptions, ResourcesOptions, ReturnDoc, type RunDocsTestsOptions, SanitizeOptions, ScopedSearchQuery, SearchDocument, SearchOptions, SearchResult, SectionIndexOptions, SectionIndexStyle, type SidebarItem, type SiteConfig, SiteMapsOptions, type SocialLinks, SsgNavigationGroup, SsgNavigationItem, SsgOptions, StepsOptions, TaxonomiesOptions, TeamLink, TeamMember, TeamOptions, type ThemeAnnouncement, type ThemeColors, type ThemeComponent, type ThemeConfig, type ThemeEmbed, type ThemeEntryPage, type ThemeFonts, type ThemeFooter, type ThemeHeader, type ThemeLayout, type ThemeProps, type ThemeRenderOptions, type ThemeTokens, ThrowsDoc, TocEntry, type TransformAllOptions, TransformContext, TransformResult, type TwitterEmbedOptions, type TypecheckCodeBlockOptions, TypedHoverOptions, VersionBannerKind, VersionEntry, VersionsOptions, type VitePressConfig, type VitePressFooter, type VitePressLogo, type VitePressNavItem, type VitePressSidebar, type VitePressSidebarItem, type VitePressSocialLink, type VitePressThemeConfig, WikiLinkOptions, type WrittenDocsTestFile, type YouTubeOptions, applyIslandSsrHtml, buildCollectionManifest, buildSearchIndex, buildSsg, classifyPublishState, clearRenderContext, collectDocsTests, collectGitHubRepos, collectGitHubSources, collectMdxIslandNamesFromHtml, collectMdxJsxNamesFromAst, collectOgpUrls, convertVitePressNav, convertVitePressSidebar, createFrameworkMarkdownOptions, createI18nPlugin, createIncrementalMarkdownParser, createIncrementalMarkdownRenderer, createMarkdownEnvironment, createTheme, defaultTheme, defineCollection, defineCollections, defineTheme, discoverDocumentMdxIslands, discoverRegisteredMdxComponents, each, escapeSvelteMarkup, extractCodeBlocks, extractDocs, extractDocsTests, extractIslandInfo, extractVideoId, fetchGitHubSource, fetchOgpData, fetchRepoData, fromVitePressConfig, generateCollectionsVirtualModule, generateFrontmatterTypes, generateHydrationScript, generateMarkdown, generateOgImages, generateTabsCSS, generateTypes, generateVirtualModule, generateVitePressMigrationConfig, hasIslands, inferType, intersectHydratableComponentNames, intersectRegisteredComponentNames, isMarkdownFilePath, isMdxFilePath, isRegisteredComponent, jsx, jsxs, lintCodeBlocks, lintMarkdown, lintMarkdownAsync, lintMarkdownFile, lintMarkdownFiles, mergeThemes, mermaidClientScript, normalizeMarkdownExtensions, normalizeVitePressFrontmatter, oxContent, parseGitHubLineRange, parseGitHubPermalink, parsePageChromeFlags, partitionPublishedPages, prefetchGitHubRepos, prefetchGitHubSources, prefetchOgpData, raw, readingTimeMinutes, renderAllPages, renderHtmlToFrameworkCode, renderHtmlToReactComponent, renderHtmlToReactCreateElement, renderHtmlToSvelteComponent, renderHtmlToVueComponent, renderHtmlToVueH, renderIslandComponentImports, renderMarkdownStream, renderPage, renderToString, resolveBadgeOptions, resolveBlogCollectionName, resolveBlogOptions, resolveBuiltinEmbedOptions, resolveCardOptions, resolveCascadeOptions, resolveCollectionsOptions, resolveContentRootPath, resolveDocsOptions, resolveDocumentComponentImports, resolveFeedsOptions, resolveFileTreeOptions, resolveHeaderNavItems, resolveI18nOptions, resolveImageOptions, resolveIncludeOptions, resolveLocaleLabel, resolveMathOptions, resolveMdxForFilePath, resolveNotFoundOptions, resolveOgImageOptions, resolvePageChromeOption, resolvePermalinksOptions, resolvePublishStateOptions, resolvePwaOptions, resolveRedirectsOptions, resolveResourcesOptions, resolveSearchOptions, resolveSectionIndexOptions, resolveSiteMapsOptions, resolveSsgOptions, resolveStepsOptions, resolveTaxonomiesOptions, resolveTeamOptions, resolveTheme, resolveTypedHoverOptions, resolveVersionsOptions, runDocsTests, setRenderContext, shouldLintMarkdownFile, stripMarkdownExtension, stripViteQuery, transformAllPlugins, transformGitHub, transformIslands, transformMarkdown, transformMermaidStatic, transformOgp, transformTabs, transformYouTube, typecheckCodeBlocks, useIsActive, useNav, usePageProps, useRenderContext, useSiteConfig, when, writeDocs, writeDocsTestFiles, writeSearchIndex };
 //# sourceMappingURL=index.d.mts.map