@clarify-labs/cli 0.11.11 → 0.11.14

package/output/{engine-BzxBO-E9.cjs → engine-CkWY8FUi.cjs}

@@ -773,6 +773,8 @@ function buildNavigationFromConfig(routes, config) {
 				title: resolveLocalizedText(item.group, "", "") ?? "",
 				icon: item.icon,
 				layout: item.layout,
+				visible: item.visible,
+				searchable: item.searchable,
 				children
 			};
 		}
@@ -802,6 +804,8 @@ function buildNavigationFromConfig(routes, config) {
 			path: children[0]?.path ?? "/",
 			title: resolveLocalizedText(group.group, "", "") ?? "",
 			icon: group.icon,
+			visible: group.visible,
+			searchable: group.searchable,
 			children
 		};
 	});
@@ -827,6 +831,8 @@ function buildLocalizedNavigationForLocale(routes, config, locale, locales) {
 				title: resolveLocalizedText(item.group, locale, locales.default) ?? "",
 				icon: item.icon,
 				layout: item.layout,
+				visible: item.visible,
+				searchable: item.searchable,
 				children
 			};
 		}
@@ -847,6 +853,8 @@ function buildLocalizedNavigationForLocale(routes, config, locale, locales) {
 			path: children[0]?.path ?? localizedRoutePath("/", locale, locales),
 			title: resolveLocalizedText(group.group, locale, locales.default) ?? "",
 			icon: group.icon,
+			visible: group.visible,
+			searchable: group.searchable,
 			children
 		};
 	});
@@ -1141,12 +1149,19 @@ var clarifyPagesItemSchema = zod.z.lazy(() => zod.z.union([
 		filter: zod.z.object({ tags: zod.z.array(zod.z.string()).optional() }).strict().optional()
 	}).strict()
 ]));
-var clarifyPagesGroupSchema = zod.z.lazy(() => zod.z.object({
+var clarifyPagesGroupShape = {
 	group: clarifyLocalizedTextSchema,
 	icon: zod.z.string().optional(),
+	visible: zod.z.enum([
+		"always",
+		"active",
+		"never"
+	]).optional(),
+	searchable: zod.z.boolean().optional(),
 	layout: zod.z.enum(["documentation", "blog"]).optional(),
 	pages: zod.z.array(clarifyPagesItemSchema)
-}).strict());
+};
+var clarifyPagesGroupSchema = zod.z.lazy(() => zod.z.object(clarifyPagesGroupShape).strict());
 var clarifyPagesConfigSchema = zod.z.union([zod.z.array(clarifyPagesGroupSchema), zod.z.literal("FileTree")]);
 var clarifyTabItemSchema = zod.z.object({
 	tab: clarifyLocalizedTextSchema,
@@ -1473,6 +1488,7 @@ function routeToRuntimeManifestEntry(route, component, mode) {
 	if (route.locale) entry.locale = route.locale;
 	if (route.isFallback) entry.isFallback = true;
 	if (route.isBareAlias) entry.isBareAlias = true;
+	if (route.searchable === false) entry.searchable = false;
 	if (route.alternates) entry.alternates = route.alternates;
 	if (route.meta.description) entry.description = route.meta.description;
 	if (route.meta.keywords?.length) entry.keywords = route.meta.keywords;
@@ -1804,7 +1820,7 @@ function createViteAdapter(engine) {
 }
 var cliPackageVersion = {
 	name: "@clarify-labs/cli",
-	version: "0.11.11",
+	version: "0.11.14",
 	license: "AGPL-3.0-only",
 	type: "module",
 	repository: {
@@ -1880,6 +1896,9 @@ var cliPackageVersion = {
 	}
 }.version ?? "0.0.0";
 var cliPackageVersionWithCaret = `^${cliPackageVersion}`;
+function printCliVersion() {
+	console.error(`[clarify] v${cliPackageVersion}`);
+}
 //#endregion
 //#region source/core/config/options.ts
 function resolveBuildOptions(options = {}) {
@@ -1927,6 +1946,49 @@ function readRouteArtifactContent(route) {
 	const content = readRouteContent(route);
 	return shouldUseUtf8Signature(route) ? withUtf8Signature(content) : content;
 }
+function mergeOpenAPIRecord(target, source, section, filePath) {
+	if (!source) return;
+	for (const [key, value] of Object.entries(source)) {
+		const existing = target[key];
+		if (existing !== void 0 && JSON.stringify(existing) !== JSON.stringify(value)) throw new Error(`[clarify] Cannot aggregate OpenAPI specs: conflicting ${section} entry "${key}" in ${filePath}.`);
+		target[key] = value;
+	}
+}
+function createRootOpenAPISpec(routes, projectConfig) {
+	const paths = {};
+	const webhooks = {};
+	const components = {};
+	const tags = /* @__PURE__ */ new Map();
+	const defaultLocale = projectConfig.locales?.default;
+	for (const route of routes) {
+		if (route.kind !== "openapi" || route.diagnostic || !route.source.content || defaultLocale && route.locale && route.locale !== defaultLocale) continue;
+		const filePath = route.source.filePath;
+		const spec = JSON.parse(route.source.content);
+		mergeOpenAPIRecord(paths, spec.paths, "paths", filePath);
+		mergeOpenAPIRecord(webhooks, "webhooks" in spec ? spec.webhooks : void 0, "webhooks", filePath);
+		for (const [section, entries] of Object.entries(spec.components ?? {})) {
+			components[section] ??= {};
+			mergeOpenAPIRecord(components[section], entries, `components.${section}`, filePath);
+		}
+		for (const tag of spec.tags ?? []) {
+			const existing = tags.get(tag.name);
+			if (existing !== void 0 && JSON.stringify(existing) !== JSON.stringify(tag)) throw new Error(`[clarify] Cannot aggregate OpenAPI specs: conflicting tag "${tag.name}" in ${filePath}.`);
+			tags.set(tag.name, tag);
+		}
+	}
+	return {
+		openapi: "3.1.0",
+		info: {
+			title: projectConfig.title,
+			description: projectConfig.description,
+			version: "1.0.0"
+		},
+		paths,
+		...Object.keys(webhooks).length > 0 ? { webhooks } : {},
+		...Object.keys(components).length > 0 ? { components } : {},
+		...tags.size > 0 ? { tags: [...tags.values()] } : {}
+	};
+}
 function isLlmsTxtRoute(route) {
 	return !route.path.split("/").includes("404");
 }
@@ -2026,6 +2088,14 @@ function serveContentArtifacts(req, res, projectConfig, routes) {
 		res.end(createLlmsTxtArtifact(routes, projectConfig), "utf8");
 		return true;
 	}
+	if (contentPath === "/openapi.json" || contentPath === "/openapi.yml") {
+		const spec = createRootOpenAPISpec(routes, projectConfig);
+		const isJson = contentPath.endsWith(".json");
+		res.statusCode = 200;
+		res.setHeader("Content-Type", isJson ? "application/json; charset=utf-8" : "text/yaml; charset=utf-8");
+		res.end(isJson ? JSON.stringify(spec, null, 2) : (0, yaml.stringify)(spec, { lineWidth: 0 }), "utf8");
+		return true;
+	}
 	if (contentPath.endsWith(".openapi.yaml")) {
 		const jsonPath = contentPath.replace(/\.yaml$/, ".json");
 		const route = routes.find((route) => route.artifacts?.contentArtifactUrl === jsonPath);
@@ -2085,6 +2155,14 @@ function createContentArtifactsPlugin() {
 					fileName: "llms.txt",
 					source: createLlmsTxtArtifact(ctx.routes, ctx.projectConfig)
 				});
+				const rootOpenAPISpec = createRootOpenAPISpec(ctx.routes, ctx.projectConfig);
+				assets.push({
+					fileName: "openapi.json",
+					source: JSON.stringify(rootOpenAPISpec, null, 2)
+				}, {
+					fileName: "openapi.yml",
+					source: (0, yaml.stringify)(rootOpenAPISpec, { lineWidth: 0 })
+				});
 				return assets;
 			}
 		}
@@ -2312,7 +2390,7 @@ function routeSearchContent(route) {
 * Convert a `ContentRoute` into the document shape stored in the Orama index.
 */
 function routeToSearchDocument(route, defaultLocale) {
-	if (route.isBareAlias) return null;
+	if (route.isBareAlias || route.searchable === false) return null;
 	const content = routeSearchContent(route);
 	if (!content.trim()) return null;
 	return {
@@ -2375,7 +2453,7 @@ function collectIndexedLocales(routes, defaultLocale) {
 	const seen = /* @__PURE__ */ new Set();
 	const locales = [];
 	for (const route of routes) {
-		if (route.isBareAlias) continue;
+		if (route.isBareAlias || route.searchable === false) continue;
 		const code = route.locale ?? defaultLocale ?? "en";
 		if (!seen.has(code)) {
 			seen.add(code);
@@ -3005,7 +3083,7 @@ async function generateDevSearchIndex(ctx, root, pagefind) {
 	try {
 		let pageCount = 0;
 		for (const route of ctx.routes) {
-			if (route.isBareAlias) continue;
+			if (route.isBareAlias || route.searchable === false) continue;
 			const content = routeSearchContent(route);
 			if (!content.trim()) continue;
 			const result = await index.addCustomRecord({
@@ -3465,6 +3543,38 @@ function handleRouteConflicts(routes, development) {
 	assertNoRouteConflicts(routes);
 	return routes;
 }
+function unsearchablePaths(navigation) {
+	const paths = /* @__PURE__ */ new Set();
+	const visit = (nodes, inherited = true) => {
+		for (const node of nodes) {
+			const searchable = inherited && node.searchable !== false;
+			if (!searchable) paths.add(node.path);
+			visit(node.children ?? [], searchable);
+		}
+	};
+	switch (navigation.kind) {
+		case "flat":
+			visit(navigation.nodes);
+			break;
+		case "tabbed":
+			navigation.tabs.forEach((tab) => visit(tab.children));
+			break;
+		case "localized":
+			Object.values(navigation.locales).forEach((nodes) => visit(nodes));
+			break;
+		case "localized-tabbed":
+			Object.values(navigation.locales).forEach((locale) => locale.tabs.forEach((tab) => visit(tab.children)));
+			break;
+	}
+	return paths;
+}
+function applySearchability(routes, navigation) {
+	const excludedPaths = unsearchablePaths(navigation);
+	return routes.map((route) => excludedPaths.has(route.path) ? {
+		...route,
+		searchable: false
+	} : route);
+}
 async function resolveRouteState(routes, plugins, ctx, development) {
 	const tabs = ctx.projectConfig.navigation?.tabs;
 	const configuredRoutes = applyConfiguredPageRoutePaths(routes, tabs, ctx.projectConfig.locales);
@@ -3472,10 +3582,11 @@ async function resolveRouteState(routes, plugins, ctx, development) {
 		routes: configuredRoutes,
 		navigation: buildNavigationTree(configuredRoutes, ctx)
 	}, ctx);
-	const finalRoutes = handleRouteConflicts(resolved.routes, development);
+	const conflictRoutes = handleRouteConflicts(resolved.routes, development);
+	const finalNavigation = conflictRoutes === resolved.routes ? resolved.navigation : buildNavigationTree(conflictRoutes, ctx);
 	return {
-		routes: finalRoutes,
-		navigation: finalRoutes === resolved.routes ? resolved.navigation : buildNavigationTree(finalRoutes, ctx)
+		routes: applySearchability(conflictRoutes, finalNavigation),
+		navigation: finalNavigation
 	};
 }
 //#endregion
@@ -3587,7 +3698,7 @@ function injectSSRIntoTemplate(template, appHtml, contextOrConfig, route) {
 	html = setNamedMeta(html, "description", route?.meta.description ?? projectConfig.description);
 	html = setNamedMeta(html, "keywords", route?.meta.keywords?.join(", "));
 	html = injectCanonicalUrl(html, contextOrConfig, route);
-	const dataPagefindIgnore = route?.isBareAlias ? " data-pagefind-ignore" : "";
+	const dataPagefindIgnore = route?.isBareAlias || route?.searchable === false ? " data-pagefind-ignore" : "";
 	html = html.replace(/<div id="root">([\s\S]*?)<\/div>/, `<div id="root"${dataPagefindIgnore}>${appHtml}</div>`);
 	return html;
 }
@@ -4096,7 +4207,7 @@ var ClarifyEngine = class {
 			assertNoContentDiagnostics(this.routes);
 			const outputDir = this.runtime.outputDirectory ?? this.generateOptions.outputDirectory;
 			if (!outputDir) throw new Error("[clarify] outputDirectory is required before SSG runs");
-			const ssrOutputDir = (0, node_path.join)(outputDir, ".ssr");
+			const ssrOutputDir = createClarifyTempDir("ssr-output");
 			let tempEntryPath;
 			try {
 				tempEntryPath = createTempEntryFile(SSR_ENTRY_CODE);
@@ -4112,6 +4223,7 @@ var ClarifyEngine = class {
 				console.error("[clarify] SSG failed:", err);
 				throw err;
 			} finally {
+				removeClarifyTempDir(ssrOutputDir);
 				if (tempEntryPath) try {
 					(0, node_fs.rmSync)(tempEntryPath, { force: true });
 				} catch {}
@@ -4212,6 +4324,12 @@ Object.defineProperty(exports, "findRouteConflicts", {
 		return findRouteConflicts;
 	}
 });
+Object.defineProperty(exports, "printCliVersion", {
+	enumerable: true,
+	get: function() {
+		return printCliVersion;
+	}
+});
 Object.defineProperty(exports, "searchMcpIndex", {
 	enumerable: true,
 	get: function() {
@@ -4219,4 +4337,4 @@ Object.defineProperty(exports, "searchMcpIndex", {
 	}
 });
 
-//# sourceMappingURL=engine-BzxBO-E9.cjs.map
+//# sourceMappingURL=engine-CkWY8FUi.cjs.map