@ox-content/vite-plugin 2.9.0 → 2.10.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");
@@ -8809,213 +8810,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 +10174,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 +10186,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 +10248,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 +10318,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;
@@ -10583,7 +10431,7 @@ async function buildSsg(options, root) {
 		});
 	} 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 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,6 +10450,7 @@ 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;
@@ -10616,8 +10465,8 @@ async function buildSsg(options, root) {
 		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 +10475,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,
@@ -10957,6 +10806,7 @@ 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;
@@ -10970,19 +10820,19 @@ async function renderPage$1(filePath, options, navGroups, siteName, base, root)
 	});
 	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
@@ -11013,7 +10863,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);
+				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");
@@ -11108,7 +10961,7 @@ async function collectPages(options, root) {
 	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 : "";
@@ -12744,17 +12597,20 @@ exports.buildSsg = buildSsg;
 exports.clearRenderContext = clearRenderContext;
 exports.collectGitHubRepos = require_github.collectGitHubRepos;
 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.fetchOgpData = require_ogp.fetchOgpData;
 exports.fetchRepoData = require_github.fetchRepoData;
+exports.fromVitePressConfig = require_vitepress.fromVitePressConfig;
 exports.generateFrontmatterTypes = generateFrontmatterTypes;
 exports.generateHydrationScript = generateHydrationScript;
 exports.generateMarkdown = generateMarkdown;
@@ -12762,6 +12618,7 @@ 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.jsx = jsx;
@@ -12770,8 +12627,9 @@ 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.normalizeVitePressFrontmatter = require_vitepress.normalizeVitePressFrontmatter;
 exports.oxContent = oxContent;
 exports.prefetchGitHubRepos = require_github.prefetchGitHubRepos;
 exports.prefetchOgpData = require_ogp.prefetchOgpData;
@@ -12784,7 +12642,7 @@ 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.transformAllPlugins = transformAllPlugins;