@wirecat/cli-core 0.0.0 → 0.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (173) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +344 -0
  3. package/config/biome.base.json +56 -0
  4. package/config/cspell.json +56 -0
  5. package/config/lefthook.yml +34 -0
  6. package/config/rumdl.toml +9 -0
  7. package/config/tsconfig.base.json +21 -0
  8. package/config/tsconfig.scripts.json +13 -0
  9. package/config/tsconfig.test.json +11 -0
  10. package/config/vale/CliDocs/Filler.yml +9 -0
  11. package/config/vale/CliDocs/SentenceLength.yml +6 -0
  12. package/config/vale/Tg/Tone.yml +7 -0
  13. package/dist/codegen/index.d.ts +12 -0
  14. package/dist/codegen/index.d.ts.map +1 -0
  15. package/dist/codegen/index.js +11 -0
  16. package/dist/codegen/index.js.map +1 -0
  17. package/dist/codegen/manifest.d.ts +47 -0
  18. package/dist/codegen/manifest.d.ts.map +1 -0
  19. package/dist/codegen/manifest.js +73 -0
  20. package/dist/codegen/manifest.js.map +1 -0
  21. package/dist/codegen/model.d.ts +146 -0
  22. package/dist/codegen/model.d.ts.map +1 -0
  23. package/dist/codegen/model.js +7 -0
  24. package/dist/codegen/model.js.map +1 -0
  25. package/dist/codegen/names.d.ts +4 -0
  26. package/dist/codegen/names.d.ts.map +1 -0
  27. package/dist/codegen/names.js +46 -0
  28. package/dist/codegen/names.js.map +1 -0
  29. package/dist/codegen/pipeline.d.ts +24 -0
  30. package/dist/codegen/pipeline.d.ts.map +1 -0
  31. package/dist/codegen/pipeline.js +193 -0
  32. package/dist/codegen/pipeline.js.map +1 -0
  33. package/dist/codegen/runtime.d.ts +24 -0
  34. package/dist/codegen/runtime.d.ts.map +1 -0
  35. package/dist/codegen/runtime.js +38 -0
  36. package/dist/codegen/runtime.js.map +1 -0
  37. package/dist/codegen/tree.d.ts +29 -0
  38. package/dist/codegen/tree.d.ts.map +1 -0
  39. package/dist/codegen/tree.js +87 -0
  40. package/dist/codegen/tree.js.map +1 -0
  41. package/dist/codegen/typescript.d.ts +6 -0
  42. package/dist/codegen/typescript.d.ts.map +1 -0
  43. package/dist/codegen/typescript.js +78 -0
  44. package/dist/codegen/typescript.js.map +1 -0
  45. package/dist/codegen/valibot.d.ts +10 -0
  46. package/dist/codegen/valibot.d.ts.map +1 -0
  47. package/dist/codegen/valibot.js +132 -0
  48. package/dist/codegen/valibot.js.map +1 -0
  49. package/dist/commands/index.d.ts +76 -0
  50. package/dist/commands/index.d.ts.map +1 -0
  51. package/dist/commands/index.js +62 -0
  52. package/dist/commands/index.js.map +1 -0
  53. package/dist/commands/page.d.ts +80 -0
  54. package/dist/commands/page.d.ts.map +1 -0
  55. package/dist/commands/page.js +100 -0
  56. package/dist/commands/page.js.map +1 -0
  57. package/dist/completion/index.d.ts +37 -0
  58. package/dist/completion/index.d.ts.map +1 -0
  59. package/dist/completion/index.js +87 -0
  60. package/dist/completion/index.js.map +1 -0
  61. package/dist/config.d.ts +20 -0
  62. package/dist/config.d.ts.map +1 -0
  63. package/dist/config.js +61 -0
  64. package/dist/config.js.map +1 -0
  65. package/dist/credentials.d.ts +48 -0
  66. package/dist/credentials.d.ts.map +1 -0
  67. package/dist/credentials.js +120 -0
  68. package/dist/credentials.js.map +1 -0
  69. package/dist/dev/bin.d.ts +3 -0
  70. package/dist/dev/bin.d.ts.map +1 -0
  71. package/dist/dev/bin.js +8 -0
  72. package/dist/dev/bin.js.map +1 -0
  73. package/dist/dev/main.d.ts +7 -0
  74. package/dist/dev/main.d.ts.map +1 -0
  75. package/dist/dev/main.js +149 -0
  76. package/dist/dev/main.js.map +1 -0
  77. package/dist/dev/next-version.d.ts +11 -0
  78. package/dist/dev/next-version.d.ts.map +1 -0
  79. package/dist/dev/next-version.js +33 -0
  80. package/dist/dev/next-version.js.map +1 -0
  81. package/dist/dev/slow-tests.d.ts +14 -0
  82. package/dist/dev/slow-tests.d.ts.map +1 -0
  83. package/dist/dev/slow-tests.js +17 -0
  84. package/dist/dev/slow-tests.js.map +1 -0
  85. package/dist/dev/test-matrix.d.ts +35 -0
  86. package/dist/dev/test-matrix.d.ts.map +1 -0
  87. package/dist/dev/test-matrix.js +93 -0
  88. package/dist/dev/test-matrix.js.map +1 -0
  89. package/dist/errors.d.ts +34 -0
  90. package/dist/errors.d.ts.map +1 -0
  91. package/dist/errors.js +36 -0
  92. package/dist/errors.js.map +1 -0
  93. package/dist/exit-codes.d.ts +11 -0
  94. package/dist/exit-codes.d.ts.map +1 -0
  95. package/dist/exit-codes.js +25 -0
  96. package/dist/exit-codes.js.map +1 -0
  97. package/dist/http/index.d.ts +20 -0
  98. package/dist/http/index.d.ts.map +1 -0
  99. package/dist/http/index.js +46 -0
  100. package/dist/http/index.js.map +1 -0
  101. package/dist/index.d.ts +16 -0
  102. package/dist/index.d.ts.map +1 -0
  103. package/dist/index.js +15 -0
  104. package/dist/index.js.map +1 -0
  105. package/dist/keyring.d.ts +27 -0
  106. package/dist/keyring.d.ts.map +1 -0
  107. package/dist/keyring.js +45 -0
  108. package/dist/keyring.js.map +1 -0
  109. package/dist/logger.d.ts +12 -0
  110. package/dist/logger.d.ts.map +1 -0
  111. package/dist/logger.js +7 -0
  112. package/dist/logger.js.map +1 -0
  113. package/dist/logging.d.ts +31 -0
  114. package/dist/logging.d.ts.map +1 -0
  115. package/dist/logging.js +58 -0
  116. package/dist/logging.js.map +1 -0
  117. package/dist/mcp/index.d.ts +32 -0
  118. package/dist/mcp/index.d.ts.map +1 -0
  119. package/dist/mcp/index.js +105 -0
  120. package/dist/mcp/index.js.map +1 -0
  121. package/dist/paths.d.ts +28 -0
  122. package/dist/paths.d.ts.map +1 -0
  123. package/dist/paths.js +23 -0
  124. package/dist/paths.js.map +1 -0
  125. package/dist/pretty.d.ts +12 -0
  126. package/dist/pretty.d.ts.map +1 -0
  127. package/dist/pretty.js +83 -0
  128. package/dist/pretty.js.map +1 -0
  129. package/dist/release/index.d.ts +38 -0
  130. package/dist/release/index.d.ts.map +1 -0
  131. package/dist/release/index.js +91 -0
  132. package/dist/release/index.js.map +1 -0
  133. package/dist/release/markdown.d.ts +36 -0
  134. package/dist/release/markdown.d.ts.map +1 -0
  135. package/dist/release/markdown.js +153 -0
  136. package/dist/release/markdown.js.map +1 -0
  137. package/dist/release/structure.d.ts +16 -0
  138. package/dist/release/structure.d.ts.map +1 -0
  139. package/dist/release/structure.js +74 -0
  140. package/dist/release/structure.js.map +1 -0
  141. package/dist/renderer.d.ts +34 -0
  142. package/dist/renderer.d.ts.map +1 -0
  143. package/dist/renderer.js +55 -0
  144. package/dist/renderer.js.map +1 -0
  145. package/dist/retry.d.ts +27 -0
  146. package/dist/retry.d.ts.map +1 -0
  147. package/dist/retry.js +26 -0
  148. package/dist/retry.js.map +1 -0
  149. package/dist/sanitize.d.ts +25 -0
  150. package/dist/sanitize.d.ts.map +1 -0
  151. package/dist/sanitize.js +52 -0
  152. package/dist/sanitize.js.map +1 -0
  153. package/dist/skill/index.d.ts +78 -0
  154. package/dist/skill/index.d.ts.map +1 -0
  155. package/dist/skill/index.js +190 -0
  156. package/dist/skill/index.js.map +1 -0
  157. package/dist/streams.d.ts +24 -0
  158. package/dist/streams.d.ts.map +1 -0
  159. package/dist/streams.js +26 -0
  160. package/dist/streams.js.map +1 -0
  161. package/dist/testing/index.d.ts +24 -0
  162. package/dist/testing/index.d.ts.map +1 -0
  163. package/dist/testing/index.js +29 -0
  164. package/dist/testing/index.js.map +1 -0
  165. package/dist/time.d.ts +21 -0
  166. package/dist/time.d.ts.map +1 -0
  167. package/dist/time.js +19 -0
  168. package/dist/time.js.map +1 -0
  169. package/dist/update/index.d.ts +80 -0
  170. package/dist/update/index.d.ts.map +1 -0
  171. package/dist/update/index.js +159 -0
  172. package/dist/update/index.js.map +1 -0
  173. package/package.json +116 -2
@@ -0,0 +1,38 @@
1
+ /**
2
+ * What generated Valibot schemas call at run time. Kept apart from the generator so a CLI loads
3
+ * these few functions, not the code that writes code.
4
+ *
5
+ * Numbers arrive from a lossless JSON parser (`lossless-json` or anything shaped like its
6
+ * `LosslessNumber`), because a 64-bit id read as a JS number is silently a different id.
7
+ */
8
+ import * as v from "valibot";
9
+ const isLossless = (input) => typeof input === "object" &&
10
+ input !== null &&
11
+ input.isLosslessNumber === true &&
12
+ typeof input.value === "string";
13
+ const INTEGER = /^-?\d+$/;
14
+ const INT64_MIN = -(2n ** 63n);
15
+ const INT64_MAX = 2n ** 63n - 1n;
16
+ const digitsOf = (input) => {
17
+ if (isLossless(input))
18
+ return INTEGER.test(input.value) ? input.value : undefined;
19
+ if (typeof input === "bigint")
20
+ return input.toString();
21
+ if (typeof input === "number" && Number.isSafeInteger(input))
22
+ return String(input);
23
+ return undefined;
24
+ };
25
+ const inRange = (value, { minimum, maximum }) => (minimum === undefined || value >= minimum) && (maximum === undefined || value <= maximum);
26
+ /** A 64-bit integer, handed on as its exact decimal string. */
27
+ export const int64 = (range = {}) => v.pipe(v.custom((input) => digitsOf(input) !== undefined, "expected an integer"), v.transform((input) => digitsOf(input)), v.check((digits) => {
28
+ const value = BigInt(digits);
29
+ return value >= INT64_MIN && value <= INT64_MAX && inRange(value, range);
30
+ }, "integer out of range"));
31
+ /** An integer that must fit a JS number exactly; one that does not fails instead of rounding. */
32
+ export const integer = (range = {}) => v.pipe(v.custom((input) => {
33
+ const digits = digitsOf(input);
34
+ return digits !== undefined && Number.isSafeInteger(Number(digits));
35
+ }, "expected an integer within ±2^53"), v.transform((input) => Number(digitsOf(input))), v.check((value) => inRange(value, range), "integer out of range"));
36
+ export const number = (range = {}) => v.pipe(v.custom((input) => (isLossless(input) ? Number.isFinite(Number(input.value)) : Number.isFinite(input)), "expected a number"), v.transform((input) => (isLossless(input) ? Number(input.value) : input)), v.check((value) => inRange(value, range), "number out of range"));
37
+ export const unique = (items) => new Set(items.map((item) => JSON.stringify(item))).size === items.length;
38
+ //# sourceMappingURL=runtime.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/codegen/runtime.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,29 @@
1
+ import type { ApiModel, ApiSchema, SchemaNode } from "./model.js";
2
+ type ObjectNode = Extract<SchemaNode, {
3
+ type: "object";
4
+ }>;
5
+ export interface NamedSchema {
6
+ name: string;
7
+ schema: ApiSchema;
8
+ }
9
+ /**
10
+ * The schema index generators share: named components, inline request and response bodies given a
11
+ * name of their own, and which subtype each discriminator value selects.
12
+ */
13
+ export declare class SchemaTree {
14
+ #private;
15
+ readonly named: NamedSchema[];
16
+ constructor(model: ApiModel);
17
+ schema(id: string): ApiSchema;
18
+ requestName(operationId: string): string | undefined;
19
+ responseName(operationId: string): string | undefined;
20
+ /** The value a subtype's discriminator property must hold, if the schema is a subtype. */
21
+ literalFor(id: string): {
22
+ property: string;
23
+ value: string;
24
+ } | undefined;
25
+ /** Merges inheritance into one object. A member that is not an object stops generation. */
26
+ flatten(node: SchemaNode, where: string): ObjectNode;
27
+ }
28
+ export {};
29
+ //# sourceMappingURL=tree.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/codegen/tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAIjE,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAA;AAEzD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,SAAS,CAAA;CAClB;AAED;;;GAGG;AACH,qBAAa,UAAU;;IACrB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,CAAA;IAM7B,YAAY,KAAK,EAAE,QAAQ,EA8B1B;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAI5B;IAED,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnD;IAED,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEpD;IAED,0FAA0F;IAC1F,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAEtE;IAED,2FAA2F;IAC3F,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAiBnD;CACF"}
@@ -0,0 +1,87 @@
1
+ import { identifier } from "./names.js";
2
+ import { CodegenError } from "./pipeline.js";
3
+ /**
4
+ * The schema index generators share: named components, inline request and response bodies given a
5
+ * name of their own, and which subtype each discriminator value selects.
6
+ */
7
+ export class SchemaTree {
8
+ named;
9
+ #byId;
10
+ #literals = new Map();
11
+ #requests = new Map();
12
+ #responses = new Map();
13
+ constructor(model) {
14
+ this.#byId = new Map(model.schemas.map((schema) => [schema.id, schema]));
15
+ this.named = model.schemas.map((schema) => ({ name: identifier(schema.id), schema }));
16
+ const taken = new Set(this.named.map((entry) => entry.name));
17
+ const nameInline = (operationId, suffix, node) => {
18
+ if (!node)
19
+ return undefined;
20
+ if (node.type === "ref")
21
+ return identifier(node.ref);
22
+ const name = identifier(`${operationId} ${suffix}`);
23
+ if (taken.has(name))
24
+ throw new CodegenError([`inline ${suffix.toLowerCase()} of "${operationId}" collides with ${name}`]);
25
+ taken.add(name);
26
+ this.named.push({ name, schema: { id: name, schema: node } });
27
+ return name;
28
+ };
29
+ for (const operation of model.operations) {
30
+ const request = nameInline(operation.id, "Request", operation.requestBody?.schema);
31
+ const response = nameInline(operation.id, "Response", operation.response?.schema);
32
+ if (request)
33
+ this.#requests.set(operation.id, request);
34
+ if (response)
35
+ this.#responses.set(operation.id, response);
36
+ }
37
+ for (const schema of model.schemas) {
38
+ for (const [value, target] of Object.entries(schema.discriminator?.mapping ?? {})) {
39
+ if (this.#literals.has(target)) {
40
+ throw new CodegenError([`schema "${target}" is a subtype of two discriminated schemas`]);
41
+ }
42
+ this.#literals.set(target, { property: schema.discriminator?.property ?? "", value });
43
+ }
44
+ }
45
+ }
46
+ schema(id) {
47
+ const schema = this.#byId.get(id);
48
+ if (!schema)
49
+ throw new CodegenError([`unknown schema "${id}"`]);
50
+ return schema;
51
+ }
52
+ requestName(operationId) {
53
+ return this.#requests.get(operationId);
54
+ }
55
+ responseName(operationId) {
56
+ return this.#responses.get(operationId);
57
+ }
58
+ /** The value a subtype's discriminator property must hold, if the schema is a subtype. */
59
+ literalFor(id) {
60
+ return this.#literals.get(id);
61
+ }
62
+ /** Merges inheritance into one object. A member that is not an object stops generation. */
63
+ flatten(node, where) {
64
+ if (node.type === "object")
65
+ return node;
66
+ if (node.type === "ref")
67
+ return this.flatten(this.schema(node.ref).schema, `${where} → ${node.ref}`);
68
+ if (node.type !== "allOf") {
69
+ throw new CodegenError([`${where}: allOf member of type "${node.type}" cannot be merged into an object`]);
70
+ }
71
+ const merged = {
72
+ properties: {},
73
+ required: [],
74
+ };
75
+ for (const member of node.of) {
76
+ const part = this.flatten(member, where);
77
+ Object.assign(merged.properties, part.properties);
78
+ for (const name of part.required)
79
+ if (!merged.required.includes(name))
80
+ merged.required.push(name);
81
+ if (part.additionalProperties)
82
+ merged.additionalProperties = part.additionalProperties;
83
+ }
84
+ return { type: "object", description: node.description, nullable: node.nullable, ...merged };
85
+ }
86
+ }
87
+ //# sourceMappingURL=tree.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tree.js","sourceRoot":"","sources":["../../src/codegen/tree.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import type { CodeGenerator } from "./model.js";
2
+ /** TypeScript types for every schema: what a caller holds after the response has been validated. */
3
+ export declare const typesGenerator: (options: {
4
+ path: string;
5
+ }) => CodeGenerator;
6
+ //# sourceMappingURL=typescript.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../src/codegen/typescript.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,aAAa,EAAc,MAAM,YAAY,CAAA;AAqErE,oGAAoG;AACpG,eAAO,MAAM,cAAc,YACf;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,KAAG,aAY5B,CAAA"}
@@ -0,0 +1,78 @@
1
+ import { identifier } from "./names.js";
2
+ import { SchemaTree } from "./tree.js";
3
+ const doc = (text, indent) => {
4
+ const line = text?.replace(/\s+/g, " ").replace(/\*\//g, "*\\/").trim();
5
+ return line ? `${indent}/** ${line} */\n` : "";
6
+ };
7
+ const key = (name) => (/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : JSON.stringify(name));
8
+ class TypeWriter {
9
+ tree;
10
+ constructor(tree) {
11
+ this.tree = tree;
12
+ }
13
+ node(node, where, literal) {
14
+ const base = this.#bare(node, where, literal);
15
+ return node.nullable ? `${base} | null` : base;
16
+ }
17
+ #bare(node, where, literal) {
18
+ switch (node.type) {
19
+ case "ref":
20
+ return identifier(node.ref);
21
+ case "string":
22
+ return node.enum ? node.enum.map((value) => JSON.stringify(value)).join(" | ") : "string";
23
+ case "integer":
24
+ if (node.format === "int64")
25
+ return "string";
26
+ return node.enum ? node.enum.map(String).join(" | ") : "number";
27
+ case "number":
28
+ return "number";
29
+ case "boolean":
30
+ return node.enum ? node.enum.map(String).join(" | ") : "boolean";
31
+ case "union":
32
+ return `(${node.of.map((member) => this.node(member, where)).join(" | ")})`;
33
+ case "unknown":
34
+ return "unknown";
35
+ case "array": {
36
+ return `Array<${this.node(node.items, `${where}[]`)}>`;
37
+ }
38
+ case "allOf":
39
+ if (node.of.length === 1 && node.of[0] && !literal)
40
+ return this.#bare(node.of[0], where);
41
+ return this.#object(this.tree.flatten(node, where), where, literal);
42
+ case "object":
43
+ return this.#object(node, where, literal);
44
+ }
45
+ }
46
+ #object(node, where, literal) {
47
+ const names = Object.keys(node.properties);
48
+ if (literal && !names.includes(literal.property))
49
+ names.unshift(literal.property);
50
+ const rest = node.additionalProperties
51
+ ? `Record<string, ${this.node(node.additionalProperties, where)}>`
52
+ : undefined;
53
+ if (names.length === 0)
54
+ return rest ?? "Record<string, unknown>";
55
+ const fields = names.map((name) => {
56
+ const property = node.properties[name] ?? { type: "string" };
57
+ const optional = node.required.includes(name) || literal?.property === name ? "" : "?";
58
+ const type = literal?.property === name ? JSON.stringify(literal.value) : this.node(property, `${where}.${name}`);
59
+ return `${doc(property.description, " ")} ${key(name)}${optional}: ${type}`;
60
+ });
61
+ const body = `{\n${fields.join("\n")}\n}`;
62
+ return rest ? `${body} & ${rest}` : body;
63
+ }
64
+ }
65
+ /** TypeScript types for every schema: what a caller holds after the response has been validated. */
66
+ export const typesGenerator = (options) => (model) => {
67
+ const tree = new SchemaTree(model);
68
+ const writer = new TypeWriter(tree);
69
+ const declarations = tree.named.map(({ name, schema }) => {
70
+ const union = schema.discriminator
71
+ ? Object.values(schema.discriminator.mapping).map(identifier).join(" | ")
72
+ : undefined;
73
+ const type = union ?? writer.node(schema.schema, schema.id, tree.literalFor(schema.id));
74
+ return `${doc(schema.schema.description, "")}export type ${name} = ${type}\n`;
75
+ });
76
+ return [{ path: options.path, content: declarations.join("\n") }];
77
+ };
78
+ //# sourceMappingURL=typescript.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"typescript.js","sourceRoot":"","sources":["../../src/codegen/typescript.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEtC,MAAM,GAAG,GAAG,CAAC,IAAwB,EAAE,MAAc,EAAU,EAAE;IAC/D,MAAM,IAAI,GAAG,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAA;IACvE,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;AAChD,CAAC,CAAA;AAED,MAAM,GAAG,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,CAAC,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;AAE7G,MAAM,UAAU;IACO,IAAI;IAAzB,YAAqB,IAAgB;oBAAhB,IAAI;IAAe,CAAC;IAEzC,IAAI,CAAC,IAAgB,EAAE,KAAa,EAAE,OAA6C;QACjF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAA;IAChD,CAAC;IAED,KAAK,CAAC,IAAgB,EAAE,KAAa,EAAE,OAA6C;QAClF,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,KAAK;gBACR,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAC7B,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;YAC3F,KAAK,SAAS;gBACZ,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO;oBAAE,OAAO,QAAQ,CAAA;gBAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;YACjE,KAAK,QAAQ;gBACX,OAAO,QAAQ,CAAA;YACjB,KAAK,SAAS;gBACZ,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YAClE,KAAK,OAAO;gBACV,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAA;YAC7E,KAAK,SAAS;gBACZ,OAAO,SAAS,CAAA;YAClB,KAAK,OAAO,EAAE,CAAC;gBACb,OAAO,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC,GAAG,CAAA;YACxD,CAAC;YACD,KAAK,OAAO;gBACV,IAAI,IAAI,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO;oBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;gBACxF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;YACrE,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;QAC7C,CAAC;IACH,CAAC;IAED,OAAO,CACL,IAA6C,EAC7C,KAAa,EACb,OAA6C;QAE7C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAC1C,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QACjF,MAAM,IAAI,GAAG,IAAI,CAAC,oBAAoB;YACpC,CAAC,CAAC,kBAAkB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,KAAK,CAAC,GAAG;YAClE,CAAC,CAAC,SAAS,CAAA;QACb,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,IAAI,yBAAyB,CAAA;QAChE,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAChC,MAAM,QAAQ,GAAe,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;YACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;YACtF,MAAM,IAAI,GAAG,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC,CAAA;YACjH,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,GAAG,QAAQ,KAAK,IAAI,EAAE,CAAA;QAC/E,CAAC,CAAC,CAAA;QACF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAA;QACzC,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAC1C,CAAC;CACF;AAED,oGAAoG;AACpG,MAAM,CAAC,MAAM,cAAc,GACzB,CAAC,OAAyB,EAAiB,EAAE,CAC7C,CAAC,KAAe,EAAE,EAAE;IAClB,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAA;IAClC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;IACnC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;QACvD,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa;YAChC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;YACzE,CAAC,CAAC,SAAS,CAAA;QACb,MAAM,IAAI,GAAG,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;QACvF,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,eAAe,IAAI,MAAM,IAAI,IAAI,CAAA;IAC/E,CAAC,CAAC,CAAA;IACF,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AACnE,CAAC,CAAA"}
@@ -0,0 +1,10 @@
1
+ import type { CodeGenerator } from "./model.js";
2
+ export interface ValibotOptions {
3
+ path: string;
4
+ /** Module the types come from, relative to `path`. */
5
+ typesImport: string;
6
+ runtimeImport?: string;
7
+ }
8
+ /** Valibot schemas that keep the source's constraints at run time, which plain generated types lose. */
9
+ export declare const valibotGenerator: (options: ValibotOptions) => CodeGenerator;
10
+ //# sourceMappingURL=valibot.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"valibot.d.ts","sourceRoot":"","sources":["../../src/codegen/valibot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,aAAa,EAAc,MAAM,YAAY,CAAA;AAqGrE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,wGAAwG;AACxG,eAAO,MAAM,gBAAgB,YACjB,cAAc,KAAG,aAqB1B,CAAA"}
@@ -0,0 +1,132 @@
1
+ import { identifier } from "./names.js";
2
+ import { CodegenError } from "./pipeline.js";
3
+ import { SchemaTree } from "./tree.js";
4
+ const key = (name) => (/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : JSON.stringify(name));
5
+ const piped = (base, actions) => actions.length === 0 ? base : `v.pipe(${base}, ${actions.join(", ")})`;
6
+ const range = (node) => {
7
+ const parts = [];
8
+ if (node.minimum !== undefined)
9
+ parts.push(`minimum: ${node.minimum}`);
10
+ if (node.maximum !== undefined)
11
+ parts.push(`maximum: ${node.maximum}`);
12
+ return parts.length === 0 ? "" : `{ ${parts.join(", ")} }`;
13
+ };
14
+ class SchemaWriter {
15
+ tree;
16
+ helpers = new Set();
17
+ constructor(tree) {
18
+ this.tree = tree;
19
+ }
20
+ node(node, where, literal) {
21
+ const base = this.#bare(node, where, literal);
22
+ return node.nullable ? `v.nullable(${base})` : base;
23
+ }
24
+ #bare(node, where, literal) {
25
+ switch (node.type) {
26
+ case "ref":
27
+ return `v.lazy(() => ${identifier(node.ref)})`;
28
+ case "string": {
29
+ if (node.enum)
30
+ return `v.picklist(${JSON.stringify(node.enum)})`;
31
+ const actions = [];
32
+ if (node.format === "binary")
33
+ actions.push('v.startsWith("attach://")');
34
+ if (node.minLength !== undefined)
35
+ actions.push(`v.minLength(${node.minLength})`);
36
+ if (node.maxLength !== undefined)
37
+ actions.push(`v.maxLength(${node.maxLength})`);
38
+ if (node.pattern !== undefined) {
39
+ try {
40
+ new RegExp(node.pattern);
41
+ }
42
+ catch {
43
+ throw new CodegenError([`${where}: pattern ${JSON.stringify(node.pattern)} is not a JS regular expression`]);
44
+ }
45
+ actions.push(`v.regex(new RegExp(${JSON.stringify(node.pattern)}))`);
46
+ }
47
+ return piped("v.string()", actions);
48
+ }
49
+ case "integer": {
50
+ const helper = node.format === "int64" ? "int64" : "integer";
51
+ this.helpers.add(helper);
52
+ const call = `${helper}(${range(node)})`;
53
+ if (!node.enum)
54
+ return call;
55
+ const values = helper === "int64" ? node.enum.map(String) : node.enum;
56
+ return piped(call, [`v.picklist(${JSON.stringify(values)})`]);
57
+ }
58
+ case "number":
59
+ this.helpers.add("number");
60
+ return `number(${range(node)})`;
61
+ case "boolean":
62
+ if (!node.enum)
63
+ return "v.boolean()";
64
+ if (node.enum.length === 1)
65
+ return `v.literal(${node.enum[0]})`;
66
+ return `v.union([${node.enum.map((value) => `v.literal(${value})`).join(", ")}])`;
67
+ case "union":
68
+ return `v.union([${node.of.map((member) => this.node(member, where)).join(", ")}])`;
69
+ case "unknown":
70
+ return "v.unknown()";
71
+ case "array": {
72
+ const actions = [];
73
+ if (node.minItems !== undefined)
74
+ actions.push(`v.minLength(${node.minItems})`);
75
+ if (node.maxItems !== undefined)
76
+ actions.push(`v.maxLength(${node.maxItems})`);
77
+ if (node.uniqueItems)
78
+ this.helpers.add("unique");
79
+ if (node.uniqueItems)
80
+ actions.push(`v.check((items) => unique(items), "items must be unique")`);
81
+ return piped(`v.array(${this.node(node.items, `${where}[]`)})`, actions);
82
+ }
83
+ case "allOf":
84
+ if (node.of.length === 1 && node.of[0] && !literal)
85
+ return this.#bare(node.of[0], where);
86
+ return this.#object(this.tree.flatten(node, where), where, literal);
87
+ case "object":
88
+ return this.#object(node, where, literal);
89
+ }
90
+ }
91
+ // Loose on purpose: MAX adds fields, and a response with a field we have never seen is still valid.
92
+ #object(node, where, literal) {
93
+ const names = Object.keys(node.properties);
94
+ if (literal && !names.includes(literal.property))
95
+ names.unshift(literal.property);
96
+ const rest = node.additionalProperties ? this.node(node.additionalProperties, where) : undefined;
97
+ if (names.length === 0)
98
+ return rest ? `v.record(v.string(), ${rest})` : "v.looseObject({})";
99
+ const entries = names.map((name) => {
100
+ if (literal?.property === name)
101
+ return ` ${key(name)}: v.literal(${JSON.stringify(literal.value)}),`;
102
+ const property = node.properties[name];
103
+ const schema = this.node(property, `${where}.${name}`);
104
+ return ` ${key(name)}: ${node.required.includes(name) ? schema : `v.optional(${schema})`},`;
105
+ });
106
+ const body = `{\n${entries.join("\n")}\n}`;
107
+ return rest ? `v.objectWithRest(${body}, ${rest})` : `v.looseObject(${body})`;
108
+ }
109
+ }
110
+ /** Valibot schemas that keep the source's constraints at run time, which plain generated types lose. */
111
+ export const valibotGenerator = (options) => (model) => {
112
+ const tree = new SchemaTree(model);
113
+ const writer = new SchemaWriter(tree);
114
+ const declarations = tree.named.map(({ name, schema }) => {
115
+ const expression = schema.discriminator
116
+ ? `v.union([${Object.values(schema.discriminator.mapping)
117
+ .map((target) => `v.lazy(() => ${identifier(target)})`)
118
+ .join(", ")}])`
119
+ : writer.node(schema.schema, schema.id, tree.literalFor(schema.id));
120
+ return `export const ${name}: v.GenericSchema<unknown, T.${name}> = ${expression}\n`;
121
+ });
122
+ const helpers = [...writer.helpers].sort();
123
+ const runtime = options.runtimeImport ?? "@wirecat/cli-core/codegen/runtime";
124
+ const packages = [
125
+ `import * as v from "valibot"`,
126
+ ...(helpers.length > 0 ? [`import { ${helpers.join(", ")} } from "${runtime}"`] : []),
127
+ ].sort((a, b) => (a.split(" from ")[1] ?? "").localeCompare(b.split(" from ")[1] ?? ""));
128
+ const header = [...packages, `import type * as T from "${options.typesImport}"`, ""];
129
+ const registry = `export const schemas = {\n${tree.named.map(({ name }) => ` ${name},`).join("\n")}\n} as const\n`;
130
+ return [{ path: options.path, content: `${header.join("\n")}\n${declarations.join("\n")}\n${registry}` }];
131
+ };
132
+ //# sourceMappingURL=valibot.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"valibot.js","sourceRoot":"","sources":["../../src/codegen/valibot.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,76 @@
1
+ /**
2
+ * The command registry: the whole command tree of a CLI as data, however each command came to be.
3
+ *
4
+ * It walks the live Commander tree rather than a list written by hand, so a command built in a
5
+ * loop from a catalog shows up exactly like one written in a file. What the tree cannot say — where
6
+ * a command came from, whether it changes anything, whether it is on its way out — is attached with
7
+ * `annotate`.
8
+ *
9
+ * Behind its own entry point for the same reason `/http` is: Commander is only a type here, and the
10
+ * root of this package stays free of any command-line framework.
11
+ */
12
+ import type { Command } from "commander";
13
+ export type Origin = "handwritten" | "generated";
14
+ export type CommandState = "beta" | "deprecated";
15
+ export interface CommandMeta {
16
+ origin?: Origin;
17
+ /** The catalog operation a generated command was made from. */
18
+ operationId?: string;
19
+ /** True when running the command changes something: a write, wherever it lands. */
20
+ mutates?: boolean;
21
+ /** With `mutates`: what it changes is only on this machine — a file, the keyring — never the service. */
22
+ local?: boolean;
23
+ state?: CommandState;
24
+ examples?: readonly string[];
25
+ }
26
+ export interface ArgumentInfo {
27
+ name: string;
28
+ required: boolean;
29
+ variadic: boolean;
30
+ description: string;
31
+ choices?: readonly string[];
32
+ default?: unknown;
33
+ }
34
+ export interface OptionInfo {
35
+ flags: string;
36
+ description: string;
37
+ /** False for a plain switch like `--json`, so an agent knows not to look for a value. */
38
+ takesValue: boolean;
39
+ /**
40
+ * Whether the option itself must be given. Deliberately not Commander's `required`, which means
41
+ * "takes a value when present" — reading that as "you must pass this" is the obvious misreading.
42
+ */
43
+ mandatory: boolean;
44
+ choices?: readonly string[];
45
+ default?: unknown;
46
+ env?: string;
47
+ /** Options that may not be given together with this one. */
48
+ conflicts?: readonly string[];
49
+ /** Values this option sets on others when they are not given. */
50
+ implies?: Readonly<Record<string, unknown>>;
51
+ }
52
+ export interface CommandInfo {
53
+ /** What to pass to the CLI, already split: `["runs", "list"]`. */
54
+ path: readonly string[];
55
+ name: string;
56
+ summary?: string;
57
+ description: string;
58
+ usage: string;
59
+ origin: Origin;
60
+ operationId?: string;
61
+ mutates?: boolean;
62
+ local?: boolean;
63
+ state?: CommandState;
64
+ examples?: readonly string[];
65
+ arguments: readonly ArgumentInfo[];
66
+ options: readonly OptionInfo[];
67
+ commands: readonly CommandInfo[];
68
+ }
69
+ /** Attaches what the tree cannot say. Repeated calls merge; the command is returned for chaining. */
70
+ export declare const annotate: <T extends Command>(command: T, meta: CommandMeta) => T;
71
+ export declare const metaOf: (command: Command) => CommandMeta;
72
+ export declare const describeProgram: (root: Command) => CommandInfo[];
73
+ export declare const describeOptions: (command: Command) => OptionInfo[];
74
+ export declare const flatten: (commands: readonly CommandInfo[]) => CommandInfo[];
75
+ export { COMMANDS_PAGE_LABELS, type CommandsPage, type CommandsPageLabels, type CommandsPageText, commandsPage, } from "./page.js";
76
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAY,OAAO,EAAU,MAAM,WAAW,CAAA;AAE1D,MAAM,MAAM,MAAM,GAAG,aAAa,GAAG,WAAW,CAAA;AAChD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,YAAY,CAAA;AAEhD,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mFAAmF;IACnF,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,yGAAyG;IACzG,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,yFAAyF;IACzF,UAAU,EAAE,OAAO,CAAA;IACnB;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7B,iEAAiE;IACjE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAC5C;AAED,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,SAAS,EAAE,SAAS,YAAY,EAAE,CAAA;IAClC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAA;IAC9B,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;CACjC;AAID,qGAAqG;AACrG,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,OAAO,WAAW,CAAC,QAAQ,WAAW,KAAG,CAG3E,CAAA;AAED,eAAO,MAAM,MAAM,YAAa,OAAO,KAAG,WAAwC,CAAA;AAElF,eAAO,MAAM,eAAe,SAAU,OAAO,KAAG,WAAW,EACK,CAAA;AAEhE,eAAO,MAAM,eAAe,YAAa,OAAO,KAAG,UAAU,EACW,CAAA;AAExE,eAAO,MAAM,OAAO,aAAc,SAAS,WAAW,EAAE,KAAG,WAAW,EACE,CAAA;AA8DxE,OAAO,EACL,oBAAoB,EACpB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,YAAY,GACb,MAAM,WAAW,CAAA"}
@@ -0,0 +1,62 @@
1
+ const labels = new WeakMap();
2
+ /** Attaches what the tree cannot say. Repeated calls merge; the command is returned for chaining. */
3
+ export const annotate = (command, meta) => {
4
+ labels.set(command, { ...labels.get(command), ...meta });
5
+ return command;
6
+ };
7
+ export const metaOf = (command) => labels.get(command) ?? {};
8
+ export const describeProgram = (root) => visible(root).map((child) => describe(child, root.name(), []));
9
+ export const describeOptions = (command) => command.options.filter((option) => !option.hidden).map(describeOption);
10
+ export const flatten = (commands) => commands.flatMap((command) => [command, ...flatten(command.commands)]);
11
+ const describe = (command, cli, parents) => {
12
+ const path = [...parents, command.name()];
13
+ const args = command.registeredArguments.map(describeArgument);
14
+ const options = describeOptions(command);
15
+ const { origin = "handwritten", ...meta } = metaOf(command);
16
+ const usage = [
17
+ cli,
18
+ ...path,
19
+ ...args.map((argument) => (argument.required ? `<${argument.name}>` : `[${argument.name}]`)),
20
+ options.length > 0 ? "[options]" : "",
21
+ ]
22
+ .filter(Boolean)
23
+ .join(" ");
24
+ return {
25
+ path,
26
+ name: command.name(),
27
+ ...(command.summary() ? { summary: command.summary() } : {}),
28
+ description: command.description(),
29
+ usage,
30
+ origin,
31
+ ...meta,
32
+ arguments: args,
33
+ options,
34
+ commands: visible(command).map((child) => describe(child, cli, path)),
35
+ };
36
+ };
37
+ // `addCommand(command, { hidden: true })` sets only this; Commander has no public getter for it.
38
+ const visible = (command) => command.commands.filter((child) => !child._hidden);
39
+ const describeArgument = (argument) => ({
40
+ name: argument.name(),
41
+ required: argument.required,
42
+ variadic: argument.variadic,
43
+ description: argument.description,
44
+ ...(argument.argChoices ? { choices: argument.argChoices } : {}),
45
+ ...(argument.defaultValue === undefined ? {} : { default: argument.defaultValue }),
46
+ });
47
+ const describeOption = (option) => {
48
+ const { conflictsWith = [], implied } = option;
49
+ return {
50
+ flags: option.flags,
51
+ description: option.description,
52
+ takesValue: option.required || option.optional,
53
+ mandatory: option.mandatory,
54
+ ...(option.argChoices ? { choices: option.argChoices } : {}),
55
+ ...(option.defaultValue === undefined ? {} : { default: option.defaultValue }),
56
+ ...(option.envVar ? { env: option.envVar } : {}),
57
+ ...(conflictsWith.length > 0 ? { conflicts: conflictsWith } : {}),
58
+ ...(implied ? { implies: implied } : {}),
59
+ };
60
+ };
61
+ export { COMMANDS_PAGE_LABELS, commandsPage, } from "./page.js";
62
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"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"}