@kubb/cli 5.0.0-alpha.9 → 5.0.0-beta.10

package/dist/constants-BYGmiFs0.cjs

@@ -0,0 +1,139 @@
+//#region ../../internals/shared/src/constants.ts
+const KUBB_CONFIG_FILENAME = "kubb.config.ts";
+const initDefaults = {
+	inputPath: "./openapi.yaml",
+	outputPath: "./src/gen",
+	plugins: ["plugin-ts"]
+};
+const availablePlugins = [
+	{
+		value: "plugin-ts",
+		label: "TypeScript",
+		hint: "Recommended",
+		packageName: "@kubb/plugin-ts",
+		importName: "pluginTs",
+		category: "types"
+	},
+	{
+		value: "plugin-client",
+		label: "Client (Fetch/Axios)",
+		packageName: "@kubb/plugin-client",
+		importName: "pluginClient",
+		category: "client"
+	},
+	{
+		value: "plugin-react-query",
+		label: "React Query / TanStack Query",
+		packageName: "@kubb/plugin-react-query",
+		importName: "pluginReactQuery",
+		category: "framework"
+	},
+	{
+		value: "plugin-vue-query",
+		label: "Vue Query",
+		packageName: "@kubb/plugin-vue-query",
+		importName: "pluginVueQuery",
+		category: "framework"
+	},
+	{
+		value: "plugin-zod",
+		label: "Zod Schemas",
+		packageName: "@kubb/plugin-zod",
+		importName: "pluginZod",
+		category: "validation"
+	},
+	{
+		value: "plugin-faker",
+		label: "Faker.js Mocks",
+		packageName: "@kubb/plugin-faker",
+		importName: "pluginFaker",
+		category: "mocks"
+	},
+	{
+		value: "plugin-msw",
+		label: "MSW Handlers",
+		packageName: "@kubb/plugin-msw",
+		importName: "pluginMsw",
+		category: "mocks"
+	},
+	{
+		value: "plugin-cypress",
+		label: "Cypress Tests",
+		packageName: "@kubb/plugin-cypress",
+		importName: "pluginCypress",
+		category: "testing"
+	},
+	{
+		value: "plugin-mcp",
+		label: "MCP Server (AI / Model Context Protocol)",
+		packageName: "@kubb/plugin-mcp",
+		importName: "pluginMcp",
+		category: "ai"
+	},
+	{
+		value: "plugin-redoc",
+		label: "ReDoc Documentation",
+		packageName: "@kubb/plugin-redoc",
+		importName: "pluginRedoc",
+		category: "documentation"
+	}
+];
+const pluginDefaultConfigs = {
+	"plugin-ts": `pluginTs({
+      output: { path: 'models' },
+    })`,
+	"plugin-client": `pluginClient({
+      output: { path: 'clients' },
+    })`,
+	"plugin-react-query": `pluginReactQuery({
+      output: { path: 'hooks' },
+    })`,
+	"plugin-vue-query": `pluginVueQuery({
+      output: { path: 'hooks' },
+    })`,
+	"plugin-zod": `pluginZod({
+      output: { path: 'zod' },
+    })`,
+	"plugin-faker": `pluginFaker({
+      output: { path: 'mocks' },
+    })`,
+	"plugin-msw": `pluginMsw({
+      output: { path: 'msw' },
+    })`,
+	"plugin-cypress": `pluginCypress({
+      output: { path: 'cypress' },
+    })`,
+	"plugin-mcp": `pluginMcp({
+      output: { path: 'mcp' },
+    })`,
+	"plugin-redoc": `pluginRedoc({
+      output: { path: 'redoc' },
+    })`
+};
+//#endregion
+Object.defineProperty(exports, "KUBB_CONFIG_FILENAME", {
+	enumerable: true,
+	get: function() {
+		return KUBB_CONFIG_FILENAME;
+	}
+});
+Object.defineProperty(exports, "availablePlugins", {
+	enumerable: true,
+	get: function() {
+		return availablePlugins;
+	}
+});
+Object.defineProperty(exports, "initDefaults", {
+	enumerable: true,
+	get: function() {
+		return initDefaults;
+	}
+});
+Object.defineProperty(exports, "pluginDefaultConfigs", {
+	enumerable: true,
+	get: function() {
+		return pluginDefaultConfigs;
+	}
+});
+
+//# sourceMappingURL=constants-BYGmiFs0.cjs.map

package/dist/constants-BYGmiFs0.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants-BYGmiFs0.cjs","names":[],"sources":["../../../internals/shared/src/constants.ts"],"sourcesContent":["import type { PluginOption } from './types.ts'\n\nexport const KUBB_CONFIG_FILENAME = 'kubb.config.ts' as const\n\nexport const initDefaults = {\n  inputPath: './openapi.yaml',\n  outputPath: './src/gen',\n  plugins: ['plugin-ts'],\n} as const\n\nexport const availablePlugins: PluginOption[] = [\n  {\n    value: 'plugin-ts',\n    label: 'TypeScript',\n    hint: 'Recommended',\n    packageName: '@kubb/plugin-ts',\n    importName: 'pluginTs',\n    category: 'types',\n  },\n  {\n    value: 'plugin-client',\n    label: 'Client (Fetch/Axios)',\n    packageName: '@kubb/plugin-client',\n    importName: 'pluginClient',\n    category: 'client',\n  },\n  {\n    value: 'plugin-react-query',\n    label: 'React Query / TanStack Query',\n    packageName: '@kubb/plugin-react-query',\n    importName: 'pluginReactQuery',\n    category: 'framework',\n  },\n  {\n    value: 'plugin-vue-query',\n    label: 'Vue Query',\n    packageName: '@kubb/plugin-vue-query',\n    importName: 'pluginVueQuery',\n    category: 'framework',\n  },\n  {\n    value: 'plugin-zod',\n    label: 'Zod Schemas',\n    packageName: '@kubb/plugin-zod',\n    importName: 'pluginZod',\n    category: 'validation',\n  },\n  {\n    value: 'plugin-faker',\n    label: 'Faker.js Mocks',\n    packageName: '@kubb/plugin-faker',\n    importName: 'pluginFaker',\n    category: 'mocks',\n  },\n  {\n    value: 'plugin-msw',\n    label: 'MSW Handlers',\n    packageName: '@kubb/plugin-msw',\n    importName: 'pluginMsw',\n    category: 'mocks',\n  },\n  {\n    value: 'plugin-cypress',\n    label: 'Cypress Tests',\n    packageName: '@kubb/plugin-cypress',\n    importName: 'pluginCypress',\n    category: 'testing',\n  },\n  {\n    value: 'plugin-mcp',\n    label: 'MCP Server (AI / Model Context Protocol)',\n    packageName: '@kubb/plugin-mcp',\n    importName: 'pluginMcp',\n    category: 'ai',\n  },\n  {\n    value: 'plugin-redoc',\n    label: 'ReDoc Documentation',\n    packageName: '@kubb/plugin-redoc',\n    importName: 'pluginRedoc',\n    category: 'documentation',\n  },\n]\n\nexport const pluginDefaultConfigs = {\n  'plugin-ts': `pluginTs({\n      output: { path: 'models' },\n    })`,\n  'plugin-client': `pluginClient({\n      output: { path: 'clients' },\n    })`,\n  'plugin-react-query': `pluginReactQuery({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-vue-query': `pluginVueQuery({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-zod': `pluginZod({\n      output: { path: 'zod' },\n    })`,\n  'plugin-faker': `pluginFaker({\n      output: { path: 'mocks' },\n    })`,\n  'plugin-msw': `pluginMsw({\n      output: { path: 'msw' },\n    })`,\n  'plugin-cypress': `pluginCypress({\n      output: { path: 'cypress' },\n    })`,\n  'plugin-mcp': `pluginMcp({\n      output: { path: 'mcp' },\n    })`,\n  'plugin-redoc': `pluginRedoc({\n      output: { path: 'redoc' },\n    })`,\n} as const satisfies Record<string, string>\n"],"mappings":";AAEA,MAAa,uBAAuB;AAEpC,MAAa,eAAe;CAC1B,WAAW;CACX,YAAY;CACZ,SAAS,CAAC,YAAY;CACvB;AAED,MAAa,mBAAmC;CAC9C;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACD;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACD;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACD;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACD;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACD;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACD;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACD;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACD;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACD;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACF;AAED,MAAa,uBAAuB;CAClC,aAAa;;;CAGb,iBAAiB;;;CAGjB,sBAAsB;;;CAGtB,oBAAoB;;;CAGpB,cAAc;;;CAGd,gBAAgB;;;CAGhB,cAAc;;;CAGd,kBAAkB;;;CAGlB,cAAc;;;CAGd,gBAAgB;;;CAGjB"}

package/dist/constants-DSJ-Xrbv.js

@@ -0,0 +1,116 @@
+//#region ../../internals/shared/src/constants.ts
+const KUBB_CONFIG_FILENAME = "kubb.config.ts";
+const initDefaults = {
+	inputPath: "./openapi.yaml",
+	outputPath: "./src/gen",
+	plugins: ["plugin-ts"]
+};
+const availablePlugins = [
+	{
+		value: "plugin-ts",
+		label: "TypeScript",
+		hint: "Recommended",
+		packageName: "@kubb/plugin-ts",
+		importName: "pluginTs",
+		category: "types"
+	},
+	{
+		value: "plugin-client",
+		label: "Client (Fetch/Axios)",
+		packageName: "@kubb/plugin-client",
+		importName: "pluginClient",
+		category: "client"
+	},
+	{
+		value: "plugin-react-query",
+		label: "React Query / TanStack Query",
+		packageName: "@kubb/plugin-react-query",
+		importName: "pluginReactQuery",
+		category: "framework"
+	},
+	{
+		value: "plugin-vue-query",
+		label: "Vue Query",
+		packageName: "@kubb/plugin-vue-query",
+		importName: "pluginVueQuery",
+		category: "framework"
+	},
+	{
+		value: "plugin-zod",
+		label: "Zod Schemas",
+		packageName: "@kubb/plugin-zod",
+		importName: "pluginZod",
+		category: "validation"
+	},
+	{
+		value: "plugin-faker",
+		label: "Faker.js Mocks",
+		packageName: "@kubb/plugin-faker",
+		importName: "pluginFaker",
+		category: "mocks"
+	},
+	{
+		value: "plugin-msw",
+		label: "MSW Handlers",
+		packageName: "@kubb/plugin-msw",
+		importName: "pluginMsw",
+		category: "mocks"
+	},
+	{
+		value: "plugin-cypress",
+		label: "Cypress Tests",
+		packageName: "@kubb/plugin-cypress",
+		importName: "pluginCypress",
+		category: "testing"
+	},
+	{
+		value: "plugin-mcp",
+		label: "MCP Server (AI / Model Context Protocol)",
+		packageName: "@kubb/plugin-mcp",
+		importName: "pluginMcp",
+		category: "ai"
+	},
+	{
+		value: "plugin-redoc",
+		label: "ReDoc Documentation",
+		packageName: "@kubb/plugin-redoc",
+		importName: "pluginRedoc",
+		category: "documentation"
+	}
+];
+const pluginDefaultConfigs = {
+	"plugin-ts": `pluginTs({
+      output: { path: 'models' },
+    })`,
+	"plugin-client": `pluginClient({
+      output: { path: 'clients' },
+    })`,
+	"plugin-react-query": `pluginReactQuery({
+      output: { path: 'hooks' },
+    })`,
+	"plugin-vue-query": `pluginVueQuery({
+      output: { path: 'hooks' },
+    })`,
+	"plugin-zod": `pluginZod({
+      output: { path: 'zod' },
+    })`,
+	"plugin-faker": `pluginFaker({
+      output: { path: 'mocks' },
+    })`,
+	"plugin-msw": `pluginMsw({
+      output: { path: 'msw' },
+    })`,
+	"plugin-cypress": `pluginCypress({
+      output: { path: 'cypress' },
+    })`,
+	"plugin-mcp": `pluginMcp({
+      output: { path: 'mcp' },
+    })`,
+	"plugin-redoc": `pluginRedoc({
+      output: { path: 'redoc' },
+    })`
+};
+//#endregion
+export { pluginDefaultConfigs as i, availablePlugins as n, initDefaults as r, KUBB_CONFIG_FILENAME as t };
+
+//# sourceMappingURL=constants-DSJ-Xrbv.js.map

package/dist/constants-DSJ-Xrbv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants-DSJ-Xrbv.js","names":[],"sources":["../../../internals/shared/src/constants.ts"],"sourcesContent":["import type { PluginOption } from './types.ts'\n\nexport const KUBB_CONFIG_FILENAME = 'kubb.config.ts' as const\n\nexport const initDefaults = {\n  inputPath: './openapi.yaml',\n  outputPath: './src/gen',\n  plugins: ['plugin-ts'],\n} as const\n\nexport const availablePlugins: PluginOption[] = [\n  {\n    value: 'plugin-ts',\n    label: 'TypeScript',\n    hint: 'Recommended',\n    packageName: '@kubb/plugin-ts',\n    importName: 'pluginTs',\n    category: 'types',\n  },\n  {\n    value: 'plugin-client',\n    label: 'Client (Fetch/Axios)',\n    packageName: '@kubb/plugin-client',\n    importName: 'pluginClient',\n    category: 'client',\n  },\n  {\n    value: 'plugin-react-query',\n    label: 'React Query / TanStack Query',\n    packageName: '@kubb/plugin-react-query',\n    importName: 'pluginReactQuery',\n    category: 'framework',\n  },\n  {\n    value: 'plugin-vue-query',\n    label: 'Vue Query',\n    packageName: '@kubb/plugin-vue-query',\n    importName: 'pluginVueQuery',\n    category: 'framework',\n  },\n  {\n    value: 'plugin-zod',\n    label: 'Zod Schemas',\n    packageName: '@kubb/plugin-zod',\n    importName: 'pluginZod',\n    category: 'validation',\n  },\n  {\n    value: 'plugin-faker',\n    label: 'Faker.js Mocks',\n    packageName: '@kubb/plugin-faker',\n    importName: 'pluginFaker',\n    category: 'mocks',\n  },\n  {\n    value: 'plugin-msw',\n    label: 'MSW Handlers',\n    packageName: '@kubb/plugin-msw',\n    importName: 'pluginMsw',\n    category: 'mocks',\n  },\n  {\n    value: 'plugin-cypress',\n    label: 'Cypress Tests',\n    packageName: '@kubb/plugin-cypress',\n    importName: 'pluginCypress',\n    category: 'testing',\n  },\n  {\n    value: 'plugin-mcp',\n    label: 'MCP Server (AI / Model Context Protocol)',\n    packageName: '@kubb/plugin-mcp',\n    importName: 'pluginMcp',\n    category: 'ai',\n  },\n  {\n    value: 'plugin-redoc',\n    label: 'ReDoc Documentation',\n    packageName: '@kubb/plugin-redoc',\n    importName: 'pluginRedoc',\n    category: 'documentation',\n  },\n]\n\nexport const pluginDefaultConfigs = {\n  'plugin-ts': `pluginTs({\n      output: { path: 'models' },\n    })`,\n  'plugin-client': `pluginClient({\n      output: { path: 'clients' },\n    })`,\n  'plugin-react-query': `pluginReactQuery({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-vue-query': `pluginVueQuery({\n      output: { path: 'hooks' },\n    })`,\n  'plugin-zod': `pluginZod({\n      output: { path: 'zod' },\n    })`,\n  'plugin-faker': `pluginFaker({\n      output: { path: 'mocks' },\n    })`,\n  'plugin-msw': `pluginMsw({\n      output: { path: 'msw' },\n    })`,\n  'plugin-cypress': `pluginCypress({\n      output: { path: 'cypress' },\n    })`,\n  'plugin-mcp': `pluginMcp({\n      output: { path: 'mcp' },\n    })`,\n  'plugin-redoc': `pluginRedoc({\n      output: { path: 'redoc' },\n    })`,\n} as const satisfies Record<string, string>\n"],"mappings":";AAEA,MAAa,uBAAuB;AAEpC,MAAa,eAAe;CAC1B,WAAW;CACX,YAAY;CACZ,SAAS,CAAC,YAAY;CACvB;AAED,MAAa,mBAAmC;CAC9C;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACD;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACD;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACD;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACD;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACD;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACD;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACD;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACD;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACD;EACE,OAAO;EACP,OAAO;EACP,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACF;AAED,MAAa,uBAAuB;CAClC,aAAa;;;CAGb,iBAAiB;;;CAGjB,sBAAsB;;;CAGtB,oBAAoB;;;CAGpB,cAAc;;;CAGd,gBAAgB;;;CAGhB,cAAc;;;CAGd,kBAAkB;;;CAGlB,cAAc;;;CAGd,gBAAgB;;;CAGjB"}

package/dist/define-Bdn8j5VM.cjs

@@ -0,0 +1,54 @@
+require("./chunk-ByKO4r7w.cjs");
+//#region ../../internals/utils/src/cli/define.ts
+/**
+* Returns a `CLIAdapter` as-is with full type inference. Pass a custom adapter to `createCLI` to swap the CLI engine.
+*
+* @example
+* ```ts
+* const adapter = defineCLIAdapter({ run: myRun, renderHelp: myHelp })
+* createCLI({ adapter }).run(commands, argv, opts)
+* ```
+*/
+function defineCLIAdapter(adapter) {
+	return adapter;
+}
+/**
+* Returns a `CommandDefinition` with typed `values` in `run()`.
+* The callback receives `values` inferred from the declared options — no casts needed.
+*
+* @example
+* ```ts
+* const generate = defineCommand({
+*   name: 'generate',
+*   description: 'Generate client code',
+*   options: { config: { type: 'string', description: 'Config path' } },
+*   async run({ values }) { console.log(values.config) },
+* })
+* ```
+*/
+function defineCommand(def) {
+	const { run, ...rest } = def;
+	if (!run) return rest;
+	return {
+		...rest,
+		run: (args) => run({
+			values: args.values,
+			positionals: args.positionals
+		})
+	};
+}
+//#endregion
+Object.defineProperty(exports, "defineCLIAdapter", {
+	enumerable: true,
+	get: function() {
+		return defineCLIAdapter;
+	}
+});
+Object.defineProperty(exports, "defineCommand", {
+	enumerable: true,
+	get: function() {
+		return defineCommand;
+	}
+});
+
+//# sourceMappingURL=define-Bdn8j5VM.cjs.map

package/dist/define-Bdn8j5VM.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-Bdn8j5VM.cjs","names":[],"sources":["../../../internals/utils/src/cli/define.ts"],"sourcesContent":["import type { CLIAdapter, CommandDefinition, OptionDefinition } from './types.ts'\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 `CLIAdapter` as-is with full type inference. Pass a custom adapter to `createCLI` to swap the CLI engine.\n *\n * @example\n * ```ts\n * const adapter = defineCLIAdapter({ run: myRun, renderHelp: myHelp })\n * createCLI({ adapter }).run(commands, argv, opts)\n * ```\n */\nexport function defineCLIAdapter(adapter: CLIAdapter): CLIAdapter {\n  return adapter\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?: string[]\n  examples?: string[]\n  options?: O\n  subCommands?: CommandDefinition[]\n  run?: (args: { values: InferValues<O>; positionals: 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":";;;;;;;;;;;AAwBA,SAAgB,iBAAiB,SAAiC;CAChE,OAAO;;;;;;;;;;;;;;;;AAiBT,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;GACnB,CAAC;EACL"}

package/dist/define-m_fp-Aqm.js

@@ -0,0 +1,43 @@
+import "./chunk-BvFE5Tac.js";
+//#region ../../internals/utils/src/cli/define.ts
+/**
+* Returns a `CLIAdapter` as-is with full type inference. Pass a custom adapter to `createCLI` to swap the CLI engine.
+*
+* @example
+* ```ts
+* const adapter = defineCLIAdapter({ run: myRun, renderHelp: myHelp })
+* createCLI({ adapter }).run(commands, argv, opts)
+* ```
+*/
+function defineCLIAdapter(adapter) {
+	return adapter;
+}
+/**
+* Returns a `CommandDefinition` with typed `values` in `run()`.
+* The callback receives `values` inferred from the declared options — no casts needed.
+*
+* @example
+* ```ts
+* const generate = defineCommand({
+*   name: 'generate',
+*   description: 'Generate client code',
+*   options: { config: { type: 'string', description: 'Config path' } },
+*   async run({ values }) { console.log(values.config) },
+* })
+* ```
+*/
+function defineCommand(def) {
+	const { run, ...rest } = def;
+	if (!run) return rest;
+	return {
+		...rest,
+		run: (args) => run({
+			values: args.values,
+			positionals: args.positionals
+		})
+	};
+}
+//#endregion
+export { defineCommand as n, defineCLIAdapter as t };
+
+//# sourceMappingURL=define-m_fp-Aqm.js.map

package/dist/define-m_fp-Aqm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-m_fp-Aqm.js","names":[],"sources":["../../../internals/utils/src/cli/define.ts"],"sourcesContent":["import type { CLIAdapter, CommandDefinition, OptionDefinition } from './types.ts'\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 `CLIAdapter` as-is with full type inference. Pass a custom adapter to `createCLI` to swap the CLI engine.\n *\n * @example\n * ```ts\n * const adapter = defineCLIAdapter({ run: myRun, renderHelp: myHelp })\n * createCLI({ adapter }).run(commands, argv, opts)\n * ```\n */\nexport function defineCLIAdapter(adapter: CLIAdapter): CLIAdapter {\n  return adapter\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?: string[]\n  examples?: string[]\n  options?: O\n  subCommands?: CommandDefinition[]\n  run?: (args: { values: InferValues<O>; positionals: 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":";;;;;;;;;;;AAwBA,SAAgB,iBAAiB,SAAiC;CAChE,OAAO;;;;;;;;;;;;;;;;AAiBT,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;GACnB,CAAC;EACL"}

package/dist/errors-CINO1EIv.js

@@ -0,0 +1,43 @@
+import "./chunk-BvFE5Tac.js";
+//#region ../../internals/utils/src/errors.ts
+/**
+* Coerces an unknown thrown value to an `Error` instance.
+* Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.
+*
+* @example
+* ```ts
+* try { ... } catch(err) {
+*   throw new BuildError('Build failed', { cause: toError(err), errors: [] })
+* }
+* ```
+*/
+function toError(value) {
+	return value instanceof Error ? value : new Error(String(value));
+}
+/**
+* Extracts a human-readable message from any thrown value.
+*
+* @example
+* ```ts
+* getErrorMessage(new Error('oops')) // 'oops'
+* getErrorMessage('plain string')    // 'plain string'
+* ```
+*/
+function getErrorMessage(value) {
+	return value instanceof Error ? value.message : String(value);
+}
+/**
+* Extracts the `.cause` of an `Error` as an `Error`, or `undefined` when absent or not an `Error`.
+*
+* @example
+* ```ts
+* const cause = toCause(buildError) // Error | undefined
+* ```
+*/
+function toCause(error) {
+	return error.cause instanceof Error ? error.cause : void 0;
+}
+//#endregion
+export { toCause as n, toError as r, getErrorMessage as t };
+
+//# sourceMappingURL=errors-CINO1EIv.js.map

package/dist/errors-CINO1EIv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-CINO1EIv.js","names":[],"sources":["../../../internals/utils/src/errors.ts"],"sourcesContent":["/**\n * Thrown when one or more errors occur during a Kubb build.\n * Carries the full list of underlying errors on `errors`.\n *\n * @example\n * ```ts\n * throw new BuildError('Build failed', { errors: [err1, err2] })\n * ```\n */\nexport class BuildError extends Error {\n  errors: Array<Error>\n\n  constructor(message: string, options: { cause?: Error; errors: Array<Error> }) {\n    super(message, { cause: options.cause })\n    this.name = 'BuildError'\n    this.errors = options.errors\n  }\n}\n\n/**\n * Coerces an unknown thrown value to an `Error` instance.\n * Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.\n *\n * @example\n * ```ts\n * try { ... } catch(err) {\n *   throw new BuildError('Build failed', { cause: toError(err), errors: [] })\n * }\n * ```\n */\nexport function toError(value: unknown): Error {\n  return value instanceof Error ? value : new Error(String(value))\n}\n\n/**\n * Extracts a human-readable message from any thrown value.\n *\n * @example\n * ```ts\n * getErrorMessage(new Error('oops')) // 'oops'\n * getErrorMessage('plain string')    // 'plain string'\n * ```\n */\nexport function getErrorMessage(value: unknown): string {\n  return value instanceof Error ? value.message : String(value)\n}\n\n/**\n * Extracts the `.cause` of an `Error` as an `Error`, or `undefined` when absent or not an `Error`.\n *\n * @example\n * ```ts\n * const cause = toCause(buildError) // Error | undefined\n * ```\n */\nexport function toCause(error: Error): Error | undefined {\n  return error.cause instanceof Error ? error.cause : undefined\n}\n"],"mappings":";;;;;;;;;;;;;AA8BA,SAAgB,QAAQ,OAAuB;CAC7C,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;;;;;;;;;;;AAYlE,SAAgB,gBAAgB,OAAwB;CACtD,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;;;;;;;;;;AAW/D,SAAgB,QAAQ,OAAiC;CACvD,OAAO,MAAM,iBAAiB,QAAQ,MAAM,QAAQ,KAAA"}

package/dist/{errors-DBW0N9w4.cjs → errors-CLCjoSg0.cjs}

@@ -2,21 +2,37 @@ require("./chunk-ByKO4r7w.cjs");
 //#region ../../internals/utils/src/errors.ts
 /**
 * Coerces an unknown thrown value to an `Error` instance.
-* When the value is already an `Error` it is returned as-is;
-* otherwise a new `Error` is created whose message is `String(value)`.
+* Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.
+*
+* @example
+* ```ts
+* try { ... } catch(err) {
+*   throw new BuildError('Build failed', { cause: toError(err), errors: [] })
+* }
+* ```
 */
 function toError(value) {
 	return value instanceof Error ? value : new Error(String(value));
 }
 /**
-* Safely extracts a human-readable message from any thrown value.
+* Extracts a human-readable message from any thrown value.
+*
+* @example
+* ```ts
+* getErrorMessage(new Error('oops')) // 'oops'
+* getErrorMessage('plain string')    // 'plain string'
+* ```
 */
 function getErrorMessage(value) {
 	return value instanceof Error ? value.message : String(value);
 }
 /**
-* Extracts the `.cause` of an `Error` as an `Error | undefined`.
-* Returns `undefined` when the cause is absent or is not an `Error`.
+* Extracts the `.cause` of an `Error` as an `Error`, or `undefined` when absent or not an `Error`.
+*
+* @example
+* ```ts
+* const cause = toCause(buildError) // Error | undefined
+* ```
 */
 function toCause(error) {
 	return error.cause instanceof Error ? error.cause : void 0;
@@ -41,4 +57,4 @@ Object.defineProperty(exports, "toError", {
 	}
 });
 
-//# sourceMappingURL=errors-DBW0N9w4.cjs.map
+//# sourceMappingURL=errors-CLCjoSg0.cjs.map

package/dist/errors-CLCjoSg0.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-CLCjoSg0.cjs","names":[],"sources":["../../../internals/utils/src/errors.ts"],"sourcesContent":["/**\n * Thrown when one or more errors occur during a Kubb build.\n * Carries the full list of underlying errors on `errors`.\n *\n * @example\n * ```ts\n * throw new BuildError('Build failed', { errors: [err1, err2] })\n * ```\n */\nexport class BuildError extends Error {\n  errors: Array<Error>\n\n  constructor(message: string, options: { cause?: Error; errors: Array<Error> }) {\n    super(message, { cause: options.cause })\n    this.name = 'BuildError'\n    this.errors = options.errors\n  }\n}\n\n/**\n * Coerces an unknown thrown value to an `Error` instance.\n * Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.\n *\n * @example\n * ```ts\n * try { ... } catch(err) {\n *   throw new BuildError('Build failed', { cause: toError(err), errors: [] })\n * }\n * ```\n */\nexport function toError(value: unknown): Error {\n  return value instanceof Error ? value : new Error(String(value))\n}\n\n/**\n * Extracts a human-readable message from any thrown value.\n *\n * @example\n * ```ts\n * getErrorMessage(new Error('oops')) // 'oops'\n * getErrorMessage('plain string')    // 'plain string'\n * ```\n */\nexport function getErrorMessage(value: unknown): string {\n  return value instanceof Error ? value.message : String(value)\n}\n\n/**\n * Extracts the `.cause` of an `Error` as an `Error`, or `undefined` when absent or not an `Error`.\n *\n * @example\n * ```ts\n * const cause = toCause(buildError) // Error | undefined\n * ```\n */\nexport function toCause(error: Error): Error | undefined {\n  return error.cause instanceof Error ? error.cause : undefined\n}\n"],"mappings":";;;;;;;;;;;;;AA8BA,SAAgB,QAAQ,OAAuB;CAC7C,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;;;;;;;;;;;AAYlE,SAAgB,gBAAgB,OAAwB;CACtD,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;;;;;;;;;;AAW/D,SAAgB,QAAQ,OAAiC;CACvD,OAAO,MAAM,iBAAiB,QAAQ,MAAM,QAAQ,KAAA"}

package/dist/{generate-Rly1EXBN.js → generate-BLvcvoIj.js}

@@ -1,10 +1,16 @@
-import "./chunk--u3MIqq1.js";
-import { n as defineCommand } from "./define--M_JMcDC.js";
+import "./chunk-BvFE5Tac.js";
+import { n as defineCommand } from "./define-m_fp-Aqm.js";
 //#region src/commands/generate.ts
 const command = defineCommand({
 	name: "generate",
-	description: "[input] Generate files based on a 'kubb.config.ts' file",
+	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.",
 	arguments: ["[input]"],
+	examples: [
+		"kubb generate",
+		"kubb generate ./openapi.yaml",
+		"kubb generate --config kubb.config.ts",
+		"kubb generate --watch"
+	],
 	options: {
 		config: {
 			type: "string",
@@ -51,8 +57,8 @@ const command = defineCommand({
 	},
 	async run({ values, positionals }) {
 		const logLevel = values.debug ? "debug" : values.verbose ? "verbose" : values.silent ? "silent" : values.logLevel;
-		const { runGenerateCommand } = await import("./generate-BHNyeQXl.js");
-		await runGenerateCommand({
+		const { run } = await import("./run-Bfbr3RaM.js");
+		await run({
 			input: positionals[0],
 			configPath: values.config,
 			logLevel,
@@ -63,4 +69,4 @@ const command = defineCommand({
 //#endregion
 export { command };
 
-//# sourceMappingURL=generate-Rly1EXBN.js.map
+//# sourceMappingURL=generate-BLvcvoIj.js.map

package/dist/generate-BLvcvoIj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-BLvcvoIj.js","names":[],"sources":["../src/commands/generate.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\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, verbose or debug',\n      short: 'l',\n      default: 'info',\n      hint: 'silent|info|verbose|debug',\n      enum: ['silent', 'info', 'verbose', 'debug'],\n    },\n    watch: {\n      type: 'boolean',\n      description: 'Watch mode based on the input file',\n      short: 'w',\n      default: false,\n    },\n    debug: {\n      type: 'boolean',\n      description: 'Override logLevel to debug',\n      short: 'd',\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  },\n  async run({ values, positionals }) {\n    const logLevel = values.debug ? 'debug' : values.verbose ? 'verbose' : values.silent ? 'silent' : values.logLevel\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    })\n  },\n})\n"],"mappings":";;;AAEA,MAAa,UAAU,cAAc;CACnC,MAAM;CACN,aACE;CACF,WAAW,CAAC,UAAU;CACtB,UAAU;EAAC;EAAiB;EAAgC;EAAyC;EAAwB;CAC7H,SAAS;EACP,QAAQ;GACN,MAAM;GACN,aAAa;GACb,OAAO;GACR;EACD,UAAU;GACR,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACT,MAAM;GACN,MAAM;IAAC;IAAU;IAAQ;IAAW;IAAQ;GAC7C;EACD,OAAO;GACL,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACV;EACD,OAAO;GACL,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACV;EACD,SAAS;GACP,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACV;EACD,QAAQ;GACN,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACV;EACF;CACD,MAAM,IAAI,EAAE,QAAQ,eAAe;EACjC,MAAM,WAAW,OAAO,QAAQ,UAAU,OAAO,UAAU,YAAY,OAAO,SAAS,WAAW,OAAO;EACzG,MAAM,EAAE,QAAQ,MAAM,OAAO;EAE7B,MAAM,IAAI;GACR,OAAO,YAAY;GACnB,YAAY,OAAO;GACnB;GACA,OAAO,OAAO;GACf,CAAC;;CAEL,CAAC"}

package/dist/{generate-DU5zzc54.cjs → generate-drLxTAnz.cjs}

@@ -1,9 +1,15 @@
 require("./chunk-ByKO4r7w.cjs");
 //#region src/commands/generate.ts
-const command = require("./define-D6Kfm7-Z.cjs").defineCommand({
+const command = require("./define-Bdn8j5VM.cjs").defineCommand({
 	name: "generate",
-	description: "[input] Generate files based on a 'kubb.config.ts' file",
+	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.",
 	arguments: ["[input]"],
+	examples: [
+		"kubb generate",
+		"kubb generate ./openapi.yaml",
+		"kubb generate --config kubb.config.ts",
+		"kubb generate --watch"
+	],
 	options: {
 		config: {
 			type: "string",
@@ -50,8 +56,8 @@ const command = require("./define-D6Kfm7-Z.cjs").defineCommand({
 	},
 	async run({ values, positionals }) {
 		const logLevel = values.debug ? "debug" : values.verbose ? "verbose" : values.silent ? "silent" : values.logLevel;
-		const { runGenerateCommand } = await Promise.resolve().then(() => require("./generate-Cq5RDTBL.cjs"));
-		await runGenerateCommand({
+		const { run } = await Promise.resolve().then(() => require("./run-CVlrIZoW.cjs"));
+		await run({
 			input: positionals[0],
 			configPath: values.config,
 			logLevel,
@@ -62,4 +68,4 @@ const command = require("./define-D6Kfm7-Z.cjs").defineCommand({
 //#endregion
 exports.command = command;
 
-//# sourceMappingURL=generate-DU5zzc54.cjs.map
+//# sourceMappingURL=generate-drLxTAnz.cjs.map

package/dist/generate-drLxTAnz.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-drLxTAnz.cjs","names":["defineCommand"],"sources":["../src/commands/generate.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\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, verbose or debug',\n      short: 'l',\n      default: 'info',\n      hint: 'silent|info|verbose|debug',\n      enum: ['silent', 'info', 'verbose', 'debug'],\n    },\n    watch: {\n      type: 'boolean',\n      description: 'Watch mode based on the input file',\n      short: 'w',\n      default: false,\n    },\n    debug: {\n      type: 'boolean',\n      description: 'Override logLevel to debug',\n      short: 'd',\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  },\n  async run({ values, positionals }) {\n    const logLevel = values.debug ? 'debug' : values.verbose ? 'verbose' : values.silent ? 'silent' : values.logLevel\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    })\n  },\n})\n"],"mappings":";;AAEA,MAAa,0CAAUA,CAAAA,cAAc;CACnC,MAAM;CACN,aACE;CACF,WAAW,CAAC,UAAU;CACtB,UAAU;EAAC;EAAiB;EAAgC;EAAyC;EAAwB;CAC7H,SAAS;EACP,QAAQ;GACN,MAAM;GACN,aAAa;GACb,OAAO;GACR;EACD,UAAU;GACR,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACT,MAAM;GACN,MAAM;IAAC;IAAU;IAAQ;IAAW;IAAQ;GAC7C;EACD,OAAO;GACL,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACV;EACD,OAAO;GACL,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACV;EACD,SAAS;GACP,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACV;EACD,QAAQ;GACN,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACV;EACF;CACD,MAAM,IAAI,EAAE,QAAQ,eAAe;EACjC,MAAM,WAAW,OAAO,QAAQ,UAAU,OAAO,UAAU,YAAY,OAAO,SAAS,WAAW,OAAO;EACzG,MAAM,EAAE,QAAQ,MAAA,QAAA,SAAA,CAAA,WAAA,QAAM,qBAAA,CAAA;EAEtB,MAAM,IAAI;GACR,OAAO,YAAY;GACnB,YAAY,OAAO;GACnB;GACA,OAAO,OAAO;GACf,CAAC;;CAEL,CAAC"}