@ox-content/vite-plugin 2.87.0 → 2.89.0

package/dist/index.d.cts

@@ -1,3 +1,4 @@
+import { a as JSXProps, c as jsxs, d as when, i as JSXNode, l as raw, n as JSXChild, o as each, r as JSXElementType, s as jsx, t as Fragment, u as renderToString } from "./jsx-html.cjs";
 import { EnvironmentOptions, Plugin } from "vite";
 import { LanguageRegistration, LanguageRegistration as LanguageRegistration$1, ThemeRegistration, ThemeRegistration as ThemeRegistration$1 } from "shiki";
 //#region src/theme-tokens.d.ts
@@ -567,218 +568,562 @@ interface TransformAllOptions {
  */
 declare function transformAllPlugins(html: string, options?: TransformAllOptions): Promise<string>;
 //#endregion
-//#region src/types.d.ts
+//#region src/page-context.d.ts
 /**
- * Hero section action button.
+ * Base page props available for all pages.
  */
-interface HeroAction {
-  /** Button theme: 'brand' (primary) or 'alt' (secondary) */
-  theme?: "brand" | "alt";
-  /** Button text */
-  text: string;
-  /** Link URL */
-  link: string;
+interface BasePageProps {
+  /** Page title from frontmatter or first heading */
+  title: string;
+  /** Page description from frontmatter */
+  description?: string;
+  /** Rendered HTML content */
+  html: string;
+  /** Table of contents entries */
+  toc: TocEntry[];
+  /** Last git commit timestamp in milliseconds */
+  lastUpdated?: number;
+  /** Source file path (relative to docs root) */
+  path: string;
+  /** Output URL path */
+  url: string;
+  /** Raw frontmatter object */
+  frontmatter: Record<string, unknown>;
+  /** Layout name from frontmatter */
+  layout?: string;
 }
 /**
- * Hero section image configuration.
+ * Extended page props with custom frontmatter.
  */
-interface HeroImage {
-  /** Image source URL */
-  src: string;
-  /** Light mode image source URL */
-  lightSrc?: string;
-  /** Dark mode image source URL */
-  darkSrc?: string;
-  /** Alt text */
-  alt?: string;
-  /** Image width */
-  width?: number;
-  /** Image height */
-  height?: number;
-}
+type PageProps<T extends Record<string, unknown> = Record<string, unknown>> = BasePageProps & {
+  /** Custom frontmatter fields */
+  frontmatter: T & Record<string, unknown>;
+};
 /**
- * Hero notice configuration.
+ * Site-wide configuration available in context.
  */
-interface HeroNotice {
-  /** Notice title */
-  title?: string;
-  /** Notice paragraphs */
-  body?: string[];
+interface SiteConfig {
+  /** Site name */
+  name: string;
+  /** Base URL path */
+  base: string;
+  /** All pages in the site */
+  pages: BasePageProps[];
+  /** Navigation groups */
+  nav: NavGroup[];
 }
 /**
- * Hero section configuration for entry page.
+ * Navigation group.
  */
-interface HeroConfig {
-  /** Main title (large, gradient text) */
-  name?: string;
-  /** Secondary text (medium size) */
-  text?: string;
-  /** Tagline (smaller, muted) */
-  tagline?: string;
-  /** Notice shown near the top of the hero */
-  notice?: HeroNotice;
-  /** Hero image */
-  image?: HeroImage;
-  /** Action buttons */
-  actions?: HeroAction[];
+interface NavGroup {
+  title: string;
+  items: NavItem[];
 }
 /**
- * Feature card for entry page.
+ * Navigation item.
  */
-interface FeatureConfig {
-  /** Icon - supports: "mdi:icon-name" (Iconify), image URL, or emoji */
-  icon?: string;
-  /** Feature title */
+interface NavItem {
   title: string;
-  /** Feature description */
-  details?: string;
-  /** Optional link */
-  link?: string;
-  /** Link text */
-  linkText?: string;
+  path: string;
+  href: string;
 }
 /**
- * Entry page frontmatter configuration.
+ * Complete render context.
  */
-interface EntryPageConfig {
-  /** Layout type - set to 'entry' for entry page */
-  layout: "entry";
-  /** Hero section */
-  hero?: HeroConfig;
-  /** Feature cards */
-  features?: FeatureConfig[];
+interface RenderContext<T extends Record<string, unknown> = Record<string, unknown>> {
+  /** Current page props */
+  page: PageProps<T>;
+  /** Site configuration */
+  site: SiteConfig;
 }
 /**
- * Navigation item for SSG sidebar rendering.
+ * Sets the current render context.
+ * Called internally during page rendering.
+ * @internal
  */
-interface SsgNavigationItem {
-  /** Display title */
-  title: string;
-  /**
-   * Route path used for active-state matching.
-   * Internal links should use site-relative paths such as `/getting-started`.
-   */
-  path?: string;
-  /**
-   * Final href used in the rendered HTML.
-   * When omitted for internal links, ox-content derives it from `path`.
-   */
-  href?: string;
-}
+declare function setRenderContext(ctx: RenderContext): void;
 /**
- * Navigation group for SSG sidebar rendering.
+ * Clears the current render context.
+ * Called internally after page rendering.
+ * @internal
  */
-interface SsgNavigationGroup {
-  /** Group heading */
-  title: string;
-  /** Navigation items within this group */
-  items: SsgNavigationItem[];
-}
+declare function clearRenderContext(): void;
 /**
- * Static Site Generation options.
+ * Gets the current page props.
  *
- * These options control the HTML files emitted at build time and the matching
- * dev-server preview behavior. Pass `false` to the top-level `ssg` option to
- * disable the whole SSG pipeline, or pass an object to customize the defaults.
+ * @returns The current page props
+ * @throws Error if called outside of a render context
+ *
+ * @example
+ * ```tsx
+ * function PageTitle() {
+ *   const page = usePageProps();
+ *   return <h1>{page.title}</h1>;
+ * }
+ * ```
  */
-interface SsgOptions {
-  /**
-   * Enable the SSG pipeline.
-   *
-   * Keep this enabled when ox-content owns page rendering. Disable it only when
-   * another framework integration will consume the Markdown modules directly.
-   *
-   * @default true
-   */
-  enabled?: boolean;
-  /**
-   * File extension used for generated routes.
-   *
-   * The value should include the leading dot. For example, `.html` emits
-   * `guide.html`, while an empty string can be used by custom deployments that
-   * map extensionless output themselves.
-   *
-   * @default '.html'
-   */
-  extension?: string;
-  /**
-   * Remove previously generated files from the output directory before writing
-   * the new SSG result.
-   *
-   * Leave this disabled when the output directory also contains assets produced
-   * by other Vite plugins or external build steps.
-   *
-   * @default false
-   */
-  clean?: boolean;
-  /**
-   * Emit bare HTML with only the rendered Markdown body.
-   *
-   * This skips the default navigation, layout shell, and theme styles. It is
-   * mainly useful for benchmarking, fixture generation, or projects that wrap
-   * the output in their own shell.
-   *
-   * @default false
-   */
-  bare?: boolean;
-  /**
-   * Site name shown in the default theme header and title suffix.
-   *
-   * When omitted, the renderer falls back to project metadata where available.
-   *
-   * @default undefined
-   */
-  siteName?: string;
-  /**
-   * Static Open Graph image URL used for social sharing.
-   *
-   * When `generateOgImage` is enabled, this value is still useful as a fallback
-   * for pages that cannot produce a generated image.
-   *
-   * @default undefined
-   */
-  ogImage?: string;
-  /**
-   * Generate one Open Graph image per page.
-   *
-   * Generated images are written alongside the SSG output and referenced from
-   * each page's metadata. Configure rendering details with the top-level
-   * `ogImageOptions` option.
-   *
-   * @default false
-   */
-  generateOgImage?: boolean;
-  /**
-   * Add each page's last git commit timestamp to the default theme.
-   * @default false
-   */
-  lastUpdated?: boolean;
-  /**
-   * Absolute site URL used when generating social metadata.
-   *
-   * Set this when pages need absolute Open Graph image URLs. Include the origin
-   * and any deployment base path, without a trailing page path.
-   *
-   * @example
-   * ```ts
-   * siteUrl: 'https://example.com/docs'
-   * ```
-   *
-   * @default undefined
-   */
-  siteUrl?: string;
-  /**
-   * Theme configuration for generated pages.
-   *
-   * Use `defineTheme()` to build this object so custom theme modules and the
-   * default theme extension points keep their expected shape.
-   *
-   * An array composes layers left to right, which is how a skin package and a
-   * color package are combined:
-   *
-   * ```ts
-   * theme: [pixelSkin, tokyoNight, { footer: { copyright: "2026" } }]
-   * ```
+declare function usePageProps<T extends Record<string, unknown> = Record<string, unknown>>(): PageProps<T>;
+/**
+ * Gets the site configuration.
+ *
+ * @returns The site configuration
+ * @throws Error if called outside of a render context
+ *
+ * @example
+ * ```tsx
+ * function SiteHeader() {
+ *   const site = useSiteConfig();
+ *   return <header>{site.name}</header>;
+ * }
+ * ```
+ */
+declare function useSiteConfig(): SiteConfig;
+/**
+ * Gets the full render context.
+ *
+ * @returns The complete render context
+ * @throws Error if called outside of a render context
+ *
+ * @example
+ * ```tsx
+ * function Layout({ children }) {
+ *   const ctx = useRenderContext();
+ *   return (
+ *     <html>
+ *       <head><title>{ctx.page.title} - {ctx.site.name}</title></head>
+ *       <body>{children}</body>
+ *     </html>
+ *   );
+ * }
+ * ```
+ */
+declare function useRenderContext<T extends Record<string, unknown> = Record<string, unknown>>(): RenderContext<T>;
+/**
+ * Gets the navigation groups.
+ *
+ * @example
+ * ```tsx
+ * function Sidebar() {
+ *   const nav = useNav();
+ *   return (
+ *     <nav>
+ *       {each(nav, (group) => (
+ *         <div>
+ *           <h3>{group.title}</h3>
+ *           <ul>
+ *             {each(group.items, (item) => (
+ *               <li><a href={item.href}>{item.title}</a></li>
+ *             ))}
+ *           </ul>
+ *         </div>
+ *       ))}
+ *     </nav>
+ *   );
+ * }
+ * ```
+ */
+declare function useNav(): NavGroup[];
+/**
+ * Checks if the given path is the current page.
+ *
+ * @example
+ * ```tsx
+ * function NavLink({ href, children }) {
+ *   const isActive = useIsActive(href);
+ *   return <a href={href} class={isActive ? 'active' : ''}>{children}</a>;
+ * }
+ * ```
+ */
+declare function useIsActive(path: string): boolean;
+/**
+ * Schema for frontmatter type generation.
+ */
+interface FrontmatterSchema {
+  /** Field name */
+  name: string;
+  /** TypeScript type */
+  type: string;
+  /** Whether the field is optional */
+  optional: boolean;
+  /** JSDoc description */
+  description?: string;
+}
+/**
+ * Infers TypeScript types from frontmatter values.
+ */
+declare function inferType(value: unknown): string;
+/**
+ * Generates TypeScript interface from frontmatter samples.
+ */
+declare function generateFrontmatterTypes(samples: Record<string, unknown>[], interfaceName?: string): string;
+//#endregion
+//#region src/theme-renderer.d.ts
+/**
+ * Theme component type.
+ */
+type ThemeComponent = (props: ThemeProps) => JSXNode;
+/**
+ * Props passed to the theme component.
+ */
+interface ThemeProps {
+  /** Rendered page content as JSX */
+  children: JSXNode;
+}
+/**
+ * Page data for rendering.
+ */
+interface PageData {
+  /** Page title */
+  title: string;
+  /** Page description */
+  description?: string;
+  /** Rendered HTML content */
+  html: string;
+  /** Table of contents */
+  toc: TocEntry[];
+  /** Last git commit timestamp in milliseconds */
+  lastUpdated?: number;
+  /** Source file path */
+  path: string;
+  /** Output URL path */
+  url: string;
+  /** Frontmatter */
+  frontmatter: Record<string, unknown>;
+  /** Layout name */
+  layout?: string;
+}
+/**
+ * Theme render options.
+ */
+interface ThemeRenderOptions {
+  /** Theme component to use */
+  theme: ThemeComponent;
+  /** Site name */
+  siteName: string;
+  /** Base URL path */
+  base: string;
+  /** Navigation groups */
+  nav: NavGroup[];
+  /** All pages (for site context) */
+  pages: PageData[];
+  /** Output directory for type definitions */
+  typesOutDir?: string;
+}
+/**
+ * Renders a page using the theme component.
+ *
+ * @param page - Page data to render
+ * @param options - Theme render options
+ * @returns Rendered HTML string
+ */
+declare function renderPage(page: PageData, options: ThemeRenderOptions): string;
+/**
+ * Renders all pages and generates type definitions.
+ *
+ * @param pages - All pages to render
+ * @param options - Theme render options
+ * @returns Map of output paths to rendered HTML
+ */
+declare function renderAllPages(pages: PageData[], options: ThemeRenderOptions): Promise<Map<string, string>>;
+/**
+ * Generates TypeScript type definitions from page frontmatter.
+ *
+ * @param pages - All pages
+ * @param outDir - Output directory for types
+ */
+declare function generateTypes(pages: PageData[], outDir: string): Promise<void>;
+/**
+ * Default theme component.
+ * A minimal theme that renders page content with basic styling.
+ */
+declare function DefaultTheme({ children }: ThemeProps): JSXNode;
+/**
+ * Creates a theme with layout switching support.
+ *
+ * @example
+ * ```tsx
+ * import { createTheme } from '@ox-content/vite-plugin';
+ * import { DefaultLayout } from './layouts/Default';
+ * import { EntryLayout } from './layouts/Entry';
+ *
+ * export default createTheme({
+ *   layouts: {
+ *     default: DefaultLayout,
+ *     entry: EntryLayout,
+ *   },
+ * });
+ * ```
+ */
+declare function createTheme(config: {
+  layouts: Record<string, ThemeComponent>;
+  defaultLayout?: string;
+}): ThemeComponent;
+//#endregion
+//#region src/types.d.ts
+/**
+ * Hero section action button.
+ */
+interface HeroAction {
+  /** Button theme: 'brand' (primary) or 'alt' (secondary) */
+  theme?: "brand" | "alt";
+  /** Button text */
+  text: string;
+  /** Link URL */
+  link: string;
+}
+/**
+ * Hero section image configuration.
+ */
+interface HeroImage {
+  /** Image source URL */
+  src: string;
+  /** Light mode image source URL */
+  lightSrc?: string;
+  /** Dark mode image source URL */
+  darkSrc?: string;
+  /** Alt text */
+  alt?: string;
+  /** Image width */
+  width?: number;
+  /** Image height */
+  height?: number;
+}
+/**
+ * Hero notice configuration.
+ */
+interface HeroNotice {
+  /** Notice title */
+  title?: string;
+  /** Notice paragraphs */
+  body?: string[];
+}
+/**
+ * Hero section configuration for entry page.
+ */
+interface HeroConfig {
+  /** Main title (large, gradient text) */
+  name?: string;
+  /** Secondary text (medium size) */
+  text?: string;
+  /** Tagline (smaller, muted) */
+  tagline?: string;
+  /** Notice shown near the top of the hero */
+  notice?: HeroNotice;
+  /** Hero image */
+  image?: HeroImage;
+  /** Action buttons */
+  actions?: HeroAction[];
+}
+/**
+ * Feature card for entry page.
+ */
+interface FeatureConfig {
+  /** Icon - supports: "mdi:icon-name" (Iconify), image URL, or emoji */
+  icon?: string;
+  /** Feature title */
+  title: string;
+  /** Feature description */
+  details?: string;
+  /** Optional link */
+  link?: string;
+  /** Link text */
+  linkText?: string;
+}
+/**
+ * Entry page frontmatter configuration.
+ */
+interface EntryPageConfig {
+  /** Layout type - set to 'entry' for entry page */
+  layout: "entry";
+  /** Hero section */
+  hero?: HeroConfig;
+  /** Feature cards */
+  features?: FeatureConfig[];
+}
+/**
+ * Navigation item for SSG sidebar rendering.
+ */
+interface SsgNavigationItem {
+  /** Display title */
+  title: string;
+  /**
+   * Route path used for active-state matching.
+   * Internal links should use site-relative paths such as `/getting-started`.
+   */
+  path?: string;
+  /**
+   * Final href used in the rendered HTML.
+   * When omitted for internal links, ox-content derives it from `path`.
+   */
+  href?: string;
+}
+/**
+ * Navigation group for SSG sidebar rendering.
+ */
+interface SsgNavigationGroup {
+  /** Group heading */
+  title: string;
+  /** Navigation items within this group */
+  items: SsgNavigationItem[];
+}
+/**
+ * Static Site Generation options.
+ *
+ * These options control the HTML files emitted at build time and the matching
+ * dev-server preview behavior. Pass `false` to the top-level `ssg` option to
+ * disable the whole SSG pipeline, or pass an object to customize the defaults.
+ */
+interface SsgOptions {
+  /**
+   * Enable the SSG pipeline.
+   *
+   * Keep this enabled when ox-content owns page rendering. Disable it only when
+   * another framework integration will consume the Markdown modules directly.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * File extension used for generated routes.
+   *
+   * The value should include the leading dot. For example, `.html` emits
+   * `guide.html`, while an empty string can be used by custom deployments that
+   * map extensionless output themselves.
+   *
+   * @default '.html'
+   */
+  extension?: string;
+  /**
+   * Remove previously generated files from the output directory before writing
+   * the new SSG result.
+   *
+   * Leave this disabled when the output directory also contains assets produced
+   * by other Vite plugins or external build steps.
+   *
+   * @default false
+   */
+  clean?: boolean;
+  /**
+   * Emit bare HTML with only the rendered Markdown body.
+   *
+   * This skips the default navigation, layout shell, and theme styles. It is
+   * mainly useful for benchmarking, fixture generation, or projects that wrap
+   * the output in their own shell.
+   *
+   * @default false
+   */
+  bare?: boolean;
+  /**
+   * Site name shown in the default theme header and title suffix.
+   *
+   * When omitted, the renderer falls back to project metadata where available.
+   *
+   * @default undefined
+   */
+  siteName?: string;
+  /**
+   * Static Open Graph image URL used for social sharing.
+   *
+   * When `generateOgImage` is enabled, this value is still useful as a fallback
+   * for pages that cannot produce a generated image.
+   *
+   * @default undefined
+   */
+  ogImage?: string;
+  /**
+   * Render each page with a JSX theme component instead of the built-in
+   * renderer.
+   *
+   * The component owns the whole document, so `theme`, `bare` and the head
+   * metadata options do not apply — everything from `<html>` down is yours.
+   * Compose one per layout with `createTheme()`, and read the current page
+   * through `usePageProps()` / `useSiteConfig()`.
+   *
+   * ```ts
+   * ssg: { render: createTheme({ layouts: { default: DefaultLayout } }) }
+   * ```
+   *
+   * @default undefined
+   */
+  render?: ThemeComponent;
+  /**
+   * `lang` attribute for the generated `<html>` element.
+   *
+   * Bare mode uses this verbatim; themed pages derive it from `i18n` instead.
+   *
+   * @default "en"
+   */
+  lang?: string;
+  /**
+   * Raw markup appended to `<head>`.
+   *
+   * Bare mode only — themed pages own their head. Use it for the stylesheet
+   * your own build emits, or any tag the plugin does not generate.
+   *
+   * @default undefined
+   */
+  head?: string;
+  /**
+   * Raw markup inserted directly after `<body>`.
+   *
+   * Bare mode only. Use it for a site header that wraps the rendered page.
+   *
+   * @default undefined
+   */
+  bodyStart?: string;
+  /**
+   * Raw markup inserted directly before `</body>`.
+   *
+   * Bare mode only. Use it for a site footer, or scripts you inject yourself.
+   *
+   * @default undefined
+   */
+  bodyEnd?: string;
+  /**
+   * Generate one Open Graph image per page.
+   *
+   * Generated images are written alongside the SSG output and referenced from
+   * each page's metadata. Configure rendering details with the top-level
+   * `ogImageOptions` option.
+   *
+   * Under `bare`, the images are still written but nothing references them,
+   * because bare output has no `<head>` to put the `<meta>` tags in — inject
+   * them from your own shell.
+   *
+   * @default false
+   */
+  generateOgImage?: boolean;
+  /**
+   * Add each page's last git commit timestamp to the default theme.
+   * @default false
+   */
+  lastUpdated?: boolean;
+  /**
+   * Absolute site URL used when generating social metadata.
+   *
+   * Set this when pages need absolute Open Graph image URLs. Include the origin
+   * and any deployment base path, without a trailing page path.
+   *
+   * @example
+   * ```ts
+   * siteUrl: 'https://example.com/docs'
+   * ```
+   *
+   * @default undefined
+   */
+  siteUrl?: string;
+  /**
+   * Theme configuration for generated pages.
+   *
+   * Use `defineTheme()` to build this object so custom theme modules and the
+   * default theme extension points keep their expected shape.
+   *
+   * An array composes layers left to right, which is how a skin package and a
+   * color package are combined:
+   *
+   * ```ts
+   * theme: [pixelSkin, tokyoNight, { footer: { copyright: "2026" } }]
+   * ```
    *
    * @default defaultTheme
    */
@@ -802,6 +1147,11 @@ interface ResolvedSsgOptions {
   extension: string;
   clean: boolean;
   bare: boolean;
+  render?: ThemeComponent;
+  lang?: string;
+  head?: string;
+  bodyStart?: string;
+  bodyEnd?: string;
   siteName?: string;
   ogImage?: string;
   generateOgImage: boolean;
@@ -3135,754 +3485,378 @@ interface MarkdownLintStandardDictionaryOptions {
    *
    * @default new URL(".", import.meta.url)
    */
-  resolveImportsRelativeTo?: string | URL;
-}
-/**
- * Additional dictionary configuration for the Markdown linter.
- */
-interface MarkdownLintDictionaryOptions {
-  /**
-   * Words ignored across all configured languages.
-   * @default []
-   */
-  words?: string[];
-  /**
-   * Extra words to allow per language.
-   * @default {}
-   */
-  byLanguage?: Partial<Record<MarkdownLintLanguage, string[]>>;
-  /**
-   * Words that should never produce diagnostics.
-   * @default []
-   */
-  ignoredWords?: string[];
-  /**
-   * Opt-in standard dictionary datasets.
-   *
-   * By default the linter stays on a minimal built-in dictionary. Enable this
-   * to load larger locale dictionaries from a standard external source.
-   * @default false
-   */
-  standard?: MarkdownLintStandardDictionaryOptions | false;
-}
-/**
- * Rule switches for Markdown linting.
- */
-interface MarkdownLintRuleOptions {
-  /**
-   * Report headings that repeat the same visible text.
-   * @default true
-   */
-  duplicateHeadings?: boolean;
-  /**
-   * Report heading depth jumps such as `#` -> `###`.
-   * @default true
-   */
-  headingIncrement?: boolean;
-  /**
-   * Maximum number of blank lines allowed in a row.
-   * @default 1
-   */
-  maxConsecutiveBlankLines?: number;
-  /**
-   * Report duplicated terminal punctuation such as `!!` or `？？`.
-   * @default true
-   */
-  repeatedPunctuation?: boolean;
-  /**
-   * Report adjacent repeated words in visible prose.
-   * @default true
-   */
-  repeatedWords?: boolean;
-  /**
-   * Enable built-in multilingual spellchecking.
-   * @default true
-   */
-  spellcheck?: boolean;
-  /**
-   * Report trailing spaces.
-   * @default true
-   */
-  trailingSpaces?: boolean;
-}
-/**
- * Options for linting Markdown documents.
- */
-interface MarkdownLintOptions {
-  /**
-   * Languages enabled for spellchecking.
-   *
-   * When `dictionary.standard.languages` is provided and this option is
-   * omitted, those languages are used instead.
-   *
-   * @default ['en']
-   */
-  languages?: MarkdownLintLanguage[];
-  /**
-   * Rule configuration.
-   * Omitted fields use `MarkdownLintRuleOptions` defaults.
-   * @default {}
-   */
-  rules?: MarkdownLintRuleOptions;
-  /**
-   * Built-in and opt-in standard dictionary overrides.
-   * @default {}
-   */
-  dictionary?: MarkdownLintDictionaryOptions;
-}
-/**
- * A single Markdown lint diagnostic.
- */
-interface MarkdownLintDiagnostic {
-  /**
-   * Stable rule identifier.
-   */
-  ruleId: string;
-  /**
-   * Diagnostic severity.
-   */
-  severity: MarkdownLintSeverity;
-  /**
-   * Human-readable explanation.
-   */
-  message: string;
-  /**
-   * 1-indexed line number.
-   */
-  line: number;
-  /**
-   * 1-indexed start column.
-   */
-  column: number;
-  /**
-   * 1-indexed end line.
-   */
-  endLine: number;
-  /**
-   * 1-indexed end column.
-   */
-  endColumn: number;
-  /**
-   * Language used for spellchecking, when relevant.
-   */
-  language?: MarkdownLintLanguage;
-  /**
-   * Suggested replacements, when available.
-   */
-  suggestions?: string[];
+  resolveImportsRelativeTo?: string | URL;
 }
 /**
- * Markdown lint report.
+ * Additional dictionary configuration for the Markdown linter.
  */
-interface MarkdownLintResult {
+interface MarkdownLintDictionaryOptions {
   /**
-   * All collected diagnostics.
+   * Words ignored across all configured languages.
+   * @default []
    */
-  diagnostics: MarkdownLintDiagnostic[];
+  words?: string[];
   /**
-   * Number of error diagnostics.
+   * Extra words to allow per language.
+   * @default {}
    */
-  errorCount: number;
+  byLanguage?: Partial<Record<MarkdownLintLanguage, string[]>>;
   /**
-   * Number of warning diagnostics.
+   * Words that should never produce diagnostics.
+   * @default []
    */
-  warningCount: number;
+  ignoredWords?: string[];
   /**
-   * Number of info diagnostics.
+   * Opt-in standard dictionary datasets.
+   *
+   * By default the linter stays on a minimal built-in dictionary. Enable this
+   * to load larger locale dictionaries from a standard external source.
+   * @default false
    */
-  infoCount: number;
+  standard?: MarkdownLintStandardDictionaryOptions | false;
 }
 /**
- * Lints Markdown prose with the Rust-backed built-in rule engine.
- */
-declare function lintMarkdown(source: string, options?: MarkdownLintOptions): MarkdownLintResult;
-/**
- * Async Markdown linter that supports opt-in standard dictionaries.
- */
-declare function lintMarkdownAsync(source: string, options?: MarkdownLintOptions): Promise<MarkdownLintResult>;
-//#endregion
-//#region src/lint-files.d.ts
-/**
- * File-oriented Markdown lint options for end-user configuration.
- *
- * This extends the content-level lint options with project-level targeting,
- * so consumers can decide which files should be checked and which paths should
- * be ignored.
+ * Rule switches for Markdown linting.
  */
-interface MarkdownLintFileOptions extends MarkdownLintOptions {
+interface MarkdownLintRuleOptions {
   /**
-   * Base directory used to resolve `include` and `exclude` patterns.
-   * @default process.cwd()
+   * Report headings that repeat the same visible text.
+   * @default true
    */
-  cwd?: string;
+  duplicateHeadings?: boolean;
   /**
-   * Glob patterns for files to lint.
-   * @default ['**\/*.md', '**\/*.markdown', '**\/*.mdx']
+   * Report heading depth jumps such as `#` -> `###`.
+   * @default true
    */
-  include?: string[];
+  headingIncrement?: boolean;
   /**
-   * Glob patterns for files to exclude from linting.
-   * @default ['**\/node_modules/**', '**\/.git/**', '**\/dist/**']
+   * Maximum number of blank lines allowed in a row.
+   * @default 1
    */
-  exclude?: string[];
+  maxConsecutiveBlankLines?: number;
   /**
-   * Alias of `exclude`.
-   * When omitted, only `exclude` is used.
-   * @default undefined
+   * Report duplicated terminal punctuation such as `!!` or `？？`.
+   * @default true
    */
-  ignore?: string[];
-}
-/**
- * A lint diagnostic annotated with file metadata.
- */
-interface MarkdownLintFileDiagnostic extends MarkdownLintDiagnostic {
-  filePath: string;
-  relativePath: string;
-}
-/**
- * Lint result for a single file.
- */
-interface MarkdownLintFileResult extends MarkdownLintResult {
-  filePath: string;
-  relativePath: string;
-  skipped: boolean;
-}
-/**
- * Aggregated lint result for multiple files.
- */
-interface MarkdownLintFilesResult {
-  checkedFileCount: number;
-  diagnostics: MarkdownLintFileDiagnostic[];
-  errorCount: number;
-  files: MarkdownLintFileResult[];
-  infoCount: number;
-  warningCount: number;
-}
-/**
- * Returns true if the file path is included by the configured glob filters.
- */
-declare function shouldLintMarkdownFile(filePath: string, options?: MarkdownLintFileOptions): boolean;
-/**
- * Lints a single Markdown file using project-style include/exclude settings.
- *
- * If the file is filtered out by `include` / `exclude`, the returned result is
- * marked as `skipped` and contains no diagnostics.
- */
-declare function lintMarkdownFile(filePath: string, options?: MarkdownLintFileOptions): Promise<MarkdownLintFileResult>;
-/**
- * Lints all Markdown files matched by the configured include/exclude patterns.
- */
-declare function lintMarkdownFiles(options?: MarkdownLintFileOptions): Promise<MarkdownLintFilesResult>;
-//#endregion
-//#region src/ssg.d.ts
-/**
- * Deprecated compatibility export for consumers that imported the former
- * TypeScript SSG template. HTML generation is Rust-backed now.
- *
- * @deprecated Use `generateHtmlPage`/`buildSsg` instead.
- */
-declare const DEFAULT_HTML_TEMPLATE = "<!-- ox-content default HTML template is Rust-backed -->";
-/**
- * Resolves SSG options with defaults.
- */
-declare function resolveSsgOptions(ssg: SsgOptions | boolean | undefined): ResolvedSsgOptions;
-/**
- * Builds all markdown files to static HTML.
- */
-declare function buildSsg(options: ResolvedOptions, root: string): Promise<{
-  files: string[];
-  errors: string[];
-}>;
-//#endregion
-//#region src/search.d.ts
-/**
- * Resolves search options with defaults.
- */
-declare function resolveSearchOptions(options: SearchOptions | boolean | undefined): ResolvedSearchOptions;
-/**
- * Builds the search index from Markdown files.
- */
-declare function buildSearchIndex(srcDir: string, base: string, extensions?: readonly string[]): Promise<string>;
-/**
- * Writes the search index to a file.
- */
-declare function writeSearchIndex(indexJson: string, outDir: string): Promise<void>;
-//#endregion
-//#region src/collections.d.ts
-declare function defineCollection<T extends CollectionOptions>(collection: T): T;
-declare function defineCollections<T extends CollectionsOptions>(collections: T): T;
-declare function resolveCollectionsOptions(options: CollectionsOptions | boolean | undefined): ResolvedCollectionsOptions;
-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;
-  dark?: string;
-  src?: string;
-  alt?: string;
-}
-interface VitePressSocialLink {
-  icon: string;
-  link: string;
-  ariaLabel?: string;
-}
-interface VitePressFooter {
-  message?: string;
-  copyright?: string;
-}
-interface VitePressSidebarItem {
-  text?: string;
-  link?: string;
-  items?: VitePressSidebarItem[];
-  collapsed?: boolean;
-}
-type VitePressSidebar = VitePressSidebarItem[] | Record<string, VitePressSidebarItem[]>;
-interface VitePressNavItem {
-  text?: string;
-  link?: string;
-  items?: VitePressNavItem[];
-  activeMatch?: string;
-}
-interface VitePressThemeConfig {
-  siteTitle?: string | false;
-  logo?: string | VitePressLogo;
-  nav?: VitePressNavItem[];
-  sidebar?: VitePressSidebar;
-  socialLinks?: VitePressSocialLink[];
-  footer?: VitePressFooter;
-  search?: {
-    placeholder?: string;
-  };
-}
-interface VitePressConfig {
-  title?: string;
-  description?: string;
-  base?: string;
-  themeConfig?: VitePressThemeConfig;
-}
-interface GenerateVitePressMigrationConfigOptions {
-  importSource?: string;
-}
-/**
- * Converts a VitePress sidebar config into ox-content navigation groups.
- * Nested VitePress items are flattened into the nearest ox-content group.
- */
-declare function convertVitePressSidebar(sidebar: VitePressSidebar): SsgNavigationGroup[];
-/**
- * Converts VitePress top navigation into ox-content sidebar groups.
- * This is used as a fallback when no explicit sidebar is defined.
- */
-declare function convertVitePressNav(nav: VitePressNavItem[]): SsgNavigationGroup[];
-/**
- * Creates ox-content plugin options from an existing VitePress config.
- */
-declare function fromVitePressConfig(config: VitePressConfig, overrides?: OxContentOptions): OxContentOptions;
-/**
- * Generates a TypeScript module exporting migrated ox-content options.
- *
- * This is used by the migration CLI so users can inspect and edit the resulting
- * object instead of keeping a runtime dependency on their VitePress config.
- */
-declare function generateVitePressMigrationConfig(config: VitePressConfig, overrides?: OxContentOptions, options?: GenerateVitePressMigrationConfigOptions): string;
-/**
- * Normalizes VitePress-specific frontmatter into ox-content's entry-page shape.
- */
-declare function normalizeVitePressFrontmatter(frontmatter: Record<string, unknown>): Record<string, unknown>;
-//#endregion
-//#region src/jsx-runtime.d.ts
-/**
- * Custom JSX Runtime for Static HTML Generation
- *
- * This module provides a JSX runtime that outputs static HTML strings.
- * No React, no hydration, no client-side JavaScript - just pure HTML.
- *
- * @example
- * ```tsx
- * // tsconfig.json or vite.config.ts
- * {
- *   "compilerOptions": {
- *     "jsx": "react-jsx",
- *     "jsxImportSource": "@ox-content/vite-plugin"
- *   }
- * }
- *
- * // MyComponent.tsx
- * export function Hero({ title }: { title: string }) {
- *   return (
- *     <section class="hero">
- *       <h1>{title}</h1>
- *     </section>
- *   );
- * }
- * ```
- */
-/**
- * JSX element type - either a string (intrinsic) or a function component.
- */
-type JSXElementType = string | ((props: Record<string, unknown>) => JSXNode);
-/**
- * Valid JSX child types.
- */
-type JSXChild = string | number | boolean | null | undefined | JSXNode | JSXChild[];
-/**
- * JSX node - the result of JSX expressions.
- */
-interface JSXNode {
-  __html: string;
+  repeatedPunctuation?: boolean;
+  /**
+   * Report adjacent repeated words in visible prose.
+   * @default true
+   */
+  repeatedWords?: boolean;
+  /**
+   * Enable built-in multilingual spellchecking.
+   * @default true
+   */
+  spellcheck?: boolean;
+  /**
+   * Report trailing spaces.
+   * @default true
+   */
+  trailingSpaces?: boolean;
 }
 /**
- * Props with children.
+ * Options for linting Markdown documents.
  */
-interface JSXProps {
-  children?: JSXChild;
-  [key: string]: unknown;
+interface MarkdownLintOptions {
+  /**
+   * Languages enabled for spellchecking.
+   *
+   * When `dictionary.standard.languages` is provided and this option is
+   * omitted, those languages are used instead.
+   *
+   * @default ['en']
+   */
+  languages?: MarkdownLintLanguage[];
+  /**
+   * Rule configuration.
+   * Omitted fields use `MarkdownLintRuleOptions` defaults.
+   * @default {}
+   */
+  rules?: MarkdownLintRuleOptions;
+  /**
+   * Built-in and opt-in standard dictionary overrides.
+   * @default {}
+   */
+  dictionary?: MarkdownLintDictionaryOptions;
 }
 /**
- * Creates a JSX element.
- * This is the core function called by the JSX transform.
- */
-declare function jsx(type: JSXElementType, props: JSXProps, _key?: string): JSXNode;
-/**
- * Creates a JSX element with static children.
- * Called by the JSX transform for elements with multiple children.
- */
-declare function jsxs(type: JSXElementType, props: JSXProps, key?: string): JSXNode;
-/**
- * Fragment component - renders children without a wrapper element.
- */
-declare function Fragment({ children }: {
-  children?: JSXChild;
-}): JSXNode;
-/**
- * Renders a JSX node to an HTML string.
- */
-declare function renderToString(node: JSXNode): string;
-/**
- * Creates raw HTML without escaping.
- * Use with caution - only for trusted content.
- *
- * @example
- * ```tsx
- * <div>{raw('<strong>Bold</strong>')}</div>
- * ```
- */
-declare function raw(html: string): JSXNode;
-/**
- * Conditionally renders content.
- *
- * @example
- * ```tsx
- * {when(isLoggedIn, <UserMenu />)}
- * ```
- */
-declare function when(condition: boolean, content: JSXNode): JSXNode;
-/**
- * Maps over an array and renders each item.
- *
- * @example
- * ```tsx
- * {each(items, (item) => <li>{item.name}</li>)}
- * ```
+ * A single Markdown lint diagnostic.
  */
-declare function each<T>(items: T[], render: (item: T, index: number) => JSXNode): JSXNode;
-//#endregion
-//#region src/page-context.d.ts
+interface MarkdownLintDiagnostic {
+  /**
+   * Stable rule identifier.
+   */
+  ruleId: string;
+  /**
+   * Diagnostic severity.
+   */
+  severity: MarkdownLintSeverity;
+  /**
+   * Human-readable explanation.
+   */
+  message: string;
+  /**
+   * 1-indexed line number.
+   */
+  line: number;
+  /**
+   * 1-indexed start column.
+   */
+  column: number;
+  /**
+   * 1-indexed end line.
+   */
+  endLine: number;
+  /**
+   * 1-indexed end column.
+   */
+  endColumn: number;
+  /**
+   * Language used for spellchecking, when relevant.
+   */
+  language?: MarkdownLintLanguage;
+  /**
+   * Suggested replacements, when available.
+   */
+  suggestions?: string[];
+}
 /**
- * Base page props available for all pages.
+ * Markdown lint report.
  */
-interface BasePageProps {
-  /** Page title from frontmatter or first heading */
-  title: string;
-  /** Page description from frontmatter */
-  description?: string;
-  /** Rendered HTML content */
-  html: string;
-  /** Table of contents entries */
-  toc: TocEntry[];
-  /** Last git commit timestamp in milliseconds */
-  lastUpdated?: number;
-  /** Source file path (relative to docs root) */
-  path: string;
-  /** Output URL path */
-  url: string;
-  /** Raw frontmatter object */
-  frontmatter: Record<string, unknown>;
-  /** Layout name from frontmatter */
-  layout?: string;
+interface MarkdownLintResult {
+  /**
+   * All collected diagnostics.
+   */
+  diagnostics: MarkdownLintDiagnostic[];
+  /**
+   * Number of error diagnostics.
+   */
+  errorCount: number;
+  /**
+   * Number of warning diagnostics.
+   */
+  warningCount: number;
+  /**
+   * Number of info diagnostics.
+   */
+  infoCount: number;
 }
 /**
- * Extended page props with custom frontmatter.
+ * Lints Markdown prose with the Rust-backed built-in rule engine.
  */
-type PageProps<T extends Record<string, unknown> = Record<string, unknown>> = BasePageProps & {
-  /** Custom frontmatter fields */
-  frontmatter: T & Record<string, unknown>;
-};
+declare function lintMarkdown(source: string, options?: MarkdownLintOptions): MarkdownLintResult;
 /**
- * Site-wide configuration available in context.
+ * Async Markdown linter that supports opt-in standard dictionaries.
  */
-interface SiteConfig {
-  /** Site name */
-  name: string;
-  /** Base URL path */
-  base: string;
-  /** All pages in the site */
-  pages: BasePageProps[];
-  /** Navigation groups */
-  nav: NavGroup[];
-}
+declare function lintMarkdownAsync(source: string, options?: MarkdownLintOptions): Promise<MarkdownLintResult>;
+//#endregion
+//#region src/lint-files.d.ts
 /**
- * Navigation group.
+ * File-oriented Markdown lint options for end-user configuration.
+ *
+ * This extends the content-level lint options with project-level targeting,
+ * so consumers can decide which files should be checked and which paths should
+ * be ignored.
  */
-interface NavGroup {
-  title: string;
-  items: NavItem[];
+interface MarkdownLintFileOptions extends MarkdownLintOptions {
+  /**
+   * Base directory used to resolve `include` and `exclude` patterns.
+   * @default process.cwd()
+   */
+  cwd?: string;
+  /**
+   * Glob patterns for files to lint.
+   * @default ['**\/*.md', '**\/*.markdown', '**\/*.mdx']
+   */
+  include?: string[];
+  /**
+   * Glob patterns for files to exclude from linting.
+   * @default ['**\/node_modules/**', '**\/.git/**', '**\/dist/**']
+   */
+  exclude?: string[];
+  /**
+   * Alias of `exclude`.
+   * When omitted, only `exclude` is used.
+   * @default undefined
+   */
+  ignore?: string[];
 }
 /**
- * Navigation item.
+ * A lint diagnostic annotated with file metadata.
  */
-interface NavItem {
-  title: string;
-  path: string;
-  href: string;
+interface MarkdownLintFileDiagnostic extends MarkdownLintDiagnostic {
+  filePath: string;
+  relativePath: string;
 }
 /**
- * Complete render context.
+ * Lint result for a single file.
  */
-interface RenderContext<T extends Record<string, unknown> = Record<string, unknown>> {
-  /** Current page props */
-  page: PageProps<T>;
-  /** Site configuration */
-  site: SiteConfig;
+interface MarkdownLintFileResult extends MarkdownLintResult {
+  filePath: string;
+  relativePath: string;
+  skipped: boolean;
 }
 /**
- * Sets the current render context.
- * Called internally during page rendering.
- * @internal
- */
-declare function setRenderContext(ctx: RenderContext): void;
-/**
- * Clears the current render context.
- * Called internally after page rendering.
- * @internal
- */
-declare function clearRenderContext(): void;
-/**
- * Gets the current page props.
- *
- * @returns The current page props
- * @throws Error if called outside of a render context
- *
- * @example
- * ```tsx
- * function PageTitle() {
- *   const page = usePageProps();
- *   return <h1>{page.title}</h1>;
- * }
- * ```
+ * Aggregated lint result for multiple files.
  */
-declare function usePageProps<T extends Record<string, unknown> = Record<string, unknown>>(): PageProps<T>;
-/**
- * Gets the site configuration.
- *
- * @returns The site configuration
- * @throws Error if called outside of a render context
- *
- * @example
- * ```tsx
- * function SiteHeader() {
- *   const site = useSiteConfig();
- *   return <header>{site.name}</header>;
- * }
- * ```
+interface MarkdownLintFilesResult {
+  checkedFileCount: number;
+  diagnostics: MarkdownLintFileDiagnostic[];
+  errorCount: number;
+  files: MarkdownLintFileResult[];
+  infoCount: number;
+  warningCount: number;
+}
+/**
+ * Returns true if the file path is included by the configured glob filters.
  */
-declare function useSiteConfig(): SiteConfig;
+declare function shouldLintMarkdownFile(filePath: string, options?: MarkdownLintFileOptions): boolean;
 /**
- * Gets the full render context.
- *
- * @returns The complete render context
- * @throws Error if called outside of a render context
+ * Lints a single Markdown file using project-style include/exclude settings.
  *
- * @example
- * ```tsx
- * function Layout({ children }) {
- *   const ctx = useRenderContext();
- *   return (
- *     <html>
- *       <head><title>{ctx.page.title} - {ctx.site.name}</title></head>
- *       <body>{children}</body>
- *     </html>
- *   );
- * }
- * ```
+ * If the file is filtered out by `include` / `exclude`, the returned result is
+ * marked as `skipped` and contains no diagnostics.
  */
-declare function useRenderContext<T extends Record<string, unknown> = Record<string, unknown>>(): RenderContext<T>;
+declare function lintMarkdownFile(filePath: string, options?: MarkdownLintFileOptions): Promise<MarkdownLintFileResult>;
 /**
- * Gets the navigation groups.
- *
- * @example
- * ```tsx
- * function Sidebar() {
- *   const nav = useNav();
- *   return (
- *     <nav>
- *       {each(nav, (group) => (
- *         <div>
- *           <h3>{group.title}</h3>
- *           <ul>
- *             {each(group.items, (item) => (
- *               <li><a href={item.href}>{item.title}</a></li>
- *             ))}
- *           </ul>
- *         </div>
- *       ))}
- *     </nav>
- *   );
- * }
- * ```
+ * Lints all Markdown files matched by the configured include/exclude patterns.
  */
-declare function useNav(): NavGroup[];
+declare function lintMarkdownFiles(options?: MarkdownLintFileOptions): Promise<MarkdownLintFilesResult>;
+//#endregion
+//#region src/ssg.d.ts
 /**
- * Checks if the given path is the current page.
+ * Deprecated compatibility export for consumers that imported the former
+ * TypeScript SSG template. HTML generation is Rust-backed now.
  *
- * @example
- * ```tsx
- * function NavLink({ href, children }) {
- *   const isActive = useIsActive(href);
- *   return <a href={href} class={isActive ? 'active' : ''}>{children}</a>;
- * }
- * ```
+ * @deprecated Use `generateHtmlPage`/`buildSsg` instead.
  */
-declare function useIsActive(path: string): boolean;
+declare const DEFAULT_HTML_TEMPLATE = "<!-- ox-content default HTML template is Rust-backed -->";
 /**
- * Schema for frontmatter type generation.
+ * Resolves SSG options with defaults.
  */
-interface FrontmatterSchema {
-  /** Field name */
-  name: string;
-  /** TypeScript type */
-  type: string;
-  /** Whether the field is optional */
-  optional: boolean;
-  /** JSDoc description */
-  description?: string;
+declare function resolveSsgOptions(ssg: SsgOptions | boolean | undefined): ResolvedSsgOptions;
+/** Result of an SSG build. */
+interface SsgBuildResult {
+  /** Every file written, HTML pages and generated OG images alike. */
+  files: string[];
+  /** Per-page failures that did not abort the build. */
+  errors: string[];
+  /**
+   * Generated OG image URL per source file, keyed by absolute input path.
+   *
+   * Bare mode renders these into the page itself, but a consumer
+   * post-processing the output had no way to find them short of probing the
+   * output directory for `og-image.png`.
+   */
+  ogImages: Record<string, string>;
 }
 /**
- * Infers TypeScript types from frontmatter values.
- */
-declare function inferType(value: unknown): string;
-/**
- * Generates TypeScript interface from frontmatter samples.
+ * Builds all markdown files to static HTML.
  */
-declare function generateFrontmatterTypes(samples: Record<string, unknown>[], interfaceName?: string): string;
+declare function buildSsg(options: ResolvedOptions, root: string): Promise<SsgBuildResult>;
 //#endregion
-//#region src/theme-renderer.d.ts
+//#region src/search.d.ts
 /**
- * Theme component type.
+ * Resolves search options with defaults.
  */
-type ThemeComponent = (props: ThemeProps) => JSXNode;
+declare function resolveSearchOptions(options: SearchOptions | boolean | undefined): ResolvedSearchOptions;
 /**
- * Props passed to the theme component.
+ * Builds the search index from Markdown files.
  */
-interface ThemeProps {
-  /** Rendered page content as JSX */
-  children: JSXNode;
-}
+declare function buildSearchIndex(srcDir: string, base: string, extensions?: readonly string[]): Promise<string>;
 /**
- * Page data for rendering.
+ * Writes the search index to a file.
  */
-interface PageData {
-  /** Page title */
-  title: string;
-  /** Page description */
+declare function writeSearchIndex(indexJson: string, outDir: string): Promise<void>;
+//#endregion
+//#region src/collections.d.ts
+declare function defineCollection<T extends CollectionOptions>(collection: T): T;
+declare function defineCollections<T extends CollectionsOptions>(collections: T): T;
+declare function resolveCollectionsOptions(options: CollectionsOptions | boolean | undefined): ResolvedCollectionsOptions;
+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;
+  dark?: string;
+  src?: string;
+  alt?: string;
+}
+interface VitePressSocialLink {
+  icon: string;
+  link: string;
+  ariaLabel?: string;
+}
+interface VitePressFooter {
+  message?: string;
+  copyright?: string;
+}
+interface VitePressSidebarItem {
+  text?: string;
+  link?: string;
+  items?: VitePressSidebarItem[];
+  collapsed?: boolean;
+}
+type VitePressSidebar = VitePressSidebarItem[] | Record<string, VitePressSidebarItem[]>;
+interface VitePressNavItem {
+  text?: string;
+  link?: string;
+  items?: VitePressNavItem[];
+  activeMatch?: string;
+}
+interface VitePressThemeConfig {
+  siteTitle?: string | false;
+  logo?: string | VitePressLogo;
+  nav?: VitePressNavItem[];
+  sidebar?: VitePressSidebar;
+  socialLinks?: VitePressSocialLink[];
+  footer?: VitePressFooter;
+  search?: {
+    placeholder?: string;
+  };
+}
+interface VitePressConfig {
+  title?: string;
   description?: string;
-  /** Rendered HTML content */
-  html: string;
-  /** Table of contents */
-  toc: TocEntry[];
-  /** Last git commit timestamp in milliseconds */
-  lastUpdated?: number;
-  /** Source file path */
-  path: string;
-  /** Output URL path */
-  url: string;
-  /** Frontmatter */
-  frontmatter: Record<string, unknown>;
-  /** Layout name */
-  layout?: string;
+  base?: string;
+  themeConfig?: VitePressThemeConfig;
 }
-/**
- * Theme render options.
- */
-interface ThemeRenderOptions {
-  /** Theme component to use */
-  theme: ThemeComponent;
-  /** Site name */
-  siteName: string;
-  /** Base URL path */
-  base: string;
-  /** Navigation groups */
-  nav: NavGroup[];
-  /** All pages (for site context) */
-  pages: PageData[];
-  /** Output directory for type definitions */
-  typesOutDir?: string;
+interface GenerateVitePressMigrationConfigOptions {
+  importSource?: string;
 }
 /**
- * Renders a page using the theme component.
- *
- * @param page - Page data to render
- * @param options - Theme render options
- * @returns Rendered HTML string
+ * Converts a VitePress sidebar config into ox-content navigation groups.
+ * Nested VitePress items are flattened into the nearest ox-content group.
  */
-declare function renderPage(page: PageData, options: ThemeRenderOptions): string;
+declare function convertVitePressSidebar(sidebar: VitePressSidebar): SsgNavigationGroup[];
 /**
- * Renders all pages and generates type definitions.
- *
- * @param pages - All pages to render
- * @param options - Theme render options
- * @returns Map of output paths to rendered HTML
+ * Converts VitePress top navigation into ox-content sidebar groups.
+ * This is used as a fallback when no explicit sidebar is defined.
  */
-declare function renderAllPages(pages: PageData[], options: ThemeRenderOptions): Promise<Map<string, string>>;
+declare function convertVitePressNav(nav: VitePressNavItem[]): SsgNavigationGroup[];
 /**
- * Generates TypeScript type definitions from page frontmatter.
- *
- * @param pages - All pages
- * @param outDir - Output directory for types
+ * Creates ox-content plugin options from an existing VitePress config.
  */
-declare function generateTypes(pages: PageData[], outDir: string): Promise<void>;
+declare function fromVitePressConfig(config: VitePressConfig, overrides?: OxContentOptions): OxContentOptions;
 /**
- * Default theme component.
- * A minimal theme that renders page content with basic styling.
+ * Generates a TypeScript module exporting migrated ox-content options.
+ *
+ * This is used by the migration CLI so users can inspect and edit the resulting
+ * object instead of keeping a runtime dependency on their VitePress config.
  */
-declare function DefaultTheme({ children }: ThemeProps): JSXNode;
+declare function generateVitePressMigrationConfig(config: VitePressConfig, overrides?: OxContentOptions, options?: GenerateVitePressMigrationConfigOptions): string;
 /**
- * Creates a theme with layout switching support.
- *
- * @example
- * ```tsx
- * import { createTheme } from '@ox-content/vite-plugin';
- * import { DefaultLayout } from './layouts/Default';
- * import { EntryLayout } from './layouts/Entry';
- *
- * export default createTheme({
- *   layouts: {
- *     default: DefaultLayout,
- *     entry: EntryLayout,
- *   },
- * });
- * ```
+ * Normalizes VitePress-specific frontmatter into ox-content's entry-page shape.
  */
-declare function createTheme(config: {
-  layouts: Record<string, ThemeComponent>;
-  defaultLayout?: string;
-}): ThemeComponent;
+declare function normalizeVitePressFrontmatter(frontmatter: Record<string, unknown>): Record<string, unknown>;
 //#endregion
 //#region src/island/parse.d.ts
 /**