@ox-content/vite-plugin 2.9.0 → 2.10.0

package/dist/index.mjs

@@ -3,6 +3,7 @@ import { i as transformTabs, n as resetTabGroupCounter, t as generateTabsCSS } f
 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 { 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";
@@ -8798,213 +8799,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 +10175,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 +10307,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;
@@ -10572,7 +10420,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$1.join(root, "package.json");
@@ -10591,6 +10439,7 @@ 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;
@@ -10605,8 +10454,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,
@@ -10615,11 +10464,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,
@@ -10946,6 +10795,7 @@ 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;
@@ -10959,19 +10809,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
@@ -11002,7 +10852,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");
@@ -11097,7 +10950,7 @@ async function collectPages(options, root) {
 	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 : "";
@@ -12725,6 +12578,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, DefaultTheme, Fragment, buildSearchIndex, buildSsg, clearRenderContext, collectGitHubRepos, collectOgpUrls, convertVitePressNav, convertVitePressSidebar, createI18nPlugin, createMarkdownEnvironment, createTheme, defaultTheme, defineTheme, each, extractDocs, extractIslandInfo, extractVideoId, fetchOgpData, fetchRepoData, fromVitePressConfig, generateFrontmatterTypes, generateHydrationScript, generateMarkdown, generateOgImages, generateTabsCSS, generateTypes, generateVirtualModule, generateVitePressMigrationConfig, hasIslands, inferType, jsx, jsxs, lintMarkdown, lintMarkdownAsync, lintMarkdownFile, lintMarkdownFiles, mergeThemes, mermaidClientScript, normalizeVitePressFrontmatter, 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 };
 
 //# sourceMappingURL=index.mjs.map