@kubb/cli 5.9.2 → 5.9.3

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["command","define","command","defineWithTypes","dryRunId","command","defineWithTypes","dryRunId","command","define","command","define","command","define","command","define","connectCommand","command","define","command","define","command","define","connectCommand","command","define","command","define","connectCommand","startCommand","loginCommand","logoutCommand","statusCommand","snapshotCommand","command","define","define","styleText","isTelemetryDisabled","styleText","cli","generateCommand","initCommand","validateCommand","mcpCommand","studioCommand","addCommand","updateCommand","listCommand","dryrun"],"sources":["../src/commands/shared.ts","../src/commands/add.ts","../src/commands/generate.ts","../src/commands/init.ts","../src/commands/list.ts","../src/commands/mcp.ts","../src/commands/studio/connect.ts","../src/commands/studio/login.ts","../src/commands/studio/logout.ts","../src/commands/studio/snapshot.ts","../src/commands/studio/background.ts","../src/commands/studio/status.ts","../src/commands/studio/index.ts","../src/commands/update.ts","../src/commands/validate.ts","../src/deprecatedFlags.ts","../src/index.ts"],"sourcesContent":["import { pluginId as dryRunId } from '@gunshi/plugin-dryrun'\nimport type { DryRunExtension } from '@gunshi/plugin-dryrun'\n\nexport { dryRunId }\n\n/** Extension shape gunshi's command context carries with `@gunshi/plugin-dryrun`; the `extensions` type parameter of `defineWithTypes`. */\nexport type DryRunExtensions = {\n  [dryRunId]: DryRunExtension\n}\n\nexport const configArg = {\n  config: {\n    type: 'string',\n    description: 'Path to the Kubb config',\n    short: 'c',\n  },\n} as const\n\nexport const yesArg = {\n  yes: {\n    type: 'boolean',\n    description: 'Skip the confirmation',\n    short: 'y',\n    default: false,\n  },\n} as const\n\nexport const logLevelArg = {\n  logLevel: {\n    type: 'enum',\n    choices: ['silent', 'info', 'verbose'] as const,\n    description: 'Info, silent or verbose',\n    short: 'l',\n    default: 'info',\n    toKebab: true,\n  },\n} as const\n\nexport const studioConnectionArgs = {\n  url: {\n    type: 'string',\n    description: 'Base URL of the Kubb Studio instance',\n  },\n  token: {\n    type: 'string',\n    description: 'Organization CI API key for `snapshot`. Defaults to KUBB_TOKEN',\n  },\n} as const\n\nexport const studioPermissionArgs = {\n  allowRead: {\n    type: 'boolean',\n    description: 'Read the source of files a generation produced. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowWrite: {\n    type: 'boolean',\n    description: 'Write generated files to disk. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowConfigEdit: {\n    type: 'boolean',\n    description: 'Let Studio change plugin options in kubb.config.ts. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowExec: {\n    type: 'boolean',\n    description: 'Run the formatter, the linter, and output.postGenerate after a generation',\n    default: false,\n    toKebab: true,\n  },\n} as const\n","import { define } from 'gunshi'\nimport { configArg, yesArg } from './shared.ts'\n\nexport const command = define({\n  name: 'add',\n  description:\n    'Install a plugin, adapter, or parser from the Kubb registry at its reviewed version. A plugin is added to kubb.config.ts, an adapter or parser prints the code to add. Reads KUBB_REGISTRY to use another registry.',\n  examples: ['kubb add plugin-zod', 'kubb add kubb-labs/plugin-react-query', 'kubb add acme/plugin-x --yes', 'kubb add plugin-zod --no-install'].join('\\n'),\n  toKebab: true,\n  args: {\n    id: {\n      type: 'positional',\n      description: 'Registry id: owner/slug, or a slug for an official extension',\n      required: true,\n    },\n    ...configArg,\n    ...yesArg,\n    install: {\n      type: 'boolean',\n      description: 'Install the package. Pass --no-install to only edit the config',\n      negatable: true,\n      default: true,\n    },\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/add/run.ts')\n    await run({ id: values.id, configPath: values.config, yes: values.yes, install: values.install })\n  },\n})\n","import { defineWithTypes } from 'gunshi'\nimport type { ReporterName } from '@kubb/core'\nimport { configArg, dryRunId, type DryRunExtensions, logLevelArg } from './shared.ts'\n\nconst REPORTER_NAMES: Array<ReporterName> = ['cli', 'json', 'file', 'html']\n\n/**\n * Splits and validates the comma-separated `--reporter` value against the known reporter names.\n */\nfunction parseReporters(value: string): Array<ReporterName> {\n  const names = value\n    .split(',')\n    .map((name) => name.trim())\n    .filter(Boolean)\n\n  for (const name of names) {\n    if (!REPORTER_NAMES.includes(name as ReporterName)) {\n      throw new Error(`must be one of cli, json, file, html (got \"${name}\")`)\n    }\n  }\n\n  return names as Array<ReporterName>\n}\n\n/**\n * Resolves the effective log level, letting the `--verbose` and `--silent` flags win over `--log-level`.\n */\nfunction resolveLogLevel({ verbose, silent, logLevel }: { verbose: boolean; silent: boolean; logLevel: string }): string {\n  if (verbose) return 'verbose'\n  if (silent) return 'silent'\n  return logLevel\n}\n\nexport const command = defineWithTypes<{ extensions: DryRunExtensions }>()({\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  examples: [\n    'kubb generate                     # generate from kubb.config.ts',\n    'kubb generate ./openapi.yaml      # generate from this spec instead of the config input',\n    'kubb generate --config kubb.config.ts',\n    'kubb generate --watch             # regenerate whenever the spec changes',\n    'kubb generate --dry-run           # preview the run without writing files',\n    'kubb generate --reporter html     # write an HTML run report',\n    'kubb studio                       # connect this project to Kubb Studio and generate from the browser',\n    'kubb studio --allow-write         # let Studio write the generated files to disk',\n    'kubb studio login                 # pair this machine with Studio without connecting',\n  ].join('\\n'),\n  toKebab: true,\n  args: {\n    input: {\n      type: 'positional',\n      required: false,\n      description: 'Path to the OpenAPI specification, overriding the config',\n    },\n    ...configArg,\n    ...logLevelArg,\n    watch: {\n      type: 'boolean',\n      description: 'Watch mode: watches an input file for changes, or polls an input URL',\n      short: 'w',\n      default: false,\n    },\n    verbose: {\n      type: 'boolean',\n      description: 'Override logLevel to verbose',\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: 'custom',\n      description: 'Reporters that render the run: cli, json, file, html. Comma-separated. Overrides config.reporters',\n      metavar: 'cli|json|file|html',\n      parse: parseReporters,\n    },\n  },\n  async run(ctx) {\n    const { values } = ctx\n    const logLevel = resolveLogLevel(values)\n    const { run } = await import('../runners/generate/run.ts')\n\n    await run({\n      input: values.input,\n      configPath: values.config,\n      logLevel,\n      watch: values.watch,\n      reporters: values.reporter,\n      dryRun: ctx.extensions[dryRunId].enabled,\n    })\n  },\n})\n","import { defineWithTypes } from 'gunshi'\nimport { dryRunId, type DryRunExtensions } from './shared.ts'\nimport { version } from '../../package.json'\n\nexport const command = defineWithTypes<{ extensions: DryRunExtensions }>()({\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-axios,plugin-react-query',\n    'kubb init --yes --dry-run',\n  ].join('\\n'),\n  toKebab: true,\n  args: {\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      metavar: 'path',\n    },\n    output: {\n      type: 'string',\n      description: 'Output directory for generated files',\n      short: 'o',\n      metavar: 'path',\n    },\n    plugins: {\n      type: 'string',\n      description: 'Comma-separated Kubb registry ids of the plugins to add, the same ids `kubb add` takes (plugin-ts, plugin-zod, acme/plugin-x)',\n      metavar: 'plugin-ts,plugin-zod,...',\n    },\n  },\n  async run(ctx) {\n    const { values } = ctx\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      dryRun: ctx.extensions[dryRunId],\n    })\n  },\n})\n","import { define } from 'gunshi'\n\nexport const command = define({\n  name: 'list',\n  description:\n    'List the installed Kubb extensions: their registry id, package, installed version, the version the Kubb registry pins, and whether an update exists.',\n  examples: 'kubb list',\n  async run() {\n    const { run } = await import('../runners/list/run.ts')\n    await run()\n  },\n})\n","import { define } from 'gunshi'\n\n/** The runner is imported when the command runs, so listing `kubb --help` never loads `@kubb/mcp`. */\nexport const command = define({\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: ['kubb mcp', '# Then add to your MCP client config:', '# { \"mcpServers\": { \"kubb\": { \"command\": \"npx\", \"args\": [\"kubb\", \"mcp\"] } } }'].join('\\n'),\n  // gunshi prints the header to stdout, which the MCP stdio transport owns.\n  rendering: { header: null },\n  async run() {\n    const { run } = await import('../runners/mcp/run.ts')\n    await run()\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs, studioPermissionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'connect',\n  description: 'Connect this project to Kubb Studio and generate from the browser.',\n  examples: [\n    'kubb studio connect',\n    'kubb studio connect --allow-read',\n    'kubb studio connect --allow-write --allow-exec',\n    'kubb studio connect --url http://localhost:3000',\n  ].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    ...studioPermissionArgs,\n    open: {\n      type: 'boolean',\n      description: 'Open the approval page in a browser while pairing',\n      default: true,\n      negatable: true,\n    },\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { connectRunner } = await import('../../runners/studio/commands.ts')\n    await connectRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { command as connectCommand } from './connect.ts'\n\nexport const command = define({\n  name: 'login',\n  description: 'Pair this machine with Kubb Studio without connecting.',\n  examples: ['kubb studio login', 'kubb studio login --url http://localhost:3000'].join('\\n'),\n  toKebab: true,\n  args: connectCommand.args,\n  async run(ctx) {\n    const { loginRunner } = await import('../../runners/studio/commands.ts')\n    await loginRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs, studioPermissionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'logout',\n  description: 'Forget the stored Kubb Studio token.',\n  examples: ['kubb studio logout'].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    ...studioPermissionArgs,\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { logoutRunner } = await import('../../runners/studio/commands.ts')\n    await logoutRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'snapshot',\n  description: 'Generate and publish a Kubb Studio snapshot from CI.',\n  examples: ['kubb studio snapshot', 'kubb studio snapshot --json'].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    id: {\n      type: 'string',\n      description: 'Stable identity for the CI agent, such as a pull request. Auto-detected on GitHub Actions, GitLab CI, Bitbucket Pipelines and CircleCI',\n    },\n    baseId: {\n      type: 'string',\n      description:\n        \"Identity of another CI agent, such as the base branch's, to also compare this snapshot with. Auto-detected on GitHub pull requests and GitLab merge requests\",\n      toKebab: true,\n    },\n    name: {\n      type: 'string',\n      description: 'Package name for the generated tarball. Defaults to the name in package.json',\n    },\n    packageVersion: {\n      type: 'string',\n      description: 'Package version for the generated tarball. Defaults to the version in package.json',\n      toKebab: true,\n    },\n    json: {\n      type: 'boolean',\n      description: 'Print the result as one JSON object instead of a summary',\n      default: false,\n    },\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { runner } = await import('../../runners/studio/snapshot.ts')\n    await runner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { command as connectCommand } from './connect.ts'\n\nexport const command = define({\n  name: 'start',\n  description: 'Keep this project connected to Kubb Studio in the background.',\n  toKebab: true,\n  args: connectCommand.args,\n  async run(ctx) {\n    const { startRunner } = await import('../../runners/studio/commands.ts')\n    await startRunner(ctx)\n  },\n})\n\nexport const stopCommand = define({\n  name: 'stop',\n  description: \"Stop this project's background connection and keep its pairing.\",\n  async run() {\n    const { stopRunner } = await import('../../runners/studio/commands.ts')\n    await stopRunner()\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs, studioPermissionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'status',\n  description: 'Show the project worker, Kubb Studio pairing, and saved permissions.',\n  examples: ['kubb studio status'].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    ...studioPermissionArgs,\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { statusRunner } = await import('../../runners/studio/commands.ts')\n    await statusRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { command as connectCommand } from './connect.ts'\nimport { command as loginCommand } from './login.ts'\nimport { command as logoutCommand } from './logout.ts'\nimport { command as snapshotCommand } from './snapshot.ts'\nimport { command as startCommand, stopCommand } from './background.ts'\nimport { command as statusCommand } from './status.ts'\n\nexport const command = define({\n  name: 'studio',\n  description: 'Connect this project to Kubb Studio, or manage its pairing and snapshots.',\n  examples: ['kubb studio', 'kubb studio --allow-read', 'kubb studio login', 'kubb studio status', 'kubb studio logout', 'kubb studio snapshot'].join('\\n'),\n  toKebab: true,\n  args: connectCommand.args,\n  async run(ctx) {\n    const { connectRunner } = await import('../../runners/studio/commands.ts')\n    await connectRunner(ctx)\n  },\n  subCommands: {\n    start: startCommand,\n    stop: stopCommand,\n    connect: connectCommand,\n    login: loginCommand,\n    logout: logoutCommand,\n    status: statusCommand,\n    snapshot: snapshotCommand,\n  },\n})\n\n/**\n * Sends `kubb studio --flag value` to `kubb studio connect`, the same runner. gunshi picks a\n * subcommand from the first token that is not a flag, so `--url http://…` would read the URL as one.\n */\nexport function routeStudioFlags(args: Array<string>): Array<string> {\n  const [name, next] = args\n  if (name !== 'studio' || !next?.startsWith('-') || next === '--help' || next === '-h') return args\n\n  return ['studio', 'connect', ...args.slice(1)]\n}\n","import { define } from 'gunshi'\nimport { yesArg } from './shared.ts'\n\nexport const command = define({\n  name: 'update',\n  description:\n    'Update installed extensions to the version the Kubb registry pins. Pass ids to update only those, or --check to list the updates without installing.',\n  examples: ['kubb update', 'kubb update --check', 'kubb update plugin-zod plugin-ts --yes'].join('\\n'),\n  args: {\n    ids: {\n      type: 'positional',\n      description: 'Registry ids to update, all installed extensions when omitted',\n      multiple: true,\n    },\n    check: {\n      type: 'boolean',\n      description: 'List the available updates without installing them',\n      default: false,\n    },\n    ...yesArg,\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/update/run.ts')\n    await run({ ids: values.ids ?? [], check: values.check, yes: values.yes })\n  },\n})\n","import { define } from 'gunshi'\n\n/** The runner is imported when the command runs, so listing `kubb --help` never loads `@kubb/adapter-oas`. */\nexport const command = define({\n  name: 'validate',\n  description:\n    'Parse and validate an OpenAPI/Swagger file for structural correctness. Reports schema errors, missing required fields, and malformed references. Use this before running generate to catch spec issues early.',\n  examples: ['kubb validate ./openapi.yaml', 'kubb validate https://petstore3.swagger.io/api/v3/openapi.json'].join('\\n'),\n  args: {\n    input: {\n      type: 'positional',\n      description: 'Path or URL to the OpenAPI/Swagger file to validate',\n      required: true,\n    },\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/validate/run.ts')\n    await run({ input: values.input })\n  },\n})\n","import { styleText } from 'node:util'\n\n/**\n * Maps each camelCase flag removed in favor of kebab-case (kubb-labs/kubb#4046) to its\n * replacement. Drop this table, and the rewrite it drives, once the deprecation window ends.\n */\nconst DEPRECATED_FLAGS: Record<string, string> = {\n  allowWrite: 'allow-write',\n  allowConfigEdit: 'allow-config-edit',\n  allowExec: 'allow-exec',\n  logLevel: 'log-level',\n  dryRun: 'dry-run',\n  packageVersion: 'package-version',\n}\n\nconst FLAG_PATTERN = /^--([a-zA-Z][\\w-]*)(=.*)?$/\n\n/**\n * Rewrites a deprecated camelCase flag to its kebab-case replacement and warns on stderr, so a\n * script written against the old flag names keeps working during the deprecation window instead\n * of failing with an unknown-option error.\n */\nexport function resolveDeprecatedFlags(args: Array<string>): Array<string> {\n  return args.map((arg) => {\n    const match = FLAG_PATTERN.exec(arg)\n    const name = match?.[1]\n    const replacement = name ? DEPRECATED_FLAGS[name] : undefined\n\n    if (!name || !replacement) {\n      return arg\n    }\n\n    console.error(\n      `${styleText('yellow', 'Warning:')} --${name} is deprecated, use --${replacement} instead. --${name} will be removed in a future major version.`,\n    )\n\n    return `--${replacement}${match?.[2] ?? ''}`\n  })\n}\n","import { styleText } from 'node:util'\nimport dryrun from '@gunshi/plugin-dryrun'\nimport { cli } from 'gunshi'\nimport { isDisabled as isTelemetryDisabled } from './Telemetry.ts'\nimport { version } from '../package.json'\nimport { command as addCommand } from './commands/add.ts'\nimport { command as generateCommand } from './commands/generate.ts'\nimport { command as initCommand } from './commands/init.ts'\nimport { command as listCommand } from './commands/list.ts'\nimport { command as mcpCommand } from './commands/mcp.ts'\nimport { command as studioCommand, routeStudioFlags } from './commands/studio/index.ts'\nimport { command as updateCommand } from './commands/update.ts'\nimport { command as validateCommand } from './commands/validate.ts'\nimport { resolveDeprecatedFlags } from './deprecatedFlags.ts'\n\n/** Flags that short-circuit execution (help and version). The telemetry notice is suppressed for these. */\nconst QUIET_FLAGS = new Set<string>(['--help', '-h', '--version', '-v', '--json'])\n\n/**\n * Entry point for the `kubb` CLI. Prints the telemetry notice unless telemetry is disabled or a\n * quiet flag is passed, then runs the given command, or `generate` when none is given.\n */\nexport async function run(argv: Array<string> = process.argv.slice(2)): Promise<void> {\n  const args = routeStudioFlags(resolveDeprecatedFlags(argv))\n  const isQuietFlag = args.some((arg) => QUIET_FLAGS.has(arg))\n\n  // stderr, so the notice never lands in a stream a client parses, such as `kubb mcp` stdio.\n  if (!isTelemetryDisabled() && !isQuietFlag) {\n    console.error(\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  // Each command's `run` imports its runner, so an optional peer (@kubb/adapter-oas, @kubb/mcp, @kubb/studio) loads only when it runs.\n  await cli(args, generateCommand, {\n    name: 'kubb',\n    version,\n    // Not `generateCommand.description`: gunshi prints this on every subcommand's help too, so\n    // `kubb studio --help` would open with a paragraph about generating types.\n    description: 'Generate code from an OpenAPI specification, manage Kubb extensions, or connect the project to Kubb Studio.',\n    subCommands: {\n      generate: generateCommand,\n      init: initCommand,\n      validate: validateCommand,\n      mcp: mcpCommand,\n      studio: studioCommand,\n      add: addCommand,\n      update: updateCommand,\n      list: listCommand,\n    },\n    fallbackToEntry: true,\n    strict: true,\n    plugins: [dryrun({ name: 'dry-run' })],\n    onErrorCommand: async (_ctx, error) => {\n      process.exitCode = 1\n      console.error(error)\n    },\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["command","define","command","defineWithTypes","dryRunId","command","defineWithTypes","dryRunId","command","define","command","define","command","define","command","define","connectCommand","command","define","command","define","command","define","connectCommand","command","define","command","define","connectCommand","startCommand","loginCommand","logoutCommand","statusCommand","snapshotCommand","command","define","define","styleText","isTelemetryDisabled","styleText","cli","generateCommand","initCommand","validateCommand","mcpCommand","studioCommand","addCommand","updateCommand","listCommand","dryrun"],"sources":["../src/commands/shared.ts","../src/commands/add.ts","../src/commands/generate.ts","../src/commands/init.ts","../src/commands/list.ts","../src/commands/mcp.ts","../src/commands/studio/connect.ts","../src/commands/studio/login.ts","../src/commands/studio/logout.ts","../src/commands/studio/snapshot.ts","../src/commands/studio/background.ts","../src/commands/studio/status.ts","../src/commands/studio/index.ts","../src/commands/update.ts","../src/commands/validate.ts","../src/deprecatedFlags.ts","../src/index.ts"],"sourcesContent":["import { pluginId as dryRunId } from '@gunshi/plugin-dryrun'\nimport type { DryRunExtension } from '@gunshi/plugin-dryrun'\n\nexport { dryRunId }\n\n/** Extension shape gunshi's command context carries with `@gunshi/plugin-dryrun`; the `extensions` type parameter of `defineWithTypes`. */\nexport type DryRunExtensions = {\n  [dryRunId]: DryRunExtension\n}\n\nexport const configArg = {\n  config: {\n    type: 'string',\n    description: 'Path to the Kubb config',\n    short: 'c',\n  },\n} as const\n\nexport const yesArg = {\n  yes: {\n    type: 'boolean',\n    description: 'Skip the confirmation',\n    short: 'y',\n    default: false,\n  },\n} as const\n\nexport const logLevelArg = {\n  logLevel: {\n    type: 'enum',\n    choices: ['silent', 'info', 'verbose'] as const,\n    description: 'Info, silent or verbose',\n    short: 'l',\n    default: 'info',\n    toKebab: true,\n  },\n} as const\n\nexport const studioConnectionArgs = {\n  url: {\n    type: 'string',\n    description: 'Base URL of the Kubb Studio instance',\n  },\n  token: {\n    type: 'string',\n    description: 'Organization CI API key for `snapshot`. Defaults to KUBB_TOKEN',\n  },\n} as const\n\nexport const studioPermissionArgs = {\n  allowRead: {\n    type: 'boolean',\n    description: 'Read the source of files a generation produced. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowWrite: {\n    type: 'boolean',\n    description: 'Write generated files to disk. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowConfigEdit: {\n    type: 'boolean',\n    description: 'Let Studio change plugin options in kubb.config.ts. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowExec: {\n    type: 'boolean',\n    description: 'Run the formatter, the linter, and output.postGenerate after a generation',\n    default: false,\n    toKebab: true,\n  },\n} as const\n","import { define } from 'gunshi'\nimport { configArg, yesArg } from './shared.ts'\n\nexport const command = define({\n  name: 'add',\n  description:\n    'Install a plugin, adapter, or parser from the Kubb registry at its reviewed version. Without an id, pick one from the registry. A plugin is added to kubb.config.ts, an adapter or parser prints the code to add. Reads KUBB_REGISTRY to use another registry.',\n  examples: [\n    'kubb add',\n    'kubb add plugin-zod',\n    'kubb add kubb-labs/plugin-react-query',\n    'kubb add acme/plugin-x --yes',\n    'kubb add plugin-zod --no-install',\n  ].join('\\n'),\n  toKebab: true,\n  args: {\n    id: {\n      type: 'positional',\n      description: 'Registry id: owner/slug, or a slug for an official extension. Asked for when omitted',\n      required: false,\n    },\n    ...configArg,\n    ...yesArg,\n    install: {\n      type: 'boolean',\n      description: 'Install the package. Pass --no-install to only edit the config',\n      negatable: true,\n      default: true,\n    },\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/add/run.ts')\n    await run({ id: values.id, configPath: values.config, yes: values.yes, install: values.install })\n  },\n})\n","import { defineWithTypes } from 'gunshi'\nimport type { ReporterName } from '@kubb/core'\nimport { configArg, dryRunId, type DryRunExtensions, logLevelArg } from './shared.ts'\n\nconst REPORTER_NAMES: Array<ReporterName> = ['cli', 'json', 'file', 'html']\n\n/**\n * Splits and validates the comma-separated `--reporter` value against the known reporter names.\n */\nfunction parseReporters(value: string): Array<ReporterName> {\n  const names = value\n    .split(',')\n    .map((name) => name.trim())\n    .filter(Boolean)\n\n  for (const name of names) {\n    if (!REPORTER_NAMES.includes(name as ReporterName)) {\n      throw new Error(`must be one of cli, json, file, html (got \"${name}\")`)\n    }\n  }\n\n  return names as Array<ReporterName>\n}\n\n/**\n * Resolves the effective log level, letting the `--verbose` and `--silent` flags win over `--log-level`.\n */\nfunction resolveLogLevel({ verbose, silent, logLevel }: { verbose: boolean; silent: boolean; logLevel: string }): string {\n  if (verbose) return 'verbose'\n  if (silent) return 'silent'\n  return logLevel\n}\n\nexport const command = defineWithTypes<{ extensions: DryRunExtensions }>()({\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  examples: [\n    'kubb generate                     # generate from kubb.config.ts',\n    'kubb generate ./openapi.yaml      # generate from this spec instead of the config input',\n    'kubb generate --config kubb.config.ts',\n    'kubb generate --watch             # regenerate whenever the spec changes',\n    'kubb generate --dry-run           # preview the run without writing files',\n    'kubb generate --reporter html     # write an HTML run report',\n    'kubb studio                       # connect this project to Kubb Studio and generate from the browser',\n    'kubb studio --allow-write         # let Studio write the generated files to disk',\n    'kubb studio login                 # pair this machine with Studio without connecting',\n  ].join('\\n'),\n  toKebab: true,\n  args: {\n    input: {\n      type: 'positional',\n      required: false,\n      description: 'Path to the OpenAPI specification, overriding the config',\n    },\n    ...configArg,\n    ...logLevelArg,\n    watch: {\n      type: 'boolean',\n      description: 'Watch mode: watches an input file for changes, or polls an input URL',\n      short: 'w',\n      default: false,\n    },\n    verbose: {\n      type: 'boolean',\n      description: 'Override logLevel to verbose',\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: 'custom',\n      description: 'Reporters that render the run: cli, json, file, html. Comma-separated. Overrides config.reporters',\n      metavar: 'cli|json|file|html',\n      parse: parseReporters,\n    },\n  },\n  async run(ctx) {\n    const { values } = ctx\n    const logLevel = resolveLogLevel(values)\n    const { run } = await import('../runners/generate/run.ts')\n\n    await run({\n      input: values.input,\n      configPath: values.config,\n      logLevel,\n      watch: values.watch,\n      reporters: values.reporter,\n      dryRun: ctx.extensions[dryRunId].enabled,\n    })\n  },\n})\n","import { defineWithTypes } from 'gunshi'\nimport { dryRunId, type DryRunExtensions } from './shared.ts'\nimport { version } from '../../package.json'\n\nexport const command = defineWithTypes<{ extensions: DryRunExtensions }>()({\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-axios,plugin-react-query',\n    'kubb init --yes --dry-run',\n  ].join('\\n'),\n  toKebab: true,\n  args: {\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      metavar: 'path',\n    },\n    output: {\n      type: 'string',\n      description: 'Output directory for generated files',\n      short: 'o',\n      metavar: 'path',\n    },\n    plugins: {\n      type: 'string',\n      description: 'Comma-separated Kubb registry ids of the plugins to add, the same ids `kubb add` takes (plugin-ts, plugin-zod, acme/plugin-x)',\n      metavar: 'plugin-ts,plugin-zod,...',\n    },\n  },\n  async run(ctx) {\n    const { values } = ctx\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      dryRun: ctx.extensions[dryRunId],\n    })\n  },\n})\n","import { define } from 'gunshi'\n\nexport const command = define({\n  name: 'list',\n  description:\n    'List the installed Kubb extensions: their registry id, package, installed version, the version the Kubb registry pins, and whether an update exists.',\n  examples: 'kubb list',\n  async run() {\n    const { run } = await import('../runners/list/run.ts')\n    await run()\n  },\n})\n","import { define } from 'gunshi'\n\n/** The runner is imported when the command runs, so listing `kubb --help` never loads `@kubb/mcp`. */\nexport const command = define({\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: ['kubb mcp', '# Then add to your MCP client config:', '# { \"mcpServers\": { \"kubb\": { \"command\": \"npx\", \"args\": [\"kubb\", \"mcp\"] } } }'].join('\\n'),\n  // gunshi prints the header to stdout, which the MCP stdio transport owns.\n  rendering: { header: null },\n  async run() {\n    const { run } = await import('../runners/mcp/run.ts')\n    await run()\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs, studioPermissionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'connect',\n  description: 'Connect this project to Kubb Studio and generate from the browser.',\n  examples: [\n    'kubb studio connect',\n    'kubb studio connect --allow-read',\n    'kubb studio connect --allow-write --allow-exec',\n    'kubb studio connect --url http://localhost:3000',\n  ].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    ...studioPermissionArgs,\n    open: {\n      type: 'boolean',\n      description: 'Open the approval page in a browser while pairing',\n      default: true,\n      negatable: true,\n    },\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { connectRunner } = await import('../../runners/studio/commands.ts')\n    await connectRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { command as connectCommand } from './connect.ts'\n\nexport const command = define({\n  name: 'login',\n  description: 'Pair this machine with Kubb Studio without connecting.',\n  examples: ['kubb studio login', 'kubb studio login --url http://localhost:3000'].join('\\n'),\n  toKebab: true,\n  args: connectCommand.args,\n  async run(ctx) {\n    const { loginRunner } = await import('../../runners/studio/commands.ts')\n    await loginRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs, studioPermissionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'logout',\n  description: 'Forget the stored Kubb Studio token.',\n  examples: ['kubb studio logout'].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    ...studioPermissionArgs,\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { logoutRunner } = await import('../../runners/studio/commands.ts')\n    await logoutRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'snapshot',\n  description: 'Generate and publish a Kubb Studio snapshot from CI.',\n  examples: ['kubb studio snapshot', 'kubb studio snapshot --json'].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    id: {\n      type: 'string',\n      description: 'Stable identity for the CI agent, such as a pull request. Auto-detected on GitHub Actions, GitLab CI, Bitbucket Pipelines and CircleCI',\n    },\n    baseId: {\n      type: 'string',\n      description:\n        \"Identity of another CI agent, such as the base branch's, to also compare this snapshot with. Auto-detected on GitHub pull requests and GitLab merge requests\",\n      toKebab: true,\n    },\n    name: {\n      type: 'string',\n      description: 'Package name for the generated tarball. Defaults to the name in package.json',\n    },\n    packageVersion: {\n      type: 'string',\n      description: 'Package version for the generated tarball. Defaults to the version in package.json',\n      toKebab: true,\n    },\n    json: {\n      type: 'boolean',\n      description: 'Print the result as one JSON object instead of a summary',\n      default: false,\n    },\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { runner } = await import('../../runners/studio/snapshot.ts')\n    await runner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { command as connectCommand } from './connect.ts'\n\nexport const command = define({\n  name: 'start',\n  description: 'Keep this project connected to Kubb Studio in the background.',\n  toKebab: true,\n  args: connectCommand.args,\n  async run(ctx) {\n    const { startRunner } = await import('../../runners/studio/commands.ts')\n    await startRunner(ctx)\n  },\n})\n\nexport const stopCommand = define({\n  name: 'stop',\n  description: \"Stop this project's background connection and keep its pairing.\",\n  async run() {\n    const { stopRunner } = await import('../../runners/studio/commands.ts')\n    await stopRunner()\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs, studioPermissionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'status',\n  description: 'Show the project worker, Kubb Studio pairing, and saved permissions.',\n  examples: ['kubb studio status'].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    ...studioPermissionArgs,\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { statusRunner } = await import('../../runners/studio/commands.ts')\n    await statusRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { command as connectCommand } from './connect.ts'\nimport { command as loginCommand } from './login.ts'\nimport { command as logoutCommand } from './logout.ts'\nimport { command as snapshotCommand } from './snapshot.ts'\nimport { command as startCommand, stopCommand } from './background.ts'\nimport { command as statusCommand } from './status.ts'\n\nexport const command = define({\n  name: 'studio',\n  description: 'Connect this project to Kubb Studio, or manage its pairing and snapshots.',\n  examples: ['kubb studio', 'kubb studio --allow-read', 'kubb studio login', 'kubb studio status', 'kubb studio logout', 'kubb studio snapshot'].join('\\n'),\n  toKebab: true,\n  args: connectCommand.args,\n  async run(ctx) {\n    const { connectRunner } = await import('../../runners/studio/commands.ts')\n    await connectRunner(ctx)\n  },\n  subCommands: {\n    start: startCommand,\n    stop: stopCommand,\n    connect: connectCommand,\n    login: loginCommand,\n    logout: logoutCommand,\n    status: statusCommand,\n    snapshot: snapshotCommand,\n  },\n})\n\n/**\n * Sends `kubb studio --flag value` to `kubb studio connect`, the same runner. gunshi picks a\n * subcommand from the first token that is not a flag, so `--url http://…` would read the URL as one.\n */\nexport function routeStudioFlags(args: Array<string>): Array<string> {\n  const [name, next] = args\n  if (name !== 'studio' || !next?.startsWith('-') || next === '--help' || next === '-h') return args\n\n  return ['studio', 'connect', ...args.slice(1)]\n}\n","import { define } from 'gunshi'\nimport { yesArg } from './shared.ts'\n\nexport const command = define({\n  name: 'update',\n  description:\n    'Update installed extensions to the version the Kubb registry pins. Pass ids to update only those, or --check to list the updates without installing.',\n  examples: ['kubb update', 'kubb update --check', 'kubb update plugin-zod plugin-ts --yes'].join('\\n'),\n  args: {\n    ids: {\n      type: 'positional',\n      description: 'Registry ids to update, all installed extensions when omitted',\n      multiple: true,\n    },\n    check: {\n      type: 'boolean',\n      description: 'List the available updates without installing them',\n      default: false,\n    },\n    ...yesArg,\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/update/run.ts')\n    await run({ ids: values.ids ?? [], check: values.check, yes: values.yes })\n  },\n})\n","import { define } from 'gunshi'\n\n/** The runner is imported when the command runs, so listing `kubb --help` never loads `@kubb/adapter-oas`. */\nexport const command = define({\n  name: 'validate',\n  description:\n    'Parse and validate an OpenAPI/Swagger file for structural correctness. Reports schema errors, missing required fields, and malformed references. Use this before running generate to catch spec issues early.',\n  examples: ['kubb validate ./openapi.yaml', 'kubb validate https://petstore3.swagger.io/api/v3/openapi.json'].join('\\n'),\n  args: {\n    input: {\n      type: 'positional',\n      description: 'Path or URL to the OpenAPI/Swagger file to validate',\n      required: true,\n    },\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/validate/run.ts')\n    await run({ input: values.input })\n  },\n})\n","import { styleText } from 'node:util'\n\n/**\n * Maps each camelCase flag removed in favor of kebab-case (kubb-labs/kubb#4046) to its\n * replacement. Drop this table, and the rewrite it drives, once the deprecation window ends.\n */\nconst DEPRECATED_FLAGS: Record<string, string> = {\n  allowWrite: 'allow-write',\n  allowConfigEdit: 'allow-config-edit',\n  allowExec: 'allow-exec',\n  logLevel: 'log-level',\n  dryRun: 'dry-run',\n  packageVersion: 'package-version',\n}\n\nconst FLAG_PATTERN = /^--([a-zA-Z][\\w-]*)(=.*)?$/\n\n/**\n * Rewrites a deprecated camelCase flag to its kebab-case replacement and warns on stderr, so a\n * script written against the old flag names keeps working during the deprecation window instead\n * of failing with an unknown-option error.\n */\nexport function resolveDeprecatedFlags(args: Array<string>): Array<string> {\n  return args.map((arg) => {\n    const match = FLAG_PATTERN.exec(arg)\n    const name = match?.[1]\n    const replacement = name ? DEPRECATED_FLAGS[name] : undefined\n\n    if (!name || !replacement) {\n      return arg\n    }\n\n    console.error(\n      `${styleText('yellow', 'Warning:')} --${name} is deprecated, use --${replacement} instead. --${name} will be removed in a future major version.`,\n    )\n\n    return `--${replacement}${match?.[2] ?? ''}`\n  })\n}\n","import { styleText } from 'node:util'\nimport dryrun from '@gunshi/plugin-dryrun'\nimport { cli } from 'gunshi'\nimport { isDisabled as isTelemetryDisabled } from './Telemetry.ts'\nimport { version } from '../package.json'\nimport { command as addCommand } from './commands/add.ts'\nimport { command as generateCommand } from './commands/generate.ts'\nimport { command as initCommand } from './commands/init.ts'\nimport { command as listCommand } from './commands/list.ts'\nimport { command as mcpCommand } from './commands/mcp.ts'\nimport { command as studioCommand, routeStudioFlags } from './commands/studio/index.ts'\nimport { command as updateCommand } from './commands/update.ts'\nimport { command as validateCommand } from './commands/validate.ts'\nimport { resolveDeprecatedFlags } from './deprecatedFlags.ts'\n\n/** Flags that short-circuit execution (help and version). The telemetry notice is suppressed for these. */\nconst QUIET_FLAGS = new Set<string>(['--help', '-h', '--version', '-v', '--json'])\n\n/**\n * Entry point for the `kubb` CLI. Prints the telemetry notice unless telemetry is disabled or a\n * quiet flag is passed, then runs the given command, or `generate` when none is given.\n */\nexport async function run(argv: Array<string> = process.argv.slice(2)): Promise<void> {\n  const args = routeStudioFlags(resolveDeprecatedFlags(argv))\n  const isQuietFlag = args.some((arg) => QUIET_FLAGS.has(arg))\n\n  // stderr, so the notice never lands in a stream a client parses, such as `kubb mcp` stdio.\n  if (!isTelemetryDisabled() && !isQuietFlag) {\n    console.error(\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  // Each command's `run` imports its runner, so an optional peer (@kubb/adapter-oas, @kubb/mcp, @kubb/studio) loads only when it runs.\n  await cli(args, generateCommand, {\n    name: 'kubb',\n    version,\n    // Not `generateCommand.description`: gunshi prints this on every subcommand's help too, so\n    // `kubb studio --help` would open with a paragraph about generating types.\n    description: 'Generate code from an OpenAPI specification, manage Kubb extensions, or connect the project to Kubb Studio.',\n    subCommands: {\n      generate: generateCommand,\n      init: initCommand,\n      validate: validateCommand,\n      mcp: mcpCommand,\n      studio: studioCommand,\n      add: addCommand,\n      update: updateCommand,\n      list: listCommand,\n    },\n    fallbackToEntry: true,\n    strict: true,\n    plugins: [dryrun({ name: 'dry-run' })],\n    onErrorCommand: async (_ctx, error) => {\n      process.exitCode = 1\n      console.error(error)\n    },\n  })\n}\n"],"mappings":"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"}

package/dist/index.js

@@ -1,5 +1,5 @@
 import "./rolldown-runtime-CRm0XQPb.js";
-import { r as version, t as isDisabled } from "./Telemetry-DER8LIO5.js";
+import { r as version, t as isDisabled } from "./Telemetry-CSc7OVsv.js";
 import { styleText } from "node:util";
 import dryrun, { pluginId as dryRunId } from "@gunshi/plugin-dryrun";
 import { cli, define, defineWithTypes } from "gunshi";
@@ -67,8 +67,9 @@ const studioPermissionArgs = {
 //#region src/commands/add.ts
 const command$13 = define({
 	name: "add",
-	description: "Install a plugin, adapter, or parser from the Kubb registry at its reviewed version. A plugin is added to kubb.config.ts, an adapter or parser prints the code to add. Reads KUBB_REGISTRY to use another registry.",
+	description: "Install a plugin, adapter, or parser from the Kubb registry at its reviewed version. Without an id, pick one from the registry. A plugin is added to kubb.config.ts, an adapter or parser prints the code to add. Reads KUBB_REGISTRY to use another registry.",
 	examples: [
+		"kubb add",
 		"kubb add plugin-zod",
 		"kubb add kubb-labs/plugin-react-query",
 		"kubb add acme/plugin-x --yes",
@@ -78,8 +79,8 @@ const command$13 = define({
 	args: {
 		id: {
 			type: "positional",
-			description: "Registry id: owner/slug, or a slug for an official extension",
-			required: true
+			description: "Registry id: owner/slug, or a slug for an official extension. Asked for when omitted",
+			required: false
 		},
 		...configArg,
 		...yesArg,
@@ -91,7 +92,7 @@ const command$13 = define({
 		}
 	},
 	async run({ values }) {
-		const { run } = await import("./run-8HrdMihy.js");
+		const { run } = await import("./run-CH48n-MJ.js");
 		await run({
 			id: values.id,
 			configPath: values.config,
@@ -174,7 +175,7 @@ const command$12 = defineWithTypes()({
 	async run(ctx) {
 		const { values } = ctx;
 		const logLevel = resolveLogLevel(values);
-		const { run } = await import("./run-BcMMYk7G.js");
+		const { run } = await import("./run-QPsBYkq_.js");
 		await run({
 			input: values.input,
 			configPath: values.config,
@@ -225,7 +226,7 @@ const command$11 = defineWithTypes()({
 	},
 	async run(ctx) {
 		const { values } = ctx;
-		const { run } = await import("./run-CJHsZZB8.js");
+		const { run } = await import("./run-BPQzGEIs.js");
 		await run({
 			yes: values.yes,
 			version,
@@ -260,7 +261,7 @@ const command$9 = define({
 	].join("\n"),
 	rendering: { header: null },
 	async run() {
-		const { run } = await import("./run-KLPSFEv-.js");
+		const { run } = await import("./run-B1jaQu6Q.js");
 		await run();
 	}
 });
@@ -289,7 +290,7 @@ const command$8 = define({
 		...logLevelArg
 	},
 	async run(ctx) {
-		const { connectRunner } = await import("./commands-BegVe5Mt.js");
+		const { connectRunner } = await import("./commands-atq2z0Bo.js");
 		await connectRunner(ctx);
 	}
 });
@@ -302,7 +303,7 @@ const command$7 = define({
 	toKebab: true,
 	args: command$8.args,
 	async run(ctx) {
-		const { loginRunner } = await import("./commands-BegVe5Mt.js");
+		const { loginRunner } = await import("./commands-atq2z0Bo.js");
 		await loginRunner(ctx);
 	}
 });
@@ -320,7 +321,7 @@ const command$6 = define({
 		...logLevelArg
 	},
 	async run(ctx) {
-		const { logoutRunner } = await import("./commands-BegVe5Mt.js");
+		const { logoutRunner } = await import("./commands-atq2z0Bo.js");
 		await logoutRunner(ctx);
 	}
 });
@@ -360,7 +361,7 @@ const command$5 = define({
 		...logLevelArg
 	},
 	async run(ctx) {
-		const { runner } = await import("./snapshot-C0WaZZiF.js");
+		const { runner } = await import("./snapshot-CkpJr-gr.js");
 		await runner(ctx);
 	}
 });
@@ -372,7 +373,7 @@ const command$4 = define({
 	toKebab: true,
 	args: command$8.args,
 	async run(ctx) {
-		const { startRunner } = await import("./commands-BegVe5Mt.js");
+		const { startRunner } = await import("./commands-atq2z0Bo.js");
 		await startRunner(ctx);
 	}
 });
@@ -380,7 +381,7 @@ const stopCommand = define({
 	name: "stop",
 	description: "Stop this project's background connection and keep its pairing.",
 	async run() {
-		const { stopRunner } = await import("./commands-BegVe5Mt.js");
+		const { stopRunner } = await import("./commands-atq2z0Bo.js");
 		await stopRunner();
 	}
 });
@@ -398,7 +399,7 @@ const command$3 = define({
 		...logLevelArg
 	},
 	async run(ctx) {
-		const { statusRunner } = await import("./commands-BegVe5Mt.js");
+		const { statusRunner } = await import("./commands-atq2z0Bo.js");
 		await statusRunner(ctx);
 	}
 });
@@ -418,7 +419,7 @@ const command$2 = define({
 	toKebab: true,
 	args: command$8.args,
 	async run(ctx) {
-		const { connectRunner } = await import("./commands-BegVe5Mt.js");
+		const { connectRunner } = await import("./commands-atq2z0Bo.js");
 		await connectRunner(ctx);
 	},
 	subCommands: {
@@ -468,7 +469,7 @@ const command$1 = define({
 		...yesArg
 	},
 	async run({ values }) {
-		const { run } = await import("./run-Dej-hm91.js");
+		const { run } = await import("./run-DxxYCqEo.js");
 		await run({
 			ids: values.ids ?? [],
 			check: values.check,
@@ -489,7 +490,7 @@ const command = define({
 		required: true
 	} },
 	async run({ values }) {
-		const { run } = await import("./run-BCswmM8Q.js");
+		const { run } = await import("./run-DunTcXOS.js");
 		await run({ input: values.input });
 	}
 });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["command","command","command","command","command","command","command","connectCommand","command","command","command","connectCommand","command","command","connectCommand","startCommand","loginCommand","logoutCommand","statusCommand","snapshotCommand","command","isTelemetryDisabled","generateCommand","initCommand","validateCommand","mcpCommand","studioCommand","addCommand","updateCommand","listCommand"],"sources":["../src/commands/shared.ts","../src/commands/add.ts","../src/commands/generate.ts","../src/commands/init.ts","../src/commands/list.ts","../src/commands/mcp.ts","../src/commands/studio/connect.ts","../src/commands/studio/login.ts","../src/commands/studio/logout.ts","../src/commands/studio/snapshot.ts","../src/commands/studio/background.ts","../src/commands/studio/status.ts","../src/commands/studio/index.ts","../src/commands/update.ts","../src/commands/validate.ts","../src/deprecatedFlags.ts","../src/index.ts"],"sourcesContent":["import { pluginId as dryRunId } from '@gunshi/plugin-dryrun'\nimport type { DryRunExtension } from '@gunshi/plugin-dryrun'\n\nexport { dryRunId }\n\n/** Extension shape gunshi's command context carries with `@gunshi/plugin-dryrun`; the `extensions` type parameter of `defineWithTypes`. */\nexport type DryRunExtensions = {\n  [dryRunId]: DryRunExtension\n}\n\nexport const configArg = {\n  config: {\n    type: 'string',\n    description: 'Path to the Kubb config',\n    short: 'c',\n  },\n} as const\n\nexport const yesArg = {\n  yes: {\n    type: 'boolean',\n    description: 'Skip the confirmation',\n    short: 'y',\n    default: false,\n  },\n} as const\n\nexport const logLevelArg = {\n  logLevel: {\n    type: 'enum',\n    choices: ['silent', 'info', 'verbose'] as const,\n    description: 'Info, silent or verbose',\n    short: 'l',\n    default: 'info',\n    toKebab: true,\n  },\n} as const\n\nexport const studioConnectionArgs = {\n  url: {\n    type: 'string',\n    description: 'Base URL of the Kubb Studio instance',\n  },\n  token: {\n    type: 'string',\n    description: 'Organization CI API key for `snapshot`. Defaults to KUBB_TOKEN',\n  },\n} as const\n\nexport const studioPermissionArgs = {\n  allowRead: {\n    type: 'boolean',\n    description: 'Read the source of files a generation produced. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowWrite: {\n    type: 'boolean',\n    description: 'Write generated files to disk. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowConfigEdit: {\n    type: 'boolean',\n    description: 'Let Studio change plugin options in kubb.config.ts. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowExec: {\n    type: 'boolean',\n    description: 'Run the formatter, the linter, and output.postGenerate after a generation',\n    default: false,\n    toKebab: true,\n  },\n} as const\n","import { define } from 'gunshi'\nimport { configArg, yesArg } from './shared.ts'\n\nexport const command = define({\n  name: 'add',\n  description:\n    'Install a plugin, adapter, or parser from the Kubb registry at its reviewed version. A plugin is added to kubb.config.ts, an adapter or parser prints the code to add. Reads KUBB_REGISTRY to use another registry.',\n  examples: ['kubb add plugin-zod', 'kubb add kubb-labs/plugin-react-query', 'kubb add acme/plugin-x --yes', 'kubb add plugin-zod --no-install'].join('\\n'),\n  toKebab: true,\n  args: {\n    id: {\n      type: 'positional',\n      description: 'Registry id: owner/slug, or a slug for an official extension',\n      required: true,\n    },\n    ...configArg,\n    ...yesArg,\n    install: {\n      type: 'boolean',\n      description: 'Install the package. Pass --no-install to only edit the config',\n      negatable: true,\n      default: true,\n    },\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/add/run.ts')\n    await run({ id: values.id, configPath: values.config, yes: values.yes, install: values.install })\n  },\n})\n","import { defineWithTypes } from 'gunshi'\nimport type { ReporterName } from '@kubb/core'\nimport { configArg, dryRunId, type DryRunExtensions, logLevelArg } from './shared.ts'\n\nconst REPORTER_NAMES: Array<ReporterName> = ['cli', 'json', 'file', 'html']\n\n/**\n * Splits and validates the comma-separated `--reporter` value against the known reporter names.\n */\nfunction parseReporters(value: string): Array<ReporterName> {\n  const names = value\n    .split(',')\n    .map((name) => name.trim())\n    .filter(Boolean)\n\n  for (const name of names) {\n    if (!REPORTER_NAMES.includes(name as ReporterName)) {\n      throw new Error(`must be one of cli, json, file, html (got \"${name}\")`)\n    }\n  }\n\n  return names as Array<ReporterName>\n}\n\n/**\n * Resolves the effective log level, letting the `--verbose` and `--silent` flags win over `--log-level`.\n */\nfunction resolveLogLevel({ verbose, silent, logLevel }: { verbose: boolean; silent: boolean; logLevel: string }): string {\n  if (verbose) return 'verbose'\n  if (silent) return 'silent'\n  return logLevel\n}\n\nexport const command = defineWithTypes<{ extensions: DryRunExtensions }>()({\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  examples: [\n    'kubb generate                     # generate from kubb.config.ts',\n    'kubb generate ./openapi.yaml      # generate from this spec instead of the config input',\n    'kubb generate --config kubb.config.ts',\n    'kubb generate --watch             # regenerate whenever the spec changes',\n    'kubb generate --dry-run           # preview the run without writing files',\n    'kubb generate --reporter html     # write an HTML run report',\n    'kubb studio                       # connect this project to Kubb Studio and generate from the browser',\n    'kubb studio --allow-write         # let Studio write the generated files to disk',\n    'kubb studio login                 # pair this machine with Studio without connecting',\n  ].join('\\n'),\n  toKebab: true,\n  args: {\n    input: {\n      type: 'positional',\n      required: false,\n      description: 'Path to the OpenAPI specification, overriding the config',\n    },\n    ...configArg,\n    ...logLevelArg,\n    watch: {\n      type: 'boolean',\n      description: 'Watch mode: watches an input file for changes, or polls an input URL',\n      short: 'w',\n      default: false,\n    },\n    verbose: {\n      type: 'boolean',\n      description: 'Override logLevel to verbose',\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: 'custom',\n      description: 'Reporters that render the run: cli, json, file, html. Comma-separated. Overrides config.reporters',\n      metavar: 'cli|json|file|html',\n      parse: parseReporters,\n    },\n  },\n  async run(ctx) {\n    const { values } = ctx\n    const logLevel = resolveLogLevel(values)\n    const { run } = await import('../runners/generate/run.ts')\n\n    await run({\n      input: values.input,\n      configPath: values.config,\n      logLevel,\n      watch: values.watch,\n      reporters: values.reporter,\n      dryRun: ctx.extensions[dryRunId].enabled,\n    })\n  },\n})\n","import { defineWithTypes } from 'gunshi'\nimport { dryRunId, type DryRunExtensions } from './shared.ts'\nimport { version } from '../../package.json'\n\nexport const command = defineWithTypes<{ extensions: DryRunExtensions }>()({\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-axios,plugin-react-query',\n    'kubb init --yes --dry-run',\n  ].join('\\n'),\n  toKebab: true,\n  args: {\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      metavar: 'path',\n    },\n    output: {\n      type: 'string',\n      description: 'Output directory for generated files',\n      short: 'o',\n      metavar: 'path',\n    },\n    plugins: {\n      type: 'string',\n      description: 'Comma-separated Kubb registry ids of the plugins to add, the same ids `kubb add` takes (plugin-ts, plugin-zod, acme/plugin-x)',\n      metavar: 'plugin-ts,plugin-zod,...',\n    },\n  },\n  async run(ctx) {\n    const { values } = ctx\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      dryRun: ctx.extensions[dryRunId],\n    })\n  },\n})\n","import { define } from 'gunshi'\n\nexport const command = define({\n  name: 'list',\n  description:\n    'List the installed Kubb extensions: their registry id, package, installed version, the version the Kubb registry pins, and whether an update exists.',\n  examples: 'kubb list',\n  async run() {\n    const { run } = await import('../runners/list/run.ts')\n    await run()\n  },\n})\n","import { define } from 'gunshi'\n\n/** The runner is imported when the command runs, so listing `kubb --help` never loads `@kubb/mcp`. */\nexport const command = define({\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: ['kubb mcp', '# Then add to your MCP client config:', '# { \"mcpServers\": { \"kubb\": { \"command\": \"npx\", \"args\": [\"kubb\", \"mcp\"] } } }'].join('\\n'),\n  // gunshi prints the header to stdout, which the MCP stdio transport owns.\n  rendering: { header: null },\n  async run() {\n    const { run } = await import('../runners/mcp/run.ts')\n    await run()\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs, studioPermissionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'connect',\n  description: 'Connect this project to Kubb Studio and generate from the browser.',\n  examples: [\n    'kubb studio connect',\n    'kubb studio connect --allow-read',\n    'kubb studio connect --allow-write --allow-exec',\n    'kubb studio connect --url http://localhost:3000',\n  ].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    ...studioPermissionArgs,\n    open: {\n      type: 'boolean',\n      description: 'Open the approval page in a browser while pairing',\n      default: true,\n      negatable: true,\n    },\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { connectRunner } = await import('../../runners/studio/commands.ts')\n    await connectRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { command as connectCommand } from './connect.ts'\n\nexport const command = define({\n  name: 'login',\n  description: 'Pair this machine with Kubb Studio without connecting.',\n  examples: ['kubb studio login', 'kubb studio login --url http://localhost:3000'].join('\\n'),\n  toKebab: true,\n  args: connectCommand.args,\n  async run(ctx) {\n    const { loginRunner } = await import('../../runners/studio/commands.ts')\n    await loginRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs, studioPermissionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'logout',\n  description: 'Forget the stored Kubb Studio token.',\n  examples: ['kubb studio logout'].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    ...studioPermissionArgs,\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { logoutRunner } = await import('../../runners/studio/commands.ts')\n    await logoutRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'snapshot',\n  description: 'Generate and publish a Kubb Studio snapshot from CI.',\n  examples: ['kubb studio snapshot', 'kubb studio snapshot --json'].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    id: {\n      type: 'string',\n      description: 'Stable identity for the CI agent, such as a pull request. Auto-detected on GitHub Actions, GitLab CI, Bitbucket Pipelines and CircleCI',\n    },\n    baseId: {\n      type: 'string',\n      description:\n        \"Identity of another CI agent, such as the base branch's, to also compare this snapshot with. Auto-detected on GitHub pull requests and GitLab merge requests\",\n      toKebab: true,\n    },\n    name: {\n      type: 'string',\n      description: 'Package name for the generated tarball. Defaults to the name in package.json',\n    },\n    packageVersion: {\n      type: 'string',\n      description: 'Package version for the generated tarball. Defaults to the version in package.json',\n      toKebab: true,\n    },\n    json: {\n      type: 'boolean',\n      description: 'Print the result as one JSON object instead of a summary',\n      default: false,\n    },\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { runner } = await import('../../runners/studio/snapshot.ts')\n    await runner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { command as connectCommand } from './connect.ts'\n\nexport const command = define({\n  name: 'start',\n  description: 'Keep this project connected to Kubb Studio in the background.',\n  toKebab: true,\n  args: connectCommand.args,\n  async run(ctx) {\n    const { startRunner } = await import('../../runners/studio/commands.ts')\n    await startRunner(ctx)\n  },\n})\n\nexport const stopCommand = define({\n  name: 'stop',\n  description: \"Stop this project's background connection and keep its pairing.\",\n  async run() {\n    const { stopRunner } = await import('../../runners/studio/commands.ts')\n    await stopRunner()\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs, studioPermissionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'status',\n  description: 'Show the project worker, Kubb Studio pairing, and saved permissions.',\n  examples: ['kubb studio status'].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    ...studioPermissionArgs,\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { statusRunner } = await import('../../runners/studio/commands.ts')\n    await statusRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { command as connectCommand } from './connect.ts'\nimport { command as loginCommand } from './login.ts'\nimport { command as logoutCommand } from './logout.ts'\nimport { command as snapshotCommand } from './snapshot.ts'\nimport { command as startCommand, stopCommand } from './background.ts'\nimport { command as statusCommand } from './status.ts'\n\nexport const command = define({\n  name: 'studio',\n  description: 'Connect this project to Kubb Studio, or manage its pairing and snapshots.',\n  examples: ['kubb studio', 'kubb studio --allow-read', 'kubb studio login', 'kubb studio status', 'kubb studio logout', 'kubb studio snapshot'].join('\\n'),\n  toKebab: true,\n  args: connectCommand.args,\n  async run(ctx) {\n    const { connectRunner } = await import('../../runners/studio/commands.ts')\n    await connectRunner(ctx)\n  },\n  subCommands: {\n    start: startCommand,\n    stop: stopCommand,\n    connect: connectCommand,\n    login: loginCommand,\n    logout: logoutCommand,\n    status: statusCommand,\n    snapshot: snapshotCommand,\n  },\n})\n\n/**\n * Sends `kubb studio --flag value` to `kubb studio connect`, the same runner. gunshi picks a\n * subcommand from the first token that is not a flag, so `--url http://…` would read the URL as one.\n */\nexport function routeStudioFlags(args: Array<string>): Array<string> {\n  const [name, next] = args\n  if (name !== 'studio' || !next?.startsWith('-') || next === '--help' || next === '-h') return args\n\n  return ['studio', 'connect', ...args.slice(1)]\n}\n","import { define } from 'gunshi'\nimport { yesArg } from './shared.ts'\n\nexport const command = define({\n  name: 'update',\n  description:\n    'Update installed extensions to the version the Kubb registry pins. Pass ids to update only those, or --check to list the updates without installing.',\n  examples: ['kubb update', 'kubb update --check', 'kubb update plugin-zod plugin-ts --yes'].join('\\n'),\n  args: {\n    ids: {\n      type: 'positional',\n      description: 'Registry ids to update, all installed extensions when omitted',\n      multiple: true,\n    },\n    check: {\n      type: 'boolean',\n      description: 'List the available updates without installing them',\n      default: false,\n    },\n    ...yesArg,\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/update/run.ts')\n    await run({ ids: values.ids ?? [], check: values.check, yes: values.yes })\n  },\n})\n","import { define } from 'gunshi'\n\n/** The runner is imported when the command runs, so listing `kubb --help` never loads `@kubb/adapter-oas`. */\nexport const command = define({\n  name: 'validate',\n  description:\n    'Parse and validate an OpenAPI/Swagger file for structural correctness. Reports schema errors, missing required fields, and malformed references. Use this before running generate to catch spec issues early.',\n  examples: ['kubb validate ./openapi.yaml', 'kubb validate https://petstore3.swagger.io/api/v3/openapi.json'].join('\\n'),\n  args: {\n    input: {\n      type: 'positional',\n      description: 'Path or URL to the OpenAPI/Swagger file to validate',\n      required: true,\n    },\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/validate/run.ts')\n    await run({ input: values.input })\n  },\n})\n","import { styleText } from 'node:util'\n\n/**\n * Maps each camelCase flag removed in favor of kebab-case (kubb-labs/kubb#4046) to its\n * replacement. Drop this table, and the rewrite it drives, once the deprecation window ends.\n */\nconst DEPRECATED_FLAGS: Record<string, string> = {\n  allowWrite: 'allow-write',\n  allowConfigEdit: 'allow-config-edit',\n  allowExec: 'allow-exec',\n  logLevel: 'log-level',\n  dryRun: 'dry-run',\n  packageVersion: 'package-version',\n}\n\nconst FLAG_PATTERN = /^--([a-zA-Z][\\w-]*)(=.*)?$/\n\n/**\n * Rewrites a deprecated camelCase flag to its kebab-case replacement and warns on stderr, so a\n * script written against the old flag names keeps working during the deprecation window instead\n * of failing with an unknown-option error.\n */\nexport function resolveDeprecatedFlags(args: Array<string>): Array<string> {\n  return args.map((arg) => {\n    const match = FLAG_PATTERN.exec(arg)\n    const name = match?.[1]\n    const replacement = name ? DEPRECATED_FLAGS[name] : undefined\n\n    if (!name || !replacement) {\n      return arg\n    }\n\n    console.error(\n      `${styleText('yellow', 'Warning:')} --${name} is deprecated, use --${replacement} instead. --${name} will be removed in a future major version.`,\n    )\n\n    return `--${replacement}${match?.[2] ?? ''}`\n  })\n}\n","import { styleText } from 'node:util'\nimport dryrun from '@gunshi/plugin-dryrun'\nimport { cli } from 'gunshi'\nimport { isDisabled as isTelemetryDisabled } from './Telemetry.ts'\nimport { version } from '../package.json'\nimport { command as addCommand } from './commands/add.ts'\nimport { command as generateCommand } from './commands/generate.ts'\nimport { command as initCommand } from './commands/init.ts'\nimport { command as listCommand } from './commands/list.ts'\nimport { command as mcpCommand } from './commands/mcp.ts'\nimport { command as studioCommand, routeStudioFlags } from './commands/studio/index.ts'\nimport { command as updateCommand } from './commands/update.ts'\nimport { command as validateCommand } from './commands/validate.ts'\nimport { resolveDeprecatedFlags } from './deprecatedFlags.ts'\n\n/** Flags that short-circuit execution (help and version). The telemetry notice is suppressed for these. */\nconst QUIET_FLAGS = new Set<string>(['--help', '-h', '--version', '-v', '--json'])\n\n/**\n * Entry point for the `kubb` CLI. Prints the telemetry notice unless telemetry is disabled or a\n * quiet flag is passed, then runs the given command, or `generate` when none is given.\n */\nexport async function run(argv: Array<string> = process.argv.slice(2)): Promise<void> {\n  const args = routeStudioFlags(resolveDeprecatedFlags(argv))\n  const isQuietFlag = args.some((arg) => QUIET_FLAGS.has(arg))\n\n  // stderr, so the notice never lands in a stream a client parses, such as `kubb mcp` stdio.\n  if (!isTelemetryDisabled() && !isQuietFlag) {\n    console.error(\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  // Each command's `run` imports its runner, so an optional peer (@kubb/adapter-oas, @kubb/mcp, @kubb/studio) loads only when it runs.\n  await cli(args, generateCommand, {\n    name: 'kubb',\n    version,\n    // Not `generateCommand.description`: gunshi prints this on every subcommand's help too, so\n    // `kubb studio --help` would open with a paragraph about generating types.\n    description: 'Generate code from an OpenAPI specification, manage Kubb extensions, or connect the project to Kubb Studio.',\n    subCommands: {\n      generate: generateCommand,\n      init: initCommand,\n      validate: validateCommand,\n      mcp: mcpCommand,\n      studio: studioCommand,\n      add: addCommand,\n      update: updateCommand,\n      list: listCommand,\n    },\n    fallbackToEntry: true,\n    strict: true,\n    plugins: [dryrun({ name: 'dry-run' })],\n    onErrorCommand: async (_ctx, error) => {\n      process.exitCode = 1\n      console.error(error)\n    },\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["command","command","command","command","command","command","command","connectCommand","command","command","command","connectCommand","command","command","connectCommand","startCommand","loginCommand","logoutCommand","statusCommand","snapshotCommand","command","isTelemetryDisabled","generateCommand","initCommand","validateCommand","mcpCommand","studioCommand","addCommand","updateCommand","listCommand"],"sources":["../src/commands/shared.ts","../src/commands/add.ts","../src/commands/generate.ts","../src/commands/init.ts","../src/commands/list.ts","../src/commands/mcp.ts","../src/commands/studio/connect.ts","../src/commands/studio/login.ts","../src/commands/studio/logout.ts","../src/commands/studio/snapshot.ts","../src/commands/studio/background.ts","../src/commands/studio/status.ts","../src/commands/studio/index.ts","../src/commands/update.ts","../src/commands/validate.ts","../src/deprecatedFlags.ts","../src/index.ts"],"sourcesContent":["import { pluginId as dryRunId } from '@gunshi/plugin-dryrun'\nimport type { DryRunExtension } from '@gunshi/plugin-dryrun'\n\nexport { dryRunId }\n\n/** Extension shape gunshi's command context carries with `@gunshi/plugin-dryrun`; the `extensions` type parameter of `defineWithTypes`. */\nexport type DryRunExtensions = {\n  [dryRunId]: DryRunExtension\n}\n\nexport const configArg = {\n  config: {\n    type: 'string',\n    description: 'Path to the Kubb config',\n    short: 'c',\n  },\n} as const\n\nexport const yesArg = {\n  yes: {\n    type: 'boolean',\n    description: 'Skip the confirmation',\n    short: 'y',\n    default: false,\n  },\n} as const\n\nexport const logLevelArg = {\n  logLevel: {\n    type: 'enum',\n    choices: ['silent', 'info', 'verbose'] as const,\n    description: 'Info, silent or verbose',\n    short: 'l',\n    default: 'info',\n    toKebab: true,\n  },\n} as const\n\nexport const studioConnectionArgs = {\n  url: {\n    type: 'string',\n    description: 'Base URL of the Kubb Studio instance',\n  },\n  token: {\n    type: 'string',\n    description: 'Organization CI API key for `snapshot`. Defaults to KUBB_TOKEN',\n  },\n} as const\n\nexport const studioPermissionArgs = {\n  allowRead: {\n    type: 'boolean',\n    description: 'Read the source of files a generation produced. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowWrite: {\n    type: 'boolean',\n    description: 'Write generated files to disk. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowConfigEdit: {\n    type: 'boolean',\n    description: 'Let Studio change plugin options in kubb.config.ts. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowExec: {\n    type: 'boolean',\n    description: 'Run the formatter, the linter, and output.postGenerate after a generation',\n    default: false,\n    toKebab: true,\n  },\n} as const\n","import { define } from 'gunshi'\nimport { configArg, yesArg } from './shared.ts'\n\nexport const command = define({\n  name: 'add',\n  description:\n    'Install a plugin, adapter, or parser from the Kubb registry at its reviewed version. Without an id, pick one from the registry. A plugin is added to kubb.config.ts, an adapter or parser prints the code to add. Reads KUBB_REGISTRY to use another registry.',\n  examples: [\n    'kubb add',\n    'kubb add plugin-zod',\n    'kubb add kubb-labs/plugin-react-query',\n    'kubb add acme/plugin-x --yes',\n    'kubb add plugin-zod --no-install',\n  ].join('\\n'),\n  toKebab: true,\n  args: {\n    id: {\n      type: 'positional',\n      description: 'Registry id: owner/slug, or a slug for an official extension. Asked for when omitted',\n      required: false,\n    },\n    ...configArg,\n    ...yesArg,\n    install: {\n      type: 'boolean',\n      description: 'Install the package. Pass --no-install to only edit the config',\n      negatable: true,\n      default: true,\n    },\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/add/run.ts')\n    await run({ id: values.id, configPath: values.config, yes: values.yes, install: values.install })\n  },\n})\n","import { defineWithTypes } from 'gunshi'\nimport type { ReporterName } from '@kubb/core'\nimport { configArg, dryRunId, type DryRunExtensions, logLevelArg } from './shared.ts'\n\nconst REPORTER_NAMES: Array<ReporterName> = ['cli', 'json', 'file', 'html']\n\n/**\n * Splits and validates the comma-separated `--reporter` value against the known reporter names.\n */\nfunction parseReporters(value: string): Array<ReporterName> {\n  const names = value\n    .split(',')\n    .map((name) => name.trim())\n    .filter(Boolean)\n\n  for (const name of names) {\n    if (!REPORTER_NAMES.includes(name as ReporterName)) {\n      throw new Error(`must be one of cli, json, file, html (got \"${name}\")`)\n    }\n  }\n\n  return names as Array<ReporterName>\n}\n\n/**\n * Resolves the effective log level, letting the `--verbose` and `--silent` flags win over `--log-level`.\n */\nfunction resolveLogLevel({ verbose, silent, logLevel }: { verbose: boolean; silent: boolean; logLevel: string }): string {\n  if (verbose) return 'verbose'\n  if (silent) return 'silent'\n  return logLevel\n}\n\nexport const command = defineWithTypes<{ extensions: DryRunExtensions }>()({\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  examples: [\n    'kubb generate                     # generate from kubb.config.ts',\n    'kubb generate ./openapi.yaml      # generate from this spec instead of the config input',\n    'kubb generate --config kubb.config.ts',\n    'kubb generate --watch             # regenerate whenever the spec changes',\n    'kubb generate --dry-run           # preview the run without writing files',\n    'kubb generate --reporter html     # write an HTML run report',\n    'kubb studio                       # connect this project to Kubb Studio and generate from the browser',\n    'kubb studio --allow-write         # let Studio write the generated files to disk',\n    'kubb studio login                 # pair this machine with Studio without connecting',\n  ].join('\\n'),\n  toKebab: true,\n  args: {\n    input: {\n      type: 'positional',\n      required: false,\n      description: 'Path to the OpenAPI specification, overriding the config',\n    },\n    ...configArg,\n    ...logLevelArg,\n    watch: {\n      type: 'boolean',\n      description: 'Watch mode: watches an input file for changes, or polls an input URL',\n      short: 'w',\n      default: false,\n    },\n    verbose: {\n      type: 'boolean',\n      description: 'Override logLevel to verbose',\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: 'custom',\n      description: 'Reporters that render the run: cli, json, file, html. Comma-separated. Overrides config.reporters',\n      metavar: 'cli|json|file|html',\n      parse: parseReporters,\n    },\n  },\n  async run(ctx) {\n    const { values } = ctx\n    const logLevel = resolveLogLevel(values)\n    const { run } = await import('../runners/generate/run.ts')\n\n    await run({\n      input: values.input,\n      configPath: values.config,\n      logLevel,\n      watch: values.watch,\n      reporters: values.reporter,\n      dryRun: ctx.extensions[dryRunId].enabled,\n    })\n  },\n})\n","import { defineWithTypes } from 'gunshi'\nimport { dryRunId, type DryRunExtensions } from './shared.ts'\nimport { version } from '../../package.json'\n\nexport const command = defineWithTypes<{ extensions: DryRunExtensions }>()({\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-axios,plugin-react-query',\n    'kubb init --yes --dry-run',\n  ].join('\\n'),\n  toKebab: true,\n  args: {\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      metavar: 'path',\n    },\n    output: {\n      type: 'string',\n      description: 'Output directory for generated files',\n      short: 'o',\n      metavar: 'path',\n    },\n    plugins: {\n      type: 'string',\n      description: 'Comma-separated Kubb registry ids of the plugins to add, the same ids `kubb add` takes (plugin-ts, plugin-zod, acme/plugin-x)',\n      metavar: 'plugin-ts,plugin-zod,...',\n    },\n  },\n  async run(ctx) {\n    const { values } = ctx\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      dryRun: ctx.extensions[dryRunId],\n    })\n  },\n})\n","import { define } from 'gunshi'\n\nexport const command = define({\n  name: 'list',\n  description:\n    'List the installed Kubb extensions: their registry id, package, installed version, the version the Kubb registry pins, and whether an update exists.',\n  examples: 'kubb list',\n  async run() {\n    const { run } = await import('../runners/list/run.ts')\n    await run()\n  },\n})\n","import { define } from 'gunshi'\n\n/** The runner is imported when the command runs, so listing `kubb --help` never loads `@kubb/mcp`. */\nexport const command = define({\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: ['kubb mcp', '# Then add to your MCP client config:', '# { \"mcpServers\": { \"kubb\": { \"command\": \"npx\", \"args\": [\"kubb\", \"mcp\"] } } }'].join('\\n'),\n  // gunshi prints the header to stdout, which the MCP stdio transport owns.\n  rendering: { header: null },\n  async run() {\n    const { run } = await import('../runners/mcp/run.ts')\n    await run()\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs, studioPermissionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'connect',\n  description: 'Connect this project to Kubb Studio and generate from the browser.',\n  examples: [\n    'kubb studio connect',\n    'kubb studio connect --allow-read',\n    'kubb studio connect --allow-write --allow-exec',\n    'kubb studio connect --url http://localhost:3000',\n  ].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    ...studioPermissionArgs,\n    open: {\n      type: 'boolean',\n      description: 'Open the approval page in a browser while pairing',\n      default: true,\n      negatable: true,\n    },\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { connectRunner } = await import('../../runners/studio/commands.ts')\n    await connectRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { command as connectCommand } from './connect.ts'\n\nexport const command = define({\n  name: 'login',\n  description: 'Pair this machine with Kubb Studio without connecting.',\n  examples: ['kubb studio login', 'kubb studio login --url http://localhost:3000'].join('\\n'),\n  toKebab: true,\n  args: connectCommand.args,\n  async run(ctx) {\n    const { loginRunner } = await import('../../runners/studio/commands.ts')\n    await loginRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs, studioPermissionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'logout',\n  description: 'Forget the stored Kubb Studio token.',\n  examples: ['kubb studio logout'].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    ...studioPermissionArgs,\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { logoutRunner } = await import('../../runners/studio/commands.ts')\n    await logoutRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'snapshot',\n  description: 'Generate and publish a Kubb Studio snapshot from CI.',\n  examples: ['kubb studio snapshot', 'kubb studio snapshot --json'].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    id: {\n      type: 'string',\n      description: 'Stable identity for the CI agent, such as a pull request. Auto-detected on GitHub Actions, GitLab CI, Bitbucket Pipelines and CircleCI',\n    },\n    baseId: {\n      type: 'string',\n      description:\n        \"Identity of another CI agent, such as the base branch's, to also compare this snapshot with. Auto-detected on GitHub pull requests and GitLab merge requests\",\n      toKebab: true,\n    },\n    name: {\n      type: 'string',\n      description: 'Package name for the generated tarball. Defaults to the name in package.json',\n    },\n    packageVersion: {\n      type: 'string',\n      description: 'Package version for the generated tarball. Defaults to the version in package.json',\n      toKebab: true,\n    },\n    json: {\n      type: 'boolean',\n      description: 'Print the result as one JSON object instead of a summary',\n      default: false,\n    },\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { runner } = await import('../../runners/studio/snapshot.ts')\n    await runner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { command as connectCommand } from './connect.ts'\n\nexport const command = define({\n  name: 'start',\n  description: 'Keep this project connected to Kubb Studio in the background.',\n  toKebab: true,\n  args: connectCommand.args,\n  async run(ctx) {\n    const { startRunner } = await import('../../runners/studio/commands.ts')\n    await startRunner(ctx)\n  },\n})\n\nexport const stopCommand = define({\n  name: 'stop',\n  description: \"Stop this project's background connection and keep its pairing.\",\n  async run() {\n    const { stopRunner } = await import('../../runners/studio/commands.ts')\n    await stopRunner()\n  },\n})\n","import { define } from 'gunshi'\nimport { configArg, logLevelArg, studioConnectionArgs, studioPermissionArgs } from '../shared.ts'\n\nexport const command = define({\n  name: 'status',\n  description: 'Show the project worker, Kubb Studio pairing, and saved permissions.',\n  examples: ['kubb studio status'].join('\\n'),\n  toKebab: true,\n  args: {\n    ...configArg,\n    ...studioConnectionArgs,\n    ...studioPermissionArgs,\n    ...logLevelArg,\n  },\n  async run(ctx) {\n    const { statusRunner } = await import('../../runners/studio/commands.ts')\n    await statusRunner(ctx)\n  },\n})\n","import { define } from 'gunshi'\nimport { command as connectCommand } from './connect.ts'\nimport { command as loginCommand } from './login.ts'\nimport { command as logoutCommand } from './logout.ts'\nimport { command as snapshotCommand } from './snapshot.ts'\nimport { command as startCommand, stopCommand } from './background.ts'\nimport { command as statusCommand } from './status.ts'\n\nexport const command = define({\n  name: 'studio',\n  description: 'Connect this project to Kubb Studio, or manage its pairing and snapshots.',\n  examples: ['kubb studio', 'kubb studio --allow-read', 'kubb studio login', 'kubb studio status', 'kubb studio logout', 'kubb studio snapshot'].join('\\n'),\n  toKebab: true,\n  args: connectCommand.args,\n  async run(ctx) {\n    const { connectRunner } = await import('../../runners/studio/commands.ts')\n    await connectRunner(ctx)\n  },\n  subCommands: {\n    start: startCommand,\n    stop: stopCommand,\n    connect: connectCommand,\n    login: loginCommand,\n    logout: logoutCommand,\n    status: statusCommand,\n    snapshot: snapshotCommand,\n  },\n})\n\n/**\n * Sends `kubb studio --flag value` to `kubb studio connect`, the same runner. gunshi picks a\n * subcommand from the first token that is not a flag, so `--url http://…` would read the URL as one.\n */\nexport function routeStudioFlags(args: Array<string>): Array<string> {\n  const [name, next] = args\n  if (name !== 'studio' || !next?.startsWith('-') || next === '--help' || next === '-h') return args\n\n  return ['studio', 'connect', ...args.slice(1)]\n}\n","import { define } from 'gunshi'\nimport { yesArg } from './shared.ts'\n\nexport const command = define({\n  name: 'update',\n  description:\n    'Update installed extensions to the version the Kubb registry pins. Pass ids to update only those, or --check to list the updates without installing.',\n  examples: ['kubb update', 'kubb update --check', 'kubb update plugin-zod plugin-ts --yes'].join('\\n'),\n  args: {\n    ids: {\n      type: 'positional',\n      description: 'Registry ids to update, all installed extensions when omitted',\n      multiple: true,\n    },\n    check: {\n      type: 'boolean',\n      description: 'List the available updates without installing them',\n      default: false,\n    },\n    ...yesArg,\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/update/run.ts')\n    await run({ ids: values.ids ?? [], check: values.check, yes: values.yes })\n  },\n})\n","import { define } from 'gunshi'\n\n/** The runner is imported when the command runs, so listing `kubb --help` never loads `@kubb/adapter-oas`. */\nexport const command = define({\n  name: 'validate',\n  description:\n    'Parse and validate an OpenAPI/Swagger file for structural correctness. Reports schema errors, missing required fields, and malformed references. Use this before running generate to catch spec issues early.',\n  examples: ['kubb validate ./openapi.yaml', 'kubb validate https://petstore3.swagger.io/api/v3/openapi.json'].join('\\n'),\n  args: {\n    input: {\n      type: 'positional',\n      description: 'Path or URL to the OpenAPI/Swagger file to validate',\n      required: true,\n    },\n  },\n  async run({ values }) {\n    const { run } = await import('../runners/validate/run.ts')\n    await run({ input: values.input })\n  },\n})\n","import { styleText } from 'node:util'\n\n/**\n * Maps each camelCase flag removed in favor of kebab-case (kubb-labs/kubb#4046) to its\n * replacement. Drop this table, and the rewrite it drives, once the deprecation window ends.\n */\nconst DEPRECATED_FLAGS: Record<string, string> = {\n  allowWrite: 'allow-write',\n  allowConfigEdit: 'allow-config-edit',\n  allowExec: 'allow-exec',\n  logLevel: 'log-level',\n  dryRun: 'dry-run',\n  packageVersion: 'package-version',\n}\n\nconst FLAG_PATTERN = /^--([a-zA-Z][\\w-]*)(=.*)?$/\n\n/**\n * Rewrites a deprecated camelCase flag to its kebab-case replacement and warns on stderr, so a\n * script written against the old flag names keeps working during the deprecation window instead\n * of failing with an unknown-option error.\n */\nexport function resolveDeprecatedFlags(args: Array<string>): Array<string> {\n  return args.map((arg) => {\n    const match = FLAG_PATTERN.exec(arg)\n    const name = match?.[1]\n    const replacement = name ? DEPRECATED_FLAGS[name] : undefined\n\n    if (!name || !replacement) {\n      return arg\n    }\n\n    console.error(\n      `${styleText('yellow', 'Warning:')} --${name} is deprecated, use --${replacement} instead. --${name} will be removed in a future major version.`,\n    )\n\n    return `--${replacement}${match?.[2] ?? ''}`\n  })\n}\n","import { styleText } from 'node:util'\nimport dryrun from '@gunshi/plugin-dryrun'\nimport { cli } from 'gunshi'\nimport { isDisabled as isTelemetryDisabled } from './Telemetry.ts'\nimport { version } from '../package.json'\nimport { command as addCommand } from './commands/add.ts'\nimport { command as generateCommand } from './commands/generate.ts'\nimport { command as initCommand } from './commands/init.ts'\nimport { command as listCommand } from './commands/list.ts'\nimport { command as mcpCommand } from './commands/mcp.ts'\nimport { command as studioCommand, routeStudioFlags } from './commands/studio/index.ts'\nimport { command as updateCommand } from './commands/update.ts'\nimport { command as validateCommand } from './commands/validate.ts'\nimport { resolveDeprecatedFlags } from './deprecatedFlags.ts'\n\n/** Flags that short-circuit execution (help and version). The telemetry notice is suppressed for these. */\nconst QUIET_FLAGS = new Set<string>(['--help', '-h', '--version', '-v', '--json'])\n\n/**\n * Entry point for the `kubb` CLI. Prints the telemetry notice unless telemetry is disabled or a\n * quiet flag is passed, then runs the given command, or `generate` when none is given.\n */\nexport async function run(argv: Array<string> = process.argv.slice(2)): Promise<void> {\n  const args = routeStudioFlags(resolveDeprecatedFlags(argv))\n  const isQuietFlag = args.some((arg) => QUIET_FLAGS.has(arg))\n\n  // stderr, so the notice never lands in a stream a client parses, such as `kubb mcp` stdio.\n  if (!isTelemetryDisabled() && !isQuietFlag) {\n    console.error(\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  // Each command's `run` imports its runner, so an optional peer (@kubb/adapter-oas, @kubb/mcp, @kubb/studio) loads only when it runs.\n  await cli(args, generateCommand, {\n    name: 'kubb',\n    version,\n    // Not `generateCommand.description`: gunshi prints this on every subcommand's help too, so\n    // `kubb studio --help` would open with a paragraph about generating types.\n    description: 'Generate code from an OpenAPI specification, manage Kubb extensions, or connect the project to Kubb Studio.',\n    subCommands: {\n      generate: generateCommand,\n      init: initCommand,\n      validate: validateCommand,\n      mcp: mcpCommand,\n      studio: studioCommand,\n      add: addCommand,\n      update: updateCommand,\n      list: listCommand,\n    },\n    fallbackToEntry: true,\n    strict: true,\n    plugins: [dryrun({ name: 'dry-run' })],\n    onErrorCommand: async (_ctx, error) => {\n      process.exitCode = 1\n      console.error(error)\n    },\n  })\n}\n"],"mappings":"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"}

package/dist/{run-KLPSFEv-.js → run-B1jaQu6Q.js}

@@ -1,6 +1,6 @@
 import "./rolldown-runtime-CRm0XQPb.js";
 import { n as toError } from "./errors-DmC83ALX.js";
-import { n as trackRun } from "./Telemetry-DER8LIO5.js";
+import { n as trackRun } from "./Telemetry-CSc7OVsv.js";
 import { styleText } from "node:util";
 import process from "node:process";
 //#region src/runners/mcp/run.ts
@@ -27,4 +27,4 @@ async function run() {
 //#endregion
 export { run };
 
-//# sourceMappingURL=run-KLPSFEv-.js.map
+//# sourceMappingURL=run-B1jaQu6Q.js.map

package/dist/{run-KLPSFEv-.js.map → run-B1jaQu6Q.js.map}

@@ -1 +1 @@
-{"version":3,"file":"run-KLPSFEv-.js","names":[],"sources":["../src/runners/mcp/run.ts"],"sourcesContent":["import process from 'node:process'\nimport { styleText } from 'node:util'\nimport { toError } from '@internals/utils'\nimport type * as McpModule from '@kubb/mcp'\nimport { trackRun } from '../../Telemetry.ts'\n\n/**\n * Starts the `@kubb/mcp` server over stdio and reports the outcome to telemetry.\n */\nexport async function run(): Promise<void> {\n  const { run: startMcpServer } = (await import('@kubb/mcp')) as typeof McpModule\n\n  const report = trackRun({ command: 'mcp', hrStart: process.hrtime() })\n\n  try {\n    // The MCP stdio transport owns stdout: anything else written there corrupts the JSON-RPC stream.\n    console.error(styleText('cyan', '⏳ Starting MCP server...'))\n    console.warn(styleText('yellow', 'This feature is still under development, use with caution'))\n    await startMcpServer()\n    await report({ status: 'success' })\n  } catch (error) {\n    await report({ status: 'failed' })\n    console.error(toError(error).message)\n    process.exitCode = 1\n  }\n}\n"],"mappings":";;;;;;;;;AASA,eAAsB,MAAqB;CACzC,MAAM,EAAE,KAAK,mBAAoB,MAAM,OAAO;CAE9C,MAAM,SAAS,SAAS;EAAE,SAAS;EAAO,SAAS,QAAQ,OAAO;CAAE,CAAC;CAErE,IAAI;EAEF,QAAQ,MAAM,UAAU,QAAQ,0BAA0B,CAAC;EAC3D,QAAQ,KAAK,UAAU,UAAU,2DAA2D,CAAC;EAC7F,MAAM,eAAe;EACrB,MAAM,OAAO,EAAE,QAAQ,UAAU,CAAC;CACpC,SAAS,OAAO;EACd,MAAM,OAAO,EAAE,QAAQ,SAAS,CAAC;EACjC,QAAQ,MAAM,QAAQ,KAAK,CAAC,CAAC,OAAO;EACpC,QAAQ,WAAW;CACrB;AACF"}
+{"version":3,"file":"run-B1jaQu6Q.js","names":[],"sources":["../src/runners/mcp/run.ts"],"sourcesContent":["import process from 'node:process'\nimport { styleText } from 'node:util'\nimport { toError } from '@internals/utils'\nimport type * as McpModule from '@kubb/mcp'\nimport { trackRun } from '../../Telemetry.ts'\n\n/**\n * Starts the `@kubb/mcp` server over stdio and reports the outcome to telemetry.\n */\nexport async function run(): Promise<void> {\n  const { run: startMcpServer } = (await import('@kubb/mcp')) as typeof McpModule\n\n  const report = trackRun({ command: 'mcp', hrStart: process.hrtime() })\n\n  try {\n    // The MCP stdio transport owns stdout: anything else written there corrupts the JSON-RPC stream.\n    console.error(styleText('cyan', '⏳ Starting MCP server...'))\n    console.warn(styleText('yellow', 'This feature is still under development, use with caution'))\n    await startMcpServer()\n    await report({ status: 'success' })\n  } catch (error) {\n    await report({ status: 'failed' })\n    console.error(toError(error).message)\n    process.exitCode = 1\n  }\n}\n"],"mappings":";;;;;;;;;AASA,eAAsB,MAAqB;CACzC,MAAM,EAAE,KAAK,mBAAoB,MAAM,OAAO;CAE9C,MAAM,SAAS,SAAS;EAAE,SAAS;EAAO,SAAS,QAAQ,OAAO;CAAE,CAAC;CAErE,IAAI;EAEF,QAAQ,MAAM,UAAU,QAAQ,0BAA0B,CAAC;EAC3D,QAAQ,KAAK,UAAU,UAAU,2DAA2D,CAAC;EAC7F,MAAM,eAAe;EACrB,MAAM,OAAO,EAAE,QAAQ,UAAU,CAAC;CACpC,SAAS,OAAO;EACd,MAAM,OAAO,EAAE,QAAQ,SAAS,CAAC;EACjC,QAAQ,MAAM,QAAQ,KAAK,CAAC,CAAC,OAAO;EACpC,QAAQ,WAAW;CACrB;AACF"}

package/dist/{run-Ct6kzKpg.cjs → run-BGTUbY2h.cjs}

@@ -48,17 +48,38 @@ async function addToConfig({ detail, configFile }) {
 		return require_errors.getErrorMessage(error);
 	}
 }
+async function selectExtension(registry) {
+	const options = (await require_registry.fetchRegistryIndex({ registry })).toSorted((a, b) => a.id.localeCompare(b.id)).map((entry) => ({
+		value: entry.id,
+		label: entry.manifest.displayName,
+		hint: `${entry.id} · ${entry.kind} ${entry.artifact.version} · ${entry.manifest.description}`
+	}));
+	if (!options.length) throw new Error(`The registry at ${registry} lists no extensions.`);
+	const id = await _clack_prompts.autocomplete({
+		message: "Select an extension to add:",
+		options,
+		filter: (search, option) => `${option.label} ${option.hint}`.toLowerCase().includes(search.toLowerCase())
+	});
+	return _clack_prompts.isCancel(id) ? void 0 : id;
+}
 /**
 * Installs an extension from the Kubb registry at its reviewed version and, for a plugin, adds it to
-* `kubb.config.ts`. Refuses when the running Kubb or Node.js version is outside its compatibility.
+* `kubb.config.ts`. Without an id, asks which one. Refuses when the running Kubb or Node.js version
+* is outside its compatibility.
 */
 async function run({ id: input, configPath, yes, install }) {
 	const cwd = node_process.default.cwd();
 	require_output.logIntro({ title: (0, node_util.styleText)("bgCyan", (0, node_util.styleText)("black", " Kubb Add ")) });
 	try {
 		const registry = require_registry.registryUrl();
+		if (!input && yes) throw new Error("Pass a registry id, such as plugin-zod, when using --yes.");
+		const id = input ? require_registry.toRegistryId(input) : await selectExtension(registry);
+		if (!id) {
+			_clack_prompts.cancel("Operation canceled.");
+			return;
+		}
 		const detail = await require_registry.fetchRegistryDetail({
-			id: require_registry.toRegistryId(input),
+			id,
 			registry
 		});
 		const { artifact, manifest } = detail;
@@ -106,4 +127,4 @@ async function run({ id: input, configPath, yes, install }) {
 exports.addToConfig = addToConfig;
 exports.run = run;
 
-//# sourceMappingURL=run-Ct6kzKpg.cjs.map
+//# sourceMappingURL=run-BGTUbY2h.cjs.map

package/dist/run-BGTUbY2h.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-BGTUbY2h.cjs","names":["getErrorMessage","fetchRegistryIndex","clack","process","styleText","registryUrl","toRegistryId","fetchRegistryDetail","incompatibility","installSpec","path","findConfigFile","detectPackageManager","installPackages"],"sources":["../src/runners/add/run.ts"],"sourcesContent":["import path from 'node:path'\nimport process from 'node:process'\nimport { styleText } from 'node:util'\nimport * as clack from '@clack/prompts'\nimport { getErrorMessage } from '@internals/utils'\nimport type { ExtensionManifest, RegistryDetail } from '@kubb/core'\nimport { findConfigFile } from '../../config.ts'\nimport { logBlock, logError, logInfo, logIntro, logOutro, logStep, logWarn } from '../../loggers/output.ts'\nimport { fetchRegistryDetail, fetchRegistryIndex, incompatibility, installSpec, registryUrl, toRegistryId } from '../../utils/registry.ts'\nimport { detectPackageManager, installPackages } from '../init/utils.ts'\n\nexport type AddOptions = {\n  /**\n   * `owner/slug`, or a bare `slug` for an official extension. Asked for when omitted.\n   */\n  id?: string\n  configPath?: string\n  yes: boolean\n  install: boolean\n}\n\n/** The import and the `defineConfig` property to merge into `kubb.config.ts` by hand. */\nexport function toSnippet({ artifact, manifest }: Pick<RegistryDetail, 'artifact' | 'manifest'>): string {\n  const call = `${manifest.export}()`\n  const property: Record<ExtensionManifest['kind'], string> = {\n    plugin: `plugins: [..., ${call}],`,\n    adapter: `adapter: ${call},`,\n    parser: `parsers: [..., ${call}],`,\n  }\n  return [`import { ${manifest.export} } from '${artifact.package}'`, '', property[manifest.kind]].join('\\n')\n}\n\n/** Adds the plugin call and its import to the config file. Returns why it could not, or `undefined`. */\nexport async function addToConfig({\n  detail,\n  configFile,\n}: {\n  detail: Pick<RegistryDetail, 'artifact' | 'manifest'>\n  configFile: string\n}): Promise<string | undefined> {\n  const { artifact, manifest } = detail\n  try {\n    const { writeConfigEdits } = await import('@kubb/studio')\n    const { outcomes } = await writeConfigEdits({\n      filePath: configFile,\n      edits: [{ operation: 'add-plugin', plugin: artifact.package }],\n      extensions: new Map([[artifact.package, { package: artifact.package, version: artifact.version, manifest }]]),\n    })\n    return outcomes[0]?.applied ? undefined : (outcomes[0]?.reason ?? 'the config file was not changed')\n  } catch (error) {\n    return getErrorMessage(error)\n  }\n}\n\nasync function selectExtension(registry: string): Promise<string | undefined> {\n  const entries = await fetchRegistryIndex({ registry })\n  const options = entries\n    .toSorted((a, b) => a.id.localeCompare(b.id))\n    .map((entry) => ({\n      value: entry.id,\n      label: entry.manifest.displayName,\n      hint: `${entry.id} · ${entry.kind} ${entry.artifact.version} · ${entry.manifest.description}`,\n    }))\n  if (!options.length) throw new Error(`The registry at ${registry} lists no extensions.`)\n\n  const id = await clack.autocomplete({\n    message: 'Select an extension to add:',\n    options,\n    filter: (search, option) => `${option.label} ${option.hint}`.toLowerCase().includes(search.toLowerCase()),\n  })\n  return clack.isCancel(id) ? undefined : id\n}\n\n/**\n * Installs an extension from the Kubb registry at its reviewed version and, for a plugin, adds it to\n * `kubb.config.ts`. Without an id, asks which one. Refuses when the running Kubb or Node.js version\n * is outside its compatibility.\n */\nexport async function run({ id: input, configPath, yes, install }: AddOptions): Promise<void> {\n  const cwd = process.cwd()\n  logIntro({ title: styleText('bgCyan', styleText('black', ' Kubb Add ')) })\n\n  try {\n    const registry = registryUrl()\n    if (!input && yes) throw new Error('Pass a registry id, such as plugin-zod, when using --yes.')\n    const id = input ? toRegistryId(input) : await selectExtension(registry)\n    if (!id) {\n      clack.cancel('Operation canceled.')\n      return\n    }\n    const detail = await fetchRegistryDetail({ id, registry })\n    const { artifact, manifest } = detail\n\n    const problem = incompatibility(manifest)\n    if (problem) throw new Error(problem)\n\n    const spec = installSpec(artifact)\n    const configFile = manifest.kind === 'plugin' ? (configPath ? path.resolve(configPath) : findConfigFile(cwd)) : undefined\n    if (manifest.kind === 'plugin' && !configFile) throw new Error('No kubb.config.ts found. Run `kubb init` first, or pass --config.')\n\n    logInfo(`${styleText('cyan', manifest.displayName)} (${manifest.kind}): ${manifest.description}`)\n    logBlock([\n      install ? `Install ${styleText('cyan', spec)} as a dev dependency` : `Skip installing ${spec}`,\n      configFile\n        ? `Add ${styleText('cyan', `${manifest.export}()`)} to ${path.relative(cwd, configFile) || configFile}`\n        : `Print the ${manifest.kind} snippet to add`,\n    ])\n\n    const confirmed = yes || (await clack.confirm({ message: 'Continue?', initialValue: true }))\n    if (clack.isCancel(confirmed) || !confirmed) {\n      clack.cancel('Operation canceled.')\n      return\n    }\n\n    if (install) {\n      const packageManager = detectPackageManager(cwd)\n      logStep(`Installing ${spec} with ${packageManager.name}`)\n      await installPackages([spec], packageManager, cwd)\n    }\n\n    const reason = configFile ? await addToConfig({ detail, configFile }) : `add the ${manifest.kind} to your config`\n    if (!reason) {\n      logOutro(styleText('green', install ? `Added ${spec}` : `Added ${manifest.export}() to the config. Install ${spec} to use it.`))\n      return\n    }\n\n    if (configFile) logWarn(`Could not edit ${configFile}: ${reason}`)\n    logBlock(['Add the import to your Kubb config and merge the property into its defineConfig call:', '', toSnippet(detail)])\n    logOutro(styleText('green', install ? `Installed ${spec}. Add it with the snippet above.` : `Install ${spec} and add the snippet above.`))\n  } catch (error) {\n    logError(getErrorMessage(error))\n    process.exitCode = 1\n  }\n}\n"],"mappings":"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"}

package/dist/{run-CJHsZZB8.js → run-BPQzGEIs.js}

@@ -3,7 +3,7 @@ import { n as KUBB_PACKAGE_NAME, r as initDefaults, t as KUBB_CONFIG_FILENAME }
 import { a as logInfo, i as logError, o as logIntro, s as logOutro, t as createSpinner } from "./output-qFt4vV7K.js";
 import { i as installSpec, n as fetchRegistryIndex, o as registryUrl, r as incompatibility, s as toRegistryId } from "./registry-B7BvdrGE.js";
 import { i as missingPluginDependencies, n as initPackageJson, r as installPackages, t as detectPackageManager } from "./utils-BHW8kA8P.js";
-import { t as addToConfig } from "./run-Ca_OX3WZ.js";
+import { t as addToConfig } from "./run-DfEoWJuy.js";
 import { styleText } from "node:util";
 import process from "node:process";
 import path from "node:path";
@@ -175,4 +175,4 @@ async function run({ yes, version, input: inputFlag, output: outputFlag, plugins
 //#endregion
 export { run };
 
-//# sourceMappingURL=run-CJHsZZB8.js.map
+//# sourceMappingURL=run-BPQzGEIs.js.map