@clarify-labs/cli 0.11.18 → 0.11.19

package/output/{engine-DeA6EGHW.js → engine-DH8Hi6Fr.js}

@@ -647,6 +647,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
@@ -1113,6 +1114,7 @@ var clarifyPagesItemSchema = z.lazy(() => z.union([
 	z.object({
 		openapi: z.string(),
 		path: z.string().optional(),
+		operationOrder: z.array(z.string()).optional(),
 		icon: z.string().optional(),
 		title: clarifyLocalizedTextSchema.optional(),
 		filter: z.object({ tags: z.array(z.string()).optional() }).strict().optional()
@@ -1788,7 +1790,7 @@ function createViteAdapter(engine) {
 }
 var cliPackageVersion = {
 	name: "@clarify-labs/cli",
-	version: "0.11.18",
+	version: "0.11.19",
 	license: "AGPL-3.0-only",
 	type: "module",
 	repository: {
@@ -2597,9 +2599,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,
@@ -2617,16 +2619,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 {
@@ -2673,7 +2684,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) {
@@ -2694,7 +2705,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
@@ -2743,9 +2755,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}`;
@@ -2758,7 +2782,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
 				}
 			}));
 		}
@@ -2800,10 +2825,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 });
 `;
@@ -2863,7 +2889,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;
@@ -2897,7 +2923,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;
 	}
@@ -4174,4 +4203,4 @@ function createClarifyEngine(options = {}) {
 //#endregion
 export { createClarifyTempDir as a, cliPackageVersion as c, createViteAdapter as d, defineConfig as f, findRouteConflicts as i, cliPackageVersionWithCaret as l, createClarifyEngine as n, deserializeSearchIndex as o, createClarifyRuntimeAliases as r, searchMcpIndex as s, ClarifyEngine as t, printCliVersion as u };
 
-//# sourceMappingURL=engine-DeA6EGHW.js.map
+//# sourceMappingURL=engine-DH8Hi6Fr.js.map