@clarify-labs/cli 0.11.10 → 0.11.13

package/output/{engine-DisWfZp-.js → engine-CTFNxQRw.js}

@@ -742,6 +742,8 @@ function buildNavigationFromConfig(routes, config) {
 				title: resolveLocalizedText(item.group, "", "") ?? "",
 				icon: item.icon,
 				layout: item.layout,
+				visible: item.visible,
+				searchable: item.searchable,
 				children
 			};
 		}
@@ -771,6 +773,8 @@ function buildNavigationFromConfig(routes, config) {
 			path: children[0]?.path ?? "/",
 			title: resolveLocalizedText(group.group, "", "") ?? "",
 			icon: group.icon,
+			visible: group.visible,
+			searchable: group.searchable,
 			children
 		};
 	});
@@ -796,6 +800,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
 			};
 		}
@@ -816,6 +822,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
 		};
 	});
@@ -1442,6 +1450,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;
@@ -1773,7 +1782,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: {
@@ -1896,6 +1905,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");
 }
@@ -1995,6 +2047,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) : 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);
@@ -2054,6 +2114,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: stringify(rootOpenAPISpec, { lineWidth: 0 })
+				});
 				return assets;
 			}
 		}
@@ -2281,7 +2349,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 {
@@ -2344,7 +2412,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);
@@ -2797,7 +2865,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_${createHash("sha256").update(JSON.stringify(tagFilter)).digest("hex").slice(0, 12)}`;
 }
 function openAPIRegistryKeys(route) {
 	const keys = /* @__PURE__ */ new Set();
@@ -2974,7 +3042,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({
@@ -3434,6 +3502,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);
@@ -3441,10 +3541,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
@@ -3556,7 +3657,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;
 }
@@ -4065,7 +4166,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 = join(outputDir, ".ssr");
+			const ssrOutputDir = createClarifyTempDir("ssr-output");
 			let tempEntryPath;
 			try {
 				tempEntryPath = createTempEntryFile(SSR_ENTRY_CODE);
@@ -4081,6 +4182,7 @@ var ClarifyEngine = class {
 				console.error("[clarify] SSG failed:", err);
 				throw err;
 			} finally {
+				removeClarifyTempDir(ssrOutputDir);
 				if (tempEntryPath) try {
 					rmSync(tempEntryPath, { force: true });
 				} catch {}
@@ -4123,4 +4225,4 @@ function createClarifyEngine(options = {}) {
 //#endregion
 export { createClarifyTempDir as a, cliPackageVersion as c, defineConfig as d, findRouteConflicts as i, cliPackageVersionWithCaret as l, createClarifyEngine as n, deserializeSearchIndex as o, createClarifyRuntimeAliases as r, searchMcpIndex as s, ClarifyEngine as t, createViteAdapter as u };
 
-//# sourceMappingURL=engine-DisWfZp-.js.map
+//# sourceMappingURL=engine-CTFNxQRw.js.map