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

package/dist/index.cjs

@@ -1,14 +1,20 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("./chunk-ByKO4r7w.cjs");
-const require_define = require("./define-D6Kfm7-Z.cjs");
-const require_telemetry = require("./telemetry-DZ7IrLAU.cjs");
-const require_package = require("./package-BJ6ionm6.cjs");
-const require_constants = require("./constants-D0XHAHeZ.cjs");
+const require_define = require("./define-Bdn8j5VM.cjs");
+const require_telemetry = require("./telemetry-B2iWkY5e.cjs");
+const require_package = require("./package-DZ-6zAIO.cjs");
+const require_constants = require("./constants-BINTA5VZ.cjs");
 let node_util = require("node:util");
 //#region ../../internals/utils/src/cli/schema.ts
 /**
 * Serializes `CommandDefinition[]` to a plain, JSON-serializable structure.
 * Use to expose CLI capabilities to AI agents or MCP tools.
+*
+* @example
+* ```ts
+* getCommandSchema([generateCommand, agentCommand])
+* // [{ name: 'generate', options: [...], subCommands: [] }, ...]
+* ```
 */
 function getCommandSchema(defs) {
 	return defs.map(serializeCommand);
@@ -18,6 +24,7 @@ function serializeCommand(def) {
 		name: def.name,
 		description: def.description,
 		arguments: def.arguments,
+		...def.examples?.length ? { examples: def.examples } : {},
 		options: serializeOptions(def.options ?? {}),
 		subCommands: def.subCommands ? def.subCommands.map(serializeCommand) : []
 	};
@@ -38,7 +45,14 @@ function serializeOptions(options) {
 }
 //#endregion
 //#region ../../internals/utils/src/cli/help.ts
-/** Prints formatted help output for a command using its `CommandDefinition`. */
+/** Prints formatted help output for `def` using its `CommandDefinition`.
+*
+* @example
+* ```ts
+* renderHelp({ name: 'generate', description: 'Generate client code' })
+* // prints Usage: generate [options] ...
+* ```
+*/
 function renderHelp(def, parentName) {
 	const schema = getCommandSchema([def])[0];
 	const programName = parentName ? `${parentName} ${schema.name}` : schema.name;
@@ -64,6 +78,11 @@ function renderHelp(def, parentName) {
 		console.log(`  ${flags}${opt.description}${defaultPart}`);
 	}
 	console.log();
+	if (schema.examples?.length) {
+		console.log((0, node_util.styleText)("bold", "Examples:"));
+		for (const ex of schema.examples) console.log(`  ${(0, node_util.styleText)("dim", ex)}`);
+		console.log();
+	}
 }
 //#endregion
 //#region ../../internals/utils/src/cli/adapters/nodeAdapter.ts
@@ -120,7 +139,9 @@ async function runCommand(def, argv, parentName) {
 }
 function printRootHelp(programName, version, defs) {
 	console.log(`\n${(0, node_util.styleText)("bold", "Usage:")} ${programName} <command> [options]\n`);
-	console.log(`  Kubb generation — v${version}\n`);
+	console.log(`  Kubb v${version} — Generate TypeScript types, API clients, React Query hooks,`);
+	console.log(`  Zod schemas, and more from an OpenAPI specification.\n`);
+	console.log(`  Quick start: ${(0, node_util.styleText)("cyan", `${programName} init`)} to scaffold a config, then ${(0, node_util.styleText)("cyan", `${programName} generate`)} to run.\n`);
 	console.log((0, node_util.styleText)("bold", "Commands:"));
 	for (const def of defs) console.log(`  ${(0, node_util.styleText)("cyan", def.name.padEnd(16))}${def.description}`);
 	console.log();
@@ -130,14 +151,17 @@ function printRootHelp(programName, version, defs) {
 	console.log();
 	console.log(`Run ${(0, node_util.styleText)("cyan", `${programName} <command> --help`)} for command-specific help.\n`);
 }
-/** CLI adapter using `node:util parseArgs`. No external dependencies. */
+/**
+* CLI adapter using `node:util parseArgs`. No external dependencies.
+*/
 const nodeAdapter = require_define.defineCLIAdapter({
 	renderHelp(def, parentName) {
 		renderHelp(def, parentName);
 	},
 	async run(defs, argv, opts) {
 		const { programName, defaultCommandName, version } = opts;
-		const args = argv.length >= 2 && argv[0]?.includes("node") ? argv.slice(2) : argv;
+		const firstArgIsExecutablePath = (argv[0]?.includes("/") || argv[0]?.includes("\\")) ?? false;
+		const args = argv.length >= 2 && firstArgIsExecutablePath ? argv.slice(2) : argv;
 		if (args[0] === "--version" || args[0] === "-v") {
 			console.log(version);
 			process.exit(0);
@@ -191,8 +215,18 @@ const nodeAdapter = require_define.defineCLIAdapter({
 //#endregion
 //#region ../../internals/utils/src/cli/parse.ts
 /**
-* Create a CLI runner bound to a specific adapter.
-* Defaults to the built-in `nodeAdapter` (Node.js `node:util parseArgs`).
+* Creates a CLI runner bound to a specific adapter.
+*
+* @default nodeAdapter (Node.js `node:util parseArgs`)
+*
+* @example
+* ```ts
+* await createCLI().run(commands, process.argv.slice(2), {
+*   programName: 'kubb',
+*   defaultCommandName: 'generate',
+*   version: '5.0.0',
+* })
+* ```
 */
 function createCLI(options) {
 	const adapter = options?.adapter ?? nodeAdapter;
@@ -201,10 +235,9 @@ function createCLI(options) {
 	} };
 }
 //#endregion
-//#region src/utils/flags.ts
+//#region ../../internals/utils/src/isFlag.ts
 /**
-* Type guard that checks whether a raw string is a member of a typed flag set.
-* Avoids the need for type assertions when working with `Set<T extends string>`.
+* Type guard that confirms `value` is a member of `set`. Avoids type assertions with `Set<T extends string>`.
 */
 function isFlag(set, value) {
 	for (const flag of set) if (flag === value) return true;
@@ -215,19 +248,17 @@ function isFlag(set, value) {
 const cli = createCLI();
 function shouldShowTelemetryNotice(argv) {
 	if (require_telemetry.isTelemetryDisabled()) return false;
-	if (argv.some((arg) => isFlag(require_constants.QUITE_FLAGS, arg))) return false;
+	if (argv.some((arg) => isFlag(require_constants.QUIET_FLAGS, arg))) return false;
 	if (!process.stdout.isTTY) return false;
 	return true;
 }
 async function run(argv = process.argv) {
 	if (shouldShowTelemetryNotice(argv)) 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`);
-	const [{ command: generateCommand }, { command: validateCommand }, { command: mcpCommand }, { command: agentCommand }, { command: initCommand }] = await Promise.all([
-		Promise.resolve().then(() => require("./generate-DU5zzc54.cjs")),
-		Promise.resolve().then(() => require("./validate-DucFMytl.cjs")),
-		Promise.resolve().then(() => require("./mcp-T7Q4nWbT.cjs")),
-		Promise.resolve().then(() => require("./agent-BKphjOIF.cjs")),
-		Promise.resolve().then(() => require("./init-CN1JFyGX.cjs"))
-	]);
+	const { command: generateCommand } = await Promise.resolve().then(() => require("./generate-drLxTAnz.cjs"));
+	const { command: validateCommand } = await Promise.resolve().then(() => require("./validate-J6AEd5zK.cjs"));
+	const { command: mcpCommand } = await Promise.resolve().then(() => require("./mcp-DSF5gpI-.cjs"));
+	const { command: agentCommand } = await Promise.resolve().then(() => require("./agent-CeLwj5im.cjs"));
+	const { command: initCommand } = await Promise.resolve().then(() => require("./init-CyCjvIEF.cjs"));
 	await cli.run([
 		generateCommand,
 		validateCommand,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["defineCLIAdapter","isTelemetryDisabled","QUITE_FLAGS"],"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/utils/flags.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 */\nexport function getCommandSchema(defs: CommandDefinition[]): 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    options: serializeOptions(def.options ?? {}),\n    subCommands: def.subCommands ? def.subCommands.map(serializeCommand) : [],\n  }\n}\n\nfunction serializeOptions(options: Record<string, OptionDefinition>): 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 a command using its `CommandDefinition`. */\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: OptionSchema[] = [...schema.options, { name: 'help', flags: '-h, --help', type: 'boolean' as const, description: 'Show help' }]\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","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 = { type: OptionType; short?: string; default?: string | boolean }\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: 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 = { values: result.values as ParsedArgs['values'], positionals: result.positionals }\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: CommandDefinition[]): void {\n  console.log(`\\n${styleText('bold', 'Usage:')} ${programName} <command> [options]\\n`)\n  console.log(`  Kubb generation — v${version}\\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/** CLI adapter using `node:util parseArgs`. No external dependencies. */\nexport const nodeAdapter = defineCLIAdapter({\n  renderHelp(def: CommandDefinition, parentName?: string): void {\n    renderHelp(def, parentName)\n  },\n\n  async run(defs: CommandDefinition[], argv: string[], opts: RunOptions): Promise<void> {\n    const { programName, defaultCommandName, version } = opts\n\n    const args = argv.length >= 2 && argv[0]?.includes('node') ? 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: 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 * Create a CLI runner bound to a specific adapter.\n * Defaults to the built-in `nodeAdapter` (Node.js `node:util parseArgs`).\n */\nexport function createCLI(options?: { adapter?: CLIAdapter }): {\n  run(commands: CommandDefinition[], argv: 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","/**\n * Type guard that checks whether a raw string is a member of a typed flag set.\n * Avoids the need for type assertions when working with `Set<T extends string>`.\n */\nexport function isFlag<T extends string>(set: ReadonlySet<T>, value: string): value is T {\n  for (const flag of set) {\n    if (flag === value) return true\n  }\n  return false\n}\n","import { styleText } from 'node:util'\nimport { createCLI } from '@internals/utils'\nimport { version } from '../package.json'\nimport { QUITE_FLAGS } from './constants.ts'\nimport { isFlag } from './utils/flags.ts'\nimport { isTelemetryDisabled } from './utils/telemetry.ts'\n\nconst cli = createCLI()\n\nfunction shouldShowTelemetryNotice(argv: Array<string>): boolean {\n  if (isTelemetryDisabled()) {\n    return false\n  }\n  // Skip when the user is just asking for help or version info\n  if (argv.some((arg) => isFlag(QUITE_FLAGS, arg))) {\n    return false\n  }\n  // Skip in non-interactive / scripting contexts\n  if (!process.stdout.isTTY) {\n    return false\n  }\n  return true\n}\n\nexport async function run(argv: Array<string> = process.argv): Promise<void> {\n  if (shouldShowTelemetryNotice(argv)) {\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 }, { command: validateCommand }, { command: mcpCommand }, { command: agentCommand }, { command: initCommand }] =\n    await Promise.all([\n      import('./commands/generate.ts'),\n      import('./commands/validate.ts'),\n      import('./commands/mcp.ts'),\n      import('./commands/agent.ts'),\n      import('./commands/init.ts'),\n    ])\n\n  await cli.run([generateCommand, validateCommand, mcpCommand, agentCommand, initCommand], argv, {\n    programName: 'kubb',\n    defaultCommandName: 'generate',\n    version,\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["defineCLIAdapter","isTelemetryDisabled","QUIET_FLAGS"],"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","../../../internals/utils/src/isFlag.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: CommandDefinition[]): 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>): 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: 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: 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: 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: CommandDefinition[], argv: 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: 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: CommandDefinition[], argv: 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","/**\n * Type guard that confirms `value` is a member of `set`. Avoids type assertions with `Set<T extends string>`.\n */\nexport function isFlag<T extends string>(set: ReadonlySet<T>, value: string): value is T {\n  for (const flag of set) {\n    if (flag === value) return true\n  }\n  return false\n}\n","import { styleText } from 'node:util'\nimport { createCLI, isFlag } from '@internals/utils'\nimport { version } from '../package.json'\nimport { QUIET_FLAGS } from './constants.ts'\nimport { isTelemetryDisabled } from './telemetry.ts'\n\nconst cli = createCLI()\n\nfunction shouldShowTelemetryNotice(argv: Array<string>): boolean {\n  if (isTelemetryDisabled()) {\n    return false\n  }\n\n  // Skip when the user is just asking for help or version info\n  if (argv.some((arg) => isFlag(QUIET_FLAGS, arg))) {\n    return false\n  }\n\n  // Skip in non-interactive / scripting contexts\n  if (!process.stdout.isTTY) {\n    return false\n  }\n\n  return true\n}\n\nexport async function run(argv: Array<string> = process.argv): Promise<void> {\n  if (shouldShowTelemetryNotice(argv)) {\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: agentCommand } = await import('./commands/agent.ts')\n  const { command: initCommand } = await import('./commands/init.ts')\n\n  await cli.run([generateCommand, validateCommand, mcpCommand, agentCommand, initCommand], argv, {\n    programName: 'kubb',\n    defaultCommandName: 'generate',\n    version,\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAYA,SAAgB,iBAAiB,MAA4C;CAC3E,OAAO,KAAK,IAAI,iBAAiB;;AAGnC,SAAS,iBAAiB,KAAuC;CAC/D,OAAO;EACL,MAAM,IAAI;EACV,aAAa,IAAI;EACjB,WAAW,IAAI;EACf,GAAI,IAAI,UAAU,SAAS,EAAE,UAAU,IAAI,UAAU,GAAG,EAAE;EAC1D,SAAS,iBAAiB,IAAI,WAAW,EAAE,CAAC;EAC5C,aAAa,IAAI,cAAc,IAAI,YAAY,IAAI,iBAAiB,GAAG,EAAE;EAC1E;;AAGH,SAAS,iBAAiB,SAA2D;CACnF,OAAO,OAAO,QAAQ,QAAQ,CAAC,KAAK,CAAC,MAAM,SAAS;EAKlD,OAAO;GACL;GACA,OAAA,GANgB,IAAI,QAAQ,IAAI,IAAI,MAAM,MAAM,GAEvB,IAAI,OADb,IAAI,SAAS,WAAW,KAAK,IAAI,QAAQ,KAAK,KAAK;GAMnE,MAAM,IAAI;GACV,aAAa,IAAI;GACjB,GAAI,IAAI,YAAY,KAAA,IAAY,EAAE,SAAS,IAAI,SAAS,GAAG,EAAE;GAC7D,GAAI,IAAI,OAAO,EAAE,MAAM,IAAI,MAAM,GAAG,EAAE;GACtC,GAAI,IAAI,OAAO,EAAE,MAAM,IAAI,MAAM,GAAG,EAAE;GACtC,GAAI,IAAI,WAAW,EAAE,UAAU,IAAI,UAAU,GAAG,EAAE;GACnD;GACD;;;;;;;;;;;;AC/BJ,SAAgB,WAAW,KAAwB,YAA2B;CAC5E,MAAM,SAAS,iBAAiB,CAAC,IAAI,CAAC,CAAC;CAEvC,MAAM,cAAc,aAAa,GAAG,WAAW,GAAG,OAAO,SAAS,OAAO;CAEzE,MAAM,WAAW,OAAO,WAAW,SAAS,IAAI,OAAO,UAAU,KAAK,IAAI,KAAK;CAC/E,MAAM,aAAa,OAAO,YAAY,SAAS,eAAe;CAC9D,QAAQ,IAAI,MAAA,GAAA,UAAA,WAAe,QAAQ,SAAS,CAAC,GAAG,cAAc,WAAW,WAAW,cAAc;CAElG,IAAI,OAAO,aACT,QAAQ,IAAI,KAAK,OAAO,YAAY,IAAI;CAG1C,IAAI,OAAO,YAAY,QAAQ;EAC7B,QAAQ,KAAA,GAAA,UAAA,WAAc,QAAQ,YAAY,CAAC;EAC3C,KAAK,MAAM,OAAO,OAAO,aACvB,QAAQ,IAAI,MAAA,GAAA,UAAA,WAAe,QAAQ,IAAI,KAAK,OAAO,GAAG,CAAC,GAAG,IAAI,cAAc;EAE9E,QAAQ,KAAK;;CAGf,MAAM,UAA0B,CAC9B,GAAG,OAAO,SACV;EACE,MAAM;EACN,OAAO;EACP,MAAM;EACN,aAAa;EACd,CACF;CAED,QAAQ,KAAA,GAAA,UAAA,WAAc,QAAQ,WAAW,CAAC;CAC1C,KAAK,MAAM,OAAO,SAAS;EACzB,MAAM,SAAA,GAAA,UAAA,WAAkB,QAAQ,IAAI,MAAM,OAAO,GAAG,CAAC;EACrD,MAAM,cAAc,IAAI,YAAY,KAAA,KAAA,GAAA,UAAA,WAAsB,OAAO,cAAc,IAAI,QAAQ,GAAG,GAAG;EACjG,QAAQ,IAAI,KAAK,QAAQ,IAAI,cAAc,cAAc;;CAE3D,QAAQ,KAAK;CAEb,IAAI,OAAO,UAAU,QAAQ;EAC3B,QAAQ,KAAA,GAAA,UAAA,WAAc,QAAQ,YAAY,CAAC;EAC3C,KAAK,MAAM,MAAM,OAAO,UACtB,QAAQ,IAAI,MAAA,GAAA,UAAA,WAAe,OAAO,GAAG,GAAG;EAE1C,QAAQ,KAAK;;;;;AC5CjB,SAAS,kBAAkB,KAAsC;CAC/D,MAAM,SAAuB,EAC3B,MAAM;EAAE,MAAM;EAAW,OAAO;EAAK,EACtC;CAED,KAAK,MAAM,CAAC,MAAM,QAAQ,OAAO,QAAQ,IAAI,WAAW,EAAE,CAAC,EACzD,OAAO,QAAQ;EACb,MAAM,IAAI;EACV,GAAI,IAAI,QAAQ,EAAE,OAAO,IAAI,OAAO,GAAG,EAAE;EACzC,GAAI,IAAI,YAAY,KAAA,IAAY,EAAE,SAAS,IAAI,SAAS,GAAG,EAAE;EAC9D;CAGH,OAAO;;AAGT,eAAe,WAAW,KAAwB,MAAgB,YAAoC;CACpG,MAAM,eAAe,kBAAkB,IAAI;CAE3C,IAAI;CACJ,IAAI;EACF,MAAM,UAAA,GAAA,UAAA,WAAmB;GACvB,MAAM;GACN,SAAS;GACT,kBAAkB;GAClB,QAAQ;GACT,CAAC;EACF,SAAS;GACP,QAAQ,OAAO;GACf,aAAa,OAAO;GACrB;SACK;EACN,WAAW,KAAK,WAAW;EAC3B,QAAQ,KAAK,EAAE;;CAGjB,IAAI,OAAO,OAAO,SAAS;EACzB,WAAW,KAAK,WAAW;EAC3B,QAAQ,KAAK,EAAE;;CAIjB,KAAK,MAAM,CAAC,MAAM,QAAQ,OAAO,QAAQ,IAAI,WAAW,EAAE,CAAC,EACzD,IAAI,IAAI,YAAY,OAAO,OAAO,UAAU,KAAA,GAAW;EACrD,QAAQ,OAAA,GAAA,UAAA,WAAgB,OAAO,YAAY,KAAK,cAAc,CAAC;EAC/D,WAAW,KAAK,WAAW;EAC3B,QAAQ,KAAK,EAAE;;CAInB,IAAI,CAAC,IAAI,KAAK;EACZ,WAAW,KAAK,WAAW;EAC3B,QAAQ,KAAK,EAAE;;CAGjB,IAAI;EACF,MAAM,IAAI,IAAI,OAAO;UACd,KAAK;EACZ,QAAQ,OAAA,GAAA,UAAA,WAAgB,OAAO,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAAG,CAAC;EAC7F,WAAW,KAAK,WAAW;EAC3B,QAAQ,KAAK,EAAE;;;AAInB,SAAS,cAAc,aAAqB,SAAiB,MAAiC;CAC5F,QAAQ,IAAI,MAAA,GAAA,UAAA,WAAe,QAAQ,SAAS,CAAC,GAAG,YAAY,wBAAwB;CACpF,QAAQ,IAAI,WAAW,QAAQ,+DAA+D;CAC9F,QAAQ,IAAI,2DAA2D;CACvE,QAAQ,IAAI,mBAAA,GAAA,UAAA,WAA4B,QAAQ,GAAG,YAAY,OAAO,CAAC,+BAAA,GAAA,UAAA,WAAwC,QAAQ,GAAG,YAAY,WAAW,CAAC,YAAY;CAC9J,QAAQ,KAAA,GAAA,UAAA,WAAc,QAAQ,YAAY,CAAC;CAC3C,KAAK,MAAM,OAAO,MAChB,QAAQ,IAAI,MAAA,GAAA,UAAA,WAAe,QAAQ,IAAI,KAAK,OAAO,GAAG,CAAC,GAAG,IAAI,cAAc;CAE9E,QAAQ,KAAK;CACb,QAAQ,KAAA,GAAA,UAAA,WAAc,QAAQ,WAAW,CAAC;CAC1C,QAAQ,IAAI,MAAA,GAAA,UAAA,WAAe,QAAQ,gBAAgB,OAAO,GAAG,CAAC,CAAC,qBAAqB;CACpF,QAAQ,IAAI,MAAA,GAAA,UAAA,WAAe,QAAQ,aAAa,OAAO,GAAG,CAAC,CAAC,WAAW;CACvE,QAAQ,KAAK;CACb,QAAQ,IAAI,QAAA,GAAA,UAAA,WAAiB,QAAQ,GAAG,YAAY,mBAAmB,CAAC,+BAA+B;;;;;AAMzG,MAAa,cAAcA,eAAAA,iBAAiB;CAC1C,WAAW,KAAwB,YAA2B;EAC5D,WAAW,KAAK,WAAW;;CAG7B,MAAM,IAAI,MAA2B,MAAgB,MAAiC;EACpF,MAAM,EAAE,aAAa,oBAAoB,YAAY;EAKrD,MAAM,4BAA4B,KAAK,IAAI,SAAS,IAAI,IAAI,KAAK,IAAI,SAAS,KAAK,KAAK;EACxF,MAAM,OAAO,KAAK,UAAU,KAAK,2BAA2B,KAAK,MAAM,EAAE,GAAG;EAE5E,IAAI,KAAK,OAAO,eAAe,KAAK,OAAO,MAAM;GAC/C,QAAQ,IAAI,QAAQ;GACpB,QAAQ,KAAK,EAAE;;EAGjB,IAAI,KAAK,OAAO,YAAY,KAAK,OAAO,MAAM;GAC5C,cAAc,aAAa,SAAS,KAAK;GACzC,QAAQ,KAAK,EAAE;;EAGjB,IAAI,KAAK,WAAW,GAAG;GACrB,MAAM,aAAa,KAAK,MAAM,MAAM,EAAE,SAAS,mBAAmB;GAClE,IAAI,YAAY,KACd,MAAM,WAAW,YAAY,EAAE,EAAE,YAAY;QAE7C,cAAc,aAAa,SAAS,KAAK;GAE3C;;EAGF,MAAM,CAAC,OAAO,GAAG,QAAQ;EACzB,MAAM,oBAAoB,KAAK,MAAM,MAAM,EAAE,SAAS,MAAM;EAE5D,IAAI;EACJ,IAAI;EACJ,IAAI;EAEJ,IAAI,mBAAmB;GACrB,MAAM,KAAK,MAAM,MAAM,EAAE,SAAS,MAAM;GACxC,cAAc;GACd,aAAa;SACR;GACL,MAAM,KAAK,MAAM,MAAM,EAAE,SAAS,mBAAmB;GACrD,cAAc;GACd,aAAa;;EAGf,IAAI,CAAC,KAAK;GACR,QAAQ,MAAM,oBAAoB,QAAQ;GAC1C,cAAc,aAAa,SAAS,KAAK;GACzC,QAAQ,KAAK,EAAE;;EAGjB,IAAI,IAAI,aAAa,QAAQ;GAC3B,MAAM,CAAC,SAAS,GAAG,WAAW;GAC9B,MAAM,SAAS,IAAI,YAAY,MAAM,MAAM,EAAE,SAAS,QAAQ;GAE9D,IAAI,YAAY,YAAY,YAAY,MAAM;IAC5C,WAAW,KAAK,WAAW;IAC3B,QAAQ,KAAK,EAAE;;GAGjB,IAAI,CAAC,QAAQ;IACX,WAAW,KAAK,WAAW;IAC3B,QAAQ,KAAK,UAAU,IAAI,EAAE;;GAG/B,MAAM,WAAW,QAAQ,SAAS,GAAG,WAAW,GAAG,IAAI,OAAO;GAC9D;;EAGF,MAAM,WAAW,KAAK,aAAa,WAAW;;CAEjD,CAAC;;;;;;;;;;;;;;;;;AC5JF,SAAgB,UAAU,SAExB;CACA,MAAM,UAAU,SAAS,WAAW;CAEpC,OAAO,EACL,IAAI,UAAU,MAAM,MAAM;EACxB,OAAO,QAAQ,IAAI,UAAU,MAAM,KAAK;IAE3C;;;;;;;ACvBH,SAAgB,OAAyB,KAAqB,OAA2B;CACvF,KAAK,MAAM,QAAQ,KACjB,IAAI,SAAS,OAAO,OAAO;CAE7B,OAAO;;;;ACDT,MAAM,MAAM,WAAW;AAEvB,SAAS,0BAA0B,MAA8B;CAC/D,IAAIC,kBAAAA,qBAAqB,EACvB,OAAO;CAIT,IAAI,KAAK,MAAM,QAAQ,OAAOC,kBAAAA,aAAa,IAAI,CAAC,EAC9C,OAAO;CAIT,IAAI,CAAC,QAAQ,OAAO,OAClB,OAAO;CAGT,OAAO;;AAGT,eAAsB,IAAI,OAAsB,QAAQ,MAAqB;CAC3E,IAAI,0BAA0B,KAAK,EACjC,QAAQ,IACN,IAAA,GAAA,UAAA,WAAa,UAAU,UAAU,CAAC,wIAAA,GAAA,UAAA,WAAiJ,QAAQ,2BAA2B,CAAC,KACxN;CAGH,MAAM,EAAE,SAAS,oBAAoB,MAAA,QAAA,SAAA,CAAA,WAAA,QAAM,0BAAA,CAAA;CAC3C,MAAM,EAAE,SAAS,oBAAoB,MAAA,QAAA,SAAA,CAAA,WAAA,QAAM,0BAAA,CAAA;CAC3C,MAAM,EAAE,SAAS,eAAe,MAAA,QAAA,SAAA,CAAA,WAAA,QAAM,qBAAA,CAAA;CACtC,MAAM,EAAE,SAAS,iBAAiB,MAAA,QAAA,SAAA,CAAA,WAAA,QAAM,uBAAA,CAAA;CACxC,MAAM,EAAE,SAAS,gBAAgB,MAAA,QAAA,SAAA,CAAA,WAAA,QAAM,sBAAA,CAAA;CAEvC,MAAM,IAAI,IAAI;EAAC;EAAiB;EAAiB;EAAY;EAAc;EAAY,EAAE,MAAM;EAC7F,aAAa;EACb,oBAAoB;EACpB,SAAA,gBAAA;EACD,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { t as __name } from "./chunk--u3MIqq1.js";
+import { t as __name } from "./chunk-BvFE5Tac.js";
 
 //#region src/index.d.ts
 declare function run(argv?: Array<string>): Promise<void>;

package/dist/index.js

@@ -1,13 +1,19 @@
-import "./chunk--u3MIqq1.js";
-import { t as defineCLIAdapter } from "./define--M_JMcDC.js";
-import { n as isTelemetryDisabled } from "./telemetry-BF3SMlH6.js";
-import { t as version } from "./package-BKZ0H3Zf.js";
-import { r as QUITE_FLAGS } from "./constants-DJM9zCXm.js";
+import "./chunk-BvFE5Tac.js";
+import { t as defineCLIAdapter } from "./define-m_fp-Aqm.js";
+import { n as isTelemetryDisabled } from "./telemetry-BkektVz6.js";
+import { t as version } from "./package-OLYIpjqw.js";
+import { r as QUIET_FLAGS } from "./constants-B2JTeRBb.js";
 import { parseArgs, styleText } from "node:util";
 //#region ../../internals/utils/src/cli/schema.ts
 /**
 * Serializes `CommandDefinition[]` to a plain, JSON-serializable structure.
 * Use to expose CLI capabilities to AI agents or MCP tools.
+*
+* @example
+* ```ts
+* getCommandSchema([generateCommand, agentCommand])
+* // [{ name: 'generate', options: [...], subCommands: [] }, ...]
+* ```
 */
 function getCommandSchema(defs) {
 	return defs.map(serializeCommand);
@@ -17,6 +23,7 @@ function serializeCommand(def) {
 		name: def.name,
 		description: def.description,
 		arguments: def.arguments,
+		...def.examples?.length ? { examples: def.examples } : {},
 		options: serializeOptions(def.options ?? {}),
 		subCommands: def.subCommands ? def.subCommands.map(serializeCommand) : []
 	};
@@ -37,7 +44,14 @@ function serializeOptions(options) {
 }
 //#endregion
 //#region ../../internals/utils/src/cli/help.ts
-/** Prints formatted help output for a command using its `CommandDefinition`. */
+/** Prints formatted help output for `def` using its `CommandDefinition`.
+*
+* @example
+* ```ts
+* renderHelp({ name: 'generate', description: 'Generate client code' })
+* // prints Usage: generate [options] ...
+* ```
+*/
 function renderHelp(def, parentName) {
 	const schema = getCommandSchema([def])[0];
 	const programName = parentName ? `${parentName} ${schema.name}` : schema.name;
@@ -63,6 +77,11 @@ function renderHelp(def, parentName) {
 		console.log(`  ${flags}${opt.description}${defaultPart}`);
 	}
 	console.log();
+	if (schema.examples?.length) {
+		console.log(styleText("bold", "Examples:"));
+		for (const ex of schema.examples) console.log(`  ${styleText("dim", ex)}`);
+		console.log();
+	}
 }
 //#endregion
 //#region ../../internals/utils/src/cli/adapters/nodeAdapter.ts
@@ -119,7 +138,9 @@ async function runCommand(def, argv, parentName) {
 }
 function printRootHelp(programName, version, defs) {
 	console.log(`\n${styleText("bold", "Usage:")} ${programName} <command> [options]\n`);
-	console.log(`  Kubb generation — v${version}\n`);
+	console.log(`  Kubb v${version} — Generate TypeScript types, API clients, React Query hooks,`);
+	console.log(`  Zod schemas, and more from an OpenAPI specification.\n`);
+	console.log(`  Quick start: ${styleText("cyan", `${programName} init`)} to scaffold a config, then ${styleText("cyan", `${programName} generate`)} to run.\n`);
 	console.log(styleText("bold", "Commands:"));
 	for (const def of defs) console.log(`  ${styleText("cyan", def.name.padEnd(16))}${def.description}`);
 	console.log();
@@ -129,14 +150,17 @@ function printRootHelp(programName, version, defs) {
 	console.log();
 	console.log(`Run ${styleText("cyan", `${programName} <command> --help`)} for command-specific help.\n`);
 }
-/** CLI adapter using `node:util parseArgs`. No external dependencies. */
+/**
+* CLI adapter using `node:util parseArgs`. No external dependencies.
+*/
 const nodeAdapter = defineCLIAdapter({
 	renderHelp(def, parentName) {
 		renderHelp(def, parentName);
 	},
 	async run(defs, argv, opts) {
 		const { programName, defaultCommandName, version } = opts;
-		const args = argv.length >= 2 && argv[0]?.includes("node") ? argv.slice(2) : argv;
+		const firstArgIsExecutablePath = (argv[0]?.includes("/") || argv[0]?.includes("\\")) ?? false;
+		const args = argv.length >= 2 && firstArgIsExecutablePath ? argv.slice(2) : argv;
 		if (args[0] === "--version" || args[0] === "-v") {
 			console.log(version);
 			process.exit(0);
@@ -190,8 +214,18 @@ const nodeAdapter = defineCLIAdapter({
 //#endregion
 //#region ../../internals/utils/src/cli/parse.ts
 /**
-* Create a CLI runner bound to a specific adapter.
-* Defaults to the built-in `nodeAdapter` (Node.js `node:util parseArgs`).
+* Creates a CLI runner bound to a specific adapter.
+*
+* @default nodeAdapter (Node.js `node:util parseArgs`)
+*
+* @example
+* ```ts
+* await createCLI().run(commands, process.argv.slice(2), {
+*   programName: 'kubb',
+*   defaultCommandName: 'generate',
+*   version: '5.0.0',
+* })
+* ```
 */
 function createCLI(options) {
 	const adapter = options?.adapter ?? nodeAdapter;
@@ -200,10 +234,9 @@ function createCLI(options) {
 	} };
 }
 //#endregion
-//#region src/utils/flags.ts
+//#region ../../internals/utils/src/isFlag.ts
 /**
-* Type guard that checks whether a raw string is a member of a typed flag set.
-* Avoids the need for type assertions when working with `Set<T extends string>`.
+* Type guard that confirms `value` is a member of `set`. Avoids type assertions with `Set<T extends string>`.
 */
 function isFlag(set, value) {
 	for (const flag of set) if (flag === value) return true;
@@ -214,19 +247,17 @@ function isFlag(set, value) {
 const cli = createCLI();
 function shouldShowTelemetryNotice(argv) {
 	if (isTelemetryDisabled()) return false;
-	if (argv.some((arg) => isFlag(QUITE_FLAGS, arg))) return false;
+	if (argv.some((arg) => isFlag(QUIET_FLAGS, arg))) return false;
 	if (!process.stdout.isTTY) return false;
 	return true;
 }
 async function run(argv = process.argv) {
 	if (shouldShowTelemetryNotice(argv)) 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`);
-	const [{ command: generateCommand }, { command: validateCommand }, { command: mcpCommand }, { command: agentCommand }, { command: initCommand }] = await Promise.all([
-		import("./generate-Rly1EXBN.js"),
-		import("./validate-DAZdX_0i.js"),
-		import("./mcp-eP1S40LZ.js"),
-		import("./agent-5mmp7QzF.js"),
-		import("./init-iN7e1XwI.js")
-	]);
+	const { command: generateCommand } = await import("./generate-BLvcvoIj.js");
+	const { command: validateCommand } = await import("./validate-CAUqLaGt.js");
+	const { command: mcpCommand } = await import("./mcp-Cq2sylQC.js");
+	const { command: agentCommand } = await import("./agent-Bx2yllmS.js");
+	const { command: initCommand } = await import("./init-CGu7JZEF.js");
 	await cli.run([
 		generateCommand,
 		validateCommand,

package/dist/index.js.map

@@ -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/utils/flags.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 */\nexport function getCommandSchema(defs: CommandDefinition[]): 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    options: serializeOptions(def.options ?? {}),\n    subCommands: def.subCommands ? def.subCommands.map(serializeCommand) : [],\n  }\n}\n\nfunction serializeOptions(options: Record<string, OptionDefinition>): 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 a command using its `CommandDefinition`. */\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: OptionSchema[] = [...schema.options, { name: 'help', flags: '-h, --help', type: 'boolean' as const, description: 'Show help' }]\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","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 = { type: OptionType; short?: string; default?: string | boolean }\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: 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 = { values: result.values as ParsedArgs['values'], positionals: result.positionals }\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: CommandDefinition[]): void {\n  console.log(`\\n${styleText('bold', 'Usage:')} ${programName} <command> [options]\\n`)\n  console.log(`  Kubb generation — v${version}\\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/** CLI adapter using `node:util parseArgs`. No external dependencies. */\nexport const nodeAdapter = defineCLIAdapter({\n  renderHelp(def: CommandDefinition, parentName?: string): void {\n    renderHelp(def, parentName)\n  },\n\n  async run(defs: CommandDefinition[], argv: string[], opts: RunOptions): Promise<void> {\n    const { programName, defaultCommandName, version } = opts\n\n    const args = argv.length >= 2 && argv[0]?.includes('node') ? 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: 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 * Create a CLI runner bound to a specific adapter.\n * Defaults to the built-in `nodeAdapter` (Node.js `node:util parseArgs`).\n */\nexport function createCLI(options?: { adapter?: CLIAdapter }): {\n  run(commands: CommandDefinition[], argv: 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","/**\n * Type guard that checks whether a raw string is a member of a typed flag set.\n * Avoids the need for type assertions when working with `Set<T extends string>`.\n */\nexport function isFlag<T extends string>(set: ReadonlySet<T>, value: string): value is T {\n  for (const flag of set) {\n    if (flag === value) return true\n  }\n  return false\n}\n","import { styleText } from 'node:util'\nimport { createCLI } from '@internals/utils'\nimport { version } from '../package.json'\nimport { QUITE_FLAGS } from './constants.ts'\nimport { isFlag } from './utils/flags.ts'\nimport { isTelemetryDisabled } from './utils/telemetry.ts'\n\nconst cli = createCLI()\n\nfunction shouldShowTelemetryNotice(argv: Array<string>): boolean {\n  if (isTelemetryDisabled()) {\n    return false\n  }\n  // Skip when the user is just asking for help or version info\n  if (argv.some((arg) => isFlag(QUITE_FLAGS, arg))) {\n    return false\n  }\n  // Skip in non-interactive / scripting contexts\n  if (!process.stdout.isTTY) {\n    return false\n  }\n  return true\n}\n\nexport async function run(argv: Array<string> = process.argv): Promise<void> {\n  if (shouldShowTelemetryNotice(argv)) {\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 }, { command: validateCommand }, { command: mcpCommand }, { command: agentCommand }, { command: initCommand }] =\n    await Promise.all([\n      import('./commands/generate.ts'),\n      import('./commands/validate.ts'),\n      import('./commands/mcp.ts'),\n      import('./commands/agent.ts'),\n      import('./commands/init.ts'),\n    ])\n\n  await cli.run([generateCommand, validateCommand, mcpCommand, agentCommand, initCommand], argv, {\n    programName: 'kubb',\n    defaultCommandName: 'generate',\n    version,\n  })\n}\n"],"mappings":"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"}
+{"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","../../../internals/utils/src/isFlag.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: CommandDefinition[]): 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>): 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: 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: 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: 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: CommandDefinition[], argv: 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: 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: CommandDefinition[], argv: 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","/**\n * Type guard that confirms `value` is a member of `set`. Avoids type assertions with `Set<T extends string>`.\n */\nexport function isFlag<T extends string>(set: ReadonlySet<T>, value: string): value is T {\n  for (const flag of set) {\n    if (flag === value) return true\n  }\n  return false\n}\n","import { styleText } from 'node:util'\nimport { createCLI, isFlag } from '@internals/utils'\nimport { version } from '../package.json'\nimport { QUIET_FLAGS } from './constants.ts'\nimport { isTelemetryDisabled } from './telemetry.ts'\n\nconst cli = createCLI()\n\nfunction shouldShowTelemetryNotice(argv: Array<string>): boolean {\n  if (isTelemetryDisabled()) {\n    return false\n  }\n\n  // Skip when the user is just asking for help or version info\n  if (argv.some((arg) => isFlag(QUIET_FLAGS, arg))) {\n    return false\n  }\n\n  // Skip in non-interactive / scripting contexts\n  if (!process.stdout.isTTY) {\n    return false\n  }\n\n  return true\n}\n\nexport async function run(argv: Array<string> = process.argv): Promise<void> {\n  if (shouldShowTelemetryNotice(argv)) {\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: agentCommand } = await import('./commands/agent.ts')\n  const { command: initCommand } = await import('./commands/init.ts')\n\n  await cli.run([generateCommand, validateCommand, mcpCommand, agentCommand, initCommand], argv, {\n    programName: 'kubb',\n    defaultCommandName: 'generate',\n    version,\n  })\n}\n"],"mappings":"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"}

package/dist/init-CGu7JZEF.js

@@ -0,0 +1,53 @@
+import "./chunk-BvFE5Tac.js";
+import { n as defineCommand } from "./define-m_fp-Aqm.js";
+import { t as version } from "./package-OLYIpjqw.js";
+//#region src/commands/init.ts
+const command = defineCommand({
+	name: "init",
+	description: "Scaffold a kubb.config.ts and install plugins for code generation from an OpenAPI spec. Run without flags for interactive setup, or pass --input, --output, and --plugins to skip the prompts.",
+	examples: [
+		"kubb init",
+		"kubb init --yes",
+		"kubb init --input ./openapi.yaml --output ./src/gen --plugins plugin-ts,plugin-zod",
+		"kubb init --plugins plugin-ts,plugin-client,plugin-react-query"
+	],
+	options: {
+		yes: {
+			type: "boolean",
+			description: "Skip prompts and use default options",
+			short: "y",
+			default: false
+		},
+		input: {
+			type: "string",
+			description: "Path to the OpenAPI specification",
+			short: "i",
+			hint: "path"
+		},
+		output: {
+			type: "string",
+			description: "Output directory for generated files",
+			short: "o",
+			hint: "path"
+		},
+		plugins: {
+			type: "string",
+			description: "Comma-separated list of plugins to use (plugin-ts, plugin-client, plugin-react-query, plugin-vue-query, plugin-zod, plugin-faker, plugin-msw, plugin-cypress, plugin-mcp, plugin-redoc)",
+			hint: "plugin-ts,plugin-zod,..."
+		}
+	},
+	async run({ values }) {
+		const { run } = await import("./run-CF97BWVa.js");
+		await run({
+			yes: values.yes,
+			version,
+			input: values.input,
+			output: values.output,
+			plugins: values.plugins
+		});
+	}
+});
+//#endregion
+export { command };
+
+//# sourceMappingURL=init-CGu7JZEF.js.map

package/dist/init-CGu7JZEF.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-CGu7JZEF.js","names":[],"sources":["../src/commands/init.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport { version } from '../../package.json'\n\nexport const command = defineCommand({\n  name: 'init',\n  description:\n    'Scaffold a kubb.config.ts and install plugins for code generation from an OpenAPI spec. Run without flags for interactive setup, or pass --input, --output, and --plugins to skip the prompts.',\n  examples: [\n    'kubb init',\n    'kubb init --yes',\n    'kubb init --input ./openapi.yaml --output ./src/gen --plugins plugin-ts,plugin-zod',\n    'kubb init --plugins plugin-ts,plugin-client,plugin-react-query',\n  ],\n  options: {\n    yes: {\n      type: 'boolean',\n      description: 'Skip prompts and use default options',\n      short: 'y',\n      default: false,\n    },\n    input: {\n      type: 'string',\n      description: 'Path to the OpenAPI specification',\n      short: 'i',\n      hint: 'path',\n    },\n    output: {\n      type: 'string',\n      description: 'Output directory for generated files',\n      short: 'o',\n      hint: 'path',\n    },\n    plugins: {\n      type: 'string',\n      description:\n        'Comma-separated list of plugins to use (plugin-ts, plugin-client, plugin-react-query, plugin-vue-query, plugin-zod, plugin-faker, plugin-msw, plugin-cypress, plugin-mcp, plugin-redoc)',\n      hint: 'plugin-ts,plugin-zod,...',\n    },\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/init/run.ts')\n\n    await run({\n      yes: values.yes,\n      version,\n      input: values.input,\n      output: values.output,\n      plugins: values.plugins,\n    })\n  },\n})\n"],"mappings":";;;;AAGA,MAAa,UAAU,cAAc;CACnC,MAAM;CACN,aACE;CACF,UAAU;EACR;EACA;EACA;EACA;EACD;CACD,SAAS;EACP,KAAK;GACH,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACV;EACD,OAAO;GACL,MAAM;GACN,aAAa;GACb,OAAO;GACP,MAAM;GACP;EACD,QAAQ;GACN,MAAM;GACN,aAAa;GACb,OAAO;GACP,MAAM;GACP;EACD,SAAS;GACP,MAAM;GACN,aACE;GACF,MAAM;GACP;EACF;CACD,MAAM,IAAI,EAAE,UAAU;EACpB,MAAM,EAAE,QAAQ,MAAM,OAAO;EAE7B,MAAM,IAAI;GACR,KAAK,OAAO;GACZ;GACA,OAAO,OAAO;GACd,QAAQ,OAAO;GACf,SAAS,OAAO;GACjB,CAAC;;CAEL,CAAC"}

package/dist/init-CyCjvIEF.cjs

@@ -0,0 +1,53 @@
+require("./chunk-ByKO4r7w.cjs");
+const require_define = require("./define-Bdn8j5VM.cjs");
+const require_package = require("./package-DZ-6zAIO.cjs");
+//#region src/commands/init.ts
+const command = require_define.defineCommand({
+	name: "init",
+	description: "Scaffold a kubb.config.ts and install plugins for code generation from an OpenAPI spec. Run without flags for interactive setup, or pass --input, --output, and --plugins to skip the prompts.",
+	examples: [
+		"kubb init",
+		"kubb init --yes",
+		"kubb init --input ./openapi.yaml --output ./src/gen --plugins plugin-ts,plugin-zod",
+		"kubb init --plugins plugin-ts,plugin-client,plugin-react-query"
+	],
+	options: {
+		yes: {
+			type: "boolean",
+			description: "Skip prompts and use default options",
+			short: "y",
+			default: false
+		},
+		input: {
+			type: "string",
+			description: "Path to the OpenAPI specification",
+			short: "i",
+			hint: "path"
+		},
+		output: {
+			type: "string",
+			description: "Output directory for generated files",
+			short: "o",
+			hint: "path"
+		},
+		plugins: {
+			type: "string",
+			description: "Comma-separated list of plugins to use (plugin-ts, plugin-client, plugin-react-query, plugin-vue-query, plugin-zod, plugin-faker, plugin-msw, plugin-cypress, plugin-mcp, plugin-redoc)",
+			hint: "plugin-ts,plugin-zod,..."
+		}
+	},
+	async run({ values }) {
+		const { run } = await Promise.resolve().then(() => require("./run-YsoCk5we.cjs"));
+		await run({
+			yes: values.yes,
+			version: require_package.version,
+			input: values.input,
+			output: values.output,
+			plugins: values.plugins
+		});
+	}
+});
+//#endregion
+exports.command = command;
+
+//# sourceMappingURL=init-CyCjvIEF.cjs.map

package/dist/init-CyCjvIEF.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-CyCjvIEF.cjs","names":["defineCommand"],"sources":["../src/commands/init.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport { version } from '../../package.json'\n\nexport const command = defineCommand({\n  name: 'init',\n  description:\n    'Scaffold a kubb.config.ts and install plugins for code generation from an OpenAPI spec. Run without flags for interactive setup, or pass --input, --output, and --plugins to skip the prompts.',\n  examples: [\n    'kubb init',\n    'kubb init --yes',\n    'kubb init --input ./openapi.yaml --output ./src/gen --plugins plugin-ts,plugin-zod',\n    'kubb init --plugins plugin-ts,plugin-client,plugin-react-query',\n  ],\n  options: {\n    yes: {\n      type: 'boolean',\n      description: 'Skip prompts and use default options',\n      short: 'y',\n      default: false,\n    },\n    input: {\n      type: 'string',\n      description: 'Path to the OpenAPI specification',\n      short: 'i',\n      hint: 'path',\n    },\n    output: {\n      type: 'string',\n      description: 'Output directory for generated files',\n      short: 'o',\n      hint: 'path',\n    },\n    plugins: {\n      type: 'string',\n      description:\n        'Comma-separated list of plugins to use (plugin-ts, plugin-client, plugin-react-query, plugin-vue-query, plugin-zod, plugin-faker, plugin-msw, plugin-cypress, plugin-mcp, plugin-redoc)',\n      hint: 'plugin-ts,plugin-zod,...',\n    },\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/init/run.ts')\n\n    await run({\n      yes: values.yes,\n      version,\n      input: values.input,\n      output: values.output,\n      plugins: values.plugins,\n    })\n  },\n})\n"],"mappings":";;;;AAGA,MAAa,UAAUA,eAAAA,cAAc;CACnC,MAAM;CACN,aACE;CACF,UAAU;EACR;EACA;EACA;EACA;EACD;CACD,SAAS;EACP,KAAK;GACH,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACV;EACD,OAAO;GACL,MAAM;GACN,aAAa;GACb,OAAO;GACP,MAAM;GACP;EACD,QAAQ;GACN,MAAM;GACN,aAAa;GACb,OAAO;GACP,MAAM;GACP;EACD,SAAS;GACP,MAAM;GACN,aACE;GACF,MAAM;GACP;EACF;CACD,MAAM,IAAI,EAAE,UAAU;EACpB,MAAM,EAAE,QAAQ,MAAA,QAAA,SAAA,CAAA,WAAA,QAAM,qBAAA,CAAA;EAEtB,MAAM,IAAI;GACR,KAAK,OAAO;GACZ,SAAA,gBAAA;GACA,OAAO,OAAO;GACd,QAAQ,OAAO;GACf,SAAS,OAAO;GACjB,CAAC;;CAEL,CAAC"}