@ox-content/vite-plugin 2.9.0 → 2.11.0

package/dist/index.mjs

@@ -1,8 +1,9 @@
 import { a as importNapiModuleSync, c as __exportAll, d as __toESM, i as importNapiModule, l as __require, o as __commonJSMin, r as transformMermaidStatic, s as __esmMin, t as mermaidClientScript, u as __toCommonJS } from "./mermaid.mjs";
 import { i as transformTabs, n as resetTabGroupCounter, t as generateTabsCSS } from "./tabs.mjs";
 import { n as transformYouTube, t as extractVideoId } from "./youtube.mjs";
-import { a as transformGitHub, i as prefetchGitHubRepos, n as fetchRepoData, t as collectGitHubRepos } from "./github.mjs";
+import { c as prefetchGitHubRepos, i as fetchRepoData, l as prefetchGitHubSources, n as collectGitHubSources, o as parseGitHubLineRange, r as fetchGitHubSource, s as parseGitHubPermalink, t as collectGitHubRepos, u as transformGitHub } from "./github.mjs";
 import { a as transformOgp, i as prefetchOgpData, n as fetchOgpData, t as collectOgpUrls } from "./ogp.mjs";
+import { a as normalizeVitePressFrontmatter, c as mergeThemes, i as generateVitePressMigrationConfig, l as resolveTheme, n as convertVitePressSidebar, o as defaultTheme, r as fromVitePressConfig, s as defineTheme, t as convertVitePressNav, u as themeToNapi } from "./vitepress.mjs";
 import { createRequire } from "node:module";
 import * as path$1 from "path";
 import { unified } from "unified";
@@ -17,6 +18,40 @@ import { glob } from "glob";
 import * as crypto from "crypto";
 import * as fs from "node:fs/promises";
 import { mkdir, writeFile } from "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$1.join(srcDir, `**/*.${suffixes[0]}`);
+	return path$1.join(srcDir, `**/*.{${suffixes.join(",")}}`);
+}
+//#endregion
 //#region src/environment.ts
 /**
 * Creates the Markdown processing environment configuration.
@@ -49,7 +84,7 @@ function createMarkdownEnvironment(options) {
 			rollupOptions: { external: [/^node:/, /\.node$/] }
 		},
 		resolve: {
-			extensions: [".md", ".markdown"],
+			extensions: options.extensions,
 			conditions: [
 				"markdown",
 				"node",
@@ -6797,6 +6832,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 import("./tabs.mjs").then((n) => n.r);
+		result = await transformTabs(result);
+	}
+	if (youtube) {
+		const { transformYouTube } = await import("./youtube.mjs").then((n) => n.r);
+		result = await transformYouTube(result);
+	}
+	if (github !== false) {
+		const { transformGitHub } = await import("./github.mjs").then((n) => n.a);
+		result = await transformGitHub(result, void 0, {
+			token: githubToken,
+			...typeof github === "object" ? github : {}
+		});
+	}
+	if (ogpOptions !== false) {
+		const { transformOgp } = await import("./ogp.mjs").then((n) => n.r);
+		result = await transformOgp(result, void 0, typeof ogpOptions === "object" ? ogpOptions : {});
+	}
+	if (mermaid) {
+		const { transformMermaidStatic } = await import("./mermaid.mjs").then((n) => n.n);
+		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 import("./github.mjs").then((n) => n.a);
+		result = await transformGitHub(result, void 0, {
+			token: process.env.GITHUB_TOKEN,
+			...options.github
+		});
+	}
+	if (options.openGraph) {
+		const { transformOgp } = await import("./ogp.mjs").then((n) => n.r);
+		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
@@ -6978,6 +7065,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),
@@ -8577,36 +8668,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 import("./tabs.mjs").then((n) => n.r);
-		result = await transformTabs(result);
-	}
-	if (youtube) {
-		const { transformYouTube } = await import("./youtube.mjs").then((n) => n.r);
-		result = await transformYouTube(result);
-	}
-	if (github) {
-		const { transformGitHub } = await import("./github.mjs").then((n) => n.r);
-		result = await transformGitHub(result, void 0, { token: githubToken });
-	}
-	if (ogp) {
-		const { transformOgp } = await import("./ogp.mjs").then((n) => n.r);
-		result = await transformOgp(result);
-	}
-	if (mermaid) {
-		const { transformMermaidStatic } = await import("./mermaid.mjs").then((n) => n.n);
-		result = await transformMermaidStatic(result);
-	}
-	return result;
-}
-//#endregion
 //#region src/island/parse.ts
 /**
 * Island Parser
@@ -8798,213 +8859,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
@@ -10381,7 +10235,8 @@ function resolveSsgOptions(ssg) {
 		generateOgImage: ssg.generateOgImage ?? false,
 		lastUpdated: ssg.lastUpdated ?? false,
 		siteUrl: ssg.siteUrl,
-		theme: resolveTheme(ssg.theme)
+		theme: resolveTheme(ssg.theme),
+		navigation: ssg.navigation
 	};
 }
 /**
@@ -10512,6 +10367,59 @@ async function externalizeSharedPageAssets(pages, outDir, base) {
 function getUrlPath$1(inputPath, srcDir) {
 	return 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 } = normalizeNavigationPath(item.path ?? rawHref);
+			const href = item.href ? (() => {
+				const normalized = normalizeNavigationPath(item.href);
+				return `${buildHrefFromNavigationPath(normalized.path, base, extension)}${normalized.suffix}`;
+			})() : buildHrefFromNavigationPath(path, base, extension);
+			return [{
+				title: item.title,
+				path,
+				href
+			}];
+		})
+	}));
+}
 function getPageLocale(urlPath, i18n) {
 	if (!i18n) return void 0;
 	return importNapiModuleSync().getSsgPageLocale(urlPath, i18n.defaultLocale, i18n.locales.map((locale) => locale.code)) ?? void 0;
@@ -10528,8 +10436,8 @@ function formatTitle(name) {
 /**
 * Collects all markdown files from the source directory.
 */
-async function collectMarkdownFiles$1(srcDir) {
-	return (await glob(path$1.join(srcDir, "**/*.{md,markdown}"), {
+async function collectMarkdownFiles$1(srcDir, extensions = DEFAULT_MARKDOWN_EXTENSIONS) {
+	return (await glob(markdownGlobPattern(srcDir, extensions), {
 		nodir: true,
 		ignore: [
 			"**/node_modules/**",
@@ -10571,8 +10479,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$1.join(root, "package.json");
@@ -10591,22 +10499,23 @@ async function buildSsg(options, root) {
 			baseUrl: base,
 			sourcePath: inputPath
 		});
+		const frontmatter = 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,
@@ -10615,11 +10524,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,
@@ -10744,7 +10653,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 {
@@ -10752,7 +10661,7 @@ async function collectMarkdownFiles(dir) {
 			for (const entry of entries) {
 				const fullPath = path$1.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 {}
 	}
@@ -10762,7 +10671,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: [],
@@ -10771,13 +10680,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$1.readFile(file, "utf-8");
-		const relativePath = path$1.relative(srcDir, file);
-		const url = base + relativePath.replace(/\.md$/, "").replace(/\\/g, "/");
-		const id = relativePath.replace(/\.md$/, "").replace(/\\/g, "/");
+		const id = stripMarkdownExtension(path$1.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");
@@ -10872,26 +10780,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$1.join(srcDir, relativePath);
-	try {
-		await fs$1.access(filePath);
-		return filePath;
-	} catch {
-		const indexPath = path$1.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$1.join(srcDir, relativePath);
+		try {
+			await fs$1.access(filePath);
+			return filePath;
+		} catch {}
+	}
+	for (const extension of extensions) {
+		const indexPath = path$1.join(srcDir, routePath, `index${extension}`);
 		try {
 			await fs$1.access(indexPath);
 			return indexPath;
-		} catch {
-			return null;
-		}
+		} catch {}
 	}
+	return null;
 }
 /**
 * Inject Vite HMR client script into the HTML.
@@ -10946,32 +10855,33 @@ async function renderPage$1(filePath, options, navGroups, siteName, base, root)
 		baseUrl: base,
 		sourcePath: filePath
 	});
+	const frontmatter = 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
@@ -10991,7 +10901,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);
@@ -11002,7 +10912,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");
@@ -11047,9 +10960,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$1.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;
@@ -11089,21 +11002,18 @@ function validatePage(page, options) {
 }
 async function collectPages(options, root) {
 	const srcDir = path$1.resolve(root, options.srcDir);
-	const files = await glob("**/*.md", {
-		cwd: srcDir,
-		absolute: true
-	});
+	const files = await 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$2.readFileSync(file, "utf-8");
-		const frontmatter = parseFrontmatter(content);
+		const frontmatter = 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$1.relative(srcDir, file),
@@ -11752,7 +11662,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/**",
@@ -12459,13 +12373,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) {
@@ -12473,14 +12387,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",
@@ -12533,7 +12447,7 @@ function oxContent(options = {}) {
 			const srcDir = path$1.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",
@@ -12546,7 +12460,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",
@@ -12559,7 +12473,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() {
@@ -12599,7 +12513,7 @@ function oxContent(options = {}) {
 				const root = config?.root || process.cwd();
 				const srcDir = path$1.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);
@@ -12630,6 +12544,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,
@@ -12650,9 +12565,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,
@@ -12725,6 +12656,6 @@ function normalizeRuntimeBase(base) {
 	return withLeading.endsWith("/") ? withLeading : `${withLeading}/`;
 }
 //#endregion
-export { DEFAULT_HTML_TEMPLATE, DefaultTheme, Fragment, buildSearchIndex, buildSsg, clearRenderContext, collectGitHubRepos, collectOgpUrls, createI18nPlugin, createMarkdownEnvironment, createTheme, defaultTheme, defineTheme, each, extractDocs, extractIslandInfo, extractVideoId, fetchOgpData, fetchRepoData, generateFrontmatterTypes, generateHydrationScript, generateMarkdown, generateOgImages, generateTabsCSS, generateTypes, generateVirtualModule, hasIslands, inferType, jsx, jsxs, lintMarkdown, lintMarkdownAsync, lintMarkdownFile, lintMarkdownFiles, mergeThemes, mermaidClientScript, oxContent, prefetchGitHubRepos, prefetchOgpData, raw, renderAllPages, renderPage, renderToString, resolveDocsOptions, resolveI18nOptions, resolveOgImageOptions, resolveSearchOptions, resolveSsgOptions, resolveTheme, setRenderContext, shouldLintMarkdownFile, transformAllPlugins, transformGitHub, transformIslands, transformMarkdown, transformMermaidStatic, transformOgp, transformTabs, transformYouTube, useIsActive, useNav, usePageProps, useRenderContext, useSiteConfig, when, writeDocs, writeSearchIndex };
+export { DEFAULT_HTML_TEMPLATE, DEFAULT_MARKDOWN_EXTENSIONS, DefaultTheme, Fragment, buildSearchIndex, buildSsg, clearRenderContext, collectGitHubRepos, collectGitHubSources, collectOgpUrls, convertVitePressNav, convertVitePressSidebar, createI18nPlugin, createMarkdownEnvironment, createTheme, defaultTheme, defineTheme, each, extractDocs, extractIslandInfo, extractVideoId, fetchGitHubSource, fetchOgpData, fetchRepoData, fromVitePressConfig, generateFrontmatterTypes, generateHydrationScript, generateMarkdown, generateOgImages, generateTabsCSS, generateTypes, generateVirtualModule, generateVitePressMigrationConfig, hasIslands, inferType, isMarkdownFilePath, jsx, jsxs, lintMarkdown, lintMarkdownAsync, lintMarkdownFile, lintMarkdownFiles, mergeThemes, mermaidClientScript, normalizeMarkdownExtensions, normalizeVitePressFrontmatter, oxContent, parseGitHubLineRange, parseGitHubPermalink, prefetchGitHubRepos, prefetchGitHubSources, prefetchOgpData, raw, renderAllPages, renderPage, renderToString, resolveBuiltinEmbedOptions, resolveDocsOptions, resolveI18nOptions, resolveOgImageOptions, resolveSearchOptions, resolveSsgOptions, resolveTheme, setRenderContext, shouldLintMarkdownFile, stripMarkdownExtension, transformAllPlugins, transformGitHub, transformIslands, transformMarkdown, transformMermaidStatic, transformOgp, transformTabs, transformYouTube, useIsActive, useNav, usePageProps, useRenderContext, useSiteConfig, when, writeDocs, writeSearchIndex };
 
 //# sourceMappingURL=index.mjs.map