@ox-content/vite-plugin 2.6.0 → 2.7.0

package/dist/index.cjs

@@ -9372,6 +9372,7 @@ function resolveTheme(config) {
 		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 ?? ""
@@ -9381,6 +9382,7 @@ function resolveTheme(config) {
 * 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,
@@ -9426,16 +9428,30 @@ function themeToNapi(theme) {
 			message: theme.footer.message,
 			copyright: theme.footer.copyright
 		} : void 0,
-		socialLinks: theme.socialLinks.github || theme.socialLinks.twitter || theme.socialLinks.discord ? {
-			github: theme.socialLinks.github,
-			twitter: theme.socialLinks.twitter,
-			discord: theme.socialLinks.discord
-		} : 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
 /**
@@ -10791,7 +10807,8 @@ function resolveSsgOptions(ssg) {
 		extension: ".html",
 		clean: false,
 		bare: false,
-		generateOgImage: false
+		generateOgImage: false,
+		lastUpdated: false
 	};
 	if (ssg === true || ssg === void 0) return {
 		enabled: true,
@@ -10799,6 +10816,7 @@ function resolveSsgOptions(ssg) {
 		clean: false,
 		bare: false,
 		generateOgImage: false,
+		lastUpdated: false,
 		theme: resolveTheme(void 0)
 	};
 	return {
@@ -10809,6 +10827,7 @@ function resolveSsgOptions(ssg) {
 		siteName: ssg.siteName,
 		ogImage: ssg.ogImage,
 		generateOgImage: ssg.generateOgImage ?? false,
+		lastUpdated: ssg.lastUpdated ?? false,
 		siteUrl: ssg.siteUrl,
 		theme: resolveTheme(ssg.theme)
 	};
@@ -10862,13 +10881,17 @@ async function generateHtmlPage(pageData, navGroups, siteName, base, ogImage, th
 		text: entry.text,
 		slug: entry.slug
 	}));
+	const toRustNavItem = (item) => ({
+		title: item.title,
+		path: item.path,
+		href: item.href,
+		children: item.children?.map(toRustNavItem),
+		collapsed: item.collapsed
+	});
 	const navGroupsForRust = navGroups.map((group) => ({
 		title: group.title,
-		items: group.items.map((item) => ({
-			title: item.title,
-			path: item.path,
-			href: item.href
-		}))
+		collapsed: group.collapsed,
+		items: group.items.map(toRustNavItem)
 	}));
 	const themeForRust = theme ? themeToNapi(theme) : void 0;
 	const entryPageForRust = pageData.entryPage ? {
@@ -10907,6 +10930,7 @@ async function generateHtmlPage(pageData, navGroups, siteName, base, ogImage, th
 		description: pageData.description,
 		content: pageData.content,
 		toc: tocForRust,
+		lastUpdated: pageData.lastUpdated,
 		path: pageData.path,
 		entryPage: entryPageForRust
 	}, navGroupsForRust, {
@@ -11194,6 +11218,63 @@ function buildNavItems(markdownFiles, srcDir, base, extension) {
 	});
 	return result;
 }
+function isSafeSidebarLink(link) {
+	const trimmed = link.trim();
+	if (trimmed.startsWith("//")) return false;
+	return !/^[a-z][a-z0-9+.-]*:/i.test(trimmed) || /^(https?:|mailto:)/i.test(trimmed);
+}
+function sidebarPath(link) {
+	if (!link || !isSafeSidebarLink(link)) return "";
+	if (/^(https?:|mailto:|#)/i.test(link.trim())) return "";
+	const bare = link.trim().split("#", 1)[0].split("?", 1)[0].replace(/^\/+/, "").replace(/\/$/, "").replace(/\.(md|markdown)$/i, "");
+	if (!bare || bare === "index") return "/";
+	return bare.replace(/\/index$/, "");
+}
+function sidebarHref(link, base, extension) {
+	if (!link) return "#";
+	const trimmed = link.trim();
+	if (!isSafeSidebarLink(trimmed)) return "#";
+	if (/^(https?:|mailto:|#)/i.test(trimmed)) return trimmed;
+	const hash = trimmed.includes("#") ? `#${trimmed.split("#").slice(1).join("#")}` : "";
+	const withoutExt = trimmed.split("#", 1)[0].replace(/^\/+/, "").replace(/\/$/, "").replace(/\.(md|markdown)$/i, "");
+	return `${base}${!withoutExt || withoutExt === "index" ? "index" : `${withoutExt.replace(/\/index$/, "")}/index`}${extension}${hash}`;
+}
+/**
+* Builds navigation items from an explicit theme sidebar tree.
+*/
+function buildThemeNavItems(sidebar, base, extension) {
+	const toNavItem = (item) => {
+		const navItem = {
+			title: item.text ?? item.link ?? "Untitled",
+			path: sidebarPath(item.link),
+			href: sidebarHref(item.link, base, extension)
+		};
+		if (item.items?.length) navItem.children = item.items.map(toNavItem);
+		if (item.collapsed !== void 0) navItem.collapsed = item.collapsed;
+		return navItem;
+	};
+	const groups = [];
+	let looseItems = [];
+	const flushLooseItems = () => {
+		if (looseItems.length > 0) {
+			groups.push({
+				title: "Guide",
+				items: looseItems
+			});
+			looseItems = [];
+		}
+	};
+	for (const item of sidebar) if (item.items?.length && !item.link) {
+		flushLooseItems();
+		groups.push({
+			title: item.text ?? "Guide",
+			items: item.items.map(toNavItem),
+			collapsed: item.collapsed
+		});
+	} else looseItems.push(toNavItem(item));
+	flushLooseItems();
+	return groups;
+}
 /**
 * Builds all markdown files to static HTML.
 */
@@ -11216,7 +11297,7 @@ async function buildSsg(options, root) {
 		});
 	} catch {}
 	const markdownFiles = await collectMarkdownFiles$1(srcDir);
-	const navItems = buildNavItems(markdownFiles, srcDir, base, ssgOptions.extension);
+	const navItems = 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");
@@ -11228,6 +11309,7 @@ async function buildSsg(options, root) {
 	const ogImageUrlMap = /* @__PURE__ */ new Map();
 	const shouldGenerateOgImages = (options.ogImage || ssgOptions.generateOgImage) && !ssgOptions.bare;
 	const pageResults = [];
+	const napi = ssgOptions.lastUpdated ? await require_mermaid.importNapiModule() : void 0;
 	for (const inputPath of markdownFiles) try {
 		const result = await transformMarkdown(await fs_promises.readFile(inputPath, "utf-8"), inputPath, options, {
 			convertMdLinks: true,
@@ -11255,6 +11337,7 @@ async function buildSsg(options, root) {
 			transformedHtml,
 			title,
 			description,
+			lastUpdated: napi?.getGitLastUpdated(inputPath, root) ?? void 0,
 			frontmatter: result.frontmatter,
 			toc: result.toc
 		});
@@ -11300,7 +11383,7 @@ async function buildSsg(options, root) {
 		ogImageUrlMap.clear();
 	}
 	for (const pageResult of pageResults) try {
-		const { inputPath, transformedHtml, title, description, frontmatter, toc } = pageResult;
+		const { inputPath, transformedHtml, title, description, lastUpdated, frontmatter, toc } = pageResult;
 		let pageOgImage = ssgOptions.ogImage;
 		if (shouldGenerateOgImages && ogImageUrlMap.has(inputPath)) pageOgImage = ogImageUrlMap.get(inputPath);
 		let entryPage;
@@ -11315,6 +11398,7 @@ async function buildSsg(options, root) {
 			description,
 			content: transformedHtml,
 			toc,
+			lastUpdated,
 			frontmatter,
 			path: getUrlPath$1(inputPath, srcDir),
 			href: getHref(inputPath, srcDir, base, ssgOptions.extension),
@@ -13223,6 +13307,7 @@ function renderPage(page, options) {
 			description: page.description,
 			html: page.html,
 			toc: page.toc,
+			lastUpdated: page.lastUpdated,
 			path: page.path,
 			url: page.url,
 			frontmatter: page.frontmatter,
@@ -13237,6 +13322,7 @@ function renderPage(page, options) {
 				description: p.description,
 				html: p.html,
 				toc: p.toc,
+				lastUpdated: p.lastUpdated,
 				path: p.path,
 				url: p.url,
 				frontmatter: p.frontmatter,