npm - @ox-content/vite-plugin - Versions diffs - 1.0.0-alpha.0 → 2.0.0 - Mend

@ox-content/vite-plugin 1.0.0-alpha.0 → 2.0.0

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

Files changed (58) hide show

package/dist/chunk.cjs +39 -49
package/dist/github.cjs +323 -3
package/dist/github.cjs.map +1 -0
package/dist/github.mjs +2 -0
package/dist/{github2.js → github2.mjs} +2 -3
package/dist/github2.mjs.map +1 -0
package/dist/index.cjs +1371 -598
package/dist/index.cjs.map +1 -1
package/dist/index.d.cts +114 -69
package/dist/index.d.cts.map +1 -1
package/dist/index.d.mts +1960 -0
package/dist/index.d.mts.map +1 -0
package/dist/{index.js → index.mjs} +1383 -623
package/dist/index.mjs.map +1 -0
package/dist/mermaid.cjs +115 -3
package/dist/mermaid.cjs.map +1 -0
package/dist/{mermaid2.js → mermaid.mjs} +14 -6
package/dist/mermaid.mjs.map +1 -0
package/dist/mermaid2.mjs +2 -0
package/dist/ogp.cjs +316 -3
package/dist/ogp.cjs.map +1 -0
package/dist/ogp.mjs +2 -0
package/dist/{ogp2.js → ogp2.mjs} +2 -3
package/dist/ogp2.mjs.map +1 -0
package/dist/tabs.cjs +212 -3
package/dist/tabs.cjs.map +1 -0
package/dist/tabs.mjs +2 -0
package/dist/{tabs2.js → tabs2.mjs} +2 -3
package/dist/tabs2.mjs.map +1 -0
package/dist/youtube.cjs +135 -3
package/dist/youtube.cjs.map +1 -0
package/dist/youtube.mjs +2 -0
package/dist/{youtube2.js → youtube2.mjs} +2 -3
package/dist/youtube2.mjs.map +1 -0
package/package.json +61 -56
package/dist/github.js +0 -3
package/dist/github2.cjs +0 -313
package/dist/github2.cjs.map +0 -1
package/dist/github2.js.map +0 -1
package/dist/index.d.ts +0 -1915
package/dist/index.d.ts.map +0 -1
package/dist/index.js.map +0 -1
package/dist/mermaid.js +0 -3
package/dist/mermaid2.cjs +0 -92
package/dist/mermaid2.cjs.map +0 -1
package/dist/mermaid2.js.map +0 -1
package/dist/ogp.js +0 -3
package/dist/ogp2.cjs +0 -306
package/dist/ogp2.cjs.map +0 -1
package/dist/ogp2.js.map +0 -1
package/dist/tabs.js +0 -3
package/dist/tabs2.cjs +0 -203
package/dist/tabs2.cjs.map +0 -1
package/dist/tabs2.js.map +0 -1
package/dist/youtube.js +0 -3
package/dist/youtube2.cjs +0 -127
package/dist/youtube2.cjs.map +0 -1
package/dist/youtube2.js.map +0 -1

package/dist/index.d.mts ADDED Viewed

@@ -0,0 +1,1960 @@
+import { LanguageRegistration, LanguageRegistration as LanguageRegistration$1, ThemeRegistration, ThemeRegistration as ThemeRegistration$1 } from "shiki";
+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;
+}
+/**
+ * Entry page theme configuration.
+ */
+interface ThemeEntryPage {
+  /** Landing page presentation mode */
+  mode?: "default" | "subtle";
+}
+/**
+ * Theme header configuration.
+ */
+interface ThemeHeader {
+  /** Logo image URL */
+  logo?: string;
+  /** Light mode logo image URL */
+  logoLight?: string;
+  /** Dark mode logo image URL */
+  logoDark?: string;
+  /** Whether to render the site name text next to the logo */
+  showSiteNameText?: boolean;
+  /** 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;
+}
+/**
+ * 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;
+  /** Entry page configuration */
+  entryPage?: ThemeEntryPage;
+  /** 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;
+  entryPage: ThemeEntryPage;
+  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;
+//#endregion
+//#region src/types.d.ts
+/**
+ * Hero section action button.
+ */
+interface HeroAction {
+  /** Button theme: 'brand' (primary) or 'alt' (secondary) */
+  theme?: "brand" | "alt";
+  /** Button text */
+  text: string;
+  /** Link URL */
+  link: string;
+}
+/**
+ * Hero section image configuration.
+ */
+interface HeroImage {
+  /** Image source URL */
+  src: string;
+  /** Light mode image source URL */
+  lightSrc?: string;
+  /** Dark mode image source URL */
+  darkSrc?: string;
+  /** Alt text */
+  alt?: string;
+  /** Image width */
+  width?: number;
+  /** Image height */
+  height?: number;
+}
+/**
+ * Hero notice configuration.
+ */
+interface HeroNotice {
+  /** Notice title */
+  title?: string;
+  /** Notice paragraphs */
+  body?: string[];
+}
+/**
+ * Hero section configuration for entry page.
+ */
+interface HeroConfig {
+  /** Main title (large, gradient text) */
+  name?: string;
+  /** Secondary text (medium size) */
+  text?: string;
+  /** Tagline (smaller, muted) */
+  tagline?: string;
+  /** Notice shown near the top of the hero */
+  notice?: HeroNotice;
+  /** Hero image */
+  image?: HeroImage;
+  /** Action buttons */
+  actions?: HeroAction[];
+}
+/**
+ * Feature card for entry page.
+ */
+interface FeatureConfig {
+  /** Icon - supports: "mdi:icon-name" (Iconify), image URL, or emoji */
+  icon?: string;
+  /** Feature title */
+  title: string;
+  /** Feature description */
+  details?: string;
+  /** Optional link */
+  link?: string;
+  /** Link text */
+  linkText?: string;
+}
+/**
+ * Entry page frontmatter configuration.
+ */
+interface EntryPageConfig {
+  /** Layout type - set to 'entry' for entry page */
+  layout: "entry";
+  /** Hero section */
+  hero?: HeroConfig;
+  /** Feature cards */
+  features?: FeatureConfig[];
+}
+/**
+ * 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;
+  /**
+   * 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;
+  theme?: ResolvedThemeConfig;
+}
+/**
+ * Plugin options.
+ */
+interface OxContentOptions {
+  /**
+   * 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 | ThemeRegistration$1;
+  /**
+   * Additional languages for syntax highlighting.
+   * Accepts Shiki LanguageRegistration objects (e.g., TextMate grammars).
+   * These are loaded alongside the built-in languages.
+   */
+  highlightLangs?: LanguageRegistration$1[];
+  /**
+   * Opt-in code block annotations for fenced code blocks.
+   *
+   * Supports the configurable attribute syntax by default, and can also opt
+   * into VitePress-compatible fence metadata and inline notation.
+   *
+   * Example:
+   * ` ```ts annotate="highlight:1,3-4;warning:6;error:7" `
+   *
+   * @default false
+   */
+  codeAnnotations?: boolean | CodeAnnotationsOptions;
+  /**
+   * 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;
+  /**
+   * Enable OG Viewer dev tool.
+   * Accessible at /__og-viewer during development.
+   * @default true
+   */
+  ogViewer?: boolean;
+  /**
+   * i18n (internationalization) options.
+   * Set to false to disable i18n.
+   * @default false
+   */
+  i18n?: I18nOptions | false;
+}
+/**
+ * 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 | ThemeRegistration$1;
+  highlightLangs: LanguageRegistration$1[];
+  codeAnnotations: ResolvedCodeAnnotationsOptions;
+  mermaid: boolean;
+  frontmatter: boolean;
+  toc: boolean;
+  tocMaxDepth: number;
+  ogImage: boolean;
+  ogImageOptions: ResolvedOgImageOptions$1;
+  transformers: MarkdownTransformer[];
+  docs: ResolvedDocsOptions | false;
+  search: ResolvedSearchOptions;
+  ogViewer: boolean;
+  i18n: ResolvedI18nOptions | false;
+}
+/**
+ * Supported line annotation kinds for code blocks.
+ */
+type CodeAnnotationKind = "highlight" | "warning" | "error";
+/**
+ * Supported code annotation syntaxes.
+ */
+type CodeAnnotationSyntax = "attribute" | "vitepress" | "both";
+/**
+ * Opt-in code annotation configuration.
+ */
+interface CodeAnnotationsOptions {
+  /**
+   * Annotation syntax to enable.
+   *
+   * - `attribute`: custom attribute syntax like `annotate="highlight:1,3-4"`
+   * - `vitepress`: VitePress-compatible syntax like `{1,3-4}` and `[!code warning]`
+   * - `both`: enables both syntaxes
+   *
+   * @default "attribute"
+   */
+  notation?: CodeAnnotationSyntax;
+  /**
+   * Attribute name read from the code fence meta string.
+   *
+   * Example: `annotate="highlight:1,3-4;warning:6"`
+   *
+   * @default "annotate"
+   */
+  metaKey?: string;
+  /**
+   * Enable line numbers for all code blocks by default.
+   *
+   * In `vitepress` or `both` mode, fenced code blocks can override this with
+   * `:line-numbers`, `:line-numbers=<start>`, or `:no-line-numbers`.
+   *
+   * @default false
+   */
+  defaultLineNumbers?: boolean;
+}
+/**
+ * Resolved code annotation configuration.
+ */
+interface ResolvedCodeAnnotationsOptions {
+  enabled: boolean;
+  notation: CodeAnnotationSyntax;
+  metaKey: string;
+  defaultLineNumbers: boolean;
+}
+/**
+ * OG image generation options.
+ * Uses Chromium-based rendering with customizable templates.
+ */
+interface OgImageOptions {
+  /**
+   * Path to a custom template file (.ts, .vue, .svelte, .tsx/.jsx).
+   * - `.ts`: default-export a function `(props) => string`
+   * - `.vue`: Vue SFC, rendered via SSR
+   * - `.svelte`: Svelte SFC, rendered via SSR
+   * - `.tsx`/`.jsx`: React Server Component, rendered via SSR
+   * If not specified, the built-in default template is used.
+   */
+  template?: string;
+  /**
+   * Vue plugin to use for compiling `.vue` templates.
+   * - `'vitejs'`: Use `@vue/compiler-sfc` (official, default)
+   * - `'vizejs'`: Use `@vizejs/vite-plugin` (Rust-based)
+   * @default 'vitejs'
+   */
+  vuePlugin?: "vitejs" | "vizejs";
+  /**
+   * Image width in pixels.
+   * @default 1200
+   */
+  width?: number;
+  /**
+   * Image height in pixels.
+   * @default 630
+   */
+  height?: number;
+  /**
+   * Enable content-hash based caching.
+   * Skips rendering when content hasn't changed.
+   * @default true
+   */
+  cache?: boolean;
+  /**
+   * Number of concurrent page instances for parallel rendering.
+   * @default 1
+   */
+  concurrency?: number;
+}
+/**
+ * Resolved OG image options with all defaults applied.
+ */
+interface ResolvedOgImageOptions$1 {
+  template?: string;
+  vuePlugin: "vitejs" | "vizejs";
+  width: number;
+  height: number;
+  cache: boolean;
+  concurrency: number;
+}
+/**
+ * Custom AST transformer.
+ */
+interface MarkdownTransformer {
+  /**
+   * Transformer name.
+   */
+  name: string;
+  /**
+   * Transform function.
+   */
+  transform: (ast: MarkdownNode, context: TransformContext) => MarkdownNode | Promise<MarkdownNode>;
+}
+/**
+ * Transform context passed to transformers.
+ */
+interface TransformContext {
+  /**
+   * File path being processed.
+   */
+  filePath: string;
+  /**
+   * Frontmatter data.
+   */
+  frontmatter: Record<string, unknown>;
+  /**
+   * Resolved plugin options.
+   */
+  options: ResolvedOptions;
+}
+/**
+ * Markdown AST node (simplified for TypeScript).
+ */
+interface MarkdownNode {
+  type: string;
+  children?: MarkdownNode[];
+  value?: string;
+  [key: string]: unknown;
+}
+/**
+ * Transform result.
+ */
+interface TransformResult {
+  /**
+   * Generated JavaScript code.
+   */
+  code: string;
+  /**
+   * Source map (null means no source map).
+   */
+  map?: null;
+  /**
+   * Rendered HTML.
+   */
+  html: string;
+  /**
+   * Parsed frontmatter.
+   */
+  frontmatter: Record<string, unknown>;
+  /**
+   * Table of contents.
+   */
+  toc: TocEntry[];
+}
+/**
+ * Table of contents entry.
+ */
+interface TocEntry {
+  /**
+   * Heading depth (1-6).
+   */
+  depth: number;
+  /**
+   * Heading text.
+   */
+  text: string;
+  /**
+   * Slug/ID for linking.
+   */
+  slug: string;
+  /**
+   * Child entries.
+   */
+  children: TocEntry[];
+}
+/**
+ * Options for source documentation generation.
+ */
+interface DocsOptions {
+  /**
+   * Enable/disable docs generation.
+   * @default true (opt-out)
+   */
+  enabled?: boolean;
+  /**
+   * Source directories to scan for documentation.
+   * @default ['./src']
+   */
+  src?: string[];
+  /**
+   * Output directory for generated documentation.
+   * @default 'docs/api'
+   */
+  out?: string;
+  /**
+   * Glob patterns for files to include.
+   * @default ['**\/*.ts', '**\/*.tsx']
+   */
+  include?: string[];
+  /**
+   * Glob patterns for files to exclude.
+   * @default ['**\/*.test.*', '**\/*.spec.*', 'node_modules']
+   */
+  exclude?: string[];
+  /**
+   * Output format.
+   * @default 'markdown'
+   */
+  format?: "markdown" | "json" | "html";
+  /**
+   * Include private members in documentation.
+   * @default false
+   */
+  private?: boolean;
+  /**
+   * Generate table of contents for each file.
+   * @default true
+   */
+  toc?: boolean;
+  /**
+   * Group documentation by file or category.
+   * @default 'file'
+   */
+  groupBy?: "file" | "category";
+  /**
+   * GitHub repository URL for source code links.
+   * When provided, generated documentation will include links to source code.
+   * Example: 'https://github.com/ubugeeei/ox-content'
+   */
+  githubUrl?: string;
+  /**
+   * Generate navigation metadata file.
+   * @default true
+   */
+  generateNav?: boolean;
+}
+/**
+ * Resolved docs options with all defaults applied.
+ */
+interface ResolvedDocsOptions {
+  enabled: boolean;
+  src: string[];
+  out: string;
+  include: string[];
+  exclude: string[];
+  format: "markdown" | "json" | "html";
+  private: boolean;
+  toc: boolean;
+  groupBy: "file" | "category";
+  githubUrl?: string;
+  generateNav: boolean;
+}
+/**
+ * A single documentation entry extracted from source.
+ */
+interface DocEntry {
+  name: string;
+  kind: "function" | "class" | "interface" | "type" | "variable" | "module";
+  description: string;
+  params?: ParamDoc[];
+  returns?: ReturnDoc;
+  examples?: string[];
+  tags?: Record<string, string>;
+  private?: boolean;
+  file: string;
+  line: number;
+  endLine: number;
+  signature?: string;
+}
+/**
+ * Parameter documentation.
+ */
+interface ParamDoc {
+  name: string;
+  type: string;
+  description: string;
+  optional?: boolean;
+  default?: string;
+}
+/**
+ * Return type documentation.
+ */
+interface ReturnDoc {
+  type: string;
+  description: string;
+}
+/**
+ * Extracted documentation for a single file.
+ */
+interface ExtractedDocs {
+  file: string;
+  entries: DocEntry[];
+}
+/**
+ * Machine-readable payload emitted alongside generated docs.
+ */
+interface GeneratedDocsData {
+  version: 1;
+  generatedAt: string;
+  modules: ExtractedDocs[];
+}
+/**
+ * Options for full-text search.
+ */
+interface SearchOptions {
+  /**
+   * Enable search functionality.
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * Maximum number of search results.
+   * @default 10
+   */
+  limit?: number;
+  /**
+   * Enable prefix matching for autocomplete.
+   * @default true
+   */
+  prefix?: boolean;
+  /**
+   * Placeholder text for the search input.
+   * @default 'Search documentation...'
+   */
+  placeholder?: string;
+  /**
+   * Keyboard shortcut to focus search (without modifier).
+   * @default '/'
+   */
+  hotkey?: string;
+}
+/**
+ * Resolved search options.
+ */
+interface ResolvedSearchOptions {
+  enabled: boolean;
+  limit: number;
+  prefix: boolean;
+  placeholder: string;
+  hotkey: string;
+}
+/**
+ * Search document structure.
+ */
+interface SearchDocument {
+  id: string;
+  title: string;
+  url: string;
+  body: string;
+  headings: string[];
+  code: string[];
+}
+/**
+ * Search result structure.
+ */
+interface SearchResult {
+  id: string;
+  title: string;
+  url: string;
+  score: number;
+  matches: string[];
+  snippet: string;
+  scopes?: string[];
+}
+/**
+ * Parsed search query with optional scope prefixes.
+ */
+interface ScopedSearchQuery {
+  text: string;
+  scopes: string[];
+}
+/**
+ * Locale configuration.
+ */
+interface LocaleConfig {
+  /** BCP 47 locale tag (e.g., 'en', 'ja', 'zh-Hans'). */
+  code: string;
+  /** Display name for this locale (e.g., 'English', '日本語'). */
+  name: string;
+  /** Text direction. @default 'ltr' */
+  dir?: "ltr" | "rtl";
+}
+/**
+ * i18n (internationalization) options.
+ */
+interface I18nOptions {
+  /**
+   * Enable i18n.
+   * @default false
+   */
+  enabled?: boolean;
+  /**
+   * Path to i18n dictionary directory (relative to project root).
+   * @default 'content/i18n'
+   */
+  dir?: string;
+  /**
+   * Default locale tag.
+   * @default 'en'
+   */
+  defaultLocale?: string;
+  /**
+   * Available locales.
+   */
+  locales?: LocaleConfig[];
+  /**
+   * Hide default locale prefix in URLs.
+   * When true, `/page` serves the default locale and `/ja/page` serves Japanese.
+   * When false, all locales get prefixed: `/en/page`, `/ja/page`.
+   * @default true
+   */
+  hideDefaultLocale?: boolean;
+  /**
+   * Run i18n checks during build.
+   * @default true
+   */
+  check?: boolean;
+  /**
+   * Translation function names to detect in source code.
+   * @default ['t', '$t']
+   */
+  functionNames?: string[];
+}
+/**
+ * Resolved i18n options with all defaults applied.
+ */
+interface ResolvedI18nOptions {
+  enabled: boolean;
+  dir: string;
+  defaultLocale: string;
+  locales: LocaleConfig[];
+  hideDefaultLocale: boolean;
+  check: boolean;
+  functionNames: string[];
+}
+//#endregion
+//#region src/environment.d.ts
+/**
+ * Creates the Markdown processing environment configuration.
+ *
+ * This environment is used for:
+ * - Server-side rendering of Markdown files
+ * - Static site generation
+ * - Pre-rendering at build time
+ *
+ * @example
+ * ```ts
+ * // In your vite.config.ts
+ * export default defineConfig({
+ *   environments: {
+ *     markdown: createMarkdownEnvironment({
+ *       srcDir: 'content',
+ *       gfm: true,
+ *     }),
+ *   },
+ * });
+ * ```
+ */
+declare function createMarkdownEnvironment(options: ResolvedOptions): EnvironmentOptions;
+//#endregion
+//#region src/transform.d.ts
+/**
+ * Transforms Markdown content into a JavaScript module.
+ *
+ * This is the primary entry point for transforming Markdown files. It handles
+ * the complete transformation pipeline including parsing, rendering, syntax
+ * highlighting, and code generation.
+ *
+ * ## Pipeline Steps
+ *
+ * 1. **Parse & Render**: Uses Rust-based parser via NAPI for high performance
+ * 2. **Extract Metadata**: Parses YAML frontmatter and generates table of contents
+ * 3. **Enhance HTML**: Applies syntax highlighting and Mermaid diagram rendering
+ * 4. **Generate Code**: Creates importable JavaScript module
+ *
+ * ## Generated Module Exports
+ *
+ * - `html` (string): Rendered HTML content with all enhancements applied
+ * - `frontmatter` (object): Parsed YAML frontmatter as JavaScript object
+ * - `toc` (array): Hierarchical table of contents entries
+ * - `render` (function): Client-side render function for dynamic updates
+ *
+ * ## Markdown Features Supported
+ *
+ * The supported features depend on parser options:
+ * - **Commonmark**: Headings, paragraphs, lists, code blocks, links, images
+ * - **GFM Extensions**: Tables, task lists, strikethrough, autolinks
+ * - **Enhancements**: Syntax highlighting, Mermaid diagrams, TOC generation
+ * - **Metadata**: YAML frontmatter parsing
+ *
+ * ## Performance
+ *
+ * Uses Rust-based parsing via NAPI bindings for optimal performance. Falls back
+ * gracefully if Rust bindings are unavailable.
+ *
+ * @param source - Raw Markdown source code (may include YAML frontmatter)
+ * @param filePath - File path for source attribution and relative link resolution
+ * @param options - Resolved plugin options controlling transformation behavior
+ *
+ * @returns Promise resolving to transformation result with HTML and metadata
+ *
+ * @throws Error if NAPI bindings are unavailable (can be handled gracefully)
+ *
+ * @example
+ * ```typescript
+ * import { transformMarkdown } from './transform';
+ * import { resolveOptions } from './index';
+ *
+ * // Transform a Markdown file with YAML frontmatter
+ * const markdown = `---
+ * title: Getting Started
+ * author: john
+ * ---
+ *
+ * # Getting Started
+ *
+ * Welcome! This guide explains [transformMarkdown] function.
+ *
+ * ## Installation
+ *
+ * \`\`\`bash
+ * npm install @ox-content/vite-plugin
+ * \`\`\`
+ * `;
+ *
+ * const options = resolveOptions({
+ *   highlight: true,
+ *   highlightTheme: 'github-dark',
+ *   toc: true,
+ *   gfm: true,
+ *   mermaid: true,
+ * });
+ *
+ * const result = await transformMarkdown(markdown, 'docs/getting-started.md', options);
+ *
+ * // Generated module exports
+ * console.log(result.html);        // Rendered HTML with syntax highlighting
+ * console.log(result.frontmatter); // { title: 'Getting Started', author: 'john' }
+ * console.log(result.toc);         // [{ depth: 1, text: 'Getting Started', ... }]
+ * console.log(result.code);        // ES module export statement
+ * ```
+ */
+/**
+ * SSG-specific transform options.
+ */
+interface SsgTransformOptions {
+  /** Convert `.md` links to `.html` links */
+  convertMdLinks?: boolean;
+  /** Base URL for absolute link conversion */
+  baseUrl?: string;
+  /** Source file path for relative link resolution */
+  sourcePath?: string;
+}
+declare function transformMarkdown(source: string, filePath: string, options: ResolvedOptions, ssgOptions?: SsgTransformOptions): Promise<TransformResult>;
+//#endregion
+//#region src/docs.d.ts
+/**
+ * Extracts JSDoc documentation from source files in specified directories.
+ *
+ * This function recursively searches directories for source files matching
+ * the include/exclude patterns, then extracts all documented items (functions,
+ * classes, interfaces, types) from those files.
+ *
+ * ## Process
+ *
+ * 1. **File Discovery**: Recursively walks directories, applying filters
+ * 2. **File Reading**: Loads each matching file's content
+ * 3. **JSDoc Extraction**: Parses JSDoc comments using regex patterns
+ * 4. **Declaration Matching**: Pairs JSDoc comments with source declarations
+ * 5. **Result Collection**: Aggregates extracted documentation by file
+ *
+ * ## Include/Exclude Patterns
+ *
+ * Patterns support:
+ * - `**` - Match any directory structure
+ * - `*` - Match any filename
+ * - Standard glob patterns (e.g., `**\/*.test.ts`)
+ *
+ * ## Performance Considerations
+ *
+ * - Uses filesystem I/O which can be slow for large codebases
+ * - Consider using more specific include patterns to reduce file scanning
+ * - Results are not cached; call once per build/dev session
+ *
+ * @param srcDirs - Array of source directory paths to scan
+ * @param options - Documentation extraction options (filters, grouping, etc.)
+ *
+ * @returns Promise resolving to array of extracted documentation by file.
+ *          Each ExtractedDocs object contains file path and array of DocEntry items.
+ *
+ * @example
+ * ```typescript
+ * const docs = await extractDocs(
+ *   ['./packages/vite-plugin/src'],
+ *   {
+ *     enabled: true,
+ *     src: [],
+ *     out: 'docs',
+ *     include: ['**\/*.ts'],
+ *     exclude: ['**\/*.test.ts', '**\/*.spec.ts'],
+ *     format: 'markdown',
+ *     private: false,
+ *     toc: true,
+ *     groupBy: 'file',
+ *     generateNav: true,
+ *   }
+ * );
+ *
+ * // Returns:
+ * // [
+ * //   {
+ * //     file: '/path/to/transform.ts',
+ * //     entries: [
+ * //       { name: 'transformMarkdown', kind: 'function', ... },
+ * //       { name: 'loadNapiBindings', kind: 'function', ... },
+ * //     ]
+ * //   },
+ * //   ...
+ * // ]
+ * ```
+ */
+declare function extractDocs(srcDirs: string[], options: ResolvedDocsOptions): Promise<ExtractedDocs[]>;
+/**
+ * Generates Markdown documentation from extracted docs.
+ */
+declare function generateMarkdown(docs: ExtractedDocs[], options: ResolvedDocsOptions): Record<string, string>;
+/**
+ * Writes generated documentation to the output directory.
+ */
+declare function writeDocs(docs: Record<string, string>, outDir: string, extractedDocs?: ExtractedDocs[], options?: ResolvedDocsOptions): Promise<void>;
+declare function resolveDocsOptions(options: DocsOptions | false | undefined): ResolvedDocsOptions | false;
+//#endregion
+//#region src/ssg.d.ts
+/**
+ * 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  {{#ogImage}}<meta name=\"twitter:card\" content=\"summary_large_image\">{{/ogImage}}\n  {{^ogImage}}<meta name=\"twitter:card\" content=\"summary\">{{/ogImage}}\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: 'IBM Plex Sans', 'Avenir Next', 'Segoe UI Variable', 'Segoe UI', sans-serif;\n      --font-mono: 'IBM Plex Mono', 'SFMono-Regular', Consolas, monospace;\n      --color-bg: #ffffff;\n      --color-bg-alt: #f5f7fb;\n      --color-text: #131a30;\n      --color-text-muted: #4f607b;\n      --color-border: #d2dbea;\n      --color-primary: #4f6fae;\n      --color-primary-hover: #425f96;\n      --color-code-bg: #101a31;\n      --color-code-bg-top: #18264a;\n      --color-code-text: #edf3ff;\n      --color-code-line-highlight: rgba(56, 189, 248, 0.16);\n      --color-code-line-warning: rgba(245, 158, 11, 0.18);\n      --color-code-line-warning-border: #f59e0b;\n      --color-code-line-error: rgba(239, 68, 68, 0.18);\n      --color-code-line-error-border: #ef4444;\n      --color-code-frame-border: rgba(147, 166, 200, 0.46);\n      --surface-noise-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 180 180'%3E%3Cfilter id='noise'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='1.2' numOctaves='2' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='180' height='180' filter='url(%23noise)' opacity='0.062'/%3E%3C/svg%3E\");\n      --surface-noise-size: 164px 164px;\n    }\n    [data-theme=\"dark\"] {\n      --color-bg: #060816;\n      --color-bg-alt: #0d1528;\n      --color-text: #ebf2ff;\n      --color-text-muted: #8ea0bf;\n      --color-border: #223252;\n      --color-primary: #86a4da;\n      --color-primary-hover: #a3bbe8;\n      --color-code-bg: #0a1020;\n      --color-code-bg-top: #0a1020;\n      --color-code-text: #e7f0ff;\n      --color-code-line-highlight: rgba(14, 165, 233, 0.2);\n      --color-code-line-warning: rgba(245, 158, 11, 0.2);\n      --color-code-line-warning-border: #f59e0b;\n      --color-code-line-error: rgba(239, 68, 68, 0.22);\n      --color-code-line-error-border: #f87171;\n      --color-code-frame-border: rgba(34, 50, 82, 0.92);\n      --surface-noise-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 180 180'%3E%3Cfilter id='noise'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='1.25' numOctaves='2' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='180' height='180' filter='url(%23noise)' opacity='0.098'/%3E%3C/svg%3E\");\n    }\n    @media (prefers-color-scheme: dark) {\n      :root:not([data-theme=\"light\"]) {\n        --color-bg: #060816;\n        --color-bg-alt: #0d1528;\n        --color-text: #ebf2ff;\n        --color-text-muted: #8ea0bf;\n        --color-border: #223252;\n        --color-primary: #86a4da;\n        --color-primary-hover: #a3bbe8;\n        --color-code-bg: #0a1020;\n        --color-code-bg-top: #0a1020;\n        --color-code-text: #e7f0ff;\n        --color-code-line-highlight: rgba(14, 165, 233, 0.2);\n        --color-code-line-warning: rgba(245, 158, 11, 0.2);\n        --color-code-line-warning-border: #f59e0b;\n        --color-code-line-error: rgba(239, 68, 68, 0.22);\n        --color-code-line-error-border: #f87171;\n        --color-code-frame-border: rgba(34, 50, 82, 0.92);\n        --surface-noise-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 180 180'%3E%3Cfilter id='noise'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='1.25' numOctaves='2' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='180' height='180' filter='url(%23noise)' opacity='0.098'/%3E%3C/svg%3E\");\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      background-image: var(--surface-noise-image);\n      background-size: var(--surface-noise-size);\n      background-repeat: repeat;\n      background-blend-mode: soft-light;\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,\n    .sidebar,\n    .search-modal,\n    .mobile-footer,\n    .content .ox-api-entry,\n    .content .ox-api-module,\n    .content blockquote.ox-callout {\n      background-image: var(--surface-noise-image);\n      background-size: var(--surface-noise-size);\n      background-repeat: repeat;\n      background-blend-mode: soft-light;\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: 4px;\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      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: 4px;\n      overflow: hidden;\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: 4px;\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: 4px;\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: color-mix(in srgb, var(--color-bg-alt) 16%, var(--color-bg));\n      border-right: 1px solid color-mix(in srgb, var(--color-border) 48%, transparent);\n      overflow-y: auto;\n      padding: 1rem 0.875rem 1.5rem;\n    }\n    .sidebar--entry { display: none; }\n    .sidebar nav {\n      display: flex;\n      flex-direction: column;\n      gap: 1rem;\n    }\n    .nav-section { margin-bottom: 0; }\n    .nav-title {\n      font-size: 0.6875rem;\n      font-weight: 600;\n      text-transform: uppercase;\n      letter-spacing: 0.08em;\n      color: var(--color-text-muted);\n      margin-bottom: 0.4rem;\n      padding: 0 0.625rem;\n    }\n    .nav-list {\n      list-style: none;\n      display: flex;\n      flex-direction: column;\n      gap: 0.125rem;\n    }\n    .nav-item { margin: 0; }\n    .nav-link {\n      display: block;\n      padding: 0.45rem 0.625rem;\n      border-radius: 0;\n      color: color-mix(in srgb, var(--color-text) 92%, var(--color-text-muted));\n      font-size: 0.875rem;\n    }\n    .nav-link:hover {\n      background: color-mix(in srgb, var(--color-bg-alt) 58%, transparent);\n      color: var(--color-text);\n      text-decoration: none;\n    }\n    .nav-link.active {\n      background: color-mix(in srgb, var(--color-bg-alt) 72%, transparent);\n      color: var(--color-text);\n      font-weight: 600;\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 4px 4px 0;\n    }\n    .content blockquote.ox-callout {\n      --callout-accent: var(--color-primary);\n      border-left-width: 3px;\n      border-left-color: var(--callout-accent);\n      padding: 0.9rem 1rem;\n      border-radius: 4px;\n      background: color-mix(in srgb, var(--color-bg-alt) 92%, var(--callout-accent) 8%);\n    }\n    .content blockquote.ox-callout.ox-callout--note,\n    .content blockquote.ox-callout.ox-callout--important { --callout-accent: var(--color-primary); }\n    .content blockquote.ox-callout.ox-callout--tip { --callout-accent: #0891b2; }\n    .content blockquote.ox-callout.ox-callout--warning { --callout-accent: #d97706; }\n    .content blockquote.ox-callout.ox-callout--caution { --callout-accent: #dc2626; }\n    .content .ox-callout-title {\n      margin: 0 0 0.5rem;\n      font-size: 0.75rem;\n      font-weight: 700;\n      letter-spacing: 0.08em;\n      text-transform: uppercase;\n      color: var(--callout-accent, var(--color-primary));\n    }\n    .content blockquote.ox-callout > :last-child { margin-bottom: 0; }\n    .content blockquote.ox-callout > :not(.ox-callout-title):first-of-type { margin-top: 0; }\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: linear-gradient(\n        180deg,\n        var(--color-code-bg-top) 0,\n        var(--color-code-bg) 3.5rem\n      ) !important;\n      color: var(--color-code-text);\n      padding: 1rem 1.25rem;\n      border-radius: 4px;\n      border: 1px solid var(--color-code-frame-border);\n      overflow-x: auto;\n      margin: 1.5rem 0;\n      line-height: 1.5;\n    }\n    .content pre code {\n      background: transparent;\n      border: 0;\n      padding: 0;\n      border-radius: 0;\n      font-size: 0.8125rem;\n      word-break: normal;\n    }\n    .content pre.ox-code-block code {\n      display: block;\n    }\n    .content pre.ox-code-block .line {\n      display: block;\n      margin: 0 -1.25rem;\n      padding: 0 1.25rem;\n    }\n    .content pre.ox-code-block .ox-code-line--highlight {\n      background: var(--color-code-line-highlight);\n    }\n    .content pre.ox-code-block .ox-code-line--warning {\n      background: var(--color-code-line-warning);\n      border-left: 3px solid var(--color-code-line-warning-border);\n    }\n    .content pre.ox-code-block .ox-code-line--error {\n      background: var(--color-code-line-error);\n      border-left: 3px solid var(--color-code-line-error-border);\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: 4px; 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    .content .ox-api-controls {\n      display: flex;\n      justify-content: flex-end;\n      align-items: center;\n      gap: 0.5rem;\n      margin: 0 0 1rem;\n    }\n    .content .ox-api-controls__button {\n      appearance: none;\n      border: 1px solid color-mix(in srgb, var(--color-border) 82%, transparent);\n      background: color-mix(in srgb, var(--color-bg-alt) 82%, var(--color-bg));\n      padding: 0.4rem 0.7rem;\n      border-radius: 4px;\n      color: color-mix(in srgb, var(--color-text) 82%, var(--color-text-muted));\n      font-family: var(--font-mono);\n      font-size: 0.78rem;\n      font-weight: 600;\n      line-height: 1.4;\n      cursor: pointer;\n    }\n    .content .ox-api-controls__button:hover {\n      color: var(--color-primary);\n      border-color: color-mix(in srgb, var(--color-primary) 38%, var(--color-border));\n      background: color-mix(in srgb, var(--color-bg-alt) 68%, var(--color-primary) 6%);\n    }\n    .content .ox-api-entry,\n    .content .ox-api-module {\n      margin: 0;\n      border: 0;\n      border-top: 1px solid color-mix(in srgb, var(--color-border) 74%, transparent);\n      border-radius: 0;\n      background: transparent;\n      overflow: visible;\n    }\n    .content .ox-api-entry:last-child,\n    .content .ox-api-module:last-child {\n      border-bottom: 1px solid color-mix(in srgb, var(--color-border) 74%, transparent);\n    }\n    .content .ox-api-entry summary,\n    .content .ox-api-module summary {\n      list-style: none;\n      cursor: pointer;\n      padding: 1rem 0;\n      position: relative;\n    }\n    .content .ox-api-entry summary::-webkit-details-marker,\n    .content .ox-api-module summary::-webkit-details-marker { display: none; }\n    .content .ox-api-entry summary {\n      display: grid;\n      grid-template-columns: var(--octc-api-kind-width, 6.5rem) minmax(0, 1fr) auto;\n      align-items: start;\n      gap: 0.95rem;\n    }\n    .content .ox-api-entry summary::after,\n    .content .ox-api-module summary::after {\n      content: \"+\";\n      align-self: center;\n      color: var(--color-text-muted);\n      font-family: var(--font-mono);\n      font-size: 0.95rem;\n      font-weight: 600;\n      line-height: 1;\n    }\n    .content .ox-api-entry[open] summary::after,\n    .content .ox-api-module[open] summary::after {\n      content: \"\u2212\";\n      color: var(--color-primary);\n    }\n    .content .ox-api-entry[open] summary,\n    .content .ox-api-module[open] summary {\n      border-bottom: 1px solid color-mix(in srgb, var(--color-border) 72%, transparent);\n    }\n    .content .ox-api-entry__kind,\n    .content .ox-api-module__kind {\n      display: block;\n      width: var(--octc-api-kind-width, 6.5rem);\n      padding: 0.3rem 0 0;\n      background: transparent;\n      border: 0;\n      font-family: var(--font-mono);\n      font-size: 0.76rem;\n      font-weight: 600;\n      letter-spacing: 0.01em;\n      text-align: left;\n      white-space: nowrap;\n      color: var(--color-text-muted);\n    }\n    .content .ox-api-module__count {\n      display: inline-flex;\n      align-items: center;\n      padding: 0.2rem 0.48rem;\n      border-radius: 4px;\n      background: color-mix(in srgb, var(--color-bg-alt) 84%, var(--color-primary) 8%);\n      border: 1px solid color-mix(in srgb, var(--color-border) 82%, transparent);\n      color: var(--color-text-muted);\n      font-family: var(--font-mono);\n      font-size: 0.72rem;\n      font-weight: 600;\n      letter-spacing: 0.03em;\n      white-space: nowrap;\n    }\n    .content .ox-api-entry__name {\n      display: block;\n      font-family: var(--font-mono);\n      font-size: 0.95rem;\n      font-weight: 600;\n      line-height: 1.55;\n    }\n    .content .ox-api-entry__signature,\n    .content .ox-api-module__signature {\n      display: block;\n      width: 100%;\n      min-width: 0;\n      font-family: var(--font-mono);\n      font-size: 0.95rem;\n      line-height: 1.55;\n      white-space: nowrap;\n      overflow-x: auto;\n      overflow-y: hidden;\n      -webkit-overflow-scrolling: touch;\n    }\n    .content .ox-api-entry__description {\n      display: block;\n      color: color-mix(in srgb, var(--color-text) 78%, var(--color-text-muted));\n      font-size: 0.9rem;\n      line-height: 1.6;\n      max-width: 72ch;\n    }\n    .content .ox-api-entry__summary-main {\n      min-width: 0;\n      display: flex;\n      flex-direction: column;\n      gap: 0.55rem;\n    }\n    .content .ox-api-entry__name,\n    .content .ox-api-entry__signature,\n    .content .ox-api-module__name,\n    .content .ox-api-module__signature {\n      background: transparent;\n      padding: 0;\n      border-radius: 0;\n      word-break: normal;\n    }\n    .content code.shiki-inline.ox-api-entry__signature--highlighted,\n    .content code.shiki-inline.ox-api-module__signature--highlighted {\n      display: block;\n      width: 100%;\n      max-width: 100%;\n      background: linear-gradient(\n        180deg,\n        var(--color-code-bg-top) 0,\n        var(--color-code-bg) 2.75rem\n      ) !important;\n      border: 1px solid var(--color-code-frame-border) !important;\n      padding: 0.55rem 0.7rem !important;\n      border-radius: 4px !important;\n      white-space: nowrap;\n      overflow-x: auto;\n      overflow-y: hidden;\n      -webkit-overflow-scrolling: touch;\n    }\n    .content code.shiki-inline.ox-api-entry__signature--highlighted .line,\n    .content code.shiki-inline.ox-api-module__signature--highlighted .line {\n      display: block;\n      width: max-content;\n      min-width: 100%;\n    }\n    .content .ox-api-entry__body,\n    .content .ox-api-module__body { padding: 0.7rem 0 1.9rem; }\n    .content .ox-api-entry__body {\n      margin-left: calc(var(--octc-api-kind-width, 6.5rem) + 0.95rem);\n      margin-top: 0.7rem;\n      padding: 1.45rem 1rem 2.1rem 1.1rem;\n      border: 1px solid color-mix(in srgb, var(--color-border) 72%, transparent);\n      border-radius: 4px;\n      background: color-mix(in srgb, var(--color-bg-alt) 68%, transparent);\n    }\n    .content .ox-api-entry__body > :first-child { margin-top: 0; }\n    .content .ox-api-entry__body > :last-child { margin-bottom: 0; }\n    .content .ox-api-entry[open] summary {\n      padding-bottom: 0.35rem;\n    }\n    .content .ox-api-entry__section {\n      display: grid;\n      grid-template-columns: 6.5rem minmax(0, 1fr);\n      gap: 0.2rem 1.25rem;\n      align-items: start;\n      margin-top: 1rem;\n      padding-top: 1rem;\n      border-top: 1px solid color-mix(in srgb, var(--color-border) 72%, transparent);\n    }\n    .content .ox-api-entry__section h4 {\n      margin-top: 0;\n      margin-bottom: 0;\n      padding-top: 0.25rem;\n      font-family: var(--font-mono);\n      font-size: 0.78rem;\n      font-weight: 700;\n      letter-spacing: 0.04em;\n      text-transform: uppercase;\n      color: var(--color-text-muted);\n    }\n    .content .ox-api-entry__section > :not(h4) { min-width: 0; }\n    .content .ox-api-entry__source {\n      margin: 0 0 0.15rem;\n      font-family: var(--font-mono);\n      font-size: 0.78rem;\n      color: var(--color-text-muted);\n    }\n    .content .ox-api-entry__source a {\n      color: inherit;\n      text-decoration-color: color-mix(in srgb, var(--color-text-muted) 38%, transparent);\n    }\n    .content .ox-api-entry__tags,\n    .content .ox-api-module__list {\n      list-style: none;\n      padding-left: 0;\n      margin: 0;\n    }\n    .content .ox-api-entry__tags {\n      display: flex;\n      flex-wrap: wrap;\n      gap: 0.6rem;\n    }\n    .content .ox-api-entry__tags li {\n      display: inline-flex;\n      align-items: center;\n      gap: 0.45rem;\n      padding: 0.4rem 0.55rem;\n      border: 1px solid color-mix(in srgb, var(--color-border) 80%, transparent);\n      border-radius: 4px;\n      background: color-mix(in srgb, var(--color-bg-alt) 72%, transparent);\n    }\n    .content .ox-api-module__list li {\n      display: grid;\n      grid-template-columns: var(--octc-api-kind-width, 6.5rem) minmax(0, 1fr);\n      align-items: start;\n      gap: 1rem;\n      padding: 0.85rem 0;\n      border-top: 1px solid color-mix(in srgb, var(--color-border) 70%, transparent);\n    }\n    .content .ox-api-module__list li:first-child { border-top: none; }\n    .content .ox-api-entry__tag-name,\n    .content .ox-api-module__title { font-weight: 700; }\n    .content .ox-api-entry__tag-name {\n      color: var(--color-primary);\n      font-family: var(--font-mono);\n      font-size: 0.74rem;\n    }\n    .content .ox-api-entry__tag-value {\n      color: var(--color-text);\n      font-size: 0.84rem;\n      line-height: 1.45;\n    }\n    .content .ox-api-module summary {\n      display: grid;\n      grid-template-columns: minmax(0, 1fr) auto auto;\n      align-items: center;\n      gap: 0.9rem;\n    }\n    .content .ox-api-module__body { padding-top: 0.15rem; }\n    .content .ox-api-module__item { min-width: 0; }\n    .content .ox-api-module__link {\n      display: block;\n      text-decoration: none;\n    }\n    .content .ox-api-module__link:hover { text-decoration: none; }\n    .content .ox-api-module__name,\n    .content .ox-api-module__signature {\n      display: block;\n      font-family: var(--font-mono);\n      font-size: 0.91rem;\n      line-height: 1.55;\n      color: var(--color-text);\n    }\n    .content .ox-api-module__summary {\n      display: block;\n      margin-top: 0.45rem;\n      color: color-mix(in srgb, var(--color-text) 76%, var(--color-text-muted));\n      font-size: 0.88rem;\n      line-height: 1.55;\n    }\n    .content .ox-api-entry__section--examples pre {\n      margin: 0;\n      border: 1px solid var(--color-code-frame-border);\n      border-radius: 4px;\n    }\n    .content .ox-api-entry__params {\n      list-style: none;\n      padding: 0;\n      margin: 0;\n    }\n    .content .ox-api-entry__param {\n      padding: 0.8rem 0;\n      border-top: 1px solid color-mix(in srgb, var(--color-border) 70%, transparent);\n    }\n    .content .ox-api-entry__param:first-child {\n      padding-top: 0;\n      border-top: 0;\n    }\n    .content .ox-api-entry__param-heading {\n      display: flex;\n      flex-wrap: wrap;\n      align-items: center;\n      gap: 0.5rem;\n    }\n    .content .ox-api-entry__param-name,\n    .content .ox-api-entry__return-type {\n      font-family: var(--font-mono);\n      font-size: 0.84rem;\n      font-weight: 600;\n      color: var(--color-text);\n      background: color-mix(in srgb, var(--color-bg-alt) 84%, transparent);\n      border: 1px solid color-mix(in srgb, var(--color-border) 82%, transparent);\n      padding: 0.28rem 0.42rem;\n      border-radius: 4px;\n    }\n    .content .ox-api-entry__param-type {\n      font-family: var(--font-mono);\n      font-size: 0.78rem;\n      color: var(--color-code-text);\n      background: color-mix(in srgb, var(--color-code-bg) 96%, #243556);\n      border: 1px solid color-mix(in srgb, var(--color-code-bg) 82%, var(--color-border));\n      padding: 0.26rem 0.42rem;\n      border-radius: 4px;\n    }\n    .content .ox-api-entry__param-description,\n    .content .ox-api-entry__return-description {\n      margin: 0.55rem 0 0;\n      font-size: 0.88rem;\n      line-height: 1.6;\n      color: color-mix(in srgb, var(--color-text) 78%, var(--color-text-muted));\n    }\n    .content .ox-api-entry__return { margin: 0; }\n\n    /* Responsive */\n    @media (max-width: 768px) {\n      .menu-toggle { display: block; }\n      .sidebar {\n        transform: translateX(-100%);\n        z-index: 99;\n        width: 280px;\n      }\n      .sidebar--entry { display: block; }\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 .ox-api-controls {\n        justify-content: flex-start;\n        gap: 0.75rem;\n      }\n      .content .ox-api-entry__body {\n        margin-left: 0;\n        margin-top: 0.55rem;\n        padding: 1.2rem 0 1.7rem;\n        border-left: 0;\n        border-right: 0;\n        border-bottom: 0;\n        border-radius: 0;\n        background: transparent;\n      }\n      .content .ox-api-entry__section {\n        grid-template-columns: 1fr;\n        gap: 0.5rem;\n      }\n      .content .ox-api-entry__tags li,\n      .content .ox-api-module__list li,\n      .content .ox-api-module summary {\n        grid-template-columns: 1fr;\n      }\n      .content .ox-api-entry__signature { width: 100%; }\n      .content pre.ox-code-block .line {\n        margin: 0 -0.75rem;\n        padding: 0 0.75rem;\n      }\n      .content code { font-size: 0.8125em; }\n      .content table {\n        display: block;\n        width: max-content;\n        min-width: 100%;\n        max-width: calc(100vw - 1.5rem);\n        overflow-x: auto;\n        -webkit-overflow-scrolling: touch;\n        font-size: 0.8125rem;\n        margin: 1rem 0;\n        border-collapse: separate;\n        border-spacing: 0;\n      }\n      .content th, .content td { padding: 0.5rem 0.75rem; white-space: nowrap; vertical-align: top; }\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:not(.header-title--logo-only) img { width: 24px; height: 24px; }\n      .header-title--logo-only .header-logo { width: 152px; height: auto; }\n      .overlay {\n        display: none;\n        position: fixed;\n        inset: 0;\n        background: transparent;\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 { max-width: calc(100vw - 1rem); 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{{#entryPage}} sidebar--entry{{/entryPage}}\">\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    document.querySelectorAll('.ox-api-controls').forEach((controls) => {\n      const targetSelector = controls.getAttribute('data-ox-api-target');\n      if (!targetSelector) return;\n\n      controls.querySelectorAll('[data-ox-api-toggle]').forEach((button) => {\n        button.addEventListener('click', () => {\n          const shouldOpen = button.getAttribute('data-ox-api-toggle') === 'expand';\n          document.querySelectorAll(targetSelector).forEach((entry) => {\n            if (entry instanceof HTMLDetailsElement) {\n              entry.open = shouldOpen;\n            }\n          });\n        });\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    const parseScopedQuery = (query) => {\n      const scopes = [];\n      const terms = [];\n      for (const part of query.trim().split(/\\s+/).filter(Boolean)) {\n        if (part.startsWith('@') && part.length > 1) {\n          scopes.push(part.slice(1).toLowerCase());\n        } else {\n          terms.push(part);\n        }\n      }\n      return { text: terms.join(' ').trim(), scopes: [...new Set(scopes)] };\n    };\n\n    const getScopesForDoc = (doc) => {\n      const source = (doc.id || doc.url || '').replace(/^\\/+/, '').toLowerCase();\n      const segments = source.split('/').filter(Boolean);\n      if (segments.length <= 1) return [];\n\n      const scopes = [];\n      let current = '';\n      for (const segment of segments.slice(0, -1)) {\n        current = current ? current + '/' + segment : segment;\n        scopes.push(current);\n      }\n      return scopes;\n    };\n\n    const matchesScopes = (doc, scopes) => {\n      if (!scopes.length) return true;\n      const docScopes = new Set(getScopesForDoc(doc));\n      return scopes.some((scope) => docScopes.has(scope));\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      await loadSearchIndex();\n      if (!searchIndex) {\n        searchResults.innerHTML = '<div class=\"search-empty\">Search index not available</div>';\n        return;\n      }\n\n      const parsedQuery = parseScopedQuery(query);\n      if (!parsedQuery.text && parsedQuery.scopes.length === 0) {\n        searchResults.innerHTML = '';\n        results = [];\n        return;\n      }\n\n      const tokens = tokenize(parsedQuery.text);\n      const k1 = 1.2, b = 0.75;\n      const docScores = new Map();\n\n      if (!tokens.length) {\n        searchIndex.documents.forEach((doc, docIdx) => {\n          if (matchesScopes(doc, parsedQuery.scopes)) {\n            docScores.set(docIdx, { score: 0, matches: new Set() });\n          }\n        });\n      }\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            if (!matchesScopes(doc, parsedQuery.scopes)) 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          const scopes = getScopesForDoc(doc);\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 = firstPos === -1 ? 0 : 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, scopes, snippet };\n        })\n        .sort((a, b) => b.score - a.score || a.title.localeCompare(b.title))\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 + (r.scopes?.length ? '<span class=\"search-result-scope\">@' + r.scopes[0] + '</span>' : '') + '</div>' +\n        (r.snippet ? '<div class=\"search-result-snippet\">' + r.snippet + '</div>' : '') +\n        '</a>'\n      ).join('');\n    };\n\n    // Event listeners\n    if (searchButton) searchButton.addEventListener('click', openSearch);\n    if (searchClose) searchClose.addEventListener('click', closeSearch);\n    if (searchOverlay) searchOverlay.addEventListener('click', (e) => { if (e.target === searchOverlay) closeSearch(); });\n\n    let searchTimeout = null;\n    if (searchInput) {\n      searchInput.addEventListener('input', () => {\n        if (searchTimeout) clearTimeout(searchTimeout);\n        searchTimeout = setTimeout(() => performSearch(searchInput.value), 150);\n      });\n      searchInput.addEventListener('keydown', (e) => {\n        if (e.key === 'Escape') closeSearch();\n        else if (e.key === 'ArrowDown') {\n          e.preventDefault();\n          if (selectedIndex < results.length - 1) { selectedIndex++; renderResults(); }\n        } else if (e.key === 'ArrowUp') {\n          e.preventDefault();\n          if (selectedIndex > 0) { selectedIndex--; renderResults(); }\n        } else if (e.key === 'Enter' && results[selectedIndex]) {\n          e.preventDefault();\n          window.location.href = results[selectedIndex].url;\n        }\n      });\n    }\n\n    // Global keyboard shortcut (/ or Cmd+K)\n    document.addEventListener('keydown', (e) => {\n      if ((e.key === '/' && !(e.target instanceof HTMLInputElement)) ||\n          ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === 'k')) {\n        e.preventDefault();\n        openSearch();\n      }\n    });\n  </script>\n</body>\n</html>";
+/**
+ * Resolves SSG options with defaults.
+ */
+declare function resolveSsgOptions(ssg: SsgOptions | boolean | undefined): ResolvedSsgOptions;
+/**
+ * Builds all markdown files to static HTML.
+ */
+declare function buildSsg(options: ResolvedOptions, root: string): Promise<{
+  files: string[];
+  errors: string[];
+}>;
+//#endregion
+//#region src/search.d.ts
+/**
+ * Resolves search options with defaults.
+ */
+declare function resolveSearchOptions(options: SearchOptions | boolean | undefined): ResolvedSearchOptions;
+/**
+ * Builds the search index from Markdown files.
+ */
+declare function buildSearchIndex(srcDir: string, base: string): Promise<string>;
+/**
+ * Writes the search index to a file.
+ */
+declare function writeSearchIndex(indexJson: string, outDir: string): Promise<void>;
+//#endregion
+//#region src/jsx-runtime.d.ts
+/**
+ * Custom JSX Runtime for Static HTML Generation
+ *
+ * This module provides a JSX runtime that outputs static HTML strings.
+ * No React, no hydration, no client-side JavaScript - just pure HTML.
+ *
+ * @example
+ * ```tsx
+ * // tsconfig.json or vite.config.ts
+ * {
+ *   "compilerOptions": {
+ *     "jsx": "react-jsx",
+ *     "jsxImportSource": "@ox-content/vite-plugin"
+ *   }
+ * }
+ *
+ * // MyComponent.tsx
+ * export function Hero({ title }: { title: string }) {
+ *   return (
+ *     <section class="hero">
+ *       <h1>{title}</h1>
+ *     </section>
+ *   );
+ * }
+ * ```
+ */
+/**
+ * JSX element type - either a string (intrinsic) or a function component.
+ */
+type JSXElementType = string | ((props: Record<string, unknown>) => JSXNode);
+/**
+ * Valid JSX child types.
+ */
+type JSXChild = string | number | boolean | null | undefined | JSXNode | JSXChild[];
+/**
+ * JSX node - the result of JSX expressions.
+ */
+interface JSXNode {
+  __html: string;
+}
+/**
+ * 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;
+//#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;
+//#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;
+//#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>;
+//#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>;
+//#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>;
+//#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 = "";
+//#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>;
+//#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[];
+}
+/**
+ * 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;
+//#endregion
+//#region src/og-image/types.d.ts
+/**
+ * Type definitions for Chromium-based OG image generation.
+ */
+/**
+ * Props passed to OG image template functions.
+ */
+interface OgImageTemplateProps {
+  /** Page title */
+  title: string;
+  /** Page description */
+  description?: string;
+  /** Site name */
+  siteName?: string;
+  /** Author name */
+  author?: string;
+  /** Tags/categories */
+  tags?: string[];
+  /** Custom data from frontmatter (arbitrary key-value pairs) */
+  [key: string]: unknown;
+}
+/**
+ * Template function that receives page metadata and returns an HTML string.
+ */
+type OgImageTemplateFn = (props: OgImageTemplateProps) => string | Promise<string>;
+/**
+ * OG image generation options (user-facing).
+ */
+interface OgImageOptions$1 {
+  /**
+   * Path to a custom template file (.ts, .vue, .svelte, .tsx/.jsx).
+   * - `.ts`: default-export a function `(props) => string`
+   * - `.vue`: Vue SFC, rendered via SSR
+   * - `.svelte`: Svelte SFC, rendered via SSR
+   * - `.tsx`/`.jsx`: React Server Component, rendered via SSR
+   * If not specified, the built-in default template is used.
+   */
+  template?: string;
+  /**
+   * Vue plugin to use for compiling `.vue` templates.
+   * - `'vitejs'`: Use `@vue/compiler-sfc` (official, default)
+   * - `'vizejs'`: Use `@vizejs/vite-plugin` (Rust-based)
+   * @default 'vitejs'
+   */
+  vuePlugin?: "vitejs" | "vizejs";
+  /**
+   * Image width in pixels.
+   * @default 1200
+   */
+  width?: number;
+  /**
+   * Image height in pixels.
+   * @default 630
+   */
+  height?: number;
+  /**
+   * Enable content-hash based caching.
+   * Skips rendering when content hasn't changed.
+   * @default true
+   */
+  cache?: boolean;
+  /**
+   * Number of concurrent page instances for parallel rendering.
+   * @default 1
+   */
+  concurrency?: number;
+}
+/**
+ * Resolved OG image options with all defaults applied.
+ */
+interface ResolvedOgImageOptions {
+  template?: string;
+  vuePlugin: "vitejs" | "vizejs";
+  width: number;
+  height: number;
+  cache: boolean;
+  concurrency: number;
+}
+//#endregion
+//#region src/og-image/browser.d.ts
+/**
+ * Chromium browser session with automatic cleanup via Explicit Resource Management.
+ *
+ * Usage:
+ *   await using session = await openBrowser();
+ *   const png = await session.renderPage(html, 1200, 630);
+ *   // browser.close() is called automatically when session goes out of scope
+ */
+/**
+ * A browser session that can render HTML pages to PNG.
+ * Implements AsyncDisposable for automatic cleanup via `await using`.
+ */
+interface OgBrowserSession extends AsyncDisposable {
+  renderPage(html: string, width: number, height: number, publicDir?: string): Promise<Buffer>;
+}
+//#endregion
+//#region src/og-image/index.d.ts
+/**
+ * Resolves user-provided OG image options with defaults.
+ */
+declare function resolveOgImageOptions(options: OgImageOptions$1 | undefined): ResolvedOgImageOptions;
+/**
+ * A single page entry for batch OG image generation.
+ */
+interface OgImagePageEntry {
+  /** Props to pass to the template */
+  props: OgImageTemplateProps;
+  /** Absolute path to write the output PNG */
+  outputPath: string;
+}
+/**
+ * Result of OG image generation for a single page.
+ */
+interface OgImageResult {
+  outputPath: string;
+  cached: boolean;
+  error?: string;
+}
+/**
+ * Generates OG images for a batch of pages.
+ *
+ * Manages the full lifecycle: resolve template → launch browser (with `using`) →
+ * render each page (with caching and concurrency).
+ *
+ * All errors are non-fatal: failures are reported in results but never throw.
+ */
+declare function generateOgImages(pages: OgImagePageEntry[], options: ResolvedOgImageOptions, root: string): Promise<OgImageResult[]>;
+//#endregion
+//#region src/i18n.d.ts
+/**
+ * Resolves i18n options with defaults.
+ */
+declare function resolveI18nOptions(options: I18nOptions | false | undefined): ResolvedI18nOptions | false;
+/**
+ * Creates the i18n sub-plugin for the Vite plugin array.
+ */
+declare function createI18nPlugin(resolvedOptions: ResolvedOptions): Plugin;
+//#endregion
+//#region src/index.d.ts
+/**
+ * Creates the Ox Content Vite plugin.
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { defineConfig } from 'vite';
+ * import { oxContent } from '@ox-content/vite-plugin';
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     oxContent({
+ *       srcDir: 'content',
+ *       gfm: true,
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+declare function oxContent(options?: OxContentOptions): Plugin[];
+//#endregion
+export { type BasePageProps, CodeAnnotationKind, type CodeAnnotationSyntax, type CodeAnnotationsOptions, DEFAULT_HTML_TEMPLATE, DefaultTheme, type DocEntry, type DocsOptions, type EntryPageConfig, type ExtractedDocs, type FeatureConfig, Fragment, type FrontmatterSchema, GeneratedDocsData, type GitHubOptions, type GitHubRepoData, type HeroAction, type HeroConfig, type HeroImage, HeroNotice, type I18nOptions, type IslandInfo, type JSXChild, type JSXElementType, type JSXNode, type JSXProps, type LanguageRegistration, type LoadStrategy, type LocaleConfig, MarkdownNode, MarkdownTransformer, type MermaidOptions, type NavGroup, type NavItem, type OgBrowserSession, type OgImageOptions, type OgImagePageEntry, type OgImageOptions$1 as OgImagePluginOptions, type OgImageResult, type OgImageTemplateFn, type OgImageTemplateProps, type OgpData, type OgpOptions, type OxContentOptions, type PageData, type PageProps, type ParamDoc, type ParseIslandsResult, type RenderContext, type ResolvedCodeAnnotationsOptions, type ResolvedDocsOptions, type ResolvedI18nOptions, type ResolvedOgImageOptions, ResolvedOptions, type ResolvedSearchOptions, type ResolvedSsgOptions, type ResolvedThemeConfig, type ReturnDoc, ScopedSearchQuery, type SearchDocument, type SearchOptions, type SearchResult, type SiteConfig, type SocialLinks, type SsgOptions, type ThemeColors, type ThemeComponent, type ThemeConfig, type ThemeEmbed, type ThemeEntryPage, type ThemeFonts, type ThemeFooter, type ThemeHeader, type ThemeLayout, type ThemeProps, type ThemeRegistration, type ThemeRenderOptions, TocEntry, type TransformAllOptions, TransformContext, TransformResult, type YouTubeOptions, buildSearchIndex, buildSsg, clearRenderContext, collectGitHubRepos, collectOgpUrls, createI18nPlugin, createMarkdownEnvironment, createTheme, defaultTheme, defineTheme, each, extractDocs, extractIslandInfo, extractVideoId, fetchOgpData, fetchRepoData, generateFrontmatterTypes, generateHydrationScript, generateMarkdown, generateOgImages, generateTabsCSS, generateTypes, hasIslands, inferType, jsx, jsxs, mergeThemes, mermaidClientScript, oxContent, prefetchGitHubRepos, prefetchOgpData, raw, renderAllPages, renderPage, renderToString, resolveDocsOptions, resolveI18nOptions, resolveOgImageOptions, resolveSearchOptions, resolveSsgOptions, resolveTheme, setRenderContext, transformAllPlugins, transformGitHub, transformIslands, transformMarkdown, transformMermaidStatic, transformOgp, transformTabs, transformYouTube, useIsActive, useNav, usePageProps, useRenderContext, useSiteConfig, when, writeDocs, writeSearchIndex };
+//# sourceMappingURL=index.d.mts.map