@clarify-labs/cli 0.11.17 → 0.11.19

package/output/cli.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const require_engine = require("./engine-BNvizszh.cjs");
+const require_engine = require("./engine-0ROqtF4o.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, d as createViteAdapter, i as findRouteConflicts, l as cliPackageVersionWithCaret, n as createClarifyEngine, o as deserializeSearchIndex, r as createClarifyRuntimeAliases, s as searchMcpIndex, u as printCliVersion } from "./engine-CIhcMyvD.js";
+import { a as createClarifyTempDir, c as cliPackageVersion, d as createViteAdapter, i as findRouteConflicts, l as cliPackageVersionWithCaret, n as createClarifyEngine, o as deserializeSearchIndex, r as createClarifyRuntimeAliases, s as searchMcpIndex, u as printCliVersion } from "./engine-DH8Hi6Fr.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-BNvizszh.cjs → engine-0ROqtF4o.cjs}

@@ -678,6 +678,7 @@ function routeIntentFromPagesItem(item) {
 		kind: "openapi",
 		ref: item.openapi,
 		tagFilter: item.filter?.tags,
+		operationOrder: item.operationOrder,
 		path: item.path,
 		title: item.title,
 		icon: item.icon
@@ -1144,6 +1145,7 @@ var clarifyPagesItemSchema = zod.z.lazy(() => zod.z.union([
 	zod.z.object({
 		openapi: zod.z.string(),
 		path: zod.z.string().optional(),
+		operationOrder: zod.z.array(zod.z.string()).optional(),
 		icon: zod.z.string().optional(),
 		title: clarifyLocalizedTextSchema.optional(),
 		filter: zod.z.object({ tags: zod.z.array(zod.z.string()).optional() }).strict().optional()
@@ -1819,7 +1821,7 @@ function createViteAdapter(engine) {
 }
 var cliPackageVersion = {
 	name: "@clarify-labs/cli",
-	version: "0.11.17",
+	version: "0.11.19",
 	license: "AGPL-3.0-only",
 	type: "module",
 	repository: {
@@ -2628,9 +2630,9 @@ function filterSpecByTags(spec, tags) {
 	};
 }
 /** Extract endpoint operations from an OpenAPI spec as page sections. */
-function extractOpenAPISections(spec, filterTags) {
+function extractOpenAPISections(spec, filterTags, operationOrder) {
 	normalizeOpenAPISpecSectionIds(spec);
-	const sections = [];
+	const entries = [];
 	const items = [...Object.entries(spec.paths ?? {}).map(([path, pathItem]) => ({
 		path,
 		pathItem,
@@ -2648,16 +2650,25 @@ function extractOpenAPISections(spec, filterTags) {
 			const tags = Array.isArray(op?.tags) ? op.tags : void 0;
 			if (!op || !operationMatchesTags(tags, filterTags)) continue;
 			const title = typeof op.summary === "string" ? op.summary : `${method.toUpperCase()} ${path}`;
-			sections.push({
-				id: operationSectionId(op),
-				title,
-				level: 2,
-				badge: kind === "webhook" ? "WEBHOOK" : method.toUpperCase(),
-				tags
+			entries.push({
+				section: {
+					id: operationSectionId(op),
+					title,
+					level: 2,
+					badge: kind === "webhook" ? "WEBHOOK" : method.toUpperCase(),
+					tags
+				},
+				operationId: typeof op.operationId === "string" ? op.operationId : void 0
 			});
 		}
 	}
-	return sections;
+	if (!operationOrder?.length) return entries.map(({ section }) => section);
+	const orderById = new Map(operationOrder.map((operationId, index) => [operationId, index]));
+	return entries.map((entry, index) => ({
+		...entry,
+		index,
+		order: entry.operationId ? orderById.get(entry.operationId) : void 0
+	})).sort((left, right) => (left.order ?? operationOrder.length) - (right.order ?? operationOrder.length) || left.index - right.index).map(({ section }) => section);
 }
 async function readOpenAPISpec(filePath, contentProcessor, projectRoot) {
 	try {
@@ -2704,7 +2715,7 @@ function collectOpenAPIPageIntents(config) {
 				continue;
 			}
 			const intent = routeIntentFromPagesItem(item);
-			if (intent.kind === "openapi" && (intent.path || intent.tagFilter?.length)) intents.push(intent);
+			if (intent.kind === "openapi" && (intent.path || intent.tagFilter?.length || intent.operationOrder?.length)) intents.push(intent);
 		}
 	}
 	function visitPages(pages) {
@@ -2725,7 +2736,8 @@ function cloneOpenAPIRoute(route, overrides = {}) {
 		source: { ...route.source },
 		openapi: route.openapi ? {
 			...route.openapi,
-			tagFilter: route.openapi.tagFilter ? [...route.openapi.tagFilter] : void 0
+			tagFilter: route.openapi.tagFilter ? [...route.openapi.tagFilter] : void 0,
+			operationOrder: route.openapi.operationOrder ? [...route.openapi.operationOrder] : void 0
 		} : void 0,
 		alternates: route.alternates ? { ...route.alternates } : void 0,
 		...overrides
@@ -2774,9 +2786,21 @@ function expandConfiguredOpenAPIRoutes(routes, config) {
 	const existingKeys = new Set(routes.map((route) => `${route.locale ?? ""}:${route.basePath ?? route.path}`));
 	for (const intent of openAPIIntents) {
 		const tagFilter = intent.tagFilter?.filter(Boolean);
+		const operationOrder = intent.operationOrder?.filter(Boolean);
 		const sourceBasePath = openAPIPagePathFromRef(intent.ref);
 		const targetBasePath = openAPIPagePathFromRef(intent.ref, tagFilter, intent.path);
-		if (sourceBasePath === targetBasePath && !tagFilter?.length) continue;
+		if (sourceBasePath === targetBasePath && !tagFilter?.length) {
+			if (!operationOrder?.length) continue;
+			for (let index = 0; index < routes.length; index++) {
+				const route = routes[index];
+				if (route.kind !== "openapi" || (route.basePath ?? route.path) !== sourceBasePath) continue;
+				routes[index] = cloneOpenAPIRoute(route, { openapi: {
+					...route.openapi,
+					operationOrder: [...operationOrder]
+				} });
+			}
+			continue;
+		}
 		for (const route of routes) {
 			if (route.kind !== "openapi" || (route.basePath ?? route.path) !== sourceBasePath) continue;
 			const key = `${route.locale ?? ""}:${targetBasePath}`;
@@ -2789,7 +2813,8 @@ function expandConfiguredOpenAPIRoutes(routes, config) {
 				module: { pageVirtualModuleId: pageVirtualModuleId(path) },
 				openapi: {
 					...route.openapi,
-					tagFilter: tagFilter?.length ? tagFilter : void 0
+					tagFilter: tagFilter?.length ? tagFilter : void 0,
+					operationOrder: operationOrder?.length ? [...operationOrder] : void 0
 				}
 			}));
 		}
@@ -2831,10 +2856,11 @@ function generateOpenAPISpecModule(spec) {
 	return `export default ${JSON.stringify(spec)};`;
 }
 function generateOpenAPIPageModule(opts) {
+	const routeData = opts.operationOrder?.length ? { operationOrder: opts.operationOrder } : {};
 	return `import { createOpenApiRouteComponent } from '@clarify-labs/renderer';
 import spec from ${JSON.stringify(opts.specModuleId)};
 
-export const routeData = {};
+export const routeData = ${JSON.stringify(routeData)};
 
 export default createOpenApiRouteComponent({ ...routeData, spec });
 `;
@@ -2894,7 +2920,7 @@ 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);
+			route.meta.sections = extractOpenAPISections(spec, route.openapi.tagFilter, route.openapi.operationOrder);
 			const pageSpec = route.openapi.tagFilter?.length ? filterSpecByTags(specWithMetadata, route.openapi.tagFilter) : specWithMetadata;
 			const routeSpecModuleId = routeSpecModuleIdFromSourceSpecId(sourceSpecId, route.openapi.tagFilter);
 			route.openapi.routeSpecModuleId = routeSpecModuleId;
@@ -2928,7 +2954,10 @@ var OpenAPIPluginState = class {
 			if (!route.openapi?.sourceSpecId) continue;
 			const routeSpecModuleId = route.openapi.routeSpecModuleId ?? route.openapi.sourceSpecId;
 			if (!this.specModules.has(routeSpecModuleId)) continue;
-			modules.set(route.module.pageVirtualModuleId, generateOpenAPIPageModule({ specModuleId: specVirtualModuleId(routeSpecModuleId) }));
+			modules.set(route.module.pageVirtualModuleId, generateOpenAPIPageModule({
+				specModuleId: specVirtualModuleId(routeSpecModuleId),
+				operationOrder: route.openapi.operationOrder
+			}));
 		}
 		return modules;
 	}
@@ -4276,4 +4305,4 @@ Object.defineProperty(exports, "searchMcpIndex", {
 	}
 });
 
-//# sourceMappingURL=engine-BNvizszh.cjs.map
+//# sourceMappingURL=engine-0ROqtF4o.cjs.map