@clarify-labs/cli 0.6.7 → 0.7.1

package/output/{plugin-Cx9lFenc.js → plugin-o1rP_gts.js}

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
+import { createReadStream, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, extname, isAbsolute, join, relative, resolve } from "node:path";
 import mdxPlugin from "@mdx-js/rollup";
 import tailwindcss from "@tailwindcss/vite";
@@ -7,13 +7,13 @@ import GithubSlugger, { slug } from "github-slugger";
 import { toString } from "mdast-util-to-string";
 import shiki from "shiki";
 import { visit } from "unist-util-visit";
-import { markdownRemarkPlugins } from "@clarify-labs/renderer";
+import { markdownRemarkPlugins, themeBootstrapScript, themePresets } from "@clarify-labs/renderer";
 import { remark } from "remark";
 import matter from "gray-matter";
 import SwaggerParser from "@apidevtools/swagger-parser";
+import { tmpdir } from "node:os";
 import { mkdir, writeFile } from "node:fs/promises";
 import { z } from "zod";
-import { tmpdir } from "node:os";
 import { pathToFileURL } from "node:url";
 import { build, loadConfigFromFile } from "vite";
 import { createRequire } from "node:module";
@@ -233,7 +233,6 @@ function createContentArtifactsPlugin() {
 }
 //#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 REL_ICON_RE = /<link\s+[^>]*rel=["'][^"']*\bicon\b[^"']*["'][^>]*>/i;
 function inferIconType(href) {
 	const path = href.split(/[?#]/, 1)[0]?.toLowerCase() ?? href.toLowerCase();
@@ -273,7 +272,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"
 				},
 				{
@@ -338,6 +337,7 @@ function navigationSections(sections) {
 	return sections.map((s) => ({
 		id: s.id,
 		title: s.title,
+		level: s.level,
 		badge: s.badge,
 		tags: s.tags
 	}));
@@ -732,6 +732,7 @@ function generateRoutesModule(routes, resolvedNavigation, projectConfig, mode =
 		const sections = r.sections && r.sections.length > 0 ? `, sections: ${JSON.stringify(r.sections.map((s) => ({
 			id: s.id,
 			title: s.title,
+			level: s.level,
 			badge: s.badge,
 			tags: s.tags
 		})))}` : "";
@@ -750,8 +751,12 @@ 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 = {}) {
+	const imports = [options.bannerComponentSource === "path" && options.imports?.bannerComponent ? `import BannerComponent from ${moduleSpecifier(options.imports.bannerComponent)};` : void 0, options.footerComponentSource === "path" && options.imports?.footerComponent ? `import FooterComponent from ${moduleSpecifier(options.imports.footerComponent)};` : void 0].filter(Boolean).join("\n");
+	const exports = `export const openApis = {};
+export const bannerComponent = ${options.bannerComponentSource === "path" ? "BannerComponent" : "undefined"};
+export const footerComponent = ${options.footerComponentSource === "path" ? "FooterComponent" : "undefined"};`;
+	return imports ? `${imports}\n${exports}` : exports;
 }
 function createClientEntryModule(options = {}) {
 	return `
@@ -759,16 +764,29 @@ 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, bannerComponent, footerComponent } from '${VIRTUAL_RUNTIME}';
+render({ config, routes, navigation, openApis, bannerComponent, footerComponent, themeEditor: ${JSON.stringify(options.themeEditor ?? false)} });`;
 }
 function buildVirtualModules(args) {
 	const modules = /* @__PURE__ */ new Map();
 	const clientEntryModule = createClientEntryModule({ themeEditor: args.themeEditor });
+	const bannerComponent = args.projectConfig.banner;
+	const bannerComponentSource = typeof bannerComponent === "string" ? "path" : void 0;
+	const bannerComponentImport = typeof bannerComponent === "string" ? bannerComponent : void 0;
+	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({
+		bannerComponentSource,
+		footerComponentSource,
+		imports: {
+			bannerComponent: bannerComponentImport,
+			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)};`);
@@ -777,8 +795,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';
@@ -906,7 +928,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;
@@ -915,6 +937,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 mkdtempSync(join(tmpdir(), `clarify-${name}-`));
+}
+function removeClarifyTempDir(path) {
+	if (!path) return;
+	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: 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: 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 = join(root, pagefindPath);
+		const relativePath = relative(root, filePath);
+		if (relativePath.startsWith("..") || relativePath === "" || !existsSync(filePath)) {
+			next();
+			return;
+		}
+		const contentType = pagefindContentTypes[extname(filePath)] ?? "application/octet-stream";
+		res.setHeader("Content-Type", contentType);
+		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: 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(/\/+$/, "");
@@ -1010,7 +1206,8 @@ function createBuiltinPlugins(options = {}) {
 		createOpenAPIPlugin(),
 		createSourceLinksPlugin(),
 		createContentArtifactsPlugin(),
-		createSeoPlugin()
+		createSeoPlugin(),
+		createSearchIndexPlugin()
 	];
 	if (options.htmlShell ?? true) plugins.push(createHtmlShellPlugin());
 	return plugins;
@@ -1064,15 +1261,18 @@ var clarifyNavbarLinkSchema = z.object({
 	href: z.string(),
 	external: z.boolean().optional()
 });
-var clarifyBannerConfigSchema = z.object({
+var clarifyBannerConfigOptionsSchema = z.object({
 	content: clarifyLocalizedTextSchema,
-	dismissible: z.boolean().optional()
-});
-var clarifyFooterConfigSchema = z.object({
+	dismissible: z.boolean().optional(),
+	link: clarifyNavbarLinkSchema.optional()
+}).strict();
+var clarifyBannerConfigSchema = z.union([clarifyBannerConfigOptionsSchema, z.string()]);
+var clarifyFooterLinksConfigSchema = z.object({
 	links: z.array(clarifyNavbarLinkSchema).optional(),
 	socials: z.record(z.string(), z.string()).optional(),
 	copyright: clarifyLocalizedTextSchema.optional()
-});
+}).strict();
+var clarifyFooterConfigSchema = z.union([clarifyFooterLinksConfigSchema, z.string()]);
 var clarifySourceConfigSchema = z.object({
 	repository: z.string(),
 	branch: z.string().optional(),
@@ -1146,6 +1346,7 @@ var clarifyProjectConfigSchema = z.object({
 	siteUrl: z.string().optional(),
 	source: clarifySourceConfigSchema.optional(),
 	logo: clarifyLogoConfigSchema.optional(),
+	homeUrl: z.string().optional(),
 	favicon: clarifyFaviconConfigSchema.optional(),
 	theme: clarifyThemeConfigSchema.optional(),
 	routePrefix: z.string().optional(),
@@ -1157,57 +1358,9 @@ var clarifyProjectConfigSchema = z.object({
 });
 //#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];
+	const presetTheme = themePresets[preset];
 	return {
 		preset,
 		tokens: {
@@ -1266,6 +1419,7 @@ function resolveProjectConfig(config = {}) {
 		siteUrl: config.siteUrl,
 		source: config.source,
 		logo: config.logo,
+		homeUrl: config.homeUrl,
 		favicon: config.favicon,
 		routePrefix: config.routePrefix ?? "/",
 		theme: resolveThemeConfig(config.theme),
@@ -1521,13 +1675,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, bannerComponent, 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, bannerComponent, footerComponent, url, themeEditor: config.theme.editor });
 }`;
 function createTempEntryFile(content) {
-	const entryPath = join(mkdtempSync(join(tmpdir(), "clarify-ssr-")), "entry-server.ts");
+	const entryPath = join(createClarifyTempDir("ssr"), "entry-server.ts");
 	writeFileSync(entryPath, content, "utf-8");
 	return entryPath;
 }
@@ -1567,6 +1721,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 = [
@@ -1817,6 +1972,6 @@ function clarifyPlugin(options = {}) {
 	].flat().filter(Boolean);
 }
 //#endregion
-export { resolveClarifySite as a, createClarifyRuntimeAliases as i, defineConfig as n, loadClarifyConfig as r, clarifyPlugin as t };
+export { resolveClarifySite as a, createClarifyRuntimeAliases as i, defineConfig as n, createClarifyTempDir as o, loadClarifyConfig as r, clarifyPlugin as t };
 
-//# sourceMappingURL=plugin-Cx9lFenc.js.map
+//# sourceMappingURL=plugin-o1rP_gts.js.map