@kubb/cli 5.0.0-beta.5 → 5.0.0-beta.6

package/dist/index.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("./chunk-ByKO4r7w.cjs");
 const require_define = require("./define-Bdn8j5VM.cjs");
-const require_telemetry = require("./telemetry-BU25EoI-.cjs");
-const require_package = require("./package-BmYRU2hz.cjs");
-const require_constants = require("./constants-B4iBDvCe.cjs");
+const require_telemetry = require("./telemetry-BLX0NzRk.cjs");
+const require_package = require("./package-iheSdfas.cjs");
+const require_constants = require("./constants-Rcaqzyd-.cjs");
 let node_util = require("node:util");
 //#region ../../internals/utils/src/cli/schema.ts
 /**
@@ -24,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) : []
 	};
@@ -77,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
@@ -133,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();
@@ -152,7 +160,8 @@ const nodeAdapter = require_define.defineCLIAdapter({
 	},
 	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);
@@ -245,11 +254,11 @@ function shouldShowTelemetryNotice(argv) {
 }
 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 } = await Promise.resolve().then(() => require("./generate-7td_hs73.cjs"));
-	const { command: validateCommand } = await Promise.resolve().then(() => require("./validate-DwX4LzYq.cjs"));
-	const { command: mcpCommand } = await Promise.resolve().then(() => require("./mcp-CIbuLGMx.cjs"));
-	const { command: agentCommand } = await Promise.resolve().then(() => require("./agent-CsMvXeqI.cjs"));
-	const { command: initCommand } = await Promise.resolve().then(() => require("./init-CfsYoyGe.cjs"));
+	const { command: generateCommand } = await Promise.resolve().then(() => require("./generate-BB2Q7I9s.cjs"));
+	const { command: validateCommand } = await Promise.resolve().then(() => require("./validate-DIDBROB2.cjs"));
+	const { command: mcpCommand } = await Promise.resolve().then(() => require("./mcp-wpl6sYYR.cjs"));
+	const { command: agentCommand } = await Promise.resolve().then(() => require("./agent-CXNO6dgj.cjs"));
+	const { command: initCommand } = await Promise.resolve().then(() => require("./init-Dpg8e1HN.cjs"));
 	await cli.run([
 		generateCommand,
 		validateCommand,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"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","../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 *\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    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","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 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/**\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    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 * 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 } from '@internals/utils'\nimport { version } from '../package.json'\nimport { QUIET_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(QUIET_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 } = 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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"}
+{"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","../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 *\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 } from '@internals/utils'\nimport { version } from '../package.json'\nimport { QUIET_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(QUIET_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 } = 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/index.js

@@ -1,8 +1,8 @@
 import "./chunk--u3MIqq1.js";
 import { t as defineCLIAdapter } from "./define-Ctii4bel.js";
-import { n as isTelemetryDisabled } from "./telemetry-CaNU4-Bf.js";
-import { t as version } from "./package-DBU5ii-k.js";
-import { i as QUIET_FLAGS } from "./constants-DmPrkaz8.js";
+import { n as isTelemetryDisabled } from "./telemetry-juq4QBf7.js";
+import { t as version } from "./package-vLafMWCe.js";
+import { r as QUIET_FLAGS } from "./constants-BPJBMT_6.js";
 import { parseArgs, styleText } from "node:util";
 //#region ../../internals/utils/src/cli/schema.ts
 /**
@@ -23,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) : []
 	};
@@ -76,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
@@ -132,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();
@@ -151,7 +159,8 @@ const nodeAdapter = defineCLIAdapter({
 	},
 	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);
@@ -244,11 +253,11 @@ function shouldShowTelemetryNotice(argv) {
 }
 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 } = await import("./generate-BqeFFQGD.js");
-	const { command: validateCommand } = await import("./validate-CQqM9siF.js");
-	const { command: mcpCommand } = await import("./mcp-BtOV6acy.js");
-	const { command: agentCommand } = await import("./agent-BcUEl9yB.js");
-	const { command: initCommand } = await import("./init-CfAn19gC.js");
+	const { command: generateCommand } = await import("./generate-BmulGxIM.js");
+	const { command: validateCommand } = await import("./validate-BfJoCxrC.js");
+	const { command: mcpCommand } = await import("./mcp-C9RoU-Dg.js");
+	const { command: agentCommand } = await import("./agent-BJEvbSiP.js");
+	const { command: initCommand } = await import("./init-BTp9if7K.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 *\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    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","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 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/**\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    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 * 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 } from '@internals/utils'\nimport { version } from '../package.json'\nimport { QUIET_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(QUIET_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 } = 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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"}
+{"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 *\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 } from '@internals/utils'\nimport { version } from '../package.json'\nimport { QUIET_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(QUIET_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 } = 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-BTp9if7K.js

@@ -0,0 +1,53 @@
+import "./chunk--u3MIqq1.js";
+import { n as defineCommand } from "./define-Ctii4bel.js";
+import { t as version } from "./package-vLafMWCe.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 { runInit } = await import("./init-DCqcEq86.js");
+		await runInit({
+			yes: values.yes,
+			version,
+			input: values.input,
+			output: values.output,
+			plugins: values.plugins
+		});
+	}
+});
+//#endregion
+export { command };
+
+//# sourceMappingURL=init-BTp9if7K.js.map

package/dist/init-BTp9if7K.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-BTp9if7K.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 { runInit } = await import('../runners/init.ts')\n\n    await runInit({\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,YAAY,MAAM,OAAO;EAEjC,MAAM,QAAQ;GACZ,KAAK,OAAO;GACZ;GACA,OAAO,OAAO;GACd,QAAQ,OAAO;GACf,SAAS,OAAO;GACjB,CAAC;;CAEL,CAAC"}

package/dist/{init-C5sZulT6.cjs → init-CJ80lKSP.cjs}

@@ -1,6 +1,6 @@
 const require_chunk = require("./chunk-ByKO4r7w.cjs");
 const require_shell = require("./shell-475fQKaX.cjs");
-const require_constants = require("./constants-B4iBDvCe.cjs");
+const require_constants = require("./constants-BYGmiFs0.cjs");
 let node_util = require("node:util");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs, 1);
@@ -66,97 +66,8 @@ function detectPackageManager(cwd = process.cwd()) {
 	return packageManagers.npm;
 }
 //#endregion
-//#region src/utils/packageManager.ts
-function hasPackageJson(cwd = process.cwd()) {
-	return node_fs.default.existsSync(node_path.default.join(cwd, "package.json"));
-}
-async function initPackageJson(cwd, packageManager) {
-	await require_shell.spawnAsync(packageManager.name, {
-		npm: ["init", "-y"],
-		pnpm: ["init"],
-		yarn: ["init", "-y"],
-		bun: ["init", "-y"]
-	}[packageManager.name], { cwd });
-}
-async function installPackages(packages, packageManager, cwd = process.cwd()) {
-	await require_shell.spawnAsync(packageManager.name, [...packageManager.installCommand, ...packages], { cwd });
-}
-//#endregion
-//#region src/runners/init.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"
-	}
-];
-function generateConfigFile(selectedPlugins, inputPath, outputPath) {
+//#region ../../internals/shared/src/init.ts
+function generateConfigFile({ selectedPlugins, inputPath, outputPath }) {
 	return `import { defineConfig } from 'kubb'
 ${selectedPlugins.map((plugin) => `import { ${plugin.importName} } from '${plugin.packageName}'`).join("\n")}
 
@@ -177,11 +88,29 @@ ${selectedPlugins.map((plugin) => {
 })
 `;
 }
+//#endregion
+//#region src/utils/packageManager.ts
+function hasPackageJson(cwd = process.cwd()) {
+	return node_fs.default.existsSync(node_path.default.join(cwd, "package.json"));
+}
+async function initPackageJson(cwd, packageManager) {
+	await require_shell.spawnAsync(packageManager.name, {
+		npm: ["init", "-y"],
+		pnpm: ["init"],
+		yarn: ["init", "-y"],
+		bun: ["init", "-y"]
+	}[packageManager.name], { cwd });
+}
+async function installPackages(packages, packageManager, cwd = process.cwd()) {
+	await require_shell.spawnAsync(packageManager.name, [...packageManager.installCommand, ...packages], { cwd });
+}
+//#endregion
+//#region src/runners/init.ts
 function cancelAndExit(message = "Operation cancelled.") {
 	_clack_prompts.cancel(message);
 	node_process.default.exit(0);
 }
-async function runInit({ yes, version }) {
+async function runInit({ yes, version, input: inputFlag, output: outputFlag, plugins: pluginsFlag }) {
 	const cwd = node_process.default.cwd();
 	_clack_prompts.intro((0, node_util.styleText)("bgCyan", (0, node_util.styleText)("black", " Kubb Init ")));
 	try {
@@ -204,7 +133,10 @@ async function runInit({ yes, version }) {
 			_clack_prompts.log.info(`Detected package manager: ${(0, node_util.styleText)("cyan", packageManager.name)}`);
 		}
 		let inputPath;
-		if (yes) {
+		if (inputFlag) {
+			inputPath = inputFlag;
+			_clack_prompts.log.info(`Using input path: ${(0, node_util.styleText)("cyan", inputPath)}`);
+		} else if (yes) {
 			inputPath = require_constants.initDefaults.inputPath;
 			_clack_prompts.log.info(`Using input path: ${(0, node_util.styleText)("cyan", inputPath)}`);
 		} else {
@@ -220,7 +152,10 @@ async function runInit({ yes, version }) {
 			inputPath = inputPathResult;
 		}
 		let outputPath;
-		if (yes) {
+		if (outputFlag) {
+			outputPath = outputFlag;
+			_clack_prompts.log.info(`Using output path: ${(0, node_util.styleText)("cyan", outputPath)}`);
+		} else if (yes) {
 			outputPath = require_constants.initDefaults.outputPath;
 			_clack_prompts.log.info(`Using output path: ${(0, node_util.styleText)("cyan", outputPath)}`);
 		} else {
@@ -236,13 +171,20 @@ async function runInit({ yes, version }) {
 			outputPath = outputPathResult;
 		}
 		let selectedPlugins;
-		if (yes) {
-			selectedPlugins = availablePlugins.filter((plugin) => require_constants.initDefaults.plugins.includes(plugin.value));
+		if (pluginsFlag) {
+			const requestedValues = pluginsFlag.split(",").map((v) => v.trim()).filter(Boolean);
+			selectedPlugins = require_constants.availablePlugins.filter((plugin) => requestedValues.includes(plugin.value));
+			if (selectedPlugins.length === 0) {
+				selectedPlugins = require_constants.availablePlugins.filter((plugin) => require_constants.initDefaults.plugins.includes(plugin.value));
+				_clack_prompts.log.warn(`No valid plugins found in --plugins value; falling back to default: ${(0, node_util.styleText)("cyan", selectedPlugins.map((p) => p.label).join(", "))}`);
+			} else _clack_prompts.log.info(`Using plugins: ${(0, node_util.styleText)("cyan", selectedPlugins.map((p) => p.label).join(", "))}`);
+		} else if (yes) {
+			selectedPlugins = require_constants.availablePlugins.filter((plugin) => require_constants.initDefaults.plugins.includes(plugin.value));
 			_clack_prompts.log.info(`Using plugins: ${(0, node_util.styleText)("cyan", selectedPlugins.map((p) => p.label).join(", "))}`);
 		} else {
 			const selectedPluginValues = await _clack_prompts.multiselect({
 				message: "Select plugins to use:",
-				options: availablePlugins.map((plugin) => ({
+				options: require_constants.availablePlugins.map((plugin) => ({
 					value: plugin.value,
 					label: plugin.label,
 					hint: plugin.hint
@@ -251,7 +193,7 @@ async function runInit({ yes, version }) {
 				required: true
 			});
 			if (_clack_prompts.isCancel(selectedPluginValues)) cancelAndExit();
-			selectedPlugins = availablePlugins.filter((plugin) => selectedPluginValues.includes(plugin.value));
+			selectedPlugins = require_constants.availablePlugins.filter((plugin) => selectedPluginValues.includes(plugin.value));
 		}
 		const packagesToInstall = ["kubb", ...selectedPlugins.map((p) => p.packageName)];
 		const spinner = _clack_prompts.spinner();
@@ -265,7 +207,11 @@ async function runInit({ yes, version }) {
 		}
 		const configSpinner = _clack_prompts.spinner();
 		configSpinner.start(`Creating ${require_constants.KUBB_CONFIG_FILENAME}`);
-		const configContent = generateConfigFile(selectedPlugins, inputPath, outputPath);
+		const configContent = generateConfigFile({
+			selectedPlugins,
+			inputPath,
+			outputPath
+		});
 		const configPath = node_path.default.join(cwd, require_constants.KUBB_CONFIG_FILENAME);
 		if (node_fs.default.existsSync(configPath)) {
 			configSpinner.stop(`${require_constants.KUBB_CONFIG_FILENAME} already exists`);
@@ -290,4 +236,4 @@ async function runInit({ yes, version }) {
 //#endregion
 exports.runInit = runInit;
 
-//# sourceMappingURL=init-C5sZulT6.cjs.map
+//# sourceMappingURL=init-CJ80lKSP.cjs.map