@clarify-labs/cli 0.6.5 → 0.6.7

package/output/{plugin-Dq1zHXan.cjs → plugin-hJcy-YdO.cjs}

@@ -35,13 +35,13 @@ 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 zod = require("zod");
 let remark = require("remark");
 let gray_matter = require("gray-matter");
 gray_matter = __toESM(gray_matter, 1);
 let _apidevtools_swagger_parser = require("@apidevtools/swagger-parser");
 _apidevtools_swagger_parser = __toESM(_apidevtools_swagger_parser, 1);
 let node_fs_promises = require("node:fs/promises");
+let zod = require("zod");
 let node_os = require("node:os");
 let node_url = require("node:url");
 let vite = require("vite");
@@ -77,6 +77,11 @@ function rehypeParseCodeBlocks() {
 			const language = getLanguage(node.properties.className);
 			parentNode.properties.language = language;
 			node.properties.language = language;
+			for (const key of [
+				"title",
+				"tag",
+				"label"
+			]) if (node.properties[key] !== void 0) parentNode.properties[key] = node.properties[key];
 		});
 	};
 }
@@ -130,284 +135,25 @@ var rehypePlugins = [
 	rehypeShiki
 ];
 //#endregion
-//#region source/core/config-schema.ts
-var clarifyLogoConfigSchema = zod.z.union([zod.z.string(), zod.z.object({
-	light: zod.z.string().optional(),
-	dark: zod.z.string().optional()
-})]);
-var clarifyFaviconConfigSchema = zod.z.union([zod.z.string(), zod.z.object({
-	light: zod.z.string().optional(),
-	dark: zod.z.string().optional()
-})]);
-var clarifyLocalizedTextSchema = zod.z.union([zod.z.string(), zod.z.record(zod.z.string(), zod.z.string())]);
-var clarifyLocaleConfigSchema = zod.z.object({
-	code: zod.z.string(),
-	label: zod.z.string(),
-	dir: zod.z.union([zod.z.literal("ltr"), zod.z.literal("rtl")]).optional()
-});
-var clarifyI18nConfigSchema = zod.z.object({
-	defaultLocale: zod.z.string().optional(),
-	missing: zod.z.union([
-		zod.z.literal("fallback"),
-		zod.z.literal("404"),
-		zod.z.literal("hide")
-	]).optional(),
-	locales: zod.z.array(clarifyLocaleConfigSchema).min(1)
-}).superRefine((config, ctx) => {
-	const localeCodes = /* @__PURE__ */ new Set();
-	for (const [index, locale] of config.locales.entries()) {
-		if (localeCodes.has(locale.code)) ctx.addIssue({
-			code: zod.z.ZodIssueCode.custom,
-			message: `Duplicate locale code "${locale.code}"`,
-			path: [
-				"locales",
-				index,
-				"code"
-			]
-		});
-		localeCodes.add(locale.code);
-	}
-	if (config.defaultLocale && !localeCodes.has(config.defaultLocale)) ctx.addIssue({
-		code: zod.z.ZodIssueCode.custom,
-		message: "defaultLocale must be one of i18n.locales",
-		path: ["defaultLocale"]
-	});
-});
-var clarifyNavbarLinkSchema = zod.z.object({
-	label: clarifyLocalizedTextSchema,
-	href: zod.z.string(),
-	external: zod.z.boolean().optional()
-});
-var clarifyBannerConfigSchema = zod.z.object({
-	content: clarifyLocalizedTextSchema,
-	dismissible: zod.z.boolean().optional()
-});
-var clarifyFooterConfigSchema = zod.z.object({
-	links: zod.z.array(clarifyNavbarLinkSchema).optional(),
-	socials: zod.z.record(zod.z.string(), zod.z.string()).optional(),
-	copyright: clarifyLocalizedTextSchema.optional()
-});
-var clarifySourceConfigSchema = zod.z.object({
-	repository: zod.z.string(),
-	branch: zod.z.string().optional(),
-	directory: zod.z.string().optional()
-});
-var clarifyPagesItemSchema = zod.z.union([
-	zod.z.string(),
-	zod.z.object({
-		page: zod.z.string(),
-		title: clarifyLocalizedTextSchema.optional(),
-		icon: zod.z.string().optional(),
-		redirect: zod.z.string().optional()
-	}),
-	zod.z.object({
-		openapi: zod.z.string(),
-		icon: zod.z.string().optional(),
-		title: clarifyLocalizedTextSchema.optional(),
-		filter: zod.z.object({ tags: zod.z.array(zod.z.string()).optional() }).optional()
-	})
-]);
-var clarifyPagesGroupSchema = zod.z.object({
-	group: clarifyLocalizedTextSchema,
-	icon: zod.z.string().optional(),
-	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 clarifyThemeModeColorValueSchema = zod.z.object({
-	light: zod.z.string().optional(),
-	dark: zod.z.string().optional()
-});
-var clarifyThemeColorValueSchema = zod.z.union([zod.z.string(), clarifyThemeModeColorValueSchema]);
-var clarifyThemeColorTokensConfigSchema = zod.z.object({
-	primary: clarifyThemeColorValueSchema.optional(),
-	accent: clarifyThemeColorValueSchema.optional(),
-	background: clarifyThemeColorValueSchema.optional(),
-	foreground: clarifyThemeColorValueSchema.optional(),
-	surface: clarifyThemeColorValueSchema.optional(),
-	muted: clarifyThemeColorValueSchema.optional(),
-	border: clarifyThemeColorValueSchema.optional(),
-	codeBackground: clarifyThemeColorValueSchema.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(),
-	editor: zod.z.boolean().optional()
-});
-var clarifyProjectConfigSchema = zod.z.object({
-	title: zod.z.string().optional(),
-	description: zod.z.string().optional(),
-	siteUrl: zod.z.string().optional(),
-	source: clarifySourceConfigSchema.optional(),
-	logo: clarifyLogoConfigSchema.optional(),
-	favicon: clarifyFaviconConfigSchema.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(),
-	tabs: clarifyTabsConfigSchema.optional()
-});
-//#endregion
-//#region source/core/theme.ts
-var clarifyThemePresets = {
-	default: {
-		preset: "default",
-		tokens: {
-			colors: {
-				primary: "#047857",
-				accent: "#0D9488",
-				background: "#ffffff",
-				foreground: "#111827",
-				surface: "#ffffff",
-				muted: "#64748b",
-				border: "rgb(15 23 42 / 0.12)",
-				codeBackground: "#f6fbf8"
-			},
-			radius: {
-				sm: "6px",
-				md: "10px",
-				lg: "14px",
-				xl: "18px"
-			}
-		},
-		layout: { maxWidth: "82rem" },
-		editor: false
-	},
-	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" },
-		editor: false
-	}
-};
-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
-		},
-		editor: theme.editor ?? presetTheme.editor
-	};
+//#region source/plugins/content-artifacts/artifacts.ts
+var UTF8_SIGNATURE = "";
+function normalizeBasePath(basePath) {
+	if (!basePath || basePath === "/") return "";
+	return "/" + basePath.replace(/^\/+|\/+$/g, "");
 }
-//#endregion
-//#region source/core/config.ts
-function formatIssuePath(path) {
-	return path.reduce((result, segment) => {
-		if (typeof segment === "number") return `${result}[${segment}]`;
-		const key = String(segment);
-		return result ? `${result}.${key}` : key;
-	}, "");
+function containsNonAscii(content) {
+	return [...content].some((character) => character.codePointAt(0) > 127);
 }
-function formatProjectConfigError(error) {
-	const issue = error.issues[0];
-	if (!issue) return "[clarify] config is invalid";
-	const path = formatIssuePath(issue.path);
-	if (!path) return `[clarify] config must contain an object: ${issue.message}`;
-	return `[clarify] config field "${path}" is invalid: ${issue.message}`;
+function withUtf8Signature(content) {
+	if (!containsNonAscii(content) || content.startsWith(UTF8_SIGNATURE)) return content;
+	return `${UTF8_SIGNATURE}${content}`;
 }
-function validateProjectConfig(value) {
-	const result = clarifyProjectConfigSchema.safeParse(value);
-	if (!result.success) throw new Error(formatProjectConfigError(result.error));
-	return result.data;
+function shouldUseUtf8Signature(route) {
+	if (route.kind === "mdx") return true;
+	return /\.ya?ml$/i.test(route.contentArtifactUrl ?? "");
 }
-function resolveI18nConfig(i18n) {
-	if (!i18n) return void 0;
-	const firstLocale = i18n.locales[0]?.code;
-	const defaultLocale = i18n.defaultLocale ?? firstLocale;
-	if (!defaultLocale) return void 0;
-	return {
-		defaultLocale,
-		missing: i18n.missing ?? "fallback",
-		locales: i18n.locales
-	};
-}
-function resolveProjectConfig(config = {}) {
-	return {
-		title: config.title ?? "Clarify Docs",
-		description: config.description ?? "",
-		siteUrl: config.siteUrl,
-		source: config.source,
-		logo: config.logo,
-		favicon: config.favicon,
-		routePrefix: config.routePrefix ?? "/",
-		theme: resolveThemeConfig(config.theme),
-		navbar: config.navbar,
-		banner: config.banner,
-		footer: config.footer,
-		i18n: resolveI18nConfig(config.i18n),
-		tabs: config.tabs
-	};
-}
-//#endregion
-//#region source/plugins/content-artifacts/artifacts.ts
-var UTF8_SIGNATURE = "";
-function normalizeBasePath(basePath) {
-	if (!basePath || basePath === "/") return "";
-	return "/" + basePath.replace(/^\/+|\/+$/g, "");
-}
-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 routeToMarkdownArtifactUrl(routePath) {
+	return `${routePath === "/" ? "/index" : routePath.replace(/\/$/, "")}.md`;
 }
 function routeToOpenAPIArtifactUrl(routePath, filePath) {
 	const extension = (0, node_path.extname)(filePath).toLowerCase() || ".json";
@@ -639,13 +385,14 @@ function basePathFromRef(ref) {
 	const withoutExtension = ref.replace(/\.mdx?$/, "").replace(/\.openapi\.(json|yaml|yml)$/, "");
 	return normalizePath(withoutExtension === "index" ? "/" : withoutExtension.replace(/\/index$/, ""));
 }
-function openAPIPagePathFromRef(ref, tagFilter) {
+function openAPIPagePathFromRef(ref, tagFilter, explicitPath) {
+	if (explicitPath) return normalizePath(explicitPath);
 	const basePath = basePathFromRef(ref);
 	if (!tagFilter?.length) return basePath;
 	return normalizePath(`${basePath}/${openAPITagsPathSegment(tagFilter)}`);
 }
-function routePathFromRef(ref) {
-	return basePathFromRef(ref);
+function routePathFromRef(ref, explicitPath) {
+	return explicitPath ? normalizePath(explicitPath) : basePathFromRef(ref);
 }
 function virtualModuleIdFromRef(ref) {
 	return "virtual:clarify-page/" + ref.replace(/\.mdx?$/, "").replace(/\.openapi\.(json|yaml|yml)$/, "").replace(/\/+/g, "/");
@@ -699,6 +446,18 @@ function frontmatterKeywords(frontmatter) {
 	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 withAlternates$2(route, routes, i18n) {
+	const basePath = route.basePath ?? route.path;
+	const routeByLocaleAndBase = new Map(routes.map((route) => [`${route.locale ?? ""}:${route.basePath ?? route.path}`, route]));
+	const alternates = Object.fromEntries(i18n.locales.flatMap((locale) => {
+		const alternate = routeByLocaleAndBase.get(`${locale.code}:${basePath}`);
+		return alternate ? [[locale.code, alternate.path]] : [];
+	}));
+	return {
+		...route,
+		alternates
+	};
+}
 function buildNavigation(routes) {
 	const root = [];
 	for (const route of routes) {
@@ -730,11 +489,13 @@ function resolvePageItem(item) {
 	if ("openapi" in item) return {
 		openapiRef: item.openapi,
 		openapiTagFilter: item.filter?.tags,
+		path: item.path,
 		title: item.title,
 		icon: item.icon
 	};
 	return {
 		pageRef: item.page,
+		path: item.path,
 		redirect: item.redirect,
 		title: item.title,
 		icon: item.icon
@@ -748,6 +509,41 @@ function firstNavigationPath(nodes) {
 	}
 	return "/";
 }
+function collectExplicitPagePathItems(tabs) {
+	const items = [];
+	for (const tab of tabs ?? []) {
+		if (!tab.pages || tab.pages === "FileTree") continue;
+		for (const group of tab.pages) for (const item of group.pages) if (typeof item !== "string" && "page" in item && item.path) items.push({
+			pageRef: item.page,
+			path: item.path
+		});
+	}
+	return items;
+}
+function applyConfiguredPageRoutePaths(routes, tabs, i18n) {
+	const pageItems = collectExplicitPagePathItems(tabs);
+	if (!pageItems.length) return routes;
+	const additions = [];
+	const existingKeys = new Set(routes.map((route) => `${route.locale ?? ""}:${route.basePath ?? route.path}`));
+	for (const item of pageItems) {
+		const sourceBasePath = routePathFromRef(item.pageRef);
+		const targetBasePath = routePathFromRef(item.pageRef, item.path);
+		if (sourceBasePath === targetBasePath) continue;
+		for (const route of routes) {
+			if (route.kind !== "mdx" || (route.basePath ?? route.path) !== sourceBasePath) continue;
+			const key = `${route.locale ?? ""}:${targetBasePath}`;
+			if (existingKeys.has(key)) continue;
+			existingKeys.add(key);
+			additions.push({
+				...route,
+				path: route.locale && i18n ? localizedRoutePath(targetBasePath, route.locale, i18n) : targetBasePath,
+				basePath: targetBasePath
+			});
+		}
+	}
+	const nextRoutes = [...routes, ...additions];
+	return i18n ? nextRoutes.map((route) => withAlternates$2(route, nextRoutes, i18n)) : nextRoutes;
+}
 function buildNavigationFromPagesConfig(routes, config) {
 	if (!config || config === "FileTree") return buildNavigation(routes);
 	return buildNavigationFromConfig(routes, config);
@@ -768,9 +564,9 @@ function buildNavigationFromConfig(routes, config) {
 	const routeMap = new Map(routes.map((r) => [r.path, r]));
 	return config.map((group) => {
 		const children = group.pages.map((item) => {
-			const { pageRef, openapiRef, openapiTagFilter, redirect, title, icon } = resolvePageItem(item);
+			const { pageRef, openapiRef, openapiTagFilter, path: explicitPath, redirect, title, icon } = resolvePageItem(item);
 			if (openapiRef) {
-				const path = openAPIPagePathFromRef(openapiRef, openapiTagFilter);
+				const path = openAPIPagePathFromRef(openapiRef, openapiTagFilter, explicitPath);
 				const route = routeMap.get(path);
 				return {
 					path,
@@ -780,10 +576,10 @@ function buildNavigationFromConfig(routes, config) {
 				};
 			}
 			const ref = pageRef ?? "";
-			const path = ref === "index" ? "/" : "/" + ref;
+			const path = routePathFromRef(ref, explicitPath);
 			const route = routeMap.get(path);
 			return {
-				path: redirect ? redirect : path,
+				path: redirect ? normalizePath(redirect) : path,
 				title: resolveLocalizedText(title, "", "") ?? route?.title ?? kebabToTitle$1(path.split("/").pop() ?? ref),
 				icon,
 				sections: route?.sections ? navigationSections(route.sections) : void 0
@@ -812,13 +608,13 @@ function buildLocalizedNavigationForLocale(routes, config, 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, openapiTagFilter, redirect, title, icon } = resolvePageItem(item);
+			const { pageRef, openapiRef, openapiTagFilter, path: explicitPath, redirect, title, icon } = resolvePageItem(item);
 			const ref = openapiRef ?? pageRef ?? "";
-			const basePath = openapiRef ? openAPIPagePathFromRef(openapiRef, openapiTagFilter) : basePathFromRef(ref);
+			const basePath = openapiRef ? openAPIPagePathFromRef(openapiRef, openapiTagFilter, explicitPath) : routePathFromRef(ref, explicitPath);
 			const route = routeMap.get(basePath);
 			const path = route?.path ?? localizedRoutePath(basePath, locale, i18n);
 			return {
-				path: (redirect ? localizedRoutePath(basePathFromRef(redirect), locale, i18n) : void 0) ?? path,
+				path: (redirect ? localizedRoutePath(routePathFromRef(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
@@ -1049,7 +845,7 @@ function collectOpenAPIPageItems(config) {
 	const items = [];
 	function visitPages(pages) {
 		if (!pages || pages === "FileTree") return;
-		for (const group of pages) for (const item of group.pages) if (typeof item !== "string" && "openapi" in item && item.filter?.tags?.length) items.push(item);
+		for (const group of pages) for (const item of group.pages) if (typeof item !== "string" && "openapi" in item && (item.path || item.filter?.tags?.length)) items.push(item);
 	}
 	for (const tab of config.tabs ?? []) visitPages(tab.pages);
 	return items;
@@ -1066,28 +862,31 @@ function withAlternates$1(route, routes, i18n) {
 		alternates
 	};
 }
-function createTaggedOpenAPIRoutes(routes, config) {
+function virtualModuleIdFromPath(path) {
+	return `virtual:clarify-page/${path.replace(/^\/+/, "") || "index"}`;
+}
+function createConfiguredOpenAPIRoutes(routes, config) {
 	const pageItems = collectOpenAPIPageItems(config);
 	if (!pageItems.length) return routes;
 	const additions = [];
 	const existingKeys = new Set(routes.map((route) => `${route.locale ?? ""}:${route.basePath ?? route.path}`));
 	for (const item of pageItems) {
 		const tagFilter = item.filter?.tags?.filter(Boolean);
-		if (!tagFilter?.length) continue;
 		const sourceBasePath = openAPIPagePathFromRef(item.openapi);
-		const filteredBasePath = openAPIPagePathFromRef(item.openapi, tagFilter);
+		const targetBasePath = openAPIPagePathFromRef(item.openapi, tagFilter, item.path);
+		if (sourceBasePath === targetBasePath && !tagFilter?.length) continue;
 		for (const route of routes) {
 			if (route.kind !== "openapi" || (route.basePath ?? route.path) !== sourceBasePath) continue;
-			const key = `${route.locale ?? ""}:${filteredBasePath}`;
+			const key = `${route.locale ?? ""}:${targetBasePath}`;
 			if (existingKeys.has(key)) continue;
 			existingKeys.add(key);
 			additions.push({
 				...route,
-				path: route.locale && config.i18n ? localizedRoutePath(filteredBasePath, route.locale, config.i18n) : filteredBasePath,
-				basePath: filteredBasePath,
+				path: route.locale && config.i18n ? localizedRoutePath(targetBasePath, route.locale, config.i18n) : targetBasePath,
+				basePath: targetBasePath,
 				title: route.title,
-				virtualModuleId: `${route.virtualModuleId}/${openAPITagsPathSegment(tagFilter)}`,
-				openapiTagFilter: tagFilter
+				virtualModuleId: virtualModuleIdFromPath(targetBasePath),
+				openapiTagFilter: tagFilter?.length ? tagFilter : void 0
 			});
 		}
 	}
@@ -1105,7 +904,7 @@ function createOpenAPIPlugin() {
 			}),
 			"routes:discovered": async (routes, ctx) => {
 				for (const key of Object.keys(specs)) delete specs[key];
-				const nextRoutes = createTaggedOpenAPIRoutes(routes, ctx.projectConfig);
+				const nextRoutes = createConfiguredOpenAPIRoutes(routes, ctx.projectConfig);
 				const specByFilePath = /* @__PURE__ */ new Map();
 				for (const route of nextRoutes.filter((route) => route.kind === "openapi")) {
 					const specFromCache = specByFilePath.get(route.filePath);
@@ -1246,6 +1045,267 @@ function createBuiltinPlugins(options = {}) {
 	return plugins;
 }
 //#endregion
+//#region source/core/config-schema.ts
+var clarifyLogoConfigSchema = zod.z.union([zod.z.string(), zod.z.object({
+	light: zod.z.string().optional(),
+	dark: zod.z.string().optional()
+})]);
+var clarifyFaviconConfigSchema = zod.z.union([zod.z.string(), zod.z.object({
+	light: zod.z.string().optional(),
+	dark: zod.z.string().optional()
+})]);
+var clarifyLocalizedTextSchema = zod.z.union([zod.z.string(), zod.z.record(zod.z.string(), zod.z.string())]);
+var clarifyLocaleConfigSchema = zod.z.object({
+	code: zod.z.string(),
+	label: zod.z.string(),
+	dir: zod.z.union([zod.z.literal("ltr"), zod.z.literal("rtl")]).optional()
+});
+var clarifyI18nConfigSchema = zod.z.object({
+	defaultLocale: zod.z.string().optional(),
+	missing: zod.z.union([
+		zod.z.literal("fallback"),
+		zod.z.literal("404"),
+		zod.z.literal("hide")
+	]).optional(),
+	locales: zod.z.array(clarifyLocaleConfigSchema).min(1)
+}).superRefine((config, ctx) => {
+	const localeCodes = /* @__PURE__ */ new Set();
+	for (const [index, locale] of config.locales.entries()) {
+		if (localeCodes.has(locale.code)) ctx.addIssue({
+			code: zod.z.ZodIssueCode.custom,
+			message: `Duplicate locale code "${locale.code}"`,
+			path: [
+				"locales",
+				index,
+				"code"
+			]
+		});
+		localeCodes.add(locale.code);
+	}
+	if (config.defaultLocale && !localeCodes.has(config.defaultLocale)) ctx.addIssue({
+		code: zod.z.ZodIssueCode.custom,
+		message: "defaultLocale must be one of i18n.locales",
+		path: ["defaultLocale"]
+	});
+});
+var clarifyNavbarLinkSchema = zod.z.object({
+	label: clarifyLocalizedTextSchema,
+	href: zod.z.string(),
+	external: zod.z.boolean().optional()
+});
+var clarifyBannerConfigSchema = zod.z.object({
+	content: clarifyLocalizedTextSchema,
+	dismissible: zod.z.boolean().optional()
+});
+var clarifyFooterConfigSchema = zod.z.object({
+	links: zod.z.array(clarifyNavbarLinkSchema).optional(),
+	socials: zod.z.record(zod.z.string(), zod.z.string()).optional(),
+	copyright: clarifyLocalizedTextSchema.optional()
+});
+var clarifySourceConfigSchema = zod.z.object({
+	repository: zod.z.string(),
+	branch: zod.z.string().optional(),
+	directory: zod.z.string().optional()
+});
+var clarifyPagesItemSchema = zod.z.union([
+	zod.z.string(),
+	zod.z.object({
+		page: zod.z.string(),
+		path: zod.z.string().optional(),
+		title: clarifyLocalizedTextSchema.optional(),
+		icon: zod.z.string().optional(),
+		redirect: zod.z.string().optional()
+	}),
+	zod.z.object({
+		openapi: zod.z.string(),
+		path: zod.z.string().optional(),
+		icon: zod.z.string().optional(),
+		title: clarifyLocalizedTextSchema.optional(),
+		filter: zod.z.object({ tags: zod.z.array(zod.z.string()).optional() }).optional()
+	})
+]);
+var clarifyPagesGroupSchema = zod.z.object({
+	group: clarifyLocalizedTextSchema,
+	icon: zod.z.string().optional(),
+	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 clarifyThemeModeColorValueSchema = zod.z.object({
+	light: zod.z.string().optional(),
+	dark: zod.z.string().optional()
+});
+var clarifyThemeColorValueSchema = zod.z.union([zod.z.string(), clarifyThemeModeColorValueSchema]);
+var clarifyThemeColorTokensConfigSchema = zod.z.object({
+	primary: clarifyThemeColorValueSchema.optional(),
+	accent: clarifyThemeColorValueSchema.optional(),
+	background: clarifyThemeColorValueSchema.optional(),
+	foreground: clarifyThemeColorValueSchema.optional(),
+	surface: clarifyThemeColorValueSchema.optional(),
+	muted: clarifyThemeColorValueSchema.optional(),
+	border: clarifyThemeColorValueSchema.optional(),
+	codeBackground: clarifyThemeColorValueSchema.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(),
+	editor: zod.z.boolean().optional()
+});
+var clarifyProjectConfigSchema = zod.z.object({
+	title: zod.z.string().optional(),
+	description: zod.z.string().optional(),
+	siteUrl: zod.z.string().optional(),
+	source: clarifySourceConfigSchema.optional(),
+	logo: clarifyLogoConfigSchema.optional(),
+	favicon: clarifyFaviconConfigSchema.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(),
+	tabs: clarifyTabsConfigSchema.optional()
+});
+//#endregion
+//#region source/core/theme.ts
+var clarifyThemePresets = {
+	default: {
+		preset: "default",
+		tokens: {
+			colors: {
+				primary: "#047857",
+				accent: "#0D9488",
+				background: "#ffffff",
+				foreground: "#111827",
+				surface: "#ffffff",
+				muted: "#64748b",
+				border: "rgb(15 23 42 / 0.12)",
+				codeBackground: "#f6fbf8"
+			},
+			radius: {
+				sm: "6px",
+				md: "10px",
+				lg: "14px",
+				xl: "18px"
+			}
+		},
+		layout: { maxWidth: "82rem" },
+		editor: false
+	},
+	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" },
+		editor: false
+	}
+};
+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
+		},
+		editor: theme.editor ?? presetTheme.editor
+	};
+}
+//#endregion
+//#region source/core/config.ts
+function formatIssuePath(path) {
+	return path.reduce((result, segment) => {
+		if (typeof segment === "number") return `${result}[${segment}]`;
+		const key = String(segment);
+		return result ? `${result}.${key}` : key;
+	}, "");
+}
+function formatProjectConfigError(error) {
+	const issue = error.issues[0];
+	if (!issue) return "[clarify] config is invalid";
+	const path = formatIssuePath(issue.path);
+	if (!path) return `[clarify] config must contain an object: ${issue.message}`;
+	return `[clarify] config field "${path}" is invalid: ${issue.message}`;
+}
+function validateProjectConfig(value) {
+	const result = clarifyProjectConfigSchema.safeParse(value);
+	if (!result.success) throw new Error(formatProjectConfigError(result.error));
+	return result.data;
+}
+function resolveI18nConfig(i18n) {
+	if (!i18n) return void 0;
+	const firstLocale = i18n.locales[0]?.code;
+	const defaultLocale = i18n.defaultLocale ?? firstLocale;
+	if (!defaultLocale) return void 0;
+	return {
+		defaultLocale,
+		missing: i18n.missing ?? "fallback",
+		locales: i18n.locales
+	};
+}
+function resolveProjectConfig(config = {}) {
+	return {
+		title: config.title ?? "Clarify Docs",
+		description: config.description ?? "",
+		siteUrl: config.siteUrl,
+		source: config.source,
+		logo: config.logo,
+		favicon: config.favicon,
+		routePrefix: config.routePrefix ?? "/",
+		theme: resolveThemeConfig(config.theme),
+		navbar: config.navbar,
+		banner: config.banner,
+		footer: config.footer,
+		i18n: resolveI18nConfig(config.i18n),
+		tabs: config.tabs
+	};
+}
+//#endregion
 //#region source/core/hooks.ts
 async function runHooks(plugins, hookName, input, ctx) {
 	let result = input;
@@ -1363,6 +1423,7 @@ async function resolveClarifySite(options = {}, resolveOptions = {}) {
 	};
 	let routes = await discoverRoutes(root, contentRoot, plugins, ctx);
 	routes = await runHooks(plugins, "routes:discovered", routes, ctx);
+	routes = applyConfiguredPageRoutePaths(routes, projectConfig.tabs, projectConfig.i18n);
 	const defaultNavigation = projectConfig.tabs ? projectConfig.i18n ? buildLocalizedNavigationFromTabsConfig(routes, projectConfig.tabs, projectConfig.i18n) ?? {} : buildNavigationFromTabsConfig(routes, projectConfig.tabs) : buildNavigation(routes);
 	const resolved = await runHooks(plugins, "routes:resolved", {
 		routes,
@@ -1816,4 +1877,4 @@ Object.defineProperty(exports, "resolveClarifySite", {
 	}
 });
 
-//# sourceMappingURL=plugin-Dq1zHXan.cjs.map
+//# sourceMappingURL=plugin-hJcy-YdO.cjs.map