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

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[];
@@ -1098,6 +1187,86 @@ interface SsgOptions {
    * @default false
    */
   lastUpdated?: boolean;
+  /**
+   * 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>;
+  /**
+   * 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;
   /**
    * Absolute site URL used when generating social metadata.
    *
@@ -1139,6 +1308,60 @@ 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;
+};
 /**
  * Resolved SSG options.
  */
@@ -1156,10 +1379,342 @@ interface ResolvedSsgOptions {
   ogImage?: string;
   generateOgImage: boolean;
   lastUpdated: boolean;
+  pagination: boolean;
+  breadcrumbs: boolean;
+  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;
   siteUrl?: string;
   theme?: ResolvedThemeConfig;
   navigation?: SsgNavigationGroup[];
 }
+/**
+ * Opt-in custom 404 page written during SSG.
+ */
+interface NotFoundOptions {
+  /**
+   * Markdown source relative to `srcDir`.
+   * @default "404.md"
+   */
+  source?: string;
+  /**
+   * Output file relative to `outDir`.
+   * @default "404.html"
+   */
+  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.
+ */
+interface TeamOptions {
+  /**
+   * People rendered as static cards on `layout: team` pages.
+   * @default []
+   */
+  members?: TeamMember[];
+}
+/**
+ * Resolved team page options.
+ */
+interface ResolvedTeamOptions {
+  enabled: boolean;
+  members: TeamMember[];
+}
+/**
+ * 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
+   */
+  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;
+}
+/**
+ * Opt-in term list pages, per-term pages, and related-page lists.
+ */
+interface TaxonomiesOptions {
+  /**
+   * Frontmatter keys (and URL prefixes) to read terms from.
+   * @default ["tags", "categories"]
+   */
+  taxonomies?: string[];
+  /**
+   * Maximum related pages injected into a source page.
+   * @default 5
+   */
+  relatedLimit?: number;
+}
+/**
+ * Resolved taxonomy options.
+ */
+interface ResolvedTaxonomiesOptions {
+  enabled: boolean;
+  taxonomies: string[];
+  relatedLimit: number;
+}
+/** Banner shown on pages that belong to one documented version. */
+type VersionBannerKind = "unreleased" | "unmaintained";
+/**
+ * One published or snapshot version of a docs tree.
+ */
+interface VersionEntry {
+  /** Stable id used as `versions.current`. */
+  id: string;
+  /** Header label. Escaped before it is rendered. */
+  label: string;
+  /**
+   * URL prefix without slashes (`"2.90"`, `"next"`). Empty string is the
+   * site root.
+   */
+  prefix: string;
+  /**
+   * Snapshot directory relative to the Vite root. Omitted entries use the
+   * live `srcDir` and are not copied. Historical dirs are read-only.
+   */
+  dir?: string;
+  /** Optional status banner for pages in this version. */
+  banner?: VersionBannerKind | false;
+}
+/**
+ * Opt-in documentation versioning.
+ *
+ * Off by default. `true` enables a single current entry. An object enables
+ * the feature and overrides only the fields you set.
+ */
+interface VersionsOptions {
+  /** Id of the live tree being built from `srcDir`. */
+  current?: string;
+  /** Render the header version dropdown. @default true */
+  switcher?: boolean;
+  /** Show unreleased / unmaintained badges in the dropdown. @default true */
+  badge?: boolean;
+  /** Declared versions. Historical snapshots must set `dir`. */
+  entries?: VersionEntry[];
+}
+/**
+ * Resolved documentation versioning.
+ */
+interface ResolvedVersionsOptions {
+  enabled: boolean;
+  current: string;
+  switcher: boolean;
+  badge: boolean;
+  entries: ResolvedVersionEntry[];
+}
+/**
+ * One resolved version after prefix and banner sanitization.
+ */
+interface ResolvedVersionEntry {
+  id: string;
+  label: string;
+  prefix: string;
+  dir?: string;
+  banner: VersionBannerKind | false;
+}
 /**
  * Options for the core `oxContent()` Vite plugin.
  *
@@ -1173,57 +1728,157 @@ interface ResolvedSsgOptions {
  */
 interface OxContentOptions {
   /**
-   * Directory containing Markdown source files.
+   * Directory containing Markdown source files.
+   *
+   * The path is resolved from the Vite project root. SSG, search indexing, and
+   * dev-server routing all use this directory as the content root.
+   *
+   * @default 'content'
+   */
+  srcDir?: string;
+  /**
+   * Directory where generated files are written.
+   *
+   * SSG HTML, search indexes, and generated assets are emitted under this
+   * directory during production builds.
+   *
+   * @default 'dist'
+   */
+  outDir?: string;
+  /**
+   * Base path prepended to generated internal URLs.
+   *
+   * Use this when the site is deployed below a sub-path, such as GitHub Pages or
+   * a documentation route inside a larger application.
+   *
+   * @default '/'
+   */
+  base?: string;
+  /**
+   * Markdown-like file extensions to process.
+   *
+   * Extensions are normalized with a leading dot and matched case-insensitively.
+   * Add custom extensions when another authoring format is compiled to Markdown
+   * before ox-content sees it.
+   *
+   * @default ['.md', '.markdown', '.mdx']
+   */
+  extensions?: string[];
+  /**
+   * Static Site Generation options.
+   *
+   * Passing `true` or omitting this option enables SSG with defaults. Passing
+   * `false` disables the SSG plugin while still allowing Markdown module
+   * transforms to run.
+   *
+   * @default { enabled: true }
+   */
+  ssg?: SsgOptions | boolean;
+  /**
+   * Write crawl manifests next to generated HTML.
+   *
+   * Off by default. `true` writes `sitemap.xml`, `robots.txt`, and `llms.txt`.
+   * An object enables the feature and overrides only the fields you set.
+   * Requires `ssg.siteUrl`. When that is missing the build continues and a
+   * warning is emitted instead of writing files.
+   *
+   * @default false
+   */
+  siteMaps?: boolean | SiteMapsOptions;
+  /**
+   * Honor frontmatter draft / unlisted / scheduled publish states.
+   *
+   * Off by default. `true` omits drafts and future-scheduled pages from
+   * production HTML, search, and sitemaps. Unlisted pages still build and
+   * remain reachable by URL. An object enables the feature and can inject
+   * `now` for a deterministic build-time clock.
+   *
+   * @default false
+   */
+  publishState?: boolean | PublishStateOptions;
+  /**
+   * Honor frontmatter `permalink` / `slug` when resolving page URLs.
+   *
+   * Off by default. `true` or `{}` replaces the file-tree URL with
+   * `permalink`, or the last path segment with `slug`. Path escape
+   * (`../`, absolute filesystem paths, `javascript:`, protocol-relative
+   * `//`) is rejected and the file-tree URL is kept. Two pages that
+   * resolve to the same URL produce an error; the first page is kept and
+   * the later page is skipped.
+   *
+   * @default false
+   */
+  permalinks?: boolean | PermalinksOptions;
+  /**
+   * Inherit missing frontmatter keys from ancestor `_index` files.
    *
-   * The path is resolved from the Vite project root. SSG, search indexing, and
-   * dev-server routing all use this directory as the content root.
+   * Off by default. `true` or `{}` fills keys a child does not set.
+   * `permalink` and `slug` are never inherited.
    *
-   * @default 'content'
+   * @default false
    */
-  srcDir?: string;
+  cascade?: boolean | CascadeOptions;
   /**
-   * Directory where generated files are written.
+   * Write static HTML redirect pages for frontmatter aliases and a config map.
    *
-   * SSG HTML, search indexes, and generated assets are emitted under this
-   * directory during production builds.
+   * 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 'dist'
+   * @default false
    */
-  outDir?: string;
+  redirects?: boolean | RedirectsOptions | Record<string, string>;
   /**
-   * Base path prepended to generated internal URLs.
+   * Write RSS, Atom, and/or JSON Feed files from a named collection.
    *
-   * Use this when the site is deployed below a sub-path, such as GitHub Pages or
-   * a documentation route inside a larger application.
+   * 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 '/'
+   * @default false
    */
-  base?: string;
+  feeds?: boolean | FeedsOptions;
   /**
-   * Markdown-like file extensions to process.
+   * Write tag/category term pages and inject related-page lists.
    *
-   * 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.
+   * 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 ['.md', '.markdown', '.mdx']
+   * @default false
    */
-  extensions?: string[];
+  taxonomies?: boolean | TaxonomiesOptions;
   /**
-   * Static Site Generation options.
+   * Prefix live docs, emit frozen snapshot trees, and render a header
+   * version dropdown.
    *
-   * Passing `true` or omitting this option enables SSG with defaults. Passing
-   * `false` disables the SSG plugin while still allowing Markdown module
-   * transforms to run.
+   * 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 { enabled: true }
+   * @default false
    */
-  ssg?: SsgOptions | boolean;
+  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
@@ -1251,28 +1906,15 @@ interface OxContentOptions {
   autolinks?: boolean;
   /**
    * Enable syntax highlighting for code blocks.
-   * @default false
-   */
-  highlight?: boolean;
-  /**
-   * Syntax highlighting theme.
    *
-   * Defaults to `'css-variables'`, which renders token colors as `--octc-shiki-*`
-   * custom properties so highlighting follows the active color scheme in both
-   * light and dark from one build. Without a `@ox-content/theme-color-*`
-   * package installed the properties fall back to GitHub Dark. Pass any bundled
-   * Shiki theme name to opt out and bake fixed colors in instead.
+   * 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 'css-variables'
-   */
-  highlightTheme?: string | ThemeRegistration$1;
-  /**
-   * Additional languages for syntax highlighting.
-   * Accepts Shiki LanguageRegistration objects (e.g., TextMate grammars).
-   * These are loaded alongside the built-in languages.
-   * @default []
+   * @default false
    */
-  highlightLangs?: LanguageRegistration$1[];
+  highlight?: boolean;
   /**
    * Code block line annotations for fenced code blocks.
    *
@@ -1318,6 +1960,35 @@ 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;
   /**
    * Import source snippets into fences with `<<< @/path/to/file.ts{region}`.
    *
@@ -1328,6 +1999,44 @@ 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.
+   *
+   * @default false
+   */
+  fileTree?: boolean | FileTreeOptions;
   /**
    * Sanitize rendered HTML with safe defaults or explicit allow lists.
    *
@@ -1388,6 +2097,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,20 +2189,34 @@ interface ResolvedOptions {
   base: string;
   extensions: string[];
   ssg: ResolvedSsgOptions;
+  siteMaps?: ResolvedSiteMapsOptions;
+  publishState?: ResolvedPublishStateOptions;
+  permalinks?: ResolvedPermalinksOptions;
+  cascade?: ResolvedCascadeOptions;
+  redirects?: ResolvedRedirectsOptions;
+  feeds?: ResolvedFeedsOptions;
+  taxonomies?: ResolvedTaxonomiesOptions;
+  versions?: ResolvedVersionsOptions;
   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;
@@ -1492,6 +2224,7 @@ interface ResolvedOptions {
   codeBlockTypecheck: ResolvedCodeBlockTypecheckOptions;
   docsTests: ResolvedDocsTestOptions;
   mermaid: boolean;
+  math: ResolvedMathOptions;
   frontmatter: boolean;
   toc: boolean;
   tocMaxDepth: number;
@@ -1582,6 +2315,75 @@ 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 expanding Obsidian-style wiki links.
  *
@@ -1636,6 +2438,23 @@ interface ResolvedEmojiShortcodeOptions {
   enabled: boolean;
   custom: Record<string, string>;
 }
+/**
+ * Options for opt-in `$…$` / `$$…$$` math.
+ */
+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 +2508,80 @@ 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;
+}
+/**
+ * Options for opt-in `file-tree` fences.
+ */
+interface FileTreeOptions {
+  /**
+   * Enable the file-tree transform when an options object is supplied.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+}
+/**
+ * Resolved file-tree transform options.
+ */
+interface ResolvedFileTreeOptions {
+  enabled: boolean;
+}
 /**
  * Options for sanitizing rendered HTML.
  *
@@ -2706,6 +3599,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 +3653,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 +3839,18 @@ 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/environment.d.ts
 /**
  * Creates the Markdown processing environment configuration.
@@ -2928,6 +3883,11 @@ interface IncrementalMarkdownParserOptions {
    * @default true
    */
   gfm?: boolean;
+  /**
+   * Enable MDX JSX, ESM, and expression nodes.
+   * @default false
+   */
+  mdx?: boolean;
   /**
    * Enable footnotes.
    * @default true
@@ -3104,7 +4064,6 @@ declare function renderMarkdownStream(chunks: MarkdownChunkSource, options?: Inc
  *
  * const options = resolveOptions({
  *   highlight: true,
- *   highlightTheme: 'github-dark',
  *   toc: true,
  *   gfm: true,
  *   mermaid: true,
@@ -3132,6 +4091,9 @@ interface SsgTransformOptions {
 }
 declare function transformMarkdown(source: string, filePath: string, options: ResolvedOptions, ssgOptions?: SsgTransformOptions): Promise<TransformResult>;
 //#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 +4115,9 @@ interface FrameworkMarkdownOptions {
     github?: ResolvedOptions["embeds"]["github"];
     openGraph?: ResolvedOptions["embeds"]["openGraph"];
   };
+  math?: boolean | {
+    enabled?: boolean;
+  };
 }
 interface FrameworkComponentIsland {
   name: string;
@@ -3579,6 +4544,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 +4727,98 @@ 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/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/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/search.d.ts
 /**
  * Resolves search options with defaults.
@@ -3763,8 +4826,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.
  */
@@ -4073,10 +5140,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, 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 };
 //# sourceMappingURL=index.d.mts.map