@ox-content/vite-plugin 0.0.1-alpha.0

package/dist/index.d.ts

@@ -0,0 +1,811 @@
+import { EnvironmentOptions, Plugin } from 'vite';
+
+/**
+ * Type definitions for vite-plugin-ox-content
+ */
+/**
+ * SSG (Static Site Generation) options.
+ */
+interface SsgOptions {
+    /**
+     * Enable SSG mode.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Output file extension.
+     * @default '.html'
+     */
+    extension?: string;
+    /**
+     * Clean output directory before build.
+     * @default false
+     */
+    clean?: boolean;
+    /**
+     * Bare HTML output (no navigation, no styles).
+     * Useful for benchmarking or when using custom layouts.
+     * @default false
+     */
+    bare?: boolean;
+    /**
+     * Site name for header and title suffix.
+     */
+    siteName?: string;
+    /**
+     * OG image URL for social sharing (static URL).
+     * If generateOgImage is enabled, this serves as the fallback.
+     */
+    ogImage?: string;
+    /**
+     * Generate OG images per page using Rust-based generator.
+     * When enabled, each page will have a unique OG image.
+     * @default false
+     */
+    generateOgImage?: boolean;
+    /**
+     * Site URL for generating absolute OG image URLs.
+     * Required for proper SNS sharing.
+     * Example: 'https://example.com'
+     */
+    siteUrl?: string;
+}
+/**
+ * Resolved SSG options.
+ */
+interface ResolvedSsgOptions {
+    enabled: boolean;
+    extension: string;
+    clean: boolean;
+    bare: boolean;
+    siteName?: string;
+    ogImage?: string;
+    generateOgImage: boolean;
+    siteUrl?: string;
+}
+/**
+ * Plugin options.
+ */
+interface OxContentOptions {
+    /**
+     * Source directory for Markdown files.
+     * @default 'docs'
+     */
+    srcDir?: string;
+    /**
+     * Output directory for built files.
+     * @default 'dist'
+     */
+    outDir?: string;
+    /**
+     * Base path for the site.
+     * @default '/'
+     */
+    base?: string;
+    /**
+     * SSG (Static Site Generation) options.
+     * Set to false to disable SSG completely.
+     * @default { enabled: true }
+     */
+    ssg?: SsgOptions | boolean;
+    /**
+     * Enable GitHub Flavored Markdown extensions.
+     * @default true
+     */
+    gfm?: boolean;
+    /**
+     * Enable footnotes.
+     * @default true
+     */
+    footnotes?: boolean;
+    /**
+     * Enable tables.
+     * @default true
+     */
+    tables?: boolean;
+    /**
+     * Enable task lists.
+     * @default true
+     */
+    taskLists?: boolean;
+    /**
+     * Enable strikethrough.
+     * @default true
+     */
+    strikethrough?: boolean;
+    /**
+     * Enable syntax highlighting for code blocks.
+     * @default false
+     */
+    highlight?: boolean;
+    /**
+     * Syntax highlighting theme.
+     * @default 'github-dark'
+     */
+    highlightTheme?: string;
+    /**
+     * Enable mermaid diagram rendering.
+     * @default false
+     */
+    mermaid?: boolean;
+    /**
+     * Parse YAML frontmatter.
+     * @default true
+     */
+    frontmatter?: boolean;
+    /**
+     * Generate table of contents.
+     * @default true
+     */
+    toc?: boolean;
+    /**
+     * Maximum heading depth for TOC.
+     * @default 3
+     */
+    tocMaxDepth?: number;
+    /**
+     * Enable OG image generation.
+     * @default false
+     */
+    ogImage?: boolean;
+    /**
+     * OG image generation options.
+     */
+    ogImageOptions?: OgImageOptions;
+    /**
+     * Custom AST transformers.
+     */
+    transformers?: MarkdownTransformer[];
+    /**
+     * Source documentation generation options.
+     * Set to false to disable (opt-out).
+     * @default { enabled: true }
+     */
+    docs?: DocsOptions | false;
+    /**
+     * Full-text search options.
+     * Set to false to disable search.
+     * @default { enabled: true }
+     */
+    search?: SearchOptions | boolean;
+}
+/**
+ * Resolved options with all defaults applied.
+ */
+interface ResolvedOptions {
+    srcDir: string;
+    outDir: string;
+    base: string;
+    ssg: ResolvedSsgOptions;
+    gfm: boolean;
+    footnotes: boolean;
+    tables: boolean;
+    taskLists: boolean;
+    strikethrough: boolean;
+    highlight: boolean;
+    highlightTheme: string;
+    mermaid: boolean;
+    frontmatter: boolean;
+    toc: boolean;
+    tocMaxDepth: number;
+    ogImage: boolean;
+    ogImageOptions: OgImageOptions;
+    transformers: MarkdownTransformer[];
+    docs: ResolvedDocsOptions | false;
+    search: ResolvedSearchOptions;
+}
+/**
+ * OG image generation options.
+ */
+interface OgImageOptions {
+    /**
+     * Background color.
+     * @default '#1a1a2e'
+     */
+    background?: string;
+    /**
+     * Text color.
+     * @default '#ffffff'
+     */
+    textColor?: string;
+    /**
+     * Accent color.
+     * @default '#e94560'
+     */
+    accentColor?: string;
+    /**
+     * Font family.
+     */
+    fontFamily?: string;
+    /**
+     * Image width.
+     * @default 1200
+     */
+    width?: number;
+    /**
+     * Image height.
+     * @default 630
+     */
+    height?: number;
+}
+/**
+ * Custom AST transformer.
+ */
+interface MarkdownTransformer {
+    /**
+     * Transformer name.
+     */
+    name: string;
+    /**
+     * Transform function.
+     */
+    transform: (ast: MarkdownNode, context: TransformContext) => MarkdownNode | Promise<MarkdownNode>;
+}
+/**
+ * Transform context passed to transformers.
+ */
+interface TransformContext {
+    /**
+     * File path being processed.
+     */
+    filePath: string;
+    /**
+     * Frontmatter data.
+     */
+    frontmatter: Record<string, unknown>;
+    /**
+     * Resolved plugin options.
+     */
+    options: ResolvedOptions;
+}
+/**
+ * Markdown AST node (simplified for TypeScript).
+ */
+interface MarkdownNode {
+    type: string;
+    children?: MarkdownNode[];
+    value?: string;
+    [key: string]: unknown;
+}
+/**
+ * Transform result.
+ */
+interface TransformResult {
+    /**
+     * Generated JavaScript code.
+     */
+    code: string;
+    /**
+     * Source map (null means no source map).
+     */
+    map?: null;
+    /**
+     * Rendered HTML.
+     */
+    html: string;
+    /**
+     * Parsed frontmatter.
+     */
+    frontmatter: Record<string, unknown>;
+    /**
+     * Table of contents.
+     */
+    toc: TocEntry[];
+}
+/**
+ * Table of contents entry.
+ */
+interface TocEntry {
+    /**
+     * Heading depth (1-6).
+     */
+    depth: number;
+    /**
+     * Heading text.
+     */
+    text: string;
+    /**
+     * Slug/ID for linking.
+     */
+    slug: string;
+    /**
+     * Child entries.
+     */
+    children: TocEntry[];
+}
+/**
+ * Options for source documentation generation.
+ */
+interface DocsOptions {
+    /**
+     * Enable/disable docs generation.
+     * @default true (opt-out)
+     */
+    enabled?: boolean;
+    /**
+     * Source directories to scan for documentation.
+     * @default ['./src']
+     */
+    src?: string[];
+    /**
+     * Output directory for generated documentation.
+     * @default 'docs/api'
+     */
+    out?: string;
+    /**
+     * Glob patterns for files to include.
+     * @default ['**\/*.ts', '**\/*.tsx']
+     */
+    include?: string[];
+    /**
+     * Glob patterns for files to exclude.
+     * @default ['**\/*.test.*', '**\/*.spec.*', 'node_modules']
+     */
+    exclude?: string[];
+    /**
+     * Output format.
+     * @default 'markdown'
+     */
+    format?: 'markdown' | 'json' | 'html';
+    /**
+     * Include private members in documentation.
+     * @default false
+     */
+    private?: boolean;
+    /**
+     * Generate table of contents for each file.
+     * @default true
+     */
+    toc?: boolean;
+    /**
+     * Group documentation by file or category.
+     * @default 'file'
+     */
+    groupBy?: 'file' | 'category';
+    /**
+     * GitHub repository URL for source code links.
+     * When provided, generated documentation will include links to source code.
+     * Example: 'https://github.com/ubugeeei/ox-content'
+     */
+    githubUrl?: string;
+    /**
+     * Generate navigation metadata file.
+     * @default true
+     */
+    generateNav?: boolean;
+}
+/**
+ * Resolved docs options with all defaults applied.
+ */
+interface ResolvedDocsOptions {
+    enabled: boolean;
+    src: string[];
+    out: string;
+    include: string[];
+    exclude: string[];
+    format: 'markdown' | 'json' | 'html';
+    private: boolean;
+    toc: boolean;
+    groupBy: 'file' | 'category';
+    githubUrl?: string;
+    generateNav: boolean;
+}
+/**
+ * A single documentation entry extracted from source.
+ */
+interface DocEntry {
+    name: string;
+    kind: 'function' | 'class' | 'interface' | 'type' | 'variable' | 'module';
+    description: string;
+    params?: ParamDoc[];
+    returns?: ReturnDoc;
+    examples?: string[];
+    tags?: Record<string, string>;
+    private?: boolean;
+    file: string;
+    line: number;
+    signature?: string;
+}
+/**
+ * Parameter documentation.
+ */
+interface ParamDoc {
+    name: string;
+    type: string;
+    description: string;
+    optional?: boolean;
+    default?: string;
+}
+/**
+ * Return type documentation.
+ */
+interface ReturnDoc {
+    type: string;
+    description: string;
+}
+/**
+ * Extracted documentation for a single file.
+ */
+interface ExtractedDocs {
+    file: string;
+    entries: DocEntry[];
+}
+/**
+ * Navigation item for sidebar navigation.
+ */
+interface NavItem {
+    /**
+     * Display title for the navigation item.
+     */
+    title: string;
+    /**
+     * Path to the documentation page.
+     */
+    path: string;
+    /**
+     * Child navigation items (optional).
+     */
+    children?: NavItem[];
+}
+/**
+ * Options for full-text search.
+ */
+interface SearchOptions {
+    /**
+     * Enable search functionality.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Maximum number of search results.
+     * @default 10
+     */
+    limit?: number;
+    /**
+     * Enable prefix matching for autocomplete.
+     * @default true
+     */
+    prefix?: boolean;
+    /**
+     * Placeholder text for the search input.
+     * @default 'Search documentation...'
+     */
+    placeholder?: string;
+    /**
+     * Keyboard shortcut to focus search (without modifier).
+     * @default '/'
+     */
+    hotkey?: string;
+}
+/**
+ * Resolved search options.
+ */
+interface ResolvedSearchOptions {
+    enabled: boolean;
+    limit: number;
+    prefix: boolean;
+    placeholder: string;
+    hotkey: string;
+}
+/**
+ * Search document structure.
+ */
+interface SearchDocument {
+    id: string;
+    title: string;
+    url: string;
+    body: string;
+    headings: string[];
+    code: string[];
+}
+/**
+ * Search result structure.
+ */
+interface SearchResult {
+    id: string;
+    title: string;
+    url: string;
+    score: number;
+    matches: string[];
+    snippet: string;
+}
+
+/**
+ * Vite Environment API integration for Ox Content.
+ *
+ * Creates a dedicated environment for Markdown processing,
+ * enabling SSG-style rendering with separate client/server contexts.
+ */
+
+/**
+ * Creates the Markdown processing environment configuration.
+ *
+ * This environment is used for:
+ * - Server-side rendering of Markdown files
+ * - Static site generation
+ * - Pre-rendering at build time
+ *
+ * @example
+ * ```ts
+ * // In your vite.config.ts
+ * export default defineConfig({
+ *   environments: {
+ *     markdown: createMarkdownEnvironment({
+ *       srcDir: 'docs',
+ *       gfm: true,
+ *     }),
+ *   },
+ * });
+ * ```
+ */
+declare function createMarkdownEnvironment(options: ResolvedOptions): EnvironmentOptions;
+
+/**
+ * Markdown Transformation Engine
+ *
+ * This module handles the complete transformation pipeline for Markdown files,
+ * converting raw Markdown content into JavaScript modules that can be imported
+ * by web applications. The transformation process includes:
+ *
+ * 1. **Parsing**: Uses Rust-based parser via NAPI bindings for high performance
+ * 2. **Rendering**: Converts parsed AST to semantic HTML
+ * 3. **Enhancement**: Applies syntax highlighting, Mermaid diagram rendering, etc.
+ * 4. **Code Generation**: Generates JavaScript/TypeScript module code
+ *
+ * The generated modules export:
+ * - `html`: Rendered HTML content
+ * - `frontmatter`: Parsed YAML metadata
+ * - `toc`: Hierarchical table of contents
+ * - `render`: Client-side render function for dynamic updates
+ *
+ * @example
+ * ```typescript
+ * import { transformMarkdown } from './transform';
+ *
+ * const content = await transformMarkdown(
+ *   '# Hello\n\nWorld',
+ *   'path/to/file.md',
+ *   resolvedOptions
+ * );
+ *
+ * console.log(content.html); // '<h1>Hello</h1><p>World</p>'
+ * console.log(content.toc);  // [{ depth: 1, text: 'Hello', slug: 'hello', children: [] }]
+ * ```
+ */
+
+/**
+ * Transforms Markdown content into a JavaScript module.
+ *
+ * This is the primary entry point for transforming Markdown files. It handles
+ * the complete transformation pipeline including parsing, rendering, syntax
+ * highlighting, and code generation.
+ *
+ * ## Pipeline Steps
+ *
+ * 1. **Parse & Render**: Uses Rust-based parser via NAPI for high performance
+ * 2. **Extract Metadata**: Parses YAML frontmatter and generates table of contents
+ * 3. **Enhance HTML**: Applies syntax highlighting and Mermaid diagram rendering
+ * 4. **Generate Code**: Creates importable JavaScript module
+ *
+ * ## Generated Module Exports
+ *
+ * - `html` (string): Rendered HTML content with all enhancements applied
+ * - `frontmatter` (object): Parsed YAML frontmatter as JavaScript object
+ * - `toc` (array): Hierarchical table of contents entries
+ * - `render` (function): Client-side render function for dynamic updates
+ *
+ * ## Markdown Features Supported
+ *
+ * The supported features depend on parser options:
+ * - **Commonmark**: Headings, paragraphs, lists, code blocks, links, images
+ * - **GFM Extensions**: Tables, task lists, strikethrough, autolinks
+ * - **Enhancements**: Syntax highlighting, Mermaid diagrams, TOC generation
+ * - **Metadata**: YAML frontmatter parsing
+ *
+ * ## Performance
+ *
+ * Uses Rust-based parsing via NAPI bindings for optimal performance. Falls back
+ * gracefully if Rust bindings are unavailable.
+ *
+ * @param source - Raw Markdown source code (may include YAML frontmatter)
+ * @param filePath - File path for source attribution and relative link resolution
+ * @param options - Resolved plugin options controlling transformation behavior
+ *
+ * @returns Promise resolving to transformation result with HTML and metadata
+ *
+ * @throws Error if NAPI bindings are unavailable (can be handled gracefully)
+ *
+ * @example
+ * ```typescript
+ * import { transformMarkdown } from './transform';
+ * import { resolveOptions } from './index';
+ *
+ * // Transform a Markdown file with YAML frontmatter
+ * const markdown = `---
+ * title: Getting Started
+ * author: john
+ * ---
+ *
+ * # Getting Started
+ *
+ * Welcome! This guide explains [transformMarkdown] function.
+ *
+ * ## Installation
+ *
+ * \`\`\`bash
+ * npm install vite-plugin-ox-content
+ * \`\`\`
+ * `;
+ *
+ * const options = resolveOptions({
+ *   highlight: true,
+ *   highlightTheme: 'github-dark',
+ *   toc: true,
+ *   gfm: true,
+ *   mermaid: true,
+ * });
+ *
+ * const result = await transformMarkdown(markdown, 'docs/getting-started.md', options);
+ *
+ * // Generated module exports
+ * console.log(result.html);        // Rendered HTML with syntax highlighting
+ * console.log(result.frontmatter); // { title: 'Getting Started', author: 'john' }
+ * console.log(result.toc);         // [{ depth: 1, text: 'Getting Started', ... }]
+ * console.log(result.code);        // ES module export statement
+ * ```
+ */
+/**
+ * SSG-specific transform options.
+ */
+interface SsgTransformOptions {
+    /** Convert `.md` links to `.html` links */
+    convertMdLinks?: boolean;
+    /** Base URL for absolute link conversion */
+    baseUrl?: string;
+}
+declare function transformMarkdown(source: string, filePath: string, options: ResolvedOptions, ssgOptions?: SsgTransformOptions): Promise<TransformResult>;
+
+/**
+ * Extracts JSDoc documentation from source files in specified directories.
+ *
+ * This function recursively searches directories for source files matching
+ * the include/exclude patterns, then extracts all documented items (functions,
+ * classes, interfaces, types) from those files.
+ *
+ * ## Process
+ *
+ * 1. **File Discovery**: Recursively walks directories, applying filters
+ * 2. **File Reading**: Loads each matching file's content
+ * 3. **JSDoc Extraction**: Parses JSDoc comments using regex patterns
+ * 4. **Declaration Matching**: Pairs JSDoc comments with source declarations
+ * 5. **Result Collection**: Aggregates extracted documentation by file
+ *
+ * ## Include/Exclude Patterns
+ *
+ * Patterns support:
+ * - `**` - Match any directory structure
+ * - `*` - Match any filename
+ * - Standard glob patterns (e.g., `**\/*.test.ts`)
+ *
+ * ## Performance Considerations
+ *
+ * - Uses filesystem I/O which can be slow for large codebases
+ * - Consider using more specific include patterns to reduce file scanning
+ * - Results are not cached; call once per build/dev session
+ *
+ * @param srcDirs - Array of source directory paths to scan
+ * @param options - Documentation extraction options (filters, grouping, etc.)
+ *
+ * @returns Promise resolving to array of extracted documentation by file.
+ *          Each ExtractedDocs object contains file path and array of DocEntry items.
+ *
+ * @example
+ * ```typescript
+ * const docs = await extractDocs(
+ *   ['./packages/vite-plugin/src'],
+ *   {
+ *     enabled: true,
+ *     src: [],
+ *     out: 'docs',
+ *     include: ['**\/*.ts'],
+ *     exclude: ['**\/*.test.ts', '**\/*.spec.ts'],
+ *     format: 'markdown',
+ *     private: false,
+ *     toc: true,
+ *     groupBy: 'file',
+ *     generateNav: true,
+ *   }
+ * );
+ *
+ * // Returns:
+ * // [
+ * //   {
+ * //     file: '/path/to/transform.ts',
+ * //     entries: [
+ * //       { name: 'transformMarkdown', kind: 'function', ... },
+ * //       { name: 'loadNapiBindings', kind: 'function', ... },
+ * //     ]
+ * //   },
+ * //   ...
+ * // ]
+ * ```
+ */
+declare function extractDocs(srcDirs: string[], options: ResolvedDocsOptions): Promise<ExtractedDocs[]>;
+/**
+ * Generates Markdown documentation from extracted docs.
+ */
+declare function generateMarkdown(docs: ExtractedDocs[], options: ResolvedDocsOptions): Record<string, string>;
+/**
+ * Writes generated documentation to the output directory.
+ */
+declare function writeDocs(docs: Record<string, string>, outDir: string, extractedDocs?: ExtractedDocs[], options?: ResolvedDocsOptions): Promise<void>;
+declare function resolveDocsOptions(options: DocsOptions | false | undefined): ResolvedDocsOptions | false;
+
+/**
+ * SSG (Static Site Generation) module for ox-content
+ */
+
+/**
+ * Default HTML template for SSG pages with navigation.
+ */
+declare const DEFAULT_HTML_TEMPLATE = "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n  <meta charset=\"UTF-8\">\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n  <title>{{title}}{{#siteName}} - {{siteName}}{{/siteName}}</title>\n  {{#description}}<meta name=\"description\" content=\"{{description}}\">{{/description}}\n  <!-- Open Graph -->\n  <meta property=\"og:type\" content=\"website\">\n  <meta property=\"og:title\" content=\"{{title}}{{#siteName}} - {{siteName}}{{/siteName}}\">\n  {{#description}}<meta property=\"og:description\" content=\"{{description}}\">{{/description}}\n  {{#ogImage}}<meta property=\"og:image\" content=\"{{ogImage}}\">{{/ogImage}}\n  <!-- Twitter Card -->\n  <meta name=\"twitter:card\" content=\"summary_large_image\">\n  <meta name=\"twitter:title\" content=\"{{title}}{{#siteName}} - {{siteName}}{{/siteName}}\">\n  {{#description}}<meta name=\"twitter:description\" content=\"{{description}}\">{{/description}}\n  {{#ogImage}}<meta name=\"twitter:image\" content=\"{{ogImage}}\">{{/ogImage}}\n  <style>\n    :root {\n      --sidebar-width: 260px;\n      --header-height: 60px;\n      --max-content-width: 960px;\n      --font-sans: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;\n      --font-mono: ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, monospace;\n      --color-bg: #ffffff;\n      --color-bg-alt: #f8f9fa;\n      --color-text: #1a1a1a;\n      --color-text-muted: #666666;\n      --color-border: #e5e7eb;\n      --color-primary: #b7410e;\n      --color-primary-hover: #ce5937;\n      --color-code-bg: #1e293b;\n      --color-code-text: #e2e8f0;\n    }\n    [data-theme=\"dark\"] {\n      --color-bg: #0f172a;\n      --color-bg-alt: #1e293b;\n      --color-text: #e2e8f0;\n      --color-text-muted: #94a3b8;\n      --color-border: #334155;\n      --color-primary: #e67e4d;\n      --color-primary-hover: #f4a07a;\n      --color-code-bg: #0f172a;\n      --color-code-text: #e2e8f0;\n    }\n    @media (prefers-color-scheme: dark) {\n      :root:not([data-theme=\"light\"]) {\n        --color-bg: #0f172a;\n        --color-bg-alt: #1e293b;\n        --color-text: #e2e8f0;\n        --color-text-muted: #94a3b8;\n        --color-border: #334155;\n        --color-primary: #e67e4d;\n        --color-primary-hover: #f4a07a;\n        --color-code-bg: #0f172a;\n        --color-code-text: #e2e8f0;\n      }\n    }\n    * { box-sizing: border-box; margin: 0; padding: 0; }\n    html { scroll-behavior: smooth; }\n    body {\n      font-family: var(--font-sans);\n      line-height: 1.7;\n      color: var(--color-text);\n      background: var(--color-bg);\n    }\n    a { color: var(--color-primary); text-decoration: none; }\n    a:hover { color: var(--color-primary-hover); text-decoration: underline; }\n\n    /* Header */\n    .header {\n      position: fixed;\n      top: 0;\n      left: 0;\n      right: 0;\n      height: var(--header-height);\n      background: var(--color-bg);\n      border-bottom: 1px solid var(--color-border);\n      display: flex;\n      align-items: center;\n      padding: 0 1.5rem;\n      z-index: 100;\n    }\n    .header-title {\n      font-size: 1.25rem;\n      font-weight: 600;\n      color: var(--color-text);\n    }\n    .header-title:hover { text-decoration: none; }\n    .menu-toggle {\n      display: none;\n      background: none;\n      border: none;\n      cursor: pointer;\n      padding: 0.5rem;\n      margin-right: 0.75rem;\n    }\n    .menu-toggle svg { display: block; }\n    .menu-toggle path { stroke: var(--color-text); }\n    .header-actions { margin-left: auto; display: flex; align-items: center; gap: 0.5rem; }\n    .search-button {\n      display: flex;\n      align-items: center;\n      gap: 0.5rem;\n      padding: 0.5rem 0.75rem;\n      background: var(--color-bg-alt);\n      border: 1px solid var(--color-border);\n      border-radius: 6px;\n      color: var(--color-text-muted);\n      cursor: pointer;\n      font-size: 0.875rem;\n      transition: border-color 0.15s, color 0.15s;\n    }\n    .search-button:hover { border-color: var(--color-primary); color: var(--color-text); }\n    .search-button svg { width: 16px; height: 16px; }\n    .search-button kbd {\n      padding: 0.125rem 0.375rem;\n      background: var(--color-bg);\n      border: 1px solid var(--color-border);\n      border-radius: 4px;\n      font-family: var(--font-mono);\n      font-size: 0.75rem;\n    }\n    @media (max-width: 640px) {\n      .search-button span, .search-button kbd { display: none; }\n      .search-button { padding: 0.5rem; }\n    }\n    .search-modal-overlay {\n      display: none;\n      position: fixed;\n      inset: 0;\n      z-index: 200;\n      background: rgba(0,0,0,0.6);\n      backdrop-filter: blur(4px);\n      justify-content: center;\n      padding-top: 10vh;\n    }\n    .search-modal-overlay.open { display: flex; }\n    .search-modal {\n      width: 100%;\n      max-width: 560px;\n      margin: 0 1rem;\n      background: var(--color-bg);\n      border: 1px solid var(--color-border);\n      border-radius: 12px;\n      overflow: hidden;\n      box-shadow: 0 25px 50px -12px rgba(0,0,0,0.4);\n      max-height: 70vh;\n      display: flex;\n      flex-direction: column;\n    }\n    .search-header {\n      display: flex;\n      align-items: center;\n      gap: 0.75rem;\n      padding: 1rem;\n      border-bottom: 1px solid var(--color-border);\n    }\n    .search-header svg { flex-shrink: 0; color: var(--color-text-muted); }\n    .search-input {\n      flex: 1;\n      background: none;\n      border: none;\n      outline: none;\n      font-size: 1rem;\n      color: var(--color-text);\n    }\n    .search-input::placeholder { color: var(--color-text-muted); }\n    .search-close {\n      padding: 0.25rem 0.5rem;\n      background: var(--color-bg-alt);\n      border: 1px solid var(--color-border);\n      border-radius: 4px;\n      color: var(--color-text-muted);\n      font-family: var(--font-mono);\n      font-size: 0.75rem;\n      cursor: pointer;\n    }\n    .search-results {\n      flex: 1;\n      overflow-y: auto;\n      padding: 0.5rem;\n    }\n    .search-result {\n      display: block;\n      padding: 0.75rem 1rem;\n      border-radius: 8px;\n      color: var(--color-text);\n      text-decoration: none;\n    }\n    .search-result:hover, .search-result.selected { background: var(--color-bg-alt); text-decoration: none; }\n    .search-result-title { font-weight: 600; font-size: 0.875rem; margin-bottom: 0.25rem; }\n    .search-result-snippet { font-size: 0.8125rem; color: var(--color-text-muted); }\n    .search-empty { padding: 2rem 1rem; text-align: center; color: var(--color-text-muted); }\n    .search-footer {\n      display: flex;\n      align-items: center;\n      justify-content: center;\n      gap: 1rem;\n      padding: 0.75rem 1rem;\n      border-top: 1px solid var(--color-border);\n      background: var(--color-bg-alt);\n      font-size: 0.75rem;\n      color: var(--color-text-muted);\n    }\n    .search-footer kbd {\n      padding: 0.125rem 0.375rem;\n      background: var(--color-bg);\n      border: 1px solid var(--color-border);\n      border-radius: 4px;\n      font-family: var(--font-mono);\n    }\n    .theme-toggle {\n      background: none;\n      border: none;\n      cursor: pointer;\n      padding: 0.5rem;\n      border-radius: 6px;\n      color: var(--color-text-muted);\n      transition: background 0.15s, color 0.15s;\n    }\n    .theme-toggle:hover { background: var(--color-bg-alt); color: var(--color-text); }\n    .theme-toggle svg { display: block; width: 20px; height: 20px; }\n    .theme-toggle .icon-sun { display: none; }\n    .theme-toggle .icon-moon { display: block; }\n    [data-theme=\"dark\"] .theme-toggle .icon-sun { display: block; }\n    [data-theme=\"dark\"] .theme-toggle .icon-moon { display: none; }\n    @media (prefers-color-scheme: dark) {\n      :root:not([data-theme=\"light\"]) .theme-toggle .icon-sun { display: block; }\n      :root:not([data-theme=\"light\"]) .theme-toggle .icon-moon { display: none; }\n    }\n\n    /* Layout */\n    .layout {\n      display: flex;\n      padding-top: var(--header-height);\n      min-height: 100vh;\n    }\n\n    /* Sidebar */\n    .sidebar {\n      position: fixed;\n      top: var(--header-height);\n      left: 0;\n      bottom: 0;\n      width: var(--sidebar-width);\n      background: var(--color-bg-alt);\n      border-right: 1px solid var(--color-border);\n      overflow-y: auto;\n      padding: 1.5rem 1rem;\n    }\n    .nav-section { margin-bottom: 1.5rem; }\n    .nav-title {\n      font-size: 0.75rem;\n      font-weight: 600;\n      text-transform: uppercase;\n      letter-spacing: 0.05em;\n      color: var(--color-text-muted);\n      margin-bottom: 0.5rem;\n      padding: 0 0.75rem;\n    }\n    .nav-list { list-style: none; }\n    .nav-item { margin: 0.125rem 0; }\n    .nav-link {\n      display: block;\n      padding: 0.5rem 0.75rem;\n      border-radius: 6px;\n      color: var(--color-text);\n      font-size: 0.875rem;\n      transition: background 0.15s;\n    }\n    .nav-link:hover {\n      background: var(--color-border);\n      text-decoration: none;\n    }\n    .nav-link.active {\n      background: var(--color-primary);\n      color: white;\n    }\n\n    /* Main content */\n    .main {\n      flex: 1;\n      margin-left: var(--sidebar-width);\n      padding: 2rem;\n      min-width: 0;\n      overflow-x: hidden;\n    }\n    .content {\n      max-width: var(--max-content-width);\n      margin: 0 auto;\n      overflow-wrap: break-word;\n      word-wrap: break-word;\n      word-break: break-word;\n    }\n\n    /* TOC (right sidebar) */\n    .toc {\n      position: fixed;\n      top: calc(var(--header-height) + 2rem);\n      right: 2rem;\n      width: 200px;\n      font-size: 0.8125rem;\n    }\n    .toc-title {\n      font-weight: 600;\n      margin-bottom: 0.75rem;\n      color: var(--color-text-muted);\n    }\n    .toc-list { list-style: none; }\n    .toc-item { margin: 0.375rem 0; }\n    .toc-link {\n      color: var(--color-text-muted);\n      display: block;\n      padding-left: calc((var(--depth, 1) - 1) * 0.75rem);\n    }\n    .toc-link:hover { color: var(--color-primary); }\n    @media (max-width: 1200px) { .toc { display: none; } }\n\n    /* Typography */\n    .content h1 { font-size: 2.25rem; margin-bottom: 1rem; line-height: 1.2; }\n    .content h2 { font-size: 1.5rem; margin-top: 2.5rem; margin-bottom: 1rem; padding-bottom: 0.5rem; border-bottom: 1px solid var(--color-border); }\n    .content h3 { font-size: 1.25rem; margin-top: 2rem; margin-bottom: 0.75rem; }\n    .content h4 { font-size: 1rem; margin-top: 1.5rem; margin-bottom: 0.5rem; }\n    .content p { margin-bottom: 1rem; }\n    .content ul, .content ol { margin: 1rem 0; padding-left: 1.5rem; }\n    .content li { margin: 0.375rem 0; }\n    .content blockquote {\n      border-left: 4px solid var(--color-primary);\n      padding: 0.5rem 1rem;\n      margin: 1rem 0;\n      background: var(--color-bg-alt);\n      border-radius: 0 6px 6px 0;\n    }\n    .content code {\n      font-family: var(--font-mono);\n      font-size: 0.875em;\n      background: var(--color-bg-alt);\n      padding: 0.2em 0.4em;\n      border-radius: 4px;\n      word-break: break-all;\n    }\n    .content pre {\n      background: var(--color-code-bg);\n      color: var(--color-code-text);\n      padding: 1rem 1.25rem;\n      border-radius: 8px;\n      overflow-x: auto;\n      margin: 1.5rem 0;\n      line-height: 1.5;\n    }\n    .content pre code {\n      background: transparent;\n      padding: 0;\n      font-size: 0.8125rem;\n    }\n    .content table {\n      width: 100%;\n      border-collapse: collapse;\n      margin: 1.5rem 0;\n      font-size: 0.875rem;\n    }\n    .content th, .content td {\n      border: 1px solid var(--color-border);\n      padding: 0.75rem 1rem;\n      text-align: left;\n    }\n    .content th { background: var(--color-bg-alt); font-weight: 600; }\n    .content img { max-width: 100%; height: auto; border-radius: 8px; display: block; }\n    .content img[alt*=\"Logo\"] { max-width: 200px; display: block; margin: 1rem 0; }\n    .content img[alt*=\"Architecture\"] { max-width: 600px; }\n    .content img[alt*=\"Benchmark\"] { max-width: 680px; }\n    .content hr { border: none; border-top: 1px solid var(--color-border); margin: 2rem 0; }\n\n    /* Responsive */\n    @media (max-width: 768px) {\n      .menu-toggle { display: block; }\n      .sidebar {\n        transform: translateX(-100%);\n        transition: transform 0.3s ease;\n        z-index: 99;\n        width: 280px;\n      }\n      .sidebar.open { transform: translateX(0); }\n      .main { margin-left: 0; padding: 1rem 0.75rem; }\n      .content { padding: 0 0.25rem; }\n      .content h1 { font-size: 1.5rem; line-height: 1.3; margin-bottom: 0.75rem; }\n      .content h2 { font-size: 1.2rem; margin-top: 2rem; }\n      .content h3 { font-size: 1.1rem; }\n      .content p { font-size: 0.9375rem; margin-bottom: 0.875rem; }\n      .content ul, .content ol { padding-left: 1.25rem; font-size: 0.9375rem; }\n      .content pre {\n        padding: 0.75rem;\n        font-size: 0.75rem;\n        margin: 1rem -0.75rem;\n        border-radius: 0;\n        overflow-x: auto;\n        -webkit-overflow-scrolling: touch;\n      }\n      .content code { font-size: 0.8125em; }\n      .content table {\n        display: block;\n        overflow-x: auto;\n        -webkit-overflow-scrolling: touch;\n        font-size: 0.8125rem;\n        margin: 1rem -0.75rem;\n        width: calc(100% + 1.5rem);\n      }\n      .content th, .content td { padding: 0.5rem 0.75rem; white-space: nowrap; }\n      .content img { margin: 1rem 0; }\n      .content img[alt*=\"Logo\"] { max-width: 150px; }\n      .content img[alt*=\"Architecture\"] { max-width: 100%; }\n      .content img[alt*=\"Benchmark\"] { max-width: 100%; }\n      .content blockquote { padding: 0.5rem 0.75rem; margin: 1rem 0; font-size: 0.9375rem; }\n      .header { padding: 0 1rem; }\n      .header-title { font-size: 1rem; }\n      .header-title img { width: 24px; height: 24px; }\n      .overlay {\n        display: none;\n        position: fixed;\n        inset: 0;\n        background: rgba(0,0,0,0.5);\n        z-index: 98;\n      }\n      .overlay.open { display: block; }\n    }\n\n    /* Extra small devices */\n    @media (max-width: 480px) {\n      .main { padding: 0.75rem 0.5rem; }\n      .content h1 { font-size: 1.35rem; }\n      .content pre { font-size: 0.6875rem; padding: 0.625rem; }\n      .content table { font-size: 0.75rem; }\n      .content th, .content td { padding: 0.375rem 0.5rem; }\n    }\n  </style>\n</head>\n<body>\n  <header class=\"header\">\n    <button class=\"menu-toggle\" aria-label=\"Toggle menu\">\n      <svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke-width=\"2\" stroke-linecap=\"round\">\n        <path d=\"M3 12h18M3 6h18M3 18h18\"/>\n      </svg>\n    </button>\n    <a href=\"{{base}}index.html\" class=\"header-title\">\n      <img src=\"{{base}}logo.svg\" alt=\"\" width=\"28\" height=\"28\" style=\"margin-right: 8px; vertical-align: middle;\" />\n      {{siteName}}\n    </a>\n    <div class=\"header-actions\">\n      <button class=\"search-button\" aria-label=\"Search\">\n        <svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\">\n          <circle cx=\"11\" cy=\"11\" r=\"8\"/><path d=\"m21 21-4.3-4.3\"/>\n        </svg>\n        <span>Search</span>\n        <kbd>/</kbd>\n      </button>\n      <button class=\"theme-toggle\" aria-label=\"Toggle theme\">\n        <svg class=\"icon-sun\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\">\n          <circle cx=\"12\" cy=\"12\" r=\"5\"/><path d=\"M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42\"/>\n        </svg>\n        <svg class=\"icon-moon\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\">\n          <path d=\"M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z\"/>\n        </svg>\n      </button>\n    </div>\n  </header>\n  <div class=\"search-modal-overlay\">\n    <div class=\"search-modal\">\n      <div class=\"search-header\">\n        <svg width=\"20\" height=\"20\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\">\n          <circle cx=\"11\" cy=\"11\" r=\"8\"/><path d=\"m21 21-4.3-4.3\"/>\n        </svg>\n        <input type=\"text\" class=\"search-input\" placeholder=\"Search documentation...\" />\n        <button class=\"search-close\">Esc</button>\n      </div>\n      <div class=\"search-results\"></div>\n      <div class=\"search-footer\">\n        <span><kbd>\u2191</kbd><kbd>\u2193</kbd> to navigate</span>\n        <span><kbd>Enter</kbd> to select</span>\n        <span><kbd>Esc</kbd> to close</span>\n      </div>\n    </div>\n  </div>\n  <div class=\"overlay\"></div>\n  <div class=\"layout\">\n    <aside class=\"sidebar\">\n      <nav>\n{{navigation}}\n      </nav>\n    </aside>\n    <main class=\"main\">\n      <article class=\"content\">\n{{content}}\n      </article>\n    </main>\n{{#hasToc}}\n    <aside class=\"toc\">\n      <div class=\"toc-title\">On this page</div>\n      <ul class=\"toc-list\">\n{{toc}}\n      </ul>\n    </aside>\n{{/hasToc}}\n  </div>\n  <script>\n    // Menu toggle\n    const toggle = document.querySelector('.menu-toggle');\n    const sidebar = document.querySelector('.sidebar');\n    const overlay = document.querySelector('.overlay');\n    if (toggle && sidebar && overlay) {\n      const close = () => { sidebar.classList.remove('open'); overlay.classList.remove('open'); };\n      toggle.addEventListener('click', () => {\n        sidebar.classList.toggle('open');\n        overlay.classList.toggle('open');\n      });\n      overlay.addEventListener('click', close);\n      sidebar.querySelectorAll('a').forEach(a => a.addEventListener('click', close));\n    }\n\n    // Theme toggle\n    const themeToggle = document.querySelector('.theme-toggle');\n    const getPreferredTheme = () => {\n      const stored = localStorage.getItem('theme');\n      if (stored) return stored;\n      return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';\n    };\n    const setTheme = (theme) => {\n      document.documentElement.setAttribute('data-theme', theme);\n      localStorage.setItem('theme', theme);\n    };\n    // Initialize theme\n    setTheme(getPreferredTheme());\n    if (themeToggle) {\n      themeToggle.addEventListener('click', () => {\n        const current = document.documentElement.getAttribute('data-theme') || getPreferredTheme();\n        setTheme(current === 'dark' ? 'light' : 'dark');\n      });\n    }\n\n    // Search functionality\n    const searchButton = document.querySelector('.search-button');\n    const searchOverlay = document.querySelector('.search-modal-overlay');\n    const searchInput = document.querySelector('.search-input');\n    const searchResults = document.querySelector('.search-results');\n    const searchClose = document.querySelector('.search-close');\n    let searchIndex = null;\n    let selectedIndex = 0;\n    let results = [];\n\n    const openSearch = () => {\n      searchOverlay.classList.add('open');\n      searchInput.focus();\n    };\n    const closeSearch = () => {\n      searchOverlay.classList.remove('open');\n      searchInput.value = '';\n      searchResults.innerHTML = '';\n      selectedIndex = 0;\n      results = [];\n    };\n\n    // Load search index\n    const loadSearchIndex = async () => {\n      if (searchIndex) return;\n      try {\n        const res = await fetch('{{base}}search-index.json');\n        searchIndex = await res.json();\n      } catch (e) {\n        console.warn('Failed to load search index:', e);\n      }\n    };\n\n    // Tokenize query\n    const tokenize = (text) => {\n      const tokens = [];\n      let current = '';\n      for (const char of text) {\n        const isCjk = /[\\u4E00-\\u9FFF\\u3400-\\u4DBF\\u3040-\\u309F\\u30A0-\\u30FF\\uAC00-\\uD7AF]/.test(char);\n        if (isCjk) {\n          if (current) { tokens.push(current.toLowerCase()); current = ''; }\n          tokens.push(char);\n        } else if (/[a-zA-Z0-9_]/.test(char)) {\n          current += char;\n        } else if (current) {\n          tokens.push(current.toLowerCase());\n          current = '';\n        }\n      }\n      if (current) tokens.push(current.toLowerCase());\n      return tokens;\n    };\n\n    // Perform search\n    const performSearch = async (query) => {\n      if (!query.trim()) {\n        searchResults.innerHTML = '';\n        results = [];\n        return;\n      }\n      await loadSearchIndex();\n      if (!searchIndex) {\n        searchResults.innerHTML = '<div class=\"search-empty\">Search index not available</div>';\n        return;\n      }\n\n      const tokens = tokenize(query);\n      if (!tokens.length) {\n        searchResults.innerHTML = '';\n        results = [];\n        return;\n      }\n\n      const k1 = 1.2, b = 0.75;\n      const docScores = new Map();\n\n      for (let i = 0; i < tokens.length; i++) {\n        const token = tokens[i];\n        const isLast = i === tokens.length - 1;\n        let matchingTerms = [];\n        if (isLast && token.length >= 2) {\n          matchingTerms = Object.keys(searchIndex.index).filter(t => t.startsWith(token));\n        } else if (searchIndex.index[token]) {\n          matchingTerms = [token];\n        }\n\n        for (const term of matchingTerms) {\n          const postings = searchIndex.index[term] || [];\n          const df = searchIndex.df[term] || 1;\n          const idf = Math.log((searchIndex.doc_count - df + 0.5) / (df + 0.5) + 1.0);\n\n          for (const posting of postings) {\n            const doc = searchIndex.documents[posting.doc_idx];\n            if (!doc) continue;\n            const boost = posting.field === 'Title' ? 10 : posting.field === 'Heading' ? 5 : 1;\n            const tf = posting.tf;\n            const docLen = doc.body.length;\n            const score = idf * ((tf * (k1 + 1)) / (tf + k1 * (1 - b + b * docLen / searchIndex.avg_dl))) * boost;\n\n            if (!docScores.has(posting.doc_idx)) {\n              docScores.set(posting.doc_idx, { score: 0, matches: new Set() });\n            }\n            const entry = docScores.get(posting.doc_idx);\n            entry.score += score;\n            entry.matches.add(term);\n          }\n        }\n      }\n\n      results = Array.from(docScores.entries())\n        .map(([docIdx, data]) => {\n          const doc = searchIndex.documents[docIdx];\n          let snippet = '';\n          if (doc.body) {\n            const bodyLower = doc.body.toLowerCase();\n            let firstPos = -1;\n            for (const match of data.matches) {\n              const pos = bodyLower.indexOf(match);\n              if (pos !== -1 && (firstPos === -1 || pos < firstPos)) firstPos = pos;\n            }\n            const start = Math.max(0, firstPos - 50);\n            const end = Math.min(doc.body.length, start + 150);\n            snippet = doc.body.slice(start, end);\n            if (start > 0) snippet = '...' + snippet;\n            if (end < doc.body.length) snippet += '...';\n          }\n          return { ...doc, score: data.score, snippet };\n        })\n        .sort((a, b) => b.score - a.score)\n        .slice(0, 10);\n\n      selectedIndex = 0;\n      renderResults();\n    };\n\n    const renderResults = () => {\n      if (!results.length) {\n        searchResults.innerHTML = '<div class=\"search-empty\">No results found</div>';\n        return;\n      }\n      searchResults.innerHTML = results.map((r, i) =>\n        '<a href=\"' + r.url + '\" class=\"search-result' + (i === selectedIndex ? ' selected' : '') + '\">' +\n        '<div class=\"search-result-title\">' + r.title + '</div>' +\n        (r.snippet ? '<div class=\"search-result-snippet\">' + r.snippet + '</div>' : '') +\n        '</a>'\n      ).join('');\n    };\n\n    // Event listeners\n    if (searchButton) searchButton.addEventListener('click', openSearch);\n    if (searchClose) searchClose.addEventListener('click', closeSearch);\n    if (searchOverlay) searchOverlay.addEventListener('click', (e) => { if (e.target === searchOverlay) closeSearch(); });\n\n    let searchTimeout = null;\n    if (searchInput) {\n      searchInput.addEventListener('input', () => {\n        if (searchTimeout) clearTimeout(searchTimeout);\n        searchTimeout = setTimeout(() => performSearch(searchInput.value), 150);\n      });\n      searchInput.addEventListener('keydown', (e) => {\n        if (e.key === 'Escape') closeSearch();\n        else if (e.key === 'ArrowDown') {\n          e.preventDefault();\n          if (selectedIndex < results.length - 1) { selectedIndex++; renderResults(); }\n        } else if (e.key === 'ArrowUp') {\n          e.preventDefault();\n          if (selectedIndex > 0) { selectedIndex--; renderResults(); }\n        } else if (e.key === 'Enter' && results[selectedIndex]) {\n          e.preventDefault();\n          window.location.href = results[selectedIndex].url;\n        }\n      });\n    }\n\n    // Global keyboard shortcut (/ or Cmd+K)\n    document.addEventListener('keydown', (e) => {\n      if ((e.key === '/' && !(e.target instanceof HTMLInputElement)) ||\n          ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === 'k')) {\n        e.preventDefault();\n        openSearch();\n      }\n    });\n  </script>\n</body>\n</html>";
+/**
+ * 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[];
+}>;
+
+/**
+ * Full-text search functionality for Ox Content.
+ *
+ * Generates search index at build time and provides client-side search.
+ */
+
+/**
+ * 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): Promise<string>;
+/**
+ * Writes the search index to a file.
+ */
+declare function writeSearchIndex(indexJson: string, outDir: string): Promise<void>;
+
+/**
+ * Vite Plugin for Ox Content
+ *
+ * Uses Vite's Environment API for SSG-focused Markdown processing.
+ * Provides separate environments for client and server rendering.
+ */
+
+/**
+ * Creates the Ox Content Vite plugin.
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { defineConfig } from 'vite';
+ * import { oxContent } from 'vite-plugin-ox-content';
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     oxContent({
+ *       srcDir: 'docs',
+ *       gfm: true,
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+declare function oxContent(options?: OxContentOptions): Plugin[];
+
+export { DEFAULT_HTML_TEMPLATE, type DocEntry, type DocsOptions, type ExtractedDocs, type MarkdownNode, type MarkdownTransformer, type NavItem, type OgImageOptions, type OxContentOptions, type ParamDoc, type ResolvedDocsOptions, type ResolvedOptions, type ResolvedSearchOptions, type ResolvedSsgOptions, type ReturnDoc, type SearchDocument, type SearchOptions, type SearchResult, type SsgOptions, type TocEntry, type TransformContext, type TransformResult, buildSearchIndex, buildSsg, createMarkdownEnvironment, extractDocs, generateMarkdown, oxContent, resolveDocsOptions, resolveSearchOptions, resolveSsgOptions, transformMarkdown, writeDocs, writeSearchIndex };