@clarify-labs/cli 0.2.0 → 0.5.0

package/output/{plugin-CEyCiD5r.cjs → plugin-DnD0L83F.cjs}

@@ -31,11 +31,10 @@ _vitejs_plugin_react = __toESM(_vitejs_plugin_react, 1);
 let github_slugger = require("github-slugger");
 github_slugger = __toESM(github_slugger, 1);
 let mdast_util_to_string = require("mdast-util-to-string");
-let remark_gfm = require("remark-gfm");
-remark_gfm = __toESM(remark_gfm, 1);
 let shiki = require("shiki");
 shiki = __toESM(shiki, 1);
 let unist_util_visit = require("unist-util-visit");
+let _clarify_labs_renderer = require("@clarify-labs/renderer");
 let remark = require("remark");
 let gray_matter = require("gray-matter");
 gray_matter = __toESM(gray_matter, 1);
@@ -123,7 +122,7 @@ function rehypeSlugSections() {
 		});
 	};
 }
-var remarkPlugins = [remark_gfm.default];
+var remarkPlugins = _clarify_labs_renderer.markdownRemarkPlugins;
 var rehypePlugins = [
 	rehypeSlugSections,
 	rehypeParseCodeBlocks,
@@ -132,11 +131,14 @@ var rehypePlugins = [
 //#endregion
 //#region source/parsers/frontmatter.ts
 /**
-* 从 MDX 文件内容中提取 frontmatter。
-* 使用 gray-matter 支持 YAML frontmatter 的标准语法和类型解析。
+* 在内容入口统一解析 MDX frontmatter，并返回可供后续流程复用的标准化正文。
 */
-function extractFrontmatter(content) {
-	return (0, gray_matter.default)(content).data;
+function parseFrontmatter(content) {
+	const parsed = (0, gray_matter.default)(content);
+	return {
+		frontmatter: parsed.data,
+		content: parsed.content.replace(/^\r?\n/, "")
+	};
 }
 //#endregion
 //#region source/parsers/routes.ts
@@ -213,8 +215,7 @@ function findContentRoutes(dir, base = dir) {
 			const relativePath = (0, node_path.relative)(base, fullPath);
 			const pathParts = relativePath.replace(/\.mdx?$/, "").split("/");
 			const cleanPath = ("/" + pathParts.map((p) => p === "index" ? "" : p).filter(Boolean).join("/")).replace(/\/+/g, "/").replace(/\/$/, "") || "/";
-			const content = (0, node_fs.readFileSync)(fullPath, "utf-8");
-			const frontmatter = extractFrontmatter(content);
+			const { frontmatter, content } = parseFrontmatter((0, node_fs.readFileSync)(fullPath, "utf-8"));
 			let title = typeof frontmatter.title === "string" ? frontmatter.title : "";
 			if (!title) {
 				const lastPart = pathParts[pathParts.length - 1] ?? "";
@@ -226,13 +227,22 @@ function findContentRoutes(dir, base = dir) {
 				filePath: fullPath,
 				virtualModuleId: "virtual:clarify-page/" + relativePath.replace(/\.mdx?$/, "").replace(/\/+/g, "/"),
 				title,
+				description: typeof frontmatter.description === "string" ? frontmatter.description : void 0,
+				keywords: frontmatterKeywords(frontmatter),
 				kind: "mdx",
+				frontmatter,
+				content,
 				sections: extractMdxSections(content)
 			});
 		}
 	}
 	return routes;
 }
+function frontmatterKeywords(frontmatter) {
+	const value = frontmatter.keywords ?? frontmatter.keyword ?? frontmatter.tags;
+	const keywords = Array.isArray(value) ? value.filter((item) => typeof item === "string") : typeof value === "string" ? value.split(",").map((keyword) => keyword.trim()).filter(Boolean) : [];
+	return keywords.length > 0 ? keywords : void 0;
+}
 function buildNavigation(routes) {
 	const root = [];
 	for (const route of routes) {
@@ -273,6 +283,30 @@ function resolvePageItem(item) {
 		icon: item.icon
 	};
 }
+function firstNavigationPath(nodes) {
+	for (const node of nodes) {
+		if (node.path) return node.path;
+		const childPath = node.children ? firstNavigationPath(node.children) : void 0;
+		if (childPath) return childPath;
+	}
+	return "/";
+}
+function buildNavigationFromPagesConfig(routes, config) {
+	if (!config || config === "FileTree") return buildNavigation(routes);
+	return buildNavigationFromConfig(routes, config);
+}
+function buildNavigationFromTabsConfig(routes, tabs) {
+	return { tabs: tabs.map((tab) => {
+		const children = buildNavigationFromPagesConfig(routes, tab.pages);
+		return {
+			type: "tab",
+			path: firstNavigationPath(children),
+			title: resolveLocalizedText(tab.tab, "", "") ?? "",
+			icon: tab.icon,
+			children
+		};
+	}) };
+}
 function buildNavigationFromConfig(routes, config) {
 	const routeMap = new Map(routes.map((r) => [r.path, r]));
 	return config.map((group) => {
@@ -313,69 +347,94 @@ function localizeNavigationPaths(nodes, locale, i18n) {
 		children: node.children ? localizeNavigationPaths(node.children, locale, i18n) : void 0
 	}));
 }
-function buildLocalizedNavigation(routes, config, i18n) {
+function buildLocalizedNavigationForLocale(routes, config, locale, i18n) {
+	if (!config || config === "FileTree") return localizeNavigationPaths(buildNavigation(routes.map((route) => ({
+		...route,
+		path: route.basePath ?? route.path
+	}))), locale, i18n);
+	const routeMap = new Map(routes.map((route) => [route.basePath ?? route.path, route]));
+	return config.map((group) => {
+		const children = group.pages.map((item) => {
+			const { pageRef, openapiRef, redirect, title, icon } = resolvePageItem(item);
+			const ref = openapiRef ?? pageRef ?? "";
+			const basePath = basePathFromRef(ref);
+			const route = routeMap.get(basePath);
+			const path = route?.path ?? localizedRoutePath(basePath, locale, i18n);
+			return {
+				path: (redirect ? localizedRoutePath(basePathFromRef(redirect), locale, i18n) : void 0) ?? path,
+				title: resolveLocalizedText(title, locale, i18n.defaultLocale) ?? route?.title ?? kebabToTitle$1(basePath.split("/").pop() ?? ref),
+				icon,
+				sections: route?.sections ? navigationSections(route.sections) : void 0
+			};
+		});
+		return {
+			path: children[0]?.path ?? localizedRoutePath("/", locale, i18n),
+			title: resolveLocalizedText(group.group, locale, i18n.defaultLocale) ?? "",
+			icon: group.icon,
+			children
+		};
+	});
+}
+function buildLocalizedNavigationFromTabsConfig(routes, tabs, i18n) {
 	if (!i18n) return void 0;
 	const result = {};
 	for (const locale of i18n.locales) {
 		const localeRoutes = routes.filter((route) => route.locale === locale.code);
-		if (!config || config === "FileTree") {
-			const baseNavigation = buildNavigation(localeRoutes.map((route) => ({
-				...route,
-				path: route.basePath ?? route.path
-			})));
-			result[locale.code] = localizeNavigationPaths(baseNavigation, locale.code, i18n);
-			continue;
-		}
-		const routeMap = new Map(localeRoutes.map((route) => [route.basePath ?? route.path, route]));
-		result[locale.code] = config.map((group) => {
-			const children = group.pages.map((item) => {
-				const { pageRef, openapiRef, redirect, title, icon } = resolvePageItem(item);
-				const ref = openapiRef ?? pageRef ?? "";
-				const basePath = basePathFromRef(ref);
-				const route = routeMap.get(basePath);
-				const path = route?.path ?? localizedRoutePath(basePath, locale.code, i18n);
-				return {
-					path: (redirect ? localizedRoutePath(basePathFromRef(redirect), locale.code, i18n) : void 0) ?? path,
-					title: resolveLocalizedText(title, locale.code, i18n.defaultLocale) ?? route?.title ?? kebabToTitle$1(basePath.split("/").pop() ?? ref),
-					icon,
-					sections: route?.sections ? navigationSections(route.sections) : void 0
-				};
-			});
+		result[locale.code] = { tabs: tabs.map((tab) => {
+			const children = buildLocalizedNavigationForLocale(localeRoutes, tab.pages, locale.code, i18n);
 			return {
-				path: children[0]?.path ?? localizedRoutePath("/", locale.code, i18n),
-				title: resolveLocalizedText(group.group, locale.code, i18n.defaultLocale) ?? "",
-				icon: group.icon,
+				type: "tab",
+				path: firstNavigationPath(children),
+				title: resolveLocalizedText(tab.tab, locale.code, i18n.defaultLocale) ?? "",
+				icon: tab.icon,
 				children
 			};
-		});
+		}) };
 	}
 	return result;
 }
 //#endregion
-//#region source/plugins/content-artifacts/raw-content.ts
+//#region source/plugins/content-artifacts/artifacts.ts
+var UTF8_SIGNATURE = "";
 function normalizeBasePath(basePath) {
 	if (!basePath || basePath === "/") return "";
 	return "/" + basePath.replace(/^\/+|\/+$/g, "");
 }
-function routeToMarkdownUrl(routePath) {
+function containsNonAscii(content) {
+	return [...content].some((character) => character.codePointAt(0) > 127);
+}
+function withUtf8Signature(content) {
+	if (!containsNonAscii(content) || content.startsWith(UTF8_SIGNATURE)) return content;
+	return `${UTF8_SIGNATURE}${content}`;
+}
+function shouldUseUtf8Signature(route) {
+	if (route.kind === "mdx") return true;
+	return /\.ya?ml$/i.test(route.contentArtifactUrl ?? "");
+}
+function routeToMarkdownArtifactUrl(routePath) {
 	return `${routePath === "/" ? "/index" : routePath.replace(/\/$/, "")}.md`;
 }
-function routeToOpenAPIUrl(routePath, filePath) {
+function routeToOpenAPIArtifactUrl(routePath, filePath) {
 	const extension = (0, node_path.extname)(filePath).toLowerCase() || ".json";
 	return `${routePath === "/" ? "/index" : routePath.replace(/\/$/, "")}.openapi${extension}`;
 }
-function enrichRoutesWithRawContent(routes) {
-	for (const route of routes) route.rawContentUrl = route.kind === "openapi" ? routeToOpenAPIUrl(route.path, route.filePath) : routeToMarkdownUrl(route.path);
+function attachContentArtifactUrls(routes) {
+	for (const route of routes) route.contentArtifactUrl = route.kind === "openapi" ? routeToOpenAPIArtifactUrl(route.path, route.filePath) : routeToMarkdownArtifactUrl(route.path);
+}
+function readRouteContent(route) {
+	if (route.content !== void 0) return route.content;
+	throw new Error(`Route content is missing from route context: ${route.filePath}`);
 }
-function readRawContent(route) {
-	return (0, node_fs.readFileSync)(route.filePath, "utf-8");
+function readRouteArtifactContent(route) {
+	const content = readRouteContent(route);
+	return shouldUseUtf8Signature(route) ? withUtf8Signature(content) : content;
 }
-function writeRawContentFiles(routes, outputDirectory) {
+function writeContentArtifactFiles(routes, outputDirectory) {
 	for (const route of routes) {
-		if (!route.rawContentUrl) continue;
-		const outFile = (0, node_path.join)(outputDirectory, route.rawContentUrl.replace(/^\//, ""));
+		if (!route.contentArtifactUrl) continue;
+		const outFile = (0, node_path.join)(outputDirectory, route.contentArtifactUrl.replace(/^\//, ""));
 		(0, node_fs.mkdirSync)((0, node_path.dirname)(outFile), { recursive: true });
-		(0, node_fs.writeFileSync)(outFile, readRawContent(route), "utf-8");
+		(0, node_fs.writeFileSync)(outFile, readRouteArtifactContent(route), "utf-8");
 	}
 }
 function createLlmsTxt(routes, projectConfig) {
@@ -384,22 +443,25 @@ function createLlmsTxt(routes, projectConfig) {
 	if (projectConfig.description) lines.push(`> ${projectConfig.description}`, "");
 	lines.push("## Docs");
 	for (const route of routes.filter((route) => route.kind === "mdx")) {
-		if (!route.rawContentUrl) continue;
-		lines.push(`- [${route.title}](${basePath}${route.rawContentUrl})`);
+		if (!route.contentArtifactUrl) continue;
+		lines.push(`- [${route.title}](${basePath}${route.contentArtifactUrl})`);
 	}
 	const openApiRoutes = routes.filter((route) => route.kind === "openapi");
 	if (openApiRoutes.length > 0) {
 		lines.push("", "## OpenAPI");
 		for (const route of openApiRoutes) {
-			if (!route.rawContentUrl) continue;
-			lines.push(`- [${route.title}](${basePath}${route.rawContentUrl})`);
+			if (!route.contentArtifactUrl) continue;
+			lines.push(`- [${route.title}](${basePath}${route.contentArtifactUrl})`);
 		}
 	}
 	return `${lines.join("\n")}\n`;
 }
+function createLlmsTxtArtifact(routes, projectConfig) {
+	return withUtf8Signature(createLlmsTxt(routes, projectConfig));
+}
 function writeLlmsTxt(routes, projectConfig, outputDirectory) {
 	(0, node_fs.mkdirSync)(outputDirectory, { recursive: true });
-	(0, node_fs.writeFileSync)((0, node_path.join)(outputDirectory, "llms.txt"), createLlmsTxt(routes, projectConfig), "utf-8");
+	(0, node_fs.writeFileSync)((0, node_path.join)(outputDirectory, "llms.txt"), createLlmsTxtArtifact(routes, projectConfig), "utf-8");
 }
 //#endregion
 //#region source/plugins/content-artifacts/server.ts
@@ -412,8 +474,8 @@ function resolveContentArtifactPath(url, projectConfig) {
 	const basePath = normalizeRoutePrefix(projectConfig.routePrefix);
 	return basePath && requestPath.startsWith(basePath) ? requestPath.slice(basePath.length) || "/" : requestPath;
 }
-function resolveRawContentType(route) {
-	if (route.kind === "openapi" && /\.ya?ml$/i.test(route.rawContentUrl ?? "")) return "text/yaml; charset=utf-8";
+function resolveContentArtifactType(route) {
+	if (route.kind === "openapi" && /\.ya?ml$/i.test(route.contentArtifactUrl ?? "")) return "text/yaml; charset=utf-8";
 	return route.kind === "openapi" ? "application/json; charset=utf-8" : "text/markdown; charset=utf-8";
 }
 function serveContentArtifacts(req, res, projectConfig, routes) {
@@ -421,14 +483,14 @@ function serveContentArtifacts(req, res, projectConfig, routes) {
 	if (contentPath === "/llms.txt") {
 		res.statusCode = 200;
 		res.setHeader("Content-Type", "text/plain; charset=utf-8");
-		res.end(createLlmsTxt(routes, projectConfig));
+		res.end(createLlmsTxtArtifact(routes, projectConfig), "utf8");
 		return true;
 	}
-	const route = routes.find((route) => route.rawContentUrl === contentPath);
+	const route = routes.find((route) => route.contentArtifactUrl === contentPath);
 	if (!route) return false;
 	res.statusCode = 200;
-	res.setHeader("Content-Type", resolveRawContentType(route));
-	res.end(readRawContent(route));
+	res.setHeader("Content-Type", resolveContentArtifactType(route));
+	res.end(readRouteArtifactContent(route), "utf8");
 	return true;
 }
 //#endregion
@@ -438,7 +500,7 @@ function createContentArtifactsPlugin() {
 		name: "clarify:content-artifacts",
 		hooks: {
 			"routes:resolved": (input) => {
-				enrichRoutesWithRawContent(input.routes);
+				attachContentArtifactUrls(input.routes);
 				return input;
 			},
 			"dev:configureServer": (server, ctx) => {
@@ -450,7 +512,7 @@ function createContentArtifactsPlugin() {
 			"build:done": (ctx) => {
 				const outputDirectory = ctx.generateOptions.outputDirectory;
 				if (!outputDirectory) return;
-				writeRawContentFiles(ctx.routes, outputDirectory);
+				writeContentArtifactFiles(ctx.routes, outputDirectory);
 				writeLlmsTxt(ctx.routes, ctx.projectConfig, outputDirectory);
 			}
 		}
@@ -527,6 +589,9 @@ var OPENAPI_HTTP_METHODS = [
 	"patch",
 	"trace"
 ];
+function errorMessage(error) {
+	return error instanceof Error ? error.message : String(error);
+}
 function kebabToTitle(str) {
 	return str.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
 }
@@ -549,7 +614,8 @@ function findOpenAPIRoutes(dir, base = dir) {
 			filePath: fullPath,
 			virtualModuleId: virtualModuleIdFromRef(ref),
 			title: kebabToTitle(cleanPath.split("/").pop() ?? "API"),
-			kind: "openapi"
+			kind: "openapi",
+			content: (0, node_fs.readFileSync)(fullPath, "utf-8")
 		});
 	}
 	return routes;
@@ -576,9 +642,20 @@ function extractOpenAPISections(spec) {
 }
 async function readOpenAPISpec(filePath) {
 	try {
-		return await _apidevtools_swagger_parser.default.dereference(filePath);
-	} catch {
-		return null;
+		return {
+			ok: true,
+			spec: await _apidevtools_swagger_parser.default.dereference(filePath)
+		};
+	} catch (error) {
+		return {
+			ok: false,
+			diagnostic: {
+				title: "OpenAPI spec parse failed",
+				message: `Clarify could not parse ${filePath}.`,
+				filePath,
+				cause: errorMessage(error)
+			}
+		};
 	}
 }
 //#endregion
@@ -589,10 +666,31 @@ function generateOpenAPIRegistryModule(openApis) {
 }
 function generateOpenAPIModule(spec) {
 	return `import { createElement } from 'react';
-import { OpenApiPage } from '@clarify-labs/renderer';
+import { OpenApiDocument } from '@clarify-labs/renderer';
 const spec = ${JSON.stringify(spec)};
 export default function OpenApiRoutePage() {
-  return createElement(OpenApiPage, { spec });
+  return createElement(OpenApiDocument, { spec });
+}`;
+}
+function generateOpenAPIErrorModule(diagnostic) {
+	return `import { createElement } from 'react';
+const diagnostic = ${JSON.stringify(diagnostic)};
+export default function OpenApiErrorRoutePage() {
+  return createElement('article', { className: 'flex h-full flex-col pt-16 pb-10' },
+    createElement('div', { className: 'prose max-w-none flex-auto dark:prose-invert' },
+      createElement('p', { className: 'mb-3 text-xs/6 font-medium tracking-widest text-red-500 uppercase dark:text-red-400' }, 'OpenAPI Error'),
+      createElement('h1', null, diagnostic.title),
+      createElement('p', { className: 'lead' }, diagnostic.message),
+      diagnostic.filePath ? createElement('div', { className: 'not-prose mt-6 rounded-lg border border-zinc-200 bg-zinc-50 p-4 text-sm dark:border-white/10 dark:bg-white/5' },
+        createElement('div', { className: 'mb-1 font-semibold text-zinc-900 dark:text-white' }, 'File'),
+        createElement('code', { className: 'break-all text-zinc-700 dark:text-zinc-300' }, diagnostic.filePath)
+      ) : null,
+      diagnostic.cause ? createElement('div', { className: 'not-prose mt-4 rounded-lg border border-red-200 bg-red-50 p-4 text-sm text-red-800 dark:border-red-500/30 dark:bg-red-500/10 dark:text-red-200' },
+        createElement('div', { className: 'mb-1 font-semibold' }, 'Why it happened'),
+        createElement('pre', { className: 'whitespace-pre-wrap break-words text-xs' }, diagnostic.cause)
+      ) : null
+    )
+  );
 }`;
 }
 //#endregion
@@ -609,18 +707,26 @@ function createOpenAPIPlugin() {
 			"routes:discovered": async (routes) => {
 				for (const key of Object.keys(specs)) delete specs[key];
 				for (const route of routes.filter((route) => route.kind === "openapi")) {
-					const spec = await readOpenAPISpec(route.filePath);
-					if (!spec) throw new Error(`Failed to parse OpenAPI spec: ${route.filePath}`);
+					const result = await readOpenAPISpec(route.filePath);
+					if (!result.ok) {
+						route.diagnostic = result.diagnostic;
+						route.title = route.title || "OpenAPI parse error";
+						route.sections = [];
+						continue;
+					}
+					const spec = result.spec;
 					specs[route.virtualModuleId] = spec;
 					specs[`virtual:clarify-page/${route.path.replace(/^\//, "")}`] = spec;
 					route.title = spec.info?.title ?? route.title;
+					route.description = spec.info?.description ?? route.description;
 					route.sections = extractOpenAPISections(spec);
 				}
 				return routes;
 			},
-			"modules:before": (modules) => {
+			"modules:before": (modules, ctx) => {
 				modules.set(openApiRegistryModuleId, generateOpenAPIRegistryModule(specs));
 				for (const [moduleId, spec] of Object.entries(specs)) modules.set(moduleId, generateOpenAPIModule(spec));
+				for (const route of ctx.routes.filter((route) => route.kind === "openapi" && route.diagnostic)) if (route.diagnostic) modules.set(route.virtualModuleId, generateOpenAPIErrorModule(route.diagnostic));
 				return modules;
 			}
 		}
@@ -704,20 +810,122 @@ var clarifyPagesGroupSchema = zod.z.object({
 	pages: zod.z.array(clarifyPagesItemSchema)
 });
 var clarifyPagesConfigSchema = zod.z.union([zod.z.array(clarifyPagesGroupSchema), zod.z.literal("FileTree")]);
+var clarifyTabItemSchema = zod.z.object({
+	tab: clarifyLocalizedTextSchema,
+	icon: zod.z.string().optional(),
+	pages: clarifyPagesConfigSchema.optional()
+});
+var clarifyTabsConfigSchema = zod.z.array(clarifyTabItemSchema);
+var clarifyThemePresetSchema = zod.z.enum(["default", "base"]);
+var clarifyThemeColorTokensConfigSchema = zod.z.object({
+	primary: zod.z.string().optional(),
+	accent: zod.z.string().optional(),
+	background: zod.z.string().optional(),
+	foreground: zod.z.string().optional(),
+	surface: zod.z.string().optional(),
+	muted: zod.z.string().optional(),
+	border: zod.z.string().optional(),
+	codeBackground: zod.z.string().optional()
+});
+var clarifyThemeRadiusTokensConfigSchema = zod.z.object({
+	sm: zod.z.string().optional(),
+	md: zod.z.string().optional(),
+	lg: zod.z.string().optional(),
+	xl: zod.z.string().optional()
+});
+var clarifyThemeTokensConfigSchema = zod.z.object({
+	colors: clarifyThemeColorTokensConfigSchema.optional(),
+	radius: clarifyThemeRadiusTokensConfigSchema.optional()
+});
+var clarifyThemeLayoutConfigSchema = zod.z.object({ maxWidth: zod.z.string().optional() });
+var clarifyThemeConfigSchema = zod.z.object({
+	preset: clarifyThemePresetSchema.optional(),
+	tokens: clarifyThemeTokensConfigSchema.optional(),
+	layout: clarifyThemeLayoutConfigSchema.optional()
+});
 var clarifyProjectConfigSchema = zod.z.object({
 	title: zod.z.string().optional(),
 	description: zod.z.string().optional(),
 	logo: clarifyLogoConfigSchema.optional(),
 	favicon: clarifyFaviconConfigSchema.optional(),
-	theme: zod.z.object({ primary: zod.z.string().optional() }).optional(),
+	theme: clarifyThemeConfigSchema.optional(),
 	routePrefix: zod.z.string().optional(),
 	navbar: zod.z.object({ links: zod.z.array(clarifyNavbarLinkSchema).optional() }).optional(),
 	banner: clarifyBannerConfigSchema.optional(),
 	footer: clarifyFooterConfigSchema.optional(),
 	i18n: clarifyI18nConfigSchema.optional(),
-	pages: clarifyPagesConfigSchema.optional()
+	tabs: clarifyTabsConfigSchema.optional()
 });
 //#endregion
+//#region source/core/theme.ts
+var clarifyThemePresets = {
+	default: {
+		preset: "default",
+		tokens: {
+			colors: {
+				primary: "#00D492",
+				accent: "#00F6C9",
+				background: "#ffffff",
+				foreground: "#111827",
+				surface: "#ffffff",
+				muted: "#64748b",
+				border: "rgb(15 23 42 / 0.12)",
+				codeBackground: "#f7fefb"
+			},
+			radius: {
+				sm: "6px",
+				md: "10px",
+				lg: "14px",
+				xl: "18px"
+			}
+		},
+		layout: { maxWidth: "82rem" }
+	},
+	base: {
+		preset: "base",
+		tokens: {
+			colors: {
+				primary: "#18181b",
+				accent: "#52525b",
+				background: "#ffffff",
+				foreground: "#18181b",
+				surface: "#ffffff",
+				muted: "#71717a",
+				border: "rgb(24 24 27 / 0.12)",
+				codeBackground: "#f4f4f5"
+			},
+			radius: {
+				sm: "6px",
+				md: "8px",
+				lg: "12px",
+				xl: "16px"
+			}
+		},
+		layout: { maxWidth: "80rem" }
+	}
+};
+function resolveThemeConfig(theme = {}) {
+	const preset = theme.preset ?? "default";
+	const presetTheme = clarifyThemePresets[preset];
+	return {
+		preset,
+		tokens: {
+			colors: {
+				...presetTheme.tokens.colors,
+				...theme.tokens?.colors
+			},
+			radius: {
+				...presetTheme.tokens.radius,
+				...theme.tokens?.radius
+			}
+		},
+		layout: {
+			...presetTheme.layout,
+			...theme.layout
+		}
+	};
+}
+//#endregion
 //#region source/core/config.ts
 function formatIssuePath(path) {
 	return path.reduce((result, segment) => {
@@ -756,12 +964,12 @@ function resolveProjectConfig(config = {}) {
 		logo: config.logo,
 		favicon: config.favicon,
 		routePrefix: config.routePrefix ?? "/",
-		theme: config.theme ?? {},
+		theme: resolveThemeConfig(config.theme),
 		navbar: config.navbar,
 		banner: config.banner,
 		footer: config.footer,
 		i18n: resolveI18nConfig(config.i18n),
-		pages: config.pages
+		tabs: config.tabs
 	};
 }
 //#endregion
@@ -901,18 +1109,28 @@ function injectHtmlLocaleAttributes(html, projectConfig, route) {
 		return `<html${nextAttributes}>`;
 	});
 }
+function routeTitle(projectConfig, route) {
+	const title = route?.title?.trim();
+	if (!title || title === projectConfig.title) return projectConfig.title;
+	return `${title} - ${projectConfig.title}`;
+}
+function setNamedMeta(html, name, content) {
+	const metaPattern = new RegExp(`<meta\\b(?=[^>]*\\bname=["']${name}["'])[^>]*>\\n?`, "i");
+	if (!content) return html.replace(metaPattern, "");
+	const meta = `<meta name="${name}" content="${escapeHtml(content)}" />`;
+	if (metaPattern.test(html)) return html.replace(metaPattern, meta);
+	return html.replace("</head>", `  ${meta}\n  </head>`);
+}
 function injectSSRIntoTemplate(template, appHtml, projectConfig, route) {
 	let html = injectHtmlLocaleAttributes(template, projectConfig, route);
-	html = html.replace(/<title>.*?<\/title>/, `<title>${escapeHtml(projectConfig.title)}</title>`);
-	if (projectConfig.description && !html.includes("name=\"description\"")) {
-		const descriptionMeta = `<meta name="description" content="${escapeHtml(projectConfig.description)}" />`;
-		html = html.replace("</head>", `  ${descriptionMeta}\n  </head>`);
-	}
+	html = html.replace(/<title>.*?<\/title>/, `<title>${escapeHtml(routeTitle(projectConfig, route))}</title>`);
+	html = setNamedMeta(html, "description", route?.description ?? projectConfig.description);
+	html = setNamedMeta(html, "keywords", route?.keywords?.join(", "));
 	html = html.replace(/<div id="root">[\s\S]*?<\/div>/, `<div id="root">${appHtml}</div>`);
 	return html;
 }
 var SSR_ENTRY_CODE = `import { renderToHTML } from '@clarify-labs/renderer/server';
-import { routes, navigation } from 'virtual:clarify-routes';
+import { routes, navigation } from 'virtual:clarify-routes/server';
 import { config } from 'virtual:clarify-config';
 import { openApis } from 'virtual:clarify-openapi-registry';
 
@@ -934,7 +1152,10 @@ async function buildSSRBundle(root, ssrEntry, ssrOutDir, plugins) {
 			ssr: ssrEntry,
 			outDir: ssrOutDir,
 			emptyOutDir: true,
-			rollupOptions: { input: ssrEntry }
+			rolldownOptions: {
+				input: ssrEntry,
+				checks: { pluginTimings: false }
+			}
 		}
 	});
 }
@@ -991,6 +1212,7 @@ async function loadClarifyConfig(root, env) {
 //#region source/core/virtual-modules.ts
 var VIRTUAL_CONFIG = "virtual:clarify-config";
 var VIRTUAL_ROUTES = "virtual:clarify-routes";
+var VIRTUAL_SERVER_ROUTES = "virtual:clarify-routes/server";
 var VIRTUAL_OPENAPI_REGISTRY = openApiRegistryModuleId;
 var VIRTUAL_CLIENT_ENTRY = "virtual:clarify-entry-client";
 var RESOLVED_CLIENT_ENTRY = "\0virtual:clarify-entry-client";
@@ -1006,8 +1228,11 @@ function generateConfigModule(projectConfig, buildOptions) {
 		...buildOptions
 	})};`;
 }
-function generateRoutesModule(routes, pagesConfig, resolvedNavigation, projectConfig) {
-	const imports = routes.map((r, i) => `import Page${i} from '${r.virtualModuleId}';`).join("\n");
+function moduleSpecifier(value) {
+	return JSON.stringify(value);
+}
+function generateRoutesModule(routes, resolvedNavigation, projectConfig, mode = "client") {
+	const imports = mode === "server" ? routes.map((r, i) => `import Page${i} from ${moduleSpecifier(r.virtualModuleId)};`).join("\n") : "";
 	const routesArray = routes.map((r, i) => {
 		const sections = r.sections && r.sections.length > 0 ? `, sections: ${JSON.stringify(r.sections.map((s) => ({
 			id: s.id,
@@ -1015,14 +1240,18 @@ function generateRoutesModule(routes, pagesConfig, resolvedNavigation, projectCo
 			badge: s.badge,
 			tags: s.tags
 		})))}` : "";
-		const rawContentUrl = r.rawContentUrl ? `, rawContentUrl: ${JSON.stringify(r.rawContentUrl)}` : "";
+		const contentArtifactUrl = r.contentArtifactUrl ? `, contentArtifactUrl: ${JSON.stringify(r.contentArtifactUrl)}` : "";
 		const basePath = r.basePath ? `, basePath: ${JSON.stringify(r.basePath)}` : "";
 		const locale = r.locale ? `, locale: ${JSON.stringify(r.locale)}` : "";
 		const isFallback = r.isFallback ? ", isFallback: true" : "";
 		const alternates = r.alternates ? `, alternates: ${JSON.stringify(r.alternates)}` : "";
-		return `  { path: ${JSON.stringify(r.path)}, title: ${JSON.stringify(r.title)}, component: Page${i}, kind: '${r.kind}'${basePath}${locale}${isFallback}${alternates}${sections}${rawContentUrl} }`;
+		const description = r.description ? `, description: ${JSON.stringify(r.description)}` : "";
+		const keywords = r.keywords && r.keywords.length > 0 ? `, keywords: ${JSON.stringify(r.keywords)}` : "";
+		const component = mode === "server" ? `Page${i}` : `() => import(${moduleSpecifier(r.virtualModuleId)})`;
+		const lazy = mode === "client" ? ", lazy: true" : "";
+		return `  { path: ${JSON.stringify(r.path)}, title: ${JSON.stringify(r.title)}, component: ${component}${lazy}, kind: ${JSON.stringify(r.kind)}${basePath}${locale}${isFallback}${alternates}${description}${keywords}${sections}${contentArtifactUrl} }`;
 	}).join(",\n");
-	const navigation = resolvedNavigation ?? (projectConfig?.i18n ? buildLocalizedNavigation(routes, pagesConfig, projectConfig.i18n) ?? {} : pagesConfig && pagesConfig !== "FileTree" ? buildNavigationFromConfig(routes, pagesConfig) : buildNavigation(routes));
+	const navigation = resolvedNavigation ?? (projectConfig?.tabs ? projectConfig.i18n ? buildLocalizedNavigationFromTabsConfig(routes, projectConfig.tabs, projectConfig.i18n) ?? {} : buildNavigationFromTabsConfig(routes, projectConfig.tabs) : buildNavigation(routes));
 	return `${imports}\n\nexport const routes = [\n${routesArray}\n];\n\nexport const navigation = ${JSON.stringify(navigation, null, 2)};\n`;
 }
 function createClientEntryModule() {
@@ -1037,13 +1266,14 @@ render({ config, routes, navigation, openApis });`;
 function buildVirtualModules(args) {
 	const modules = /* @__PURE__ */ new Map();
 	modules.set(VIRTUAL_CONFIG, generateConfigModule(args.projectConfig, args.generateOptions));
-	modules.set(VIRTUAL_ROUTES, generateRoutesModule(args.routes, args.projectConfig.pages, args.navigation, args.projectConfig));
+	modules.set(VIRTUAL_ROUTES, generateRoutesModule(args.routes, args.navigation, args.projectConfig, "client"));
+	modules.set(VIRTUAL_SERVER_ROUTES, generateRoutesModule(args.routes, args.navigation, args.projectConfig, "server"));
 	modules.set(VIRTUAL_OPENAPI_REGISTRY, "export const openApis = {};");
 	modules.set(VIRTUAL_CLIENT_ENTRY, createClientEntryModule());
 	modules.set(RESOLVED_CLIENT_ENTRY, createClientEntryModule());
 	for (const route of args.routes) {
 		if (route.kind === "openapi") continue;
-		modules.set(route.virtualModuleId, `export { default } from '${route.filePath}';`);
+		modules.set(route.virtualModuleId, `export { default } from ${moduleSpecifier(route.filePath)};`);
 	}
 	return modules;
 }
@@ -1148,7 +1378,7 @@ function clarifyPlugin(options = {}) {
 	async function resolveRoutesAndSpecs() {
 		routes = await discoverRoutes();
 		routes = await runHooks(clarifyPlugins, "routes:discovered", routes, ctx);
-		const defaultNavigation = projectConfig.i18n ? buildLocalizedNavigation(routes, projectConfig.pages, projectConfig.i18n) ?? {} : projectConfig.pages && projectConfig.pages !== "FileTree" ? buildNavigationFromConfig(routes, projectConfig.pages) : buildNavigation(routes);
+		const defaultNavigation = projectConfig.tabs ? projectConfig.i18n ? buildLocalizedNavigationFromTabsConfig(routes, projectConfig.tabs, projectConfig.i18n) ?? {} : buildNavigationFromTabsConfig(routes, projectConfig.tabs) : buildNavigation(routes);
 		const resolved = await runHooks(clarifyPlugins, "routes:resolved", {
 			routes,
 			navigation: defaultNavigation
@@ -1182,6 +1412,20 @@ function clarifyPlugin(options = {}) {
 	function hasContentRouteForFile(filePath) {
 		return routes.some((route) => route.filePath === filePath);
 	}
+	const normalizedMdxContentPlugin = {
+		name: "clarify:normalized-mdx-content",
+		enforce: "pre",
+		transform(_code, id) {
+			if (!/\.mdx?(?:\?|$)/.test(id)) return null;
+			const filePath = id.replace(/\?.*$/, "");
+			const route = routes.find((route) => route.kind === "mdx" && route.filePath === filePath);
+			if (!route || route.content === void 0) return null;
+			return {
+				code: route.content,
+				map: null
+			};
+		}
+	};
 	const mdx = (0, _mdx_js_rollup.default)({
 		include: ["**/*.{md,mdx}"],
 		jsxImportSource: "react",
@@ -1192,6 +1436,7 @@ function clarifyPlugin(options = {}) {
 	return [
 		(0, _vitejs_plugin_react.default)(),
 		(0, _tailwindcss_vite.default)(),
+		normalizedMdxContentPlugin,
 		{
 			name: "clarify:core",
 			async config() {
@@ -1227,6 +1472,7 @@ function clarifyPlugin(options = {}) {
 				if (id === "virtual:clarify-entry-client" || id === "\0virtual:clarify-entry-client") return RESOLVED_CLIENT_ENTRY;
 				if (id === "virtual:clarify-config" || id === resolveVirtualId("virtual:clarify-config")) return resolveVirtualId(VIRTUAL_CONFIG);
 				if (id === "virtual:clarify-routes" || id === resolveVirtualId("virtual:clarify-routes")) return resolveVirtualId(VIRTUAL_ROUTES);
+				if (id === "virtual:clarify-routes/server" || id === resolveVirtualId("virtual:clarify-routes/server")) return resolveVirtualId(VIRTUAL_SERVER_ROUTES);
 				if (id === VIRTUAL_OPENAPI_REGISTRY || id === resolveVirtualId(VIRTUAL_OPENAPI_REGISTRY)) return resolveVirtualId(VIRTUAL_OPENAPI_REGISTRY);
 				const route = routes.find((r) => r.virtualModuleId === id || r.virtualModuleId === stripVirtualPrefix(id));
 				if (route) return resolveVirtualId(route.virtualModuleId);
@@ -1272,19 +1518,24 @@ function clarifyPlugin(options = {}) {
 				let tempEntryPath;
 				try {
 					tempEntryPath = createTempEntryFile(SSR_ENTRY_CODE);
-					await buildSSRBundle(root, tempEntryPath, ssrOutputDir, [{
-						name: "clarify:virtual-ssg",
-						resolveId(id) {
-							if (id === "virtual:clarify-entry-client") return RESOLVED_CLIENT_ENTRY;
-							if (id === "\0virtual:clarify-entry-client") return RESOLVED_CLIENT_ENTRY;
-							if (id === "virtual:clarify-config") return id;
-							if (id === "virtual:clarify-routes") return id;
-							if (id === VIRTUAL_OPENAPI_REGISTRY) return id;
-							if (routes.find((r) => r.virtualModuleId === id)) return id;
-							return null;
+					await buildSSRBundle(root, tempEntryPath, ssrOutputDir, [
+						{
+							name: "clarify:virtual-ssg",
+							resolveId(id) {
+								if (id === "virtual:clarify-entry-client") return RESOLVED_CLIENT_ENTRY;
+								if (id === "\0virtual:clarify-entry-client") return RESOLVED_CLIENT_ENTRY;
+								if (id === "virtual:clarify-config") return id;
+								if (id === "virtual:clarify-routes") return id;
+								if (id === "virtual:clarify-routes/server") return id;
+								if (id === VIRTUAL_OPENAPI_REGISTRY) return id;
+								if (routes.find((r) => r.virtualModuleId === id)) return id;
+								return null;
+							},
+							load: (id) => loadVirtualModule(id, virtualModules)
 						},
-						load: (id) => loadVirtualModule(id, virtualModules)
-					}, mdx]);
+						normalizedMdxContentPlugin,
+						mdx
+					]);
 					const ssrBundlePath = (0, node_path.join)(ssrOutputDir, "entry-server.js");
 					await renderSSGRoutes(routes, projectConfig, outputDir, ssrBundlePath, generateOptions.ssg.failOnError);
 				} catch (err) {
@@ -1327,4 +1578,4 @@ Object.defineProperty(exports, "loadClarifyConfig", {
 	}
 });
 
-//# sourceMappingURL=plugin-CEyCiD5r.cjs.map
+//# sourceMappingURL=plugin-DnD0L83F.cjs.map