@clarify-labs/cli 0.11.9 → 0.11.10

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

@@ -14,6 +14,7 @@ import GithubSlugger, { slug } from "github-slugger";
 import { toString } from "mdast-util-to-string";
 import { remark } from "remark";
 import matter from "gray-matter";
+import { spawnSync } from "node:child_process";
 import { createReadStream, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { build, loadConfigFromFile } from "vite";
 import { z } from "zod";
@@ -320,6 +321,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 = spawnSync("git", [
+			"log",
+			"-1",
+			"--format=%cI",
+			"--",
+			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 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(" ");
@@ -419,6 +456,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 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,
@@ -439,6 +477,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: {
@@ -548,8 +589,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++) {
@@ -561,6 +609,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);
@@ -570,6 +619,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) {
@@ -676,6 +741,7 @@ function buildNavigationFromConfig(routes, config) {
 				path: firstNavigationPath(children),
 				title: resolveLocalizedText(item.group, "", "") ?? "",
 				icon: item.icon,
+				layout: item.layout,
 				children
 			};
 		}
@@ -729,6 +795,7 @@ function buildLocalizedNavigationForLocale(routes, config, locale, locales) {
 				path: firstNavigationPath(children),
 				title: resolveLocalizedText(item.group, locale, locales.default) ?? "",
 				icon: item.icon,
+				layout: item.layout,
 				children
 			};
 		}
@@ -940,10 +1007,10 @@ var clarifyLocalesConfigSchema = z.object({
 		z.literal("404"),
 		z.literal("hide")
 	]).optional(),
-	locales: z.array(clarifyLocaleConfigSchema).min(1)
+	locales: 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: z.ZodIssueCode.custom,
 			message: `Duplicate locale code "${locale.code}"`,
@@ -955,24 +1022,45 @@ var clarifyLocalesConfigSchema = 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: z.ZodIssueCode.custom,
 		message: "default must be one of locales.locales",
 		path: ["default"]
 	});
 });
-var clarifyNavbarLinkSchema = z.object({
+var clarifyLinkConfigSchema = z.object({
 	label: clarifyLocalizedTextSchema,
-	href: z.string(),
-	external: z.boolean().optional()
+	href: z.string()
 }).strict();
+var clarifyNavbarMenuItemBaseSchema = {
+	label: clarifyLocalizedTextSchema,
+	description: clarifyLocalizedTextSchema.optional(),
+	icon: z.string().optional()
+};
+var clarifyNavbarMenuHrefSchema = z.object({
+	...clarifyNavbarMenuItemBaseSchema,
+	href: z.string()
+}).strict();
+var clarifyNavbarMenuPageSchema = z.object({
+	...clarifyNavbarMenuItemBaseSchema,
+	page: z.string()
+}).strict();
+var clarifyNavbarMenuItemsSchema = z.lazy(() => z.object({
+	...clarifyNavbarMenuItemBaseSchema,
+	items: z.array(clarifyNavbarMenuItemSchema)
+}).strict());
+var clarifyNavbarMenuItemSchema = z.lazy(() => z.union([
+	clarifyNavbarMenuHrefSchema,
+	clarifyNavbarMenuPageSchema,
+	clarifyNavbarMenuItemsSchema
+]));
 var clarifyBannerConfigOptionsSchema = z.object({
 	content: clarifyLocalizedTextSchema,
 	dismissible: z.boolean().optional(),
-	link: clarifyNavbarLinkSchema.optional()
+	link: clarifyLinkConfigSchema.optional()
 }).strict();
 var clarifyFooterConfigSchema = z.object({
-	links: z.array(clarifyNavbarLinkSchema).optional(),
+	links: z.array(clarifyLinkConfigSchema).optional(),
 	socials: z.record(z.string(), z.string()).optional(),
 	copyright: clarifyLocalizedTextSchema.optional()
 }).strict();
@@ -1025,6 +1113,7 @@ var clarifyPagesItemSchema = z.lazy(() => z.union([
 var clarifyPagesGroupSchema = z.lazy(() => z.object({
 	group: clarifyLocalizedTextSchema,
 	icon: z.string().optional(),
+	layout: z.enum(["documentation", "blog"]).optional(),
 	pages: z.array(clarifyPagesItemSchema)
 }).strict());
 var clarifyPagesConfigSchema = z.union([z.array(clarifyPagesGroupSchema), z.literal("FileTree")]);
@@ -1099,7 +1188,7 @@ var clarifyProjectConfigSchema = z.object({
 	theme: clarifyThemeConfigSchema.optional(),
 	layout: clarifyLayoutConfigSchema.optional(),
 	navigation: z.object({
-		links: z.array(clarifyNavbarLinkSchema).optional(),
+		menus: z.array(clarifyNavbarMenuItemSchema).optional(),
 		tabs: clarifyTabsConfigSchema.optional()
 	}).strict().optional(),
 	banner: clarifyBannerConfigOptionsSchema.optional(),
@@ -1130,7 +1219,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;
@@ -1174,6 +1263,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)
 	};
@@ -1330,6 +1420,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
 	};
@@ -1354,6 +1445,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) => ({
@@ -1680,7 +1773,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: {
@@ -2722,6 +2815,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 ? {
@@ -2735,6 +2829,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 = {
@@ -2743,8 +2844,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);
@@ -4021,4 +4123,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-CdH3JL_y.js.map
+//# sourceMappingURL=engine-DisWfZp-.js.map