@kubb/cli 5.0.0-beta.64 → 5.0.0-beta.65
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.
- package/dist/{define-Cq9hOxpK.cjs → defineCommand-Bo3yZTWI.cjs} +2 -20
- package/dist/defineCommand-Bo3yZTWI.cjs.map +1 -0
- package/dist/{define-GYXr00ky.js → defineCommand-DMEeqliP.js} +3 -15
- package/dist/defineCommand-DMEeqliP.js.map +1 -0
- package/dist/{generate-DHQnl_F1.js → generate-Bv36TZRy.js} +3 -3
- package/dist/{generate-DHQnl_F1.js.map → generate-Bv36TZRy.js.map} +1 -1
- package/dist/{generate-svfhwhEK.cjs → generate-WczcCx5K.cjs} +3 -3
- package/dist/{generate-svfhwhEK.cjs.map → generate-WczcCx5K.cjs.map} +1 -1
- package/dist/index.cjs +25 -60
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +25 -60
- package/dist/index.js.map +1 -1
- package/dist/{init-B02NN_88.js → init-CK76OU9h.js} +4 -4
- package/dist/{init-B02NN_88.js.map → init-CK76OU9h.js.map} +1 -1
- package/dist/{init-Bg_68Ok6.cjs → init-DrbsCmnm.cjs} +5 -5
- package/dist/{init-Bg_68Ok6.cjs.map → init-DrbsCmnm.cjs.map} +1 -1
- package/dist/{mcp-DUzIXdRV.cjs → mcp-CUNv25QY.cjs} +4 -4
- package/dist/{mcp-DUzIXdRV.cjs.map → mcp-CUNv25QY.cjs.map} +1 -1
- package/dist/{mcp-ZJQksVUU.js → mcp-DN1u2C54.js} +3 -3
- package/dist/{mcp-ZJQksVUU.js.map → mcp-DN1u2C54.js.map} +1 -1
- package/dist/package-DA31STdg.js +6 -0
- package/dist/package-DA31STdg.js.map +1 -0
- package/dist/{package-Cdu8eJMb.cjs → package-IOP3izYE.cjs} +2 -2
- package/dist/package-IOP3izYE.cjs.map +1 -0
- package/dist/{run-B4rIAnch.cjs → run-AYlRjIX5.cjs} +2 -16
- package/dist/run-AYlRjIX5.cjs.map +1 -0
- package/dist/{run-CD3BE8yP.cjs → run-B9pmTHZT.cjs} +2 -2
- package/dist/run-B9pmTHZT.cjs.map +1 -0
- package/dist/{run-DzYeru-0.js → run-D9mQoQHA.js} +2 -16
- package/dist/run-D9mQoQHA.js.map +1 -0
- package/dist/{run-DkW2VQBq.js → run-DTlsUFHr.js} +2 -2
- package/dist/run-DTlsUFHr.js.map +1 -0
- package/dist/{validate-B3EwltHu.cjs → validate-BZRFhF5M.cjs} +4 -4
- package/dist/{validate-B3EwltHu.cjs.map → validate-BZRFhF5M.cjs.map} +1 -1
- package/dist/{validate-DXYcZCm_.js → validate-SkDAzU_5.js} +3 -3
- package/dist/{validate-DXYcZCm_.js.map → validate-SkDAzU_5.js.map} +1 -1
- package/package.json +5 -5
- package/dist/define-Cq9hOxpK.cjs.map +0 -1
- package/dist/define-GYXr00ky.js.map +0 -1
- package/dist/package-BoXPsuNH.js +0 -6
- package/dist/package-BoXPsuNH.js.map +0 -1
- package/dist/package-Cdu8eJMb.cjs.map +0 -1
- package/dist/run-B4rIAnch.cjs.map +0 -1
- package/dist/run-CD3BE8yP.cjs.map +0 -1
- package/dist/run-DkW2VQBq.js.map +0 -1
- package/dist/run-DzYeru-0.js.map +0 -1
|
@@ -1,17 +1,5 @@
|
|
|
1
1
|
require("./rolldown-runtime-Bx3C2hgW.cjs");
|
|
2
|
-
//#region ../../internals/utils/src/cli/
|
|
3
|
-
/**
|
|
4
|
-
* Returns a `CLIAdapter` as-is with full type inference. Pass a custom adapter to `createCLI` to swap the CLI engine.
|
|
5
|
-
*
|
|
6
|
-
* @example
|
|
7
|
-
* ```ts
|
|
8
|
-
* const adapter = defineCLIAdapter({ run: myRun, renderHelp: myHelp })
|
|
9
|
-
* createCLI({ adapter }).run(commands, argv, opts)
|
|
10
|
-
* ```
|
|
11
|
-
*/
|
|
12
|
-
function defineCLIAdapter(adapter) {
|
|
13
|
-
return adapter;
|
|
14
|
-
}
|
|
2
|
+
//#region ../../internals/utils/src/cli/defineCommand.ts
|
|
15
3
|
/**
|
|
16
4
|
* Returns a `CommandDefinition` with typed `values` in `run()`.
|
|
17
5
|
* The callback receives `values` inferred from the declared options — no casts needed.
|
|
@@ -38,12 +26,6 @@ function defineCommand(def) {
|
|
|
38
26
|
};
|
|
39
27
|
}
|
|
40
28
|
//#endregion
|
|
41
|
-
Object.defineProperty(exports, "defineCLIAdapter", {
|
|
42
|
-
enumerable: true,
|
|
43
|
-
get: function() {
|
|
44
|
-
return defineCLIAdapter;
|
|
45
|
-
}
|
|
46
|
-
});
|
|
47
29
|
Object.defineProperty(exports, "defineCommand", {
|
|
48
30
|
enumerable: true,
|
|
49
31
|
get: function() {
|
|
@@ -51,4 +33,4 @@ Object.defineProperty(exports, "defineCommand", {
|
|
|
51
33
|
}
|
|
52
34
|
});
|
|
53
35
|
|
|
54
|
-
//# sourceMappingURL=
|
|
36
|
+
//# sourceMappingURL=defineCommand-Bo3yZTWI.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"defineCommand-Bo3yZTWI.cjs","names":[],"sources":["../../../internals/utils/src/cli/defineCommand.ts"],"sourcesContent":["type BaseOption = {\n /**\n * Single-character short alias, e.g. `'c'` for `--config`.\n */\n short?: string\n description: string\n hint?: string\n required?: boolean\n /**\n * Allowed values for string options. Used in help output and AI/MCP tool schemas.\n */\n enum?: Array<string>\n}\n\ntype StringOption = BaseOption & { type: 'string'; default?: string }\ntype BooleanOption = BaseOption & { type: 'boolean'; default?: boolean }\n\n/**\n * A single CLI option — either a string value or a boolean flag.\n */\nexport type OptionDefinition = StringOption | BooleanOption\n\n/**\n * The primitive type of a CLI option value.\n */\nexport type OptionType = OptionDefinition['type']\n\n/**\n * Parsed result of `parseArgs` — typed values map plus positional arguments.\n */\nexport type ParsedArgs = {\n values: Record<string, string | boolean | undefined>\n positionals: Array<string>\n}\n\n/**\n * Full definition of a CLI command including its options, sub-commands, and run handler.\n */\nexport type CommandDefinition = {\n name: string\n description: string\n /**\n * Positional argument labels shown in usage line, e.g. `['[input]']`.\n */\n arguments?: Array<string>\n /**\n * Usage examples shown in help output and exposed to AI/MCP tools.\n */\n examples?: Array<string>\n options?: Record<string, OptionDefinition>\n subCommands?: Array<CommandDefinition>\n run?: (args: ParsedArgs) => Promise<void>\n}\n\ntype OptionTypeMap = { string: string; boolean: boolean }\n\ntype IsRequired<O extends OptionDefinition> = O['default'] extends string | boolean ? true : O['required'] extends true ? true : false\n\n/**\n * Infers typed values from an options record. Options with a `default` or `required: true` are always defined.\n */\ntype InferValues<O extends Record<string, OptionDefinition>> = {\n [K in keyof O as IsRequired<O[K]> extends true ? K : never]: OptionTypeMap[O[K]['type']]\n} & {\n [K in keyof O as IsRequired<O[K]> extends true ? never : K]?: OptionTypeMap[O[K]['type']]\n}\n\n/**\n * Returns a `CommandDefinition` with typed `values` in `run()`.\n * The callback receives `values` inferred from the declared options — no casts needed.\n *\n * @example\n * ```ts\n * const generate = defineCommand({\n * name: 'generate',\n * description: 'Generate client code',\n * options: { config: { type: 'string', description: 'Config path' } },\n * async run({ values }) { console.log(values.config) },\n * })\n * ```\n */\nexport function defineCommand<O extends Record<string, OptionDefinition>>(def: {\n name: string\n description: string\n arguments?: Array<string>\n examples?: Array<string>\n options?: O\n subCommands?: Array<CommandDefinition>\n run?: (args: { values: InferValues<O>; positionals: Array<string> }) => Promise<void>\n}): CommandDefinition {\n const { run, ...rest } = def\n if (!run) return rest\n return {\n ...rest,\n run: (args) =>\n run({\n values: args.values as InferValues<O>,\n positionals: args.positionals,\n }),\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiFA,SAAgB,cAA0D,KAQpD;CACpB,MAAM,EAAE,KAAK,GAAG,SAAS;CACzB,IAAI,CAAC,KAAK,OAAO;CACjB,OAAO;EACL,GAAG;EACH,MAAM,SACJ,IAAI;GACF,QAAQ,KAAK;GACb,aAAa,KAAK;EACpB,CAAC;CACL;AACF"}
|
|
@@ -1,17 +1,5 @@
|
|
|
1
1
|
import "./rolldown-runtime-C0LytTxp.js";
|
|
2
|
-
//#region ../../internals/utils/src/cli/
|
|
3
|
-
/**
|
|
4
|
-
* Returns a `CLIAdapter` as-is with full type inference. Pass a custom adapter to `createCLI` to swap the CLI engine.
|
|
5
|
-
*
|
|
6
|
-
* @example
|
|
7
|
-
* ```ts
|
|
8
|
-
* const adapter = defineCLIAdapter({ run: myRun, renderHelp: myHelp })
|
|
9
|
-
* createCLI({ adapter }).run(commands, argv, opts)
|
|
10
|
-
* ```
|
|
11
|
-
*/
|
|
12
|
-
function defineCLIAdapter(adapter) {
|
|
13
|
-
return adapter;
|
|
14
|
-
}
|
|
2
|
+
//#region ../../internals/utils/src/cli/defineCommand.ts
|
|
15
3
|
/**
|
|
16
4
|
* Returns a `CommandDefinition` with typed `values` in `run()`.
|
|
17
5
|
* The callback receives `values` inferred from the declared options — no casts needed.
|
|
@@ -38,6 +26,6 @@ function defineCommand(def) {
|
|
|
38
26
|
};
|
|
39
27
|
}
|
|
40
28
|
//#endregion
|
|
41
|
-
export { defineCommand as
|
|
29
|
+
export { defineCommand as t };
|
|
42
30
|
|
|
43
|
-
//# sourceMappingURL=
|
|
31
|
+
//# sourceMappingURL=defineCommand-DMEeqliP.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"defineCommand-DMEeqliP.js","names":[],"sources":["../../../internals/utils/src/cli/defineCommand.ts"],"sourcesContent":["type BaseOption = {\n /**\n * Single-character short alias, e.g. `'c'` for `--config`.\n */\n short?: string\n description: string\n hint?: string\n required?: boolean\n /**\n * Allowed values for string options. Used in help output and AI/MCP tool schemas.\n */\n enum?: Array<string>\n}\n\ntype StringOption = BaseOption & { type: 'string'; default?: string }\ntype BooleanOption = BaseOption & { type: 'boolean'; default?: boolean }\n\n/**\n * A single CLI option — either a string value or a boolean flag.\n */\nexport type OptionDefinition = StringOption | BooleanOption\n\n/**\n * The primitive type of a CLI option value.\n */\nexport type OptionType = OptionDefinition['type']\n\n/**\n * Parsed result of `parseArgs` — typed values map plus positional arguments.\n */\nexport type ParsedArgs = {\n values: Record<string, string | boolean | undefined>\n positionals: Array<string>\n}\n\n/**\n * Full definition of a CLI command including its options, sub-commands, and run handler.\n */\nexport type CommandDefinition = {\n name: string\n description: string\n /**\n * Positional argument labels shown in usage line, e.g. `['[input]']`.\n */\n arguments?: Array<string>\n /**\n * Usage examples shown in help output and exposed to AI/MCP tools.\n */\n examples?: Array<string>\n options?: Record<string, OptionDefinition>\n subCommands?: Array<CommandDefinition>\n run?: (args: ParsedArgs) => Promise<void>\n}\n\ntype OptionTypeMap = { string: string; boolean: boolean }\n\ntype IsRequired<O extends OptionDefinition> = O['default'] extends string | boolean ? true : O['required'] extends true ? true : false\n\n/**\n * Infers typed values from an options record. Options with a `default` or `required: true` are always defined.\n */\ntype InferValues<O extends Record<string, OptionDefinition>> = {\n [K in keyof O as IsRequired<O[K]> extends true ? K : never]: OptionTypeMap[O[K]['type']]\n} & {\n [K in keyof O as IsRequired<O[K]> extends true ? never : K]?: OptionTypeMap[O[K]['type']]\n}\n\n/**\n * Returns a `CommandDefinition` with typed `values` in `run()`.\n * The callback receives `values` inferred from the declared options — no casts needed.\n *\n * @example\n * ```ts\n * const generate = defineCommand({\n * name: 'generate',\n * description: 'Generate client code',\n * options: { config: { type: 'string', description: 'Config path' } },\n * async run({ values }) { console.log(values.config) },\n * })\n * ```\n */\nexport function defineCommand<O extends Record<string, OptionDefinition>>(def: {\n name: string\n description: string\n arguments?: Array<string>\n examples?: Array<string>\n options?: O\n subCommands?: Array<CommandDefinition>\n run?: (args: { values: InferValues<O>; positionals: Array<string> }) => Promise<void>\n}): CommandDefinition {\n const { run, ...rest } = def\n if (!run) return rest\n return {\n ...rest,\n run: (args) =>\n run({\n values: args.values as InferValues<O>,\n positionals: args.positionals,\n }),\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiFA,SAAgB,cAA0D,KAQpD;CACpB,MAAM,EAAE,KAAK,GAAG,SAAS;CACzB,IAAI,CAAC,KAAK,OAAO;CACjB,OAAO;EACL,GAAG;EACH,MAAM,SACJ,IAAI;GACF,QAAQ,KAAK;GACb,aAAa,KAAK;EACpB,CAAC;CACL;AACF"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import "./rolldown-runtime-C0LytTxp.js";
|
|
2
|
-
import {
|
|
2
|
+
import { t as defineCommand } from "./defineCommand-DMEeqliP.js";
|
|
3
3
|
//#region src/commands/generate.ts
|
|
4
4
|
const command = defineCommand({
|
|
5
5
|
name: "generate",
|
|
@@ -61,7 +61,7 @@ const command = defineCommand({
|
|
|
61
61
|
async run({ values, positionals }) {
|
|
62
62
|
const logLevel = values.verbose ? "verbose" : values.silent ? "silent" : values.logLevel;
|
|
63
63
|
const reporters = values.reporter?.split(",").map((name) => name.trim()).filter(Boolean);
|
|
64
|
-
const { run } = await import("./run-
|
|
64
|
+
const { run } = await import("./run-DTlsUFHr.js");
|
|
65
65
|
await run({
|
|
66
66
|
input: positionals[0],
|
|
67
67
|
configPath: values.config,
|
|
@@ -74,4 +74,4 @@ const command = defineCommand({
|
|
|
74
74
|
//#endregion
|
|
75
75
|
export { command };
|
|
76
76
|
|
|
77
|
-
//# sourceMappingURL=generate-
|
|
77
|
+
//# sourceMappingURL=generate-Bv36TZRy.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"generate-
|
|
1
|
+
{"version":3,"file":"generate-Bv36TZRy.js","names":[],"sources":["../src/commands/generate.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport type { ReporterName } from '@kubb/core'\n\nexport const command = defineCommand({\n name: 'generate',\n description:\n 'Generate TypeScript types, API clients, React Query hooks, Zod schemas, and more from an OpenAPI specification. Reads kubb.config.ts by default. Pass an OpenAPI file path as the first argument to override the input without editing the config.',\n arguments: ['[input]'],\n examples: ['kubb generate', 'kubb generate ./openapi.yaml', 'kubb generate --config kubb.config.ts', 'kubb generate --watch'],\n options: {\n config: {\n type: 'string',\n description: 'Path to the Kubb config',\n short: 'c',\n },\n logLevel: {\n type: 'string',\n description: 'Info, silent or verbose',\n short: 'l',\n default: 'info',\n hint: 'silent|info|verbose',\n enum: ['silent', 'info', 'verbose'],\n },\n watch: {\n type: 'boolean',\n description: 'Watch mode based on the input file',\n short: 'w',\n default: false,\n },\n verbose: {\n type: 'boolean',\n description: 'Override logLevel to verbose',\n short: 'v',\n default: false,\n },\n silent: {\n type: 'boolean',\n description: 'Override logLevel to silent',\n short: 's',\n default: false,\n },\n reporter: {\n type: 'string',\n description: 'Reporters that render the run, comma-separated. Overrides config.reporters',\n hint: 'cli|json|file',\n enum: ['cli', 'json', 'file'],\n },\n },\n async run({ values, positionals }) {\n const logLevel = values.verbose ? 'verbose' : values.silent ? 'silent' : values.logLevel\n const reporters = values.reporter\n ?.split(',')\n .map((name) => name.trim())\n .filter(Boolean) as Array<ReporterName> | undefined\n const { run } = await import('../runners/generate/run.ts')\n\n await run({\n input: positionals[0],\n configPath: values.config,\n logLevel,\n watch: values.watch,\n reporters,\n })\n },\n})\n"],"mappings":";;;AAGA,MAAa,UAAU,cAAc;CACnC,MAAM;CACN,aACE;CACF,WAAW,CAAC,SAAS;CACrB,UAAU;EAAC;EAAiB;EAAgC;EAAyC;CAAuB;CAC5H,SAAS;EACP,QAAQ;GACN,MAAM;GACN,aAAa;GACb,OAAO;EACT;EACA,UAAU;GACR,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACT,MAAM;GACN,MAAM;IAAC;IAAU;IAAQ;GAAS;EACpC;EACA,OAAO;GACL,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;EACX;EACA,SAAS;GACP,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;EACX;EACA,QAAQ;GACN,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;EACX;EACA,UAAU;GACR,MAAM;GACN,aAAa;GACb,MAAM;GACN,MAAM;IAAC;IAAO;IAAQ;GAAM;EAC9B;CACF;CACA,MAAM,IAAI,EAAE,QAAQ,eAAe;EACjC,MAAM,WAAW,OAAO,UAAU,YAAY,OAAO,SAAS,WAAW,OAAO;EAChF,MAAM,YAAY,OAAO,UACrB,MAAM,GAAG,CAAC,CACX,KAAK,SAAS,KAAK,KAAK,CAAC,CAAC,CAC1B,OAAO,OAAO;EACjB,MAAM,EAAE,QAAQ,MAAM,OAAO;EAE7B,MAAM,IAAI;GACR,OAAO,YAAY;GACnB,YAAY,OAAO;GACnB;GACA,OAAO,OAAO;GACd;EACF,CAAC;CACH;AACF,CAAC"}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
require("./rolldown-runtime-Bx3C2hgW.cjs");
|
|
2
2
|
//#region src/commands/generate.ts
|
|
3
|
-
const command = require("./
|
|
3
|
+
const command = require("./defineCommand-Bo3yZTWI.cjs").defineCommand({
|
|
4
4
|
name: "generate",
|
|
5
5
|
description: "Generate TypeScript types, API clients, React Query hooks, Zod schemas, and more from an OpenAPI specification. Reads kubb.config.ts by default. Pass an OpenAPI file path as the first argument to override the input without editing the config.",
|
|
6
6
|
arguments: ["[input]"],
|
|
@@ -60,7 +60,7 @@ const command = require("./define-Cq9hOxpK.cjs").defineCommand({
|
|
|
60
60
|
async run({ values, positionals }) {
|
|
61
61
|
const logLevel = values.verbose ? "verbose" : values.silent ? "silent" : values.logLevel;
|
|
62
62
|
const reporters = values.reporter?.split(",").map((name) => name.trim()).filter(Boolean);
|
|
63
|
-
const { run } = await Promise.resolve().then(() => require("./run-
|
|
63
|
+
const { run } = await Promise.resolve().then(() => require("./run-B9pmTHZT.cjs"));
|
|
64
64
|
await run({
|
|
65
65
|
input: positionals[0],
|
|
66
66
|
configPath: values.config,
|
|
@@ -73,4 +73,4 @@ const command = require("./define-Cq9hOxpK.cjs").defineCommand({
|
|
|
73
73
|
//#endregion
|
|
74
74
|
exports.command = command;
|
|
75
75
|
|
|
76
|
-
//# sourceMappingURL=generate-
|
|
76
|
+
//# sourceMappingURL=generate-WczcCx5K.cjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"generate-
|
|
1
|
+
{"version":3,"file":"generate-WczcCx5K.cjs","names":["defineCommand"],"sources":["../src/commands/generate.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport type { ReporterName } from '@kubb/core'\n\nexport const command = defineCommand({\n name: 'generate',\n description:\n 'Generate TypeScript types, API clients, React Query hooks, Zod schemas, and more from an OpenAPI specification. Reads kubb.config.ts by default. Pass an OpenAPI file path as the first argument to override the input without editing the config.',\n arguments: ['[input]'],\n examples: ['kubb generate', 'kubb generate ./openapi.yaml', 'kubb generate --config kubb.config.ts', 'kubb generate --watch'],\n options: {\n config: {\n type: 'string',\n description: 'Path to the Kubb config',\n short: 'c',\n },\n logLevel: {\n type: 'string',\n description: 'Info, silent or verbose',\n short: 'l',\n default: 'info',\n hint: 'silent|info|verbose',\n enum: ['silent', 'info', 'verbose'],\n },\n watch: {\n type: 'boolean',\n description: 'Watch mode based on the input file',\n short: 'w',\n default: false,\n },\n verbose: {\n type: 'boolean',\n description: 'Override logLevel to verbose',\n short: 'v',\n default: false,\n },\n silent: {\n type: 'boolean',\n description: 'Override logLevel to silent',\n short: 's',\n default: false,\n },\n reporter: {\n type: 'string',\n description: 'Reporters that render the run, comma-separated. Overrides config.reporters',\n hint: 'cli|json|file',\n enum: ['cli', 'json', 'file'],\n },\n },\n async run({ values, positionals }) {\n const logLevel = values.verbose ? 'verbose' : values.silent ? 'silent' : values.logLevel\n const reporters = values.reporter\n ?.split(',')\n .map((name) => name.trim())\n .filter(Boolean) as Array<ReporterName> | undefined\n const { run } = await import('../runners/generate/run.ts')\n\n await run({\n input: positionals[0],\n configPath: values.config,\n logLevel,\n watch: values.watch,\n reporters,\n })\n },\n})\n"],"mappings":";;AAGA,MAAa,gDAAUA,CAAAA,CAAAA,cAAc;CACnC,MAAM;CACN,aACE;CACF,WAAW,CAAC,SAAS;CACrB,UAAU;EAAC;EAAiB;EAAgC;EAAyC;CAAuB;CAC5H,SAAS;EACP,QAAQ;GACN,MAAM;GACN,aAAa;GACb,OAAO;EACT;EACA,UAAU;GACR,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACT,MAAM;GACN,MAAM;IAAC;IAAU;IAAQ;GAAS;EACpC;EACA,OAAO;GACL,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;EACX;EACA,SAAS;GACP,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;EACX;EACA,QAAQ;GACN,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;EACX;EACA,UAAU;GACR,MAAM;GACN,aAAa;GACb,MAAM;GACN,MAAM;IAAC;IAAO;IAAQ;GAAM;EAC9B;CACF;CACA,MAAM,IAAI,EAAE,QAAQ,eAAe;EACjC,MAAM,WAAW,OAAO,UAAU,YAAY,OAAO,SAAS,WAAW,OAAO;EAChF,MAAM,YAAY,OAAO,UACrB,MAAM,GAAG,CAAC,CACX,KAAK,SAAS,KAAK,KAAK,CAAC,CAAC,CAC1B,OAAO,OAAO;EACjB,MAAM,EAAE,QAAQ,MAAA,QAAA,QAAA,CAAA,CAAA,WAAA,QAAM,oBAAA,CAAA;EAEtB,MAAM,IAAI;GACR,OAAO,YAAY;GACnB,YAAY,OAAO;GACnB;GACA,OAAO,OAAO;GACd;EACF,CAAC;CACH;AACF,CAAC"}
|
package/dist/index.cjs
CHANGED
|
@@ -1,49 +1,12 @@
|
|
|
1
1
|
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
2
2
|
require("./rolldown-runtime-Bx3C2hgW.cjs");
|
|
3
|
-
const require_define = require("./define-Cq9hOxpK.cjs");
|
|
4
3
|
const require_Telemetry = require("./Telemetry-CfPP7MYq.cjs");
|
|
5
|
-
const require_package = require("./package-
|
|
4
|
+
const require_package = require("./package-IOP3izYE.cjs");
|
|
6
5
|
let node_util = require("node:util");
|
|
7
|
-
//#region ../../internals/utils/src/cli/
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
* Use to expose CLI capabilities to AI agents or MCP tools.
|
|
11
|
-
*
|
|
12
|
-
* @example
|
|
13
|
-
* ```ts
|
|
14
|
-
* getCommandSchema([generateCommand, agentCommand])
|
|
15
|
-
* // [{ name: 'generate', options: [...], subCommands: [] }, ...]
|
|
16
|
-
* ```
|
|
17
|
-
*/
|
|
18
|
-
function getCommandSchema(defs) {
|
|
19
|
-
return defs.map(serializeCommand);
|
|
6
|
+
//#region ../../internals/utils/src/cli/renderHelp.ts
|
|
7
|
+
function formatFlags(name, opt) {
|
|
8
|
+
return `${opt.short ? `-${opt.short}, ` : ""}--${name}${opt.type === "string" ? ` <${opt.hint ?? name}>` : ""}`;
|
|
20
9
|
}
|
|
21
|
-
function serializeCommand(def) {
|
|
22
|
-
return {
|
|
23
|
-
name: def.name,
|
|
24
|
-
description: def.description,
|
|
25
|
-
arguments: def.arguments,
|
|
26
|
-
...def.examples?.length ? { examples: def.examples } : {},
|
|
27
|
-
options: serializeOptions(def.options ?? {}),
|
|
28
|
-
subCommands: def.subCommands ? def.subCommands.map(serializeCommand) : []
|
|
29
|
-
};
|
|
30
|
-
}
|
|
31
|
-
function serializeOptions(options) {
|
|
32
|
-
return Object.entries(options).map(([name, opt]) => {
|
|
33
|
-
return {
|
|
34
|
-
name,
|
|
35
|
-
flags: `${opt.short ? `-${opt.short}, ` : ""}--${name}${opt.type === "string" ? ` <${opt.hint ?? name}>` : ""}`,
|
|
36
|
-
type: opt.type,
|
|
37
|
-
description: opt.description,
|
|
38
|
-
...opt.default !== void 0 ? { default: opt.default } : {},
|
|
39
|
-
...opt.hint ? { hint: opt.hint } : {},
|
|
40
|
-
...opt.enum ? { enum: opt.enum } : {},
|
|
41
|
-
...opt.required ? { required: opt.required } : {}
|
|
42
|
-
};
|
|
43
|
-
});
|
|
44
|
-
}
|
|
45
|
-
//#endregion
|
|
46
|
-
//#region ../../internals/utils/src/cli/help.ts
|
|
47
10
|
/** Prints formatted help output for `def` using its `CommandDefinition`.
|
|
48
11
|
*
|
|
49
12
|
* @example
|
|
@@ -53,21 +16,23 @@ function serializeOptions(options) {
|
|
|
53
16
|
* ```
|
|
54
17
|
*/
|
|
55
18
|
function renderHelp(def, parentName) {
|
|
56
|
-
const
|
|
57
|
-
const
|
|
58
|
-
const argsPart =
|
|
59
|
-
const subCmdPart =
|
|
19
|
+
const programName = parentName ? `${parentName} ${def.name}` : def.name;
|
|
20
|
+
const subCommands = def.subCommands ?? [];
|
|
21
|
+
const argsPart = def.arguments?.length ? ` ${def.arguments.join(" ")}` : "";
|
|
22
|
+
const subCmdPart = subCommands.length ? " <command>" : "";
|
|
60
23
|
console.log(`\n${(0, node_util.styleText)("bold", "Usage:")} ${programName}${argsPart}${subCmdPart} [options]\n`);
|
|
61
|
-
if (
|
|
62
|
-
if (
|
|
24
|
+
if (def.description) console.log(` ${def.description}\n`);
|
|
25
|
+
if (subCommands.length) {
|
|
63
26
|
console.log((0, node_util.styleText)("bold", "Commands:"));
|
|
64
|
-
for (const sub of
|
|
27
|
+
for (const sub of subCommands) console.log(` ${(0, node_util.styleText)("cyan", sub.name.padEnd(16))}${sub.description}`);
|
|
65
28
|
console.log();
|
|
66
29
|
}
|
|
67
|
-
const options = [...
|
|
68
|
-
|
|
30
|
+
const options = [...Object.entries(def.options ?? {}).map(([name, opt]) => ({
|
|
31
|
+
flags: formatFlags(name, opt),
|
|
32
|
+
description: opt.description,
|
|
33
|
+
default: opt.default
|
|
34
|
+
})), {
|
|
69
35
|
flags: "-h, --help",
|
|
70
|
-
type: "boolean",
|
|
71
36
|
description: "Show help"
|
|
72
37
|
}];
|
|
73
38
|
console.log((0, node_util.styleText)("bold", "Options:"));
|
|
@@ -77,9 +42,9 @@ function renderHelp(def, parentName) {
|
|
|
77
42
|
console.log(` ${flags}${opt.description}${defaultPart}`);
|
|
78
43
|
}
|
|
79
44
|
console.log();
|
|
80
|
-
if (
|
|
45
|
+
if (def.examples?.length) {
|
|
81
46
|
console.log((0, node_util.styleText)("bold", "Examples:"));
|
|
82
|
-
for (const ex of
|
|
47
|
+
for (const ex of def.examples) console.log(` ${(0, node_util.styleText)("dim", ex)}`);
|
|
83
48
|
console.log();
|
|
84
49
|
}
|
|
85
50
|
}
|
|
@@ -153,7 +118,7 @@ function printRootHelp(programName, version, defs) {
|
|
|
153
118
|
/**
|
|
154
119
|
* CLI adapter using `node:util parseArgs`. No external dependencies.
|
|
155
120
|
*/
|
|
156
|
-
const nodeAdapter =
|
|
121
|
+
const nodeAdapter = {
|
|
157
122
|
renderHelp(def, parentName) {
|
|
158
123
|
renderHelp(def, parentName);
|
|
159
124
|
},
|
|
@@ -210,9 +175,9 @@ const nodeAdapter = require_define.defineCLIAdapter({
|
|
|
210
175
|
}
|
|
211
176
|
await runCommand(def, commandArgv, parentName);
|
|
212
177
|
}
|
|
213
|
-
}
|
|
178
|
+
};
|
|
214
179
|
//#endregion
|
|
215
|
-
//#region ../../internals/utils/src/cli/
|
|
180
|
+
//#region ../../internals/utils/src/cli/createCLI.ts
|
|
216
181
|
/**
|
|
217
182
|
* Creates a CLI runner bound to a specific adapter.
|
|
218
183
|
*
|
|
@@ -244,10 +209,10 @@ const cli = createCLI();
|
|
|
244
209
|
async function run(argv = process.argv) {
|
|
245
210
|
const isQuietFlag = argv.some((arg) => require_Telemetry.QUIET_FLAGS.has(arg));
|
|
246
211
|
if (!require_Telemetry.Telemetry.isDisabled && !isQuietFlag) console.log(`${(0, node_util.styleText)("yellow", "Notice:")} Kubb collects anonymous telemetry data to help improve the tool. No personal data or file contents are collected. \nTo disable, set ${(0, node_util.styleText)("cyan", "KUBB_DISABLE_TELEMETRY=1")}.\n`);
|
|
247
|
-
const { command: generateCommand } = await Promise.resolve().then(() => require("./generate-
|
|
248
|
-
const { command: validateCommand } = await Promise.resolve().then(() => require("./validate-
|
|
249
|
-
const { command: mcpCommand } = await Promise.resolve().then(() => require("./mcp-
|
|
250
|
-
const { command: initCommand } = await Promise.resolve().then(() => require("./init-
|
|
212
|
+
const { command: generateCommand } = await Promise.resolve().then(() => require("./generate-WczcCx5K.cjs"));
|
|
213
|
+
const { command: validateCommand } = await Promise.resolve().then(() => require("./validate-BZRFhF5M.cjs"));
|
|
214
|
+
const { command: mcpCommand } = await Promise.resolve().then(() => require("./mcp-CUNv25QY.cjs"));
|
|
215
|
+
const { command: initCommand } = await Promise.resolve().then(() => require("./init-DrbsCmnm.cjs"));
|
|
251
216
|
await cli.run([
|
|
252
217
|
generateCommand,
|
|
253
218
|
validateCommand,
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.cjs","names":["defineCLIAdapter","QUIET_FLAGS","Telemetry"],"sources":["../../../internals/utils/src/cli/schema.ts","../../../internals/utils/src/cli/help.ts","../../../internals/utils/src/cli/adapters/nodeAdapter.ts","../../../internals/utils/src/cli/parse.ts","../src/index.ts"],"sourcesContent":["import type { CommandDefinition, CommandSchema, OptionDefinition, OptionSchema } from './types.ts'\n\n/**\n * Serializes `CommandDefinition[]` to a plain, JSON-serializable structure.\n * Use to expose CLI capabilities to AI agents or MCP tools.\n *\n * @example\n * ```ts\n * getCommandSchema([generateCommand, agentCommand])\n * // [{ name: 'generate', options: [...], subCommands: [] }, ...]\n * ```\n */\nexport function getCommandSchema(defs: Array<CommandDefinition>): Array<CommandSchema> {\n return defs.map(serializeCommand)\n}\n\nfunction serializeCommand(def: CommandDefinition): CommandSchema {\n return {\n name: def.name,\n description: def.description,\n arguments: def.arguments,\n ...(def.examples?.length ? { examples: def.examples } : {}),\n options: serializeOptions(def.options ?? {}),\n subCommands: def.subCommands ? def.subCommands.map(serializeCommand) : [],\n }\n}\n\nfunction serializeOptions(options: Record<string, OptionDefinition>): Array<OptionSchema> {\n return Object.entries(options).map(([name, opt]) => {\n const shortPart = opt.short ? `-${opt.short}, ` : ''\n const valuePart = opt.type === 'string' ? ` <${opt.hint ?? name}>` : ''\n const flags = `${shortPart}--${name}${valuePart}`\n\n return {\n name,\n flags,\n type: opt.type,\n description: opt.description,\n ...(opt.default !== undefined ? { default: opt.default } : {}),\n ...(opt.hint ? { hint: opt.hint } : {}),\n ...(opt.enum ? { enum: opt.enum } : {}),\n ...(opt.required ? { required: opt.required } : {}),\n }\n })\n}\n","import { styleText } from 'node:util'\nimport { getCommandSchema } from './schema.ts'\nimport type { CommandDefinition, OptionSchema } from './types.ts'\n\n/** Prints formatted help output for `def` using its `CommandDefinition`.\n *\n * @example\n * ```ts\n * renderHelp({ name: 'generate', description: 'Generate client code' })\n * // prints Usage: generate [options] ...\n * ```\n */\nexport function renderHelp(def: CommandDefinition, parentName?: string): void {\n const schema = getCommandSchema([def])[0]!\n\n const programName = parentName ? `${parentName} ${schema.name}` : schema.name\n\n const argsPart = schema.arguments?.length ? ` ${schema.arguments.join(' ')}` : ''\n const subCmdPart = schema.subCommands.length ? ' <command>' : ''\n console.log(`\\n${styleText('bold', 'Usage:')} ${programName}${argsPart}${subCmdPart} [options]\\n`)\n\n if (schema.description) {\n console.log(` ${schema.description}\\n`)\n }\n\n if (schema.subCommands.length) {\n console.log(styleText('bold', 'Commands:'))\n for (const sub of schema.subCommands) {\n console.log(` ${styleText('cyan', sub.name.padEnd(16))}${sub.description}`)\n }\n console.log()\n }\n\n const options: Array<OptionSchema> = [\n ...schema.options,\n {\n name: 'help',\n flags: '-h, --help',\n type: 'boolean' as const,\n description: 'Show help',\n },\n ]\n\n console.log(styleText('bold', 'Options:'))\n for (const opt of options) {\n const flags = styleText('cyan', opt.flags.padEnd(30))\n const defaultPart = opt.default !== undefined ? styleText('dim', ` (default: ${opt.default})`) : ''\n console.log(` ${flags}${opt.description}${defaultPart}`)\n }\n console.log()\n\n if (schema.examples?.length) {\n console.log(styleText('bold', 'Examples:'))\n for (const ex of schema.examples) {\n console.log(` ${styleText('dim', ex)}`)\n }\n console.log()\n }\n}\n","import { parseArgs, styleText } from 'node:util'\nimport { defineCLIAdapter } from '../define.ts'\nimport { renderHelp } from '../help.ts'\nimport type { CommandDefinition, OptionType, ParsedArgs, RunOptions } from '../types.ts'\n\ntype ParseOption = {\n type: OptionType\n short?: string\n default?: string | boolean\n}\ntype ParseOptions = Record<string, ParseOption>\n\nfunction buildParseOptions(def: CommandDefinition): ParseOptions {\n const result: ParseOptions = {\n help: { type: 'boolean', short: 'h' },\n }\n\n for (const [name, opt] of Object.entries(def.options ?? {})) {\n result[name] = {\n type: opt.type,\n ...(opt.short ? { short: opt.short } : {}),\n ...(opt.default !== undefined ? { default: opt.default } : {}),\n }\n }\n\n return result\n}\n\nasync function runCommand(def: CommandDefinition, argv: Array<string>, parentName?: string): Promise<void> {\n const parseOptions = buildParseOptions(def)\n\n let parsed: ParsedArgs\n try {\n const result = parseArgs({\n args: argv,\n options: parseOptions,\n allowPositionals: true,\n strict: false,\n })\n parsed = {\n values: result.values as ParsedArgs['values'],\n positionals: result.positionals,\n }\n } catch {\n renderHelp(def, parentName)\n process.exit(1)\n }\n\n if (parsed.values['help']) {\n renderHelp(def, parentName)\n process.exit(0)\n }\n\n // Validate required options before running the command\n for (const [name, opt] of Object.entries(def.options ?? {})) {\n if (opt.required && parsed.values[name] === undefined) {\n console.error(styleText('red', `Error: --${name} is required`))\n renderHelp(def, parentName)\n process.exit(1)\n }\n }\n\n if (!def.run) {\n renderHelp(def, parentName)\n process.exit(0)\n }\n\n try {\n await def.run(parsed)\n } catch (err) {\n console.error(styleText('red', `Error: ${err instanceof Error ? err.message : String(err)}`))\n renderHelp(def, parentName)\n process.exit(1)\n }\n}\n\nfunction printRootHelp(programName: string, version: string, defs: Array<CommandDefinition>): void {\n console.log(`\\n${styleText('bold', 'Usage:')} ${programName} <command> [options]\\n`)\n console.log(` Kubb v${version} — Generate TypeScript types, API clients, React Query hooks,`)\n console.log(` Zod schemas, and more from an OpenAPI specification.\\n`)\n console.log(` Quick start: ${styleText('cyan', `${programName} init`)} to scaffold a config, then ${styleText('cyan', `${programName} generate`)} to run.\\n`)\n console.log(styleText('bold', 'Commands:'))\n for (const def of defs) {\n console.log(` ${styleText('cyan', def.name.padEnd(16))}${def.description}`)\n }\n console.log()\n console.log(styleText('bold', 'Options:'))\n console.log(` ${styleText('cyan', '-v, --version'.padEnd(30))}Show version number`)\n console.log(` ${styleText('cyan', '-h, --help'.padEnd(30))}Show help`)\n console.log()\n console.log(`Run ${styleText('cyan', `${programName} <command> --help`)} for command-specific help.\\n`)\n}\n\n/**\n * CLI adapter using `node:util parseArgs`. No external dependencies.\n */\nexport const nodeAdapter = defineCLIAdapter({\n renderHelp(def: CommandDefinition, parentName?: string): void {\n renderHelp(def, parentName)\n },\n\n async run(defs: Array<CommandDefinition>, argv: Array<string>, opts: RunOptions): Promise<void> {\n const { programName, defaultCommandName, version } = opts\n\n // Strip the leading executable + script entries when process.argv is passed directly.\n // Handles Node.js (/usr/bin/node), Bun (/usr/local/bin/bun), Deno, tsx, etc.\n // All runtime executable paths contain a path separator; bare command names do not.\n const firstArgIsExecutablePath = (argv[0]?.includes('/') || argv[0]?.includes('\\\\')) ?? false\n const args = argv.length >= 2 && firstArgIsExecutablePath ? argv.slice(2) : argv\n\n if (args[0] === '--version' || args[0] === '-v') {\n console.log(version)\n process.exit(0)\n }\n\n if (args[0] === '--help' || args[0] === '-h') {\n printRootHelp(programName, version, defs)\n process.exit(0)\n }\n\n if (args.length === 0) {\n const defaultDef = defs.find((d) => d.name === defaultCommandName)\n if (defaultDef?.run) {\n await runCommand(defaultDef, [], programName)\n } else {\n printRootHelp(programName, version, defs)\n }\n return\n }\n\n const [first, ...rest] = args\n const isKnownSubcommand = defs.some((d) => d.name === first)\n\n let def: CommandDefinition | undefined\n let commandArgv: Array<string>\n let parentName: string | undefined\n\n if (isKnownSubcommand) {\n def = defs.find((d) => d.name === first)\n commandArgv = rest\n parentName = programName\n } else {\n def = defs.find((d) => d.name === defaultCommandName)\n commandArgv = args\n parentName = programName\n }\n\n if (!def) {\n console.error(`Unknown command: ${first}`)\n printRootHelp(programName, version, defs)\n process.exit(1)\n }\n\n if (def.subCommands?.length) {\n const [subName, ...subRest] = commandArgv\n const subDef = def.subCommands.find((s) => s.name === subName)\n\n if (subName === '--help' || subName === '-h') {\n renderHelp(def, parentName)\n process.exit(0)\n }\n\n if (!subDef) {\n renderHelp(def, parentName)\n process.exit(subName ? 1 : 0)\n }\n\n await runCommand(subDef, subRest, `${parentName} ${def.name}`)\n return\n }\n\n await runCommand(def, commandArgv, parentName)\n },\n})\n","import { nodeAdapter } from './adapters/nodeAdapter.ts'\nimport type { CLIAdapter, CommandDefinition, RunOptions } from './types.ts'\n\n/**\n * Creates a CLI runner bound to a specific adapter.\n *\n * @default nodeAdapter (Node.js `node:util parseArgs`)\n *\n * @example\n * ```ts\n * await createCLI().run(commands, process.argv.slice(2), {\n * programName: 'kubb',\n * defaultCommandName: 'generate',\n * version: '5.0.0',\n * })\n * ```\n */\nexport function createCLI(options?: { adapter?: CLIAdapter }): {\n run(commands: Array<CommandDefinition>, argv: Array<string>, opts: RunOptions): Promise<void>\n} {\n const adapter = options?.adapter ?? nodeAdapter\n\n return {\n run(commands, argv, opts) {\n return adapter.run(commands, argv, opts)\n },\n }\n}\n","import { styleText } from 'node:util'\nimport { createCLI } from '@internals/utils'\nimport { Telemetry } from './Telemetry.ts'\nimport { version } from '../package.json'\nimport { QUIET_FLAGS } from './constants.ts'\n\nconst cli = createCLI()\n/**\n * Entry point for the `kubb` CLI. Prints the telemetry notice unless telemetry is disabled or a\n * quiet flag is passed, then runs the generate, validate, mcp, and init commands. Defaults to\n * `generate` when no command is given.\n */\nexport async function run(argv: Array<string> = process.argv): Promise<void> {\n const isQuietFlag = argv.some((arg) => QUIET_FLAGS.has(arg))\n\n if (!Telemetry.isDisabled && !isQuietFlag) {\n console.log(\n `${styleText('yellow', 'Notice:')} Kubb collects anonymous telemetry data to help improve the tool. No personal data or file contents are collected. \\nTo disable, set ${styleText('cyan', 'KUBB_DISABLE_TELEMETRY=1')}.\\n`,\n )\n }\n\n const { command: generateCommand } = await import('./commands/generate.ts')\n const { command: validateCommand } = await import('./commands/validate.ts')\n const { command: mcpCommand } = await import('./commands/mcp.ts')\n const { command: initCommand } = await import('./commands/init.ts')\n\n await cli.run([generateCommand, validateCommand, mcpCommand, initCommand], argv, {\n programName: 'kubb',\n defaultCommandName: 'generate',\n version,\n })\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.cjs","names":["QUIET_FLAGS","Telemetry"],"sources":["../../../internals/utils/src/cli/renderHelp.ts","../../../internals/utils/src/cli/adapters/nodeAdapter.ts","../../../internals/utils/src/cli/createCLI.ts","../src/index.ts"],"sourcesContent":["import { styleText } from 'node:util'\nimport type { CommandDefinition, OptionDefinition } from './defineCommand.ts'\n\nfunction formatFlags(name: string, opt: OptionDefinition): string {\n const short = opt.short ? `-${opt.short}, ` : ''\n const value = opt.type === 'string' ? ` <${opt.hint ?? name}>` : ''\n return `${short}--${name}${value}`\n}\n\n/** Prints formatted help output for `def` using its `CommandDefinition`.\n *\n * @example\n * ```ts\n * renderHelp({ name: 'generate', description: 'Generate client code' })\n * // prints Usage: generate [options] ...\n * ```\n */\nexport function renderHelp(def: CommandDefinition, parentName?: string): void {\n const programName = parentName ? `${parentName} ${def.name}` : def.name\n const subCommands = def.subCommands ?? []\n\n const argsPart = def.arguments?.length ? ` ${def.arguments.join(' ')}` : ''\n const subCmdPart = subCommands.length ? ' <command>' : ''\n console.log(`\\n${styleText('bold', 'Usage:')} ${programName}${argsPart}${subCmdPart} [options]\\n`)\n\n if (def.description) {\n console.log(` ${def.description}\\n`)\n }\n\n if (subCommands.length) {\n console.log(styleText('bold', 'Commands:'))\n for (const sub of subCommands) {\n console.log(` ${styleText('cyan', sub.name.padEnd(16))}${sub.description}`)\n }\n console.log()\n }\n\n const options: Array<{ flags: string; description: string; default?: string | boolean }> = [\n ...Object.entries(def.options ?? {}).map(([name, opt]) => ({ flags: formatFlags(name, opt), description: opt.description, default: opt.default })),\n { flags: '-h, --help', description: 'Show help' },\n ]\n\n console.log(styleText('bold', 'Options:'))\n for (const opt of options) {\n const flags = styleText('cyan', opt.flags.padEnd(30))\n const defaultPart = opt.default !== undefined ? styleText('dim', ` (default: ${opt.default})`) : ''\n console.log(` ${flags}${opt.description}${defaultPart}`)\n }\n console.log()\n\n if (def.examples?.length) {\n console.log(styleText('bold', 'Examples:'))\n for (const ex of def.examples) {\n console.log(` ${styleText('dim', ex)}`)\n }\n console.log()\n }\n}\n","import { parseArgs, styleText } from 'node:util'\nimport type { CLIAdapter, RunOptions } from '../createCLI.ts'\nimport type { CommandDefinition, OptionType, ParsedArgs } from '../defineCommand.ts'\nimport { renderHelp } from '../renderHelp.ts'\n\ntype ParseOption = {\n type: OptionType\n short?: string\n default?: string | boolean\n}\ntype ParseOptions = Record<string, ParseOption>\n\nfunction buildParseOptions(def: CommandDefinition): ParseOptions {\n const result: ParseOptions = {\n help: { type: 'boolean', short: 'h' },\n }\n\n for (const [name, opt] of Object.entries(def.options ?? {})) {\n result[name] = {\n type: opt.type,\n ...(opt.short ? { short: opt.short } : {}),\n ...(opt.default !== undefined ? { default: opt.default } : {}),\n }\n }\n\n return result\n}\n\nasync function runCommand(def: CommandDefinition, argv: Array<string>, parentName?: string): Promise<void> {\n const parseOptions = buildParseOptions(def)\n\n let parsed: ParsedArgs\n try {\n const result = parseArgs({\n args: argv,\n options: parseOptions,\n allowPositionals: true,\n strict: false,\n })\n parsed = {\n values: result.values as ParsedArgs['values'],\n positionals: result.positionals,\n }\n } catch {\n renderHelp(def, parentName)\n process.exit(1)\n }\n\n if (parsed.values['help']) {\n renderHelp(def, parentName)\n process.exit(0)\n }\n\n // Validate required options before running the command\n for (const [name, opt] of Object.entries(def.options ?? {})) {\n if (opt.required && parsed.values[name] === undefined) {\n console.error(styleText('red', `Error: --${name} is required`))\n renderHelp(def, parentName)\n process.exit(1)\n }\n }\n\n if (!def.run) {\n renderHelp(def, parentName)\n process.exit(0)\n }\n\n try {\n await def.run(parsed)\n } catch (err) {\n console.error(styleText('red', `Error: ${err instanceof Error ? err.message : String(err)}`))\n renderHelp(def, parentName)\n process.exit(1)\n }\n}\n\nfunction printRootHelp(programName: string, version: string, defs: Array<CommandDefinition>): void {\n console.log(`\\n${styleText('bold', 'Usage:')} ${programName} <command> [options]\\n`)\n console.log(` Kubb v${version} — Generate TypeScript types, API clients, React Query hooks,`)\n console.log(` Zod schemas, and more from an OpenAPI specification.\\n`)\n console.log(` Quick start: ${styleText('cyan', `${programName} init`)} to scaffold a config, then ${styleText('cyan', `${programName} generate`)} to run.\\n`)\n console.log(styleText('bold', 'Commands:'))\n for (const def of defs) {\n console.log(` ${styleText('cyan', def.name.padEnd(16))}${def.description}`)\n }\n console.log()\n console.log(styleText('bold', 'Options:'))\n console.log(` ${styleText('cyan', '-v, --version'.padEnd(30))}Show version number`)\n console.log(` ${styleText('cyan', '-h, --help'.padEnd(30))}Show help`)\n console.log()\n console.log(`Run ${styleText('cyan', `${programName} <command> --help`)} for command-specific help.\\n`)\n}\n\n/**\n * CLI adapter using `node:util parseArgs`. No external dependencies.\n */\nexport const nodeAdapter: CLIAdapter = {\n renderHelp(def: CommandDefinition, parentName?: string): void {\n renderHelp(def, parentName)\n },\n\n async run(defs: Array<CommandDefinition>, argv: Array<string>, opts: RunOptions): Promise<void> {\n const { programName, defaultCommandName, version } = opts\n\n // Strip the leading executable + script entries when process.argv is passed directly.\n // Handles Node.js (/usr/bin/node), Bun (/usr/local/bin/bun), Deno, tsx, etc.\n // All runtime executable paths contain a path separator; bare command names do not.\n const firstArgIsExecutablePath = (argv[0]?.includes('/') || argv[0]?.includes('\\\\')) ?? false\n const args = argv.length >= 2 && firstArgIsExecutablePath ? argv.slice(2) : argv\n\n if (args[0] === '--version' || args[0] === '-v') {\n console.log(version)\n process.exit(0)\n }\n\n if (args[0] === '--help' || args[0] === '-h') {\n printRootHelp(programName, version, defs)\n process.exit(0)\n }\n\n if (args.length === 0) {\n const defaultDef = defs.find((d) => d.name === defaultCommandName)\n if (defaultDef?.run) {\n await runCommand(defaultDef, [], programName)\n } else {\n printRootHelp(programName, version, defs)\n }\n return\n }\n\n const [first, ...rest] = args\n const isKnownSubcommand = defs.some((d) => d.name === first)\n\n let def: CommandDefinition | undefined\n let commandArgv: Array<string>\n let parentName: string | undefined\n\n if (isKnownSubcommand) {\n def = defs.find((d) => d.name === first)\n commandArgv = rest\n parentName = programName\n } else {\n def = defs.find((d) => d.name === defaultCommandName)\n commandArgv = args\n parentName = programName\n }\n\n if (!def) {\n console.error(`Unknown command: ${first}`)\n printRootHelp(programName, version, defs)\n process.exit(1)\n }\n\n if (def.subCommands?.length) {\n const [subName, ...subRest] = commandArgv\n const subDef = def.subCommands.find((s) => s.name === subName)\n\n if (subName === '--help' || subName === '-h') {\n renderHelp(def, parentName)\n process.exit(0)\n }\n\n if (!subDef) {\n renderHelp(def, parentName)\n process.exit(subName ? 1 : 0)\n }\n\n await runCommand(subDef, subRest, `${parentName} ${def.name}`)\n return\n }\n\n await runCommand(def, commandArgv, parentName)\n },\n}\n","import { nodeAdapter } from './adapters/nodeAdapter.ts'\nimport type { CommandDefinition } from './defineCommand.ts'\n\n/**\n * Options passed to every `CLIAdapter.run` invocation.\n */\nexport type RunOptions = {\n programName: string\n defaultCommandName: string\n version: string\n}\n\n/**\n * Interface a CLI adapter must implement to plug into `createCLI`.\n */\nexport type CLIAdapter = {\n run(commands: Array<CommandDefinition>, argv: Array<string>, opts: RunOptions): Promise<void>\n renderHelp(def: CommandDefinition, parentName?: string): void\n}\n\n/**\n * Creates a CLI runner bound to a specific adapter.\n *\n * @default nodeAdapter (Node.js `node:util parseArgs`)\n *\n * @example\n * ```ts\n * await createCLI().run(commands, process.argv.slice(2), {\n * programName: 'kubb',\n * defaultCommandName: 'generate',\n * version: '5.0.0',\n * })\n * ```\n */\nexport function createCLI(options?: { adapter?: CLIAdapter }): {\n run(commands: Array<CommandDefinition>, argv: Array<string>, opts: RunOptions): Promise<void>\n} {\n const adapter = options?.adapter ?? nodeAdapter\n\n return {\n run(commands, argv, opts) {\n return adapter.run(commands, argv, opts)\n },\n }\n}\n","import { styleText } from 'node:util'\nimport { createCLI } from '@internals/utils'\nimport { Telemetry } from './Telemetry.ts'\nimport { version } from '../package.json'\nimport { QUIET_FLAGS } from './constants.ts'\n\nconst cli = createCLI()\n/**\n * Entry point for the `kubb` CLI. Prints the telemetry notice unless telemetry is disabled or a\n * quiet flag is passed, then runs the generate, validate, mcp, and init commands. Defaults to\n * `generate` when no command is given.\n */\nexport async function run(argv: Array<string> = process.argv): Promise<void> {\n const isQuietFlag = argv.some((arg) => QUIET_FLAGS.has(arg))\n\n if (!Telemetry.isDisabled && !isQuietFlag) {\n console.log(\n `${styleText('yellow', 'Notice:')} Kubb collects anonymous telemetry data to help improve the tool. No personal data or file contents are collected. \\nTo disable, set ${styleText('cyan', 'KUBB_DISABLE_TELEMETRY=1')}.\\n`,\n )\n }\n\n const { command: generateCommand } = await import('./commands/generate.ts')\n const { command: validateCommand } = await import('./commands/validate.ts')\n const { command: mcpCommand } = await import('./commands/mcp.ts')\n const { command: initCommand } = await import('./commands/init.ts')\n\n await cli.run([generateCommand, validateCommand, mcpCommand, initCommand], argv, {\n programName: 'kubb',\n defaultCommandName: 'generate',\n version,\n })\n}\n"],"mappings":"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"}
|
package/dist/index.js
CHANGED
|
@@ -1,48 +1,11 @@
|
|
|
1
1
|
import "./rolldown-runtime-C0LytTxp.js";
|
|
2
|
-
import { t as defineCLIAdapter } from "./define-GYXr00ky.js";
|
|
3
2
|
import { r as QUIET_FLAGS, t as Telemetry } from "./Telemetry-uAr3lK_-.js";
|
|
4
|
-
import { t as version } from "./package-
|
|
3
|
+
import { t as version } from "./package-DA31STdg.js";
|
|
5
4
|
import { parseArgs, styleText } from "node:util";
|
|
6
|
-
//#region ../../internals/utils/src/cli/
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
* Use to expose CLI capabilities to AI agents or MCP tools.
|
|
10
|
-
*
|
|
11
|
-
* @example
|
|
12
|
-
* ```ts
|
|
13
|
-
* getCommandSchema([generateCommand, agentCommand])
|
|
14
|
-
* // [{ name: 'generate', options: [...], subCommands: [] }, ...]
|
|
15
|
-
* ```
|
|
16
|
-
*/
|
|
17
|
-
function getCommandSchema(defs) {
|
|
18
|
-
return defs.map(serializeCommand);
|
|
5
|
+
//#region ../../internals/utils/src/cli/renderHelp.ts
|
|
6
|
+
function formatFlags(name, opt) {
|
|
7
|
+
return `${opt.short ? `-${opt.short}, ` : ""}--${name}${opt.type === "string" ? ` <${opt.hint ?? name}>` : ""}`;
|
|
19
8
|
}
|
|
20
|
-
function serializeCommand(def) {
|
|
21
|
-
return {
|
|
22
|
-
name: def.name,
|
|
23
|
-
description: def.description,
|
|
24
|
-
arguments: def.arguments,
|
|
25
|
-
...def.examples?.length ? { examples: def.examples } : {},
|
|
26
|
-
options: serializeOptions(def.options ?? {}),
|
|
27
|
-
subCommands: def.subCommands ? def.subCommands.map(serializeCommand) : []
|
|
28
|
-
};
|
|
29
|
-
}
|
|
30
|
-
function serializeOptions(options) {
|
|
31
|
-
return Object.entries(options).map(([name, opt]) => {
|
|
32
|
-
return {
|
|
33
|
-
name,
|
|
34
|
-
flags: `${opt.short ? `-${opt.short}, ` : ""}--${name}${opt.type === "string" ? ` <${opt.hint ?? name}>` : ""}`,
|
|
35
|
-
type: opt.type,
|
|
36
|
-
description: opt.description,
|
|
37
|
-
...opt.default !== void 0 ? { default: opt.default } : {},
|
|
38
|
-
...opt.hint ? { hint: opt.hint } : {},
|
|
39
|
-
...opt.enum ? { enum: opt.enum } : {},
|
|
40
|
-
...opt.required ? { required: opt.required } : {}
|
|
41
|
-
};
|
|
42
|
-
});
|
|
43
|
-
}
|
|
44
|
-
//#endregion
|
|
45
|
-
//#region ../../internals/utils/src/cli/help.ts
|
|
46
9
|
/** Prints formatted help output for `def` using its `CommandDefinition`.
|
|
47
10
|
*
|
|
48
11
|
* @example
|
|
@@ -52,21 +15,23 @@ function serializeOptions(options) {
|
|
|
52
15
|
* ```
|
|
53
16
|
*/
|
|
54
17
|
function renderHelp(def, parentName) {
|
|
55
|
-
const
|
|
56
|
-
const
|
|
57
|
-
const argsPart =
|
|
58
|
-
const subCmdPart =
|
|
18
|
+
const programName = parentName ? `${parentName} ${def.name}` : def.name;
|
|
19
|
+
const subCommands = def.subCommands ?? [];
|
|
20
|
+
const argsPart = def.arguments?.length ? ` ${def.arguments.join(" ")}` : "";
|
|
21
|
+
const subCmdPart = subCommands.length ? " <command>" : "";
|
|
59
22
|
console.log(`\n${styleText("bold", "Usage:")} ${programName}${argsPart}${subCmdPart} [options]\n`);
|
|
60
|
-
if (
|
|
61
|
-
if (
|
|
23
|
+
if (def.description) console.log(` ${def.description}\n`);
|
|
24
|
+
if (subCommands.length) {
|
|
62
25
|
console.log(styleText("bold", "Commands:"));
|
|
63
|
-
for (const sub of
|
|
26
|
+
for (const sub of subCommands) console.log(` ${styleText("cyan", sub.name.padEnd(16))}${sub.description}`);
|
|
64
27
|
console.log();
|
|
65
28
|
}
|
|
66
|
-
const options = [...
|
|
67
|
-
|
|
29
|
+
const options = [...Object.entries(def.options ?? {}).map(([name, opt]) => ({
|
|
30
|
+
flags: formatFlags(name, opt),
|
|
31
|
+
description: opt.description,
|
|
32
|
+
default: opt.default
|
|
33
|
+
})), {
|
|
68
34
|
flags: "-h, --help",
|
|
69
|
-
type: "boolean",
|
|
70
35
|
description: "Show help"
|
|
71
36
|
}];
|
|
72
37
|
console.log(styleText("bold", "Options:"));
|
|
@@ -76,9 +41,9 @@ function renderHelp(def, parentName) {
|
|
|
76
41
|
console.log(` ${flags}${opt.description}${defaultPart}`);
|
|
77
42
|
}
|
|
78
43
|
console.log();
|
|
79
|
-
if (
|
|
44
|
+
if (def.examples?.length) {
|
|
80
45
|
console.log(styleText("bold", "Examples:"));
|
|
81
|
-
for (const ex of
|
|
46
|
+
for (const ex of def.examples) console.log(` ${styleText("dim", ex)}`);
|
|
82
47
|
console.log();
|
|
83
48
|
}
|
|
84
49
|
}
|
|
@@ -152,7 +117,7 @@ function printRootHelp(programName, version, defs) {
|
|
|
152
117
|
/**
|
|
153
118
|
* CLI adapter using `node:util parseArgs`. No external dependencies.
|
|
154
119
|
*/
|
|
155
|
-
const nodeAdapter =
|
|
120
|
+
const nodeAdapter = {
|
|
156
121
|
renderHelp(def, parentName) {
|
|
157
122
|
renderHelp(def, parentName);
|
|
158
123
|
},
|
|
@@ -209,9 +174,9 @@ const nodeAdapter = defineCLIAdapter({
|
|
|
209
174
|
}
|
|
210
175
|
await runCommand(def, commandArgv, parentName);
|
|
211
176
|
}
|
|
212
|
-
}
|
|
177
|
+
};
|
|
213
178
|
//#endregion
|
|
214
|
-
//#region ../../internals/utils/src/cli/
|
|
179
|
+
//#region ../../internals/utils/src/cli/createCLI.ts
|
|
215
180
|
/**
|
|
216
181
|
* Creates a CLI runner bound to a specific adapter.
|
|
217
182
|
*
|
|
@@ -243,10 +208,10 @@ const cli = createCLI();
|
|
|
243
208
|
async function run(argv = process.argv) {
|
|
244
209
|
const isQuietFlag = argv.some((arg) => QUIET_FLAGS.has(arg));
|
|
245
210
|
if (!Telemetry.isDisabled && !isQuietFlag) console.log(`${styleText("yellow", "Notice:")} Kubb collects anonymous telemetry data to help improve the tool. No personal data or file contents are collected. \nTo disable, set ${styleText("cyan", "KUBB_DISABLE_TELEMETRY=1")}.\n`);
|
|
246
|
-
const { command: generateCommand } = await import("./generate-
|
|
247
|
-
const { command: validateCommand } = await import("./validate-
|
|
248
|
-
const { command: mcpCommand } = await import("./mcp-
|
|
249
|
-
const { command: initCommand } = await import("./init-
|
|
211
|
+
const { command: generateCommand } = await import("./generate-Bv36TZRy.js");
|
|
212
|
+
const { command: validateCommand } = await import("./validate-SkDAzU_5.js");
|
|
213
|
+
const { command: mcpCommand } = await import("./mcp-DN1u2C54.js");
|
|
214
|
+
const { command: initCommand } = await import("./init-CK76OU9h.js");
|
|
250
215
|
await cli.run([
|
|
251
216
|
generateCommand,
|
|
252
217
|
validateCommand,
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":[],"sources":["../../../internals/utils/src/cli/schema.ts","../../../internals/utils/src/cli/help.ts","../../../internals/utils/src/cli/adapters/nodeAdapter.ts","../../../internals/utils/src/cli/parse.ts","../src/index.ts"],"sourcesContent":["import type { CommandDefinition, CommandSchema, OptionDefinition, OptionSchema } from './types.ts'\n\n/**\n * Serializes `CommandDefinition[]` to a plain, JSON-serializable structure.\n * Use to expose CLI capabilities to AI agents or MCP tools.\n *\n * @example\n * ```ts\n * getCommandSchema([generateCommand, agentCommand])\n * // [{ name: 'generate', options: [...], subCommands: [] }, ...]\n * ```\n */\nexport function getCommandSchema(defs: Array<CommandDefinition>): Array<CommandSchema> {\n return defs.map(serializeCommand)\n}\n\nfunction serializeCommand(def: CommandDefinition): CommandSchema {\n return {\n name: def.name,\n description: def.description,\n arguments: def.arguments,\n ...(def.examples?.length ? { examples: def.examples } : {}),\n options: serializeOptions(def.options ?? {}),\n subCommands: def.subCommands ? def.subCommands.map(serializeCommand) : [],\n }\n}\n\nfunction serializeOptions(options: Record<string, OptionDefinition>): Array<OptionSchema> {\n return Object.entries(options).map(([name, opt]) => {\n const shortPart = opt.short ? `-${opt.short}, ` : ''\n const valuePart = opt.type === 'string' ? ` <${opt.hint ?? name}>` : ''\n const flags = `${shortPart}--${name}${valuePart}`\n\n return {\n name,\n flags,\n type: opt.type,\n description: opt.description,\n ...(opt.default !== undefined ? { default: opt.default } : {}),\n ...(opt.hint ? { hint: opt.hint } : {}),\n ...(opt.enum ? { enum: opt.enum } : {}),\n ...(opt.required ? { required: opt.required } : {}),\n }\n })\n}\n","import { styleText } from 'node:util'\nimport { getCommandSchema } from './schema.ts'\nimport type { CommandDefinition, OptionSchema } from './types.ts'\n\n/** Prints formatted help output for `def` using its `CommandDefinition`.\n *\n * @example\n * ```ts\n * renderHelp({ name: 'generate', description: 'Generate client code' })\n * // prints Usage: generate [options] ...\n * ```\n */\nexport function renderHelp(def: CommandDefinition, parentName?: string): void {\n const schema = getCommandSchema([def])[0]!\n\n const programName = parentName ? `${parentName} ${schema.name}` : schema.name\n\n const argsPart = schema.arguments?.length ? ` ${schema.arguments.join(' ')}` : ''\n const subCmdPart = schema.subCommands.length ? ' <command>' : ''\n console.log(`\\n${styleText('bold', 'Usage:')} ${programName}${argsPart}${subCmdPart} [options]\\n`)\n\n if (schema.description) {\n console.log(` ${schema.description}\\n`)\n }\n\n if (schema.subCommands.length) {\n console.log(styleText('bold', 'Commands:'))\n for (const sub of schema.subCommands) {\n console.log(` ${styleText('cyan', sub.name.padEnd(16))}${sub.description}`)\n }\n console.log()\n }\n\n const options: Array<OptionSchema> = [\n ...schema.options,\n {\n name: 'help',\n flags: '-h, --help',\n type: 'boolean' as const,\n description: 'Show help',\n },\n ]\n\n console.log(styleText('bold', 'Options:'))\n for (const opt of options) {\n const flags = styleText('cyan', opt.flags.padEnd(30))\n const defaultPart = opt.default !== undefined ? styleText('dim', ` (default: ${opt.default})`) : ''\n console.log(` ${flags}${opt.description}${defaultPart}`)\n }\n console.log()\n\n if (schema.examples?.length) {\n console.log(styleText('bold', 'Examples:'))\n for (const ex of schema.examples) {\n console.log(` ${styleText('dim', ex)}`)\n }\n console.log()\n }\n}\n","import { parseArgs, styleText } from 'node:util'\nimport { defineCLIAdapter } from '../define.ts'\nimport { renderHelp } from '../help.ts'\nimport type { CommandDefinition, OptionType, ParsedArgs, RunOptions } from '../types.ts'\n\ntype ParseOption = {\n type: OptionType\n short?: string\n default?: string | boolean\n}\ntype ParseOptions = Record<string, ParseOption>\n\nfunction buildParseOptions(def: CommandDefinition): ParseOptions {\n const result: ParseOptions = {\n help: { type: 'boolean', short: 'h' },\n }\n\n for (const [name, opt] of Object.entries(def.options ?? {})) {\n result[name] = {\n type: opt.type,\n ...(opt.short ? { short: opt.short } : {}),\n ...(opt.default !== undefined ? { default: opt.default } : {}),\n }\n }\n\n return result\n}\n\nasync function runCommand(def: CommandDefinition, argv: Array<string>, parentName?: string): Promise<void> {\n const parseOptions = buildParseOptions(def)\n\n let parsed: ParsedArgs\n try {\n const result = parseArgs({\n args: argv,\n options: parseOptions,\n allowPositionals: true,\n strict: false,\n })\n parsed = {\n values: result.values as ParsedArgs['values'],\n positionals: result.positionals,\n }\n } catch {\n renderHelp(def, parentName)\n process.exit(1)\n }\n\n if (parsed.values['help']) {\n renderHelp(def, parentName)\n process.exit(0)\n }\n\n // Validate required options before running the command\n for (const [name, opt] of Object.entries(def.options ?? {})) {\n if (opt.required && parsed.values[name] === undefined) {\n console.error(styleText('red', `Error: --${name} is required`))\n renderHelp(def, parentName)\n process.exit(1)\n }\n }\n\n if (!def.run) {\n renderHelp(def, parentName)\n process.exit(0)\n }\n\n try {\n await def.run(parsed)\n } catch (err) {\n console.error(styleText('red', `Error: ${err instanceof Error ? err.message : String(err)}`))\n renderHelp(def, parentName)\n process.exit(1)\n }\n}\n\nfunction printRootHelp(programName: string, version: string, defs: Array<CommandDefinition>): void {\n console.log(`\\n${styleText('bold', 'Usage:')} ${programName} <command> [options]\\n`)\n console.log(` Kubb v${version} — Generate TypeScript types, API clients, React Query hooks,`)\n console.log(` Zod schemas, and more from an OpenAPI specification.\\n`)\n console.log(` Quick start: ${styleText('cyan', `${programName} init`)} to scaffold a config, then ${styleText('cyan', `${programName} generate`)} to run.\\n`)\n console.log(styleText('bold', 'Commands:'))\n for (const def of defs) {\n console.log(` ${styleText('cyan', def.name.padEnd(16))}${def.description}`)\n }\n console.log()\n console.log(styleText('bold', 'Options:'))\n console.log(` ${styleText('cyan', '-v, --version'.padEnd(30))}Show version number`)\n console.log(` ${styleText('cyan', '-h, --help'.padEnd(30))}Show help`)\n console.log()\n console.log(`Run ${styleText('cyan', `${programName} <command> --help`)} for command-specific help.\\n`)\n}\n\n/**\n * CLI adapter using `node:util parseArgs`. No external dependencies.\n */\nexport const nodeAdapter = defineCLIAdapter({\n renderHelp(def: CommandDefinition, parentName?: string): void {\n renderHelp(def, parentName)\n },\n\n async run(defs: Array<CommandDefinition>, argv: Array<string>, opts: RunOptions): Promise<void> {\n const { programName, defaultCommandName, version } = opts\n\n // Strip the leading executable + script entries when process.argv is passed directly.\n // Handles Node.js (/usr/bin/node), Bun (/usr/local/bin/bun), Deno, tsx, etc.\n // All runtime executable paths contain a path separator; bare command names do not.\n const firstArgIsExecutablePath = (argv[0]?.includes('/') || argv[0]?.includes('\\\\')) ?? false\n const args = argv.length >= 2 && firstArgIsExecutablePath ? argv.slice(2) : argv\n\n if (args[0] === '--version' || args[0] === '-v') {\n console.log(version)\n process.exit(0)\n }\n\n if (args[0] === '--help' || args[0] === '-h') {\n printRootHelp(programName, version, defs)\n process.exit(0)\n }\n\n if (args.length === 0) {\n const defaultDef = defs.find((d) => d.name === defaultCommandName)\n if (defaultDef?.run) {\n await runCommand(defaultDef, [], programName)\n } else {\n printRootHelp(programName, version, defs)\n }\n return\n }\n\n const [first, ...rest] = args\n const isKnownSubcommand = defs.some((d) => d.name === first)\n\n let def: CommandDefinition | undefined\n let commandArgv: Array<string>\n let parentName: string | undefined\n\n if (isKnownSubcommand) {\n def = defs.find((d) => d.name === first)\n commandArgv = rest\n parentName = programName\n } else {\n def = defs.find((d) => d.name === defaultCommandName)\n commandArgv = args\n parentName = programName\n }\n\n if (!def) {\n console.error(`Unknown command: ${first}`)\n printRootHelp(programName, version, defs)\n process.exit(1)\n }\n\n if (def.subCommands?.length) {\n const [subName, ...subRest] = commandArgv\n const subDef = def.subCommands.find((s) => s.name === subName)\n\n if (subName === '--help' || subName === '-h') {\n renderHelp(def, parentName)\n process.exit(0)\n }\n\n if (!subDef) {\n renderHelp(def, parentName)\n process.exit(subName ? 1 : 0)\n }\n\n await runCommand(subDef, subRest, `${parentName} ${def.name}`)\n return\n }\n\n await runCommand(def, commandArgv, parentName)\n },\n})\n","import { nodeAdapter } from './adapters/nodeAdapter.ts'\nimport type { CLIAdapter, CommandDefinition, RunOptions } from './types.ts'\n\n/**\n * Creates a CLI runner bound to a specific adapter.\n *\n * @default nodeAdapter (Node.js `node:util parseArgs`)\n *\n * @example\n * ```ts\n * await createCLI().run(commands, process.argv.slice(2), {\n * programName: 'kubb',\n * defaultCommandName: 'generate',\n * version: '5.0.0',\n * })\n * ```\n */\nexport function createCLI(options?: { adapter?: CLIAdapter }): {\n run(commands: Array<CommandDefinition>, argv: Array<string>, opts: RunOptions): Promise<void>\n} {\n const adapter = options?.adapter ?? nodeAdapter\n\n return {\n run(commands, argv, opts) {\n return adapter.run(commands, argv, opts)\n },\n }\n}\n","import { styleText } from 'node:util'\nimport { createCLI } from '@internals/utils'\nimport { Telemetry } from './Telemetry.ts'\nimport { version } from '../package.json'\nimport { QUIET_FLAGS } from './constants.ts'\n\nconst cli = createCLI()\n/**\n * Entry point for the `kubb` CLI. Prints the telemetry notice unless telemetry is disabled or a\n * quiet flag is passed, then runs the generate, validate, mcp, and init commands. Defaults to\n * `generate` when no command is given.\n */\nexport async function run(argv: Array<string> = process.argv): Promise<void> {\n const isQuietFlag = argv.some((arg) => QUIET_FLAGS.has(arg))\n\n if (!Telemetry.isDisabled && !isQuietFlag) {\n console.log(\n `${styleText('yellow', 'Notice:')} Kubb collects anonymous telemetry data to help improve the tool. No personal data or file contents are collected. \\nTo disable, set ${styleText('cyan', 'KUBB_DISABLE_TELEMETRY=1')}.\\n`,\n )\n }\n\n const { command: generateCommand } = await import('./commands/generate.ts')\n const { command: validateCommand } = await import('./commands/validate.ts')\n const { command: mcpCommand } = await import('./commands/mcp.ts')\n const { command: initCommand } = await import('./commands/init.ts')\n\n await cli.run([generateCommand, validateCommand, mcpCommand, initCommand], argv, {\n programName: 'kubb',\n defaultCommandName: 'generate',\n version,\n })\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.js","names":[],"sources":["../../../internals/utils/src/cli/renderHelp.ts","../../../internals/utils/src/cli/adapters/nodeAdapter.ts","../../../internals/utils/src/cli/createCLI.ts","../src/index.ts"],"sourcesContent":["import { styleText } from 'node:util'\nimport type { CommandDefinition, OptionDefinition } from './defineCommand.ts'\n\nfunction formatFlags(name: string, opt: OptionDefinition): string {\n const short = opt.short ? `-${opt.short}, ` : ''\n const value = opt.type === 'string' ? ` <${opt.hint ?? name}>` : ''\n return `${short}--${name}${value}`\n}\n\n/** Prints formatted help output for `def` using its `CommandDefinition`.\n *\n * @example\n * ```ts\n * renderHelp({ name: 'generate', description: 'Generate client code' })\n * // prints Usage: generate [options] ...\n * ```\n */\nexport function renderHelp(def: CommandDefinition, parentName?: string): void {\n const programName = parentName ? `${parentName} ${def.name}` : def.name\n const subCommands = def.subCommands ?? []\n\n const argsPart = def.arguments?.length ? ` ${def.arguments.join(' ')}` : ''\n const subCmdPart = subCommands.length ? ' <command>' : ''\n console.log(`\\n${styleText('bold', 'Usage:')} ${programName}${argsPart}${subCmdPart} [options]\\n`)\n\n if (def.description) {\n console.log(` ${def.description}\\n`)\n }\n\n if (subCommands.length) {\n console.log(styleText('bold', 'Commands:'))\n for (const sub of subCommands) {\n console.log(` ${styleText('cyan', sub.name.padEnd(16))}${sub.description}`)\n }\n console.log()\n }\n\n const options: Array<{ flags: string; description: string; default?: string | boolean }> = [\n ...Object.entries(def.options ?? {}).map(([name, opt]) => ({ flags: formatFlags(name, opt), description: opt.description, default: opt.default })),\n { flags: '-h, --help', description: 'Show help' },\n ]\n\n console.log(styleText('bold', 'Options:'))\n for (const opt of options) {\n const flags = styleText('cyan', opt.flags.padEnd(30))\n const defaultPart = opt.default !== undefined ? styleText('dim', ` (default: ${opt.default})`) : ''\n console.log(` ${flags}${opt.description}${defaultPart}`)\n }\n console.log()\n\n if (def.examples?.length) {\n console.log(styleText('bold', 'Examples:'))\n for (const ex of def.examples) {\n console.log(` ${styleText('dim', ex)}`)\n }\n console.log()\n }\n}\n","import { parseArgs, styleText } from 'node:util'\nimport type { CLIAdapter, RunOptions } from '../createCLI.ts'\nimport type { CommandDefinition, OptionType, ParsedArgs } from '../defineCommand.ts'\nimport { renderHelp } from '../renderHelp.ts'\n\ntype ParseOption = {\n type: OptionType\n short?: string\n default?: string | boolean\n}\ntype ParseOptions = Record<string, ParseOption>\n\nfunction buildParseOptions(def: CommandDefinition): ParseOptions {\n const result: ParseOptions = {\n help: { type: 'boolean', short: 'h' },\n }\n\n for (const [name, opt] of Object.entries(def.options ?? {})) {\n result[name] = {\n type: opt.type,\n ...(opt.short ? { short: opt.short } : {}),\n ...(opt.default !== undefined ? { default: opt.default } : {}),\n }\n }\n\n return result\n}\n\nasync function runCommand(def: CommandDefinition, argv: Array<string>, parentName?: string): Promise<void> {\n const parseOptions = buildParseOptions(def)\n\n let parsed: ParsedArgs\n try {\n const result = parseArgs({\n args: argv,\n options: parseOptions,\n allowPositionals: true,\n strict: false,\n })\n parsed = {\n values: result.values as ParsedArgs['values'],\n positionals: result.positionals,\n }\n } catch {\n renderHelp(def, parentName)\n process.exit(1)\n }\n\n if (parsed.values['help']) {\n renderHelp(def, parentName)\n process.exit(0)\n }\n\n // Validate required options before running the command\n for (const [name, opt] of Object.entries(def.options ?? {})) {\n if (opt.required && parsed.values[name] === undefined) {\n console.error(styleText('red', `Error: --${name} is required`))\n renderHelp(def, parentName)\n process.exit(1)\n }\n }\n\n if (!def.run) {\n renderHelp(def, parentName)\n process.exit(0)\n }\n\n try {\n await def.run(parsed)\n } catch (err) {\n console.error(styleText('red', `Error: ${err instanceof Error ? err.message : String(err)}`))\n renderHelp(def, parentName)\n process.exit(1)\n }\n}\n\nfunction printRootHelp(programName: string, version: string, defs: Array<CommandDefinition>): void {\n console.log(`\\n${styleText('bold', 'Usage:')} ${programName} <command> [options]\\n`)\n console.log(` Kubb v${version} — Generate TypeScript types, API clients, React Query hooks,`)\n console.log(` Zod schemas, and more from an OpenAPI specification.\\n`)\n console.log(` Quick start: ${styleText('cyan', `${programName} init`)} to scaffold a config, then ${styleText('cyan', `${programName} generate`)} to run.\\n`)\n console.log(styleText('bold', 'Commands:'))\n for (const def of defs) {\n console.log(` ${styleText('cyan', def.name.padEnd(16))}${def.description}`)\n }\n console.log()\n console.log(styleText('bold', 'Options:'))\n console.log(` ${styleText('cyan', '-v, --version'.padEnd(30))}Show version number`)\n console.log(` ${styleText('cyan', '-h, --help'.padEnd(30))}Show help`)\n console.log()\n console.log(`Run ${styleText('cyan', `${programName} <command> --help`)} for command-specific help.\\n`)\n}\n\n/**\n * CLI adapter using `node:util parseArgs`. No external dependencies.\n */\nexport const nodeAdapter: CLIAdapter = {\n renderHelp(def: CommandDefinition, parentName?: string): void {\n renderHelp(def, parentName)\n },\n\n async run(defs: Array<CommandDefinition>, argv: Array<string>, opts: RunOptions): Promise<void> {\n const { programName, defaultCommandName, version } = opts\n\n // Strip the leading executable + script entries when process.argv is passed directly.\n // Handles Node.js (/usr/bin/node), Bun (/usr/local/bin/bun), Deno, tsx, etc.\n // All runtime executable paths contain a path separator; bare command names do not.\n const firstArgIsExecutablePath = (argv[0]?.includes('/') || argv[0]?.includes('\\\\')) ?? false\n const args = argv.length >= 2 && firstArgIsExecutablePath ? argv.slice(2) : argv\n\n if (args[0] === '--version' || args[0] === '-v') {\n console.log(version)\n process.exit(0)\n }\n\n if (args[0] === '--help' || args[0] === '-h') {\n printRootHelp(programName, version, defs)\n process.exit(0)\n }\n\n if (args.length === 0) {\n const defaultDef = defs.find((d) => d.name === defaultCommandName)\n if (defaultDef?.run) {\n await runCommand(defaultDef, [], programName)\n } else {\n printRootHelp(programName, version, defs)\n }\n return\n }\n\n const [first, ...rest] = args\n const isKnownSubcommand = defs.some((d) => d.name === first)\n\n let def: CommandDefinition | undefined\n let commandArgv: Array<string>\n let parentName: string | undefined\n\n if (isKnownSubcommand) {\n def = defs.find((d) => d.name === first)\n commandArgv = rest\n parentName = programName\n } else {\n def = defs.find((d) => d.name === defaultCommandName)\n commandArgv = args\n parentName = programName\n }\n\n if (!def) {\n console.error(`Unknown command: ${first}`)\n printRootHelp(programName, version, defs)\n process.exit(1)\n }\n\n if (def.subCommands?.length) {\n const [subName, ...subRest] = commandArgv\n const subDef = def.subCommands.find((s) => s.name === subName)\n\n if (subName === '--help' || subName === '-h') {\n renderHelp(def, parentName)\n process.exit(0)\n }\n\n if (!subDef) {\n renderHelp(def, parentName)\n process.exit(subName ? 1 : 0)\n }\n\n await runCommand(subDef, subRest, `${parentName} ${def.name}`)\n return\n }\n\n await runCommand(def, commandArgv, parentName)\n },\n}\n","import { nodeAdapter } from './adapters/nodeAdapter.ts'\nimport type { CommandDefinition } from './defineCommand.ts'\n\n/**\n * Options passed to every `CLIAdapter.run` invocation.\n */\nexport type RunOptions = {\n programName: string\n defaultCommandName: string\n version: string\n}\n\n/**\n * Interface a CLI adapter must implement to plug into `createCLI`.\n */\nexport type CLIAdapter = {\n run(commands: Array<CommandDefinition>, argv: Array<string>, opts: RunOptions): Promise<void>\n renderHelp(def: CommandDefinition, parentName?: string): void\n}\n\n/**\n * Creates a CLI runner bound to a specific adapter.\n *\n * @default nodeAdapter (Node.js `node:util parseArgs`)\n *\n * @example\n * ```ts\n * await createCLI().run(commands, process.argv.slice(2), {\n * programName: 'kubb',\n * defaultCommandName: 'generate',\n * version: '5.0.0',\n * })\n * ```\n */\nexport function createCLI(options?: { adapter?: CLIAdapter }): {\n run(commands: Array<CommandDefinition>, argv: Array<string>, opts: RunOptions): Promise<void>\n} {\n const adapter = options?.adapter ?? nodeAdapter\n\n return {\n run(commands, argv, opts) {\n return adapter.run(commands, argv, opts)\n },\n }\n}\n","import { styleText } from 'node:util'\nimport { createCLI } from '@internals/utils'\nimport { Telemetry } from './Telemetry.ts'\nimport { version } from '../package.json'\nimport { QUIET_FLAGS } from './constants.ts'\n\nconst cli = createCLI()\n/**\n * Entry point for the `kubb` CLI. Prints the telemetry notice unless telemetry is disabled or a\n * quiet flag is passed, then runs the generate, validate, mcp, and init commands. Defaults to\n * `generate` when no command is given.\n */\nexport async function run(argv: Array<string> = process.argv): Promise<void> {\n const isQuietFlag = argv.some((arg) => QUIET_FLAGS.has(arg))\n\n if (!Telemetry.isDisabled && !isQuietFlag) {\n console.log(\n `${styleText('yellow', 'Notice:')} Kubb collects anonymous telemetry data to help improve the tool. No personal data or file contents are collected. \\nTo disable, set ${styleText('cyan', 'KUBB_DISABLE_TELEMETRY=1')}.\\n`,\n )\n }\n\n const { command: generateCommand } = await import('./commands/generate.ts')\n const { command: validateCommand } = await import('./commands/validate.ts')\n const { command: mcpCommand } = await import('./commands/mcp.ts')\n const { command: initCommand } = await import('./commands/init.ts')\n\n await cli.run([generateCommand, validateCommand, mcpCommand, initCommand], argv, {\n programName: 'kubb',\n defaultCommandName: 'generate',\n version,\n })\n}\n"],"mappings":"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"}
|