@ox-content/vite-plugin 2.9.0 → 2.11.0

package/dist/index.cjs

@@ -5,6 +5,7 @@ const require_tabs = require("./tabs.cjs");
 const require_youtube = require("./youtube.cjs");
 const require_github = require("./github.cjs");
 const require_ogp = require("./ogp.cjs");
+const require_vitepress = require("./vitepress.cjs");
 let path = require("path");
 path = require_chunk.__toESM(path);
 let unified = require("unified");
@@ -25,6 +26,40 @@ crypto = require_chunk.__toESM(crypto);
 let node_module = require("node:module");
 let node_fs_promises = require("node:fs/promises");
 node_fs_promises = require_chunk.__toESM(node_fs_promises);
+//#region src/markdown.ts
+const DEFAULT_MARKDOWN_EXTENSIONS = [
+	".md",
+	".markdown",
+	".mdx"
+];
+function normalizeMarkdownExtensions(extensions) {
+	const values = extensions?.length ? extensions : DEFAULT_MARKDOWN_EXTENSIONS;
+	const seen = /* @__PURE__ */ new Set();
+	const normalized = [];
+	for (const extension of values) {
+		const value = extension.startsWith(".") ? extension : `.${extension}`;
+		const key = value.toLowerCase();
+		if (!seen.has(key)) {
+			seen.add(key);
+			normalized.push(value);
+		}
+	}
+	return normalized;
+}
+function isMarkdownFilePath(filePath, extensions = DEFAULT_MARKDOWN_EXTENSIONS) {
+	const pathname = filePath.split("?")[0].split("#")[0].toLowerCase();
+	return extensions.some((extension) => pathname.endsWith(extension.toLowerCase()));
+}
+function stripMarkdownExtension(filePath, extensions = DEFAULT_MARKDOWN_EXTENSIONS) {
+	const match = [...extensions].sort((left, right) => right.length - left.length).find((extension) => filePath.toLowerCase().endsWith(extension.toLowerCase()));
+	return match ? filePath.slice(0, -match.length) : filePath;
+}
+function markdownGlobPattern(srcDir, extensions) {
+	const suffixes = extensions.map((extension) => extension.replace(/^\./, ""));
+	if (suffixes.length === 1) return path.join(srcDir, `**/*.${suffixes[0]}`);
+	return path.join(srcDir, `**/*.{${suffixes.join(",")}}`);
+}
+//#endregion
 //#region src/environment.ts
 /**
 * Creates the Markdown processing environment configuration.
@@ -57,7 +92,7 @@ function createMarkdownEnvironment(options) {
 			rollupOptions: { external: [/^node:/, /\.node$/] }
 		},
 		resolve: {
-			extensions: [".md", ".markdown"],
+			extensions: options.extensions,
 			conditions: [
 				"markdown",
 				"node",
@@ -6808,6 +6843,58 @@ async function highlightCode(html, theme = "github-dark", langs = []) {
 	return String(result);
 }
 //#endregion
+//#region src/plugins/index.ts
+/**
+* Transform all enabled plugins in HTML content.
+*/
+async function transformAllPlugins(html, options = {}) {
+	const { tabs = true, youtube = true, github = true, ogp, openGraph, mermaid = true, githubToken } = options;
+	let result = html;
+	const ogpOptions = openGraph ?? ogp ?? true;
+	if (tabs) {
+		const { transformTabs } = await Promise.resolve().then(() => require("./tabs.cjs")).then((n) => n.tabs_exports);
+		result = await transformTabs(result);
+	}
+	if (youtube) {
+		const { transformYouTube } = await Promise.resolve().then(() => require("./youtube.cjs")).then((n) => n.youtube_exports);
+		result = await transformYouTube(result);
+	}
+	if (github !== false) {
+		const { transformGitHub } = await Promise.resolve().then(() => require("./github.cjs")).then((n) => n.github_exports);
+		result = await transformGitHub(result, void 0, {
+			token: githubToken,
+			...typeof github === "object" ? github : {}
+		});
+	}
+	if (ogpOptions !== false) {
+		const { transformOgp } = await Promise.resolve().then(() => require("./ogp.cjs")).then((n) => n.ogp_exports);
+		result = await transformOgp(result, void 0, typeof ogpOptions === "object" ? ogpOptions : {});
+	}
+	if (mermaid) {
+		const { transformMermaidStatic } = await Promise.resolve().then(() => require("./mermaid.cjs")).then((n) => n.mermaid_exports);
+		result = await transformMermaidStatic(result);
+	}
+	return result;
+}
+/**
+* Transform built-in embed components in HTML content.
+*/
+async function transformBuiltinEmbeds(html, options) {
+	let result = html;
+	if (options.github) {
+		const { transformGitHub } = await Promise.resolve().then(() => require("./github.cjs")).then((n) => n.github_exports);
+		result = await transformGitHub(result, void 0, {
+			token: process.env.GITHUB_TOKEN,
+			...options.github
+		});
+	}
+	if (options.openGraph) {
+		const { transformOgp } = await Promise.resolve().then(() => require("./ogp.cjs")).then((n) => n.ogp_exports);
+		result = await transformOgp(result, void 0, options.openGraph);
+	}
+	return result;
+}
+//#endregion
 //#region src/plugins/mermaid-protect.ts
 /**
 * Extract `<div class="ox-mermaid">...</div>` blocks and replace
@@ -6989,6 +7076,10 @@ async function transformMarkdown(source, filePath, options, ssgOptions) {
 		const highlightedHtml = await highlightCode(html, options.highlightTheme, options.highlightLangs);
 		html = napi.mergeHighlightedCodeBlocks(originalHtml, highlightedHtml);
 	}
+	html = await transformBuiltinEmbeds(html, options.embeds ?? {
+		github: {},
+		openGraph: {}
+	});
 	html = restoreMermaidSvgs(html, svgs);
 	return {
 		code: generateModuleCode(html, frontmatter, toc, filePath, options),
@@ -8588,36 +8679,6 @@ async function renderSinglePage(entry, templateFn, templateSource, options, cach
 	}
 }
 //#endregion
-//#region src/plugins/index.ts
-/**
-* Transform all enabled plugins in HTML content.
-*/
-async function transformAllPlugins(html, options = {}) {
-	const { tabs = true, youtube = true, github = true, ogp = true, mermaid = true, githubToken } = options;
-	let result = html;
-	if (tabs) {
-		const { transformTabs } = await Promise.resolve().then(() => require("./tabs.cjs")).then((n) => n.tabs_exports);
-		result = await transformTabs(result);
-	}
-	if (youtube) {
-		const { transformYouTube } = await Promise.resolve().then(() => require("./youtube.cjs")).then((n) => n.youtube_exports);
-		result = await transformYouTube(result);
-	}
-	if (github) {
-		const { transformGitHub } = await Promise.resolve().then(() => require("./github.cjs")).then((n) => n.github_exports);
-		result = await transformGitHub(result, void 0, { token: githubToken });
-	}
-	if (ogp) {
-		const { transformOgp } = await Promise.resolve().then(() => require("./ogp.cjs")).then((n) => n.ogp_exports);
-		result = await transformOgp(result);
-	}
-	if (mermaid) {
-		const { transformMermaidStatic } = await Promise.resolve().then(() => require("./mermaid.cjs")).then((n) => n.mermaid_exports);
-		result = await transformMermaidStatic(result);
-	}
-	return result;
-}
-//#endregion
 //#region src/island/parse.ts
 /**
 * Island Parser
@@ -8809,213 +8870,6 @@ initIslands((el, props) => {
 `;
 }
 //#endregion
-//#region src/theme.ts
-/**
-* Default theme configuration.
-* Based on the current ox-content SSG styles.
-*/
-const defaultTheme = {
-	name: "default",
-	colors: {
-		primary: "#4f6fae",
-		primaryHover: "#425f96",
-		background: "#ffffff",
-		backgroundAlt: "#f5f7fb",
-		text: "#131a30",
-		textMuted: "#4f607b",
-		border: "#d2dbea",
-		codeBackground: "#101a31",
-		codeText: "#edf3ff"
-	},
-	darkColors: {
-		primary: "#86a4da",
-		primaryHover: "#a3bbe8",
-		background: "#060816",
-		backgroundAlt: "#0d1528",
-		text: "#ebf2ff",
-		textMuted: "#8ea0bf",
-		border: "#223252",
-		codeBackground: "#0a1020",
-		codeText: "#e7f0ff"
-	},
-	fonts: {
-		sans: "\"IBM Plex Sans\", \"Avenir Next\", \"Segoe UI Variable\", \"Segoe UI\", sans-serif",
-		mono: "\"IBM Plex Mono\", \"SFMono-Regular\", Consolas, monospace"
-	},
-	entryPage: { mode: "default" },
-	layout: {
-		sidebarWidth: "260px",
-		headerHeight: "60px",
-		maxContentWidth: "960px"
-	},
-	header: {
-		logo: void 0,
-		logoLight: void 0,
-		logoDark: void 0,
-		showSiteNameText: true,
-		logoWidth: 28,
-		logoHeight: 28
-	},
-	footer: {
-		message: void 0,
-		copyright: void 0
-	},
-	socialLinks: {},
-	embed: {},
-	css: "",
-	js: ""
-};
-/**
-* Deep merge two objects.
-*/
-function deepMerge(target, source) {
-	const result = { ...target };
-	for (const key of Object.keys(source)) {
-		const sourceValue = source[key];
-		const targetValue = target[key];
-		if (sourceValue !== void 0 && typeof sourceValue === "object" && sourceValue !== null && !Array.isArray(sourceValue) && typeof targetValue === "object" && targetValue !== null && !Array.isArray(targetValue)) result[key] = deepMerge(targetValue, sourceValue);
-		else if (sourceValue !== void 0) result[key] = sourceValue;
-	}
-	return result;
-}
-/**
-* Defines a theme configuration with type checking.
-*
-* @example
-* ```ts
-* const myTheme = defineTheme({
-*   extends: defaultTheme,
-*   colors: {
-*     primary: '#3498db',
-*   },
-*   footer: {
-*     copyright: '2025 My Company',
-*   },
-* });
-* ```
-*/
-function defineTheme(config) {
-	return config;
-}
-/**
-* Merges multiple theme configurations.
-* Later themes override earlier ones.
-*
-* @example
-* ```ts
-* const merged = mergeThemes(defaultTheme, customTheme, overrides);
-* ```
-*/
-function mergeThemes(...themes) {
-	if (themes.length === 0) return { ...defaultTheme };
-	let result = {};
-	for (const theme of themes) result = deepMerge(result, theme);
-	return result;
-}
-/**
-* Resolves a theme configuration by merging with its extends chain and defaults.
-*/
-function resolveTheme(config) {
-	if (!config) return resolveTheme(defaultTheme);
-	const chain = [];
-	let current = config;
-	while (current) {
-		chain.unshift(current);
-		current = current.extends;
-	}
-	if (chain[0] !== defaultTheme && chain[0]?.name !== "default") chain.unshift(defaultTheme);
-	const merged = mergeThemes(...chain);
-	return {
-		name: merged.name ?? "custom",
-		colors: merged.colors ?? defaultTheme.colors,
-		darkColors: merged.darkColors ?? defaultTheme.darkColors,
-		fonts: merged.fonts ?? defaultTheme.fonts,
-		entryPage: merged.entryPage ?? defaultTheme.entryPage,
-		layout: merged.layout ?? defaultTheme.layout,
-		header: merged.header ?? defaultTheme.header,
-		footer: merged.footer ?? defaultTheme.footer,
-		socialLinks: merged.socialLinks ?? defaultTheme.socialLinks,
-		sidebar: merged.sidebar ?? [],
-		embed: merged.embed ?? {},
-		css: merged.css ?? "",
-		js: merged.js ?? ""
-	};
-}
-/**
-* Converts resolved theme to the format expected by Rust NAPI.
-*/
-function themeToNapi(theme) {
-	const socialLinks = socialLinksToNapi(theme.socialLinks);
-	return {
-		colors: theme.colors.primary ? {
-			primary: theme.colors.primary,
-			primaryHover: theme.colors.primaryHover,
-			background: theme.colors.background,
-			backgroundAlt: theme.colors.backgroundAlt,
-			text: theme.colors.text,
-			textMuted: theme.colors.textMuted,
-			border: theme.colors.border,
-			codeBackground: theme.colors.codeBackground,
-			codeText: theme.colors.codeText
-		} : void 0,
-		darkColors: theme.darkColors.primary ? {
-			primary: theme.darkColors.primary,
-			primaryHover: theme.darkColors.primaryHover,
-			background: theme.darkColors.background,
-			backgroundAlt: theme.darkColors.backgroundAlt,
-			text: theme.darkColors.text,
-			textMuted: theme.darkColors.textMuted,
-			border: theme.darkColors.border,
-			codeBackground: theme.darkColors.codeBackground,
-			codeText: theme.darkColors.codeText
-		} : void 0,
-		fonts: theme.fonts.sans ? {
-			sans: theme.fonts.sans,
-			mono: theme.fonts.mono
-		} : void 0,
-		entryPage: theme.entryPage.mode ? { mode: theme.entryPage.mode } : void 0,
-		layout: theme.layout.sidebarWidth ? {
-			sidebarWidth: theme.layout.sidebarWidth,
-			headerHeight: theme.layout.headerHeight,
-			maxContentWidth: theme.layout.maxContentWidth
-		} : void 0,
-		header: theme.header.logo || theme.header.logoLight || theme.header.logoDark ? {
-			logo: theme.header.logo,
-			logoLight: theme.header.logoLight,
-			logoDark: theme.header.logoDark,
-			showSiteNameText: theme.header.showSiteNameText,
-			logoWidth: theme.header.logoWidth,
-			logoHeight: theme.header.logoHeight
-		} : void 0,
-		footer: theme.footer.message || theme.footer.copyright ? {
-			message: theme.footer.message,
-			copyright: theme.footer.copyright
-		} : void 0,
-		socialLinks,
-		embed: Object.keys(theme.embed).length > 0 ? theme.embed : void 0,
-		css: theme.css || void 0,
-		js: theme.js || void 0
-	};
-}
-function socialLinksToNapi(links) {
-	if (Array.isArray(links)) {
-		const items = links.map((item) => {
-			return {
-				icon: typeof item.icon === "string" ? item.icon : void 0,
-				iconSvg: typeof item.icon === "object" ? item.icon.svg : void 0,
-				link: item.link,
-				ariaLabel: item.ariaLabel
-			};
-		});
-		return items.length > 0 ? { links: items } : void 0;
-	}
-	return links.github || links.twitter || links.discord ? {
-		github: links.github,
-		twitter: links.twitter,
-		discord: links.discord
-	} : void 0;
-}
-//#endregion
 //#region src/ssg.ts
 /**
 * SSG (Static Site Generation) module for ox-content
@@ -10380,7 +10234,7 @@ function resolveSsgOptions(ssg) {
 		bare: false,
 		generateOgImage: false,
 		lastUpdated: false,
-		theme: resolveTheme(void 0)
+		theme: require_vitepress.resolveTheme(void 0)
 	};
 	return {
 		enabled: ssg.enabled ?? true,
@@ -10392,7 +10246,8 @@ function resolveSsgOptions(ssg) {
 		generateOgImage: ssg.generateOgImage ?? false,
 		lastUpdated: ssg.lastUpdated ?? false,
 		siteUrl: ssg.siteUrl,
-		theme: resolveTheme(ssg.theme)
+		theme: require_vitepress.resolveTheme(ssg.theme),
+		navigation: ssg.navigation
 	};
 }
 /**
@@ -10453,7 +10308,7 @@ async function generateHtmlPage(pageData, navGroups, siteName, base, ogImage, th
 		collapsed: group.collapsed,
 		items: group.items.map(toRustNavItem)
 	}));
-	const themeForRust = theme ? themeToNapi(theme) : void 0;
+	const themeForRust = theme ? require_vitepress.themeToNapi(theme) : void 0;
 	const entryPageForRust = pageData.entryPage ? {
 		hero: pageData.entryPage.hero ? {
 			name: pageData.entryPage.hero.name,
@@ -10523,6 +10378,59 @@ async function externalizeSharedPageAssets(pages, outDir, base) {
 function getUrlPath$1(inputPath, srcDir) {
 	return require_mermaid.importNapiModuleSync().getSsgUrlPath(inputPath, srcDir);
 }
+function isExternalHref(value) {
+	return /^[a-z][a-z0-9+.-]*:/i.test(value) || value.startsWith("//");
+}
+function splitHrefSuffix(value) {
+	const match = /^([^?#]*)([?#].*)?$/.exec(value);
+	return {
+		pathname: match?.[1] ?? value,
+		suffix: match?.[2] ?? ""
+	};
+}
+function normalizeNavigationPath(value) {
+	const { pathname, suffix } = splitHrefSuffix(value.trim());
+	let normalized = pathname || "/";
+	if (!normalized.startsWith("/")) normalized = `/${normalized}`;
+	normalized = normalized.replace(/\/index(?:\.(?:html?|md|markdown))?$/i, "/").replace(/\.(?:html?|md|markdown)$/i, "");
+	if (normalized !== "/") normalized = normalized.replace(/\/+$/, "");
+	return {
+		path: normalized || "/",
+		suffix
+	};
+}
+function buildHrefFromNavigationPath(pathname, base, extension) {
+	if (pathname === "/" || pathname === "") return `${base}index${extension}`;
+	return `${base}${pathname.replace(/^\/+/, "")}/index${extension}`;
+}
+/**
+* Resolves manual navigation config to the format used by the built-in SSG renderer.
+*/
+function resolveNavigationGroups(navigation, base, extension) {
+	if (!navigation) return;
+	return navigation.map((group) => ({
+		title: group.title,
+		items: group.items.flatMap((item) => {
+			const rawHref = item.href ?? item.path;
+			if (!rawHref) return [];
+			if (isExternalHref(rawHref) || rawHref.startsWith("#")) return [{
+				title: item.title,
+				path: item.path ?? rawHref,
+				href: rawHref
+			}];
+			const { path: path$2 } = normalizeNavigationPath(item.path ?? rawHref);
+			const href = item.href ? (() => {
+				const normalized = normalizeNavigationPath(item.href);
+				return `${buildHrefFromNavigationPath(normalized.path, base, extension)}${normalized.suffix}`;
+			})() : buildHrefFromNavigationPath(path$2, base, extension);
+			return [{
+				title: item.title,
+				path: path$2,
+				href
+			}];
+		})
+	}));
+}
 function getPageLocale(urlPath, i18n) {
 	if (!i18n) return void 0;
 	return require_mermaid.importNapiModuleSync().getSsgPageLocale(urlPath, i18n.defaultLocale, i18n.locales.map((locale) => locale.code)) ?? void 0;
@@ -10539,8 +10447,8 @@ function formatTitle(name) {
 /**
 * Collects all markdown files from the source directory.
 */
-async function collectMarkdownFiles$1(srcDir) {
-	return (await (0, glob.glob)(path.join(srcDir, "**/*.{md,markdown}"), {
+async function collectMarkdownFiles$1(srcDir, extensions = DEFAULT_MARKDOWN_EXTENSIONS) {
+	return (await (0, glob.glob)(markdownGlobPattern(srcDir, extensions), {
 		nodir: true,
 		ignore: [
 			"**/node_modules/**",
@@ -10582,8 +10490,8 @@ async function buildSsg(options, root) {
 			force: true
 		});
 	} catch {}
-	const markdownFiles = await collectMarkdownFiles$1(srcDir);
-	const navItems = ssgOptions.theme?.sidebar.length ? buildThemeNavItems(ssgOptions.theme.sidebar, base, ssgOptions.extension) : buildNavItems(markdownFiles, srcDir, base, ssgOptions.extension);
+	const markdownFiles = await collectMarkdownFiles$1(srcDir, options.extensions);
+	const navItems = resolveNavigationGroups(ssgOptions.navigation, base, ssgOptions.extension) ?? (ssgOptions.theme?.sidebar.length ? buildThemeNavItems(ssgOptions.theme.sidebar, base, ssgOptions.extension) : buildNavItems(markdownFiles, srcDir, base, ssgOptions.extension));
 	let siteName = ssgOptions.siteName ?? "Documentation";
 	if (!ssgOptions.siteName) try {
 		const pkgPath = path.join(root, "package.json");
@@ -10602,22 +10510,23 @@ async function buildSsg(options, root) {
 			baseUrl: base,
 			sourcePath: inputPath
 		});
+		const frontmatter = require_vitepress.normalizeVitePressFrontmatter(result.frontmatter);
 		let transformedHtml = result.html;
 		const { html: protectedHtml, svgs: mermaidSvgs } = protectMermaidSvgs(transformedHtml);
 		transformedHtml = protectedHtml;
 		const pluginOptions = {
 			tabs: true,
 			youtube: true,
-			github: true,
-			ogp: true,
+			github: options.embeds.github,
+			openGraph: options.embeds.openGraph,
 			mermaid: true,
 			githubToken: process.env.GITHUB_TOKEN
 		};
 		transformedHtml = await transformAllPlugins(transformedHtml, pluginOptions);
 		if (hasIslands(transformedHtml)) transformedHtml = (await transformIslands(transformedHtml)).html;
 		transformedHtml = restoreMermaidSvgs(transformedHtml, mermaidSvgs);
-		const title = extractTitle$1(transformedHtml, result.frontmatter);
-		const description = result.frontmatter.description;
+		const title = extractTitle$1(transformedHtml, frontmatter);
+		const description = frontmatter.description;
 		const routePaths = getRoutePaths(inputPath, srcDir, outDir, base, ssgOptions.extension, ssgOptions.siteUrl);
 		pageResults.push({
 			inputPath,
@@ -10626,11 +10535,11 @@ async function buildSsg(options, root) {
 			title,
 			description,
 			lastUpdated: napi?.getGitLastUpdated(inputPath, root) ?? void 0,
-			frontmatter: result.frontmatter,
+			frontmatter,
 			toc: result.toc
 		});
 		if (shouldGenerateOgImages) {
-			const { layout: _layout, ...frontmatterRest } = result.frontmatter;
+			const { layout: _layout, ...frontmatterRest } = frontmatter;
 			ogImageEntries.push({
 				props: {
 					...frontmatterRest,
@@ -10755,7 +10664,7 @@ function resolveSearchOptions(options) {
 /**
 * Collects all Markdown files from a directory.
 */
-async function collectMarkdownFiles(dir) {
+async function collectMarkdownFiles(dir, extensions = DEFAULT_MARKDOWN_EXTENSIONS) {
 	const files = [];
 	async function walk(currentDir) {
 		try {
@@ -10763,7 +10672,7 @@ async function collectMarkdownFiles(dir) {
 			for (const entry of entries) {
 				const fullPath = path.join(currentDir, entry.name);
 				if (entry.isDirectory() && !entry.name.startsWith(".") && entry.name !== "node_modules") await walk(fullPath);
-				else if (entry.isFile() && entry.name.endsWith(".md")) files.push(fullPath);
+				else if (entry.isFile() && isMarkdownFilePath(entry.name, extensions)) files.push(fullPath);
 			}
 		} catch {}
 	}
@@ -10773,7 +10682,7 @@ async function collectMarkdownFiles(dir) {
 /**
 * Builds the search index from Markdown files.
 */
-async function buildSearchIndex(srcDir, base) {
+async function buildSearchIndex(srcDir, base, extensions = DEFAULT_MARKDOWN_EXTENSIONS) {
 	const napi = await getOxContent();
 	if (!napi) return JSON.stringify({
 		documents: [],
@@ -10782,13 +10691,12 @@ async function buildSearchIndex(srcDir, base) {
 		avg_dl: 0,
 		doc_count: 0
 	});
-	const files = await collectMarkdownFiles(srcDir);
+	const files = await collectMarkdownFiles(srcDir, extensions);
 	const documents = [];
 	for (const file of files) try {
 		const content = await fs_promises.readFile(file, "utf-8");
-		const relativePath = path.relative(srcDir, file);
-		const url = base + relativePath.replace(/\.md$/, "").replace(/\\/g, "/");
-		const id = relativePath.replace(/\.md$/, "").replace(/\\/g, "/");
+		const id = stripMarkdownExtension(path.relative(srcDir, file), extensions).replace(/\\/g, "/");
+		const url = base + id;
 		const extractSearchContent = napi.extractSearchContent;
 		if (!extractSearchContent) {
 			console.warn("[ox-content] Search not available: extractSearchContent not implemented");
@@ -10883,26 +10791,27 @@ function shouldSkip(url) {
 * Resolve a request URL to a markdown file path.
 * Returns null if no matching file exists.
 */
-async function resolveMarkdownFile(url, srcDir) {
+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);
-	let relativePath;
-	if (pathname === "/") relativePath = "index.md";
-	else relativePath = pathname.slice(1) + ".md";
-	const filePath = path.join(srcDir, relativePath);
-	try {
-		await fs_promises.access(filePath);
-		return filePath;
-	} catch {
-		const indexPath = path.join(srcDir, pathname === "/" ? "" : pathname.slice(1), "index.md");
+	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;
-		}
+		} catch {}
 	}
+	return null;
 }
 /**
 * Inject Vite HMR client script into the HTML.
@@ -10957,32 +10866,33 @@ async function renderPage$1(filePath, options, navGroups, siteName, base, root)
 		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: true,
-		ogp: true,
+		github: options.embeds.github,
+		openGraph: options.embeds.openGraph,
 		mermaid: true,
 		githubToken: process.env.GITHUB_TOKEN
 	});
 	if (hasIslands(transformedHtml)) transformedHtml = (await transformIslands(transformedHtml)).html;
 	transformedHtml = restoreMermaidSvgs(transformedHtml, mermaidSvgs);
-	const title = extractTitle$1(transformedHtml, result.frontmatter);
-	const description = result.frontmatter.description;
+	const title = extractTitle$1(transformedHtml, frontmatter);
+	const description = frontmatter.description;
 	let entryPage;
-	if (result.frontmatter.layout === "entry") entryPage = {
-		hero: result.frontmatter.hero,
-		features: result.frontmatter.features
+	if (frontmatter.layout === "entry") entryPage = {
+		hero: frontmatter.hero,
+		features: frontmatter.features
 	};
 	let html = await generateHtmlPage({
 		title,
 		description,
 		content: transformedHtml,
 		toc: result.toc,
-		frontmatter: result.frontmatter,
+		frontmatter,
 		path: getUrlPath$1(filePath, srcDir),
 		href: getUrlPath$1(filePath, srcDir) || "/",
 		entryPage
@@ -11002,7 +10912,7 @@ function createDevServerMiddleware(options, root, cache) {
 		let routeUrl = url;
 		if (base !== "/" && routeUrl.startsWith(base)) routeUrl = "/" + routeUrl.slice(base.length);
 		if (shouldSkip(routeUrl)) return next();
-		const filePath = await resolveMarkdownFile(routeUrl, srcDir);
+		const filePath = await resolveMarkdownFile(routeUrl, srcDir, options.extensions);
 		if (!filePath) return next();
 		try {
 			const cached = cache.pages.get(filePath);
@@ -11013,7 +10923,10 @@ function createDevServerMiddleware(options, root, cache) {
 				return;
 			}
 			if (!cache.siteName) cache.siteName = await resolveSiteName(options, root);
-			if (!cache.navGroups) cache.navGroups = buildNavItems(await collectMarkdownFiles$1(srcDir), srcDir, base, ".html");
+			if (!cache.navGroups) {
+				const markdownFiles = await collectMarkdownFiles$1(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");
@@ -11058,9 +10971,9 @@ function extractTitle(content, frontmatter) {
 	const match = content.match(/^#\s+(.+)$/m);
 	return match ? match[1].trim() : "";
 }
-function getUrlPath(filePath, srcDir) {
+function getUrlPath(filePath, srcDir, extensions) {
 	let rel = path.relative(srcDir, filePath).replace(/\\/g, "/");
-	rel = rel.replace(/\.md$/, "");
+	rel = stripMarkdownExtension(rel, extensions);
 	if (rel === "index") return "/";
 	if (rel.endsWith("/index")) rel = rel.slice(0, -6);
 	return "/" + rel;
@@ -11100,21 +11013,18 @@ function validatePage(page, options) {
 }
 async function collectPages(options, root) {
 	const srcDir = path.resolve(root, options.srcDir);
-	const files = await (0, glob.glob)("**/*.md", {
-		cwd: srcDir,
-		absolute: true
-	});
+	const files = await (0, glob.glob)(markdownGlobPattern(srcDir, options.extensions), { absolute: true });
 	const pages = [];
 	const generateOgImage = options.ogImage || options.ssg.generateOgImage;
 	for (const file of files.sort()) {
 		const content = fs.readFileSync(file, "utf-8");
-		const frontmatter = parseFrontmatter(content);
+		const frontmatter = require_vitepress.normalizeVitePressFrontmatter(parseFrontmatter(content));
 		if (frontmatter.layout === "entry") continue;
 		const title = extractTitle(content, frontmatter);
 		const description = typeof frontmatter.description === "string" ? frontmatter.description : "";
 		const author = typeof frontmatter.author === "string" ? frontmatter.author : "";
 		const tags = Array.isArray(frontmatter.tags) ? frontmatter.tags : typeof frontmatter.tags === "string" ? [frontmatter.tags] : [];
-		const urlPath = getUrlPath(file, srcDir);
+		const urlPath = getUrlPath(file, srcDir, options.extensions);
 		const ogImageUrl = computeOgImageUrl(urlPath, options.base, options.ssg.siteUrl, generateOgImage, options.ssg.ogImage);
 		const page = {
 			path: path.relative(srcDir, file),
@@ -11763,7 +11673,11 @@ function sortDiagnostics(diagnostics) {
 }
 //#endregion
 //#region src/lint-files.ts
-const DEFAULT_LINT_FILE_INCLUDE = ["**/*.md", "**/*.markdown"];
+const DEFAULT_LINT_FILE_INCLUDE = [
+	"**/*.md",
+	"**/*.markdown",
+	"**/*.mdx"
+];
 const DEFAULT_LINT_FILE_EXCLUDE = [
 	"**/node_modules/**",
 	"**/.git/**",
@@ -12470,13 +12384,13 @@ function oxContent(options = {}) {
 		configureServer(devServer) {
 			devServer.middlewares.use(async (req, res, next) => {
 				const url = req.url;
-				if (!url || !url.endsWith(".md")) return next();
+				if (!url || !isMarkdownFilePath(url, resolvedOptions.extensions)) return next();
 				next();
 			});
 		},
 		resolveId(id) {
 			if (id.startsWith("virtual:ox-content/")) return "\0" + id;
-			if (id.endsWith(".md")) return id;
+			if (isMarkdownFilePath(id, resolvedOptions.extensions)) return id;
 			return null;
 		},
 		async load(id) {
@@ -12484,14 +12398,14 @@ function oxContent(options = {}) {
 			return null;
 		},
 		async transform(code, id) {
-			if (!id.endsWith(".md")) return null;
+			if (!isMarkdownFilePath(id, resolvedOptions.extensions)) return null;
 			return {
 				code: (await transformMarkdown(code, id, resolvedOptions)).code,
 				map: null
 			};
 		},
 		async handleHotUpdate({ file, server }) {
-			if (file.endsWith(".md")) {
+			if (isMarkdownFilePath(file, resolvedOptions.extensions)) {
 				server.ws.send({
 					type: "custom",
 					event: "ox-content:update",
@@ -12544,7 +12458,7 @@ function oxContent(options = {}) {
 			const srcDir = path.resolve(root, resolvedOptions.srcDir);
 			devServer.middlewares.use(createDevServerMiddleware(resolvedOptions, root, ssgDevCache));
 			devServer.watcher.on("add", (file) => {
-				if (file.startsWith(srcDir) && file.endsWith(".md")) {
+				if (file.startsWith(srcDir) && isMarkdownFilePath(file, resolvedOptions.extensions)) {
 					invalidateNavCache(ssgDevCache);
 					devServer.ws.send({
 						type: "custom",
@@ -12557,7 +12471,7 @@ function oxContent(options = {}) {
 				}
 			});
 			devServer.watcher.on("unlink", (file) => {
-				if (file.startsWith(srcDir) && file.endsWith(".md")) {
+				if (file.startsWith(srcDir) && isMarkdownFilePath(file, resolvedOptions.extensions)) {
 					invalidateNavCache(ssgDevCache);
 					devServer.ws.send({
 						type: "custom",
@@ -12570,7 +12484,7 @@ function oxContent(options = {}) {
 				}
 			});
 			devServer.watcher.on("change", (file) => {
-				if (file.startsWith(srcDir) && file.endsWith(".md")) invalidatePageCache(ssgDevCache, file);
+				if (file.startsWith(srcDir) && isMarkdownFilePath(file, resolvedOptions.extensions)) invalidatePageCache(ssgDevCache, file);
 			});
 		},
 		async closeBundle() {
@@ -12610,7 +12524,7 @@ function oxContent(options = {}) {
 				const root = config?.root || process.cwd();
 				const srcDir = path.resolve(root, resolvedOptions.srcDir);
 				try {
-					searchIndexJson = await buildSearchIndex(srcDir, resolvedOptions.base);
+					searchIndexJson = await buildSearchIndex(srcDir, resolvedOptions.base, resolvedOptions.extensions);
 					console.log("[ox-content] Search index built");
 				} catch (err) {
 					console.warn("[ox-content] Failed to build search index:", err);
@@ -12641,6 +12555,7 @@ function resolveOptions(options) {
 		srcDir: options.srcDir ?? "content",
 		outDir: options.outDir ?? "dist",
 		base: options.base ?? "/",
+		extensions: normalizeMarkdownExtensions(options.extensions),
 		ssg: resolveSsgOptions(options.ssg),
 		gfm: options.gfm ?? true,
 		footnotes: options.footnotes ?? true,
@@ -12661,9 +12576,25 @@ function resolveOptions(options) {
 		docs: resolveDocsOptions(options.docs),
 		search: resolveSearchOptions(options.search),
 		ogViewer: options.ogViewer ?? true,
+		embeds: resolveBuiltinEmbedOptions(options.embeds),
 		i18n: resolveI18nOptions(options.i18n)
 	};
 }
+function resolveBuiltinEmbedOptions(options) {
+	if (options === false) return {
+		github: false,
+		openGraph: false
+	};
+	return {
+		github: resolveSingleEmbedOptions(options?.github),
+		openGraph: resolveSingleEmbedOptions(options?.openGraph)
+	};
+}
+function resolveSingleEmbedOptions(options) {
+	if (options === false) return false;
+	if (options === true || options === void 0) return {};
+	return options;
+}
 function resolveCodeAnnotationsOptions(options) {
 	if (!options) return {
 		enabled: false,
@@ -12737,24 +12668,30 @@ function normalizeRuntimeBase(base) {
 }
 //#endregion
 exports.DEFAULT_HTML_TEMPLATE = DEFAULT_HTML_TEMPLATE;
+exports.DEFAULT_MARKDOWN_EXTENSIONS = DEFAULT_MARKDOWN_EXTENSIONS;
 exports.DefaultTheme = DefaultTheme;
 exports.Fragment = Fragment;
 exports.buildSearchIndex = buildSearchIndex;
 exports.buildSsg = buildSsg;
 exports.clearRenderContext = clearRenderContext;
 exports.collectGitHubRepos = require_github.collectGitHubRepos;
+exports.collectGitHubSources = require_github.collectGitHubSources;
 exports.collectOgpUrls = require_ogp.collectOgpUrls;
+exports.convertVitePressNav = require_vitepress.convertVitePressNav;
+exports.convertVitePressSidebar = require_vitepress.convertVitePressSidebar;
 exports.createI18nPlugin = createI18nPlugin;
 exports.createMarkdownEnvironment = createMarkdownEnvironment;
 exports.createTheme = createTheme;
-exports.defaultTheme = defaultTheme;
-exports.defineTheme = defineTheme;
+exports.defaultTheme = require_vitepress.defaultTheme;
+exports.defineTheme = require_vitepress.defineTheme;
 exports.each = each;
 exports.extractDocs = extractDocs;
 exports.extractIslandInfo = extractIslandInfo;
 exports.extractVideoId = require_youtube.extractVideoId;
+exports.fetchGitHubSource = require_github.fetchGitHubSource;
 exports.fetchOgpData = require_ogp.fetchOgpData;
 exports.fetchRepoData = require_github.fetchRepoData;
+exports.fromVitePressConfig = require_vitepress.fromVitePressConfig;
 exports.generateFrontmatterTypes = generateFrontmatterTypes;
 exports.generateHydrationScript = generateHydrationScript;
 exports.generateMarkdown = generateMarkdown;
@@ -12762,31 +12699,40 @@ exports.generateOgImages = generateOgImages;
 exports.generateTabsCSS = require_tabs.generateTabsCSS;
 exports.generateTypes = generateTypes;
 exports.generateVirtualModule = generateVirtualModule;
+exports.generateVitePressMigrationConfig = require_vitepress.generateVitePressMigrationConfig;
 exports.hasIslands = hasIslands;
 exports.inferType = inferType;
+exports.isMarkdownFilePath = isMarkdownFilePath;
 exports.jsx = jsx;
 exports.jsxs = jsxs;
 exports.lintMarkdown = lintMarkdown;
 exports.lintMarkdownAsync = lintMarkdownAsync;
 exports.lintMarkdownFile = lintMarkdownFile;
 exports.lintMarkdownFiles = lintMarkdownFiles;
-exports.mergeThemes = mergeThemes;
+exports.mergeThemes = require_vitepress.mergeThemes;
 exports.mermaidClientScript = require_mermaid.mermaidClientScript;
+exports.normalizeMarkdownExtensions = normalizeMarkdownExtensions;
+exports.normalizeVitePressFrontmatter = require_vitepress.normalizeVitePressFrontmatter;
 exports.oxContent = oxContent;
+exports.parseGitHubLineRange = require_github.parseGitHubLineRange;
+exports.parseGitHubPermalink = require_github.parseGitHubPermalink;
 exports.prefetchGitHubRepos = require_github.prefetchGitHubRepos;
+exports.prefetchGitHubSources = require_github.prefetchGitHubSources;
 exports.prefetchOgpData = require_ogp.prefetchOgpData;
 exports.raw = raw;
 exports.renderAllPages = renderAllPages;
 exports.renderPage = renderPage;
 exports.renderToString = renderToString;
+exports.resolveBuiltinEmbedOptions = resolveBuiltinEmbedOptions;
 exports.resolveDocsOptions = resolveDocsOptions;
 exports.resolveI18nOptions = resolveI18nOptions;
 exports.resolveOgImageOptions = resolveOgImageOptions;
 exports.resolveSearchOptions = resolveSearchOptions;
 exports.resolveSsgOptions = resolveSsgOptions;
-exports.resolveTheme = resolveTheme;
+exports.resolveTheme = require_vitepress.resolveTheme;
 exports.setRenderContext = setRenderContext;
 exports.shouldLintMarkdownFile = shouldLintMarkdownFile;
+exports.stripMarkdownExtension = stripMarkdownExtension;
 exports.transformAllPlugins = transformAllPlugins;
 exports.transformGitHub = require_github.transformGitHub;
 exports.transformIslands = transformIslands;