npm - @ox-content/vite-plugin - Versions diffs - 2.88.0 → 2.89.0 - Mend

@ox-content/vite-plugin 2.88.0 → 2.89.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/dist/index.d.cts CHANGED Viewed

@@ -568,6 +568,297 @@ interface TransformAllOptions {
  */
 declare function transformAllPlugins(html: string, options?: TransformAllOptions): Promise<string>;
 //#endregion
+//#region src/page-context.d.ts
+/**
+ * Base page props available for all pages.
+ */
+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;
+}
+/**
+ * Extended page props with custom frontmatter.
+ */
+type PageProps<T extends Record<string, unknown> = Record<string, unknown>> = BasePageProps & {
+  /** Custom frontmatter fields */
+  frontmatter: T & Record<string, unknown>;
+};
+/**
+ * Site-wide configuration available in context.
+ */
+interface SiteConfig {
+  /** Site name */
+  name: string;
+  /** Base URL path */
+  base: string;
+  /** All pages in the site */
+  pages: BasePageProps[];
+  /** Navigation groups */
+  nav: NavGroup[];
+}
+/**
+ * Navigation group.
+ */
+interface NavGroup {
+  title: string;
+  items: NavItem[];
+}
+/**
+ * Navigation item.
+ */
+interface NavItem {
+  title: string;
+  path: string;
+  href: string;
+}
+/**
+ * Complete render context.
+ */
+interface RenderContext<T extends Record<string, unknown> = Record<string, unknown>> {
+  /** Current page props */
+  page: PageProps<T>;
+  /** Site configuration */
+  site: SiteConfig;
+}
+/**
+ * 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>;
+ * }
+ * ```
+ */
+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.
@@ -723,22 +1014,71 @@ interface SsgOptions {
    */
   bare?: boolean;
   /**
-   * Site name shown in the default theme header and title suffix.
+   * 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>`.
    *
-   * When omitted, the renderer falls back to project metadata where available.
+   * Bare mode only. Use it for a site header that wraps the rendered page.
    *
    * @default undefined
    */
-  siteName?: string;
+  bodyStart?: string;
   /**
-   * Static Open Graph image URL used for social sharing.
+   * Raw markup inserted directly before `</body>`.
    *
-   * When `generateOgImage` is enabled, this value is still useful as a fallback
-   * for pages that cannot produce a generated image.
+   * Bare mode only. Use it for a site footer, or scripts you inject yourself.
    *
    * @default undefined
    */
-  ogImage?: string;
+  bodyEnd?: string;
   /**
    * Generate one Open Graph image per page.
    *
@@ -807,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;
@@ -3360,437 +3705,158 @@ interface MarkdownLintFilesResult {
   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/page-context.d.ts
-/**
- * Base page props available for all pages.
- */
-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;
-}
-/**
- * Extended page props with custom frontmatter.
- */
-type PageProps<T extends Record<string, unknown> = Record<string, unknown>> = BasePageProps & {
-  /** Custom frontmatter fields */
-  frontmatter: T & Record<string, unknown>;
-};
-/**
- * Site-wide configuration available in context.
- */
-interface SiteConfig {
-  /** Site name */
-  name: string;
-  /** Base URL path */
-  base: string;
-  /** All pages in the site */
-  pages: BasePageProps[];
-  /** Navigation groups */
-  nav: NavGroup[];
-}
-/**
- * Navigation group.
- */
-interface NavGroup {
-  title: string;
-  items: NavItem[];
-}
-/**
- * Navigation item.
- */
-interface NavItem {
-  title: string;
-  path: string;
-  href: string;
-}
-/**
- * Complete render context.
- */
-interface RenderContext<T extends Record<string, unknown> = Record<string, unknown>> {
-  /** Current page props */
-  page: PageProps<T>;
-  /** Site configuration */
-  site: SiteConfig;
-}
-/**
- * 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>;
- * }
- * ```
- */
-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>;
- * }
- * ```
+  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
 /**