specli 0.0.5 → 0.0.8

package/dist/src/cli/naming.js

@@ -0,0 +1,216 @@
+// src/cli/pluralize.ts
+var IRREGULAR = {
+  person: "people",
+  man: "men",
+  woman: "women",
+  child: "children",
+  tooth: "teeth",
+  foot: "feet",
+  mouse: "mice",
+  goose: "geese"
+};
+var UNCOUNTABLE = new Set([
+  "metadata",
+  "information",
+  "equipment",
+  "money",
+  "series",
+  "species"
+]);
+function pluralize(word) {
+  const w = word.trim();
+  if (!w)
+    return w;
+  const lower = w.toLowerCase();
+  if (UNCOUNTABLE.has(lower))
+    return lower;
+  if (IRREGULAR[lower])
+    return IRREGULAR[lower];
+  if (lower.endsWith("s"))
+    return lower;
+  if (/[bcdfghjklmnpqrstvwxyz]y$/.test(lower)) {
+    return lower.replace(/y$/, "ies");
+  }
+  if (/(ch|sh|x|z)$/.test(lower)) {
+    return `${lower}es`;
+  }
+  return `${lower}s`;
+}
+
+// src/cli/strings.ts
+function kebabCase(input) {
+  const trimmed = input.trim();
+  if (!trimmed)
+    return "";
+  return trimmed.replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/[\s_.:/]+/g, "-").replace(/[^a-zA-Z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").toLowerCase();
+}
+
+// src/cli/naming.ts
+var GENERIC_TAGS = new Set(["default", "defaults", "api"]);
+function getPathSegments(path) {
+  return path.split("/").map((s) => s.trim()).filter(Boolean);
+}
+function getPathArgs(path) {
+  const args = [];
+  const re = /\{([^}]+)\}/g;
+  while (true) {
+    const match = re.exec(path);
+    if (!match)
+      break;
+    args.push(match[1]);
+  }
+  return args;
+}
+function pickResourceFromTags(tags) {
+  if (!tags.length)
+    return;
+  const first = tags[0]?.trim();
+  if (!first)
+    return;
+  if (GENERIC_TAGS.has(first.toLowerCase()))
+    return;
+  return first;
+}
+function splitOperationId(operationId) {
+  const trimmed = operationId.trim();
+  if (!trimmed)
+    return {};
+  if (trimmed.includes(".")) {
+    const [prefix, ...rest] = trimmed.split(".");
+    return { prefix, suffix: rest.join(".") };
+  }
+  if (trimmed.includes("__")) {
+    const [prefix, ...rest] = trimmed.split("__");
+    return { prefix, suffix: rest.join("__") };
+  }
+  if (trimmed.includes("_")) {
+    const [prefix, ...rest] = trimmed.split("_");
+    return { prefix, suffix: rest.join("_") };
+  }
+  return { suffix: trimmed };
+}
+function inferStyle(op) {
+  if (op.path.includes("."))
+    return "rpc";
+  if (op.operationId?.includes(".") && op.method === "POST")
+    return "rpc";
+  return "rest";
+}
+function inferResource(op) {
+  const tag = pickResourceFromTags(op.tags);
+  if (tag)
+    return pluralize(kebabCase(tag));
+  if (op.operationId) {
+    const { prefix } = splitOperationId(op.operationId);
+    if (prefix) {
+      const fromId = kebabCase(prefix);
+      if (fromId === "ping")
+        return "ping";
+      return pluralize(fromId);
+    }
+  }
+  const segments = getPathSegments(op.path);
+  let first = segments[0] ?? "api";
+  first = first.includes(".") ? first.split(".")[0] : first;
+  if (first.toLowerCase() === "ping")
+    return "ping";
+  const cleaned = first.replace(/^\{.+\}$/, "");
+  return pluralize(kebabCase(cleaned || "api"));
+}
+function canonicalizeAction(action) {
+  const a = kebabCase(action);
+  if (a === "retrieve" || a === "read")
+    return "get";
+  if (a === "list" || a === "search")
+    return "list";
+  if (a === "create")
+    return "create";
+  if (a === "update" || a === "patch")
+    return "update";
+  if (a === "delete" || a === "remove")
+    return "delete";
+  return a;
+}
+function inferRestAction(op) {
+  if (op.operationId) {
+    const { suffix } = splitOperationId(op.operationId);
+    if (suffix) {
+      const fromId = canonicalizeAction(suffix);
+      if (fromId === "get" || fromId === "list" || fromId === "create" || fromId === "update" || fromId === "delete") {
+        return fromId;
+      }
+    }
+  }
+  const method = op.method.toUpperCase();
+  const args = getPathArgs(op.path);
+  const hasId = args.length > 0;
+  if (method === "GET" && !hasId)
+    return "list";
+  if (method === "POST" && !hasId)
+    return "create";
+  if (method === "GET" && hasId)
+    return "get";
+  if ((method === "PUT" || method === "PATCH") && hasId)
+    return "update";
+  if (method === "DELETE" && hasId)
+    return "delete";
+  return kebabCase(method);
+}
+function inferRpcAction(op) {
+  if (op.operationId) {
+    const { suffix } = splitOperationId(op.operationId);
+    if (suffix)
+      return canonicalizeAction(suffix);
+  }
+  const segments = getPathSegments(op.path);
+  const last = segments[segments.length - 1] ?? "";
+  if (last.includes(".")) {
+    const part = last.split(".").pop() ?? last;
+    return canonicalizeAction(part);
+  }
+  return kebabCase(op.method);
+}
+function planOperation(op) {
+  const style = inferStyle(op);
+  const resource = inferResource(op);
+  const action = style === "rpc" ? inferRpcAction(op) : inferRestAction(op);
+  return {
+    ...op,
+    key: op.key,
+    style,
+    resource,
+    action,
+    canonicalAction: action,
+    pathArgs: getPathArgs(op.path).map((a) => kebabCase(a))
+  };
+}
+function planOperations(ops) {
+  const planned = ops.map(planOperation);
+  const counts = new Map;
+  for (const op of planned) {
+    const key = `${op.resource}:${op.action}`;
+    counts.set(key, (counts.get(key) ?? 0) + 1);
+  }
+  const seen = new Map;
+  return planned.map((op) => {
+    const key = `${op.resource}:${op.action}`;
+    const total = counts.get(key) ?? 0;
+    if (total <= 1)
+      return op;
+    const idx = (seen.get(key) ?? 0) + 1;
+    seen.set(key, idx);
+    const suffix = op.operationId ? kebabCase(op.operationId) : kebabCase(`${op.method}-${op.path}`);
+    const disambiguatedAction = `${op.action}-${suffix}-${idx}`;
+    return {
+      ...op,
+      action: disambiguatedAction,
+      aliasOf: `${op.resource} ${op.canonicalAction}`
+    };
+  });
+}
+export {
+  planOperations,
+  planOperation
+};
+
+//# debugId=99ADFCE0CE9D3B1464756E2164756E21

package/dist/src/cli/naming.js.map

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["../../../src/cli/pluralize.ts", "../../../src/cli/strings.ts", "../../../src/cli/naming.ts"],
+  "sourcesContent": [
+    "const IRREGULAR: Record<string, string> = {\n\tperson: \"people\",\n\tman: \"men\",\n\twoman: \"women\",\n\tchild: \"children\",\n\ttooth: \"teeth\",\n\tfoot: \"feet\",\n\tmouse: \"mice\",\n\tgoose: \"geese\",\n};\n\nconst UNCOUNTABLE = new Set([\n\t\"metadata\",\n\t\"information\",\n\t\"equipment\",\n\t\"money\",\n\t\"series\",\n\t\"species\",\n]);\n\nexport function pluralize(word: string): string {\n\tconst w = word.trim();\n\tif (!w) return w;\n\n\tconst lower = w.toLowerCase();\n\tif (UNCOUNTABLE.has(lower)) return lower;\n\tif (IRREGULAR[lower]) return IRREGULAR[lower];\n\n\t// already plural-ish\n\tif (lower.endsWith(\"s\")) return lower;\n\n\tif (/[bcdfghjklmnpqrstvwxyz]y$/.test(lower)) {\n\t\treturn lower.replace(/y$/, \"ies\");\n\t}\n\n\tif (/(ch|sh|x|z)$/.test(lower)) {\n\t\treturn `${lower}es`;\n\t}\n\n\treturn `${lower}s`;\n}\n",
+    "export function kebabCase(input: string): string {\n\tconst trimmed = input.trim();\n\tif (!trimmed) return \"\";\n\n\t// Convert spaces/underscores/dots to dashes, split camelCase.\n\treturn trimmed\n\t\t.replace(/([a-z0-9])([A-Z])/g, \"$1-$2\")\n\t\t.replace(/[\\s_.:/]+/g, \"-\")\n\t\t.replace(/[^a-zA-Z0-9-]/g, \"-\")\n\t\t.replace(/-+/g, \"-\")\n\t\t.replace(/^-|-$/g, \"\")\n\t\t.toLowerCase();\n}\n\nexport function titleCase(input: string): string {\n\treturn input\n\t\t.split(/\\s+/g)\n\t\t.filter(Boolean)\n\t\t.map((w) => w[0]?.toUpperCase() + w.slice(1))\n\t\t.join(\" \");\n}\n",
+    "import { pluralize } from \"./pluralize.ts\";\nimport { kebabCase } from \"./strings.ts\";\nimport type { NormalizedOperation } from \"./types.ts\";\n\nexport type PlannedOperation = NormalizedOperation & {\n\tresource: string;\n\taction: string;\n\tpathArgs: string[];\n\tstyle: \"rest\" | \"rpc\";\n\tcanonicalAction: string;\n\taliasOf?: string;\n};\n\nconst GENERIC_TAGS = new Set([\"default\", \"defaults\", \"api\"]);\n\nfunction getPathSegments(path: string): string[] {\n\treturn path\n\t\t.split(\"/\")\n\t\t.map((s) => s.trim())\n\t\t.filter(Boolean);\n}\n\nfunction getPathArgs(path: string): string[] {\n\tconst args: string[] = [];\n\tconst re = /\\{([^}]+)\\}/g;\n\n\twhile (true) {\n\t\tconst match = re.exec(path);\n\t\tif (!match) break;\n\t\t// biome-ignore lint/style/noNonNullAssertion: unknown\n\t\targs.push(match[1]!);\n\t}\n\n\treturn args;\n}\n\nfunction pickResourceFromTags(tags: string[]): string | undefined {\n\tif (!tags.length) return undefined;\n\tconst first = tags[0]?.trim();\n\tif (!first) return undefined;\n\tif (GENERIC_TAGS.has(first.toLowerCase())) return undefined;\n\treturn first;\n}\n\nfunction splitOperationId(operationId: string): {\n\tprefix?: string;\n\tsuffix?: string;\n} {\n\tconst trimmed = operationId.trim();\n\tif (!trimmed) return {};\n\n\t// Prefer dot-notation when present: Contacts.List\n\tif (trimmed.includes(\".\")) {\n\t\tconst [prefix, ...rest] = trimmed.split(\".\");\n\t\treturn { prefix, suffix: rest.join(\".\") };\n\t}\n\n\t// Try separators: Contacts_List, Contacts__List\n\tif (trimmed.includes(\"__\")) {\n\t\tconst [prefix, ...rest] = trimmed.split(\"__\");\n\t\treturn { prefix, suffix: rest.join(\"__\") };\n\t}\n\n\tif (trimmed.includes(\"_\")) {\n\t\tconst [prefix, ...rest] = trimmed.split(\"_\");\n\t\treturn { prefix, suffix: rest.join(\"_\") };\n\t}\n\n\treturn { suffix: trimmed };\n}\n\nfunction inferStyle(op: NormalizedOperation): \"rest\" | \"rpc\" {\n\t// Path-based RPC convention (common in gRPC-ish HTTP gateways)\n\t// - POST /Contacts.List\n\t// - POST /Contacts/Service.List\n\tif (op.path.includes(\".\")) return \"rpc\";\n\n\t// operationId dot-notation alone is not enough to call it RPC; many REST APIs\n\t// have dotted ids. We treat dotted operationId as a weak signal.\n\tif (op.operationId?.includes(\".\") && op.method === \"POST\") return \"rpc\";\n\n\treturn \"rest\";\n}\n\nfunction inferResource(op: NormalizedOperation): string {\n\tconst tag = pickResourceFromTags(op.tags);\n\tif (tag) return pluralize(kebabCase(tag));\n\n\tif (op.operationId) {\n\t\tconst { prefix } = splitOperationId(op.operationId);\n\t\tif (prefix) {\n\t\t\tconst fromId = kebabCase(prefix);\n\t\t\tif (fromId === \"ping\") return \"ping\";\n\t\t\treturn pluralize(fromId);\n\t\t}\n\t}\n\n\tconst segments = getPathSegments(op.path);\n\tlet first = segments[0] ?? \"api\";\n\n\t// If first segment is rpc-ish, like Contacts.List, split it.\n\t// biome-ignore lint/style/noNonNullAssertion: split always returns at least one element\n\tfirst = first.includes(\".\") ? first.split(\".\")[0]! : first;\n\n\t// Singletons like /ping generally shouldn't become `pings`.\n\tif (first.toLowerCase() === \"ping\") return \"ping\";\n\n\t// Strip path params if they appear in first segment (rare)\n\tconst cleaned = first.replace(/^\\{.+\\}$/, \"\");\n\treturn pluralize(kebabCase(cleaned || \"api\"));\n}\n\nfunction canonicalizeAction(action: string): string {\n\tconst a = kebabCase(action);\n\n\t// Common RPC verbs -> REST canonical verbs\n\tif (a === \"retrieve\" || a === \"read\") return \"get\";\n\tif (a === \"list\" || a === \"search\") return \"list\";\n\tif (a === \"create\") return \"create\";\n\tif (a === \"update\" || a === \"patch\") return \"update\";\n\tif (a === \"delete\" || a === \"remove\") return \"delete\";\n\n\treturn a;\n}\n\nfunction inferRestAction(op: NormalizedOperation): string {\n\t// If operationId is present and looks intentional, prefer it.\n\t// This helps with singleton endpoints like GET /ping (Ping.Get) vs collections.\n\tif (op.operationId) {\n\t\tconst { suffix } = splitOperationId(op.operationId);\n\t\tif (suffix) {\n\t\t\tconst fromId = canonicalizeAction(suffix);\n\t\t\tif (\n\t\t\t\tfromId === \"get\" ||\n\t\t\t\tfromId === \"list\" ||\n\t\t\t\tfromId === \"create\" ||\n\t\t\t\tfromId === \"update\" ||\n\t\t\t\tfromId === \"delete\"\n\t\t\t) {\n\t\t\t\treturn fromId;\n\t\t\t}\n\t\t}\n\t}\n\n\tconst method = op.method.toUpperCase();\n\tconst args = getPathArgs(op.path);\n\tconst hasId = args.length > 0;\n\n\tif (method === \"GET\" && !hasId) return \"list\";\n\tif (method === \"POST\" && !hasId) return \"create\";\n\n\tif (method === \"GET\" && hasId) return \"get\";\n\tif ((method === \"PUT\" || method === \"PATCH\") && hasId) return \"update\";\n\tif (method === \"DELETE\" && hasId) return \"delete\";\n\n\treturn kebabCase(method);\n}\n\nfunction inferRpcAction(op: NormalizedOperation): string {\n\t// Prefer operationId suffix: Contacts.List -> list\n\tif (op.operationId) {\n\t\tconst { suffix } = splitOperationId(op.operationId);\n\t\tif (suffix) return canonicalizeAction(suffix);\n\t}\n\n\t// Else take last segment and split by '.'\n\tconst segments = getPathSegments(op.path);\n\tconst last = segments[segments.length - 1] ?? \"\";\n\tif (last.includes(\".\")) {\n\t\tconst part = last.split(\".\").pop() ?? last;\n\t\treturn canonicalizeAction(part);\n\t}\n\n\treturn kebabCase(op.method);\n}\n\nexport function planOperation(op: NormalizedOperation): PlannedOperation {\n\tconst style = inferStyle(op);\n\tconst resource = inferResource(op);\n\tconst action = style === \"rpc\" ? inferRpcAction(op) : inferRestAction(op);\n\n\treturn {\n\t\t...op,\n\t\tkey: op.key,\n\t\tstyle,\n\t\tresource,\n\t\taction,\n\t\tcanonicalAction: action,\n\t\tpathArgs: getPathArgs(op.path).map((a) => kebabCase(a)),\n\t};\n}\n\nexport function planOperations(ops: NormalizedOperation[]): PlannedOperation[] {\n\tconst planned = ops.map(planOperation);\n\n\t// Stable collision handling: if resource+action repeats, add a suffix.\n\tconst counts = new Map<string, number>();\n\tfor (const op of planned) {\n\t\tconst key = `${op.resource}:${op.action}`;\n\t\tcounts.set(key, (counts.get(key) ?? 0) + 1);\n\t}\n\n\tconst seen = new Map<string, number>();\n\treturn planned.map((op) => {\n\t\tconst key = `${op.resource}:${op.action}`;\n\t\tconst total = counts.get(key) ?? 0;\n\t\tif (total <= 1) return op;\n\n\t\tconst idx = (seen.get(key) ?? 0) + 1;\n\t\tseen.set(key, idx);\n\n\t\tconst suffix = op.operationId\n\t\t\t? kebabCase(op.operationId)\n\t\t\t: kebabCase(`${op.method}-${op.path}`);\n\n\t\tconst disambiguatedAction = `${op.action}-${suffix}-${idx}`;\n\n\t\treturn {\n\t\t\t...op,\n\t\t\taction: disambiguatedAction,\n\t\t\taliasOf: `${op.resource} ${op.canonicalAction}`,\n\t\t};\n\t});\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "99ADFCE0CE9D3B1464756E2164756E21",
+  "names": []
+}

package/dist/src/cli/operations.d.ts

@@ -0,0 +1,3 @@
+import type { NormalizedOperation, OpenApiDoc } from "./types.js";
+export declare function indexOperations(doc: OpenApiDoc): NormalizedOperation[];
+//# sourceMappingURL=operations.d.ts.map

package/dist/src/cli/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../src/cli/operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,mBAAmB,EAGnB,UAAU,EACV,MAAM,YAAY,CAAC;AA6GpB,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,mBAAmB,EAAE,CAqCtE"}

package/dist/src/cli/operations.js

@@ -0,0 +1,103 @@
+// src/cli/operations.ts
+function operationKey(method, path) {
+  return `${method.toUpperCase()} ${path}`;
+}
+var HTTP_METHODS = [
+  "get",
+  "post",
+  "put",
+  "patch",
+  "delete",
+  "options",
+  "head",
+  "trace"
+];
+function normalizeParam(p) {
+  if (!p || typeof p !== "object")
+    return;
+  const loc = p.in;
+  const name = p.name;
+  if (loc !== "path" && loc !== "query" && loc !== "header" && loc !== "cookie") {
+    return;
+  }
+  if (!name)
+    return;
+  return {
+    in: loc,
+    name,
+    required: Boolean(p.required || loc === "path"),
+    description: p.description,
+    schema: p.schema
+  };
+}
+function mergeParameters(pathParams, opParams) {
+  const merged = new Map;
+  for (const p of pathParams ?? []) {
+    const normalized = normalizeParam(p);
+    if (!normalized)
+      continue;
+    merged.set(`${normalized.in}:${normalized.name}`, normalized);
+  }
+  for (const p of opParams ?? []) {
+    const normalized = normalizeParam(p);
+    if (!normalized)
+      continue;
+    merged.set(`${normalized.in}:${normalized.name}`, normalized);
+  }
+  return [...merged.values()];
+}
+function normalizeRequestBody(rb) {
+  if (!rb)
+    return;
+  const content = rb.content ?? {};
+  const contentTypes = Object.keys(content);
+  const schemasByContentType = {};
+  for (const contentType of contentTypes) {
+    schemasByContentType[contentType] = content[contentType]?.schema;
+  }
+  return {
+    required: Boolean(rb.required),
+    contentTypes,
+    schemasByContentType
+  };
+}
+function indexOperations(doc) {
+  const out = [];
+  const paths = doc.paths ?? {};
+  for (const [path, rawPathItem] of Object.entries(paths)) {
+    if (!rawPathItem || typeof rawPathItem !== "object")
+      continue;
+    const pathItem = rawPathItem;
+    for (const method of HTTP_METHODS) {
+      const op = pathItem[method];
+      if (!op)
+        continue;
+      const parameters = mergeParameters(pathItem.parameters, op.parameters);
+      const normalizedMethod = method.toUpperCase();
+      out.push({
+        key: operationKey(normalizedMethod, path),
+        method: normalizedMethod,
+        path,
+        operationId: op.operationId,
+        tags: op.tags ?? [],
+        summary: op.summary,
+        description: op.description,
+        deprecated: op.deprecated,
+        security: op.security ?? doc.security,
+        parameters,
+        requestBody: normalizeRequestBody(op.requestBody)
+      });
+    }
+  }
+  out.sort((a, b) => {
+    if (a.path !== b.path)
+      return a.path.localeCompare(b.path);
+    return a.method.localeCompare(b.method);
+  });
+  return out;
+}
+export {
+  indexOperations
+};
+
+//# debugId=C74131EC8AF45C3D64756E2164756E21

package/dist/src/cli/operations.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../src/cli/operations.ts"],
+  "sourcesContent": [
+    "import type {\n\tNormalizedOperation,\n\tNormalizedParameter,\n\tNormalizedRequestBody,\n\tOpenApiDoc,\n} from \"./types.ts\";\n\nfunction operationKey(method: string, path: string): string {\n\treturn `${method.toUpperCase()} ${path}`;\n}\n\nconst HTTP_METHODS = [\n\t\"get\",\n\t\"post\",\n\t\"put\",\n\t\"patch\",\n\t\"delete\",\n\t\"options\",\n\t\"head\",\n\t\"trace\",\n] as const;\n\ntype RawParameter = {\n\tin?: string;\n\tname?: string;\n\trequired?: boolean;\n\tdescription?: string;\n\tschema?: unknown;\n};\n\ntype RawRequestBody = {\n\trequired?: boolean;\n\tcontent?: Record<string, { schema?: unknown } | undefined>;\n};\n\ntype RawOperation = {\n\toperationId?: string;\n\ttags?: string[];\n\tsummary?: string;\n\tdescription?: string;\n\tdeprecated?: boolean;\n\tsecurity?: OpenApiDoc[\"security\"];\n\tparameters?: RawParameter[];\n\trequestBody?: RawRequestBody;\n};\n\ntype RawPathItem = {\n\tparameters?: RawParameter[];\n} & Partial<Record<(typeof HTTP_METHODS)[number], RawOperation>>;\n\nfunction normalizeParam(p: RawParameter): NormalizedParameter | undefined {\n\tif (!p || typeof p !== \"object\") return undefined;\n\tconst loc = p.in;\n\tconst name = p.name;\n\tif (\n\t\tloc !== \"path\" &&\n\t\tloc !== \"query\" &&\n\t\tloc !== \"header\" &&\n\t\tloc !== \"cookie\"\n\t) {\n\t\treturn undefined;\n\t}\n\tif (!name) return undefined;\n\n\treturn {\n\t\tin: loc,\n\t\tname,\n\t\trequired: Boolean(p.required || loc === \"path\"),\n\t\tdescription: p.description,\n\t\tschema: p.schema,\n\t};\n}\n\nfunction mergeParameters(\n\tpathParams: RawParameter[] | undefined,\n\topParams: RawParameter[] | undefined,\n): NormalizedParameter[] {\n\tconst merged = new Map<string, NormalizedParameter>();\n\n\tfor (const p of pathParams ?? []) {\n\t\tconst normalized = normalizeParam(p);\n\t\tif (!normalized) continue;\n\t\tmerged.set(`${normalized.in}:${normalized.name}`, normalized);\n\t}\n\n\tfor (const p of opParams ?? []) {\n\t\tconst normalized = normalizeParam(p);\n\t\tif (!normalized) continue;\n\t\tmerged.set(`${normalized.in}:${normalized.name}`, normalized);\n\t}\n\n\treturn [...merged.values()];\n}\n\nfunction normalizeRequestBody(\n\trb: RawRequestBody | undefined,\n): NormalizedRequestBody | undefined {\n\tif (!rb) return undefined;\n\n\tconst content = rb.content ?? {};\n\tconst contentTypes = Object.keys(content);\n\tconst schemasByContentType: Record<string, unknown | undefined> = {};\n\n\tfor (const contentType of contentTypes) {\n\t\tschemasByContentType[contentType] = content[contentType]?.schema;\n\t}\n\n\treturn {\n\t\trequired: Boolean(rb.required),\n\t\tcontentTypes,\n\t\tschemasByContentType,\n\t};\n}\n\nexport function indexOperations(doc: OpenApiDoc): NormalizedOperation[] {\n\tconst out: NormalizedOperation[] = [];\n\tconst paths = doc.paths ?? {};\n\n\tfor (const [path, rawPathItem] of Object.entries(paths)) {\n\t\tif (!rawPathItem || typeof rawPathItem !== \"object\") continue;\n\n\t\tconst pathItem = rawPathItem as RawPathItem;\n\n\t\tfor (const method of HTTP_METHODS) {\n\t\t\tconst op = pathItem[method];\n\t\t\tif (!op) continue;\n\n\t\t\tconst parameters = mergeParameters(pathItem.parameters, op.parameters);\n\t\t\tconst normalizedMethod = method.toUpperCase();\n\t\t\tout.push({\n\t\t\t\tkey: operationKey(normalizedMethod, path),\n\t\t\t\tmethod: normalizedMethod,\n\t\t\t\tpath,\n\t\t\t\toperationId: op.operationId,\n\t\t\t\ttags: op.tags ?? [],\n\t\t\t\tsummary: op.summary,\n\t\t\t\tdescription: op.description,\n\t\t\t\tdeprecated: op.deprecated,\n\t\t\t\tsecurity: (op.security ?? doc.security) as OpenApiDoc[\"security\"],\n\t\t\t\tparameters,\n\t\t\t\trequestBody: normalizeRequestBody(op.requestBody),\n\t\t\t});\n\t\t}\n\t}\n\n\tout.sort((a, b) => {\n\t\tif (a.path !== b.path) return a.path.localeCompare(b.path);\n\t\treturn a.method.localeCompare(b.method);\n\t});\n\n\treturn out;\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "C74131EC8AF45C3D64756E2164756E21",
+  "names": []
+}

package/dist/src/cli/params.d.ts

@@ -0,0 +1,19 @@
+import type { NormalizedOperation, NormalizedParameter } from "./types.js";
+export type ParamType = import("./schema-shape.js").ParamType;
+export type ParamSpec = {
+    kind: "positional" | "flag";
+    in: NormalizedParameter["in"];
+    name: string;
+    flag: string;
+    required: boolean;
+    description?: string;
+    type: ParamType;
+    format?: string;
+    enum?: string[];
+    itemType?: ParamType;
+    itemFormat?: string;
+    itemEnum?: string[];
+    schema?: import("./types.js").JsonSchema;
+};
+export declare function deriveParamSpecs(op: NormalizedOperation): ParamSpec[];
+//# sourceMappingURL=params.d.ts.map

package/dist/src/cli/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../../src/cli/params.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE3E,MAAM,MAAM,SAAS,GAAG,OAAO,mBAAmB,EAAE,SAAS,CAAC;AAE9D,MAAM,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IAC5B,EAAE,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAGhB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAGpB,MAAM,CAAC,EAAE,OAAO,YAAY,EAAE,UAAU,CAAC;CACzC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,mBAAmB,GAAG,SAAS,EAAE,CAwCrE"}

package/dist/src/cli/params.js

@@ -0,0 +1,79 @@
+// src/cli/schema-shape.ts
+function getSchemaType(schema) {
+  if (!schema || typeof schema !== "object")
+    return "unknown";
+  const t = schema.type;
+  if (t === "string")
+    return "string";
+  if (t === "number")
+    return "number";
+  if (t === "integer")
+    return "integer";
+  if (t === "boolean")
+    return "boolean";
+  if (t === "array")
+    return "array";
+  if (t === "object")
+    return "object";
+  return "unknown";
+}
+function getSchemaFormat(schema) {
+  if (!schema || typeof schema !== "object")
+    return;
+  const f = schema.format;
+  return typeof f === "string" ? f : undefined;
+}
+function getSchemaEnumStrings(schema) {
+  if (!schema || typeof schema !== "object")
+    return;
+  const e = schema.enum;
+  if (!Array.isArray(e))
+    return;
+  const values = e.filter((v) => typeof v === "string");
+  return values.length ? values : undefined;
+}
+
+// src/cli/strings.ts
+function kebabCase(input) {
+  const trimmed = input.trim();
+  if (!trimmed)
+    return "";
+  return trimmed.replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/[\s_.:/]+/g, "-").replace(/[^a-zA-Z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").toLowerCase();
+}
+
+// src/cli/params.ts
+function deriveParamSpecs(op) {
+  const out = [];
+  for (const p of op.parameters) {
+    const flag = `--${kebabCase(p.name)}`;
+    const type = getSchemaType(p.schema);
+    const schemaObj = p.schema && typeof p.schema === "object" ? p.schema : undefined;
+    const itemsSchema = schemaObj && type === "array" && typeof schemaObj.items === "object" ? schemaObj.items : undefined;
+    out.push({
+      kind: p.in === "path" ? "positional" : "flag",
+      in: p.in,
+      name: p.name,
+      flag,
+      required: p.required,
+      description: p.description,
+      type,
+      format: getSchemaFormat(p.schema),
+      enum: getSchemaEnumStrings(p.schema),
+      itemType: type === "array" ? getSchemaType(itemsSchema) : undefined,
+      itemFormat: type === "array" ? getSchemaFormat(itemsSchema) : undefined,
+      itemEnum: type === "array" ? getSchemaEnumStrings(itemsSchema) : undefined,
+      schema: schemaObj
+    });
+  }
+  out.sort((a, b) => {
+    if (a.in !== b.in)
+      return a.in.localeCompare(b.in);
+    return a.name.localeCompare(b.name);
+  });
+  return out;
+}
+export {
+  deriveParamSpecs
+};
+
+//# debugId=1318B970EA1D049964756E2164756E21

package/dist/src/cli/params.js.map

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["../../../src/cli/schema-shape.ts", "../../../src/cli/strings.ts", "../../../src/cli/params.ts"],
+  "sourcesContent": [
+    "export type ParamType =\n\t| \"string\"\n\t| \"number\"\n\t| \"integer\"\n\t| \"boolean\"\n\t| \"array\"\n\t| \"object\"\n\t| \"unknown\";\n\nexport function getSchemaType(schema: unknown): ParamType {\n\tif (!schema || typeof schema !== \"object\") return \"unknown\";\n\tconst t = (schema as { type?: unknown }).type;\n\tif (t === \"string\") return \"string\";\n\tif (t === \"number\") return \"number\";\n\tif (t === \"integer\") return \"integer\";\n\tif (t === \"boolean\") return \"boolean\";\n\tif (t === \"array\") return \"array\";\n\tif (t === \"object\") return \"object\";\n\treturn \"unknown\";\n}\n\nexport function getSchemaFormat(schema: unknown): string | undefined {\n\tif (!schema || typeof schema !== \"object\") return undefined;\n\tconst f = (schema as { format?: unknown }).format;\n\treturn typeof f === \"string\" ? f : undefined;\n}\n\nexport function getSchemaEnumStrings(schema: unknown): string[] | undefined {\n\tif (!schema || typeof schema !== \"object\") return undefined;\n\tconst e = (schema as { enum?: unknown }).enum;\n\tif (!Array.isArray(e)) return undefined;\n\n\t// We only surface string enums for now (enough for flag docs + completion).\n\tconst values = e.filter((v) => typeof v === \"string\") as string[];\n\treturn values.length ? values : undefined;\n}\n",
+    "export function kebabCase(input: string): string {\n\tconst trimmed = input.trim();\n\tif (!trimmed) return \"\";\n\n\t// Convert spaces/underscores/dots to dashes, split camelCase.\n\treturn trimmed\n\t\t.replace(/([a-z0-9])([A-Z])/g, \"$1-$2\")\n\t\t.replace(/[\\s_.:/]+/g, \"-\")\n\t\t.replace(/[^a-zA-Z0-9-]/g, \"-\")\n\t\t.replace(/-+/g, \"-\")\n\t\t.replace(/^-|-$/g, \"\")\n\t\t.toLowerCase();\n}\n\nexport function titleCase(input: string): string {\n\treturn input\n\t\t.split(/\\s+/g)\n\t\t.filter(Boolean)\n\t\t.map((w) => w[0]?.toUpperCase() + w.slice(1))\n\t\t.join(\" \");\n}\n",
+    "import {\n\tgetSchemaEnumStrings,\n\tgetSchemaFormat,\n\tgetSchemaType,\n} from \"./schema-shape.ts\";\nimport { kebabCase } from \"./strings.ts\";\nimport type { NormalizedOperation, NormalizedParameter } from \"./types.ts\";\n\nexport type ParamType = import(\"./schema-shape.ts\").ParamType;\n\nexport type ParamSpec = {\n\tkind: \"positional\" | \"flag\";\n\tin: NormalizedParameter[\"in\"];\n\tname: string;\n\tflag: string;\n\trequired: boolean;\n\tdescription?: string;\n\ttype: ParamType;\n\tformat?: string;\n\tenum?: string[];\n\n\t// Arrays\n\titemType?: ParamType;\n\titemFormat?: string;\n\titemEnum?: string[];\n\n\t// Original schema for Ajv validation and future advanced flag expansion.\n\tschema?: import(\"./types.ts\").JsonSchema;\n};\n\nexport function deriveParamSpecs(op: NormalizedOperation): ParamSpec[] {\n\tconst out: ParamSpec[] = [];\n\n\tfor (const p of op.parameters) {\n\t\tconst flag = `--${kebabCase(p.name)}`;\n\t\tconst type = getSchemaType(p.schema);\n\t\tconst schemaObj =\n\t\t\tp.schema && typeof p.schema === \"object\"\n\t\t\t\t? (p.schema as import(\"./types.ts\").JsonSchema)\n\t\t\t\t: undefined;\n\n\t\tconst itemsSchema =\n\t\t\tschemaObj && type === \"array\" && typeof schemaObj.items === \"object\"\n\t\t\t\t? (schemaObj.items as unknown)\n\t\t\t\t: undefined;\n\n\t\tout.push({\n\t\t\tkind: p.in === \"path\" ? \"positional\" : \"flag\",\n\t\t\tin: p.in,\n\t\t\tname: p.name,\n\t\t\tflag,\n\t\t\trequired: p.required,\n\t\t\tdescription: p.description,\n\t\t\ttype,\n\t\t\tformat: getSchemaFormat(p.schema),\n\t\t\tenum: getSchemaEnumStrings(p.schema),\n\t\t\titemType: type === \"array\" ? getSchemaType(itemsSchema) : undefined,\n\t\t\titemFormat: type === \"array\" ? getSchemaFormat(itemsSchema) : undefined,\n\t\t\titemEnum:\n\t\t\t\ttype === \"array\" ? getSchemaEnumStrings(itemsSchema) : undefined,\n\t\t\tschema: schemaObj,\n\t\t});\n\t}\n\n\tout.sort((a, b) => {\n\t\tif (a.in !== b.in) return a.in.localeCompare(b.in);\n\t\treturn a.name.localeCompare(b.name);\n\t});\n\n\treturn out;\n}\n"
+  ],
+  "mappings": ";AASO,SAAS,aAAa,CAAC,QAA4B;AAAA,EACzD,IAAI,CAAC,UAAU,OAAO,WAAW;AAAA,IAAU,OAAO;AAAA,EAClD,MAAM,IAAK,OAA8B;AAAA,EACzC,IAAI,MAAM;AAAA,IAAU,OAAO;AAAA,EAC3B,IAAI,MAAM;AAAA,IAAU,OAAO;AAAA,EAC3B,IAAI,MAAM;AAAA,IAAW,OAAO;AAAA,EAC5B,IAAI,MAAM;AAAA,IAAW,OAAO;AAAA,EAC5B,IAAI,MAAM;AAAA,IAAS,OAAO;AAAA,EAC1B,IAAI,MAAM;AAAA,IAAU,OAAO;AAAA,EAC3B,OAAO;AAAA;AAGD,SAAS,eAAe,CAAC,QAAqC;AAAA,EACpE,IAAI,CAAC,UAAU,OAAO,WAAW;AAAA,IAAU;AAAA,EAC3C,MAAM,IAAK,OAAgC;AAAA,EAC3C,OAAO,OAAO,MAAM,WAAW,IAAI;AAAA;AAG7B,SAAS,oBAAoB,CAAC,QAAuC;AAAA,EAC3E,IAAI,CAAC,UAAU,OAAO,WAAW;AAAA,IAAU;AAAA,EAC3C,MAAM,IAAK,OAA8B;AAAA,EACzC,IAAI,CAAC,MAAM,QAAQ,CAAC;AAAA,IAAG;AAAA,EAGvB,MAAM,SAAS,EAAE,OAAO,CAAC,MAAM,OAAO,MAAM,QAAQ;AAAA,EACpD,OAAO,OAAO,SAAS,SAAS;AAAA;;;AClC1B,SAAS,SAAS,CAAC,OAAuB;AAAA,EAChD,MAAM,UAAU,MAAM,KAAK;AAAA,EAC3B,IAAI,CAAC;AAAA,IAAS,OAAO;AAAA,EAGrB,OAAO,QACL,QAAQ,sBAAsB,OAAO,EACrC,QAAQ,cAAc,GAAG,EACzB,QAAQ,kBAAkB,GAAG,EAC7B,QAAQ,OAAO,GAAG,EAClB,QAAQ,UAAU,EAAE,EACpB,YAAY;AAAA;;;ACmBR,SAAS,gBAAgB,CAAC,IAAsC;AAAA,EACtE,MAAM,MAAmB,CAAC;AAAA,EAE1B,WAAW,KAAK,GAAG,YAAY;AAAA,IAC9B,MAAM,OAAO,KAAK,UAAU,EAAE,IAAI;AAAA,IAClC,MAAM,OAAO,cAAc,EAAE,MAAM;AAAA,IACnC,MAAM,YACL,EAAE,UAAU,OAAO,EAAE,WAAW,WAC5B,EAAE,SACH;AAAA,IAEJ,MAAM,cACL,aAAa,SAAS,WAAW,OAAO,UAAU,UAAU,WACxD,UAAU,QACX;AAAA,IAEJ,IAAI,KAAK;AAAA,MACR,MAAM,EAAE,OAAO,SAAS,eAAe;AAAA,MACvC,IAAI,EAAE;AAAA,MACN,MAAM,EAAE;AAAA,MACR;AAAA,MACA,UAAU,EAAE;AAAA,MACZ,aAAa,EAAE;AAAA,MACf;AAAA,MACA,QAAQ,gBAAgB,EAAE,MAAM;AAAA,MAChC,MAAM,qBAAqB,EAAE,MAAM;AAAA,MACnC,UAAU,SAAS,UAAU,cAAc,WAAW,IAAI;AAAA,MAC1D,YAAY,SAAS,UAAU,gBAAgB,WAAW,IAAI;AAAA,MAC9D,UACC,SAAS,UAAU,qBAAqB,WAAW,IAAI;AAAA,MACxD,QAAQ;AAAA,IACT,CAAC;AAAA,EACF;AAAA,EAEA,IAAI,KAAK,CAAC,GAAG,MAAM;AAAA,IAClB,IAAI,EAAE,OAAO,EAAE;AAAA,MAAI,OAAO,EAAE,GAAG,cAAc,EAAE,EAAE;AAAA,IACjD,OAAO,EAAE,KAAK,cAAc,EAAE,IAAI;AAAA,GAClC;AAAA,EAED,OAAO;AAAA;",
+  "debugId": "1318B970EA1D049964756E2164756E21",
+  "names": []
+}

package/dist/src/cli/pluralize.d.ts

@@ -0,0 +1,2 @@
+export declare function pluralize(word: string): string;
+//# sourceMappingURL=pluralize.d.ts.map

package/dist/src/cli/pluralize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluralize.d.ts","sourceRoot":"","sources":["../../../src/cli/pluralize.ts"],"names":[],"mappings":"AAoBA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoB9C"}

package/dist/src/cli/pluralize.js

@@ -0,0 +1,43 @@
+// src/cli/pluralize.ts
+var IRREGULAR = {
+  person: "people",
+  man: "men",
+  woman: "women",
+  child: "children",
+  tooth: "teeth",
+  foot: "feet",
+  mouse: "mice",
+  goose: "geese"
+};
+var UNCOUNTABLE = new Set([
+  "metadata",
+  "information",
+  "equipment",
+  "money",
+  "series",
+  "species"
+]);
+function pluralize(word) {
+  const w = word.trim();
+  if (!w)
+    return w;
+  const lower = w.toLowerCase();
+  if (UNCOUNTABLE.has(lower))
+    return lower;
+  if (IRREGULAR[lower])
+    return IRREGULAR[lower];
+  if (lower.endsWith("s"))
+    return lower;
+  if (/[bcdfghjklmnpqrstvwxyz]y$/.test(lower)) {
+    return lower.replace(/y$/, "ies");
+  }
+  if (/(ch|sh|x|z)$/.test(lower)) {
+    return `${lower}es`;
+  }
+  return `${lower}s`;
+}
+export {
+  pluralize
+};
+
+//# debugId=DB29AA914B97043364756E2164756E21

package/dist/src/cli/pluralize.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../src/cli/pluralize.ts"],
+  "sourcesContent": [
+    "const IRREGULAR: Record<string, string> = {\n\tperson: \"people\",\n\tman: \"men\",\n\twoman: \"women\",\n\tchild: \"children\",\n\ttooth: \"teeth\",\n\tfoot: \"feet\",\n\tmouse: \"mice\",\n\tgoose: \"geese\",\n};\n\nconst UNCOUNTABLE = new Set([\n\t\"metadata\",\n\t\"information\",\n\t\"equipment\",\n\t\"money\",\n\t\"series\",\n\t\"species\",\n]);\n\nexport function pluralize(word: string): string {\n\tconst w = word.trim();\n\tif (!w) return w;\n\n\tconst lower = w.toLowerCase();\n\tif (UNCOUNTABLE.has(lower)) return lower;\n\tif (IRREGULAR[lower]) return IRREGULAR[lower];\n\n\t// already plural-ish\n\tif (lower.endsWith(\"s\")) return lower;\n\n\tif (/[bcdfghjklmnpqrstvwxyz]y$/.test(lower)) {\n\t\treturn lower.replace(/y$/, \"ies\");\n\t}\n\n\tif (/(ch|sh|x|z)$/.test(lower)) {\n\t\treturn `${lower}es`;\n\t}\n\n\treturn `${lower}s`;\n}\n"
+  ],
+  "mappings": ";AAAA,IAAM,YAAoC;AAAA,EACzC,QAAQ;AAAA,EACR,KAAK;AAAA,EACL,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AACR;AAEA,IAAM,cAAc,IAAI,IAAI;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACD,CAAC;AAEM,SAAS,SAAS,CAAC,MAAsB;AAAA,EAC/C,MAAM,IAAI,KAAK,KAAK;AAAA,EACpB,IAAI,CAAC;AAAA,IAAG,OAAO;AAAA,EAEf,MAAM,QAAQ,EAAE,YAAY;AAAA,EAC5B,IAAI,YAAY,IAAI,KAAK;AAAA,IAAG,OAAO;AAAA,EACnC,IAAI,UAAU;AAAA,IAAQ,OAAO,UAAU;AAAA,EAGvC,IAAI,MAAM,SAAS,GAAG;AAAA,IAAG,OAAO;AAAA,EAEhC,IAAI,4BAA4B,KAAK,KAAK,GAAG;AAAA,IAC5C,OAAO,MAAM,QAAQ,MAAM,KAAK;AAAA,EACjC;AAAA,EAEA,IAAI,eAAe,KAAK,KAAK,GAAG;AAAA,IAC/B,OAAO,GAAG;AAAA,EACX;AAAA,EAEA,OAAO,GAAG;AAAA;",
+  "debugId": "DB29AA914B97043364756E2164756E21",
+  "names": []
+}

package/dist/src/cli/positional.d.ts

@@ -0,0 +1,19 @@
+import type { ParamSpec } from "./params.js";
+export type ActionShapeForCli = {
+    pathArgs: string[];
+    params: ParamSpec[];
+};
+export type PositionalArg = {
+    name: string;
+    required: boolean;
+    description?: string;
+    type: import("./schema-shape.js").ParamType;
+    format?: string;
+    enum?: string[];
+};
+export type FlagsIndex = {
+    flags: Array<Pick<import("./params.js").ParamSpec, "in" | "name" | "flag" | "required" | "description" | "type" | "format" | "enum" | "itemType" | "itemFormat" | "itemEnum">>;
+};
+export declare function derivePositionals(action: ActionShapeForCli): PositionalArg[];
+export declare function deriveFlags(action: ActionShapeForCli): FlagsIndex;
+//# sourceMappingURL=positional.d.ts.map

package/dist/src/cli/positional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positional.d.ts","sourceRoot":"","sources":["../../../src/cli/positional.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,SAAS,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,OAAO,mBAAmB,EAAE,SAAS,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE,KAAK,CACX,IAAI,CACH,OAAO,aAAa,EAAE,SAAS,EAC7B,IAAI,GACJ,MAAM,GACN,MAAM,GACN,UAAU,GACV,aAAa,GACb,MAAM,GACN,QAAQ,GACR,MAAM,GACN,UAAU,GACV,YAAY,GACZ,UAAU,CACZ,CACD,CAAC;CACF,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,aAAa,EAAE,CAmB5E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,UAAU,CAkBjE"}

package/dist/src/cli/positional.js

@@ -0,0 +1,39 @@
+// src/cli/positional.ts
+function derivePositionals(action) {
+  const byName = new Map;
+  for (const name of action.pathArgs) {
+    const p = action.params.find((x) => x.in === "path" && x.name === name);
+    byName.set(name, {
+      name,
+      required: true,
+      description: p?.description,
+      type: p?.type ?? "unknown",
+      format: p?.format,
+      enum: p?.enum
+    });
+  }
+  return [...byName.values()];
+}
+function deriveFlags(action) {
+  return {
+    flags: action.params.filter((p) => p.kind === "flag").map((p) => ({
+      in: p.in,
+      name: p.name,
+      flag: p.flag,
+      required: p.required,
+      description: p.description,
+      type: p.type,
+      format: p.format,
+      enum: p.enum,
+      itemType: p.itemType,
+      itemFormat: p.itemFormat,
+      itemEnum: p.itemEnum
+    }))
+  };
+}
+export {
+  derivePositionals,
+  deriveFlags
+};
+
+//# debugId=16EFAB2F171B486164756E2164756E21