@clarify-labs/cli 0.11.10 → 0.11.13

package/output/cli.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const require_engine = require("./engine-BuYsLjJN.cjs");
+const require_engine = require("./engine--f7G04zS.cjs");
 let node_path = require("node:path");
 let node_fs_promises = require("node:fs/promises");
 let node_child_process = require("node:child_process");

package/output/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as createClarifyTempDir, c as cliPackageVersion, i as findRouteConflicts, l as cliPackageVersionWithCaret, n as createClarifyEngine, o as deserializeSearchIndex, r as createClarifyRuntimeAliases, s as searchMcpIndex, u as createViteAdapter } from "./engine-DisWfZp-.js";
+import { a as createClarifyTempDir, c as cliPackageVersion, i as findRouteConflicts, l as cliPackageVersionWithCaret, n as createClarifyEngine, o as deserializeSearchIndex, r as createClarifyRuntimeAliases, s as searchMcpIndex, u as createViteAdapter } from "./engine-CTFNxQRw.js";
 import { dirname, extname, isAbsolute, join, normalize, relative, resolve } from "node:path";
 import { lstat, mkdir, readFile, stat, writeFile } from "node:fs/promises";
 import { spawnSync } from "node:child_process";

package/output/{engine-BuYsLjJN.cjs → engine--f7G04zS.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
 		};
 	});
@@ -1473,6 +1481,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 +1813,7 @@ function createViteAdapter(engine) {
 }
 var cliPackageVersion = {
 	name: "@clarify-labs/cli",
-	version: "0.11.10",
+	version: "0.11.13",
 	license: "AGPL-3.0-only",
 	type: "module",
 	repository: {
@@ -1927,6 +1936,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 +2078,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 +2145,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 +2380,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 +2443,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);
@@ -2828,7 +2896,7 @@ function sourceSpecIdFromPath(filePath, projectRoot) {
 }
 function routeSpecModuleIdFromSourceSpecId(sourceSpecId, tagFilter) {
 	if (!tagFilter?.length) return sourceSpecId;
-	return `${sourceSpecId}_tags_${tagFilter.map((tag) => tag.replace(/[^a-zA-Z0-9_-]/g, "_").replace(/_+/g, "_").replace(/^_|_$/g, "") || "tag").join("_")}`;
+	return `${sourceSpecId}_tags_${(0, node_crypto.createHash)("sha256").update(JSON.stringify(tagFilter)).digest("hex").slice(0, 12)}`;
 }
 function openAPIRegistryKeys(route) {
 	const keys = /* @__PURE__ */ new Set();
@@ -3005,7 +3073,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 +3533,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 +3572,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 +3688,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 +4197,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 +4213,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 {}
@@ -4219,4 +4321,4 @@ Object.defineProperty(exports, "searchMcpIndex", {
 	}
 });
 
-//# sourceMappingURL=engine-BuYsLjJN.cjs.map
+//# sourceMappingURL=engine--f7G04zS.cjs.map