@clarify-labs/cli 0.6.6 → 0.7.0

package/output/{plugin-GTN_SQ7d.cjs → plugin-dzXRzjdX.cjs}

@@ -40,9 +40,9 @@ 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_os = require("node:os");
 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");
 let node_module = require("node:module");
@@ -261,8 +261,80 @@ function createContentArtifactsPlugin() {
 	};
 }
 //#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/plugins/html-shell/index.ts
-var THEME_BOOTSTRAP_SCRIPT = `(function(){try{var e=localStorage.getItem('clarify:theme');var t=e==='dark'||e==='light'||e==='system'?e:'system';var r=t==='system'?window.matchMedia('(prefers-color-scheme: dark)').matches:t==='dark';document.documentElement.classList.toggle('dark',r);document.documentElement.style.colorScheme=r?'dark':'light'}catch(e){}})();`;
+var THEME_STORAGE_KEY = "clarify:theme";
 var REL_ICON_RE = /<link\s+[^>]*rel=["'][^"']*\bicon\b[^"']*["'][^>]*>/i;
 function inferIconType(href) {
 	const path = href.split(/[?#]/, 1)[0]?.toLowerCase() ?? href.toLowerCase();
@@ -292,6 +364,62 @@ function createIconTags(icon) {
 	if (lightIcon === darkIcon) return [createIconTag(lightIcon)];
 	return [createIconTag(lightIcon, "(prefers-color-scheme: light)"), createIconTag(darkIcon, "(prefers-color-scheme: dark)")];
 }
+function matchesPresetTheme(theme) {
+	const preset = clarifyThemePresets[theme.preset];
+	return JSON.stringify({
+		tokens: theme.tokens,
+		layout: theme.layout
+	}) === JSON.stringify({
+		tokens: preset.tokens,
+		layout: preset.layout
+	});
+}
+function effectiveTheme(theme, resolvedTheme) {
+	if (resolvedTheme !== "dark" || !matchesPresetTheme(theme)) return theme;
+	return {
+		...theme,
+		tokens: {
+			...theme.tokens,
+			colors: {
+				...theme.tokens.colors,
+				background: "#09090b",
+				foreground: "#ffffff",
+				surface: "#18181b",
+				muted: "#a1a1aa",
+				border: "rgb(255 255 255 / 0.1)",
+				codeBackground: "#18181b"
+			}
+		}
+	};
+}
+function resolveThemeColorValue(value, resolvedTheme) {
+	return typeof value === "string" ? value : value[resolvedTheme] ?? value.light ?? value.dark ?? "";
+}
+function themeToCssVariables(theme, resolvedTheme) {
+	const resolved = effectiveTheme(theme, resolvedTheme);
+	const { colors } = resolved.tokens;
+	const { radius } = resolved.tokens;
+	return {
+		"--clarify-theme-tokens-colors-primary": resolveThemeColorValue(colors.primary, resolvedTheme),
+		"--clarify-theme-tokens-colors-accent": resolveThemeColorValue(colors.accent, resolvedTheme),
+		"--clarify-theme-tokens-colors-background": resolveThemeColorValue(colors.background, resolvedTheme),
+		"--clarify-theme-tokens-colors-foreground": resolveThemeColorValue(colors.foreground, resolvedTheme),
+		"--clarify-theme-tokens-colors-surface": resolveThemeColorValue(colors.surface, resolvedTheme),
+		"--clarify-theme-tokens-colors-muted": resolveThemeColorValue(colors.muted, resolvedTheme),
+		"--clarify-theme-tokens-colors-border": resolveThemeColorValue(colors.border, resolvedTheme),
+		"--clarify-theme-tokens-colors-code-background": resolveThemeColorValue(colors.codeBackground, resolvedTheme),
+		"--clarify-theme-tokens-radius-sm": radius.sm,
+		"--clarify-theme-tokens-radius-md": radius.md,
+		"--clarify-theme-tokens-radius-lg": radius.lg,
+		"--clarify-theme-tokens-radius-xl": radius.xl,
+		"--clarify-theme-layout-max-width": resolved.layout.maxWidth
+	};
+}
+function themeBootstrapScript(theme) {
+	const darkVariables = themeToCssVariables(theme, "dark");
+	const lightVariables = themeToCssVariables(theme, "light");
+	return `(function(){try{var e=localStorage.getItem(${JSON.stringify(THEME_STORAGE_KEY)});var t=e==='dark'||e==='light'||e==='system'?e:'system';var r=t==='system'?window.matchMedia('(prefers-color-scheme: dark)').matches:t==='dark';var v=r?${JSON.stringify(darkVariables)}:${JSON.stringify(lightVariables)};var s=document.documentElement.style;for(var k in v)s.setProperty(k,v[k]);document.documentElement.classList.toggle('dark',r);document.documentElement.style.colorScheme=r?'dark':'light'}catch(e){}})();`;
+}
 function createHtmlShellPlugin() {
 	return {
 		name: "clarify:html-shell",
@@ -302,7 +430,7 @@ function createHtmlShellPlugin() {
 				...REL_ICON_RE.test(input.html) ? [] : createIconTags(ctx.projectConfig.favicon ?? ctx.projectConfig.logo),
 				{
 					tag: "script",
-					children: THEME_BOOTSTRAP_SCRIPT,
+					children: themeBootstrapScript(ctx.projectConfig.theme),
 					injectTo: "head-prepend"
 				},
 				{
@@ -385,13 +513,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, "/");
@@ -445,6 +574,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) {
@@ -476,11 +617,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
@@ -494,6 +637,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);
@@ -514,9 +692,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,
@@ -526,10 +704,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
@@ -558,13 +736,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
@@ -729,8 +907,10 @@ function generateRoutesModule(routes, resolvedNavigation, projectConfig, mode =
 	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 createRuntimeModule() {
-	return "export const openApis = {};";
+function createRuntimeModule(options = {}) {
+	return `${options.footerComponentSource === "path" && options.imports?.footerComponent ? `import FooterComponent from ${moduleSpecifier(options.imports.footerComponent)};` : ""}
+export const openApis = {};
+export const footerComponent = ${options.footerComponentSource === "path" ? "FooterComponent" : "undefined"};`;
 }
 function createClientEntryModule(options = {}) {
 	return `
@@ -738,16 +918,22 @@ import '@clarify-labs/renderer/style.css';
 import { render } from '@clarify-labs/renderer/client';
 import { routes, navigation } from '${VIRTUAL_ROUTES}';
 import { config } from '${VIRTUAL_CONFIG}';
-import { openApis } from '${VIRTUAL_RUNTIME}';
-render({ config, routes, navigation, openApis, themeEditor: ${JSON.stringify(options.themeEditor ?? false)} });`;
+import { openApis, footerComponent } from '${VIRTUAL_RUNTIME}';
+render({ config, routes, navigation, openApis, footerComponent, themeEditor: ${JSON.stringify(options.themeEditor ?? false)} });`;
 }
 function buildVirtualModules(args) {
 	const modules = /* @__PURE__ */ new Map();
 	const clientEntryModule = createClientEntryModule({ themeEditor: args.themeEditor });
+	const footerComponent = args.projectConfig.footer;
+	const footerComponentSource = typeof footerComponent === "string" ? "path" : void 0;
+	const footerComponentImport = typeof footerComponent === "string" ? footerComponent : void 0;
 	modules.set(VIRTUAL_CONFIG, generateConfigModule(args.projectConfig, args.generateOptions));
 	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_RUNTIME, createRuntimeModule());
+	modules.set(VIRTUAL_RUNTIME, createRuntimeModule({
+		footerComponentSource,
+		imports: { footerComponent: footerComponentImport }
+	}));
 	modules.set(VIRTUAL_CLIENT_ENTRY, clientEntryModule);
 	modules.set(RESOLVED_CLIENT_ENTRY, clientEntryModule);
 	for (const route of args.routes) modules.set(route.virtualModuleId, `export { default } from ${moduleSpecifier(route.filePath)};`);
@@ -756,8 +942,12 @@ function buildVirtualModules(args) {
 //#endregion
 //#region source/plugins/openapi/virtual-modules.ts
 var openApiRegistryModuleId = VIRTUAL_RUNTIME;
-function generateOpenAPIRegistryModule(openApis) {
-	return `export const openApis = ${JSON.stringify(openApis)};`;
+function generateOpenAPIRegistryModule(openApis, runtimeModule = "") {
+	const openApisExport = `export const openApis = ${JSON.stringify(openApis)};`;
+	const openApisPlaceholder = /export const openApis = \{\};?/;
+	if (!runtimeModule) return openApisExport;
+	if (openApisPlaceholder.test(runtimeModule)) return runtimeModule.replace(openApisPlaceholder, openApisExport);
+	return runtimeModule;
 }
 function generateOpenAPIModule(spec, tagFilter) {
 	return `import { createElement } from 'react';
@@ -795,7 +985,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;
@@ -812,28 +1002,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
 			});
 		}
 	}
@@ -851,7 +1044,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);
@@ -882,7 +1075,7 @@ function createOpenAPIPlugin() {
 				return nextRoutes;
 			},
 			"modules:before": (modules, ctx) => {
-				modules.set(openApiRegistryModuleId, generateOpenAPIRegistryModule(Object.fromEntries(Object.entries(specs).map(([moduleId, entry]) => [moduleId, entry.spec]))));
+				modules.set(openApiRegistryModuleId, generateOpenAPIRegistryModule(Object.fromEntries(Object.entries(specs).map(([moduleId, entry]) => [moduleId, entry.spec])), modules.get(openApiRegistryModuleId)));
 				for (const [moduleId, entry] of Object.entries(specs)) modules.set(moduleId, generateOpenAPIModule(entry.spec, entry.tagFilter));
 				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;
@@ -891,6 +1084,180 @@ function createOpenAPIPlugin() {
 	};
 }
 //#endregion
+//#region source/core/search-language.ts
+function toPagefindLanguage(locale) {
+	return locale?.trim().replace(/_/g, "-").split("-").filter(Boolean).join("-").toLowerCase() || "en";
+}
+//#endregion
+//#region source/core/temp-dir.ts
+function createClarifyTempDir(name) {
+	return (0, node_fs.mkdtempSync)((0, node_path.join)((0, node_os.tmpdir)(), `clarify-${name}-`));
+}
+function removeClarifyTempDir(path) {
+	if (!path) return;
+	(0, node_fs.rmSync)(path, {
+		recursive: true,
+		force: true
+	});
+}
+//#endregion
+//#region source/plugins/search-index/index.ts
+var pagefindContentTypes = {
+	".css": "text/css; charset=utf-8",
+	".js": "text/javascript; charset=utf-8",
+	".json": "application/json; charset=utf-8",
+	".wasm": "application/wasm"
+};
+function assertNoPagefindErrors(action, errors) {
+	if (!errors?.length) return;
+	throw new Error(`[clarify] Pagefind ${action} failed:\n${errors.join("\n")}`);
+}
+async function generatePagefindIndex(options) {
+	const pagefind = await import("pagefind");
+	const { errors, index } = await pagefind.createIndex({
+		excludeSelectors: [
+			"[data-pagefind-ignore]",
+			"script",
+			"style",
+			"svg"
+		],
+		includeCharacters: "._-/#:@",
+		keepIndexUrl: false,
+		verbose: false,
+		writePlayground: false
+	});
+	assertNoPagefindErrors("createIndex", errors);
+	if (!index) throw new Error("[clarify] Pagefind did not create an index.");
+	try {
+		const addResult = await index.addDirectory({
+			path: options.sourceRoot ?? options.outputRoot,
+			glob: "**/*.html"
+		});
+		assertNoPagefindErrors("addDirectory", addResult.errors);
+		assertNoPagefindErrors("writeFiles", (await index.writeFiles({ outputPath: (0, node_path.join)(options.outputRoot, "pagefind") })).errors);
+		return addResult.page_count;
+	} finally {
+		await index.deleteIndex();
+		await pagefind.close();
+	}
+}
+function routeSearchContent(route) {
+	return [
+		route.title,
+		route.description,
+		route.keywords?.join(" "),
+		route.sections?.map((section) => section.title).join(" "),
+		route.content
+	].filter(Boolean).join("\n\n");
+}
+async function generateDevSearchIndex(ctx, root) {
+	const pagefind = await import("pagefind");
+	const { errors, index } = await pagefind.createIndex({
+		includeCharacters: "._-/#:@",
+		keepIndexUrl: false,
+		verbose: false,
+		writePlayground: false
+	});
+	assertNoPagefindErrors("createIndex", errors);
+	if (!index) throw new Error("[clarify] Pagefind did not create an index.");
+	try {
+		let pageCount = 0;
+		for (const route of ctx.routes) {
+			const content = routeSearchContent(route);
+			if (!content.trim()) continue;
+			const result = await index.addCustomRecord({
+				url: route.path,
+				content,
+				language: toPagefindLanguage(route.locale ?? ctx.projectConfig.i18n?.defaultLocale),
+				meta: { title: route.title }
+			});
+			assertNoPagefindErrors(`addCustomRecord ${route.path}`, result.errors);
+			pageCount += 1;
+		}
+		assertNoPagefindErrors("writeFiles", (await index.writeFiles({ outputPath: (0, node_path.join)(root, "pagefind") })).errors);
+		console.log(`[clarify] Dev search index generated for ${pageCount} pages.`);
+	} finally {
+		await index.deleteIndex();
+		await pagefind.close();
+	}
+}
+function normalizeDevPagefindPath(rawUrl, routePrefix) {
+	const pathname = rawUrl?.split("?")[0];
+	if (!pathname) return void 0;
+	const normalizedPrefix = routePrefix && routePrefix !== "/" ? `/${routePrefix.replace(/^\/+|\/+$/g, "")}` : "";
+	const pagefindPath = normalizedPrefix && pathname.startsWith(`${normalizedPrefix}/pagefind/`) ? pathname.slice(normalizedPrefix.length) : pathname;
+	return pagefindPath.startsWith("/pagefind/") ? pagefindPath : void 0;
+}
+function serveDevPagefind(server, getRoot, ctx) {
+	server.middlewares.use((req, res, next) => {
+		const root = getRoot();
+		const pagefindPath = normalizeDevPagefindPath(req.url, ctx.projectConfig.routePrefix);
+		if (!root || !pagefindPath) {
+			next();
+			return;
+		}
+		const filePath = (0, node_path.join)(root, pagefindPath);
+		const relativePath = (0, node_path.relative)(root, filePath);
+		if (relativePath.startsWith("..") || relativePath === "" || !(0, node_fs.existsSync)(filePath)) {
+			next();
+			return;
+		}
+		const contentType = pagefindContentTypes[(0, node_path.extname)(filePath)] ?? "application/octet-stream";
+		res.setHeader("Content-Type", contentType);
+		(0, node_fs.createReadStream)(filePath).pipe(res);
+	});
+}
+function createSearchIndexPlugin() {
+	return {
+		name: "clarify:search-index",
+		hooks: {
+			async "dev:configureServer"(server, ctx) {
+				let currentRoot;
+				const staleRoots = /* @__PURE__ */ new Set();
+				const replaceDevIndex = async () => {
+					const nextRoot = createClarifyTempDir("pagefind");
+					await generateDevSearchIndex(ctx, nextRoot);
+					const previousRoot = currentRoot;
+					currentRoot = nextRoot;
+					if (previousRoot) {
+						staleRoots.add(previousRoot);
+						setTimeout(() => {
+							staleRoots.delete(previousRoot);
+							removeClarifyTempDir(previousRoot);
+						}, 3e4).unref?.();
+					}
+				};
+				serveDevPagefind(server, () => currentRoot, ctx);
+				await replaceDevIndex();
+				let regenerateTimer;
+				const regenerate = (filePath) => {
+					if (!/\.(md|mdx|json|ya?ml)$/i.test(filePath)) return;
+					if (regenerateTimer) clearTimeout(regenerateTimer);
+					regenerateTimer = setTimeout(() => {
+						replaceDevIndex().catch((err) => {
+							console.error("[clarify] Failed to regenerate dev search index:", err);
+						});
+					}, 100);
+				};
+				server.watcher.on("add", regenerate);
+				server.watcher.on("change", regenerate);
+				server.watcher.on("unlink", regenerate);
+				server.httpServer?.once("close", () => {
+					if (regenerateTimer) clearTimeout(regenerateTimer);
+					removeClarifyTempDir(currentRoot);
+					for (const staleRoot of staleRoots) removeClarifyTempDir(staleRoot);
+				});
+			},
+			async "build:done"(ctx) {
+				const outputDirectory = ctx.generateOptions.outputDirectory;
+				if (!outputDirectory) return;
+				const pageCount = await generatePagefindIndex({ outputRoot: (0, node_path.resolve)(ctx.generateOptions.projectRoot, outputDirectory) });
+				console.log(`[clarify] Search index generated for ${pageCount} pages.`);
+			}
+		}
+	};
+}
+//#endregion
 //#region source/plugins/seo/artifacts.ts
 function trimTrailingSlash(value) {
 	return value.replace(/\/+$/, "");
@@ -986,7 +1353,8 @@ function createBuiltinPlugins(options = {}) {
 		createOpenAPIPlugin(),
 		createSourceLinksPlugin(),
 		createContentArtifactsPlugin(),
-		createSeoPlugin()
+		createSeoPlugin(),
+		createSearchIndexPlugin()
 	];
 	if (options.htmlShell ?? true) plugins.push(createHtmlShellPlugin());
 	return plugins;
@@ -1044,11 +1412,12 @@ var clarifyBannerConfigSchema = zod.z.object({
 	content: clarifyLocalizedTextSchema,
 	dismissible: zod.z.boolean().optional()
 });
-var clarifyFooterConfigSchema = zod.z.object({
+var clarifyFooterLinksConfigSchema = zod.z.object({
 	links: zod.z.array(clarifyNavbarLinkSchema).optional(),
 	socials: zod.z.record(zod.z.string(), zod.z.string()).optional(),
 	copyright: clarifyLocalizedTextSchema.optional()
-});
+}).strict();
+var clarifyFooterConfigSchema = zod.z.union([clarifyFooterLinksConfigSchema, zod.z.string()]);
 var clarifySourceConfigSchema = zod.z.object({
 	repository: zod.z.string(),
 	branch: zod.z.string().optional(),
@@ -1058,12 +1427,14 @@ 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()
@@ -1130,78 +1501,6 @@ var clarifyProjectConfigSchema = zod.z.object({
 	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) => {
@@ -1368,6 +1667,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,
@@ -1494,13 +1794,13 @@ function routeOutputFiles(outputDirectory, route) {
 var SSR_ENTRY_CODE = `import { renderToHTML } from '@clarify-labs/renderer/server';
 import { routes, navigation } from 'virtual:clarify-routes/server';
 import { config } from 'virtual:clarify-config';
-import { openApis } from 'virtual:clarify-runtime';
+import { openApis, footerComponent } from 'virtual:clarify-runtime';
 
 export function render(url) {
-  return renderToHTML({ config, routes, navigation, openApis, url, themeEditor: config.theme.editor });
+  return renderToHTML({ config, routes, navigation, openApis, footerComponent, url, themeEditor: config.theme.editor });
 }`;
 function createTempEntryFile(content) {
-	const entryPath = (0, node_path.join)((0, node_fs.mkdtempSync)((0, node_path.join)((0, node_os.tmpdir)(), "clarify-ssr-")), "entry-server.ts");
+	const entryPath = (0, node_path.join)(createClarifyTempDir("ssr"), "entry-server.ts");
 	(0, node_fs.writeFileSync)(entryPath, content, "utf-8");
 	return entryPath;
 }
@@ -1540,6 +1840,7 @@ async function renderSSGRoutes(routes, projectConfig, outputDirectory, ssrBundle
 //#endregion
 //#region source/core/user-config.ts
 function defineConfig(config) {
+	validateProjectConfig(config);
 	return config;
 }
 var CONFIG_FILENAMES = [
@@ -1802,6 +2103,12 @@ Object.defineProperty(exports, "createClarifyRuntimeAliases", {
 		return createClarifyRuntimeAliases;
 	}
 });
+Object.defineProperty(exports, "createClarifyTempDir", {
+	enumerable: true,
+	get: function() {
+		return createClarifyTempDir;
+	}
+});
 Object.defineProperty(exports, "defineConfig", {
 	enumerable: true,
 	get: function() {
@@ -1821,4 +2128,4 @@ Object.defineProperty(exports, "resolveClarifySite", {
 	}
 });
 
-//# sourceMappingURL=plugin-GTN_SQ7d.cjs.map
+//# sourceMappingURL=plugin-dzXRzjdX.cjs.map