@ox-content/vite-plugin 2.6.0 → 2.8.0

package/dist/index.mjs

@@ -1,8 +1,8 @@
 import { n as transformMermaidStatic, r as importNapiModule, t as mermaidClientScript } from "./mermaid.mjs";
 import { n as resetTabGroupCounter, r as transformTabs, t as generateTabsCSS } from "./tabs2.mjs";
 import { n as transformYouTube, t as extractVideoId } from "./youtube2.mjs";
-import { i as transformGitHub, n as fetchRepoData, r as prefetchGitHubRepos, t as collectGitHubRepos } from "./github2.mjs";
-import { i as transformOgp, n as fetchOgpData, r as prefetchOgpData, t as collectOgpUrls } from "./ogp2.mjs";
+import { a as transformGitHub, i as prefetchGitHubRepos, n as fetchRepoData, t as collectGitHubRepos } from "./github2.mjs";
+import { a as transformOgp, i as prefetchOgpData, n as fetchOgpData, t as collectOgpUrls } from "./ogp2.mjs";
 import { createRequire } from "node:module";
 import * as path$2 from "path";
 import path from "path";
@@ -9397,6 +9397,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 ?? ""
@@ -9406,6 +9407,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,
@@ -9451,16 +9453,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
 /**
@@ -10816,7 +10832,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,
@@ -10824,6 +10841,7 @@ function resolveSsgOptions(ssg) {
 		clean: false,
 		bare: false,
 		generateOgImage: false,
+		lastUpdated: false,
 		theme: resolveTheme(void 0)
 	};
 	return {
@@ -10834,6 +10852,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)
 	};
@@ -10880,20 +10899,24 @@ function generateBareHtmlPage(content, title) {
 /**
 * Generates HTML page with navigation using Rust NAPI bindings.
 */
-async function generateHtmlPage(pageData, navGroups, siteName, base, ogImage, theme) {
+async function generateHtmlPage(pageData, navGroups, siteName, base, ogImage, theme, locale, availableLocales) {
 	const mod = await importNapiModule();
 	const tocForRust = pageData.toc.map((entry) => ({
 		depth: entry.depth,
 		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 ? {
@@ -10932,13 +10955,20 @@ 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, {
 		siteName,
 		base,
 		ogImage,
-		theme: themeForRust
+		theme: themeForRust,
+		locale,
+		availableLocales: availableLocales?.map((l) => ({
+			code: l.code,
+			name: l.name,
+			dir: l.dir ?? "ltr"
+		}))
 	});
 }
 const SSG_STYLE_BLOCK_RE = /[ \t]*<!-- ox-content:styles:start -->\s*<style>([\s\S]*?)<\/style>\s*<!-- ox-content:styles:end -->/;
@@ -11113,6 +11143,11 @@ function getHref(inputPath, srcDir, base, extension) {
 	if (urlPath === "/" || urlPath === "") return `${base}index${extension}`;
 	return `${base}${urlPath}/index${extension}`;
 }
+function getPageLocale(urlPath, i18n) {
+	if (!i18n) return void 0;
+	const firstSegment = urlPath.split("/").filter(Boolean)[0];
+	return i18n.locales.some((l) => l.code === firstSegment) ? firstSegment : i18n.defaultLocale;
+}
 /**
 * Gets the OG image output path for a given markdown file.
 */
@@ -11219,6 +11254,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.
 */
@@ -11241,7 +11333,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$2.join(root, "package.json");
@@ -11253,6 +11345,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 importNapiModule() : void 0;
 	for (const inputPath of markdownFiles) try {
 		const result = await transformMarkdown(await fs$1.readFile(inputPath, "utf-8"), inputPath, options, {
 			convertMdLinks: true,
@@ -11280,6 +11373,7 @@ async function buildSsg(options, root) {
 			transformedHtml,
 			title,
 			description,
+			lastUpdated: napi?.getGitLastUpdated(inputPath, root) ?? void 0,
 			frontmatter: result.frontmatter,
 			toc: result.toc
 		});
@@ -11325,7 +11419,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;
@@ -11335,16 +11429,20 @@ async function buildSsg(options, root) {
 		};
 		let html;
 		if (ssgOptions.bare) html = generateBareHtmlPage(transformedHtml, title);
-		else html = await generateHtmlPage({
-			title,
-			description,
-			content: transformedHtml,
-			toc,
-			frontmatter,
-			path: getUrlPath$1(inputPath, srcDir),
-			href: getHref(inputPath, srcDir, base, ssgOptions.extension),
-			entryPage
-		}, navItems, siteName, base, pageOgImage, ssgOptions.theme);
+		else {
+			const pageData = {
+				title,
+				description,
+				content: transformedHtml,
+				toc,
+				lastUpdated,
+				frontmatter,
+				path: getUrlPath$1(inputPath, srcDir),
+				href: getHref(inputPath, srcDir, base, ssgOptions.extension),
+				entryPage
+			};
+			html = await generateHtmlPage(pageData, navItems, siteName, base, pageOgImage, ssgOptions.theme, getPageLocale(pageData.path, options.i18n), options.i18n ? options.i18n.locales : void 0);
+		}
 		const outputPath = getOutputPath(inputPath, srcDir, outDir, ssgOptions.extension);
 		generatedPages.push({
 			inputPath,
@@ -12344,7 +12442,7 @@ function createI18nPlugin(resolvedOptions) {
 			}
 			server.middlewares.use((req, _res, next) => {
 				if (!req.url) return next();
-				const localeMatch = req.url.match(/^\/([a-z]{2}(?:-[a-zA-Z]+)?)(\/|$)/);
+				const localeMatch = req.url.match(/^\/([A-Za-z]{2,3}(?:-[A-Za-z0-9]+)*)(\/|$)/);
 				if (localeMatch) {
 					const localeCode = localeMatch[1];
 					if (i18nOptions.locales.some((l) => l.code === localeCode)) req.__oxLocale = localeCode;
@@ -12392,14 +12490,14 @@ export function t(key, params, locale) {
   }
   if (params) {
     for (const [k, v] of Object.entries(params)) {
-      message = message.replace(new RegExp('\\\\{\\\\$' + k + '\\\\}', 'g'), String(v));
+      message = message.split('{$' + k + '}').join(String(v));
     }
   }
   return message;
 }
 
 export function getLocaleFromPath(pathname) {
-  const match = pathname.match(/^\\/([a-z]{2}(?:-[a-zA-Z]+)?)(\\//|$)/);
+  const match = pathname.match(new RegExp('^/([A-Za-z]{2,3}(?:-[A-Za-z0-9]+)*)(/|$)'));
   if (match) {
     const code = match[1];
     if (i18nConfig.locales.some(l => l.code === code)) {
@@ -12413,7 +12511,9 @@ export function localePath(pathname, locale) {
   const current = getLocaleFromPath(pathname);
   let clean = pathname;
   if (current !== i18nConfig.defaultLocale || !i18nConfig.hideDefaultLocale) {
-    clean = pathname.replace(new RegExp('^/' + current + '(/|$)'), '/');
+    const prefix = '/' + current;
+    if (clean === prefix) clean = '/';
+    else if (clean.startsWith(prefix + '/')) clean = clean.slice(prefix.length);
   }
   if (locale === i18nConfig.defaultLocale && i18nConfig.hideDefaultLocale) {
     return clean || '/';
@@ -12421,8 +12521,95 @@ export function localePath(pathname, locale) {
   return '/' + locale + (clean.startsWith('/') ? clean : '/' + clean);
 }
 
-export default { i18nConfig, dictionaries, t, getLocaleFromPath, localePath };
-`;
+const formatterCache = new Map();
+
+function getFormatter(kind, locale, options) {
+  const key = kind + ':' + locale + ':' + JSON.stringify(options || {});
+  if (!formatterCache.has(key)) {
+    formatterCache.set(key, new Intl[kind](locale, options));
+  }
+  return formatterCache.get(key);
+}
+
+export function getLocaleMeta(locale) {
+  const code = locale || i18nConfig.defaultLocale;
+  return i18nConfig.locales.find(l => l.code === code) || { code, name: code, dir: 'ltr' };
+}
+
+export function formatDate(value, options, locale) {
+  return getFormatter('DateTimeFormat', locale || i18nConfig.defaultLocale, options).format(
+    value instanceof Date ? value : new Date(value),
+  );
+}
+
+export function formatDateParts(value, options, locale) {
+  return getFormatter('DateTimeFormat', locale || i18nConfig.defaultLocale, options).formatToParts(
+    value instanceof Date ? value : new Date(value),
+  );
+}
+
+export function formatNumber(value, options, locale) {
+  return getFormatter('NumberFormat', locale || i18nConfig.defaultLocale, options).format(value);
+}
+
+export function formatNumberParts(value, options, locale) {
+  return getFormatter('NumberFormat', locale || i18nConfig.defaultLocale, options).formatToParts(value);
+}
+
+export function formatRelativeTime(value, unit, options, locale) {
+  return getFormatter('RelativeTimeFormat', locale || i18nConfig.defaultLocale, options).format(value, unit);
+}
+
+export function formatList(values, options, locale) {
+  return getFormatter('ListFormat', locale || i18nConfig.defaultLocale, options).format(values);
+}
+
+export function formatListParts(values, options, locale) {
+  return getFormatter('ListFormat', locale || i18nConfig.defaultLocale, options).formatToParts(values);
+}
+
+export function formatDisplayName(value, type, options, locale) {
+  if (!Intl.DisplayNames) return String(value);
+  const displayType = type || 'language';
+  return getFormatter('DisplayNames', locale || i18nConfig.defaultLocale, { type: displayType, ...options }).of(value) || String(value);
+}
+
+export function createIntl(locale, defaults = {}) {
+  const meta = getLocaleMeta(locale);
+  const code = meta.code;
+  return {
+    locale: code,
+    meta,
+    dir: meta.dir || 'ltr',
+    date: (value, options) => formatDate(value, { ...defaults.date, ...options }, code),
+    dateParts: (value, options) => formatDateParts(value, { ...defaults.date, ...options }, code),
+    number: (value, options) => formatNumber(value, { ...defaults.number, ...options }, code),
+    numberParts: (value, options) => formatNumberParts(value, { ...defaults.number, ...options }, code),
+    relativeTime: (value, unit, options) => formatRelativeTime(value, unit, { ...defaults.relativeTime, ...options }, code),
+    list: (values, options) => formatList(values, { ...defaults.list, ...options }, code),
+    listParts: (values, options) => formatListParts(values, { ...defaults.list, ...options }, code),
+    displayName: (value, type, options) => formatDisplayName(value, type, { ...defaults.displayName, ...options }, code),
+  };
+}
+
+export default {
+  i18nConfig,
+  dictionaries,
+  t,
+  getLocaleFromPath,
+  localePath,
+  getLocaleMeta,
+  createIntl,
+  formatDate,
+  formatDateParts,
+  formatNumber,
+  formatNumberParts,
+  formatRelativeTime,
+  formatList,
+  formatListParts,
+  formatDisplayName,
+};
+  `;
 }
 /**
 * Flattens a nested object into dot-separated keys.
@@ -13248,6 +13435,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,
@@ -13262,6 +13450,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,
@@ -13652,19 +13841,53 @@ function resolveCodeAnnotationsOptions(options) {
 */
 function generateVirtualModule(path, options) {
 	if (path === "config") return `export default ${JSON.stringify(options)};`;
-	if (path === "runtime") return `
+	if (path === "runtime") {
+		const base = normalizeRuntimeBase(options.base);
+		return `
+      export const base = ${JSON.stringify(base)};
+      export const runtimeConfig = { base };
+
+      export function isExternalUrl(value) {
+        return /^(?:https?:)?\\/\\//i.test(value) || /^(?:mailto|tel):/i.test(value);
+      }
+
+      export function withBase(pathname = "") {
+        const value = String(pathname);
+        if (!value || value === "/") return base;
+        if (value.startsWith("#") || isExternalUrl(value)) return value;
+        return base + (value.startsWith("/") ? value.slice(1) : value);
+      }
+
+      export function withoutBase(pathname = "") {
+        const value = String(pathname);
+        if (base === "/" || value.startsWith("#") || isExternalUrl(value)) return value;
+        const bareBase = base.slice(0, -1);
+        if (value === bareBase) return "/";
+        if (value.startsWith(base)) return "/" + value.slice(base.length);
+        return value;
+      }
+
       export function useMarkdown() {
         return {
+          base,
+          withBase,
+          withoutBase,
           render: (content) => {
-            // Client-side rendering if needed
             return content;
           },
         };
       }
     `;
+	}
 	return "export default {};";
 }
+function normalizeRuntimeBase(base) {
+	const trimmed = base.trim();
+	if (!trimmed || trimmed === "/") return "/";
+	const withLeading = trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+	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, 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, 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 };
 
 //# sourceMappingURL=index.mjs.map