@clarify-labs/cli 0.11.9 → 0.11.10

package/output/cli.cjs

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
-const require_engine = require("./engine-Bupsozys.cjs");
+const require_engine = require("./engine-BuYsLjJN.cjs");
 let node_path = require("node:path");
 let node_fs_promises = require("node:fs/promises");
+let node_child_process = require("node:child_process");
 let node_fs = require("node:fs");
 let vite = require("vite");
 let zod = require("zod");
@@ -11,7 +12,6 @@ let node_os = require("node:os");
 let node_module = require("node:module");
 let cac = require("cac");
 let _clarify_labs_templates = require("@clarify-labs/templates");
-let node_child_process = require("node:child_process");
 let _modelcontextprotocol_sdk_server_mcp_js = require("@modelcontextprotocol/sdk/server/mcp.js");
 let _modelcontextprotocol_sdk_server_stdio_js = require("@modelcontextprotocol/sdk/server/stdio.js");
 //#region source/core/runtime/log.ts

package/output/cli.js

@@ -1,7 +1,8 @@
 #!/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-CdH3JL_y.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-DisWfZp-.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";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { build, createLogger, createServer } from "vite";
 import { z } from "zod";
@@ -11,7 +12,6 @@ import { homedir } from "node:os";
 import { createRequire } from "node:module";
 import { cac } from "cac";
 import { copyTemplateDirectory, getTemplateDirectory, resolveTemplate } from "@clarify-labs/templates";
-import { spawnSync } from "node:child_process";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 //#region source/core/runtime/log.ts

package/output/core/config/config-schema.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { ClarifyVariableValue } from '../../types.js';
+import { ClarifyNavbarMenuItem, ClarifyVariableValue } from '../../types.js';
 export declare const clarifyFeaturesConfigSchema: z.ZodObject<{
     search: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
@@ -126,11 +126,7 @@ export declare const clarifyProjectConfigSchema: z.ZodObject<{
         }>>;
     }, z.core.$strict>>;
     navigation: z.ZodOptional<z.ZodObject<{
-        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
-            href: z.ZodString;
-            external: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strict>>>;
+        menus: z.ZodOptional<z.ZodArray<z.ZodType<ClarifyNavbarMenuItem, unknown, z.core.$ZodTypeInternals<ClarifyNavbarMenuItem, unknown>>>>;
         tabs: z.ZodOptional<z.ZodArray<z.ZodObject<{
             tab: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
             icon: z.ZodOptional<z.ZodString>;
@@ -143,14 +139,12 @@ export declare const clarifyProjectConfigSchema: z.ZodObject<{
         link: z.ZodOptional<z.ZodObject<{
             label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
             href: z.ZodString;
-            external: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
     footer: z.ZodOptional<z.ZodObject<{
         links: z.ZodOptional<z.ZodArray<z.ZodObject<{
             label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
             href: z.ZodString;
-            external: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>>;
         socials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         copyright: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
@@ -158,11 +152,11 @@ export declare const clarifyProjectConfigSchema: z.ZodObject<{
     locales: z.ZodOptional<z.ZodObject<{
         default: z.ZodOptional<z.ZodString>;
         missing: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"fallback">, z.ZodLiteral<"404">, z.ZodLiteral<"hide">]>>;
-        locales: z.ZodArray<z.ZodObject<{
+        locales: z.ZodOptional<z.ZodArray<z.ZodObject<{
             code: z.ZodString;
             label: z.ZodString;
             dir: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"ltr">, z.ZodLiteral<"rtl">]>>;
-        }, z.core.$strict>>;
+        }, z.core.$strict>>>;
     }, z.core.$strict>>;
     variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<ClarifyVariableValue, unknown, z.core.$ZodTypeInternals<ClarifyVariableValue, unknown>>>>;
     features: z.ZodOptional<z.ZodObject<{

package/output/{engine-Bupsozys.cjs → engine-BuYsLjJN.cjs}

@@ -44,6 +44,7 @@ let mdast_util_to_string = require("mdast-util-to-string");
 let remark = require("remark");
 let gray_matter = require("gray-matter");
 gray_matter = __toESM(gray_matter, 1);
+let node_child_process = require("node:child_process");
 let node_fs = require("node:fs");
 let vite = require("vite");
 let zod = require("zod");
@@ -351,6 +352,42 @@ async function compileMarkdownContent(content, options = {}) {
 	}
 }
 //#endregion
+//#region source/parsers/routes/git-metadata.ts
+function normalizeDate(value) {
+	if (!value) return void 0;
+	const date = new Date(value);
+	return Number.isNaN(date.getTime()) ? void 0 : date.toISOString();
+}
+async function getFileUpdatedAt(filePath, contentRoot) {
+	try {
+		const result = (0, node_child_process.spawnSync)("git", [
+			"log",
+			"-1",
+			"--format=%cI",
+			"--",
+			(0, node_path.relative)(contentRoot, filePath)
+		], {
+			cwd: contentRoot,
+			encoding: "utf8",
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			]
+		});
+		const committedAt = normalizeDate(result.status === 0 ? result.stdout.trim() : void 0);
+		if (committedAt) return committedAt;
+	} catch {}
+	try {
+		return (await (0, node_fs_promises.stat)(filePath)).mtime.toISOString();
+	} catch {
+		return;
+	}
+}
+function resolveUpdatedAt(frontmatter, detectedAt) {
+	return normalizeDate(typeof frontmatter.updatedAt === "string" ? frontmatter.updatedAt : void 0) ?? detectedAt;
+}
+//#endregion
 //#region source/parsers/routes/routes.ts
 function kebabToTitle(str) {
 	return str.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
@@ -450,6 +487,7 @@ async function findContentRoutes(dir, base = dir, options = {}) {
 			const cleanPath = ("/" + pathParts.map((p) => p === "index" ? "" : p).filter(Boolean).join("/")).replace(/\/+/g, "/").replace(/\/$/, "") || "/";
 			const source = await (0, node_fs_promises.readFile)(fullPath, "utf-8");
 			const { frontmatter, content } = await (options.contentProcessor ?? createContentProcessor()).processMdx(source, fullPath);
+			const updatedAt = resolveUpdatedAt(frontmatter, await getFileUpdatedAt(fullPath, base));
 			const page = {
 				path: cleanPath,
 				filePath: fullPath,
@@ -470,6 +508,9 @@ async function findContentRoutes(dir, base = dir, options = {}) {
 					title,
 					description: typeof page.frontmatter.description === "string" ? page.frontmatter.description : void 0,
 					keywords: frontmatterKeywords(page.frontmatter),
+					group: typeof page.frontmatter.group === "string" ? page.frontmatter.group : void 0,
+					layout: page.frontmatter.layout === "documentation" || page.frontmatter.layout === "blog" ? page.frontmatter.layout : void 0,
+					updatedAt,
 					sections: extractMdxSections(page.content)
 				},
 				module: {
@@ -579,8 +620,15 @@ async function findLocalizedContentRoutes(contentRoot, locales, options = {}) {
 }
 function buildNavigation(routes) {
 	const root = [];
+	const groupedRoutes = /* @__PURE__ */ new Map();
 	for (const route of routes) {
 		if (route.path === "/" || (route.basePath ?? route.path) === "/404") continue;
+		if (route.meta.group) {
+			const grouped = groupedRoutes.get(route.meta.group) ?? [];
+			grouped.push(route);
+			groupedRoutes.set(route.meta.group, grouped);
+			continue;
+		}
 		const parts = route.path.replace(/^\//, "").split("/");
 		let current = root;
 		for (let i = 0; i < parts.length; i++) {
@@ -592,6 +640,7 @@ function buildNavigation(routes) {
 					title: i === parts.length - 1 ? route.meta.title : kebabToTitle(parts[i]),
 					children: []
 				};
+				if (i === parts.length - 1 && route.meta.layout) node.layout = route.meta.layout;
 				current.push(node);
 			}
 			if (i === parts.length - 1 && route.meta.sections) node.sections = navigationSections(route.meta.sections);
@@ -601,6 +650,22 @@ function buildNavigation(routes) {
 			}
 		}
 	}
+	for (const [title, grouped] of groupedRoutes) {
+		const children = buildNavigation(grouped.map((route) => ({
+			...route,
+			meta: {
+				...route.meta,
+				group: void 0
+			}
+		})));
+		const node = {
+			path: children[0]?.path ?? "/",
+			title,
+			children
+		};
+		if (grouped[0]?.meta.layout) node.layout = grouped[0].meta.layout;
+		root.push(node);
+	}
 	return root;
 }
 function routeIntentFromPagesItem(item) {
@@ -707,6 +772,7 @@ function buildNavigationFromConfig(routes, config) {
 				path: firstNavigationPath(children),
 				title: resolveLocalizedText(item.group, "", "") ?? "",
 				icon: item.icon,
+				layout: item.layout,
 				children
 			};
 		}
@@ -760,6 +826,7 @@ function buildLocalizedNavigationForLocale(routes, config, locale, locales) {
 				path: firstNavigationPath(children),
 				title: resolveLocalizedText(item.group, locale, locales.default) ?? "",
 				icon: item.icon,
+				layout: item.layout,
 				children
 			};
 		}
@@ -971,10 +1038,10 @@ var clarifyLocalesConfigSchema = zod.z.object({
 		zod.z.literal("404"),
 		zod.z.literal("hide")
 	]).optional(),
-	locales: zod.z.array(clarifyLocaleConfigSchema).min(1)
+	locales: zod.z.array(clarifyLocaleConfigSchema).min(1).optional()
 }).strict().superRefine((config, ctx) => {
 	const localeCodes = /* @__PURE__ */ new Set();
-	for (const [index, locale] of config.locales.entries()) {
+	for (const [index, locale] of (config.locales ?? []).entries()) {
 		if (localeCodes.has(locale.code)) ctx.addIssue({
 			code: zod.z.ZodIssueCode.custom,
 			message: `Duplicate locale code "${locale.code}"`,
@@ -986,24 +1053,45 @@ var clarifyLocalesConfigSchema = zod.z.object({
 		});
 		localeCodes.add(locale.code);
 	}
-	if (config.default && !localeCodes.has(config.default)) ctx.addIssue({
+	if (config.default && config.locales && !localeCodes.has(config.default)) ctx.addIssue({
 		code: zod.z.ZodIssueCode.custom,
 		message: "default must be one of locales.locales",
 		path: ["default"]
 	});
 });
-var clarifyNavbarLinkSchema = zod.z.object({
+var clarifyLinkConfigSchema = zod.z.object({
 	label: clarifyLocalizedTextSchema,
-	href: zod.z.string(),
-	external: zod.z.boolean().optional()
+	href: zod.z.string()
 }).strict();
+var clarifyNavbarMenuItemBaseSchema = {
+	label: clarifyLocalizedTextSchema,
+	description: clarifyLocalizedTextSchema.optional(),
+	icon: zod.z.string().optional()
+};
+var clarifyNavbarMenuHrefSchema = zod.z.object({
+	...clarifyNavbarMenuItemBaseSchema,
+	href: zod.z.string()
+}).strict();
+var clarifyNavbarMenuPageSchema = zod.z.object({
+	...clarifyNavbarMenuItemBaseSchema,
+	page: zod.z.string()
+}).strict();
+var clarifyNavbarMenuItemsSchema = zod.z.lazy(() => zod.z.object({
+	...clarifyNavbarMenuItemBaseSchema,
+	items: zod.z.array(clarifyNavbarMenuItemSchema)
+}).strict());
+var clarifyNavbarMenuItemSchema = zod.z.lazy(() => zod.z.union([
+	clarifyNavbarMenuHrefSchema,
+	clarifyNavbarMenuPageSchema,
+	clarifyNavbarMenuItemsSchema
+]));
 var clarifyBannerConfigOptionsSchema = zod.z.object({
 	content: clarifyLocalizedTextSchema,
 	dismissible: zod.z.boolean().optional(),
-	link: clarifyNavbarLinkSchema.optional()
+	link: clarifyLinkConfigSchema.optional()
 }).strict();
 var clarifyFooterConfigSchema = zod.z.object({
-	links: zod.z.array(clarifyNavbarLinkSchema).optional(),
+	links: zod.z.array(clarifyLinkConfigSchema).optional(),
 	socials: zod.z.record(zod.z.string(), zod.z.string()).optional(),
 	copyright: clarifyLocalizedTextSchema.optional()
 }).strict();
@@ -1056,6 +1144,7 @@ var clarifyPagesItemSchema = zod.z.lazy(() => zod.z.union([
 var clarifyPagesGroupSchema = zod.z.lazy(() => zod.z.object({
 	group: clarifyLocalizedTextSchema,
 	icon: zod.z.string().optional(),
+	layout: zod.z.enum(["documentation", "blog"]).optional(),
 	pages: zod.z.array(clarifyPagesItemSchema)
 }).strict());
 var clarifyPagesConfigSchema = zod.z.union([zod.z.array(clarifyPagesGroupSchema), zod.z.literal("FileTree")]);
@@ -1130,7 +1219,7 @@ var clarifyProjectConfigSchema = zod.z.object({
 	theme: clarifyThemeConfigSchema.optional(),
 	layout: clarifyLayoutConfigSchema.optional(),
 	navigation: zod.z.object({
-		links: zod.z.array(clarifyNavbarLinkSchema).optional(),
+		menus: zod.z.array(clarifyNavbarMenuItemSchema).optional(),
 		tabs: clarifyTabsConfigSchema.optional()
 	}).strict().optional(),
 	banner: clarifyBannerConfigOptionsSchema.optional(),
@@ -1161,7 +1250,7 @@ function validateProjectConfig(value) {
 	return result.data;
 }
 function resolveLocalesConfig(locales) {
-	if (!locales) return void 0;
+	if (!locales?.locales) return void 0;
 	const firstLocale = locales.locales[0]?.code;
 	const defaultLocale = locales.default ?? firstLocale;
 	if (!defaultLocale) return void 0;
@@ -1205,6 +1294,7 @@ function resolveProjectConfig(config = {}) {
 		banner: config.banner,
 		footer: config.footer,
 		locales: resolveLocalesConfig(config.locales),
+		defaultLocale: config.locales?.default,
 		variables: config.variables ?? {},
 		features: resolveFeaturesConfig(config.features)
 	};
@@ -1361,6 +1451,7 @@ function generateConfigModule(projectConfig, version, themeEditor = false) {
 		banner: projectConfig.banner,
 		footer: projectConfig.footer,
 		locales: projectConfig.locales,
+		defaultLocale: projectConfig.defaultLocale,
 		variables: projectConfig.variables,
 		features: projectConfig.features
 	};
@@ -1385,6 +1476,8 @@ function routeToRuntimeManifestEntry(route, component, mode) {
 	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;
+	if (route.meta.layout) entry.layout = route.meta.layout;
+	if (route.meta.updatedAt) entry.updatedAt = route.meta.updatedAt;
 	if (route.artifacts?.contentArtifactUrl) entry.contentArtifactUrl = route.artifacts.contentArtifactUrl;
 	if (route.source?.sourceEditUrl) entry.sourceEditUrl = route.source.sourceEditUrl;
 	if (route.meta.sections?.length) entry.sections = route.meta.sections.map((section) => ({
@@ -1711,7 +1804,7 @@ function createViteAdapter(engine) {
 }
 var cliPackageVersion = {
 	name: "@clarify-labs/cli",
-	version: "0.11.9",
+	version: "0.11.10",
 	license: "AGPL-3.0-only",
 	type: "module",
 	repository: {
@@ -2753,6 +2846,7 @@ var OpenAPIPluginState = class {
 		const specByFilePath = /* @__PURE__ */ new Map();
 		for (const route of routes) {
 			if (route.kind !== "openapi") continue;
+			const updatedAt = await getFileUpdatedAt(route.source.filePath, ctx.contentRoot);
 			const specFromCache = specByFilePath.get(route.source.filePath);
 			const processor = createProjectContentProcessor(ctx.plugins, ctx);
 			const result = specFromCache ? {
@@ -2766,6 +2860,13 @@ var OpenAPIPluginState = class {
 				continue;
 			}
 			const spec = normalizeOpenAPISpecSectionIds(result.spec);
+			const specWithMetadata = updatedAt && spec.info ? {
+				...spec,
+				info: {
+					...spec.info,
+					"x-clarify-updated-at": updatedAt
+				}
+			} : spec;
 			specByFilePath.set(route.source.filePath, spec);
 			const sourceSpecId = sourceSpecIdFromPath(route.source.filePath, ctx.generateOptions.projectRoot);
 			route.openapi = {
@@ -2774,8 +2875,9 @@ var OpenAPIPluginState = class {
 			};
 			route.meta.title = spec.info?.title ?? route.meta.title;
 			route.meta.description = spec.info?.description ?? route.meta.description;
+			route.meta.updatedAt = updatedAt;
 			route.meta.sections = extractOpenAPISections(spec, route.openapi.tagFilter);
-			const pageSpec = route.openapi.tagFilter?.length ? filterSpecByTags(spec, route.openapi.tagFilter) : spec;
+			const pageSpec = route.openapi.tagFilter?.length ? filterSpecByTags(specWithMetadata, route.openapi.tagFilter) : specWithMetadata;
 			const routeSpecModuleId = routeSpecModuleIdFromSourceSpecId(sourceSpecId, route.openapi.tagFilter);
 			route.openapi.routeSpecModuleId = routeSpecModuleId;
 			this.specModules.set(routeSpecModuleId, pageSpec);
@@ -4117,4 +4219,4 @@ Object.defineProperty(exports, "searchMcpIndex", {
 	}
 });
 
-//# sourceMappingURL=engine-Bupsozys.cjs.map
+//# sourceMappingURL=engine-BuYsLjJN.cjs.map