@ox-content/vite-plugin 2.88.0 → 2.89.0

package/dist/index.cjs

@@ -2767,6 +2767,45 @@ async function resolveTemplate(options, root) {
 	}
 }
 /**
+* Matches this package and every subpath it exports.
+*
+* A template's natural runtime is whatever renders it, and for the
+* framework-less kinds that is this package: `renderToString`, `raw`, `when`
+* and `each` live at its root, and the JSX runtime under `./jsx-runtime`.
+* Inlining them instead drags the entire plugin — chokidar, fsevents and all
+* — into the template bundle, which is what made importing it fail outright.
+*/
+const OX_CONTENT_PACKAGE = /^@ox-content\/vite-plugin(\/.*)?$/;
+/**
+* Whether `id` is a bare specifier, and so resolvable at runtime rather than
+* something the template bundle has to inline.
+*
+* Template bundles are written to `<root>/.cache/og-images/` and imported
+* from there, so Node resolves anything left external against the project's
+* own `node_modules`. Relative and absolute imports still bundle, which is
+* what a template actually needs — its own components travel with it.
+*/
+function isBareSpecifier(id) {
+	if (id.startsWith(".") || id.startsWith("/") || id.startsWith("\0")) return false;
+	return !/^[a-zA-Z]:[\\/]/.test(id);
+}
+/**
+* Rolldown input options for a `.ts` template bundle.
+*
+* A `.ts` template is the framework-less kind, so it has no single runtime to
+* externalize the way the `.vue`, `.svelte` and `.tsx` paths do — anything
+* from `node_modules` is better resolved at import time than inlined. Nothing
+* on this path has a compiler plugin, so nothing here needed bundling to be
+* loadable in the first place.
+*/
+function tsTemplateBundleOptions(templatePath) {
+	return {
+		input: templatePath,
+		platform: "node",
+		external: (id) => isBareSpecifier(id)
+	};
+}
+/**
 * Resolves a plain TypeScript template (existing behavior).
 */
 async function resolveTsTemplate(templatePath, options, root) {
@@ -2775,10 +2814,7 @@ async function resolveTsTemplate(templatePath, options, root) {
 	const cacheDir = path.join(root, ".cache", "og-images");
 	await fs.mkdir(cacheDir, { recursive: true });
 	const outfile = path.join(cacheDir, "_template.mjs");
-	const bundle = await rolldown({
-		input: templatePath,
-		platform: "node"
-	});
+	const bundle = await rolldown(tsTemplateBundleOptions(templatePath));
 	await bundle.write({
 		file: outfile,
 		format: "esm"
@@ -2800,11 +2836,16 @@ async function resolveVueTemplate(templatePath, options, root) {
 	const cacheDir = path.join(root, ".cache", "og-images");
 	await fs.mkdir(cacheDir, { recursive: true });
 	const outfile = path.join(cacheDir, "_template_vue.mjs");
+	const plugins = options.vuePlugin === "vizejs" ? await getVizejsPlugin() : [createVueCompilerPlugin()];
 	const bundle = await rolldown({
 		input: templatePath,
 		platform: "node",
-		external: ["vue", "vue/server-renderer"],
-		plugins: options.vuePlugin === "vizejs" ? await getVizejsPlugin() : [createVueCompilerPlugin()]
+		external: [
+			"vue",
+			"vue/server-renderer",
+			OX_CONTENT_PACKAGE
+		],
+		plugins
 	});
 	await bundle.write({
 		file: outfile,
@@ -2906,7 +2947,8 @@ async function resolveSvelteTemplate(templatePath, root) {
 			"svelte",
 			"svelte/server",
 			"svelte/internal",
-			"svelte/internal/server"
+			"svelte/internal/server",
+			OX_CONTENT_PACKAGE
 		],
 		plugins: [createSvelteCompilerPlugin()]
 	});
@@ -2965,7 +3007,8 @@ async function resolveReactTemplate(templatePath, root) {
 			"react/jsx-runtime",
 			"react/jsx-dev-runtime",
 			"react-dom",
-			"react-dom/server"
+			"react-dom/server",
+			OX_CONTENT_PACKAGE
 		],
 		transform: { jsx: "react-jsx" }
 	});
@@ -3297,674 +3340,724 @@ initIslands((el, props) => {
 `;
 }
 //#endregion
-//#region src/ssg.ts
-/**
-* SSG (Static Site Generation) module for ox-content
-*/
+//#region src/page-context.ts
+var page_context_exports = /* @__PURE__ */ require_vitepress.__exportAll({
+	clearRenderContext: () => clearRenderContext,
+	generateFrontmatterTypes: () => generateFrontmatterTypes,
+	inferType: () => inferType,
+	setRenderContext: () => setRenderContext,
+	useIsActive: () => useIsActive,
+	useNav: () => useNav,
+	usePageProps: () => usePageProps,
+	useRenderContext: () => useRenderContext,
+	useSiteConfig: () => useSiteConfig
+});
 /**
-* Deprecated compatibility export for consumers that imported the former
-* TypeScript SSG template. HTML generation is Rust-backed now.
-*
-* @deprecated Use `generateHtmlPage`/`buildSsg` instead.
+* Sets the current render context.
+* Called internally during page rendering.
+* @internal
 */
-const DEFAULT_HTML_TEMPLATE = "<!-- ox-content default HTML template is Rust-backed -->";
+function setRenderContext(ctx) {
+	currentContext = ctx;
+}
 /**
-* Resolves SSG options with defaults.
+* Clears the current render context.
+* Called internally after page rendering.
+* @internal
 */
-function resolveSsgOptions(ssg) {
-	if (ssg === false) return {
-		enabled: false,
-		extension: ".html",
-		clean: false,
-		bare: false,
-		generateOgImage: false,
-		lastUpdated: false
-	};
-	if (ssg === true || ssg === void 0) return {
-		enabled: true,
-		extension: ".html",
-		clean: false,
-		bare: false,
-		generateOgImage: false,
-		lastUpdated: false,
-		theme: require_vitepress.resolveTheme(void 0)
-	};
-	return {
-		enabled: ssg.enabled ?? true,
-		extension: ssg.extension ?? ".html",
-		clean: ssg.clean ?? false,
-		bare: ssg.bare ?? false,
-		siteName: ssg.siteName,
-		ogImage: ssg.ogImage,
-		generateOgImage: ssg.generateOgImage ?? false,
-		lastUpdated: ssg.lastUpdated ?? false,
-		siteUrl: ssg.siteUrl,
-		theme: require_vitepress.resolveTheme(ssg.theme),
-		navigation: ssg.navigation
-	};
+function clearRenderContext() {
+	currentContext = null;
 }
 /**
-* Extracts title from content or frontmatter.
+* 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>;
+* }
+* ```
 */
-function extractTitle$1(content, frontmatter) {
-	return require_vitepress.importNapiModuleSync().extractSsgTitle(content, typeof frontmatter.title === "string" ? frontmatter.title : void 0);
+function usePageProps() {
+	if (!currentContext) throw new Error("[ox-content] usePageProps() must be called during page rendering. Make sure you are using it inside a theme component.");
+	return currentContext.page;
 }
 /**
-* Generates bare HTML page (no navigation, no styles).
+* 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>;
+* }
+* ```
 */
-function generateBareHtmlPage(content, title) {
-	return require_vitepress.importNapiModuleSync().generateSsgBareHtml(content, title);
+function useSiteConfig() {
+	if (!currentContext) throw new Error("[ox-content] useSiteConfig() must be called during page rendering. Make sure you are using it inside a theme component.");
+	return currentContext.site;
 }
 /**
-* Per-build cache for the Rust-facing nav conversion. `navGroups` is the same
-* `context.navItems` reference for every page in a build, so the deep recursive
-* copy below only needs to run once per build instead of once per page.
+* 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>
+*   );
+* }
+* ```
 */
-const navGroupsForRustCache = /* @__PURE__ */ new WeakMap();
-function toRustNavItem(item) {
-	return {
-		title: item.title,
-		path: item.path,
-		href: item.href,
-		children: item.children?.map(toRustNavItem),
-		collapsed: item.collapsed,
-		stickyCollapsed: item.stickyCollapsed
-	};
-}
-function convertNavGroupsForRust(navGroups) {
-	const cached = navGroupsForRustCache.get(navGroups);
-	if (cached) return cached;
-	const converted = navGroups.map((group) => ({
-		title: group.title,
-		collapsed: group.collapsed,
-		stickyCollapsed: group.stickyCollapsed,
-		items: group.items.map(toRustNavItem)
-	}));
-	navGroupsForRustCache.set(navGroups, converted);
-	return converted;
+function useRenderContext() {
+	if (!currentContext) throw new Error("[ox-content] useRenderContext() must be called during page rendering. Make sure you are using it inside a theme component.");
+	return currentContext;
 }
 /**
-* Converts a `TocEntry` tree into the plain shape the Rust binding expects.
-* Hoisted to module scope so it isn't reallocated for every page; the
-* per-page `.map` over `pageData.toc` still runs since the TOC is page-specific.
+* 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>
+*   );
+* }
+* ```
 */
-function toRustTocEntry(entry) {
-	return {
-		depth: entry.depth,
-		text: entry.text,
-		slug: entry.slug,
-		children: entry.children?.map(toRustTocEntry) ?? []
-	};
+function useNav() {
+	return useSiteConfig().nav;
 }
 /**
-* Per-build cache for the Rust-facing locale list. `i18n.locales` is the same
-* reference for every page in a build, so this mapping (and the `?? "ltr"`
-* default) only runs once per build instead of once per page.
+* 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>;
+* }
+* ```
 */
-const rustLocalesCache = /* @__PURE__ */ new WeakMap();
-function toRustLocales(locales) {
-	const cached = rustLocalesCache.get(locales);
-	if (cached) return cached;
-	const converted = locales.map((locale) => ({
-		code: locale.code,
-		name: locale.name,
-		dir: locale.dir ?? "ltr"
-	}));
-	rustLocalesCache.set(locales, converted);
-	return converted;
+function useIsActive(path) {
+	const page = usePageProps();
+	return page.path === path || page.url === path;
 }
 /**
-* Per-build cache for the locale-code list passed to `getSsgPageLocale`. The
-* `i18n.locales` reference is stable across a build, so the `.map` to codes
-* runs once instead of once per page.
+* Infers TypeScript types from frontmatter values.
 */
-const localeCodesCache = /* @__PURE__ */ new WeakMap();
-function localeCodesFor(locales) {
-	const cached = localeCodesCache.get(locales);
-	if (cached) return cached;
-	const codes = locales.map((locale) => locale.code);
-	localeCodesCache.set(locales, codes);
-	return codes;
+function inferType(value) {
+	if (value === null) return "null";
+	if (value === void 0) return "undefined";
+	if (typeof value === "string") return "string";
+	if (typeof value === "number") return "number";
+	if (typeof value === "boolean") return "boolean";
+	if (Array.isArray(value)) {
+		if (value.length === 0) return "unknown[]";
+		const itemTypes = [...new Set(value.map(inferType))];
+		if (itemTypes.length === 1) return `${itemTypes[0]}[]`;
+		return `(${itemTypes.join(" | ")})[]`;
+	}
+	if (typeof value === "object") {
+		const entries = Object.entries(value);
+		if (entries.length === 0) return "Record<string, unknown>";
+		return `{ ${entries.map(([k, v]) => `${k}: ${inferType(v)}`).join("; ")} }`;
+	}
+	return "unknown";
 }
 /**
-* Generates HTML page with navigation using Rust NAPI bindings.
+* Generates TypeScript interface from frontmatter samples.
 */
-async function generateHtmlPage(pageData, navGroups, siteName, base, ogImage, theme, locale, availableLocales) {
-	const mod = await require_vitepress.importNapiModule();
-	const tocForRust = pageData.toc.map(toRustTocEntry);
-	const navGroupsForRust = convertNavGroupsForRust(navGroups);
-	const themeForRust = theme ? require_vitepress.themeToNapi(theme) : void 0;
-	const entryPageForRust = pageData.entryPage ? {
-		hero: pageData.entryPage.hero ? {
-			name: pageData.entryPage.hero.name,
-			text: pageData.entryPage.hero.text,
-			tagline: pageData.entryPage.hero.tagline,
-			notice: pageData.entryPage.hero.notice ? {
-				title: pageData.entryPage.hero.notice.title,
-				body: pageData.entryPage.hero.notice.body
-			} : void 0,
-			image: pageData.entryPage.hero.image ? {
-				src: pageData.entryPage.hero.image.src,
-				lightSrc: pageData.entryPage.hero.image.lightSrc,
-				darkSrc: pageData.entryPage.hero.image.darkSrc,
-				alt: pageData.entryPage.hero.image.alt,
-				width: pageData.entryPage.hero.image.width,
-				height: pageData.entryPage.hero.image.height
-			} : void 0,
-			actions: pageData.entryPage.hero.actions?.map((a) => ({
-				theme: a.theme,
-				text: a.text,
-				link: a.link
-			}))
-		} : void 0,
-		features: pageData.entryPage.features?.map((f) => ({
-			icon: f.icon,
-			title: f.title,
-			details: f.details,
-			link: f.link,
-			linkText: f.linkText
-		}))
-	} : void 0;
-	return mod.generateSsgHtml({
-		title: pageData.title,
-		description: pageData.description,
-		content: pageData.content,
-		toc: tocForRust,
-		lastUpdated: pageData.lastUpdated,
-		path: pageData.path,
-		entryPage: entryPageForRust
-	}, navGroupsForRust, {
-		siteName,
-		base,
-		ogImage,
-		theme: themeForRust,
-		locale,
-		availableLocales: availableLocales ? toRustLocales(availableLocales) : void 0
-	});
-}
-async function externalizeSharedPageAssets(pages, outDir, base) {
-	const optimized = (await require_vitepress.importNapiModule()).externalizeSsgAssets(pages, outDir, base);
-	await Promise.all(optimized.assets.map(async (asset) => {
-		await fs_promises.mkdir(path.dirname(asset.outputPath), { recursive: true });
-		await fs_promises.writeFile(asset.outputPath, asset.content, "utf-8");
-	}));
-	return {
-		pages: optimized.pages,
-		assets: optimized.assets.map((asset) => asset.outputPath)
-	};
+function generateFrontmatterTypes(samples, interfaceName = "PageFrontmatter") {
+	const fields = /* @__PURE__ */ new Map();
+	for (const sample of samples) for (const [key, value] of Object.entries(sample)) {
+		const existing = fields.get(key) ?? {
+			types: /* @__PURE__ */ new Set(),
+			count: 0
+		};
+		existing.types.add(inferType(value));
+		existing.count++;
+		fields.set(key, existing);
+	}
+	const lines = [
+		"/**",
+		" * Auto-generated frontmatter type based on your pages.",
+		" * DO NOT EDIT - this file is generated by ox-content.",
+		" */",
+		"",
+		`export interface ${interfaceName} {`
+	];
+	for (const [name, { types, count }] of fields) {
+		const isOptional = count < samples.length;
+		const typeStr = [...types].join(" | ");
+		const optionalMark = isOptional ? "?" : "";
+		lines.push(`  ${name}${optionalMark}: ${typeStr};`);
+	}
+	lines.push("}");
+	lines.push("");
+	lines.push(`export type PageProps = import('@ox-content/vite-plugin').PageProps<${interfaceName}>;`);
+	lines.push("");
+	return lines.join("\n");
 }
+var currentContext;
+var init_page_context = require_vitepress.__esmMin((() => {
+	currentContext = null;
+}));
+//#endregion
+//#region src/theme-renderer.ts
 /**
-* Converts a markdown file path to a relative URL path.
+* Theme Renderer for Static HTML Generation
+*
+* Renders JSX theme components to static HTML strings.
+* No client-side JavaScript is included by default.
 */
-function getUrlPath$1(inputPath, srcDir) {
-	return require_vitepress.importNapiModuleSync().getSsgUrlPath(inputPath, srcDir);
-}
+init_page_context();
 /**
-* Resolves manual navigation config to the format used by the built-in SSG renderer.
+* Renders a page using the theme component.
+*
+* @param page - Page data to render
+* @param options - Theme render options
+* @returns Rendered HTML string
 */
-function resolveNavigationGroups(navigation, base, extension) {
-	if (!navigation) return;
-	return require_vitepress.importNapiModuleSync().resolveSsgNavigationGroups(navigation, base, extension);
-}
-function getPageLocale(urlPath, i18n) {
-	if (!i18n) return void 0;
-	return require_vitepress.importNapiModuleSync().getSsgPageLocale(urlPath, i18n.defaultLocale, localeCodesFor(i18n.locales)) ?? void 0;
-}
-function getRoutePaths(inputPath, srcDir, outDir, base, extension, siteUrl) {
-	return require_vitepress.importNapiModuleSync().resolveSsgRoutePaths(inputPath, srcDir, outDir, base, extension, siteUrl);
+function renderPage(page, options) {
+	const { theme, siteName, base, nav, pages } = options;
+	setRenderContext({
+		page: {
+			title: page.title,
+			description: page.description,
+			html: page.html,
+			toc: page.toc,
+			lastUpdated: page.lastUpdated,
+			path: page.path,
+			url: page.url,
+			frontmatter: page.frontmatter,
+			layout: page.layout
+		},
+		site: {
+			name: siteName,
+			base,
+			nav,
+			pages: pages.map((p) => ({
+				title: p.title,
+				description: p.description,
+				html: p.html,
+				toc: p.toc,
+				lastUpdated: p.lastUpdated,
+				path: p.path,
+				url: p.url,
+				frontmatter: p.frontmatter,
+				layout: p.layout
+			}))
+		}
+	});
+	try {
+		const result = theme({ children: require_jsx_html.raw(page.html) });
+		const html = require_jsx_html.renderToString(result);
+		if (!html.trimStart().toLowerCase().startsWith("<!doctype")) return `<!DOCTYPE html>\n${html}`;
+		return html;
+	} finally {
+		clearRenderContext();
+	}
 }
 /**
-* Formats a file/dir name as a title.
+* 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
 */
-function formatTitle(name) {
-	return require_vitepress.importNapiModuleSync().formatSsgTitle(name);
+async function renderAllPages(pages, options) {
+	const results = /* @__PURE__ */ new Map();
+	for (const page of pages) {
+		const html = renderPage(page, {
+			...options,
+			pages
+		});
+		results.set(page.url, html);
+	}
+	if (options.typesOutDir) await generateTypes(pages, options.typesOutDir);
+	return results;
 }
 /**
-* Collects all markdown files from the source directory.
+* Generates TypeScript type definitions from page frontmatter.
+*
+* @param pages - All pages
+* @param outDir - Output directory for types
 */
-async function collectMarkdownFiles(srcDir, extensions = DEFAULT_MARKDOWN_EXTENSIONS) {
-	return require_vitepress.importNapiModuleSync().collectSsgMarkdownFiles(srcDir, [...extensions]);
+async function generateTypes(pages, outDir) {
+	const types = generateFrontmatterTypes(pages.map((p) => p.frontmatter));
+	const typesPath = (0, node_path.join)(outDir, "page-props.d.ts");
+	await (0, node_fs_promises.mkdir)((0, node_path.dirname)(typesPath), { recursive: true });
+	await (0, node_fs_promises.writeFile)(typesPath, types, "utf-8");
 }
 /**
-* Builds navigation items from markdown files, grouped by directory.
+* Default theme component.
+* A minimal theme that renders page content with basic styling.
 */
-function buildNavItems(markdownFiles, srcDir, base, extension) {
-	return require_vitepress.importNapiModuleSync().buildSsgNavItems(markdownFiles, srcDir, base, extension);
+function DefaultTheme({ children }) {
+	const { usePageProps, useSiteConfig } = (init_page_context(), require_vitepress.__toCommonJS(page_context_exports));
+	const page = usePageProps();
+	const site = useSiteConfig();
+	return { __html: `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${escapeHtml(page.title)} - ${escapeHtml(site.name)}</title>
+  ${page.description ? `<meta name="description" content="${escapeHtml(page.description)}">` : ""}
+  <style>
+    :root {
+      --octc-color-primary: #4f6fae;
+      --octc-color-text: #131a30;
+      --octc-color-bg: #ffffff;
+      --octc-color-bg-alt: #f5f7fb;
+      --octc-color-text-muted: #4f607b;
+      --octc-color-border: #d2dbea;
+    }
+    body {
+      font-family: "IBM Plex Sans", "Avenir Next", "Segoe UI Variable", "Segoe UI", sans-serif;
+      line-height: 1.7;
+      color: var(--octc-color-text);
+      background: var(--octc-color-bg);
+      max-width: 800px;
+      margin: 0 auto;
+      padding: 2rem;
+    }
+    a { color: var(--octc-color-primary); }
+  </style>
+</head>
+<body>
+  <header>
+    <h1>${escapeHtml(site.name)}</h1>
+  </header>
+  <main>
+    ${children.__html}
+  </main>
+</body>
+</html>` };
 }
-/**
-* Builds navigation items from an explicit theme sidebar tree.
-*/
-function buildThemeNavItems(sidebar, base, extension) {
-	return require_vitepress.importNapiModuleSync().buildSsgThemeNavItems(sidebar, base, extension);
+function escapeHtml(str) {
+	return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
 /**
-* Builds all markdown files to static HTML.
-*/
-async function buildSsg(options, root) {
-	const ssgOptions = options.ssg;
-	if (!ssgOptions.enabled) return {
-		files: [],
-		errors: []
-	};
-	const srcDir = path.resolve(root, options.srcDir);
-	const outDir = path.resolve(root, options.outDir);
-	const generatedFiles = [];
-	const errors = [];
-	await cleanOutputDirectory(ssgOptions, outDir);
-	const markdownFiles = await collectMarkdownFiles(srcDir, options.extensions);
-	const context = await createBuildSsgContext(options, root, srcDir, outDir, markdownFiles);
-	const collected = await collectPageResults(context, markdownFiles);
-	errors.push(...collected.errors);
-	await generateOgImageAssets(context, collected, generatedFiles, errors);
-	await writeGeneratedPages(await generateHtmlPages(context, collected.pageResults, collected, errors), context, generatedFiles);
-	return {
-		files: generatedFiles,
-		errors
+* 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,
+*   },
+* });
+* ```
+*/
+function createTheme(config) {
+	const { layouts, defaultLayout = "default" } = config;
+	return function ThemeWithLayouts({ children }) {
+		const layoutName = usePageProps().layout ?? defaultLayout;
+		const Layout = layouts[layoutName] ?? layouts[defaultLayout];
+		if (!Layout) throw new Error(`[ox-content] Layout "${layoutName}" not found. Available layouts: ${Object.keys(layouts).join(", ")}`);
+		return Layout({ children });
 	};
 }
-async function cleanOutputDirectory(ssgOptions, outDir) {
-	if (!ssgOptions.clean) return;
-	try {
-		await fs_promises.rm(outDir, {
-			recursive: true,
-			force: true
-		});
-	} catch {}
-}
-async function createBuildSsgContext(options, root, srcDir, outDir, markdownFiles) {
-	const ssgOptions = options.ssg;
-	const base = options.base.endsWith("/") ? options.base : options.base + "/";
+//#endregion
+//#region src/ssg.ts
+/**
+* SSG (Static Site Generation) module for ox-content
+*/
+/**
+* Deprecated compatibility export for consumers that imported the former
+* TypeScript SSG template. HTML generation is Rust-backed now.
+*
+* @deprecated Use `generateHtmlPage`/`buildSsg` instead.
+*/
+const DEFAULT_HTML_TEMPLATE = "<!-- ox-content default HTML template is Rust-backed -->";
+/**
+* Resolves SSG options with defaults.
+*/
+function resolveSsgOptions(ssg) {
+	if (ssg === false) return {
+		enabled: false,
+		extension: ".html",
+		clean: false,
+		bare: false,
+		generateOgImage: false,
+		lastUpdated: false
+	};
+	if (ssg === true || ssg === void 0) return {
+		enabled: true,
+		extension: ".html",
+		clean: false,
+		bare: false,
+		generateOgImage: false,
+		lastUpdated: false,
+		theme: require_vitepress.resolveTheme(void 0)
+	};
 	return {
-		options,
-		ssgOptions,
-		root,
-		srcDir,
-		outDir,
-		base,
-		navItems: resolveNavigationGroups(ssgOptions.navigation, base, ssgOptions.extension) ?? (ssgOptions.theme?.sidebar.length ? buildThemeNavItems(ssgOptions.theme.sidebar, base, ssgOptions.extension) : buildNavItems(markdownFiles, srcDir, base, ssgOptions.extension)),
-		siteName: await resolveSiteName$1(root, ssgOptions),
-		shouldGenerateOgImages: shouldGenerateOgImages(options),
-		napi: ssgOptions.lastUpdated ? await require_vitepress.importNapiModule() : void 0
+		enabled: ssg.enabled ?? true,
+		extension: ssg.extension ?? ".html",
+		clean: ssg.clean ?? false,
+		bare: ssg.bare ?? false,
+		render: ssg.render,
+		lang: ssg.lang,
+		head: ssg.head,
+		bodyStart: ssg.bodyStart,
+		bodyEnd: ssg.bodyEnd,
+		siteName: ssg.siteName,
+		ogImage: ssg.ogImage,
+		generateOgImage: ssg.generateOgImage ?? false,
+		lastUpdated: ssg.lastUpdated ?? false,
+		siteUrl: ssg.siteUrl,
+		theme: require_vitepress.resolveTheme(ssg.theme),
+		navigation: ssg.navigation
 	};
 }
 /**
-* Whether this build emits one Open Graph image per page.
-*
-* `ssg.bare` deliberately does not turn this off. Bare mode only drops the
-* generated page shell, and bringing your own shell is exactly the case where
-* per-page OG images are still wanted — the images are written to the output
-* tree and the consumer injects the `<meta>` tags itself. Nothing in the bare
-* HTML references them, because bare output has no `<head>` to put them in.
+* Extracts title from content or frontmatter.
 */
-function shouldGenerateOgImages(options) {
-	return options.ogImage || options.ssg.generateOgImage;
+function extractTitle$1(content, frontmatter) {
+	return require_vitepress.importNapiModuleSync().extractSsgTitle(content, typeof frontmatter.title === "string" ? frontmatter.title : void 0);
 }
-async function resolveSiteName$1(root, ssgOptions) {
-	if (ssgOptions.siteName) return ssgOptions.siteName;
-	try {
-		const pkgPath = path.join(root, "package.json");
-		const pkg = JSON.parse(await fs_promises.readFile(pkgPath, "utf-8"));
-		return pkg.name ? formatTitle(pkg.name) : "Documentation";
-	} catch {
-		return "Documentation";
-	}
+/**
+* Generates a bare HTML page carrying head metadata and injected markup.
+*
+* Bare mode leaves the shell to the consumer, but the metadata here is
+* already computed for the themed page and cannot be recovered afterwards —
+* the generated OG image in particular was only discoverable by guessing at
+* the output directory. A page with none of it set renders exactly what bare
+* mode emitted before, which keeps the no-JS size baseline honest.
+*/
+function generateBarePage(page) {
+	return require_vitepress.importNapiModuleSync().generateSsgBarePage(page);
 }
-async function collectPageResults(context, markdownFiles) {
-	const collected = {
-		pageResults: [],
-		ogImageEntries: [],
-		ogImageInputPaths: [],
-		ogImageUrlMap: /* @__PURE__ */ new Map(),
-		errors: []
+/**
+* Per-build cache for the Rust-facing nav conversion. `navGroups` is the same
+* `context.navItems` reference for every page in a build, so the deep recursive
+* copy below only needs to run once per build instead of once per page.
+*/
+const navGroupsForRustCache = /* @__PURE__ */ new WeakMap();
+function toRustNavItem(item) {
+	return {
+		title: item.title,
+		path: item.path,
+		href: item.href,
+		children: item.children?.map(toRustNavItem),
+		collapsed: item.collapsed,
+		stickyCollapsed: item.stickyCollapsed
 	};
-	for (const inputPath of markdownFiles) try {
-		const pageResult = await transformSsgPage(context, inputPath);
-		collected.pageResults.push(pageResult);
-		collectOgImageEntry(context, pageResult, collected);
-	} catch (err) {
-		const errorMessage = err instanceof Error ? err.message : String(err);
-		collected.errors.push(`Failed to process ${inputPath}: ${errorMessage}`);
-	}
-	return collected;
 }
-async function transformSsgPage(context, inputPath) {
-	const result = await transformMarkdown(await fs_promises.readFile(inputPath, "utf-8"), inputPath, context.options, {
-		convertMdLinks: true,
-		baseUrl: context.base,
-		sourcePath: inputPath
-	});
-	const frontmatter = require_vitepress.normalizeVitePressFrontmatter(result.frontmatter);
-	const transformedHtml = await transformSsgHtml(result.html, context.options);
-	const title = extractTitle$1(transformedHtml, frontmatter);
+function convertNavGroupsForRust(navGroups) {
+	const cached = navGroupsForRustCache.get(navGroups);
+	if (cached) return cached;
+	const converted = navGroups.map((group) => ({
+		title: group.title,
+		collapsed: group.collapsed,
+		stickyCollapsed: group.stickyCollapsed,
+		items: group.items.map(toRustNavItem)
+	}));
+	navGroupsForRustCache.set(navGroups, converted);
+	return converted;
+}
+/**
+* Converts a `TocEntry` tree into the plain shape the Rust binding expects.
+* Hoisted to module scope so it isn't reallocated for every page; the
+* per-page `.map` over `pageData.toc` still runs since the TOC is page-specific.
+*/
+function toRustTocEntry(entry) {
 	return {
-		inputPath,
-		routePaths: getRoutePaths(inputPath, context.srcDir, context.outDir, context.base, context.ssgOptions.extension, context.ssgOptions.siteUrl),
-		transformedHtml,
-		title,
-		description: frontmatter.description,
-		lastUpdated: context.napi?.getGitLastUpdated(inputPath, context.root) ?? void 0,
-		frontmatter,
-		toc: result.toc
+		depth: entry.depth,
+		text: entry.text,
+		slug: entry.slug,
+		children: entry.children?.map(toRustTocEntry) ?? []
 	};
 }
-async function transformSsgHtml(html, options) {
-	const { html: protectedHtml, svgs: mermaidSvgs } = protectMermaidSvgs(html);
-	let transformedHtml = await transformAllPlugins(protectedHtml, {
-		tabs: true,
-		youtube: true,
-		github: options.embeds.github,
-		openGraph: options.embeds.openGraph,
-		pm: options.embeds.pm,
-		spotify: options.embeds.spotify,
-		stackBlitz: options.embeds.stackBlitz,
-		twitter: options.embeds.twitter,
-		bluesky: options.embeds.bluesky,
-		webContainer: options.embeds.webContainer,
-		mermaid: true,
-		githubToken: process.env.GITHUB_TOKEN
-	});
-	if (hasIslands(transformedHtml)) transformedHtml = (await transformIslands(transformedHtml)).html;
-	return restoreMermaidSvgs(transformedHtml, mermaidSvgs);
+/**
+* Per-build cache for the Rust-facing locale list. `i18n.locales` is the same
+* reference for every page in a build, so this mapping (and the `?? "ltr"`
+* default) only runs once per build instead of once per page.
+*/
+const rustLocalesCache = /* @__PURE__ */ new WeakMap();
+function toRustLocales(locales) {
+	const cached = rustLocalesCache.get(locales);
+	if (cached) return cached;
+	const converted = locales.map((locale) => ({
+		code: locale.code,
+		name: locale.name,
+		dir: locale.dir ?? "ltr"
+	}));
+	rustLocalesCache.set(locales, converted);
+	return converted;
 }
-function collectOgImageEntry(context, pageResult, collected) {
-	if (!context.shouldGenerateOgImages) return;
-	const { layout: _layout, ...frontmatterRest } = pageResult.frontmatter;
-	collected.ogImageEntries.push({
-		props: {
-			...frontmatterRest,
-			title: pageResult.title,
-			description: pageResult.description,
-			siteName: context.siteName
-		},
-		outputPath: pageResult.routePaths.ogImagePath
-	});
-	collected.ogImageInputPaths.push(pageResult.inputPath);
-	collected.ogImageUrlMap.set(pageResult.inputPath, pageResult.routePaths.ogImageUrl);
+/**
+* Per-build cache for the locale-code list passed to `getSsgPageLocale`. The
+* `i18n.locales` reference is stable across a build, so the `.map` to codes
+* runs once instead of once per page.
+*/
+const localeCodesCache = /* @__PURE__ */ new WeakMap();
+function localeCodesFor(locales) {
+	const cached = localeCodesCache.get(locales);
+	if (cached) return cached;
+	const codes = locales.map((locale) => locale.code);
+	localeCodesCache.set(locales, codes);
+	return codes;
 }
-async function generateOgImageAssets(context, collected, generatedFiles, errors) {
-	if (!context.shouldGenerateOgImages || collected.ogImageEntries.length === 0) return;
-	try {
-		const ogResults = await generateOgImages(collected.ogImageEntries, context.options.ogImageOptions, context.root);
-		if (clearMissingBrowserOgImages(ogResults, collected)) return;
-		reportOgImageResults(ogResults, collected, generatedFiles, errors);
-	} catch (err) {
-		const errorMessage = err instanceof Error ? err.message : String(err);
-		console.warn(`[ox-content:og-image] Batch generation failed: ${errorMessage}`);
-		collected.ogImageUrlMap.clear();
-	}
-}
-function clearMissingBrowserOgImages(ogResults, collected) {
-	if (!(ogResults.length > 0 && ogResults.every((result) => result.error === "Chromium not available"))) return false;
-	for (const inputPath of collected.ogImageInputPaths) collected.ogImageUrlMap.delete(inputPath);
-	return true;
-}
-function reportOgImageResults(ogResults, collected, generatedFiles, errors) {
-	let ogSuccessCount = 0;
-	for (let i = 0; i < ogResults.length; i++) {
-		const result = ogResults[i];
-		if (result.error) {
-			errors.push(`OG image failed for ${result.outputPath}: ${result.error}`);
-			collected.ogImageUrlMap.delete(collected.ogImageInputPaths[i]);
-		} else {
-			generatedFiles.push(result.outputPath);
-			ogSuccessCount++;
-		}
-	}
-	if (ogSuccessCount > 0) {
-		const cachedCount = ogResults.filter((result) => result.cached && !result.error).length;
-		console.log(`[ox-content:og-image] Generated ${ogSuccessCount} OG images` + (cachedCount > 0 ? ` (${cachedCount} from cache)` : ""));
-	}
-}
-async function generateHtmlPages(context, pageResults, collected, errors) {
-	const generatedPages = [];
-	for (const pageResult of pageResults) try {
-		generatedPages.push({
-			inputPath: pageResult.inputPath,
-			outputPath: pageResult.routePaths.outputPath,
-			html: await renderSsgPage(context, pageResult, collected.ogImageUrlMap)
-		});
-	} catch (err) {
-		const errorMessage = err instanceof Error ? err.message : String(err);
-		errors.push(`Failed to generate HTML for ${pageResult.inputPath}: ${errorMessage}`);
-	}
-	return generatedPages;
-}
-async function renderSsgPage(context, pageResult, ogImageUrlMap) {
-	if (context.ssgOptions.bare) return generateBareHtmlPage(pageResult.transformedHtml, pageResult.title);
-	const pageData = createSsgPageData(pageResult);
-	const pageOgImage = context.shouldGenerateOgImages && ogImageUrlMap.has(pageResult.inputPath) ? ogImageUrlMap.get(pageResult.inputPath) : context.ssgOptions.ogImage;
-	return generateHtmlPage(pageData, context.navItems, context.siteName, context.base, pageOgImage, context.ssgOptions.theme, getPageLocale(pageData.path, context.options.i18n), context.options.i18n ? context.options.i18n.locales : void 0);
-}
-function createSsgPageData(pageResult) {
-	const { frontmatter } = pageResult;
-	const entryPage = frontmatter.layout === "entry" ? {
-		hero: frontmatter.hero,
-		features: frontmatter.features
+/**
+* Generates HTML page with navigation using Rust NAPI bindings.
+*/
+async function generateHtmlPage(pageData, navGroups, siteName, base, ogImage, theme, locale, availableLocales) {
+	const mod = await require_vitepress.importNapiModule();
+	const tocForRust = pageData.toc.map(toRustTocEntry);
+	const navGroupsForRust = convertNavGroupsForRust(navGroups);
+	const themeForRust = theme ? require_vitepress.themeToNapi(theme) : void 0;
+	const entryPageForRust = pageData.entryPage ? {
+		hero: pageData.entryPage.hero ? {
+			name: pageData.entryPage.hero.name,
+			text: pageData.entryPage.hero.text,
+			tagline: pageData.entryPage.hero.tagline,
+			notice: pageData.entryPage.hero.notice ? {
+				title: pageData.entryPage.hero.notice.title,
+				body: pageData.entryPage.hero.notice.body
+			} : void 0,
+			image: pageData.entryPage.hero.image ? {
+				src: pageData.entryPage.hero.image.src,
+				lightSrc: pageData.entryPage.hero.image.lightSrc,
+				darkSrc: pageData.entryPage.hero.image.darkSrc,
+				alt: pageData.entryPage.hero.image.alt,
+				width: pageData.entryPage.hero.image.width,
+				height: pageData.entryPage.hero.image.height
+			} : void 0,
+			actions: pageData.entryPage.hero.actions?.map((a) => ({
+				theme: a.theme,
+				text: a.text,
+				link: a.link
+			}))
+		} : void 0,
+		features: pageData.entryPage.features?.map((f) => ({
+			icon: f.icon,
+			title: f.title,
+			details: f.details,
+			link: f.link,
+			linkText: f.linkText
+		}))
 	} : void 0;
+	return mod.generateSsgHtml({
+		title: pageData.title,
+		description: pageData.description,
+		content: pageData.content,
+		toc: tocForRust,
+		lastUpdated: pageData.lastUpdated,
+		path: pageData.path,
+		entryPage: entryPageForRust
+	}, navGroupsForRust, {
+		siteName,
+		base,
+		ogImage,
+		theme: themeForRust,
+		locale,
+		availableLocales: availableLocales ? toRustLocales(availableLocales) : void 0
+	});
+}
+async function externalizeSharedPageAssets(pages, outDir, base) {
+	const optimized = (await require_vitepress.importNapiModule()).externalizeSsgAssets(pages, outDir, base);
+	await Promise.all(optimized.assets.map(async (asset) => {
+		await fs_promises.mkdir(path.dirname(asset.outputPath), { recursive: true });
+		await fs_promises.writeFile(asset.outputPath, asset.content, "utf-8");
+	}));
 	return {
-		title: pageResult.title,
-		description: pageResult.description,
-		content: pageResult.transformedHtml,
-		toc: pageResult.toc,
-		lastUpdated: pageResult.lastUpdated,
-		frontmatter,
-		path: pageResult.routePaths.urlPath,
-		href: pageResult.routePaths.href,
-		entryPage
+		pages: optimized.pages,
+		assets: optimized.assets.map((asset) => asset.outputPath)
 	};
 }
-async function writeGeneratedPages(generatedPages, context, generatedFiles) {
-	const optimizedOutput = await externalizeSharedPageAssets(generatedPages, context.outDir, context.base);
-	generatedFiles.push(...optimizedOutput.assets);
-	for (const page of optimizedOutput.pages) {
-		await fs_promises.mkdir(path.dirname(page.outputPath), { recursive: true });
-		await fs_promises.writeFile(page.outputPath, page.html, "utf-8");
-		generatedFiles.push(page.outputPath);
-	}
-}
-//#endregion
-//#region src/search.ts
 /**
-* Full-text search functionality for Ox Content.
-*
-* Generates search index at build time and provides client-side search.
+* Converts a markdown file path to a relative URL path.
 */
-let oxContent$1 = null;
-async function getOxContent() {
-	if (!oxContent$1) try {
-		oxContent$1 = await require_vitepress.importNapiModule();
-	} catch {
-		console.warn("[ox-content] Native bindings not available, search disabled");
-		return null;
-	}
-	return oxContent$1;
+function getUrlPath$1(inputPath, srcDir) {
+	return require_vitepress.importNapiModuleSync().getSsgUrlPath(inputPath, srcDir);
 }
 /**
-* Resolves search options with defaults.
+* Resolves manual navigation config to the format used by the built-in SSG renderer.
 */
-function resolveSearchOptions(options) {
-	if (options === false) return {
-		enabled: false,
-		limit: 10,
-		prefix: true,
-		placeholder: "Search documentation...",
-		hotkey: "/"
-	};
-	const opts = typeof options === "object" ? options : {};
-	return {
-		enabled: opts.enabled ?? true,
-		limit: opts.limit ?? 10,
-		prefix: opts.prefix ?? true,
-		placeholder: opts.placeholder ?? "Search documentation...",
-		hotkey: opts.hotkey ?? "/"
-	};
+function resolveNavigationGroups(navigation, base, extension) {
+	if (!navigation) return;
+	return require_vitepress.importNapiModuleSync().resolveSsgNavigationGroups(navigation, base, extension);
+}
+function getPageLocale(urlPath, i18n) {
+	if (!i18n) return void 0;
+	return require_vitepress.importNapiModuleSync().getSsgPageLocale(urlPath, i18n.defaultLocale, localeCodesFor(i18n.locales)) ?? void 0;
+}
+function getRoutePaths(inputPath, srcDir, outDir, base, extension, siteUrl) {
+	return require_vitepress.importNapiModuleSync().resolveSsgRoutePaths(inputPath, srcDir, outDir, base, extension, siteUrl);
 }
 /**
-* Builds the search index from Markdown files.
+* Formats a file/dir name as a title.
 */
-async function buildSearchIndex(srcDir, base, extensions = DEFAULT_MARKDOWN_EXTENSIONS) {
-	const napi = await getOxContent();
-	if (!napi) return JSON.stringify({
-		documents: [],
-		index: {},
-		df: {},
-		avg_dl: 0,
-		doc_count: 0
-	});
-	return napi.buildSearchIndexFromDirectory(srcDir, base, [...extensions]);
+function formatTitle(name) {
+	return require_vitepress.importNapiModuleSync().formatSsgTitle(name);
 }
 /**
-* Writes the search index to a file.
+* Collects all markdown files from the source directory.
 */
-async function writeSearchIndex(indexJson, outDir) {
-	const napi = await getOxContent();
-	if (!napi) return;
-	napi.writeSearchIndex(indexJson, outDir);
+async function collectMarkdownFiles(srcDir, extensions = DEFAULT_MARKDOWN_EXTENSIONS) {
+	return require_vitepress.importNapiModuleSync().collectSsgMarkdownFiles(srcDir, [...extensions]);
 }
 /**
-* Client-side search module code.
-* This is injected into the bundle as a virtual module.
+* Builds navigation items from markdown files, grouped by directory.
 */
-function generateSearchModule(options, indexPath) {
-	return require_vitepress.importNapiModuleSync().generateSearchModuleFromOptions(options, indexPath);
+function buildNavItems(markdownFiles, srcDir, base, extension) {
+	return require_vitepress.importNapiModuleSync().buildSsgNavItems(markdownFiles, srcDir, base, extension);
 }
-//#endregion
-//#region src/dev-server.ts
 /**
-* Dev server middleware for ox-content SSG.
-*
-* Serves fully-rendered HTML pages (with navigation, theme, etc.)
-* during `vite dev`, matching the SSG build output.
+* Builds navigation items from an explicit theme sidebar tree.
 */
-/** File extensions to skip in the middleware. */
-const SKIP_EXTENSIONS = /* @__PURE__ */ new Set([
-	".js",
-	".ts",
-	".css",
-	".scss",
-	".less",
-	".svg",
-	".png",
-	".jpg",
-	".jpeg",
-	".gif",
-	".webp",
-	".ico",
-	".woff",
-	".woff2",
-	".ttf",
-	".eot",
-	".json",
-	".map",
-	".mp4",
-	".webm",
-	".mp3",
-	".pdf"
-]);
-/** Vite internal URL prefixes to skip. */
-const VITE_INTERNAL_PREFIXES = [
-	"/@vite/",
-	"/@fs/",
-	"/@id/",
-	"/__"
-];
+function buildThemeNavItems(sidebar, base, extension) {
+	return require_vitepress.importNapiModuleSync().buildSsgThemeNavItems(sidebar, base, extension);
+}
 /**
-* Check if a request URL should be skipped by the dev server middleware.
+* Builds all markdown files to static HTML.
 */
-function shouldSkip(url) {
-	for (const prefix of VITE_INTERNAL_PREFIXES) if (url.startsWith(prefix)) return true;
-	if (url.includes("/node_modules/")) return true;
-	const extMatch = url.match(/\.([a-zA-Z0-9]+)(?:\?|$)/);
-	if (extMatch) {
-		const ext = "." + extMatch[1].toLowerCase();
-		if (SKIP_EXTENSIONS.has(ext)) return true;
-	}
-	return false;
-}
-/**
-* Resolve a request URL to a markdown file path.
-* Returns null if no matching file exists.
-*/
-async function resolveMarkdownFile(url, srcDir, extensions) {
-	let pathname = url.split("?")[0].split("#")[0];
-	if (pathname.endsWith("/index.html")) pathname = pathname.slice(0, -11) || "/";
-	if (pathname !== "/" && pathname.endsWith("/")) pathname = pathname.slice(0, -1);
-	const routePath = pathname === "/" ? "" : pathname.slice(1);
-	const directCandidates = pathname === "/" ? extensions.map((extension) => `index${extension}`) : isMarkdownFilePath(routePath, extensions) ? [routePath] : extensions.map((extension) => `${routePath}${extension}`);
-	for (const relativePath of directCandidates) {
-		const filePath = path.join(srcDir, relativePath);
-		try {
-			await fs_promises.access(filePath);
-			return filePath;
-		} catch {}
-	}
-	for (const extension of extensions) {
-		const indexPath = path.join(srcDir, routePath, `index${extension}`);
-		try {
-			await fs_promises.access(indexPath);
-			return indexPath;
-		} catch {}
-	}
-	return null;
+async function buildSsg(options, root) {
+	const ssgOptions = options.ssg;
+	if (!ssgOptions.enabled) return {
+		files: [],
+		errors: [],
+		ogImages: {}
+	};
+	const srcDir = path.resolve(root, options.srcDir);
+	const outDir = path.resolve(root, options.outDir);
+	const generatedFiles = [];
+	const errors = [];
+	await cleanOutputDirectory(ssgOptions, outDir);
+	const markdownFiles = await collectMarkdownFiles(srcDir, options.extensions);
+	const context = await createBuildSsgContext(options, root, srcDir, outDir, markdownFiles);
+	const collected = await collectPageResults(context, markdownFiles);
+	errors.push(...collected.errors);
+	await generateOgImageAssets(context, collected, generatedFiles, errors);
+	await writeGeneratedPages(await generateHtmlPages(context, collected.pageResults, collected, errors), context, generatedFiles);
+	return {
+		files: generatedFiles,
+		errors,
+		ogImages: Object.fromEntries(collected.ogImageUrlMap)
+	};
 }
-/**
-* Inject Vite HMR client script into the HTML.
-*/
-function injectViteHmrClient(html) {
-	return html.replace("</head>", "<script type=\"module\" src=\"/@vite/client\"><\/script>\n<script type=\"module\">\nif (import.meta.hot) {\n  const reexecuteBodyScripts = () => {\n    const scripts = Array.from(document.body.querySelectorAll('script'));\n    for (const script of scripts) {\n      const nextScript = document.createElement('script');\n      for (const attr of script.attributes) {\n        nextScript.setAttribute(attr.name, attr.value);\n      }\n      nextScript.textContent = script.textContent;\n      script.replaceWith(nextScript);\n    }\n  };\n\n  const applyHotUpdate = async () => {\n    const nextUrl = new URL(window.location.href);\n    nextUrl.searchParams.set('__ox_hmr', String(Date.now()));\n\n    const scrollX = window.scrollX;\n    const scrollY = window.scrollY;\n    const theme = document.documentElement.getAttribute('data-theme');\n\n    const response = await fetch(nextUrl.toString(), {\n      cache: 'no-store',\n      headers: {\n        'x-ox-content-hmr': '1',\n      },\n    });\n\n    if (!response.ok) {\n      throw new Error('Failed to fetch updated page');\n    }\n\n    const nextHtml = await response.text();\n    const nextDocument = new DOMParser().parseFromString(nextHtml, 'text/html');\n\n    if (!nextDocument.body) {\n      throw new Error('Updated page is missing a body');\n    }\n\n    document.title = nextDocument.title;\n    document.body.innerHTML = nextDocument.body.innerHTML;\n    reexecuteBodyScripts();\n\n    if (theme) {\n      document.documentElement.setAttribute('data-theme', theme);\n    }\n\n    window.scrollTo({ left: scrollX, top: scrollY });\n  };\n\n  let pendingUpdate = Promise.resolve();\n\n  import.meta.hot.on('ox-content:update', () => {\n    pendingUpdate = pendingUpdate\n      .then(() => applyHotUpdate())\n      .catch((error) => {\n        console.warn('[ox-content] HMR patch failed, falling back to reload.', error);\n        location.reload();\n      });\n  });\n}\n<\/script>\n</head>");
+async function cleanOutputDirectory(ssgOptions, outDir) {
+	if (!ssgOptions.clean) return;
+	try {
+		await fs_promises.rm(outDir, {
+			recursive: true,
+			force: true
+		});
+	} catch {}
 }
-/**
-* Create a dev server cache instance.
-*/
-function createDevServerCache() {
+async function createBuildSsgContext(options, root, srcDir, outDir, markdownFiles) {
+	const ssgOptions = options.ssg;
+	const base = options.base.endsWith("/") ? options.base : options.base + "/";
 	return {
-		navGroups: null,
-		pages: /* @__PURE__ */ new Map(),
-		siteName: null
+		options,
+		ssgOptions,
+		root,
+		srcDir,
+		outDir,
+		base,
+		navItems: resolveNavigationGroups(ssgOptions.navigation, base, ssgOptions.extension) ?? (ssgOptions.theme?.sidebar.length ? buildThemeNavItems(ssgOptions.theme.sidebar, base, ssgOptions.extension) : buildNavItems(markdownFiles, srcDir, base, ssgOptions.extension)),
+		siteName: await resolveSiteName$1(root, ssgOptions),
+		shouldGenerateOgImages: shouldGenerateOgImages(options),
+		napi: ssgOptions.lastUpdated ? await require_vitepress.importNapiModule() : void 0
 	};
 }
 /**
-* Invalidate navigation cache (called on file add/unlink).
-*/
-function invalidateNavCache(cache) {
-	cache.navGroups = null;
-	cache.pages.clear();
-}
-/**
-* Invalidate page cache for a specific file (called on file change).
+* Whether this build emits one Open Graph image per page.
+*
+* `ssg.bare` deliberately does not turn this off. Bare mode only drops the
+* generated page shell, and bringing your own shell is exactly the case where
+* per-page OG images are still wanted — the images are written to the output
+* tree and the consumer injects the `<meta>` tags itself. Nothing in the bare
+* HTML references them, because bare output has no `<head>` to put them in.
 */
-function invalidatePageCache(cache, filePath) {
-	cache.pages.delete(filePath);
+function shouldGenerateOgImages(options) {
+	return options.ogImage || options.ssg.generateOgImage;
 }
-/**
-* Resolve site name from options or package.json.
-*/
-async function resolveSiteName(options, root) {
-	if (options.ssg.siteName) return options.ssg.siteName;
+async function resolveSiteName$1(root, ssgOptions) {
+	if (ssgOptions.siteName) return ssgOptions.siteName;
 	try {
 		const pkgPath = path.join(root, "package.json");
 		const pkg = JSON.parse(await fs_promises.readFile(pkgPath, "utf-8"));
-		if (pkg.name) return formatTitle(pkg.name);
-	} catch {}
-	return "Documentation";
+		return pkg.name ? formatTitle(pkg.name) : "Documentation";
+	} catch {
+		return "Documentation";
+	}
 }
-/**
-* Render a single markdown page to full HTML.
-*/
-async function renderPage$1(filePath, options, navGroups, siteName, base, root) {
-	const srcDir = path.resolve(root, options.srcDir);
-	require_tabs.resetTabGroupCounter();
-	resetIslandCounter();
-	const result = await transformMarkdown(await fs_promises.readFile(filePath, "utf-8"), filePath, options, {
+async function collectPageResults(context, markdownFiles) {
+	const collected = {
+		pageResults: [],
+		ogImageEntries: [],
+		ogImageInputPaths: [],
+		ogImageUrlMap: /* @__PURE__ */ new Map(),
+		errors: []
+	};
+	for (const inputPath of markdownFiles) try {
+		const pageResult = await transformSsgPage(context, inputPath);
+		collected.pageResults.push(pageResult);
+		collectOgImageEntry(context, pageResult, collected);
+	} catch (err) {
+		const errorMessage = err instanceof Error ? err.message : String(err);
+		collected.errors.push(`Failed to process ${inputPath}: ${errorMessage}`);
+	}
+	return collected;
+}
+async function transformSsgPage(context, inputPath) {
+	const result = await transformMarkdown(await fs_promises.readFile(inputPath, "utf-8"), inputPath, context.options, {
 		convertMdLinks: true,
-		baseUrl: base,
-		sourcePath: filePath
+		baseUrl: context.base,
+		sourcePath: inputPath
 	});
 	const frontmatter = require_vitepress.normalizeVitePressFrontmatter(result.frontmatter);
-	let transformedHtml = result.html;
-	const { html: protectedHtml, svgs: mermaidSvgs } = protectMermaidSvgs(transformedHtml);
-	transformedHtml = protectedHtml;
-	transformedHtml = await transformAllPlugins(transformedHtml, {
+	const transformedHtml = await transformSsgHtml(result.html, context.options);
+	const title = extractTitle$1(transformedHtml, frontmatter);
+	return {
+		inputPath,
+		routePaths: getRoutePaths(inputPath, context.srcDir, context.outDir, context.base, context.ssgOptions.extension, context.ssgOptions.siteUrl),
+		transformedHtml,
+		title,
+		description: frontmatter.description,
+		lastUpdated: context.napi?.getGitLastUpdated(inputPath, context.root) ?? void 0,
+		frontmatter,
+		toc: result.toc
+	};
+}
+async function transformSsgHtml(html, options) {
+	const { html: protectedHtml, svgs: mermaidSvgs } = protectMermaidSvgs(html);
+	let transformedHtml = await transformAllPlugins(protectedHtml, {
 		tabs: true,
 		youtube: true,
 		github: options.embeds.github,
@@ -3979,83 +4072,443 @@ async function renderPage$1(filePath, options, navGroups, siteName, base, root)
 		githubToken: process.env.GITHUB_TOKEN
 	});
 	if (hasIslands(transformedHtml)) transformedHtml = (await transformIslands(transformedHtml)).html;
-	transformedHtml = restoreMermaidSvgs(transformedHtml, mermaidSvgs);
-	const title = extractTitle$1(transformedHtml, frontmatter);
-	const description = frontmatter.description;
-	let entryPage;
-	if (frontmatter.layout === "entry") entryPage = {
-		hero: frontmatter.hero,
-		features: frontmatter.features
-	};
-	let html = await generateHtmlPage({
-		title,
-		description,
-		content: transformedHtml,
-		toc: result.toc,
-		frontmatter,
-		path: getUrlPath$1(filePath, srcDir),
-		href: getUrlPath$1(filePath, srcDir) || "/",
-		entryPage
-	}, navGroups, siteName, base, options.ssg.ogImage, options.ssg.theme);
-	html = injectViteHmrClient(html);
-	return html;
+	return restoreMermaidSvgs(transformedHtml, mermaidSvgs);
 }
-/**
-* Create the dev server middleware for SSG page serving.
-*/
-function createDevServerMiddleware(options, root, cache) {
-	const srcDir = path.resolve(root, options.srcDir);
-	const base = options.base.endsWith("/") ? options.base : options.base + "/";
-	return async (req, res, next) => {
-		const url = req.url;
-		if (!url) return next();
-		let routeUrl = url;
-		if (base !== "/" && routeUrl.startsWith(base)) routeUrl = "/" + routeUrl.slice(base.length);
-		if (shouldSkip(routeUrl)) return next();
-		const filePath = await resolveMarkdownFile(routeUrl, srcDir, options.extensions);
-		if (!filePath) return next();
-		try {
-			const cached = cache.pages.get(filePath);
-			if (cached) {
-				res.setHeader("Content-Type", "text/html");
-				res.setHeader("Cache-Control", "no-cache");
-				res.end(cached);
-				return;
-			}
-			if (!cache.siteName) cache.siteName = await resolveSiteName(options, root);
-			if (!cache.navGroups) {
-				const markdownFiles = await collectMarkdownFiles(srcDir, options.extensions);
-				cache.navGroups = resolveNavigationGroups(options.ssg.navigation, base, options.ssg.extension) ?? (options.ssg.theme?.sidebar.length ? buildThemeNavItems(options.ssg.theme.sidebar, base, options.ssg.extension) : buildNavItems(markdownFiles, srcDir, base, options.ssg.extension));
-			}
-			const html = await renderPage$1(filePath, options, cache.navGroups, cache.siteName, base, root);
-			cache.pages.set(filePath, html);
-			res.setHeader("Content-Type", "text/html");
-			res.setHeader("Cache-Control", "no-cache");
-			res.end(html);
-		} catch (err) {
-			const message = err instanceof Error ? err.message : String(err);
-			console.error(`[ox-content:dev] Failed to render ${filePath}:`, message);
-			next();
-		}
-	};
+function collectOgImageEntry(context, pageResult, collected) {
+	if (!context.shouldGenerateOgImages) return;
+	const { layout: _layout, ...frontmatterRest } = pageResult.frontmatter;
+	collected.ogImageEntries.push({
+		props: {
+			...frontmatterRest,
+			title: pageResult.title,
+			description: pageResult.description,
+			siteName: context.siteName
+		},
+		outputPath: pageResult.routePaths.ogImagePath
+	});
+	collected.ogImageInputPaths.push(pageResult.inputPath);
+	collected.ogImageUrlMap.set(pageResult.inputPath, pageResult.routePaths.ogImageUrl);
 }
-//#endregion
-//#region src/og-viewer.ts
-/**
-* OG Viewer - Dev tool for previewing Open Graph metadata
-*
-* Accessible at /__og-viewer during development.
-* Shows all pages with their OG metadata, validation warnings,
-* and social card previews.
-*/
-function parseFrontmatter(content) {
-	const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-	if (!match) return {};
-	const yaml = match[1];
-	const result = {};
-	for (const line of yaml.split("\n")) {
-		const kv = line.match(/^(\w[\w-]*):\s*(.*)$/);
-		if (!kv) continue;
+async function generateOgImageAssets(context, collected, generatedFiles, errors) {
+	if (!context.shouldGenerateOgImages || collected.ogImageEntries.length === 0) return;
+	try {
+		const ogResults = await generateOgImages(collected.ogImageEntries, context.options.ogImageOptions, context.root);
+		if (clearMissingBrowserOgImages(ogResults, collected)) return;
+		reportOgImageResults(ogResults, collected, generatedFiles, errors);
+	} catch (err) {
+		const errorMessage = err instanceof Error ? err.message : String(err);
+		console.warn(`[ox-content:og-image] Batch generation failed: ${errorMessage}`);
+		collected.ogImageUrlMap.clear();
+	}
+}
+function clearMissingBrowserOgImages(ogResults, collected) {
+	if (!(ogResults.length > 0 && ogResults.every((result) => result.error === "Chromium not available"))) return false;
+	for (const inputPath of collected.ogImageInputPaths) collected.ogImageUrlMap.delete(inputPath);
+	return true;
+}
+function reportOgImageResults(ogResults, collected, generatedFiles, errors) {
+	let ogSuccessCount = 0;
+	for (let i = 0; i < ogResults.length; i++) {
+		const result = ogResults[i];
+		if (result.error) {
+			errors.push(`OG image failed for ${result.outputPath}: ${result.error}`);
+			collected.ogImageUrlMap.delete(collected.ogImageInputPaths[i]);
+		} else {
+			generatedFiles.push(result.outputPath);
+			ogSuccessCount++;
+		}
+	}
+	if (ogSuccessCount > 0) {
+		const cachedCount = ogResults.filter((result) => result.cached && !result.error).length;
+		console.log(`[ox-content:og-image] Generated ${ogSuccessCount} OG images` + (cachedCount > 0 ? ` (${cachedCount} from cache)` : ""));
+	}
+}
+async function generateHtmlPages(context, pageResults, collected, errors) {
+	const generatedPages = [];
+	for (const pageResult of pageResults) try {
+		generatedPages.push({
+			inputPath: pageResult.inputPath,
+			outputPath: pageResult.routePaths.outputPath,
+			html: await renderSsgPage(context, pageResult, collected, pageResults)
+		});
+	} catch (err) {
+		const errorMessage = err instanceof Error ? err.message : String(err);
+		errors.push(`Failed to generate HTML for ${pageResult.inputPath}: ${errorMessage}`);
+	}
+	return generatedPages;
+}
+async function renderSsgPage(context, pageResult, collected, allPageResults) {
+	const { ogImageUrlMap } = collected;
+	const pageOgImage = context.shouldGenerateOgImages && ogImageUrlMap.has(pageResult.inputPath) ? ogImageUrlMap.get(pageResult.inputPath) : context.ssgOptions.ogImage;
+	if (context.ssgOptions.render) return renderPage(toThemePageData(pageResult), {
+		theme: context.ssgOptions.render,
+		siteName: context.siteName,
+		base: context.base,
+		nav: context.navItems,
+		pages: allPageResults.map(toThemePageData)
+	});
+	if (context.ssgOptions.bare) return generateBarePage({
+		title: pageResult.title,
+		content: pageResult.transformedHtml,
+		lang: context.ssgOptions.lang ?? getPageLocale(pageResult.routePaths.urlPath, context.options.i18n),
+		description: pageResult.description,
+		canonicalUrl: canonicalPageUrl(context, pageResult.routePaths.urlPath),
+		siteName: context.ssgOptions.siteName,
+		ogImage: pageOgImage,
+		head: context.ssgOptions.head,
+		bodyStart: context.ssgOptions.bodyStart,
+		bodyEnd: context.ssgOptions.bodyEnd
+	});
+	const pageData = createSsgPageData(pageResult);
+	return generateHtmlPage(pageData, context.navItems, context.siteName, context.base, pageOgImage, context.ssgOptions.theme, getPageLocale(pageData.path, context.options.i18n), context.options.i18n ? context.options.i18n.locales : void 0);
+}
+/** Maps an internal page result onto the theme renderer's page shape. */
+function toThemePageData(pageResult) {
+	return {
+		title: pageResult.title,
+		description: pageResult.description,
+		html: pageResult.transformedHtml,
+		toc: pageResult.toc,
+		lastUpdated: pageResult.lastUpdated,
+		path: pageResult.inputPath,
+		url: pageResult.routePaths.href,
+		frontmatter: pageResult.frontmatter,
+		layout: typeof pageResult.frontmatter.layout === "string" ? pageResult.frontmatter.layout : void 0
+	};
+}
+/**
+* Absolute URL of a page, or `undefined` when `ssg.siteUrl` is not set.
+*
+* Built the same way `get_og_image_url` builds the image URL next to it, so
+* the canonical link and `og:image` always agree about where the page lives.
+*/
+function canonicalPageUrl(context, urlPath) {
+	const siteUrl = context.ssgOptions.siteUrl?.replace(/\/+$/, "");
+	if (!siteUrl) return;
+	if (urlPath === "/" || urlPath === "") return `${siteUrl}${context.base}`;
+	return `${siteUrl}${context.base}${urlPath}/`;
+}
+function createSsgPageData(pageResult) {
+	const { frontmatter } = pageResult;
+	const entryPage = frontmatter.layout === "entry" ? {
+		hero: frontmatter.hero,
+		features: frontmatter.features
+	} : void 0;
+	return {
+		title: pageResult.title,
+		description: pageResult.description,
+		content: pageResult.transformedHtml,
+		toc: pageResult.toc,
+		lastUpdated: pageResult.lastUpdated,
+		frontmatter,
+		path: pageResult.routePaths.urlPath,
+		href: pageResult.routePaths.href,
+		entryPage
+	};
+}
+async function writeGeneratedPages(generatedPages, context, generatedFiles) {
+	const optimizedOutput = await externalizeSharedPageAssets(generatedPages, context.outDir, context.base);
+	generatedFiles.push(...optimizedOutput.assets);
+	for (const page of optimizedOutput.pages) {
+		await fs_promises.mkdir(path.dirname(page.outputPath), { recursive: true });
+		await fs_promises.writeFile(page.outputPath, page.html, "utf-8");
+		generatedFiles.push(page.outputPath);
+	}
+}
+//#endregion
+//#region src/search.ts
+/**
+* Full-text search functionality for Ox Content.
+*
+* Generates search index at build time and provides client-side search.
+*/
+let oxContent$1 = null;
+async function getOxContent() {
+	if (!oxContent$1) try {
+		oxContent$1 = await require_vitepress.importNapiModule();
+	} catch {
+		console.warn("[ox-content] Native bindings not available, search disabled");
+		return null;
+	}
+	return oxContent$1;
+}
+/**
+* Resolves search options with defaults.
+*/
+function resolveSearchOptions(options) {
+	if (options === false) return {
+		enabled: false,
+		limit: 10,
+		prefix: true,
+		placeholder: "Search documentation...",
+		hotkey: "/"
+	};
+	const opts = typeof options === "object" ? options : {};
+	return {
+		enabled: opts.enabled ?? true,
+		limit: opts.limit ?? 10,
+		prefix: opts.prefix ?? true,
+		placeholder: opts.placeholder ?? "Search documentation...",
+		hotkey: opts.hotkey ?? "/"
+	};
+}
+/**
+* Builds the search index from Markdown files.
+*/
+async function buildSearchIndex(srcDir, base, extensions = DEFAULT_MARKDOWN_EXTENSIONS) {
+	const napi = await getOxContent();
+	if (!napi) return JSON.stringify({
+		documents: [],
+		index: {},
+		df: {},
+		avg_dl: 0,
+		doc_count: 0
+	});
+	return napi.buildSearchIndexFromDirectory(srcDir, base, [...extensions]);
+}
+/**
+* Writes the search index to a file.
+*/
+async function writeSearchIndex(indexJson, outDir) {
+	const napi = await getOxContent();
+	if (!napi) return;
+	napi.writeSearchIndex(indexJson, outDir);
+}
+/**
+* Client-side search module code.
+* This is injected into the bundle as a virtual module.
+*/
+function generateSearchModule(options, indexPath) {
+	return require_vitepress.importNapiModuleSync().generateSearchModuleFromOptions(options, indexPath);
+}
+//#endregion
+//#region src/dev-server.ts
+/**
+* Dev server middleware for ox-content SSG.
+*
+* Serves fully-rendered HTML pages (with navigation, theme, etc.)
+* during `vite dev`, matching the SSG build output.
+*/
+/** File extensions to skip in the middleware. */
+const SKIP_EXTENSIONS = /* @__PURE__ */ new Set([
+	".js",
+	".ts",
+	".css",
+	".scss",
+	".less",
+	".svg",
+	".png",
+	".jpg",
+	".jpeg",
+	".gif",
+	".webp",
+	".ico",
+	".woff",
+	".woff2",
+	".ttf",
+	".eot",
+	".json",
+	".map",
+	".mp4",
+	".webm",
+	".mp3",
+	".pdf"
+]);
+/** Vite internal URL prefixes to skip. */
+const VITE_INTERNAL_PREFIXES = [
+	"/@vite/",
+	"/@fs/",
+	"/@id/",
+	"/__"
+];
+/**
+* Check if a request URL should be skipped by the dev server middleware.
+*/
+function shouldSkip(url) {
+	for (const prefix of VITE_INTERNAL_PREFIXES) if (url.startsWith(prefix)) return true;
+	if (url.includes("/node_modules/")) return true;
+	const extMatch = url.match(/\.([a-zA-Z0-9]+)(?:\?|$)/);
+	if (extMatch) {
+		const ext = "." + extMatch[1].toLowerCase();
+		if (SKIP_EXTENSIONS.has(ext)) return true;
+	}
+	return false;
+}
+/**
+* Resolve a request URL to a markdown file path.
+* Returns null if no matching file exists.
+*/
+async function resolveMarkdownFile(url, srcDir, extensions) {
+	let pathname = url.split("?")[0].split("#")[0];
+	if (pathname.endsWith("/index.html")) pathname = pathname.slice(0, -11) || "/";
+	if (pathname !== "/" && pathname.endsWith("/")) pathname = pathname.slice(0, -1);
+	const routePath = pathname === "/" ? "" : pathname.slice(1);
+	const directCandidates = pathname === "/" ? extensions.map((extension) => `index${extension}`) : isMarkdownFilePath(routePath, extensions) ? [routePath] : extensions.map((extension) => `${routePath}${extension}`);
+	for (const relativePath of directCandidates) {
+		const filePath = path.join(srcDir, relativePath);
+		try {
+			await fs_promises.access(filePath);
+			return filePath;
+		} catch {}
+	}
+	for (const extension of extensions) {
+		const indexPath = path.join(srcDir, routePath, `index${extension}`);
+		try {
+			await fs_promises.access(indexPath);
+			return indexPath;
+		} catch {}
+	}
+	return null;
+}
+/**
+* Inject Vite HMR client script into the HTML.
+*/
+function injectViteHmrClient(html) {
+	return html.replace("</head>", "<script type=\"module\" src=\"/@vite/client\"><\/script>\n<script type=\"module\">\nif (import.meta.hot) {\n  const reexecuteBodyScripts = () => {\n    const scripts = Array.from(document.body.querySelectorAll('script'));\n    for (const script of scripts) {\n      const nextScript = document.createElement('script');\n      for (const attr of script.attributes) {\n        nextScript.setAttribute(attr.name, attr.value);\n      }\n      nextScript.textContent = script.textContent;\n      script.replaceWith(nextScript);\n    }\n  };\n\n  const applyHotUpdate = async () => {\n    const nextUrl = new URL(window.location.href);\n    nextUrl.searchParams.set('__ox_hmr', String(Date.now()));\n\n    const scrollX = window.scrollX;\n    const scrollY = window.scrollY;\n    const theme = document.documentElement.getAttribute('data-theme');\n\n    const response = await fetch(nextUrl.toString(), {\n      cache: 'no-store',\n      headers: {\n        'x-ox-content-hmr': '1',\n      },\n    });\n\n    if (!response.ok) {\n      throw new Error('Failed to fetch updated page');\n    }\n\n    const nextHtml = await response.text();\n    const nextDocument = new DOMParser().parseFromString(nextHtml, 'text/html');\n\n    if (!nextDocument.body) {\n      throw new Error('Updated page is missing a body');\n    }\n\n    document.title = nextDocument.title;\n    document.body.innerHTML = nextDocument.body.innerHTML;\n    reexecuteBodyScripts();\n\n    if (theme) {\n      document.documentElement.setAttribute('data-theme', theme);\n    }\n\n    window.scrollTo({ left: scrollX, top: scrollY });\n  };\n\n  let pendingUpdate = Promise.resolve();\n\n  import.meta.hot.on('ox-content:update', () => {\n    pendingUpdate = pendingUpdate\n      .then(() => applyHotUpdate())\n      .catch((error) => {\n        console.warn('[ox-content] HMR patch failed, falling back to reload.', error);\n        location.reload();\n      });\n  });\n}\n<\/script>\n</head>");
+}
+/**
+* Create a dev server cache instance.
+*/
+function createDevServerCache() {
+	return {
+		navGroups: null,
+		pages: /* @__PURE__ */ new Map(),
+		siteName: null
+	};
+}
+/**
+* Invalidate navigation cache (called on file add/unlink).
+*/
+function invalidateNavCache(cache) {
+	cache.navGroups = null;
+	cache.pages.clear();
+}
+/**
+* Invalidate page cache for a specific file (called on file change).
+*/
+function invalidatePageCache(cache, filePath) {
+	cache.pages.delete(filePath);
+}
+/**
+* Resolve site name from options or package.json.
+*/
+async function resolveSiteName(options, root) {
+	if (options.ssg.siteName) return options.ssg.siteName;
+	try {
+		const pkgPath = path.join(root, "package.json");
+		const pkg = JSON.parse(await fs_promises.readFile(pkgPath, "utf-8"));
+		if (pkg.name) return formatTitle(pkg.name);
+	} catch {}
+	return "Documentation";
+}
+/**
+* Render a single markdown page to full HTML.
+*/
+async function renderPage$1(filePath, options, navGroups, siteName, base, root) {
+	const srcDir = path.resolve(root, options.srcDir);
+	require_tabs.resetTabGroupCounter();
+	resetIslandCounter();
+	const result = await transformMarkdown(await fs_promises.readFile(filePath, "utf-8"), filePath, options, {
+		convertMdLinks: true,
+		baseUrl: base,
+		sourcePath: filePath
+	});
+	const frontmatter = require_vitepress.normalizeVitePressFrontmatter(result.frontmatter);
+	let transformedHtml = result.html;
+	const { html: protectedHtml, svgs: mermaidSvgs } = protectMermaidSvgs(transformedHtml);
+	transformedHtml = protectedHtml;
+	transformedHtml = await transformAllPlugins(transformedHtml, {
+		tabs: true,
+		youtube: true,
+		github: options.embeds.github,
+		openGraph: options.embeds.openGraph,
+		pm: options.embeds.pm,
+		spotify: options.embeds.spotify,
+		stackBlitz: options.embeds.stackBlitz,
+		twitter: options.embeds.twitter,
+		bluesky: options.embeds.bluesky,
+		webContainer: options.embeds.webContainer,
+		mermaid: true,
+		githubToken: process.env.GITHUB_TOKEN
+	});
+	if (hasIslands(transformedHtml)) transformedHtml = (await transformIslands(transformedHtml)).html;
+	transformedHtml = restoreMermaidSvgs(transformedHtml, mermaidSvgs);
+	const title = extractTitle$1(transformedHtml, frontmatter);
+	const description = frontmatter.description;
+	let entryPage;
+	if (frontmatter.layout === "entry") entryPage = {
+		hero: frontmatter.hero,
+		features: frontmatter.features
+	};
+	let html = await generateHtmlPage({
+		title,
+		description,
+		content: transformedHtml,
+		toc: result.toc,
+		frontmatter,
+		path: getUrlPath$1(filePath, srcDir),
+		href: getUrlPath$1(filePath, srcDir) || "/",
+		entryPage
+	}, navGroups, siteName, base, options.ssg.ogImage, options.ssg.theme);
+	html = injectViteHmrClient(html);
+	return html;
+}
+/**
+* Create the dev server middleware for SSG page serving.
+*/
+function createDevServerMiddleware(options, root, cache) {
+	const srcDir = path.resolve(root, options.srcDir);
+	const base = options.base.endsWith("/") ? options.base : options.base + "/";
+	return async (req, res, next) => {
+		const url = req.url;
+		if (!url) return next();
+		let routeUrl = url;
+		if (base !== "/" && routeUrl.startsWith(base)) routeUrl = "/" + routeUrl.slice(base.length);
+		if (shouldSkip(routeUrl)) return next();
+		const filePath = await resolveMarkdownFile(routeUrl, srcDir, options.extensions);
+		if (!filePath) return next();
+		try {
+			const cached = cache.pages.get(filePath);
+			if (cached) {
+				res.setHeader("Content-Type", "text/html");
+				res.setHeader("Cache-Control", "no-cache");
+				res.end(cached);
+				return;
+			}
+			if (!cache.siteName) cache.siteName = await resolveSiteName(options, root);
+			if (!cache.navGroups) {
+				const markdownFiles = await collectMarkdownFiles(srcDir, options.extensions);
+				cache.navGroups = resolveNavigationGroups(options.ssg.navigation, base, options.ssg.extension) ?? (options.ssg.theme?.sidebar.length ? buildThemeNavItems(options.ssg.theme.sidebar, base, options.ssg.extension) : buildNavItems(markdownFiles, srcDir, base, options.ssg.extension));
+			}
+			const html = await renderPage$1(filePath, options, cache.navGroups, cache.siteName, base, root);
+			cache.pages.set(filePath, html);
+			res.setHeader("Content-Type", "text/html");
+			res.setHeader("Cache-Control", "no-cache");
+			res.end(html);
+		} catch (err) {
+			const message = err instanceof Error ? err.message : String(err);
+			console.error(`[ox-content:dev] Failed to render ${filePath}:`, message);
+			next();
+		}
+	};
+}
+//#endregion
+//#region src/og-viewer.ts
+/**
+* OG Viewer - Dev tool for previewing Open Graph metadata
+*
+* Accessible at /__og-viewer during development.
+* Shows all pages with their OG metadata, validation warnings,
+* and social card previews.
+*/
+function parseFrontmatter(content) {
+	const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+	if (!match) return {};
+	const yaml = match[1];
+	const result = {};
+	for (const line of yaml.split("\n")) {
+		const kv = line.match(/^(\w[\w-]*):\s*(.*)$/);
+		if (!kv) continue;
 		const [, key, rawValue] = kv;
 		let value = rawValue.trim();
 		if (typeof value === "string" && value.startsWith("[") && value.endsWith("]")) value = value.slice(1, -1).split(",").map((s) => s.trim().replace(/^['"]|['"]$/g, "")).filter(Boolean);
@@ -5547,562 +6000,209 @@ async function runStandardSpellcheckDocuments(maskedDocuments, options) {
 	} catch (error) {
 		const imports = standard.imports.join(", ");
 		const message = imports.length > 0 ? `[ox-content] Failed to load standard dictionaries from ${imports}. Verify the imports and install the referenced CSpell packages.` : "[ox-content] Failed to load the configured standard dictionaries.";
-		throw new Error(message, { cause: error });
-	}
-}
-function createStandardSpellcheckSettings(options, locale) {
-	return {
-		import: options.dictionary.standard ? options.dictionary.standard.imports : [],
-		ignoreWords: options.dictionary.ignoredWords,
-		language: locale,
-		version: "0.2",
-		words: [...options.dictionary.words ?? [], ...Object.values(options.dictionary.byLanguage ?? {}).flat()]
-	};
-}
-async function loadCspellLib() {
-	cspellLibPromise ??= import("cspell-lib");
-	return cspellLibPromise;
-}
-function mapStandardIssueToDiagnostic(issue, languages, newlineOffsets) {
-	const line = getLineNumberAtOffset(newlineOffsets, issue.line.offset);
-	const column = issue.offset - issue.line.offset + 1;
-	return {
-		column,
-		endColumn: column + (issue.length ?? issue.text.length),
-		endLine: line,
-		language: inferStandardIssueLanguage(issue.text, languages),
-		line,
-		message: `Unknown word "${issue.text}".`,
-		ruleId: "spellcheck",
-		severity: "warning",
-		suggestions: issue.suggestions?.slice(0, 3)
-	};
-}
-function getLineNumberAtOffset(newlineOffsets, offset) {
-	let lo = 0;
-	let hi = newlineOffsets.length;
-	while (lo < hi) {
-		const mid = lo + hi >>> 1;
-		if (newlineOffsets[mid] < offset) lo = mid + 1;
-		else hi = mid;
-	}
-	return lo + 1;
-}
-function inferStandardIssueLanguage(word, languages) {
-	if (/[\p{Script=Hiragana}\p{Script=Katakana}]/u.test(word) && languages.includes("ja")) return "ja";
-	if (/[\p{Script=Han}]/u.test(word)) {
-		if (languages.includes("zh") && !languages.includes("ja")) return "zh";
-		if (languages.includes("ja") && !languages.includes("zh")) return "ja";
-	}
-	if (/[\p{Script=Latin}]/u.test(word)) {
-		const latinLanguages = languages.filter((language) => language !== "ja" && language !== "zh");
-		if (latinLanguages.length === 1) return latinLanguages[0];
-		return inferLatinLanguageFromCharacters(word, latinLanguages);
-	}
-}
-function inferLatinLanguageFromCharacters(word, languages) {
-	if (languages.includes("pl") && /[ąćęłńóśźż]/iu.test(word)) return "pl";
-	if (languages.includes("de") && /[äöüß]/iu.test(word)) return "de";
-	if (languages.includes("fr") && /[àâæçéèêëîïôœùûüÿ]/iu.test(word)) return "fr";
-}
-function summarizeDiagnostics(diagnostics) {
-	let errorCount = 0;
-	let warningCount = 0;
-	let infoCount = 0;
-	for (const diagnostic of diagnostics) if (diagnostic.severity === "error") errorCount += 1;
-	else if (diagnostic.severity === "warning") warningCount += 1;
-	else infoCount += 1;
-	return {
-		diagnostics,
-		errorCount,
-		infoCount,
-		warningCount
-	};
-}
-function createEmptyLintResult$1() {
-	return summarizeDiagnostics([]);
-}
-function sortDiagnostics(diagnostics) {
-	return [...diagnostics].sort((left, right) => {
-		if (left.line !== right.line) return left.line - right.line;
-		if (left.column !== right.column) return left.column - right.column;
-		return left.ruleId.localeCompare(right.ruleId);
-	});
-}
-//#endregion
-//#region src/lint-files.ts
-const DEFAULT_LINT_FILE_INCLUDE = [
-	"**/*.md",
-	"**/*.markdown",
-	"**/*.mdx"
-];
-const DEFAULT_LINT_FILE_EXCLUDE = [
-	"**/node_modules/**",
-	"**/.git/**",
-	"**/dist/**"
-];
-/**
-* Returns true if the file path is included by the configured glob filters.
-*/
-function shouldLintMarkdownFile(filePath, options = {}) {
-	const resolvedOptions = resolveMarkdownLintFileOptions(options);
-	return shouldLintAbsoluteFile(node_path.resolve(resolvedOptions.cwd, filePath), resolvedOptions);
-}
-/**
-* Lints a single Markdown file using project-style include/exclude settings.
-*
-* If the file is filtered out by `include` / `exclude`, the returned result is
-* marked as `skipped` and contains no diagnostics.
-*/
-async function lintMarkdownFile(filePath, options = {}) {
-	const resolvedOptions = resolveMarkdownLintFileOptions(options);
-	return lintMarkdownFileWithResolvedOptions(node_path.resolve(resolvedOptions.cwd, filePath), resolvedOptions);
-}
-/**
-* Lints all Markdown files matched by the configured include/exclude patterns.
-*/
-async function lintMarkdownFiles(options = {}) {
-	const resolvedOptions = resolveMarkdownLintFileOptions(options);
-	const matchedFiles = await collectMarkdownLintFileEntries(resolvedOptions);
-	const results = await lintMarkdownDocumentsAsync(await Promise.all(matchedFiles.map((file) => node_fs_promises.readFile(file.filePath, "utf-8"))), resolvedOptions.lintOptions);
-	const files = matchedFiles.map((file, index) => ({
-		...results[index] ?? createEmptyLintResult(),
-		filePath: file.filePath,
-		relativePath: file.relativePath,
-		skipped: false
-	}));
-	const diagnostics = files.flatMap((fileResult) => fileResult.diagnostics.map((diagnostic) => ({
-		...diagnostic,
-		filePath: fileResult.filePath,
-		relativePath: fileResult.relativePath
-	})));
-	return {
-		checkedFileCount: files.length,
-		diagnostics,
-		errorCount: files.reduce((count, fileResult) => count + fileResult.errorCount, 0),
-		files,
-		infoCount: files.reduce((count, fileResult) => count + fileResult.infoCount, 0),
-		warningCount: files.reduce((count, fileResult) => count + fileResult.warningCount, 0)
-	};
-}
-function resolveMarkdownLintFileOptions(options) {
-	return {
-		cwd: node_path.resolve(options.cwd ?? process.cwd()),
-		exclude: [.../* @__PURE__ */ new Set([...options.exclude ?? DEFAULT_LINT_FILE_EXCLUDE, ...options.ignore ?? []])],
-		include: [...new Set(options.include ?? DEFAULT_LINT_FILE_INCLUDE)],
-		lintOptions: {
-			dictionary: options.dictionary,
-			languages: options.languages,
-			rules: options.rules
-		}
-	};
-}
-async function lintMarkdownFileWithResolvedOptions(filePath, options) {
-	const absoluteFilePath = node_path.resolve(filePath);
-	const relativePath = normalizePath(node_path.relative(options.cwd, absoluteFilePath));
-	if (!shouldLintAbsoluteFile(absoluteFilePath, options)) return {
-		...createEmptyLintResult(),
-		filePath: absoluteFilePath,
-		relativePath,
-		skipped: true
-	};
-	return {
-		...await lintMarkdownAsync(await node_fs_promises.readFile(absoluteFilePath, "utf-8"), options.lintOptions),
-		filePath: absoluteFilePath,
-		relativePath,
-		skipped: false
-	};
-}
-async function collectMarkdownLintFileEntries(options) {
-	const files = /* @__PURE__ */ new Map();
-	for (const pattern of options.include) {
-		const matches = await (0, glob.glob)(pattern, {
-			absolute: true,
-			cwd: options.cwd,
-			ignore: options.exclude,
-			nodir: true
-		});
-		for (const filePath of matches) {
-			const absoluteFilePath = node_path.resolve(filePath);
-			if (shouldLintAbsoluteFile(absoluteFilePath, options)) files.set(absoluteFilePath, {
-				filePath: absoluteFilePath,
-				relativePath: normalizePath(node_path.relative(options.cwd, absoluteFilePath))
-			});
-		}
-	}
-	return [...files.values()].sort((left, right) => left.filePath.localeCompare(right.filePath));
-}
-function shouldLintAbsoluteFile(filePath, options) {
-	const absolutePath = normalizePath(node_path.resolve(filePath));
-	const relativePath = normalizePath(node_path.relative(options.cwd, absolutePath));
-	const matches = (patterns) => patterns.some((pattern) => {
-		const normalizedPattern = normalizePath(pattern);
-		return node_path.matchesGlob(relativePath, normalizedPattern) || node_path.matchesGlob(absolutePath, normalizedPattern);
-	});
-	return matches(options.include) && !matches(options.exclude);
-}
-function normalizePath(value) {
-	return value.split(node_path.sep).join("/");
+		throw new Error(message, { cause: error });
+	}
 }
-function createEmptyLintResult() {
+function createStandardSpellcheckSettings(options, locale) {
 	return {
-		diagnostics: [],
-		errorCount: 0,
-		infoCount: 0,
-		warningCount: 0
+		import: options.dictionary.standard ? options.dictionary.standard.imports : [],
+		ignoreWords: options.dictionary.ignoredWords,
+		language: locale,
+		version: "0.2",
+		words: [...options.dictionary.words ?? [], ...Object.values(options.dictionary.byLanguage ?? {}).flat()]
 	};
 }
-//#endregion
-//#region src/page-context.ts
-var page_context_exports = /* @__PURE__ */ require_vitepress.__exportAll({
-	clearRenderContext: () => clearRenderContext,
-	generateFrontmatterTypes: () => generateFrontmatterTypes,
-	inferType: () => inferType,
-	setRenderContext: () => setRenderContext,
-	useIsActive: () => useIsActive,
-	useNav: () => useNav,
-	usePageProps: () => usePageProps,
-	useRenderContext: () => useRenderContext,
-	useSiteConfig: () => useSiteConfig
-});
-/**
-* Sets the current render context.
-* Called internally during page rendering.
-* @internal
-*/
-function setRenderContext(ctx) {
-	currentContext = ctx;
-}
-/**
-* Clears the current render context.
-* Called internally after page rendering.
-* @internal
-*/
-function clearRenderContext() {
-	currentContext = null;
-}
-/**
-* 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>;
-* }
-* ```
-*/
-function usePageProps() {
-	if (!currentContext) throw new Error("[ox-content] usePageProps() must be called during page rendering. Make sure you are using it inside a theme component.");
-	return currentContext.page;
-}
-/**
-* 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>;
-* }
-* ```
-*/
-function useSiteConfig() {
-	if (!currentContext) throw new Error("[ox-content] useSiteConfig() must be called during page rendering. Make sure you are using it inside a theme component.");
-	return currentContext.site;
-}
-/**
-* 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>
-*   );
-* }
-* ```
-*/
-function useRenderContext() {
-	if (!currentContext) throw new Error("[ox-content] useRenderContext() must be called during page rendering. Make sure you are using it inside a theme component.");
-	return currentContext;
-}
-/**
-* 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>
-*   );
-* }
-* ```
-*/
-function useNav() {
-	return useSiteConfig().nav;
+async function loadCspellLib() {
+	cspellLibPromise ??= import("cspell-lib");
+	return cspellLibPromise;
 }
-/**
-* 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>;
-* }
-* ```
-*/
-function useIsActive(path) {
-	const page = usePageProps();
-	return page.path === path || page.url === path;
+function mapStandardIssueToDiagnostic(issue, languages, newlineOffsets) {
+	const line = getLineNumberAtOffset(newlineOffsets, issue.line.offset);
+	const column = issue.offset - issue.line.offset + 1;
+	return {
+		column,
+		endColumn: column + (issue.length ?? issue.text.length),
+		endLine: line,
+		language: inferStandardIssueLanguage(issue.text, languages),
+		line,
+		message: `Unknown word "${issue.text}".`,
+		ruleId: "spellcheck",
+		severity: "warning",
+		suggestions: issue.suggestions?.slice(0, 3)
+	};
 }
-/**
-* Infers TypeScript types from frontmatter values.
-*/
-function inferType(value) {
-	if (value === null) return "null";
-	if (value === void 0) return "undefined";
-	if (typeof value === "string") return "string";
-	if (typeof value === "number") return "number";
-	if (typeof value === "boolean") return "boolean";
-	if (Array.isArray(value)) {
-		if (value.length === 0) return "unknown[]";
-		const itemTypes = [...new Set(value.map(inferType))];
-		if (itemTypes.length === 1) return `${itemTypes[0]}[]`;
-		return `(${itemTypes.join(" | ")})[]`;
-	}
-	if (typeof value === "object") {
-		const entries = Object.entries(value);
-		if (entries.length === 0) return "Record<string, unknown>";
-		return `{ ${entries.map(([k, v]) => `${k}: ${inferType(v)}`).join("; ")} }`;
+function getLineNumberAtOffset(newlineOffsets, offset) {
+	let lo = 0;
+	let hi = newlineOffsets.length;
+	while (lo < hi) {
+		const mid = lo + hi >>> 1;
+		if (newlineOffsets[mid] < offset) lo = mid + 1;
+		else hi = mid;
 	}
-	return "unknown";
+	return lo + 1;
 }
-/**
-* Generates TypeScript interface from frontmatter samples.
-*/
-function generateFrontmatterTypes(samples, interfaceName = "PageFrontmatter") {
-	const fields = /* @__PURE__ */ new Map();
-	for (const sample of samples) for (const [key, value] of Object.entries(sample)) {
-		const existing = fields.get(key) ?? {
-			types: /* @__PURE__ */ new Set(),
-			count: 0
-		};
-		existing.types.add(inferType(value));
-		existing.count++;
-		fields.set(key, existing);
+function inferStandardIssueLanguage(word, languages) {
+	if (/[\p{Script=Hiragana}\p{Script=Katakana}]/u.test(word) && languages.includes("ja")) return "ja";
+	if (/[\p{Script=Han}]/u.test(word)) {
+		if (languages.includes("zh") && !languages.includes("ja")) return "zh";
+		if (languages.includes("ja") && !languages.includes("zh")) return "ja";
 	}
-	const lines = [
-		"/**",
-		" * Auto-generated frontmatter type based on your pages.",
-		" * DO NOT EDIT - this file is generated by ox-content.",
-		" */",
-		"",
-		`export interface ${interfaceName} {`
-	];
-	for (const [name, { types, count }] of fields) {
-		const isOptional = count < samples.length;
-		const typeStr = [...types].join(" | ");
-		const optionalMark = isOptional ? "?" : "";
-		lines.push(`  ${name}${optionalMark}: ${typeStr};`);
+	if (/[\p{Script=Latin}]/u.test(word)) {
+		const latinLanguages = languages.filter((language) => language !== "ja" && language !== "zh");
+		if (latinLanguages.length === 1) return latinLanguages[0];
+		return inferLatinLanguageFromCharacters(word, latinLanguages);
 	}
-	lines.push("}");
-	lines.push("");
-	lines.push(`export type PageProps = import('@ox-content/vite-plugin').PageProps<${interfaceName}>;`);
-	lines.push("");
-	return lines.join("\n");
 }
-var currentContext;
-var init_page_context = require_vitepress.__esmMin((() => {
-	currentContext = null;
-}));
+function inferLatinLanguageFromCharacters(word, languages) {
+	if (languages.includes("pl") && /[ąćęłńóśźż]/iu.test(word)) return "pl";
+	if (languages.includes("de") && /[äöüß]/iu.test(word)) return "de";
+	if (languages.includes("fr") && /[àâæçéèêëîïôœùûüÿ]/iu.test(word)) return "fr";
+}
+function summarizeDiagnostics(diagnostics) {
+	let errorCount = 0;
+	let warningCount = 0;
+	let infoCount = 0;
+	for (const diagnostic of diagnostics) if (diagnostic.severity === "error") errorCount += 1;
+	else if (diagnostic.severity === "warning") warningCount += 1;
+	else infoCount += 1;
+	return {
+		diagnostics,
+		errorCount,
+		infoCount,
+		warningCount
+	};
+}
+function createEmptyLintResult$1() {
+	return summarizeDiagnostics([]);
+}
+function sortDiagnostics(diagnostics) {
+	return [...diagnostics].sort((left, right) => {
+		if (left.line !== right.line) return left.line - right.line;
+		if (left.column !== right.column) return left.column - right.column;
+		return left.ruleId.localeCompare(right.ruleId);
+	});
+}
 //#endregion
-//#region src/theme-renderer.ts
+//#region src/lint-files.ts
+const DEFAULT_LINT_FILE_INCLUDE = [
+	"**/*.md",
+	"**/*.markdown",
+	"**/*.mdx"
+];
+const DEFAULT_LINT_FILE_EXCLUDE = [
+	"**/node_modules/**",
+	"**/.git/**",
+	"**/dist/**"
+];
 /**
-* Theme Renderer for Static HTML Generation
-*
-* Renders JSX theme components to static HTML strings.
-* No client-side JavaScript is included by default.
+* Returns true if the file path is included by the configured glob filters.
 */
-init_page_context();
+function shouldLintMarkdownFile(filePath, options = {}) {
+	const resolvedOptions = resolveMarkdownLintFileOptions(options);
+	return shouldLintAbsoluteFile(node_path.resolve(resolvedOptions.cwd, filePath), resolvedOptions);
+}
 /**
-* Renders a page using the theme component.
+* Lints a single Markdown file using project-style include/exclude settings.
 *
-* @param page - Page data to render
-* @param options - Theme render options
-* @returns Rendered HTML string
+* If the file is filtered out by `include` / `exclude`, the returned result is
+* marked as `skipped` and contains no diagnostics.
 */
-function renderPage(page, options) {
-	const { theme, siteName, base, nav, pages } = options;
-	setRenderContext({
-		page: {
-			title: page.title,
-			description: page.description,
-			html: page.html,
-			toc: page.toc,
-			lastUpdated: page.lastUpdated,
-			path: page.path,
-			url: page.url,
-			frontmatter: page.frontmatter,
-			layout: page.layout
-		},
-		site: {
-			name: siteName,
-			base,
-			nav,
-			pages: pages.map((p) => ({
-				title: p.title,
-				description: p.description,
-				html: p.html,
-				toc: p.toc,
-				lastUpdated: p.lastUpdated,
-				path: p.path,
-				url: p.url,
-				frontmatter: p.frontmatter,
-				layout: p.layout
-			}))
-		}
-	});
-	try {
-		const result = theme({ children: require_jsx_html.raw(page.html) });
-		const html = require_jsx_html.renderToString(result);
-		if (!html.trimStart().toLowerCase().startsWith("<!doctype")) return `<!DOCTYPE html>\n${html}`;
-		return html;
-	} finally {
-		clearRenderContext();
-	}
+async function lintMarkdownFile(filePath, options = {}) {
+	const resolvedOptions = resolveMarkdownLintFileOptions(options);
+	return lintMarkdownFileWithResolvedOptions(node_path.resolve(resolvedOptions.cwd, filePath), resolvedOptions);
 }
 /**
-* 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
+* Lints all Markdown files matched by the configured include/exclude patterns.
 */
-async function renderAllPages(pages, options) {
-	const results = /* @__PURE__ */ new Map();
-	for (const page of pages) {
-		const html = renderPage(page, {
-			...options,
-			pages
+async function lintMarkdownFiles(options = {}) {
+	const resolvedOptions = resolveMarkdownLintFileOptions(options);
+	const matchedFiles = await collectMarkdownLintFileEntries(resolvedOptions);
+	const results = await lintMarkdownDocumentsAsync(await Promise.all(matchedFiles.map((file) => node_fs_promises.readFile(file.filePath, "utf-8"))), resolvedOptions.lintOptions);
+	const files = matchedFiles.map((file, index) => ({
+		...results[index] ?? createEmptyLintResult(),
+		filePath: file.filePath,
+		relativePath: file.relativePath,
+		skipped: false
+	}));
+	const diagnostics = files.flatMap((fileResult) => fileResult.diagnostics.map((diagnostic) => ({
+		...diagnostic,
+		filePath: fileResult.filePath,
+		relativePath: fileResult.relativePath
+	})));
+	return {
+		checkedFileCount: files.length,
+		diagnostics,
+		errorCount: files.reduce((count, fileResult) => count + fileResult.errorCount, 0),
+		files,
+		infoCount: files.reduce((count, fileResult) => count + fileResult.infoCount, 0),
+		warningCount: files.reduce((count, fileResult) => count + fileResult.warningCount, 0)
+	};
+}
+function resolveMarkdownLintFileOptions(options) {
+	return {
+		cwd: node_path.resolve(options.cwd ?? process.cwd()),
+		exclude: [.../* @__PURE__ */ new Set([...options.exclude ?? DEFAULT_LINT_FILE_EXCLUDE, ...options.ignore ?? []])],
+		include: [...new Set(options.include ?? DEFAULT_LINT_FILE_INCLUDE)],
+		lintOptions: {
+			dictionary: options.dictionary,
+			languages: options.languages,
+			rules: options.rules
+		}
+	};
+}
+async function lintMarkdownFileWithResolvedOptions(filePath, options) {
+	const absoluteFilePath = node_path.resolve(filePath);
+	const relativePath = normalizePath(node_path.relative(options.cwd, absoluteFilePath));
+	if (!shouldLintAbsoluteFile(absoluteFilePath, options)) return {
+		...createEmptyLintResult(),
+		filePath: absoluteFilePath,
+		relativePath,
+		skipped: true
+	};
+	return {
+		...await lintMarkdownAsync(await node_fs_promises.readFile(absoluteFilePath, "utf-8"), options.lintOptions),
+		filePath: absoluteFilePath,
+		relativePath,
+		skipped: false
+	};
+}
+async function collectMarkdownLintFileEntries(options) {
+	const files = /* @__PURE__ */ new Map();
+	for (const pattern of options.include) {
+		const matches = await (0, glob.glob)(pattern, {
+			absolute: true,
+			cwd: options.cwd,
+			ignore: options.exclude,
+			nodir: true
 		});
-		results.set(page.url, html);
+		for (const filePath of matches) {
+			const absoluteFilePath = node_path.resolve(filePath);
+			if (shouldLintAbsoluteFile(absoluteFilePath, options)) files.set(absoluteFilePath, {
+				filePath: absoluteFilePath,
+				relativePath: normalizePath(node_path.relative(options.cwd, absoluteFilePath))
+			});
+		}
 	}
-	if (options.typesOutDir) await generateTypes(pages, options.typesOutDir);
-	return results;
-}
-/**
-* Generates TypeScript type definitions from page frontmatter.
-*
-* @param pages - All pages
-* @param outDir - Output directory for types
-*/
-async function generateTypes(pages, outDir) {
-	const types = generateFrontmatterTypes(pages.map((p) => p.frontmatter));
-	const typesPath = (0, node_path.join)(outDir, "page-props.d.ts");
-	await (0, node_fs_promises.mkdir)((0, node_path.dirname)(typesPath), { recursive: true });
-	await (0, node_fs_promises.writeFile)(typesPath, types, "utf-8");
+	return [...files.values()].sort((left, right) => left.filePath.localeCompare(right.filePath));
 }
-/**
-* Default theme component.
-* A minimal theme that renders page content with basic styling.
-*/
-function DefaultTheme({ children }) {
-	const { usePageProps, useSiteConfig } = (init_page_context(), require_vitepress.__toCommonJS(page_context_exports));
-	const page = usePageProps();
-	const site = useSiteConfig();
-	return { __html: `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>${escapeHtml(page.title)} - ${escapeHtml(site.name)}</title>
-  ${page.description ? `<meta name="description" content="${escapeHtml(page.description)}">` : ""}
-  <style>
-    :root {
-      --octc-color-primary: #4f6fae;
-      --octc-color-text: #131a30;
-      --octc-color-bg: #ffffff;
-      --octc-color-bg-alt: #f5f7fb;
-      --octc-color-text-muted: #4f607b;
-      --octc-color-border: #d2dbea;
-    }
-    body {
-      font-family: "IBM Plex Sans", "Avenir Next", "Segoe UI Variable", "Segoe UI", sans-serif;
-      line-height: 1.7;
-      color: var(--octc-color-text);
-      background: var(--octc-color-bg);
-      max-width: 800px;
-      margin: 0 auto;
-      padding: 2rem;
-    }
-    a { color: var(--octc-color-primary); }
-  </style>
-</head>
-<body>
-  <header>
-    <h1>${escapeHtml(site.name)}</h1>
-  </header>
-  <main>
-    ${children.__html}
-  </main>
-</body>
-</html>` };
+function shouldLintAbsoluteFile(filePath, options) {
+	const absolutePath = normalizePath(node_path.resolve(filePath));
+	const relativePath = normalizePath(node_path.relative(options.cwd, absolutePath));
+	const matches = (patterns) => patterns.some((pattern) => {
+		const normalizedPattern = normalizePath(pattern);
+		return node_path.matchesGlob(relativePath, normalizedPattern) || node_path.matchesGlob(absolutePath, normalizedPattern);
+	});
+	return matches(options.include) && !matches(options.exclude);
 }
-function escapeHtml(str) {
-	return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+function normalizePath(value) {
+	return value.split(node_path.sep).join("/");
 }
-/**
-* 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,
-*   },
-* });
-* ```
-*/
-function createTheme(config) {
-	const { layouts, defaultLayout = "default" } = config;
-	return function ThemeWithLayouts({ children }) {
-		const { usePageProps } = (init_page_context(), require_vitepress.__toCommonJS(page_context_exports));
-		const layoutName = usePageProps().layout ?? defaultLayout;
-		const Layout = layouts[layoutName] ?? layouts[defaultLayout];
-		if (!Layout) throw new Error(`[ox-content] Layout "${layoutName}" not found. Available layouts: ${Object.keys(layouts).join(", ")}`);
-		return Layout({ children });
+function createEmptyLintResult() {
+	return {
+		diagnostics: [],
+		errorCount: 0,
+		infoCount: 0,
+		warningCount: 0
 	};
 }
 //#endregion