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

package/dist/generate-XeCSLYWp.js

@@ -0,0 +1,83 @@
+import "./chunk-C0LytTxp.js";
+import { n as defineCommand } from "./define-C63T4jp6.js";
+//#region src/commands/generate.ts
+const command = defineCommand({
+	name: "generate",
+	description: "Generate TypeScript types, API clients, React Query hooks, Zod schemas, and more from an OpenAPI specification. Reads kubb.config.ts by default. Pass an OpenAPI file path as the first argument to override the input without editing the config.",
+	arguments: ["[input]"],
+	examples: [
+		"kubb generate",
+		"kubb generate ./openapi.yaml",
+		"kubb generate --config kubb.config.ts",
+		"kubb generate --watch"
+	],
+	options: {
+		config: {
+			type: "string",
+			description: "Path to the Kubb config",
+			short: "c"
+		},
+		logLevel: {
+			type: "string",
+			description: "Info, silent or verbose",
+			short: "l",
+			default: "info",
+			hint: "silent|info|verbose",
+			enum: [
+				"silent",
+				"info",
+				"verbose"
+			]
+		},
+		watch: {
+			type: "boolean",
+			description: "Watch mode based on the input file",
+			short: "w",
+			default: false
+		},
+		verbose: {
+			type: "boolean",
+			description: "Override logLevel to verbose",
+			short: "v",
+			default: false
+		},
+		silent: {
+			type: "boolean",
+			description: "Override logLevel to silent",
+			short: "s",
+			default: false
+		},
+		reporter: {
+			type: "string",
+			description: "Reporters that render the run, comma-separated. Overrides config.reporters",
+			hint: "cli|json|file",
+			enum: [
+				"cli",
+				"json",
+				"file"
+			]
+		},
+		"no-cache": {
+			type: "boolean",
+			description: "Disable the incremental build cache and force a full regeneration",
+			default: false
+		}
+	},
+	async run({ values, positionals }) {
+		const logLevel = values.verbose ? "verbose" : values.silent ? "silent" : values.logLevel;
+		const reporters = values.reporter?.split(",").map((name) => name.trim()).filter(Boolean);
+		const { run } = await import("./run-aODbKkaY.js");
+		await run({
+			input: positionals[0],
+			configPath: values.config,
+			logLevel,
+			watch: values.watch,
+			reporters,
+			noCache: values["no-cache"]
+		});
+	}
+});
+//#endregion
+export { command };
+
+//# sourceMappingURL=generate-XeCSLYWp.js.map

package/dist/generate-XeCSLYWp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-XeCSLYWp.js","names":[],"sources":["../src/commands/generate.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport type { ReporterName } from '@kubb/core'\n\nexport const command = defineCommand({\n  name: 'generate',\n  description:\n    'Generate TypeScript types, API clients, React Query hooks, Zod schemas, and more from an OpenAPI specification. Reads kubb.config.ts by default. Pass an OpenAPI file path as the first argument to override the input without editing the config.',\n  arguments: ['[input]'],\n  examples: ['kubb generate', 'kubb generate ./openapi.yaml', 'kubb generate --config kubb.config.ts', 'kubb generate --watch'],\n  options: {\n    config: {\n      type: 'string',\n      description: 'Path to the Kubb config',\n      short: 'c',\n    },\n    logLevel: {\n      type: 'string',\n      description: 'Info, silent or verbose',\n      short: 'l',\n      default: 'info',\n      hint: 'silent|info|verbose',\n      enum: ['silent', 'info', 'verbose'],\n    },\n    watch: {\n      type: 'boolean',\n      description: 'Watch mode based on the input file',\n      short: 'w',\n      default: false,\n    },\n    verbose: {\n      type: 'boolean',\n      description: 'Override logLevel to verbose',\n      short: 'v',\n      default: false,\n    },\n    silent: {\n      type: 'boolean',\n      description: 'Override logLevel to silent',\n      short: 's',\n      default: false,\n    },\n    reporter: {\n      type: 'string',\n      description: 'Reporters that render the run, comma-separated. Overrides config.reporters',\n      hint: 'cli|json|file',\n      enum: ['cli', 'json', 'file'],\n    },\n    'no-cache': {\n      type: 'boolean',\n      description: 'Disable the incremental build cache and force a full regeneration',\n      default: false,\n    },\n  },\n  async run({ values, positionals }) {\n    const logLevel = values.verbose ? 'verbose' : values.silent ? 'silent' : values.logLevel\n    const reporters = values.reporter\n      ?.split(',')\n      .map((name) => name.trim())\n      .filter(Boolean) as Array<ReporterName> | undefined\n    const { run } = await import('../runners/generate/run.ts')\n\n    await run({\n      input: positionals[0],\n      configPath: values.config,\n      logLevel,\n      watch: values.watch,\n      reporters,\n      noCache: values['no-cache'],\n    })\n  },\n})\n"],"mappings":";;;AAGA,MAAa,UAAU,cAAc;CACnC,MAAM;CACN,aACE;CACF,WAAW,CAAC,SAAS;CACrB,UAAU;EAAC;EAAiB;EAAgC;EAAyC;CAAuB;CAC5H,SAAS;EACP,QAAQ;GACN,MAAM;GACN,aAAa;GACb,OAAO;EACT;EACA,UAAU;GACR,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;GACT,MAAM;GACN,MAAM;IAAC;IAAU;IAAQ;GAAS;EACpC;EACA,OAAO;GACL,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;EACX;EACA,SAAS;GACP,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;EACX;EACA,QAAQ;GACN,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;EACX;EACA,UAAU;GACR,MAAM;GACN,aAAa;GACb,MAAM;GACN,MAAM;IAAC;IAAO;IAAQ;GAAM;EAC9B;EACA,YAAY;GACV,MAAM;GACN,aAAa;GACb,SAAS;EACX;CACF;CACA,MAAM,IAAI,EAAE,QAAQ,eAAe;EACjC,MAAM,WAAW,OAAO,UAAU,YAAY,OAAO,SAAS,WAAW,OAAO;EAChF,MAAM,YAAY,OAAO,UACrB,MAAM,GAAG,CAAC,CACX,KAAK,SAAS,KAAK,KAAK,CAAC,CAAC,CAC1B,OAAO,OAAO;EACjB,MAAM,EAAE,QAAQ,MAAM,OAAO;EAE7B,MAAM,IAAI;GACR,OAAO,YAAY;GACnB,YAAY,OAAO;GACnB;GACA,OAAO,OAAO;GACd;GACA,SAAS,OAAO;EAClB,CAAC;CACH;AACF,CAAC"}

package/dist/index.cjs

@@ -1,9 +1,8 @@
 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");
+require("./chunk-Bx3C2hgW.cjs");
+const require_define = require("./define-C4AB3POr.cjs");
+const require_Telemetry = require("./Telemetry-BG80bcoQ.cjs");
+const require_package = require("./package-aN3cIOkh.cjs");
 let node_util = require("node:util");
 //#region ../../internals/utils/src/cli/schema.ts
 /**
@@ -24,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) : []
 	};
@@ -77,6 +77,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 +138,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 +159,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);
@@ -226,7 +234,7 @@ function createCLI(options) {
 	} };
 }
 //#endregion
-//#region src/utils/flags.ts
+//#region ../../internals/utils/src/isFlag.ts
 /**
 * Type guard that confirms `value` is a member of `set`. Avoids type assertions with `Set<T extends string>`.
 */
@@ -238,23 +246,21 @@ function isFlag(set, value) {
 //#region src/index.ts
 const cli = createCLI();
 function shouldShowTelemetryNotice(argv) {
-	if (require_telemetry.isTelemetryDisabled()) return false;
-	if (argv.some((arg) => isFlag(require_constants.QUIET_FLAGS, arg))) return false;
+	if (require_Telemetry.Telemetry.isDisabled()) return false;
+	if (argv.some((arg) => isFlag(require_Telemetry.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 } = 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-BRpukupe.cjs"));
+	const { command: validateCommand } = await Promise.resolve().then(() => require("./validate-sOD68Kma.cjs"));
+	const { command: mcpCommand } = await Promise.resolve().then(() => require("./mcp-D4ZwcNDD.cjs"));
+	const { command: initCommand } = await Promise.resolve().then(() => require("./init-C156kkn3.cjs"));
 	await cli.run([
 		generateCommand,
 		validateCommand,
 		mcpCommand,
-		agentCommand,
 		initCommand
 	], argv, {
 		programName: "kubb",

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","Telemetry","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 { Telemetry } from './Telemetry.ts'\nimport { version } from '../package.json'\nimport { QUIET_FLAGS } from './constants.ts'\n\nconst cli = createCLI()\n\nfunction shouldShowTelemetryNotice(argv: Array<string>): boolean {\n  if (Telemetry.isDisabled()) {\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: initCommand } = await import('./commands/init.ts')\n\n  await cli.run([generateCommand, validateCommand, mcpCommand, initCommand], argv, {\n    programName: 'kubb',\n    defaultCommandName: 'generate',\n    version,\n  })\n}\n"],"mappings":"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"}

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,8 +1,7 @@
-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 "./chunk-C0LytTxp.js";
+import { t as defineCLIAdapter } from "./define-C63T4jp6.js";
+import { r as QUIET_FLAGS, t as Telemetry } from "./Telemetry-CyBqvgcj.js";
+import { t as version } from "./package-_PDiS5qW.js";
 import { parseArgs, styleText } from "node:util";
 //#region ../../internals/utils/src/cli/schema.ts
 /**
@@ -23,6 +22,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 +76,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 +137,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 +158,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);
@@ -225,7 +233,7 @@ function createCLI(options) {
 	} };
 }
 //#endregion
-//#region src/utils/flags.ts
+//#region ../../internals/utils/src/isFlag.ts
 /**
 * Type guard that confirms `value` is a member of `set`. Avoids type assertions with `Set<T extends string>`.
 */
@@ -237,23 +245,21 @@ function isFlag(set, value) {
 //#region src/index.ts
 const cli = createCLI();
 function shouldShowTelemetryNotice(argv) {
-	if (isTelemetryDisabled()) return false;
+	if (Telemetry.isDisabled()) 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 } = 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-XeCSLYWp.js");
+	const { command: validateCommand } = await import("./validate-DWdTJLGF.js");
+	const { command: mcpCommand } = await import("./mcp--t_K4yMF.js");
+	const { command: initCommand } = await import("./init-Djx-xXm2.js");
 	await cli.run([
 		generateCommand,
 		validateCommand,
 		mcpCommand,
-		agentCommand,
 		initCommand
 	], argv, {
 		programName: "kubb",

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","../../../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 { Telemetry } from './Telemetry.ts'\nimport { version } from '../package.json'\nimport { QUIET_FLAGS } from './constants.ts'\n\nconst cli = createCLI()\n\nfunction shouldShowTelemetryNotice(argv: Array<string>): boolean {\n  if (Telemetry.isDisabled()) {\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: initCommand } = await import('./commands/init.ts')\n\n  await cli.run([generateCommand, validateCommand, mcpCommand, initCommand], argv, {\n    programName: 'kubb',\n    defaultCommandName: 'generate',\n    version,\n  })\n}\n"],"mappings":"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"}

package/dist/init-C156kkn3.cjs

@@ -0,0 +1,53 @@
+require("./chunk-Bx3C2hgW.cjs");
+const require_define = require("./define-C4AB3POr.cjs");
+const require_package = require("./package-aN3cIOkh.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-BtjzfTz3.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-C156kkn3.cjs.map

package/dist/init-C156kkn3.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-C156kkn3.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;CACF;CACA,SAAS;EACP,KAAK;GACH,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;EACX;EACA,OAAO;GACL,MAAM;GACN,aAAa;GACb,OAAO;GACP,MAAM;EACR;EACA,QAAQ;GACN,MAAM;GACN,aAAa;GACb,OAAO;GACP,MAAM;EACR;EACA,SAAS;GACP,MAAM;GACN,aACE;GACF,MAAM;EACR;CACF;CACA,MAAM,IAAI,EAAE,UAAU;EACpB,MAAM,EAAE,QAAQ,MAAA,QAAA,QAAA,CAAA,CAAA,WAAA,QAAM,oBAAA,CAAA;EAEtB,MAAM,IAAI;GACR,KAAK,OAAO;GACZ,SAAA,gBAAA;GACA,OAAO,OAAO;GACd,QAAQ,OAAO;GACf,SAAS,OAAO;EAClB,CAAC;CACH;AACF,CAAC"}

package/dist/init-Djx-xXm2.js

@@ -0,0 +1,53 @@
+import "./chunk-C0LytTxp.js";
+import { n as defineCommand } from "./define-C63T4jp6.js";
+import { t as version } from "./package-_PDiS5qW.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-C-omuksC.js");
+		await run({
+			yes: values.yes,
+			version,
+			input: values.input,
+			output: values.output,
+			plugins: values.plugins
+		});
+	}
+});
+//#endregion
+export { command };
+
+//# sourceMappingURL=init-Djx-xXm2.js.map

package/dist/init-Djx-xXm2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-Djx-xXm2.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;CACF;CACA,SAAS;EACP,KAAK;GACH,MAAM;GACN,aAAa;GACb,OAAO;GACP,SAAS;EACX;EACA,OAAO;GACL,MAAM;GACN,aAAa;GACb,OAAO;GACP,MAAM;EACR;EACA,QAAQ;GACN,MAAM;GACN,aAAa;GACb,OAAO;GACP,MAAM;EACR;EACA,SAAS;GACP,MAAM;GACN,aACE;GACF,MAAM;EACR;CACF;CACA,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;EAClB,CAAC;CACH;AACF,CAAC"}

package/dist/mcp--t_K4yMF.js

@@ -0,0 +1,39 @@
+import "./chunk-C0LytTxp.js";
+import { n as defineCommand } from "./define-C63T4jp6.js";
+import { t as version } from "./package-_PDiS5qW.js";
+//#region src/commands/mcp.ts
+const command = defineCommand({
+	name: "mcp",
+	description: "Start a Model Context Protocol (MCP) server that exposes Kubb code generation as tools for AI assistants. Once running, configure your AI client (Claude, Cursor, Windsurf, etc.) to connect to it — the assistant can then call kubb generate directly without leaving the chat.",
+	examples: [
+		"kubb mcp",
+		"kubb mcp --port 3001",
+		"# Then add to your MCP client config:",
+		"# { \"mcpServers\": { \"kubb\": { \"command\": \"npx\", \"args\": [\"kubb\", \"mcp\"] } } }"
+	],
+	options: {
+		port: {
+			type: "string",
+			short: "p",
+			description: "Port for HTTP MCP server (omit for stdio)",
+			hint: "number"
+		},
+		host: {
+			type: "string",
+			description: "Hostname to bind to (HTTP mode only)",
+			default: "localhost"
+		}
+	},
+	async run({ values }) {
+		const { run } = await import("./run-CsBW0NRp.js");
+		await run({
+			version,
+			port: values.port,
+			host: values.host
+		});
+	}
+});
+//#endregion
+export { command };
+
+//# sourceMappingURL=mcp--t_K4yMF.js.map

package/dist/mcp--t_K4yMF.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp--t_K4yMF.js","names":[],"sources":["../src/commands/mcp.ts"],"sourcesContent":["import { defineCommand } from '@internals/utils'\nimport { version } from '../../package.json'\n\nexport const command = defineCommand({\n  name: 'mcp',\n  description:\n    'Start a Model Context Protocol (MCP) server that exposes Kubb code generation as tools for AI assistants. Once running, configure your AI client (Claude, Cursor, Windsurf, etc.) to connect to it — the assistant can then call kubb generate directly without leaving the chat.',\n  examples: [\n    'kubb mcp',\n    'kubb mcp --port 3001',\n    '# Then add to your MCP client config:',\n    '# { \"mcpServers\": { \"kubb\": { \"command\": \"npx\", \"args\": [\"kubb\", \"mcp\"] } } }',\n  ],\n  options: {\n    port: {\n      type: 'string',\n      short: 'p',\n      description: 'Port for HTTP MCP server (omit for stdio)',\n      hint: 'number',\n    },\n    host: {\n      type: 'string',\n      description: 'Hostname to bind to (HTTP mode only)',\n      default: 'localhost',\n    },\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/mcp/run.ts')\n\n    await run({\n      version,\n      port: values.port,\n      host: values.host,\n    })\n  },\n})\n"],"mappings":";;;;AAGA,MAAa,UAAU,cAAc;CACnC,MAAM;CACN,aACE;CACF,UAAU;EACR;EACA;EACA;EACA;CACF;CACA,SAAS;EACP,MAAM;GACJ,MAAM;GACN,OAAO;GACP,aAAa;GACb,MAAM;EACR;EACA,MAAM;GACJ,MAAM;GACN,aAAa;GACb,SAAS;EACX;CACF;CACA,MAAM,IAAI,EAAE,UAAU;EACpB,MAAM,EAAE,QAAQ,MAAM,OAAO;EAE7B,MAAM,IAAI;GACR;GACA,MAAM,OAAO;GACb,MAAM,OAAO;EACf,CAAC;CACH;AACF,CAAC"}