npm - @ox-content/vite-plugin - Versions diffs - 0.0.1-alpha.0 → 0.3.0-alpha.12 - Mend

@ox-content/vite-plugin 0.0.1-alpha.0 → 0.3.0-alpha.12

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 (40) hide show

package/dist/index.d.ts CHANGED Viewed

@@ -1,522 +1,762 @@
-import { EnvironmentOptions, Plugin } from 'vite';
+import { EnvironmentOptions, Plugin } from "vite";
+//#region src/theme.d.ts
+/**
+ * Theme API for ox-content SSG
+ *
+ * Provides VitePress-like theming with default theme + customization.
+ */
+/**
+ * Theme color configuration.
+ */
+interface ThemeColors {
+  /** Primary accent color */
+  primary?: string;
+  /** Primary color on hover */
+  primaryHover?: string;
+  /** Background color */
+  background?: string;
+  /** Alternative background color (sidebar, code blocks) */
+  backgroundAlt?: string;
+  /** Main text color */
+  text?: string;
+  /** Muted/secondary text color */
+  textMuted?: string;
+  /** Border color */
+  border?: string;
+  /** Code block background color */
+  codeBackground?: string;
+  /** Code block text color */
+  codeText?: string;
+}
+/**
+ * Theme layout configuration.
+ */
+interface ThemeLayout {
+  /** Sidebar width (CSS value, e.g., "260px") */
+  sidebarWidth?: string;
+  /** Header height (CSS value, e.g., "60px") */
+  headerHeight?: string;
+  /** Maximum content width (CSS value, e.g., "960px") */
+  maxContentWidth?: string;
+}
+/**
+ * Theme font configuration.
+ */
+interface ThemeFonts {
+  /** Sans-serif font stack */
+  sans?: string;
+  /** Monospace font stack */
+  mono?: string;
+}
+/**
+ * Theme header configuration.
+ */
+interface ThemeHeader {
+  /** Logo image URL */
+  logo?: string;
+  /** Logo width in pixels */
+  logoWidth?: number;
+  /** Logo height in pixels */
+  logoHeight?: number;
+}
+/**
+ * Theme footer configuration.
+ */
+interface ThemeFooter {
+  /** Footer message (supports HTML) */
+  message?: string;
+  /** Copyright text (supports HTML) */
+  copyright?: string;
+}
 /**
- * Type definitions for vite-plugin-ox-content
+ * Social links configuration.
  */
+interface SocialLinks {
+  /** GitHub URL */
+  github?: string;
+  /** Twitter/X URL */
+  twitter?: string;
+  /** Discord URL */
+  discord?: string;
+}
+/**
+ * Embedded HTML content for specific positions in the page layout.
+ */
+interface ThemeEmbed {
+  /** Content to embed into <head> */
+  head?: string;
+  /** Content before header */
+  headerBefore?: string;
+  /** Content after header */
+  headerAfter?: string;
+  /** Content before sidebar navigation */
+  sidebarBefore?: string;
+  /** Content after sidebar navigation */
+  sidebarAfter?: string;
+  /** Content before main content */
+  contentBefore?: string;
+  /** Content after main content */
+  contentAfter?: string;
+  /** Content before footer */
+  footerBefore?: string;
+  /** Custom footer content (replaces default footer) */
+  footer?: string;
+}
+/**
+ * Complete theme configuration.
+ */
+interface ThemeConfig {
+  /** Theme name for identification */
+  name?: string;
+  /** Base theme to extend */
+  extends?: ThemeConfig;
+  /** Light mode colors (maps to CSS variables) */
+  colors?: ThemeColors;
+  /** Dark mode colors (maps to CSS variables) */
+  darkColors?: ThemeColors;
+  /** Font configuration (maps to CSS variables) */
+  fonts?: ThemeFonts;
+  /** Layout configuration (maps to CSS variables) */
+  layout?: ThemeLayout;
+  /** Header configuration */
+  header?: ThemeHeader;
+  /** Footer configuration */
+  footer?: ThemeFooter;
+  /** Social links configuration */
+  socialLinks?: SocialLinks;
+  /** Embedded HTML content at specific positions */
+  embed?: ThemeEmbed;
+  /** Additional custom CSS */
+  css?: string;
+  /** Additional custom JavaScript */
+  js?: string;
+}
+/**
+ * Resolved theme configuration (after merging with defaults).
+ */
+interface ResolvedThemeConfig {
+  name: string;
+  colors: ThemeColors;
+  darkColors: ThemeColors;
+  fonts: ThemeFonts;
+  layout: ThemeLayout;
+  header: ThemeHeader;
+  footer: ThemeFooter;
+  socialLinks: SocialLinks;
+  embed: ThemeEmbed;
+  css: string;
+  js: string;
+}
+/**
+ * Default theme configuration.
+ * Based on the current ox-content SSG styles.
+ */
+declare const defaultTheme: ThemeConfig;
+/**
+ * Defines a theme configuration with type checking.
+ *
+ * @example
+ * ```ts
+ * const myTheme = defineTheme({
+ *   extends: defaultTheme,
+ *   colors: {
+ *     primary: '#3498db',
+ *   },
+ *   footer: {
+ *     copyright: '2025 My Company',
+ *   },
+ * });
+ * ```
+ */
+declare function defineTheme(config: ThemeConfig): ThemeConfig;
+/**
+ * Merges multiple theme configurations.
+ * Later themes override earlier ones.
+ *
+ * @example
+ * ```ts
+ * const merged = mergeThemes(defaultTheme, customTheme, overrides);
+ * ```
+ */
+declare function mergeThemes(...themes: ThemeConfig[]): ThemeConfig;
+/**
+ * Resolves a theme configuration by merging with its extends chain and defaults.
+ */
+declare function resolveTheme(config?: ThemeConfig): ResolvedThemeConfig;
+/**
+ * Converts resolved theme to the format expected by Rust NAPI.
+ */
+//#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;
+  /** Alt text */
+  alt?: string;
+  /** Image width */
+  width?: number;
+  /** Image height */
+  height?: number;
+}
+/**
+ * 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;
+  /** 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[];
+}
 /**
  * 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;
+  /**
+   * 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;
+  /**
+   * Theme configuration for customizing the SSG output.
+   * Use defineTheme() to create a theme configuration.
+   */
+  theme?: ThemeConfig;
 }
 /**
  * Resolved SSG options.
  */
 interface ResolvedSsgOptions {
-    enabled: boolean;
-    extension: string;
-    clean: boolean;
-    bare: boolean;
-    siteName?: string;
-    ogImage?: string;
-    generateOgImage: boolean;
-    siteUrl?: string;
+  enabled: boolean;
+  extension: string;
+  clean: boolean;
+  bare: boolean;
+  siteName?: string;
+  ogImage?: string;
+  generateOgImage: boolean;
+  siteUrl?: string;
+  theme?: ResolvedThemeConfig;
 }
 /**
  * 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;
+  /**
+   * Source directory for Markdown files.
+   * @default 'content'
+   */
+  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;
+  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;
+  /**
+   * 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>;
+  /**
+   * 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;
+  /**
+   * 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;
+  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[];
+  /**
+   * 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[];
+  /**
+   * 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;
+  /**
+   * 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;
+  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;
+  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;
+  name: string;
+  type: string;
+  description: string;
+  optional?: boolean;
+  default?: string;
 }
 /**
  * Return type documentation.
  */
 interface ReturnDoc {
-    type: string;
-    description: string;
+  type: string;
+  description: string;
 }
 /**
  * Extracted documentation for a single file.
  */
 interface ExtractedDocs {
-    file: string;
-    entries: DocEntry[];
+  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;
+  /**
+   * 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;
+  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[];
+  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;
+  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.
- */
+//# sourceMappingURL=types.d.ts.map
+//#endregion
+//#region src/environment.d.ts
 /**
  * Creates the Markdown processing environment configuration.
  *
@@ -531,7 +771,7 @@ interface SearchResult {
  * export default defineConfig({
  *   environments: {
  *     markdown: createMarkdownEnvironment({
- *       srcDir: 'docs',
+ *       srcDir: 'content',
  *       gfm: true,
  *     }),
  *   },
@@ -539,40 +779,15 @@ interface SearchResult {
  * ```
  */
 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:
+ * Environment-specific module transformer.
  *
- * 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: [] }]
- * ```
+ * This is called during the transform phase to process
+ * Markdown files within the environment context.
  */
+//#endregion
+//#region src/transform.d.ts
 /**
  * Transforms Markdown content into a JavaScript module.
  *
@@ -633,7 +848,7 @@ declare function createMarkdownEnvironment(options: ResolvedOptions): Environmen
  * ## Installation
  *
  * \`\`\`bash
- * npm install vite-plugin-ox-content
+ * npm install @ox-content/vite-plugin
  * \`\`\`
  * `;
  *
@@ -658,13 +873,21 @@ declare function createMarkdownEnvironment(options: ResolvedOptions): Environmen
  * SSG-specific transform options.
  */
 interface SsgTransformOptions {
-    /** Convert `.md` links to `.html` links */
-    convertMdLinks?: boolean;
-    /** Base URL for absolute link conversion */
-    baseUrl?: string;
+  /** Convert `.md` links to `.html` links */
+  convertMdLinks?: boolean;
+  /** Base URL for absolute link conversion */
+  baseUrl?: string;
+  /** Source file path for relative link resolution */
+  sourcePath?: string;
 }
 declare function transformMarkdown(source: string, filePath: string, options: ResolvedOptions, ssgOptions?: SsgTransformOptions): Promise<TransformResult>;
+/**
+ * Extracts imports from Markdown content.
+ *
+ * Supports importing components for interactive islands.
+ */
+//#endregion
+//#region src/docs.d.ts
 /**
  * Extracts JSDoc documentation from source files in specified directories.
  *
@@ -740,33 +963,34 @@ declare function generateMarkdown(docs: ExtractedDocs[], options: ResolvedDocsOp
  */
 declare function writeDocs(docs: Record<string, string>, outDir: string, extractedDocs?: ExtractedDocs[], options?: ResolvedDocsOptions): Promise<void>;
 declare function resolveDocsOptions(options: DocsOptions | false | undefined): ResolvedDocsOptions | false;
+//# sourceMappingURL=docs.d.ts.map
+//#endregion
+//#region src/ssg.d.ts
 /**
- * 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: #141414;\n      --color-bg-alt: #141414;\n      --color-text: #e5e5e5;\n      --color-text-muted: #a3a3a3;\n      --color-border: #2a2a2a;\n      --color-primary: #c9714a;\n      --color-primary-hover: #d4845f;\n      --color-code-bg: #1a1a1a;\n      --color-code-text: #e5e5e5;\n    }\n    @media (prefers-color-scheme: dark) {\n      :root:not([data-theme=\"light\"]) {\n        --color-bg: #141414;\n        --color-bg-alt: #141414;\n        --color-text: #e5e5e5;\n        --color-text-muted: #a3a3a3;\n        --color-border: #2a2a2a;\n        --color-primary: #c9714a;\n        --color-primary-hover: #d4845f;\n        --color-code-bg: #1a1a1a;\n        --color-code-text: #e5e5e5;\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>";
 /**
- * Default HTML template for SSG pages with navigation.
+ * Bare HTML template (no navigation, no styles).
  */
-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.
+ * Generates bare HTML page (no navigation, no styles).
  */
-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.
+ * 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.
  */
@@ -779,14 +1003,633 @@ 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>;
+/**
+ * Client-side search module code.
+ * This is injected into the bundle as a virtual module.
+ */
+//#endregion
+//#region src/jsx-runtime.d.ts
 /**
- * Vite Plugin for Ox Content
+ * 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.
  *
- * Uses Vite's Environment API for SSG-focused Markdown processing.
- * Provides separate environments for client and server rendering.
+ * @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;
+}
+/**
+ * Props with children.
+ */
+interface JSXProps {
+  children?: JSXChild;
+  [key: string]: unknown;
+}
+/**
+ * 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>)}
+ * ```
+ */
+declare function each<T>(items: T[], render: (item: T, index: number) => JSXNode): JSXNode;
+//#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[];
+  /** 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;
+//# sourceMappingURL=page-context.d.ts.map
+//#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[];
+  /** 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;
+//# sourceMappingURL=theme-renderer.d.ts.map
+//#endregion
+//#region src/plugins/tabs.d.ts
+/**
+ * Transform Tabs components in HTML.
+ */
+declare function transformTabs(html: string): Promise<string>;
+/**
+ * Generate dynamic CSS for :has() based tab switching.
+ * This is needed because :has() selectors need unique IDs.
+ */
+declare function generateTabsCSS(groupCount: number): string;
+//# sourceMappingURL=tabs.d.ts.map
+//#endregion
+//#region src/plugins/youtube.d.ts
+/**
+ * YouTube Plugin - Privacy-enhanced iframe embedding
+ *
+ * Transforms <YouTube> components into responsive iframe embeds
+ * using youtube-nocookie.com for enhanced privacy.
+ */
+interface YouTubeOptions {
+  /** Use privacy-enhanced mode (youtube-nocookie.com). Default: true */
+  privacyEnhanced?: boolean;
+  /** Default aspect ratio. Default: "16/9" */
+  aspectRatio?: string;
+  /** Allow fullscreen. Default: true */
+  allowFullscreen?: boolean;
+  /** Lazy load iframe. Default: true */
+  lazyLoad?: boolean;
+}
+/**
+ * Extract YouTube video ID from various URL formats.
+ */
+declare function extractVideoId(input: string): string | null;
+/**
+ * Transform YouTube components in HTML.
+ */
+declare function transformYouTube(html: string, options?: YouTubeOptions): Promise<string>;
+//# sourceMappingURL=youtube.d.ts.map
+//#endregion
+//#region src/plugins/github.d.ts
+/**
+ * GitHub Plugin - Repository card embedding
+ *
+ * Transforms <GitHub> components into static repository cards
+ * by fetching data from GitHub API at build time.
+ */
+interface GitHubRepoData {
+  name: string;
+  full_name: string;
+  description: string | null;
+  html_url: string;
+  stargazers_count: number;
+  forks_count: number;
+  language: string | null;
+  owner: {
+    login: string;
+    avatar_url: string;
+  };
+}
+interface GitHubOptions {
+  /** GitHub API token for higher rate limits. */
+  token?: string;
+  /** Cache fetched data. Default: true */
+  cache?: boolean;
+  /** Cache TTL in milliseconds. Default: 3600000 (1 hour) */
+  cacheTTL?: number;
+}
+/**
+ * Fetch repository data from GitHub API.
+ */
+declare function fetchRepoData(repo: string, options: Required<GitHubOptions>): Promise<GitHubRepoData | null>;
+/**
+ * Collect all GitHub repos from HTML for pre-fetching.
+ */
+declare function collectGitHubRepos(html: string): Promise<string[]>;
+/**
+ * Pre-fetch all GitHub repos data.
+ */
+declare function prefetchGitHubRepos(repos: string[], options?: GitHubOptions): Promise<Map<string, GitHubRepoData | null>>;
+/**
+ * Transform GitHub components in HTML.
+ */
+declare function transformGitHub(html: string, repoDataMap?: Map<string, GitHubRepoData | null>, options?: GitHubOptions): Promise<string>;
+//# sourceMappingURL=github.d.ts.map
+//#endregion
+//#region src/plugins/ogp.d.ts
+/**
+ * OGP Card Plugin - Link card embedding
+ *
+ * Transforms <OgCard> components into static link preview cards
+ * by fetching OGP metadata at build time.
+ */
+interface OgpData {
+  url: string;
+  title: string;
+  description?: string;
+  image?: string;
+  siteName?: string;
+  favicon?: string;
+}
+interface OgpOptions {
+  /** Request timeout in milliseconds. Default: 10000 */
+  timeout?: number;
+  /** Cache fetched data. Default: true */
+  cache?: boolean;
+  /** Cache TTL in milliseconds. Default: 3600000 (1 hour) */
+  cacheTTL?: number;
+  /** User agent for requests */
+  userAgent?: string;
+}
+/**
+ * Fetch OGP data for a URL.
+ */
+declare function fetchOgpData(url: string, options: Required<OgpOptions>): Promise<OgpData | null>;
+/**
+ * Collect all OGP URLs from HTML for pre-fetching.
+ */
+declare function collectOgpUrls(html: string): Promise<string[]>;
+/**
+ * Pre-fetch all OGP data.
+ */
+declare function prefetchOgpData(urls: string[], options?: OgpOptions): Promise<Map<string, OgpData | null>>;
+/**
+ * Transform OgCard components in HTML.
+ */
+declare function transformOgp(html: string, ogpDataMap?: Map<string, OgpData | null>, options?: OgpOptions): Promise<string>;
+//# sourceMappingURL=ogp.d.ts.map
+//#endregion
+//#region src/plugins/mermaid.d.ts
+/**
+ * Mermaid Plugin - Native Rust renderer via NAPI
+ *
+ * Renders mermaid code blocks to SVG using the native Rust renderer
+ * via NAPI. Delegates to the NAPI `transformMermaid` function which
+ * extracts mermaid code blocks from HTML and renders them using mmdc.
+ */
+interface MermaidOptions {
+  /** Mermaid theme. Default: "neutral" */
+  theme?: "default" | "dark" | "forest" | "neutral" | "base";
+}
+/**
+ * Transforms mermaid code blocks in HTML to rendered SVG diagrams.
+ * Uses the native Rust NAPI transformMermaid function.
+ */
+declare function transformMermaidStatic(html: string, _options?: MermaidOptions): Promise<string>;
+/**
+ * @deprecated No longer used. Mermaid rendering is now done at build time via NAPI.
+ */
+declare const mermaidClientScript = "";
+//# sourceMappingURL=mermaid.d.ts.map
+//#endregion
+//#region src/plugins/index.d.ts
+/**
+ * Transform all plugin components in HTML.
+ * Call this during SSG build to process all plugins at once.
+ */
+interface TransformAllOptions {
+  tabs?: boolean;
+  youtube?: boolean;
+  github?: boolean;
+  ogp?: boolean;
+  mermaid?: boolean;
+  githubToken?: string;
+}
+/**
+ * Transform all enabled plugins in HTML content.
+ */
+declare function transformAllPlugins(html: string, options?: TransformAllOptions): Promise<string>;
+//# sourceMappingURL=index.d.ts.map
+//#endregion
+//#region src/island/parse.d.ts
+/**
+ * Island Parser
+ *
+ * Detects <Island> components in HTML and transforms them
+ * into hydration-ready elements with data attributes.
+ */
+type LoadStrategy = "eager" | "idle" | "visible" | "media";
+interface IslandInfo {
+  component: string;
+  load: LoadStrategy;
+  mediaQuery?: string;
+  props: Record<string, unknown>;
+}
+interface ParseIslandsResult {
+  html: string;
+  islands: IslandInfo[];
+}
+/**
+ * Reset island counter (for testing).
  */
+/**
+ * Transform Island components in HTML.
+ *
+ * Converts:
+ * ```html
+ * <Island load="visible">
+ *   <Counter initial={0} />
+ * </Island>
+ * ```
+ *
+ * To:
+ * ```html
+ * <div id="ox-island-0"
+ *      data-ox-island="Counter"
+ *      data-ox-load="visible"
+ *      data-ox-props='{"initial":0}'
+ *      class="ox-island">
+ *   <!-- fallback content -->
+ * </div>
+ * ```
+ */
+declare function transformIslands(html: string): Promise<ParseIslandsResult>;
+/**
+ * Check if HTML contains any Island components.
+ */
+declare function hasIslands(html: string): boolean;
+/**
+ * Extract island info without transforming HTML.
+ * Useful for analysis/bundling purposes.
+ */
+declare function extractIslandInfo(html: string): Promise<IslandInfo[]>;
+/**
+ * Generate client-side hydration script.
+ * This is a minimal script that imports and initializes islands.
+ */
+declare function generateHydrationScript(components: string[]): string;
+//# sourceMappingURL=parse.d.ts.map
+//#endregion
+//#region src/index.d.ts
 /**
  * Creates the Ox Content Vite plugin.
  *
@@ -794,12 +1637,12 @@ declare function writeSearchIndex(indexJson: string, outDir: string): Promise<vo
  * ```ts
  * // vite.config.ts
  * import { defineConfig } from 'vite';
- * import { oxContent } from 'vite-plugin-ox-content';
+ * import { oxContent } from '@ox-content/vite-plugin';
  *
  * export default defineConfig({
  *   plugins: [
  *     oxContent({
- *       srcDir: 'docs',
+ *       srcDir: 'content',
  *       gfm: true,
  *     }),
  *   ],
@@ -807,5 +1650,6 @@ declare function writeSearchIndex(indexJson: string, outDir: string): Promise<vo
  * ```
  */
 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 };
+//#endregion
+export { type BasePageProps, DEFAULT_HTML_TEMPLATE, DefaultTheme, type DocEntry, type DocsOptions, type EntryPageConfig, type ExtractedDocs, type FeatureConfig, Fragment, type FrontmatterSchema, type GitHubOptions, type GitHubRepoData, type HeroAction, type HeroConfig, type HeroImage, type IslandInfo, type JSXChild, type JSXElementType, type JSXNode, type JSXProps, type LoadStrategy, MarkdownNode, MarkdownTransformer, type MermaidOptions, type NavGroup, type NavItem, OgImageOptions, type OgpData, type OgpOptions, type OxContentOptions, type PageData, type PageProps, type ParamDoc, type ParseIslandsResult, type RenderContext, type ResolvedDocsOptions, ResolvedOptions, type ResolvedSearchOptions, type ResolvedSsgOptions, type ResolvedThemeConfig, type ReturnDoc, type SearchDocument, type SearchOptions, type SearchResult, type SiteConfig, type SocialLinks, type SsgOptions, type ThemeColors, type ThemeComponent, type ThemeConfig, type ThemeEmbed, type ThemeFonts, type ThemeFooter, type ThemeHeader, type ThemeLayout, type ThemeProps, type ThemeRenderOptions, TocEntry, type TransformAllOptions, TransformContext, TransformResult, type YouTubeOptions, buildSearchIndex, buildSsg, clearRenderContext, collectGitHubRepos, collectOgpUrls, createMarkdownEnvironment, createTheme, defaultTheme, defineTheme, each, extractDocs, extractIslandInfo, extractVideoId, fetchOgpData, fetchRepoData, generateFrontmatterTypes, generateHydrationScript, generateMarkdown, generateTabsCSS, generateTypes, hasIslands, inferType, jsx, jsxs, mergeThemes, mermaidClientScript, oxContent, prefetchGitHubRepos, prefetchOgpData, raw, renderAllPages, renderPage, renderToString, resolveDocsOptions, resolveSearchOptions, resolveSsgOptions, resolveTheme, setRenderContext, transformAllPlugins, transformGitHub, transformIslands, transformMarkdown, transformMermaidStatic, transformOgp, transformTabs, transformYouTube, useIsActive, useNav, usePageProps, useRenderContext, useSiteConfig, when, writeDocs, writeSearchIndex };
+//# sourceMappingURL=index.d.ts.map