kubb 5.0.0-beta.9 → 5.0.0-beta.91

package/LICENSE

@@ -1,14 +1,21 @@
-Copyright (c) 2026 Stijn Van Hulle
-
-This repository contains software under two licenses:
+MIT License
 
-1. Most of the code in this repository is licensed under the
-   MIT License — see licenses/LICENSE-MIT for the full license text.
+Copyright (c) 2026 Stijn Van Hulle
 
-2. The following components are licensed under the
-   GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later)
-   — see licenses/LICENSE-AGPL-3.0 for the full license text:
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-   - packages/agent (published as @kubb/agent)
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-Each package's own LICENSE file or package.json specifies its applicable license.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,18 +1,15 @@
 <div align="center">
-  <h1>kubb</h1>
   <a href="https://kubb.dev" target="_blank" rel="noopener noreferrer">
-    <img width="180" src="https://raw.githubusercontent.com/kubb-labs/kubb/main/assets/logo.png" alt="Kubb logo">
+    <img src="https://kubb.dev/og.png" alt="Kubb banner">
   </a>
 
 [![npm version][npm-version-src]][npm-version-href]
 [![npm downloads][npm-downloads-src]][npm-downloads-href]
-[![Coverage][coverage-src]][coverage-href]
+[![Stars][stars-src]][stars-href]
 [![License][license-src]][license-href]
-[![Sponsors][sponsors-src]][sponsors-href]
-
-### The meta framework for code generation
-
-Point Kubb at an OpenAPI spec and it generates types, clients, hooks, validators, mocks, and more.
+[![Coverage][coverage-src]][coverage-href]
+[![Node][node-src]][node-href]
+[![OC Backers][oc-backers-src]][oc-backers-href]
 
 <h4>
 <a href="https://kubb.dev" target="_blank">Documentation</a>
@@ -25,6 +22,12 @@ Point Kubb at an OpenAPI spec and it generates types, clients, hooks, validators
 
 <br />
 
+# Kubb
+
+### The meta framework for code generation
+
+Point Kubb at a schema and it generates types, clients, hooks, validators, mocks, and more.
+
 ## Installation
 
 ```bash
@@ -53,26 +56,39 @@ See the [documentation](https://kubb.dev) for detailed usage and advanced featur
 
 ## Features
 
-- Works with Node.js 22+ and TypeScript 6.
-- Converts Swagger 2.0, OpenAPI 3.0, and OpenAPI 3.1 into TypeScript types, API clients, and more via the [plugin ecosystem](https://github.com/kubb-labs/kubb-plugins).
-- Extensible plugin and middleware system that you can compose for custom code generation pipelines.
-- CLI with interactive setup, progress bar, and detailed logs.
-- Model Context Protocol (MCP) server for AI assistants like [Claude](https://claude.ai), [Cursor](https://cursor.sh), and other MCP-compatible tools.
-- JSX-based renderer (`@kubb/renderer-jsx`) for building custom plugin output.
-- Barrel file generation via `@kubb/middleware-barrel`.
+- Generate TypeScript types, type-safe clients, [TanStack Query](https://github.com/TanStack/query) and [SWR](https://github.com/vercel/swr) hooks, [Zod](https://github.com/colinhacks/zod) validators, [Faker](https://github.com/faker-js/faker) mocks, and [MSW](https://github.com/mswjs/msw) handlers from one schema.
+- Generate a typed [axios](https://axios-http.com/) or [Fetch](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) client with status-keyed results, auth, validation, file uploads, server-sent events, interceptors, and a swappable transport.
+- Read OpenAPI 2.0, 3.0, and 3.1 through adapters like [`@kubb/adapter-oas`](https://npmx.dev/package/@kubb/adapter-oas), with output for Node.js and Bun.
+- Enable only the [plugins](https://github.com/kubb-labs/plugins) you need: `plugin-ts`, `plugin-axios`, `plugin-fetch`, `plugin-react-query`, `plugin-vue-query`, `plugin-swr`, `plugin-zod`, `plugin-faker`, `plugin-msw`, `plugin-cypress`, `plugin-redoc`, `plugin-mcp`.
+- Shape the output by grouping files by tag, including or excluding operations, and writing to disk, memory, or a custom storage backend.
+- Build your own plugins, generators, adapters, and renderers with the [`kubb/kit`](https://kubb.dev/docs/5.x/reference/kit) authoring toolkit, plus a JSX renderer for component-based output.
+- Run generation in your bundler with `unplugin-kubb` for [Vite](https://github.com/vitejs/vite), [Nuxt](https://github.com/nuxt/nuxt), [Astro](https://github.com/withastro/astro), [webpack](https://github.com/webpack/webpack), and more.
+- Drive generation from AI tools over the built-in MCP server ([Claude](https://claude.ai), [Cursor](https://cursor.sh)) or inside [Claude Code](https://kubb.dev/docs/5.x/ai/claude).
 
 ## Supporting Kubb
 
-Kubb is an open source project with its ongoing development made possible entirely by the support of Sponsors. If you would like to become a sponsor, please consider:
+Kubb is an open source project, and its development is funded entirely by sponsors. If you would like to become a sponsor, please consider:
 
 - [Become a Sponsor on GitHub](https://github.com/sponsors/stijnvanhulle)
+- [Back Kubb on Open Collective](https://opencollective.com/kubb)
+- [See sponsorship tiers and our sponsors](https://kubb.dev/sponsors)
 
 <p align="center">
   <a href="https://github.com/sponsors/stijnvanhulle">
-    <img src="https://raw.githubusercontent.com/stijnvanhulle/sponsors/main/sponsors.svg" alt="My sponsors" />
+    <img src="https://shieldcn.dev/sponsors/stijnvanhulle.svg?titleAlign=center&mode=dark" alt="stijnvanhulle sponsors" width="100%" />
   </a>
 </p>
 
+## Contributing
+
+We welcome contributions that help improve Kubb. A few ways to get involved:
+
+- Found a bug? File it in the [issue tracker](https://github.com/kubb-labs/kubb/issues).
+- Have an idea to improve Kubb? [Open an issue](https://github.com/kubb-labs/kubb/issues/new) to share it.
+- Need help? Ask the community on [Discord](https://discord.gg/4dQjA6vrWX).
+
+See [CONTRIBUTING.md](https://github.com/kubb-labs/kubb/blob/main/CONTRIBUTING.md) for the project structure, local setup, and commands.
+
 ## Contributors [![Contributors][contributors-src]][contributors-href]
 
 <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
@@ -160,39 +176,29 @@ Kubb is an open source project with its ongoing development made possible entire
 
 ## License
 
-Most of this repository is licensed under the [MIT License](./licenses/LICENSE-MIT), Copyright © 2025 [Stijn Van Hulle](https://stijnvanhulle.be). Some components are licensed
-under AGPL-3.0-or-later.
-
-- **Most packages** — [MIT](./licenses/LICENSE-MIT)
-- **`@kubb/agent`** — [AGPL-3.0-or-later](./licenses/LICENSE-AGPL-3.0)
+This repository is licensed under the [MIT License](./licenses/LICENSE-MIT), Copyright © 2025 [Stijn Van Hulle](https://stijnvanhulle.be).
 
 See [LICENSE](./LICENSE) for details.
 
-## Star History
+## Star history
 
-<a href="https://star-history.com/#kubb-labs/kubb&Date">
-  <picture>
-    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=kubb-labs/kubb&type=Date&theme=dark" />
-    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=kubb-labs/kubb&type=Date" />
-    <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=kubb-labs/kubb&type=Date" />
-  </picture>
-</a>
+<img alt="Star history chart" src="https://shieldcn.dev/chart/github/stars/kubb-labs/kubb.svg?theme=orange" width="100%" />
 
 <!-- Badges -->
 
-[npm-version-src]: https://img.shields.io/npm/v/@kubb/core?flat&colorA=18181B&colorB=f58517
-[npm-version-href]: https://npmx.dev/package/@kubb/core
-[npm-downloads-src]: https://img.shields.io/npm/dm/@kubb/core?flat&colorA=18181B&colorB=f58517
-[npm-downloads-href]: https://npmjs.com/package/@kubb/core
-[license-src]: https://img.shields.io/npm/l/%40kubb%2Fcore?flat&colorA=18181B&colorB=f58517
-[license-href]: https://github.com/kubb-labs/kubb/blob/main/licenses/LICENSE-MIT
-[build-src]: https://img.shields.io/github/actions/workflow/status/kubb-labs/kubb/ci.yaml?style=flat&colorA=18181B&colorB=f58517
-[build-href]: https://www.npmjs.com/package/@kubb/core
-[minified-src]: https://img.shields.io/bundlephobia/min/@kubb/core?style=flat&colorA=18181B&colorB=f58517
-[minified-href]: https://www.npmjs.com/package/@kubb/core
-[coverage-src]: https://img.shields.io/codecov/c/github/kubb-labs/kubb?style=flat&colorA=18181B&colorB=f58517
-[coverage-href]: https://www.npmjs.com/package/@kubb/core
-[contributors-src]: https://img.shields.io/github/contributors/kubb-labs/kubb?style=flat&colorA=18181B&colorB=f58517&label=%20
+[npm-version-src]: https://shieldcn.dev/npm/v/@kubb/core.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[npm-version-href]: https://npmx.dev/package/kubb
+[npm-downloads-src]: https://shieldcn.dev/npm/dm/@kubb/core.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[npm-downloads-href]: https://npmx.dev/package/kubb
+[stars-src]: https://shieldcn.dev/github/stars/kubb-labs/kubb.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[stars-href]: https://github.com/kubb-labs/kubb
+[license-src]: https://shieldcn.dev/npm/license/kubb.svg?variant=secondary&size=xs&theme=zinc
+[license-href]: https://github.com/kubb-labs/kubb/blob/main/LICENSE
+[node-src]: https://shieldcn.dev/npm/node/kubb.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[node-href]: https://npmx.dev/package/kubb
+[contributors-src]: https://shieldcn.dev/github/contributors/kubb-labs/kubb.svg?variant=secondary&size=xs&theme=zinc&mode=dark
 [contributors-href]: #contributors-
-[sponsors-src]: https://img.shields.io/github/sponsors/stijnvanhulle?style=flat&colorA=18181B&colorB=f58517
-[sponsors-href]: https://github.com/sponsors/stijnvanhulle/
+[coverage-src]: https://shieldcn.dev/codecov/github/kubb-labs/kubb.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[coverage-href]: https://app.codecov.io/gh/kubb-labs/kubb
+[oc-backers-src]: https://shieldcn.dev/opencollective/backers/kubb.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[oc-backers-href]: https://opencollective.com/kubb

package/bin/kubb.js

@@ -1,4 +1,12 @@
 #!/usr/bin/env node
-import('@kubb/cli').then(({ run }) => {
-  run(process.argv)
-})
+
+process.setSourceMapsEnabled?.(true)
+process.title = 'Kubb'
+
+try {
+  const { run } = await import('@kubb/cli')
+  await run(process.argv)
+} catch (err) {
+  console.error(err)
+  process.exit(1)
+}

package/dist/astro.cjs

@@ -0,0 +1,4 @@
+const require_rolldown_runtime = require("./rolldown-runtime-Bx3C2hgW.cjs");
+let unplugin_kubb_astro = require("unplugin-kubb/astro");
+unplugin_kubb_astro = require_rolldown_runtime.__toESM(unplugin_kubb_astro, 1);
+module.exports = unplugin_kubb_astro.default;

package/dist/astro.d.ts

@@ -0,0 +1,2 @@
+import astro_default from "unplugin-kubb/astro";
+export { astro_default as default };

package/dist/astro.js

@@ -0,0 +1,2 @@
+import astro_default from "unplugin-kubb/astro";
+export { astro_default as default };

package/dist/config.cjs

@@ -0,0 +1,3 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_defineConfig = require("./defineConfig-CzY_scM2.cjs");
+exports.defineConfig = require_defineConfig.defineConfig;

package/dist/config.d.ts

@@ -0,0 +1,3 @@
+import { t as defineConfig } from "./defineConfig-CG4ndZ9i.js";
+import { BarrelType } from "@kubb/plugin-barrel";
+export { type BarrelType, defineConfig };

package/dist/config.js

@@ -0,0 +1,2 @@
+import { t as defineConfig } from "./defineConfig-BCzzAVwJ.js";
+export { defineConfig };

package/dist/defineConfig-BCzzAVwJ.js

@@ -0,0 +1,114 @@
+import "./rolldown-runtime-C0LytTxp.js";
+import { applyConfigDefaults, cliReporter, fileReporter, jsonReporter } from "@kubb/core";
+import { adapterOas } from "@kubb/adapter-oas";
+import { pluginBarrel, pluginBarrelName } from "@kubb/plugin-barrel";
+import { parserTs, parserTsx } from "@kubb/parser-ts";
+import { parserMd } from "@kubb/parser-md";
+//#region ../../internals/utils/src/promise.ts
+/** Returns `true` when `result` is a thenable `Promise`.
+*
+* @example
+* ```ts
+* isPromise(Promise.resolve(1)) // true
+* isPromise(42)                 // false
+* ```
+*/
+function isPromise(result) {
+	return result !== null && result !== void 0 && typeof result["then"] === "function";
+}
+//#endregion
+//#region src/defineConfig.ts
+/**
+* Applies default `root`, adapter, parsers, plugins, `output.barrel`, `output.format`, and `output.lint` to a single user config when not set.
+*
+* - `root` defaults to `process.cwd()`
+* - `adapter` defaults to `adapterOas()`
+* - `parsers` defaults to `[parserTs(), parserTsx(), parserMd()]`
+* - `reporters` defaults to `[cliReporter, jsonReporter, fileReporter]`
+* - `plugins` gets `pluginBarrel()` appended when none is already present
+* - `output.barrel` defaults to `{ type: 'named' }` when not set (`pluginBarrel` is always present after the step above)
+* - `output.format` defaults to `false`
+* - `output.lint` defaults to `false`
+*/
+function applyDefaults(config) {
+	const { adapter, output, plugins } = applyConfigDefaults(config, {
+		defaultAdapter: adapterOas(),
+		barrelPlugin: pluginBarrel(),
+		barrelPluginName: pluginBarrelName,
+		defaultOutput: {
+			barrel: { type: "named" },
+			format: false,
+			lint: false
+		}
+	});
+	return {
+		...config,
+		root: config.root || process.cwd(),
+		adapter,
+		parsers: config.parsers?.length ? config.parsers : [
+			parserTs(),
+			parserTsx(),
+			parserMd()
+		],
+		reporters: config.reporters?.length ? config.reporters : [
+			cliReporter,
+			jsonReporter,
+			fileReporter
+		],
+		plugins,
+		output
+	};
+}
+function normalizeConfig(config) {
+	if (Array.isArray(config)) return config.map(applyDefaults);
+	return applyDefaults(config);
+}
+/**
+* Defines a Kubb build configuration and fills in defaults for any omitted fields.
+*
+* Defaults applied when omitted:
+* - `adapter` → `adapterOas()` (OpenAPI 2.0/3.0/3.1).
+* - `parsers` → `[parserTs(), parserTsx(), parserMd()]`.
+* - `reporters` → `[cliReporter, jsonReporter, fileReporter]`.
+* - `plugins` → `pluginBarrel()` is appended when not already present.
+* - `output.barrel` → `{ type: 'named' }` when not set.
+* - `output.format` and `output.lint` → `false`.
+*
+* Accepts a config object, an array of configs, a Promise resolving to one,
+* or a function that receives the parsed CLI options and returns any of the
+* above. The return type is preserved so async/array variants stay typed.
+*
+* @example
+* ```ts
+* import { defineConfig } from 'kubb'
+* import { pluginTs } from '@kubb/plugin-ts'
+*
+* export default defineConfig({
+*   input: './petStore.yaml',
+*   output: { path: './src/gen' },
+*   plugins: [pluginTs()],
+* })
+* ```
+*
+* @example Function form with CLI options
+* ```ts
+* import { defineConfig } from 'kubb'
+*
+* export default defineConfig(({ input }) => ({
+*   input: input ?? './petStore.yaml',
+*   output: { path: './src/gen' },
+*   plugins: [],
+* }))
+* ```
+*/
+function defineConfig(config) {
+	if (typeof config === "function") return (async (cli) => {
+		return normalizeConfig(await config(cli));
+	});
+	if (isPromise(config)) return config.then((resolved) => normalizeConfig(resolved));
+	return normalizeConfig(config);
+}
+//#endregion
+export { defineConfig as t };
+
+//# sourceMappingURL=defineConfig-BCzzAVwJ.js.map

package/dist/defineConfig-BCzzAVwJ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineConfig-BCzzAVwJ.js","names":[],"sources":["../../../internals/utils/src/promise.ts","../src/defineConfig.ts"],"sourcesContent":["import { toError } from './errors.ts'\n\n/** A value that may already be resolved or still pending.\n *\n * @example\n * ```ts\n * function load(id: string): PossiblePromise<string> {\n *   return cache.get(id) ?? fetchRemote(id)\n * }\n * ```\n */\nexport type PossiblePromise<T> = Promise<T> | T\n\n/** Returns `true` when `result` is a thenable `Promise`.\n *\n * @example\n * ```ts\n * isPromise(Promise.resolve(1)) // true\n * isPromise(42)                 // false\n * ```\n */\nexport function isPromise<T>(result: PossiblePromise<T>): result is Promise<T> {\n  return result !== null && result !== undefined && typeof (result as Record<string, unknown>)['then'] === 'function'\n}\n\ntype Store<TKey, TValue> = {\n  has(key: TKey): boolean\n  get(key: TKey): TValue | undefined\n  set(key: TKey, value: TValue): unknown\n}\n\n/**\n * Wraps `factory` with a keyed cache backed by the provided store.\n *\n * Pass a `WeakMap` for object keys (results are GC-eligible when the key is\n * collected) or a `Map` for primitive keys. For multi-argument functions,\n * nest two `memoize` calls — the outer keyed by the first argument, the\n * inner (created once per outer miss) keyed by the second.\n *\n * Because the cache is owned by the caller, it can be shared, inspected, or\n * cleared independently of the memoized function.\n *\n * @example Single WeakMap key\n * ```ts\n * const cache = new WeakMap<SchemaNode, Set<string>>()\n * const getRefs = memoize(cache, (node) => collectRefs(node))\n * ```\n *\n * @example Single Map key (primitive)\n * ```ts\n * const cache = new Map<string, Resolver>()\n * const getResolver = memoize(cache, (name) => buildResolver(name))\n * ```\n *\n * @example Two-level (object + primitive)\n * ```ts\n * const outer = new WeakMap<Params[], Map<string, Params[]>>()\n * const fn = memoize(outer, (params) => memoize(new Map(), (key) => transform(params, key)))\n * fn(params)('camelcase')\n * ```\n */\nexport function memoize<TKey, TValue>(store: Store<TKey, TValue>, factory: (key: TKey) => TValue): (key: TKey) => TValue {\n  return (key: TKey): TValue => {\n    if (store.has(key)) return store.get(key)!\n    const value = factory(key)\n    store.set(key, value)\n    return value\n  }\n}\n\ntype SerialRunnerOptions = {\n  /**\n   * The async work to serialize.\n   */\n  run(): Promise<void>\n  /**\n   * Receives errors thrown by `run`, so a failure never rejects the returned trigger.\n   */\n  onError(error: Error): void\n}\n\n/**\n * Wraps `run` so invocations never overlap: a trigger that lands while a run is in flight\n * marks it dirty and runs once more after it finishes, no matter how many triggers arrived.\n * Useful for event-driven reruns (a file watcher, a queue drain) where bursts should\n * coalesce into a single trailing run.\n *\n * @example\n * ```ts\n * const rebuild = createSerialRunner({\n *   run: () => build(),\n *   onError: (error) => log.error(error.message),\n * })\n * watcher.on('change', () => void rebuild())\n * ```\n */\nexport function createSerialRunner({ run, onError }: SerialRunnerOptions): () => Promise<void> {\n  let running = false\n  let dirty = false\n\n  return async (): Promise<void> => {\n    if (running) {\n      dirty = true\n      return\n    }\n    running = true\n    do {\n      dirty = false\n      try {\n        await run()\n      } catch (error) {\n        onError(toError(error))\n      }\n    } while (dirty)\n    running = false\n  }\n}\n","import { isPromise, type PossiblePromise } from '@internals/utils'\nimport { adapterOas } from '@kubb/adapter-oas'\nimport { applyConfigDefaults, cliReporter, type CLIOptions, fileReporter, jsonReporter, type UserConfig } from '@kubb/core'\nimport { pluginBarrel, pluginBarrelName } from '@kubb/plugin-barrel'\nimport { parserTs, parserTsx } from '@kubb/parser-ts'\nimport { parserMd } from '@kubb/parser-md'\n\ntype AnyConfigResult = UserConfig<any> | Array<UserConfig<any>>\ntype ConfigInput = AnyConfigResult | Promise<AnyConfigResult> | ((cli: CLIOptions) => PossiblePromise<AnyConfigResult>)\ntype NormalizeConfig<TConfig> =\n  TConfig extends Array<UserConfig<infer TInput>> ? Array<UserConfig<TInput>> : TConfig extends UserConfig<infer TInput> ? UserConfig<TInput> : never\ntype DefinedConfig<TConfig extends ConfigInput> = TConfig extends (cli: CLIOptions) => PossiblePromise<infer TResult>\n  ? (cli: CLIOptions) => Promise<NormalizeConfig<TResult>>\n  : TConfig extends Promise<infer TResult>\n    ? Promise<NormalizeConfig<TResult>>\n    : NormalizeConfig<TConfig>\n\n/**\n * Applies default `root`, adapter, parsers, plugins, `output.barrel`, `output.format`, and `output.lint` to a single user config when not set.\n *\n * - `root` defaults to `process.cwd()`\n * - `adapter` defaults to `adapterOas()`\n * - `parsers` defaults to `[parserTs(), parserTsx(), parserMd()]`\n * - `reporters` defaults to `[cliReporter, jsonReporter, fileReporter]`\n * - `plugins` gets `pluginBarrel()` appended when none is already present\n * - `output.barrel` defaults to `{ type: 'named' }` when not set (`pluginBarrel` is always present after the step above)\n * - `output.format` defaults to `false`\n * - `output.lint` defaults to `false`\n */\nfunction applyDefaults<TInput>(config: UserConfig<TInput>): UserConfig<TInput> {\n  const { adapter, output, plugins } = applyConfigDefaults(config, {\n    defaultAdapter: adapterOas(),\n    barrelPlugin: pluginBarrel(),\n    barrelPluginName: pluginBarrelName,\n    defaultOutput: { barrel: { type: 'named' }, format: false, lint: false },\n  })\n\n  return {\n    ...config,\n    root: config.root || process.cwd(),\n    adapter,\n    parsers: config.parsers?.length ? config.parsers : [parserTs(), parserTsx(), parserMd()],\n    reporters: config.reporters?.length ? config.reporters : [cliReporter, jsonReporter, fileReporter],\n    plugins,\n    output,\n  }\n}\n\nfunction normalizeConfig<TInput>(config: UserConfig<TInput> | Array<UserConfig<TInput>>): UserConfig<TInput> | Array<UserConfig<TInput>> {\n  if (Array.isArray(config)) {\n    return config.map(applyDefaults)\n  }\n\n  return applyDefaults(config)\n}\n\n/**\n * Defines a Kubb build configuration and fills in defaults for any omitted fields.\n *\n * Defaults applied when omitted:\n * - `adapter` → `adapterOas()` (OpenAPI 2.0/3.0/3.1).\n * - `parsers` → `[parserTs(), parserTsx(), parserMd()]`.\n * - `reporters` → `[cliReporter, jsonReporter, fileReporter]`.\n * - `plugins` → `pluginBarrel()` is appended when not already present.\n * - `output.barrel` → `{ type: 'named' }` when not set.\n * - `output.format` and `output.lint` → `false`.\n *\n * Accepts a config object, an array of configs, a Promise resolving to one,\n * or a function that receives the parsed CLI options and returns any of the\n * above. The return type is preserved so async/array variants stay typed.\n *\n * @example\n * ```ts\n * import { defineConfig } from 'kubb'\n * import { pluginTs } from '@kubb/plugin-ts'\n *\n * export default defineConfig({\n *   input: './petStore.yaml',\n *   output: { path: './src/gen' },\n *   plugins: [pluginTs()],\n * })\n * ```\n *\n * @example Function form with CLI options\n * ```ts\n * import { defineConfig } from 'kubb'\n *\n * export default defineConfig(({ input }) => ({\n *   input: input ?? './petStore.yaml',\n *   output: { path: './src/gen' },\n *   plugins: [],\n * }))\n * ```\n */\nexport function defineConfig<TConfig extends ConfigInput>(config: TConfig): DefinedConfig<TConfig> {\n  if (typeof config === 'function') {\n    return (async (cli: CLIOptions) => {\n      return normalizeConfig(await config(cli))\n    }) as DefinedConfig<TConfig>\n  }\n\n  if (isPromise(config)) {\n    return config.then((resolved) => normalizeConfig(resolved)) as DefinedConfig<TConfig>\n  }\n\n  return normalizeConfig(config) as DefinedConfig<TConfig>\n}\n"],"mappings":";;;;;;;;;;;;;;;AAqBA,SAAgB,UAAa,QAAkD;CAC7E,OAAO,WAAW,QAAQ,WAAW,KAAA,KAAa,OAAQ,OAAmC,YAAY;AAC3G;;;;;;;;;;;;;;;ACMA,SAAS,cAAsB,QAAgD;CAC7E,MAAM,EAAE,SAAS,QAAQ,YAAY,oBAAoB,QAAQ;EAC/D,gBAAgB,WAAW;EAC3B,cAAc,aAAa;EAC3B,kBAAkB;EAClB,eAAe;GAAE,QAAQ,EAAE,MAAM,QAAQ;GAAG,QAAQ;GAAO,MAAM;EAAM;CACzE,CAAC;CAED,OAAO;EACL,GAAG;EACH,MAAM,OAAO,QAAQ,QAAQ,IAAI;EACjC;EACA,SAAS,OAAO,SAAS,SAAS,OAAO,UAAU;GAAC,SAAS;GAAG,UAAU;GAAG,SAAS;EAAC;EACvF,WAAW,OAAO,WAAW,SAAS,OAAO,YAAY;GAAC;GAAa;GAAc;EAAY;EACjG;EACA;CACF;AACF;AAEA,SAAS,gBAAwB,QAAwG;CACvI,IAAI,MAAM,QAAQ,MAAM,GACtB,OAAO,OAAO,IAAI,aAAa;CAGjC,OAAO,cAAc,MAAM;AAC7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,SAAgB,aAA0C,QAAyC;CACjG,IAAI,OAAO,WAAW,YACpB,QAAQ,OAAO,QAAoB;EACjC,OAAO,gBAAgB,MAAM,OAAO,GAAG,CAAC;CAC1C;CAGF,IAAI,UAAU,MAAM,GAClB,OAAO,OAAO,MAAM,aAAa,gBAAgB,QAAQ,CAAC;CAG5D,OAAO,gBAAgB,MAAM;AAC/B"}

package/dist/defineConfig-CG4ndZ9i.d.ts

@@ -0,0 +1,62 @@
+import { t as __name } from "./rolldown-runtime-C0LytTxp.js";
+import { CLIOptions, UserConfig } from "@kubb/core";
+
+//#region ../../internals/utils/src/promise.d.ts
+/** A value that may already be resolved or still pending.
+ *
+ * @example
+ * ```ts
+ * function load(id: string): PossiblePromise<string> {
+ *   return cache.get(id) ?? fetchRemote(id)
+ * }
+ * ```
+ */
+type PossiblePromise<T> = Promise<T> | T;
+//#endregion
+//#region src/defineConfig.d.ts
+type AnyConfigResult = UserConfig<any> | Array<UserConfig<any>>;
+type ConfigInput = AnyConfigResult | Promise<AnyConfigResult> | ((cli: CLIOptions) => PossiblePromise<AnyConfigResult>);
+type NormalizeConfig<TConfig> = TConfig extends Array<UserConfig<infer TInput>> ? Array<UserConfig<TInput>> : TConfig extends UserConfig<infer TInput> ? UserConfig<TInput> : never;
+type DefinedConfig<TConfig extends ConfigInput> = TConfig extends ((cli: CLIOptions) => PossiblePromise<infer TResult>) ? (cli: CLIOptions) => Promise<NormalizeConfig<TResult>> : TConfig extends Promise<infer TResult> ? Promise<NormalizeConfig<TResult>> : NormalizeConfig<TConfig>;
+/**
+ * Defines a Kubb build configuration and fills in defaults for any omitted fields.
+ *
+ * Defaults applied when omitted:
+ * - `adapter` → `adapterOas()` (OpenAPI 2.0/3.0/3.1).
+ * - `parsers` → `[parserTs(), parserTsx(), parserMd()]`.
+ * - `reporters` → `[cliReporter, jsonReporter, fileReporter]`.
+ * - `plugins` → `pluginBarrel()` is appended when not already present.
+ * - `output.barrel` → `{ type: 'named' }` when not set.
+ * - `output.format` and `output.lint` → `false`.
+ *
+ * Accepts a config object, an array of configs, a Promise resolving to one,
+ * or a function that receives the parsed CLI options and returns any of the
+ * above. The return type is preserved so async/array variants stay typed.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from 'kubb'
+ * import { pluginTs } from '@kubb/plugin-ts'
+ *
+ * export default defineConfig({
+ *   input: './petStore.yaml',
+ *   output: { path: './src/gen' },
+ *   plugins: [pluginTs()],
+ * })
+ * ```
+ *
+ * @example Function form with CLI options
+ * ```ts
+ * import { defineConfig } from 'kubb'
+ *
+ * export default defineConfig(({ input }) => ({
+ *   input: input ?? './petStore.yaml',
+ *   output: { path: './src/gen' },
+ *   plugins: [],
+ * }))
+ * ```
+ */
+declare function defineConfig<TConfig extends ConfigInput>(config: TConfig): DefinedConfig<TConfig>;
+//#endregion
+export { defineConfig as t };
+//# sourceMappingURL=defineConfig-CG4ndZ9i.d.ts.map

package/dist/defineConfig-CzY_scM2.cjs

@@ -0,0 +1,119 @@
+require("./rolldown-runtime-Bx3C2hgW.cjs");
+let _kubb_core = require("@kubb/core");
+let _kubb_adapter_oas = require("@kubb/adapter-oas");
+let _kubb_plugin_barrel = require("@kubb/plugin-barrel");
+let _kubb_parser_ts = require("@kubb/parser-ts");
+let _kubb_parser_md = require("@kubb/parser-md");
+//#region ../../internals/utils/src/promise.ts
+/** Returns `true` when `result` is a thenable `Promise`.
+*
+* @example
+* ```ts
+* isPromise(Promise.resolve(1)) // true
+* isPromise(42)                 // false
+* ```
+*/
+function isPromise(result) {
+	return result !== null && result !== void 0 && typeof result["then"] === "function";
+}
+//#endregion
+//#region src/defineConfig.ts
+/**
+* Applies default `root`, adapter, parsers, plugins, `output.barrel`, `output.format`, and `output.lint` to a single user config when not set.
+*
+* - `root` defaults to `process.cwd()`
+* - `adapter` defaults to `adapterOas()`
+* - `parsers` defaults to `[parserTs(), parserTsx(), parserMd()]`
+* - `reporters` defaults to `[cliReporter, jsonReporter, fileReporter]`
+* - `plugins` gets `pluginBarrel()` appended when none is already present
+* - `output.barrel` defaults to `{ type: 'named' }` when not set (`pluginBarrel` is always present after the step above)
+* - `output.format` defaults to `false`
+* - `output.lint` defaults to `false`
+*/
+function applyDefaults(config) {
+	const { adapter, output, plugins } = (0, _kubb_core.applyConfigDefaults)(config, {
+		defaultAdapter: (0, _kubb_adapter_oas.adapterOas)(),
+		barrelPlugin: (0, _kubb_plugin_barrel.pluginBarrel)(),
+		barrelPluginName: _kubb_plugin_barrel.pluginBarrelName,
+		defaultOutput: {
+			barrel: { type: "named" },
+			format: false,
+			lint: false
+		}
+	});
+	return {
+		...config,
+		root: config.root || process.cwd(),
+		adapter,
+		parsers: config.parsers?.length ? config.parsers : [
+			(0, _kubb_parser_ts.parserTs)(),
+			(0, _kubb_parser_ts.parserTsx)(),
+			(0, _kubb_parser_md.parserMd)()
+		],
+		reporters: config.reporters?.length ? config.reporters : [
+			_kubb_core.cliReporter,
+			_kubb_core.jsonReporter,
+			_kubb_core.fileReporter
+		],
+		plugins,
+		output
+	};
+}
+function normalizeConfig(config) {
+	if (Array.isArray(config)) return config.map(applyDefaults);
+	return applyDefaults(config);
+}
+/**
+* Defines a Kubb build configuration and fills in defaults for any omitted fields.
+*
+* Defaults applied when omitted:
+* - `adapter` → `adapterOas()` (OpenAPI 2.0/3.0/3.1).
+* - `parsers` → `[parserTs(), parserTsx(), parserMd()]`.
+* - `reporters` → `[cliReporter, jsonReporter, fileReporter]`.
+* - `plugins` → `pluginBarrel()` is appended when not already present.
+* - `output.barrel` → `{ type: 'named' }` when not set.
+* - `output.format` and `output.lint` → `false`.
+*
+* Accepts a config object, an array of configs, a Promise resolving to one,
+* or a function that receives the parsed CLI options and returns any of the
+* above. The return type is preserved so async/array variants stay typed.
+*
+* @example
+* ```ts
+* import { defineConfig } from 'kubb'
+* import { pluginTs } from '@kubb/plugin-ts'
+*
+* export default defineConfig({
+*   input: './petStore.yaml',
+*   output: { path: './src/gen' },
+*   plugins: [pluginTs()],
+* })
+* ```
+*
+* @example Function form with CLI options
+* ```ts
+* import { defineConfig } from 'kubb'
+*
+* export default defineConfig(({ input }) => ({
+*   input: input ?? './petStore.yaml',
+*   output: { path: './src/gen' },
+*   plugins: [],
+* }))
+* ```
+*/
+function defineConfig(config) {
+	if (typeof config === "function") return (async (cli) => {
+		return normalizeConfig(await config(cli));
+	});
+	if (isPromise(config)) return config.then((resolved) => normalizeConfig(resolved));
+	return normalizeConfig(config);
+}
+//#endregion
+Object.defineProperty(exports, "defineConfig", {
+	enumerable: true,
+	get: function() {
+		return defineConfig;
+	}
+});
+
+//# sourceMappingURL=defineConfig-CzY_scM2.cjs.map

package/dist/defineConfig-CzY_scM2.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineConfig-CzY_scM2.cjs","names":["pluginBarrelName","cliReporter","jsonReporter","fileReporter"],"sources":["../../../internals/utils/src/promise.ts","../src/defineConfig.ts"],"sourcesContent":["import { toError } from './errors.ts'\n\n/** A value that may already be resolved or still pending.\n *\n * @example\n * ```ts\n * function load(id: string): PossiblePromise<string> {\n *   return cache.get(id) ?? fetchRemote(id)\n * }\n * ```\n */\nexport type PossiblePromise<T> = Promise<T> | T\n\n/** Returns `true` when `result` is a thenable `Promise`.\n *\n * @example\n * ```ts\n * isPromise(Promise.resolve(1)) // true\n * isPromise(42)                 // false\n * ```\n */\nexport function isPromise<T>(result: PossiblePromise<T>): result is Promise<T> {\n  return result !== null && result !== undefined && typeof (result as Record<string, unknown>)['then'] === 'function'\n}\n\ntype Store<TKey, TValue> = {\n  has(key: TKey): boolean\n  get(key: TKey): TValue | undefined\n  set(key: TKey, value: TValue): unknown\n}\n\n/**\n * Wraps `factory` with a keyed cache backed by the provided store.\n *\n * Pass a `WeakMap` for object keys (results are GC-eligible when the key is\n * collected) or a `Map` for primitive keys. For multi-argument functions,\n * nest two `memoize` calls — the outer keyed by the first argument, the\n * inner (created once per outer miss) keyed by the second.\n *\n * Because the cache is owned by the caller, it can be shared, inspected, or\n * cleared independently of the memoized function.\n *\n * @example Single WeakMap key\n * ```ts\n * const cache = new WeakMap<SchemaNode, Set<string>>()\n * const getRefs = memoize(cache, (node) => collectRefs(node))\n * ```\n *\n * @example Single Map key (primitive)\n * ```ts\n * const cache = new Map<string, Resolver>()\n * const getResolver = memoize(cache, (name) => buildResolver(name))\n * ```\n *\n * @example Two-level (object + primitive)\n * ```ts\n * const outer = new WeakMap<Params[], Map<string, Params[]>>()\n * const fn = memoize(outer, (params) => memoize(new Map(), (key) => transform(params, key)))\n * fn(params)('camelcase')\n * ```\n */\nexport function memoize<TKey, TValue>(store: Store<TKey, TValue>, factory: (key: TKey) => TValue): (key: TKey) => TValue {\n  return (key: TKey): TValue => {\n    if (store.has(key)) return store.get(key)!\n    const value = factory(key)\n    store.set(key, value)\n    return value\n  }\n}\n\ntype SerialRunnerOptions = {\n  /**\n   * The async work to serialize.\n   */\n  run(): Promise<void>\n  /**\n   * Receives errors thrown by `run`, so a failure never rejects the returned trigger.\n   */\n  onError(error: Error): void\n}\n\n/**\n * Wraps `run` so invocations never overlap: a trigger that lands while a run is in flight\n * marks it dirty and runs once more after it finishes, no matter how many triggers arrived.\n * Useful for event-driven reruns (a file watcher, a queue drain) where bursts should\n * coalesce into a single trailing run.\n *\n * @example\n * ```ts\n * const rebuild = createSerialRunner({\n *   run: () => build(),\n *   onError: (error) => log.error(error.message),\n * })\n * watcher.on('change', () => void rebuild())\n * ```\n */\nexport function createSerialRunner({ run, onError }: SerialRunnerOptions): () => Promise<void> {\n  let running = false\n  let dirty = false\n\n  return async (): Promise<void> => {\n    if (running) {\n      dirty = true\n      return\n    }\n    running = true\n    do {\n      dirty = false\n      try {\n        await run()\n      } catch (error) {\n        onError(toError(error))\n      }\n    } while (dirty)\n    running = false\n  }\n}\n","import { isPromise, type PossiblePromise } from '@internals/utils'\nimport { adapterOas } from '@kubb/adapter-oas'\nimport { applyConfigDefaults, cliReporter, type CLIOptions, fileReporter, jsonReporter, type UserConfig } from '@kubb/core'\nimport { pluginBarrel, pluginBarrelName } from '@kubb/plugin-barrel'\nimport { parserTs, parserTsx } from '@kubb/parser-ts'\nimport { parserMd } from '@kubb/parser-md'\n\ntype AnyConfigResult = UserConfig<any> | Array<UserConfig<any>>\ntype ConfigInput = AnyConfigResult | Promise<AnyConfigResult> | ((cli: CLIOptions) => PossiblePromise<AnyConfigResult>)\ntype NormalizeConfig<TConfig> =\n  TConfig extends Array<UserConfig<infer TInput>> ? Array<UserConfig<TInput>> : TConfig extends UserConfig<infer TInput> ? UserConfig<TInput> : never\ntype DefinedConfig<TConfig extends ConfigInput> = TConfig extends (cli: CLIOptions) => PossiblePromise<infer TResult>\n  ? (cli: CLIOptions) => Promise<NormalizeConfig<TResult>>\n  : TConfig extends Promise<infer TResult>\n    ? Promise<NormalizeConfig<TResult>>\n    : NormalizeConfig<TConfig>\n\n/**\n * Applies default `root`, adapter, parsers, plugins, `output.barrel`, `output.format`, and `output.lint` to a single user config when not set.\n *\n * - `root` defaults to `process.cwd()`\n * - `adapter` defaults to `adapterOas()`\n * - `parsers` defaults to `[parserTs(), parserTsx(), parserMd()]`\n * - `reporters` defaults to `[cliReporter, jsonReporter, fileReporter]`\n * - `plugins` gets `pluginBarrel()` appended when none is already present\n * - `output.barrel` defaults to `{ type: 'named' }` when not set (`pluginBarrel` is always present after the step above)\n * - `output.format` defaults to `false`\n * - `output.lint` defaults to `false`\n */\nfunction applyDefaults<TInput>(config: UserConfig<TInput>): UserConfig<TInput> {\n  const { adapter, output, plugins } = applyConfigDefaults(config, {\n    defaultAdapter: adapterOas(),\n    barrelPlugin: pluginBarrel(),\n    barrelPluginName: pluginBarrelName,\n    defaultOutput: { barrel: { type: 'named' }, format: false, lint: false },\n  })\n\n  return {\n    ...config,\n    root: config.root || process.cwd(),\n    adapter,\n    parsers: config.parsers?.length ? config.parsers : [parserTs(), parserTsx(), parserMd()],\n    reporters: config.reporters?.length ? config.reporters : [cliReporter, jsonReporter, fileReporter],\n    plugins,\n    output,\n  }\n}\n\nfunction normalizeConfig<TInput>(config: UserConfig<TInput> | Array<UserConfig<TInput>>): UserConfig<TInput> | Array<UserConfig<TInput>> {\n  if (Array.isArray(config)) {\n    return config.map(applyDefaults)\n  }\n\n  return applyDefaults(config)\n}\n\n/**\n * Defines a Kubb build configuration and fills in defaults for any omitted fields.\n *\n * Defaults applied when omitted:\n * - `adapter` → `adapterOas()` (OpenAPI 2.0/3.0/3.1).\n * - `parsers` → `[parserTs(), parserTsx(), parserMd()]`.\n * - `reporters` → `[cliReporter, jsonReporter, fileReporter]`.\n * - `plugins` → `pluginBarrel()` is appended when not already present.\n * - `output.barrel` → `{ type: 'named' }` when not set.\n * - `output.format` and `output.lint` → `false`.\n *\n * Accepts a config object, an array of configs, a Promise resolving to one,\n * or a function that receives the parsed CLI options and returns any of the\n * above. The return type is preserved so async/array variants stay typed.\n *\n * @example\n * ```ts\n * import { defineConfig } from 'kubb'\n * import { pluginTs } from '@kubb/plugin-ts'\n *\n * export default defineConfig({\n *   input: './petStore.yaml',\n *   output: { path: './src/gen' },\n *   plugins: [pluginTs()],\n * })\n * ```\n *\n * @example Function form with CLI options\n * ```ts\n * import { defineConfig } from 'kubb'\n *\n * export default defineConfig(({ input }) => ({\n *   input: input ?? './petStore.yaml',\n *   output: { path: './src/gen' },\n *   plugins: [],\n * }))\n * ```\n */\nexport function defineConfig<TConfig extends ConfigInput>(config: TConfig): DefinedConfig<TConfig> {\n  if (typeof config === 'function') {\n    return (async (cli: CLIOptions) => {\n      return normalizeConfig(await config(cli))\n    }) as DefinedConfig<TConfig>\n  }\n\n  if (isPromise(config)) {\n    return config.then((resolved) => normalizeConfig(resolved)) as DefinedConfig<TConfig>\n  }\n\n  return normalizeConfig(config) as DefinedConfig<TConfig>\n}\n"],"mappings":";;;;;;;;;;;;;;;AAqBA,SAAgB,UAAa,QAAkD;CAC7E,OAAO,WAAW,QAAQ,WAAW,KAAA,KAAa,OAAQ,OAAmC,YAAY;AAC3G;;;;;;;;;;;;;;;ACMA,SAAS,cAAsB,QAAgD;CAC7E,MAAM,EAAE,SAAS,QAAQ,aAAA,GAAA,WAAA,oBAAA,CAAgC,QAAQ;EAC/D,iBAAA,GAAA,kBAAA,WAAA,CAA2B;EAC3B,eAAA,GAAA,oBAAA,aAAA,CAA2B;EAC3B,kBAAkBA,oBAAAA;EAClB,eAAe;GAAE,QAAQ,EAAE,MAAM,QAAQ;GAAG,QAAQ;GAAO,MAAM;EAAM;CACzE,CAAC;CAED,OAAO;EACL,GAAG;EACH,MAAM,OAAO,QAAQ,QAAQ,IAAI;EACjC;EACA,SAAS,OAAO,SAAS,SAAS,OAAO,UAAU;iCAAU;kCAAa;iCAAY;EAAC;EACvF,WAAW,OAAO,WAAW,SAAS,OAAO,YAAY;GAACC,WAAAA;GAAaC,WAAAA;GAAcC,WAAAA;EAAY;EACjG;EACA;CACF;AACF;AAEA,SAAS,gBAAwB,QAAwG;CACvI,IAAI,MAAM,QAAQ,MAAM,GACtB,OAAO,OAAO,IAAI,aAAa;CAGjC,OAAO,cAAc,MAAM;AAC7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,SAAgB,aAA0C,QAAyC;CACjG,IAAI,OAAO,WAAW,YACpB,QAAQ,OAAO,QAAoB;EACjC,OAAO,gBAAgB,MAAM,OAAO,GAAG,CAAC;CAC1C;CAGF,IAAI,UAAU,MAAM,GAClB,OAAO,OAAO,MAAM,aAAa,gBAAgB,QAAQ,CAAC;CAG5D,OAAO,gBAAgB,MAAM;AAC/B"}

package/dist/esbuild.cjs

@@ -0,0 +1,4 @@
+const require_rolldown_runtime = require("./rolldown-runtime-Bx3C2hgW.cjs");
+let unplugin_kubb_esbuild = require("unplugin-kubb/esbuild");
+unplugin_kubb_esbuild = require_rolldown_runtime.__toESM(unplugin_kubb_esbuild, 1);
+module.exports = unplugin_kubb_esbuild.default;

package/dist/esbuild.d.ts

@@ -0,0 +1,2 @@
+import esbuild_default from "unplugin-kubb/esbuild";
+export { esbuild_default as default };

package/dist/esbuild.js

@@ -0,0 +1,2 @@
+import esbuild_default from "unplugin-kubb/esbuild";
+export { esbuild_default as default };

package/dist/farm.cjs

@@ -0,0 +1,4 @@
+const require_rolldown_runtime = require("./rolldown-runtime-Bx3C2hgW.cjs");
+let unplugin_kubb_farm = require("unplugin-kubb/farm");
+unplugin_kubb_farm = require_rolldown_runtime.__toESM(unplugin_kubb_farm, 1);
+module.exports = unplugin_kubb_farm.default;

package/dist/farm.d.ts

@@ -0,0 +1,2 @@
+import farm_default from "unplugin-kubb/farm";
+export { farm_default as default };

package/dist/farm.js

@@ -0,0 +1,2 @@
+import farm_default from "unplugin-kubb/farm";
+export { farm_default as default };