@kubb/core 5.0.0-beta.1 → 5.0.0-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -152,7 +152,7 @@ Kubb is an open source project with its ongoing development made possible entire
152
152
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/skoropadas"><img src="https://avatars.githubusercontent.com/u/20700969?v=4?s=100" width="100px;" alt="Alex Skoropad"/><br /><sub><b>Alex Skoropad</b></sub></a><br /><a href="https://github.com/kubb-labs/kubb/commits?author=skoropadas" title="Code">💻</a></td>
153
153
  <td align="center" valign="top" width="14.28%"><a href="https://pateljay.io"><img src="https://avatars.githubusercontent.com/u/36803168?v=4?s=100" width="100px;" alt="Jay Patel"/><br /><sub><b>Jay Patel</b></sub></a><br /><a href="https://github.com/kubb-labs/kubb/commits?author=jay-babu" title="Code">💻</a></td>
154
154
  <td align="center" valign="top" width="14.28%"><a href="https://hamzamihaidaniel.com"><img src="https://avatars.githubusercontent.com/u/12731515?v=4?s=100" width="100px;" alt="Hamza Mihai Daniel"/><br /><sub><b>Hamza Mihai Daniel</b></sub></a><br /><a href="https://github.com/kubb-labs/kubb/commits?author=hamzamihaidanielx" title="Code">💻</a></td>
155
- <td align="center" valign="top" width="14.28%"><a href="https://github.com/saschabuehrle"><img src="https://avatars.githubusercontent.com/u/47737812?v=4?s=100" width="100px;" alt="Sascha Buehrle"/><br /><sub><b>Sascha Buehrle</b></sub></a><br /><a href="https://github.com/kubb-labs/kubb/commits?author=saschabuehrle" title="Code">💻</a></td>
155
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/DesselBane"><img src="https://avatars.githubusercontent.com/u/12199480?v=4?s=100" width="100px;" alt="DesselBane"/><br /><sub><b>DesselBane</b></sub></a><br /><a href="https://github.com/kubb-labs/kubb/commits?author=DesselBane" title="Code">💻</a></td>
156
156
  </tr>
157
157
  </tbody>
158
158
  </table>
package/dist/index.cjs CHANGED
@@ -817,7 +817,7 @@ const fsStorage = createStorage(() => ({
817
817
  }));
818
818
  //#endregion
819
819
  //#region package.json
820
- var version = "5.0.0-beta.1";
820
+ var version = "5.0.0-beta.2";
821
821
  //#endregion
822
822
  //#region src/utils/diagnostics.ts
823
823
  /**
@@ -939,6 +939,12 @@ async function setup(userConfig, options = {}) {
939
939
  /**
940
940
  * Walks the AST and dispatches nodes to a plugin's direct AST hooks
941
941
  * (`schema`, `operation`, `operations`).
942
+ *
943
+ * When `include` contains only operation-scoped filters (`tag`, `operationId`, `path`,
944
+ * `method`, `contentType`) and no `schemaName` filter, the function pre-computes the set
945
+ * of top-level schema names transitively reachable from the included operations and skips
946
+ * schemas that fall outside that set. This ensures that component schemas referenced
947
+ * exclusively by excluded operations are not generated.
942
948
  */
943
949
  async function runPluginAstHooks(plugin, context) {
944
950
  const { adapter, inputNode, resolver, driver } = context;
@@ -953,10 +959,27 @@ async function runPluginAstHooks(plugin, context) {
953
959
  ...context,
954
960
  resolver: driver.getResolver(plugin.name)
955
961
  };
962
+ const operationFilterTypes = new Set([
963
+ "tag",
964
+ "operationId",
965
+ "path",
966
+ "method",
967
+ "contentType"
968
+ ]);
969
+ const hasOperationBasedIncludes = include?.some(({ type }) => operationFilterTypes.has(type)) ?? false;
970
+ const hasSchemaNameIncludes = include?.some(({ type }) => type === "schemaName") ?? false;
971
+ let allowedSchemaNames;
972
+ if (hasOperationBasedIncludes && !hasSchemaNameIncludes) allowedSchemaNames = (0, _kubb_ast.collectUsedSchemaNames)(inputNode.operations.filter((op) => resolver.resolveOptions(op, {
973
+ options: plugin.options,
974
+ exclude,
975
+ include,
976
+ override
977
+ }) !== null), inputNode.schemas);
956
978
  await (0, _kubb_ast.walk)(inputNode, {
957
979
  depth: "shallow",
958
980
  async schema(node) {
959
981
  const transformedNode = plugin.transformer ? (0, _kubb_ast.transform)(node, plugin.transformer) : node;
982
+ if (allowedSchemaNames !== void 0 && transformedNode.name && !allowedSchemaNames.has(transformedNode.name)) return;
960
983
  const options = resolver.resolveOptions(transformedNode, {
961
984
  options: plugin.options,
962
985
  exclude,
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","names":["#emitter","NodeEventEmitter","#options","camelCase","#transformParam","#eachParam","#head","#tail","#size","#limit","DEFAULT_EXTENSION","DEFAULT_BANNER","DEFAULT_STUDIO_URL","PluginDriver","applyHookResult"],"sources":["../../../internals/utils/src/errors.ts","../../../internals/utils/src/asyncEventEmitter.ts","../../../internals/utils/src/time.ts","../../../internals/utils/src/fs.ts","../../../internals/utils/src/reserved.ts","../../../internals/utils/src/urlPath.ts","../src/createAdapter.ts","../../../node_modules/.pnpm/yocto-queue@1.2.2/node_modules/yocto-queue/index.js","../../../node_modules/.pnpm/p-limit@7.3.0/node_modules/p-limit/index.js","../src/FileProcessor.ts","../src/createStorage.ts","../src/storages/fsStorage.ts","../package.json","../src/utils/diagnostics.ts","../src/utils/isInputPath.ts","../src/createKubb.ts","../src/createRenderer.ts","../src/defineGenerator.ts","../src/defineLogger.ts","../src/defineMiddleware.ts","../src/defineParser.ts","../src/definePlugin.ts","../src/storages/memoryStorage.ts"],"sourcesContent":["/**\n * Thrown when one or more errors occur during a Kubb build.\n * Carries the full list of underlying errors on `errors`.\n *\n * @example\n * ```ts\n * throw new BuildError('Build failed', { errors: [err1, err2] })\n * ```\n */\nexport class BuildError extends Error {\n errors: Array<Error>\n\n constructor(message: string, options: { cause?: Error; errors: Array<Error> }) {\n super(message, { cause: options.cause })\n this.name = 'BuildError'\n this.errors = options.errors\n }\n}\n\n/**\n * Coerces an unknown thrown value to an `Error` instance.\n * Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.\n *\n * @example\n * ```ts\n * try { ... } catch(err) {\n * throw new BuildError('Build failed', { cause: toError(err), errors: [] })\n * }\n * ```\n */\nexport function toError(value: unknown): Error {\n return value instanceof Error ? value : new Error(String(value))\n}\n\n/**\n * Extracts a human-readable message from any thrown value.\n *\n * @example\n * ```ts\n * getErrorMessage(new Error('oops')) // 'oops'\n * getErrorMessage('plain string') // 'plain string'\n * ```\n */\nexport function getErrorMessage(value: unknown): string {\n return value instanceof Error ? value.message : String(value)\n}\n\n/**\n * Extracts the `.cause` of an `Error` as an `Error`, or `undefined` when absent or not an `Error`.\n *\n * @example\n * ```ts\n * const cause = toCause(buildError) // Error | undefined\n * ```\n */\nexport function toCause(error: Error): Error | undefined {\n return error.cause instanceof Error ? error.cause : undefined\n}\n","import { EventEmitter as NodeEventEmitter } from 'node:events'\nimport { toError } from './errors.ts'\n\n/**\n * A function that can be registered as an event listener, synchronous or async.\n */\ntype AsyncListener<TArgs extends unknown[]> = (...args: TArgs) => void | Promise<void>\n\n/**\n * Typed `EventEmitter` that awaits all async listeners before resolving.\n * Wraps Node's `EventEmitter` with full TypeScript event-map inference.\n *\n * @example\n * ```ts\n * const emitter = new AsyncEventEmitter<{ build: [name: string] }>()\n * emitter.on('build', async (name) => { console.log(name) })\n * await emitter.emit('build', 'petstore') // all listeners awaited\n * ```\n */\nexport class AsyncEventEmitter<TEvents extends { [K in keyof TEvents]: unknown[] }> {\n /**\n * Maximum number of listeners per event before Node emits a memory-leak warning.\n * @default 10\n */\n constructor(maxListener = 10) {\n this.#emitter.setMaxListeners(maxListener)\n }\n\n #emitter = new NodeEventEmitter()\n\n /**\n * Emits `eventName` and awaits all registered listeners sequentially.\n * Throws if any listener rejects, wrapping the cause with the event name and serialized arguments.\n *\n * @example\n * ```ts\n * await emitter.emit('build', 'petstore')\n * ```\n */\n async emit<TEventName extends keyof TEvents & string>(eventName: TEventName, ...eventArgs: TEvents[TEventName]): Promise<void> {\n const listeners = this.#emitter.listeners(eventName) as Array<AsyncListener<TEvents[TEventName]>>\n\n if (listeners.length === 0) {\n return\n }\n\n for (const listener of listeners) {\n try {\n await listener(...eventArgs)\n } catch (err) {\n let serializedArgs: string\n try {\n serializedArgs = JSON.stringify(eventArgs)\n } catch {\n serializedArgs = String(eventArgs)\n }\n throw new Error(`Error in async listener for \"${eventName}\" with eventArgs ${serializedArgs}`, { cause: toError(err) })\n }\n }\n }\n\n /**\n * Registers a persistent listener for `eventName`.\n *\n * @example\n * ```ts\n * emitter.on('build', async (name) => { console.log(name) })\n * ```\n */\n on<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n this.#emitter.on(eventName, handler as AsyncListener<unknown[]>)\n }\n\n /**\n * Registers a one-shot listener that removes itself after the first invocation.\n *\n * @example\n * ```ts\n * emitter.onOnce('build', async (name) => { console.log(name) })\n * ```\n */\n onOnce<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n const wrapper: AsyncListener<TEvents[TEventName]> = (...args) => {\n this.off(eventName, wrapper)\n return handler(...args)\n }\n this.on(eventName, wrapper)\n }\n\n /**\n * Removes a previously registered listener.\n *\n * @example\n * ```ts\n * emitter.off('build', handler)\n * ```\n */\n off<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n this.#emitter.off(eventName, handler as AsyncListener<unknown[]>)\n }\n\n /**\n * Returns the number of listeners registered for `eventName`.\n *\n * @example\n * ```ts\n * emitter.on('build', handler)\n * emitter.listenerCount('build') // 1\n * ```\n */\n listenerCount<TEventName extends keyof TEvents & string>(eventName: TEventName): number {\n return this.#emitter.listenerCount(eventName)\n }\n\n /**\n * Removes all listeners from every event channel.\n *\n * @example\n * ```ts\n * emitter.removeAll()\n * ```\n */\n removeAll(): void {\n this.#emitter.removeAllListeners()\n }\n}\n","/**\n * Calculates elapsed time in milliseconds from a high-resolution `process.hrtime` start time.\n * Rounds to 2 decimal places for sub-millisecond precision without noise.\n *\n * @example\n * ```ts\n * const start = process.hrtime()\n * doWork()\n * getElapsedMs(start) // 42.35\n * ```\n */\nexport function getElapsedMs(hrStart: [number, number]): number {\n const [seconds, nanoseconds] = process.hrtime(hrStart)\n const ms = seconds * 1000 + nanoseconds / 1e6\n return Math.round(ms * 100) / 100\n}\n\n/**\n * Converts a millisecond duration into a human-readable string (`ms`, `s`, or `m s`).\n *\n * @example\n * ```ts\n * formatMs(250) // '250ms'\n * formatMs(1500) // '1.50s'\n * formatMs(90000) // '1m 30.0s'\n * ```\n */\nexport function formatMs(ms: number): string {\n if (ms >= 60000) {\n const mins = Math.floor(ms / 60000)\n const secs = ((ms % 60000) / 1000).toFixed(1)\n return `${mins}m ${secs}s`\n }\n\n if (ms >= 1000) {\n return `${(ms / 1000).toFixed(2)}s`\n }\n return `${Math.round(ms)}ms`\n}\n\n/**\n * Formats the elapsed time since `hrStart` as a human-readable string.\n *\n * @example\n * ```ts\n * const start = process.hrtime()\n * doWork()\n * formatHrtime(start) // '1.50s'\n * ```\n */\nexport function formatHrtime(hrStart: [number, number]): string {\n return formatMs(getElapsedMs(hrStart))\n}\n","import { existsSync, readFileSync } from 'node:fs'\nimport { access, mkdir, readFile, rm, writeFile } from 'node:fs/promises'\nimport { dirname, join, posix, resolve } from 'node:path'\n\n/**\n * Walks up the directory tree from `cwd` (defaults to `process.cwd()`) and\n * returns the absolute path of the nearest `package.json`, or `null` when none\n * is found before reaching the filesystem root.\n *\n * @example\n * ```ts\n * const pkgPath = findPackageJSON('/home/user/project/src') // '/home/user/project/package.json'\n * ```\n */\nexport function findPackageJSON(cwd?: string): string | null {\n let dir = cwd ? resolve(cwd) : process.cwd()\n while (true) {\n const pkgPath = join(dir, 'package.json')\n if (existsSync(pkgPath)) return pkgPath\n const parent = dirname(dir)\n if (parent === dir) return null\n dir = parent\n }\n}\n\n/**\n * Converts all backslashes to forward slashes.\n * Extended-length Windows paths (`\\\\?\\...`) are left unchanged.\n */\nfunction toSlash(p: string): string {\n if (p.startsWith('\\\\\\\\?\\\\')) return p\n return p.replaceAll('\\\\', '/')\n}\n\n/**\n * Returns the relative path from `rootDir` to `filePath`, always using forward slashes\n * and prefixed with `./` when not already traversing upward.\n *\n * @example\n * ```ts\n * getRelativePath('/src/components', '/src/components/Button.tsx') // './Button.tsx'\n * getRelativePath('/src/components', '/src/utils/helpers.ts') // '../utils/helpers.ts'\n * ```\n */\nexport function getRelativePath(rootDir?: string | null, filePath?: string | null): string {\n if (!rootDir || !filePath) {\n throw new Error(`Root and file should be filled in when retrieving the relativePath, ${rootDir || ''} ${filePath || ''}`)\n }\n\n const relativePath = posix.relative(toSlash(rootDir), toSlash(filePath))\n\n return relativePath.startsWith('../') ? relativePath : `./${relativePath}`\n}\n\n/**\n * Resolves to `true` when the file or directory at `path` exists.\n * Uses `Bun.file().exists()` when running under Bun, `fs.access` otherwise.\n *\n * @example\n * ```ts\n * if (await exists('./kubb.config.ts')) {\n * const content = await read('./kubb.config.ts')\n * }\n * ```\n */\nexport async function exists(path: string): Promise<boolean> {\n if (typeof Bun !== 'undefined') {\n return Bun.file(path).exists()\n }\n return access(path).then(\n () => true,\n () => false,\n )\n}\n\n/**\n * Reads the file at `path` as a UTF-8 string.\n * Uses `Bun.file().text()` when running under Bun, `fs.readFile` otherwise.\n *\n * @example\n * ```ts\n * const source = await read('./src/Pet.ts')\n * ```\n */\nexport async function read(path: string): Promise<string> {\n if (typeof Bun !== 'undefined') {\n return Bun.file(path).text()\n }\n return readFile(path, { encoding: 'utf8' })\n}\n\n/**\n * Synchronous counterpart of `read`.\n *\n * @example\n * ```ts\n * const source = readSync('./src/Pet.ts')\n * ```\n */\nexport function readSync(path: string): string {\n return readFileSync(path, { encoding: 'utf8' })\n}\n\ntype WriteOptions = {\n /**\n * When `true`, re-reads the file immediately after writing and throws if the\n * content does not match — useful for catching write failures on unreliable file systems.\n */\n sanity?: boolean\n}\n\n/**\n * Writes `data` to `path`, trimming leading/trailing whitespace before saving.\n * Skips the write when the trimmed content is empty or identical to what is already on disk.\n * Creates any missing parent directories automatically.\n * When `sanity` is `true`, re-reads the file after writing and throws if the content does not match.\n *\n * @example\n * ```ts\n * await write('./src/Pet.ts', source) // writes and returns trimmed content\n * await write('./src/Pet.ts', source) // null — file unchanged\n * await write('./src/Pet.ts', ' ') // null — empty content skipped\n * ```\n */\nexport async function write(path: string, data: string, options: WriteOptions = {}): Promise<string | null> {\n const trimmed = data.trim()\n if (trimmed === '') return null\n\n const resolved = resolve(path)\n\n if (typeof Bun !== 'undefined') {\n const file = Bun.file(resolved)\n const oldContent = (await file.exists()) ? await file.text() : null\n if (oldContent === trimmed) return null\n await Bun.write(resolved, trimmed)\n return trimmed\n }\n\n try {\n const oldContent = await readFile(resolved, { encoding: 'utf-8' })\n if (oldContent === trimmed) return null\n } catch {\n /* file doesn't exist yet */\n }\n\n await mkdir(dirname(resolved), { recursive: true })\n await writeFile(resolved, trimmed, { encoding: 'utf-8' })\n\n if (options.sanity) {\n const savedData = await readFile(resolved, { encoding: 'utf-8' })\n if (savedData !== trimmed) {\n throw new Error(`Sanity check failed for ${path}\\n\\nData[${data.length}]:\\n${data}\\n\\nSaved[${savedData.length}]:\\n${savedData}\\n`)\n }\n return savedData\n }\n\n return trimmed\n}\n\n/**\n * Recursively removes `path`. Silently succeeds when `path` does not exist.\n *\n * @example\n * ```ts\n * await clean('./dist')\n * ```\n */\nexport async function clean(path: string): Promise<void> {\n return rm(path, { recursive: true, force: true })\n}\n","/**\n * JavaScript and Java reserved words.\n * @link https://github.com/jonschlinkert/reserved/blob/master/index.js\n */\nconst reservedWords = new Set([\n 'abstract',\n 'arguments',\n 'boolean',\n 'break',\n 'byte',\n 'case',\n 'catch',\n 'char',\n 'class',\n 'const',\n 'continue',\n 'debugger',\n 'default',\n 'delete',\n 'do',\n 'double',\n 'else',\n 'enum',\n 'eval',\n 'export',\n 'extends',\n 'false',\n 'final',\n 'finally',\n 'float',\n 'for',\n 'function',\n 'goto',\n 'if',\n 'implements',\n 'import',\n 'in',\n 'instanceof',\n 'int',\n 'interface',\n 'let',\n 'long',\n 'native',\n 'new',\n 'null',\n 'package',\n 'private',\n 'protected',\n 'public',\n 'return',\n 'short',\n 'static',\n 'super',\n 'switch',\n 'synchronized',\n 'this',\n 'throw',\n 'throws',\n 'transient',\n 'true',\n 'try',\n 'typeof',\n 'var',\n 'void',\n 'volatile',\n 'while',\n 'with',\n 'yield',\n 'Array',\n 'Date',\n 'hasOwnProperty',\n 'Infinity',\n 'isFinite',\n 'isNaN',\n 'isPrototypeOf',\n 'length',\n 'Math',\n 'name',\n 'NaN',\n 'Number',\n 'Object',\n 'prototype',\n 'String',\n 'toString',\n 'undefined',\n 'valueOf',\n] as const)\n\n/**\n * Prefixes `word` with `_` when it is a reserved JavaScript/Java identifier or starts with a digit.\n *\n * @example\n * ```ts\n * transformReservedWord('class') // '_class'\n * transformReservedWord('42foo') // '_42foo'\n * transformReservedWord('status') // 'status'\n * ```\n */\nexport function transformReservedWord(word: string): string {\n const firstChar = word.charCodeAt(0)\n if (word && (reservedWords.has(word as 'valueOf') || (firstChar >= 48 && firstChar <= 57))) {\n return `_${word}`\n }\n return word\n}\n\n/**\n * Returns `true` when `name` is a syntactically valid JavaScript variable name.\n *\n * @example\n * ```ts\n * isValidVarName('status') // true\n * isValidVarName('class') // false (reserved word)\n * isValidVarName('42foo') // false (starts with digit)\n * ```\n */\nexport function isValidVarName(name: string): boolean {\n if (!name || reservedWords.has(name as 'valueOf')) {\n return false\n }\n return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name)\n}\n","import { camelCase } from './casing.ts'\nimport { isValidVarName } from './reserved.ts'\n\nexport type URLObject = {\n /**\n * The resolved URL string (Express-style or template literal, depending on context).\n */\n url: string\n /**\n * Extracted path parameters as a key-value map, or `undefined` when the path has none.\n */\n params?: Record<string, string>\n}\n\ntype ObjectOptions = {\n /**\n * Controls whether the `url` is rendered as an Express path or a template literal.\n * @default 'path'\n */\n type?: 'path' | 'template'\n /**\n * Optional transform applied to each extracted parameter name.\n */\n replacer?: (pathParam: string) => string\n /**\n * When `true`, the result is serialized to a string expression instead of a plain object.\n */\n stringify?: boolean\n}\n\n/**\n * Supported identifier casing strategies for path parameters.\n */\ntype PathCasing = 'camelcase'\n\ntype Options = {\n /**\n * Casing strategy applied to path parameter names.\n * @default undefined (original identifier preserved)\n */\n casing?: PathCasing\n}\n\n/**\n * Parses and transforms an OpenAPI/Swagger path string into various URL formats.\n *\n * @example\n * const p = new URLPath('/pet/{petId}')\n * p.URL // '/pet/:petId'\n * p.template // '`/pet/${petId}`'\n */\nexport class URLPath {\n /**\n * The raw OpenAPI/Swagger path string, e.g. `/pet/{petId}`.\n */\n path: string\n\n #options: Options\n\n constructor(path: string, options: Options = {}) {\n this.path = path\n this.#options = options\n }\n\n /** Converts the OpenAPI path to Express-style colon syntax, e.g. `/pet/{petId}` → `/pet/:petId`.\n *\n * @example\n * ```ts\n * new URLPath('/pet/{petId}').URL // '/pet/:petId'\n * ```\n */\n get URL(): string {\n return this.toURLPath()\n }\n\n /** Returns `true` when `path` is a fully-qualified URL (e.g. starts with `https://`).\n *\n * @example\n * ```ts\n * new URLPath('https://petstore.swagger.io/v2/pet').isURL // true\n * new URLPath('/pet/{petId}').isURL // false\n * ```\n */\n get isURL(): boolean {\n try {\n return !!new URL(this.path).href\n } catch {\n return false\n }\n }\n\n /**\n * Converts the OpenAPI path to a TypeScript template literal string.\n *\n * @example\n * new URLPath('/pet/{petId}').template // '`/pet/${petId}`'\n * new URLPath('/account/monetary-accountID').template // '`/account/${monetaryAccountId}`'\n */\n get template(): string {\n return this.toTemplateString()\n }\n\n /** Returns the path and its extracted params as a structured `URLObject`, or as a stringified expression when `stringify` is set.\n *\n * @example\n * ```ts\n * new URLPath('/pet/{petId}').object\n * // { url: '/pet/:petId', params: { petId: 'petId' } }\n * ```\n */\n get object(): URLObject | string {\n return this.toObject()\n }\n\n /** Returns a map of path parameter names, or `undefined` when the path has no parameters.\n *\n * @example\n * ```ts\n * new URLPath('/pet/{petId}').params // { petId: 'petId' }\n * new URLPath('/pet').params // undefined\n * ```\n */\n get params(): Record<string, string> | undefined {\n return this.getParams()\n }\n\n #transformParam(raw: string): string {\n const param = isValidVarName(raw) ? raw : camelCase(raw)\n return this.#options.casing === 'camelcase' ? camelCase(param) : param\n }\n\n /**\n * Iterates over every `{param}` token in `path`, calling `fn` with the raw token and transformed name.\n */\n #eachParam(fn: (raw: string, param: string) => void): void {\n for (const match of this.path.matchAll(/\\{([^}]+)\\}/g)) {\n const raw = match[1]!\n fn(raw, this.#transformParam(raw))\n }\n }\n\n toObject({ type = 'path', replacer, stringify }: ObjectOptions = {}): URLObject | string {\n const object = {\n url: type === 'path' ? this.toURLPath() : this.toTemplateString({ replacer }),\n params: this.getParams(),\n }\n\n if (stringify) {\n if (type === 'template') {\n return JSON.stringify(object).replaceAll(\"'\", '').replaceAll(`\"`, '')\n }\n\n if (object.params) {\n return `{ url: '${object.url}', params: ${JSON.stringify(object.params).replaceAll(\"'\", '').replaceAll(`\"`, '')} }`\n }\n\n return `{ url: '${object.url}' }`\n }\n\n return object\n }\n\n /**\n * Converts the OpenAPI path to a TypeScript template literal string.\n * An optional `replacer` can transform each extracted parameter name before interpolation.\n *\n * @example\n * new URLPath('/pet/{petId}').toTemplateString() // '`/pet/${petId}`'\n */\n toTemplateString({\n prefix = '',\n replacer,\n }: {\n prefix?: string\n replacer?: (pathParam: string) => string\n } = {}): string {\n const parts = this.path.split(/\\{([^}]+)\\}/)\n const result = parts\n .map((part, i) => {\n if (i % 2 === 0) return part\n const param = this.#transformParam(part)\n return `\\${${replacer ? replacer(param) : param}}`\n })\n .join('')\n\n return `\\`${prefix}${result}\\``\n }\n\n /**\n * Extracts all `{param}` segments from the path and returns them as a key-value map.\n * An optional `replacer` transforms each parameter name in both key and value positions.\n * Returns `undefined` when no path parameters are found.\n *\n * @example\n * ```ts\n * new URLPath('/pet/{petId}/tag/{tagId}').getParams()\n * // { petId: 'petId', tagId: 'tagId' }\n * ```\n */\n getParams(replacer?: (pathParam: string) => string): Record<string, string> | undefined {\n const params: Record<string, string> = {}\n\n this.#eachParam((_raw, param) => {\n const key = replacer ? replacer(param) : param\n params[key] = key\n })\n\n return Object.keys(params).length > 0 ? params : undefined\n }\n\n /** Converts the OpenAPI path to Express-style colon syntax.\n *\n * @example\n * ```ts\n * new URLPath('/pet/{petId}').toURLPath() // '/pet/:petId'\n * ```\n */\n toURLPath(): string {\n return this.path.replace(/\\{([^}]+)\\}/g, ':$1')\n }\n}\n","import type { Adapter, AdapterFactoryOptions } from './types.ts'\n\ntype AdapterBuilder<T extends AdapterFactoryOptions> = (options: T['options']) => Adapter<T>\n\n/**\n * Factory for implementing custom adapters that translate non-OpenAPI specs into Kubb's AST.\n *\n * Use this to support GraphQL schemas, gRPC definitions, AsyncAPI, or custom domain-specific languages.\n * Built-in adapters include `@kubb/adapter-oas` for OpenAPI and Swagger documents.\n *\n * @note Adapters must parse their input format to Kubb's `InputNode` structure.\n *\n * @example\n * ```ts\n * export const myAdapter = createAdapter<MyAdapter>((options) => {\n * return {\n * name: 'my-adapter',\n * options,\n * async parse(source) {\n * // Transform source format to InputNode\n * return { ... }\n * },\n * }\n * })\n *\n * // Instantiate:\n * const adapter = myAdapter({ validate: true })\n * ```\n */\nexport function createAdapter<T extends AdapterFactoryOptions = AdapterFactoryOptions>(build: AdapterBuilder<T>): (options?: T['options']) => Adapter<T> {\n return (options) => build(options ?? ({} as T['options']))\n}\n","/*\nHow it works:\n`this.#head` is an instance of `Node` which keeps track of its current value and nests another instance of `Node` that keeps the value that comes after it. When a value is provided to `.enqueue()`, the code needs to iterate through `this.#head`, going deeper and deeper to find the last value. However, iterating through every single item is slow. This problem is solved by saving a reference to the last value as `this.#tail` so that it can reference it to add a new value.\n*/\n\nclass Node {\n\tvalue;\n\tnext;\n\n\tconstructor(value) {\n\t\tthis.value = value;\n\t}\n}\n\nexport default class Queue {\n\t#head;\n\t#tail;\n\t#size;\n\n\tconstructor() {\n\t\tthis.clear();\n\t}\n\n\tenqueue(value) {\n\t\tconst node = new Node(value);\n\n\t\tif (this.#head) {\n\t\t\tthis.#tail.next = node;\n\t\t\tthis.#tail = node;\n\t\t} else {\n\t\t\tthis.#head = node;\n\t\t\tthis.#tail = node;\n\t\t}\n\n\t\tthis.#size++;\n\t}\n\n\tdequeue() {\n\t\tconst current = this.#head;\n\t\tif (!current) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.#head = this.#head.next;\n\t\tthis.#size--;\n\n\t\t// Clean up tail reference when queue becomes empty\n\t\tif (!this.#head) {\n\t\t\tthis.#tail = undefined;\n\t\t}\n\n\t\treturn current.value;\n\t}\n\n\tpeek() {\n\t\tif (!this.#head) {\n\t\t\treturn;\n\t\t}\n\n\t\treturn this.#head.value;\n\n\t\t// TODO: Node.js 18.\n\t\t// return this.#head?.value;\n\t}\n\n\tclear() {\n\t\tthis.#head = undefined;\n\t\tthis.#tail = undefined;\n\t\tthis.#size = 0;\n\t}\n\n\tget size() {\n\t\treturn this.#size;\n\t}\n\n\t* [Symbol.iterator]() {\n\t\tlet current = this.#head;\n\n\t\twhile (current) {\n\t\t\tyield current.value;\n\t\t\tcurrent = current.next;\n\t\t}\n\t}\n\n\t* drain() {\n\t\twhile (this.#head) {\n\t\t\tyield this.dequeue();\n\t\t}\n\t}\n}\n","import Queue from 'yocto-queue';\n\nexport default function pLimit(concurrency) {\n\tlet rejectOnClear = false;\n\n\tif (typeof concurrency === 'object') {\n\t\t({concurrency, rejectOnClear = false} = concurrency);\n\t}\n\n\tvalidateConcurrency(concurrency);\n\n\tif (typeof rejectOnClear !== 'boolean') {\n\t\tthrow new TypeError('Expected `rejectOnClear` to be a boolean');\n\t}\n\n\tconst queue = new Queue();\n\tlet activeCount = 0;\n\n\tconst resumeNext = () => {\n\t\t// Process the next queued function if we're under the concurrency limit\n\t\tif (activeCount < concurrency && queue.size > 0) {\n\t\t\tactiveCount++;\n\t\t\tqueue.dequeue().run();\n\t\t}\n\t};\n\n\tconst next = () => {\n\t\tactiveCount--;\n\t\tresumeNext();\n\t};\n\n\tconst run = async (function_, resolve, arguments_) => {\n\t\t// Execute the function and capture the result promise\n\t\tconst result = (async () => function_(...arguments_))();\n\n\t\t// Resolve immediately with the promise (don't wait for completion)\n\t\tresolve(result);\n\n\t\t// Wait for the function to complete (success or failure)\n\t\t// We catch errors here to prevent unhandled rejections,\n\t\t// but the original promise rejection is preserved for the caller\n\t\ttry {\n\t\t\tawait result;\n\t\t} catch {}\n\n\t\t// Decrement active count and process next queued function\n\t\tnext();\n\t};\n\n\tconst enqueue = (function_, resolve, reject, arguments_) => {\n\t\tconst queueItem = {reject};\n\n\t\t// Queue the internal resolve function instead of the run function\n\t\t// to preserve the asynchronous execution context.\n\t\tnew Promise(internalResolve => { // eslint-disable-line promise/param-names\n\t\t\tqueueItem.run = internalResolve;\n\t\t\tqueue.enqueue(queueItem);\n\t\t}).then(run.bind(undefined, function_, resolve, arguments_)); // eslint-disable-line promise/prefer-await-to-then\n\n\t\t// Start processing immediately if we haven't reached the concurrency limit\n\t\tif (activeCount < concurrency) {\n\t\t\tresumeNext();\n\t\t}\n\t};\n\n\tconst generator = (function_, ...arguments_) => new Promise((resolve, reject) => {\n\t\tenqueue(function_, resolve, reject, arguments_);\n\t});\n\n\tObject.defineProperties(generator, {\n\t\tactiveCount: {\n\t\t\tget: () => activeCount,\n\t\t},\n\t\tpendingCount: {\n\t\t\tget: () => queue.size,\n\t\t},\n\t\tclearQueue: {\n\t\t\tvalue() {\n\t\t\t\tif (!rejectOnClear) {\n\t\t\t\t\tqueue.clear();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tconst abortError = AbortSignal.abort().reason;\n\n\t\t\t\twhile (queue.size > 0) {\n\t\t\t\t\tqueue.dequeue().reject(abortError);\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t\tconcurrency: {\n\t\t\tget: () => concurrency,\n\n\t\t\tset(newConcurrency) {\n\t\t\t\tvalidateConcurrency(newConcurrency);\n\t\t\t\tconcurrency = newConcurrency;\n\n\t\t\t\tqueueMicrotask(() => {\n\t\t\t\t\t// eslint-disable-next-line no-unmodified-loop-condition\n\t\t\t\t\twhile (activeCount < concurrency && queue.size > 0) {\n\t\t\t\t\t\tresumeNext();\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t},\n\t\t},\n\t\tmap: {\n\t\t\tasync value(iterable, function_) {\n\t\t\t\tconst promises = Array.from(iterable, (value, index) => this(function_, value, index));\n\t\t\t\treturn Promise.all(promises);\n\t\t\t},\n\t\t},\n\t});\n\n\treturn generator;\n}\n\nexport function limitFunction(function_, options) {\n\tconst limit = pLimit(options);\n\n\treturn (...arguments_) => limit(() => function_(...arguments_));\n}\n\nfunction validateConcurrency(concurrency) {\n\tif (!((Number.isInteger(concurrency) || concurrency === Number.POSITIVE_INFINITY) && concurrency > 0)) {\n\t\tthrow new TypeError('Expected `concurrency` to be a number from 1 and up');\n\t}\n}\n","import type { CodeNode, FileNode } from '@kubb/ast'\nimport { extractStringsFromNodes } from '@kubb/ast'\nimport pLimit from 'p-limit'\nimport { PARALLEL_CONCURRENCY_LIMIT } from './constants.ts'\nimport type { Parser } from './defineParser.ts'\n\ntype ParseOptions = {\n parsers?: Map<FileNode['extname'], Parser>\n extension?: Record<FileNode['extname'], FileNode['extname'] | ''>\n}\n\ntype RunOptions = ParseOptions & {\n /**\n * @default 'sequential'\n */\n mode?: 'sequential' | 'parallel'\n onStart?: (files: Array<FileNode>) => Promise<void> | void\n onEnd?: (files: Array<FileNode>) => Promise<void> | void\n onUpdate?: (params: { file: FileNode; source?: string; processed: number; total: number; percentage: number }) => Promise<void> | void\n}\n\nfunction joinSources(file: FileNode): string {\n return file.sources\n .map((item) => extractStringsFromNodes(item.nodes as Array<CodeNode>))\n .filter(Boolean)\n .join('\\n\\n')\n}\n\n/**\n * Converts a single file to a string using the registered parsers.\n * Falls back to joining source values when no matching parser is found.\n *\n * @internal\n */\nexport class FileProcessor {\n readonly #limit = pLimit(PARALLEL_CONCURRENCY_LIMIT)\n\n async parse(file: FileNode, { parsers, extension }: ParseOptions = {}): Promise<string> {\n const parseExtName = extension?.[file.extname] || undefined\n\n if (!parsers || !file.extname) {\n return joinSources(file)\n }\n\n const parser = parsers.get(file.extname)\n\n if (!parser) {\n return joinSources(file)\n }\n\n return parser.parse(file, { extname: parseExtName })\n }\n\n async run(files: Array<FileNode>, { parsers, mode = 'sequential', extension, onStart, onEnd, onUpdate }: RunOptions = {}): Promise<Array<FileNode>> {\n await onStart?.(files)\n\n const total = files.length\n let processed = 0\n\n const processOne = async (file: FileNode) => {\n const source = await this.parse(file, { extension, parsers })\n const currentProcessed = ++processed\n const percentage = (currentProcessed / total) * 100\n\n await onUpdate?.({\n file,\n source,\n processed: currentProcessed,\n percentage,\n total,\n })\n }\n\n if (mode === 'sequential') {\n for (const file of files) {\n await processOne(file)\n }\n } else {\n await Promise.all(files.map((file) => this.#limit(() => processOne(file))))\n }\n\n await onEnd?.(files)\n\n return files\n }\n}\n","export type Storage = {\n /**\n * Identifier used for logging and debugging (e.g. `'fs'`, `'s3'`).\n */\n readonly name: string\n /**\n * Returns `true` when an entry for `key` exists in storage.\n */\n hasItem(key: string): Promise<boolean>\n /**\n * Returns the stored string value, or `null` when `key` does not exist.\n */\n getItem(key: string): Promise<string | null>\n /**\n * Persists `value` under `key`, creating any required structure.\n */\n setItem(key: string, value: string): Promise<void>\n /**\n * Removes the entry for `key`. No-ops when the key does not exist.\n */\n removeItem(key: string): Promise<void>\n /**\n * Returns all keys, optionally filtered to those starting with `base`.\n */\n getKeys(base?: string): Promise<Array<string>>\n /**\n * Removes all entries, optionally scoped to those starting with `base`.\n */\n clear(base?: string): Promise<void>\n /**\n * Optional teardown hook called after the build completes.\n */\n dispose?(): Promise<void>\n}\n\n/**\n * Factory for implementing custom storage backends that control where generated files are written.\n *\n * Takes a builder function `(options: TOptions) => Storage` and returns a factory `(options?: TOptions) => Storage`.\n * Kubb provides filesystem and in-memory implementations out of the box.\n *\n * @note Call the returned factory with optional options to instantiate the storage adapter.\n *\n * @example\n * ```ts\n * import { createStorage } from '@kubb/core'\n *\n * export const memoryStorage = createStorage(() => {\n * const store = new Map<string, string>()\n * return {\n * name: 'memory',\n * async hasItem(key) { return store.has(key) },\n * async getItem(key) { return store.get(key) ?? null },\n * async setItem(key, value) { store.set(key, value) },\n * async removeItem(key) { store.delete(key) },\n * async getKeys(base) {\n * const keys = [...store.keys()]\n * return base ? keys.filter((k) => k.startsWith(base)) : keys\n * },\n * async clear(base) { if (!base) store.clear() },\n * }\n * })\n *\n * // Instantiate:\n * const storage = memoryStorage()\n * ```\n */\nexport function createStorage<TOptions = Record<string, never>>(build: (options: TOptions) => Storage): (options?: TOptions) => Storage {\n return (options) => build(options ?? ({} as TOptions))\n}\n","import type { Dirent } from 'node:fs'\nimport { access, readdir, readFile, rm } from 'node:fs/promises'\nimport { join, resolve } from 'node:path'\nimport { clean, write } from '@internals/utils'\nimport { createStorage } from '../createStorage.ts'\n\n/**\n * Detects the filesystem error used to indicate that a path does not exist.\n */\nfunction isMissingPathError(error: unknown): error is NodeJS.ErrnoException {\n return typeof error === 'object' && error !== null && 'code' in error && (error as NodeJS.ErrnoException).code === 'ENOENT'\n}\n\n/**\n * Built-in filesystem storage driver.\n *\n * This is the default storage when no `storage` option is configured in the root config.\n * Keys are resolved against `process.cwd()`, so root-relative paths such as\n * `src/gen/api/getPets.ts` are written to the correct location without extra configuration.\n *\n * Internally uses the `write` utility from `@internals/utils`, which:\n * - trims leading/trailing whitespace before writing\n * - skips the write when file content is already identical (deduplication)\n * - creates missing parent directories automatically\n * - supports Bun's native file API when running under Bun\n *\n * @example\n * ```ts\n * import { fsStorage } from '@kubb/core'\n * import { defineConfig } from 'kubb'\n *\n * export default defineConfig({\n * input: { path: './petStore.yaml' },\n * output: { path: './src/gen' },\n * storage: fsStorage(),\n * })\n * ```\n */\nexport const fsStorage = createStorage(() => ({\n name: 'fs',\n async hasItem(key: string) {\n try {\n await access(resolve(key))\n return true\n } catch (error) {\n if (isMissingPathError(error)) {\n return false\n }\n\n throw new Error(`Failed to access storage item \"${key}\"`, {\n cause: error as Error,\n })\n }\n },\n async getItem(key: string) {\n try {\n return await readFile(resolve(key), 'utf8')\n } catch (error) {\n if (isMissingPathError(error)) {\n return null\n }\n\n throw new Error(`Failed to read storage item \"${key}\"`, {\n cause: error as Error,\n })\n }\n },\n async setItem(key: string, value: string) {\n await write(resolve(key), value, { sanity: false })\n },\n async removeItem(key: string) {\n await rm(resolve(key), { force: true })\n },\n async getKeys(base?: string) {\n const keys: Array<string> = []\n const resolvedBase = resolve(base ?? process.cwd())\n\n async function walk(dir: string, prefix: string): Promise<void> {\n let entries: Array<Dirent>\n try {\n entries = (await readdir(dir, {\n withFileTypes: true,\n })) as Array<Dirent>\n } catch (error) {\n if (isMissingPathError(error)) {\n return\n }\n\n throw new Error(`Failed to list storage keys under \"${resolvedBase}\"`, {\n cause: error as Error,\n })\n }\n for (const entry of entries) {\n const rel = prefix ? `${prefix}/${entry.name}` : entry.name\n if (entry.isDirectory()) {\n await walk(join(dir, entry.name), rel)\n } else {\n keys.push(rel)\n }\n }\n }\n\n await walk(resolvedBase, '')\n\n return keys\n },\n async clear(base?: string) {\n if (!base) {\n return\n }\n\n await clean(resolve(base))\n },\n}))\n","","import { version as nodeVersion } from 'node:process'\nimport { version as KubbVersion } from '../../package.json'\n\n/**\n * Returns a snapshot of the current runtime environment.\n *\n * Useful for attaching context to debug logs and error reports so that\n * issues can be reproduced without manual information gathering.\n */\nexport function getDiagnosticInfo() {\n return {\n nodeVersion,\n KubbVersion,\n platform: process.platform,\n arch: process.arch,\n cwd: process.cwd(),\n } as const\n}\n","import type { Config, InputPath, UserConfig } from '../types'\n\n/**\n * Type guard to check if a given config has an `input.path`.\n */\nexport function isInputPath(config: UserConfig | undefined): config is UserConfig<InputPath>\nexport function isInputPath(config: Config | undefined): config is Config<InputPath>\nexport function isInputPath(config: Config | UserConfig | undefined): config is Config<InputPath> | UserConfig<InputPath> {\n return typeof config?.input === 'object' && config.input !== null && 'path' in config.input\n}\n","import { resolve } from 'node:path'\nimport { AsyncEventEmitter, BuildError, exists, formatMs, getElapsedMs, URLPath } from '@internals/utils'\nimport type { FileNode, OperationNode } from '@kubb/ast'\nimport { transform, walk } from '@kubb/ast'\nimport { DEFAULT_BANNER, DEFAULT_EXTENSION, DEFAULT_STUDIO_URL } from './constants.ts'\nimport type { RendererFactory } from './createRenderer.ts'\nimport type { Generator } from './defineGenerator.ts'\nimport type { Parser } from './defineParser.ts'\nimport type { Plugin } from './definePlugin.ts'\nimport { FileProcessor } from './FileProcessor.ts'\nimport type { Kubb } from './Kubb.ts'\nimport { PluginDriver } from './PluginDriver.ts'\nimport { applyHookResult } from './renderNode.ts'\nimport { fsStorage } from './storages/fsStorage.ts'\nimport type { AdapterSource, Config, GeneratorContext, KubbHooks, Middleware, NormalizedPlugin, Storage, UserConfig } from './types.ts'\nimport { getDiagnosticInfo } from './utils/diagnostics.ts'\nimport { isInputPath } from './utils/isInputPath.ts'\n\ntype SetupOptions = {\n hooks?: AsyncEventEmitter<KubbHooks>\n}\n\n/**\n * Full output produced by a successful or failed build.\n */\nexport type BuildOutput = {\n /**\n * Plugins that threw during installation, paired with the caught error.\n */\n failedPlugins: Set<{ plugin: Plugin; error: Error }>\n files: Array<FileNode>\n driver: PluginDriver\n /**\n * Elapsed time in milliseconds for each plugin, keyed by plugin name.\n */\n pluginTimings: Map<string, number>\n error?: Error\n /**\n * Raw generated source, keyed by absolute file path.\n */\n sources: Map<string, string>\n}\n\ntype SetupResult = {\n hooks: AsyncEventEmitter<KubbHooks>\n driver: PluginDriver\n sources: Map<string, string>\n config: Config\n storage: Storage | null\n}\n\nasync function setup(userConfig: UserConfig, options: SetupOptions = {}): Promise<SetupResult> {\n const hooks = options.hooks ?? new AsyncEventEmitter<KubbHooks>()\n\n const sources: Map<string, string> = new Map<string, string>()\n const diagnosticInfo = getDiagnosticInfo()\n\n if (Array.isArray(userConfig.input)) {\n await hooks.emit('kubb:warn', { message: 'This feature is still under development — use with caution' })\n }\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [\n 'Configuration:',\n ` • Name: ${userConfig.name || 'unnamed'}`,\n ` • Root: ${userConfig.root || process.cwd()}`,\n ` • Output: ${userConfig.output?.path || 'not specified'}`,\n ` • Plugins: ${userConfig.plugins?.length || 0}`,\n 'Output Settings:',\n ` • Storage: ${userConfig.storage ? `custom(${userConfig.storage.name})` : userConfig.output?.write === false ? 'disabled' : 'filesystem (default)'}`,\n ` • Formatter: ${userConfig.output?.format || 'none'}`,\n ` • Linter: ${userConfig.output?.lint || 'none'}`,\n 'Environment:',\n Object.entries(diagnosticInfo)\n .map(([key, value]) => ` • ${key}: ${value}`)\n .join('\\n'),\n ],\n })\n\n try {\n if (isInputPath(userConfig) && !new URLPath(userConfig.input.path).isURL) {\n await exists(userConfig.input.path)\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [`✓ Input file validated: ${userConfig.input.path}`],\n })\n }\n } catch (caughtError) {\n if (isInputPath(userConfig)) {\n const error = caughtError as Error\n\n throw new Error(\n `Cannot read file/URL defined in \\`input.path\\` or set with \\`kubb generate PATH\\` in the CLI of your Kubb config ${userConfig.input.path}`,\n {\n cause: error,\n },\n )\n }\n }\n\n if (!userConfig.adapter) {\n throw new Error('Adapter should be defined')\n }\n\n const config: Config = {\n ...userConfig,\n root: userConfig.root || process.cwd(),\n parsers: userConfig.parsers ?? [],\n adapter: userConfig.adapter,\n output: {\n format: false,\n lint: false,\n write: true,\n extension: DEFAULT_EXTENSION,\n defaultBanner: DEFAULT_BANNER,\n ...userConfig.output,\n },\n devtools: userConfig.devtools\n ? {\n studioUrl: DEFAULT_STUDIO_URL,\n ...(typeof userConfig.devtools === 'boolean' ? {} : userConfig.devtools),\n }\n : undefined,\n plugins: userConfig.plugins as unknown as Config['plugins'],\n }\n\n const storage: Storage | null = config.output.write === false ? null : (config.storage ?? fsStorage())\n\n if (config.output.clean) {\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: ['Cleaning output directories', ` • Output: ${config.output.path}`],\n })\n await storage?.clear(resolve(config.root, config.output.path))\n }\n\n const driver = new PluginDriver(config, {\n hooks,\n })\n\n // Register middleware hooks after all plugin hooks are registered.\n // Because AsyncEventEmitter calls listeners in registration order,\n // middleware hooks for any event fire after all plugin hooks for that event.\n function registerMiddlewareHook<K extends keyof KubbHooks & string>(event: K, middlewareHooks: Middleware['hooks']) {\n const handler = middlewareHooks[event]\n if (handler) {\n hooks.on(event, handler)\n }\n }\n\n for (const middleware of config.middleware ?? []) {\n for (const event of Object.keys(middleware.hooks) as Array<keyof KubbHooks & string>) {\n registerMiddlewareHook(event, middleware.hooks)\n }\n }\n\n const adapter = config.adapter\n if (!adapter) {\n throw new Error('No adapter configured. Please provide an adapter in your kubb.config.ts.')\n }\n const source = inputToAdapterSource(config)\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [`Running adapter: ${adapter.name}`],\n })\n\n driver.adapter = adapter\n driver.inputNode = await adapter.parse(source)\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [\n `✓ Adapter '${adapter.name}' resolved InputNode`,\n ` • Schemas: ${driver.inputNode.schemas.length}`,\n ` • Operations: ${driver.inputNode.operations.length}`,\n ],\n })\n\n return {\n config,\n hooks,\n driver,\n sources,\n storage,\n }\n}\n\n/**\n * Walks the AST and dispatches nodes to a plugin's direct AST hooks\n * (`schema`, `operation`, `operations`).\n */\nasync function runPluginAstHooks(plugin: NormalizedPlugin, context: GeneratorContext): Promise<void> {\n const { adapter, inputNode, resolver, driver } = context\n const { exclude, include, override } = plugin.options\n\n if (!adapter || !inputNode) {\n throw new Error(`[${plugin.name}] No adapter found. Add an OAS adapter (e.g. pluginOas()) before this plugin in your Kubb config.`)\n }\n\n function resolveRenderer(gen: Generator): RendererFactory | undefined {\n return gen.renderer === null ? undefined : (gen.renderer ?? plugin.renderer ?? context.config.renderer)\n }\n\n const generators = plugin.generators ?? []\n const collectedOperations: Array<OperationNode> = []\n\n const generatorContext = {\n ...context,\n resolver: driver.getResolver(plugin.name),\n }\n\n await walk(inputNode, {\n depth: 'shallow',\n async schema(node) {\n const transformedNode = plugin.transformer ? transform(node, plugin.transformer) : node\n const options = resolver.resolveOptions(transformedNode, {\n options: plugin.options,\n exclude,\n include,\n override,\n })\n if (options === null) return\n\n const ctx = { ...generatorContext, options }\n\n for (const gen of generators) {\n if (!gen.schema) continue\n const result = await gen.schema(transformedNode, ctx)\n await applyHookResult(result, driver, resolveRenderer(gen))\n }\n\n await driver.hooks.emit('kubb:generate:schema', transformedNode, ctx)\n },\n async operation(node) {\n const transformedNode = plugin.transformer ? transform(node, plugin.transformer) : node\n const options = resolver.resolveOptions(transformedNode, {\n options: plugin.options,\n exclude,\n include,\n override,\n })\n if (options !== null) {\n collectedOperations.push(transformedNode)\n\n const ctx = { ...generatorContext, options }\n\n for (const gen of generators) {\n if (!gen.operation) continue\n const result = await gen.operation(transformedNode, ctx)\n await applyHookResult(result, driver, resolveRenderer(gen))\n }\n\n await driver.hooks.emit('kubb:generate:operation', transformedNode, ctx)\n }\n },\n })\n\n if (collectedOperations.length > 0) {\n const ctx = { ...generatorContext, options: plugin.options }\n\n for (const gen of generators) {\n if (!gen.operations) continue\n const result = await gen.operations(collectedOperations, ctx)\n await applyHookResult(result, driver, resolveRenderer(gen))\n }\n\n await driver.hooks.emit('kubb:generate:operations', collectedOperations, ctx)\n }\n}\n\nasync function safeBuild(setupResult: SetupResult): Promise<BuildOutput> {\n const { driver, hooks, sources, storage } = setupResult\n\n const failedPlugins = new Set<{ plugin: Plugin; error: Error }>()\n const pluginTimings = new Map<string, number>()\n const config = driver.config\n\n try {\n await driver.emitSetupHooks()\n\n if (driver.adapter && driver.inputNode) {\n await hooks.emit('kubb:build:start', {\n config,\n adapter: driver.adapter,\n inputNode: driver.inputNode,\n getPlugin: driver.getPlugin.bind(driver),\n get files() {\n return driver.fileManager.files\n },\n upsertFile: (...files) => driver.fileManager.upsert(...files),\n })\n }\n\n for (const plugin of driver.plugins.values()) {\n const context = driver.getContext(plugin)\n const hrStart = process.hrtime()\n\n try {\n const timestamp = new Date()\n\n await hooks.emit('kubb:plugin:start', { plugin })\n\n await hooks.emit('kubb:debug', {\n date: timestamp,\n logs: ['Starting plugin...', ` • Plugin Name: ${plugin.name}`],\n })\n\n if (plugin.generators?.length || driver.hasRegisteredGenerators(plugin.name)) {\n await runPluginAstHooks(plugin, context)\n }\n\n const duration = getElapsedMs(hrStart)\n pluginTimings.set(plugin.name, duration)\n\n await hooks.emit('kubb:plugin:end', {\n plugin,\n duration,\n success: true,\n config,\n get files() {\n return driver.fileManager.files\n },\n upsertFile: (...files) => driver.fileManager.upsert(...files),\n })\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [`✓ Plugin started successfully (${formatMs(duration)})`],\n })\n } catch (caughtError) {\n const error = caughtError as Error\n const errorTimestamp = new Date()\n const duration = getElapsedMs(hrStart)\n\n await hooks.emit('kubb:plugin:end', {\n plugin,\n duration,\n success: false,\n error,\n config,\n get files() {\n return driver.fileManager.files\n },\n upsertFile: (...files) => driver.fileManager.upsert(...files),\n })\n\n await hooks.emit('kubb:debug', {\n date: errorTimestamp,\n logs: [\n '✗ Plugin start failed',\n ` • Plugin Name: ${plugin.name}`,\n ` • Error: ${error.constructor.name} - ${error.message}`,\n ' • Stack Trace:',\n error.stack || 'No stack trace available',\n ],\n })\n\n failedPlugins.add({ plugin, error })\n }\n }\n\n await hooks.emit('kubb:plugins:end', {\n config,\n get files() {\n return driver.fileManager.files\n },\n upsertFile: (...files) => driver.fileManager.upsert(...files),\n })\n\n const files = driver.fileManager.files\n\n const parsersMap = new Map<FileNode['extname'], Parser>()\n for (const parser of config.parsers) {\n if (parser.extNames) {\n for (const extname of parser.extNames) {\n parsersMap.set(extname, parser)\n }\n }\n }\n\n const fileProcessor = new FileProcessor()\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [`Writing ${files.length} files...`],\n })\n\n await fileProcessor.run(files, {\n parsers: parsersMap,\n extension: config.output.extension,\n onStart: async (processingFiles) => {\n await hooks.emit('kubb:files:processing:start', { files: processingFiles })\n },\n onUpdate: async ({ file, source, processed, total, percentage }) => {\n await hooks.emit('kubb:file:processing:update', {\n file,\n source,\n processed,\n total,\n percentage,\n config,\n })\n if (source) {\n await storage?.setItem(file.path, source)\n sources.set(file.path, source)\n }\n },\n onEnd: async (processedFiles) => {\n await hooks.emit('kubb:files:processing:end', { files: processedFiles })\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [`✓ File write process completed for ${processedFiles.length} files`],\n })\n },\n })\n\n await hooks.emit('kubb:build:end', {\n files,\n config,\n outputDir: resolve(config.root, config.output.path),\n })\n\n return {\n failedPlugins,\n files,\n driver,\n pluginTimings,\n sources,\n }\n } catch (error) {\n return {\n failedPlugins,\n files: [],\n driver,\n pluginTimings,\n error: error as Error,\n sources,\n }\n } finally {\n driver.dispose()\n }\n}\n\nasync function build(setupResult: SetupResult): Promise<BuildOutput> {\n const { files, driver, failedPlugins, pluginTimings, error, sources } = await safeBuild(setupResult)\n\n if (error) {\n throw error\n }\n\n if (failedPlugins.size > 0) {\n const errors = [...failedPlugins].map(({ error }) => error)\n\n throw new BuildError(`Build Error with ${failedPlugins.size} failed plugins`, { errors })\n }\n\n return {\n failedPlugins,\n files,\n driver,\n pluginTimings,\n error: undefined,\n sources,\n }\n}\n\nfunction inputToAdapterSource(config: Config): AdapterSource {\n if (Array.isArray(config.input)) {\n return {\n type: 'paths',\n paths: config.input.map((i) => (new URLPath(i.path).isURL ? i.path : resolve(config.root, i.path))),\n }\n }\n\n if ('data' in config.input) {\n return { type: 'data', data: config.input.data }\n }\n\n if (new URLPath(config.input.path).isURL) {\n return { type: 'path', path: config.input.path }\n }\n\n const resolved = resolve(config.root, config.input.path)\n return { type: 'path', path: resolved }\n}\n\ntype CreateKubbOptions = {\n hooks?: AsyncEventEmitter<KubbHooks>\n}\n\n/**\n * Creates a Kubb instance bound to a single config entry.\n *\n * Accepts a user-facing config shape and resolves it to a full {@link Config} during\n * `setup()`. The instance then holds shared state (`hooks`, `sources`, `driver`, `config`)\n * across the `setup → build` lifecycle. Attach event listeners to `kubb.hooks` before\n * calling `setup()` or `build()`.\n *\n * @example\n * ```ts\n * const kubb = createKubb(userConfig)\n *\n * kubb.hooks.on('kubb:plugin:end', ({ plugin, duration }) => {\n * console.log(`${plugin.name} completed in ${duration}ms`)\n * })\n *\n * const { files, failedPlugins } = await kubb.safeBuild()\n * ```\n */\nexport function createKubb(userConfig: UserConfig, options: CreateKubbOptions = {}): Kubb {\n const hooks = options.hooks ?? new AsyncEventEmitter<KubbHooks>()\n let setupResult: SetupResult | undefined\n\n const instance: Kubb = {\n get hooks() {\n return hooks\n },\n get sources() {\n return setupResult?.sources ?? new Map()\n },\n get driver() {\n return setupResult?.driver\n },\n get config() {\n return setupResult?.config\n },\n async setup() {\n setupResult = await setup(userConfig, { hooks })\n },\n async build() {\n if (!setupResult) {\n await instance.setup()\n }\n return build(setupResult!)\n },\n async safeBuild() {\n if (!setupResult) {\n await instance.setup()\n }\n return safeBuild(setupResult!)\n },\n }\n\n return instance\n}\n","import type { FileNode } from '@kubb/ast'\n\n/**\n * Minimal interface any Kubb renderer must satisfy.\n *\n * The generic `TElement` is the type of the element the renderer accepts —\n * e.g. `KubbReactElement` for `@kubb/renderer-jsx`, or a custom type for\n * your own renderer. Defaults to `unknown` so that generators which do not\n * care about the element type continue to work without specifying it.\n *\n * This allows core to drive rendering without a hard dependency on\n * `@kubb/renderer-jsx` or any specific renderer implementation.\n */\nexport type Renderer<TElement = unknown> = {\n render(element: TElement): Promise<void>\n unmount(error?: Error | number | null): void\n readonly files: Array<FileNode>\n}\n\n/**\n * A factory function that produces a fresh {@link Renderer} per render.\n *\n * Generators use this to declare which renderer handles their output.\n */\nexport type RendererFactory<TElement = unknown> = () => Renderer<TElement>\n\n/**\n * Creates a renderer factory for use in generator definitions.\n *\n * Wrap your renderer factory function with this helper to register it as the\n * renderer for a generator. Core will call this factory once per render cycle\n * to obtain a fresh renderer instance.\n *\n * @example\n * ```ts\n * // packages/renderer-jsx/src/index.ts\n * export const jsxRenderer = createRenderer(() => {\n * const runtime = new Runtime()\n * return {\n * async render(element) { await runtime.render(element) },\n * get files() { return runtime.nodes },\n * unmount(error) { runtime.unmount(error) },\n * }\n * })\n *\n * // packages/plugin-zod/src/generators/zodGenerator.tsx\n * import { jsxRenderer } from '@kubb/renderer-jsx'\n * export const zodGenerator = defineGenerator<PluginZod>({\n * name: 'zod',\n * renderer: jsxRenderer,\n * schema(node, options) { return <File ...>...</File> },\n * })\n * ```\n */\nexport function createRenderer<TElement = unknown>(factory: RendererFactory<TElement>): RendererFactory<TElement> {\n return factory\n}\n","import type { PossiblePromise } from '@internals/utils'\nimport type { FileNode, OperationNode, SchemaNode } from '@kubb/ast'\nimport type { RendererFactory } from './createRenderer.ts'\nimport type { GeneratorContext, PluginFactoryOptions } from './types.ts'\n\nexport type { GeneratorContext } from './types.ts'\n\n/**\n * Declares a named generator unit that walks the AST and emits files.\n *\n * Each method (`schema`, `operation`, `operations`) is called for the matching node type.\n * Each method returns `TElement | Array<FileNode> | void`. JSX-based generators require a `renderer` factory.\n * Return `Array<FileNode>` directly or call `ctx.upsertFile()` manually and return `void` to bypass rendering.\n *\n * @note Generators are consumed by plugins and registered via `ctx.addGenerator()` in `kubb:plugin:setup`.\n *\n * @example\n * ```ts\n * import { defineGenerator } from '@kubb/core'\n * import { jsxRenderer } from '@kubb/renderer-jsx'\n *\n * export const typeGenerator = defineGenerator({\n * name: 'typescript',\n * renderer: jsxRenderer,\n * schema(node, ctx) {\n * const { adapter, resolver, root, options } = ctx\n * return <File ...><Type node={node} resolver={resolver} /></File>\n * },\n * })\n * ```\n */\nexport type Generator<TOptions extends PluginFactoryOptions = PluginFactoryOptions, TElement = unknown> = {\n /**\n * Used in diagnostic messages and debug output.\n */\n name: string\n /**\n * Optional renderer factory that produces a {@link Renderer} for each render cycle.\n *\n * Generators that return renderer elements (e.g. JSX via `@kubb/renderer-jsx`) must set this\n * to the matching renderer factory (e.g. `jsxRenderer` from `@kubb/renderer-jsx`).\n *\n * Generators that only return `Array<FileNode>` or `void` do not need to set this.\n *\n * Set `renderer: null` to explicitly opt out of rendering even when the parent plugin\n * declares a `renderer` (overrides the plugin-level fallback).\n *\n * @example\n * ```ts\n * import { jsxRenderer } from '@kubb/renderer-jsx'\n * export const myGenerator = defineGenerator<PluginTs>({\n * renderer: jsxRenderer,\n * schema(node, ctx) { return <File ...>...</File> },\n * })\n * ```\n */\n renderer?: RendererFactory<TElement> | null\n /**\n * Called for each schema node in the AST walk.\n * `ctx` carries the plugin context with `adapter` and `inputNode` guaranteed present,\n * plus `ctx.options` with the per-node resolved options (after exclude/include/override).\n */\n schema?: (node: SchemaNode, ctx: GeneratorContext<TOptions>) => PossiblePromise<TElement | Array<FileNode> | void>\n /**\n * Called for each operation node in the AST walk.\n * `ctx` carries the plugin context with `adapter` and `inputNode` guaranteed present,\n * plus `ctx.options` with the per-node resolved options (after exclude/include/override).\n */\n operation?: (node: OperationNode, ctx: GeneratorContext<TOptions>) => PossiblePromise<TElement | Array<FileNode> | void>\n /**\n * Called once after all operations have been walked.\n * `ctx` carries the plugin context with `adapter` and `inputNode` guaranteed present,\n * plus `ctx.options` with the plugin-level options for the batch call.\n */\n operations?: (nodes: Array<OperationNode>, ctx: GeneratorContext<TOptions>) => PossiblePromise<TElement | Array<FileNode> | void>\n}\n\n/**\n * Defines a generator. Returns the object as-is with correct `this` typings.\n * `applyHookResult` handles renderer elements and `File[]` uniformly using\n * the generator's declared `renderer` factory.\n */\nexport function defineGenerator<TOptions extends PluginFactoryOptions = PluginFactoryOptions, TElement = unknown>(\n generator: Generator<TOptions, TElement>,\n): Generator<TOptions, TElement> {\n return generator\n}\n","import type { Logger, LoggerOptions, UserLogger } from './types.ts'\n\n/**\n * Wraps a logger definition into a typed {@link Logger}.\n *\n * @example\n * ```ts\n * export const myLogger = defineLogger({\n * name: 'my-logger',\n * install(context, options) {\n * context.on('kubb:info', (message) => console.log('ℹ', message))\n * context.on('kubb:error', (error) => console.error('✗', error.message))\n * },\n * })\n * ```\n */\nexport function defineLogger<Options extends LoggerOptions = LoggerOptions>(logger: UserLogger<Options>): Logger<Options> {\n return logger\n}\n","import type { KubbHooks } from './Kubb.ts'\n\n/**\n * A middleware instance produced by calling a factory created with `defineMiddleware`.\n * It declares event handlers under a `hooks` object which are registered on the\n * shared emitter after all plugin hooks, so middleware handlers for any event\n * always fire last.\n */\nexport type Middleware = {\n /**\n * Unique identifier for this middleware.\n */\n name: string\n /**\n * Lifecycle event handlers for this middleware.\n * Any event from the global `KubbHooks` map can be subscribed to here.\n * Handlers are registered after all plugin handlers, so they always fire last.\n */\n hooks: {\n [K in keyof KubbHooks]?: (...args: KubbHooks[K]) => void | Promise<void>\n }\n}\n\n/**\n * Creates a middleware factory using the hook-style `hooks` API.\n *\n * Middleware handlers fire after all plugin handlers for any given event, making them ideal for post-processing, logging, and auditing.\n * Per-build state (such as accumulators) belongs inside the factory closure so each `createKubb` invocation gets its own isolated instance.\n *\n * @note The factory can accept typed options. See examples for using options and per-build state patterns.\n *\n * @example\n * ```ts\n * import { defineMiddleware } from '@kubb/core'\n *\n * // Stateless middleware\n * export const logMiddleware = defineMiddleware(() => ({\n * name: 'log-middleware',\n * hooks: {\n * 'kubb:build:end'({ files }) {\n * console.log(`Build complete with ${files.length} files`)\n * },\n * },\n * }))\n *\n * // Middleware with options and per-build state\n * export const prefixMiddleware = defineMiddleware((options: { prefix: string } = { prefix: '' }) => {\n * const seen = new Set<string>()\n * return {\n * name: 'prefix-middleware',\n * hooks: {\n * 'kubb:plugin:end'({ plugin }) {\n * seen.add(`${options.prefix}${plugin.name}`)\n * },\n * },\n * }\n * })\n * ```\n */\nexport function defineMiddleware<TOptions extends object = object>(factory: (options: TOptions) => Middleware): (options?: TOptions) => Middleware {\n return (options) => factory(options ?? ({} as TOptions))\n}\n","import type { FileNode } from '@kubb/ast'\n\ntype PrintOptions = {\n extname?: FileNode['extname']\n}\n\nexport type Parser<TMeta extends object = any> = {\n name: string\n /**\n * File extensions this parser handles.\n * Use `undefined` to create a catch-all fallback parser.\n *\n * @example Handled extensions\n * `['.ts', '.js']`\n */\n extNames: Array<FileNode['extname']> | undefined\n /**\n * Convert a resolved file to a string.\n */\n parse(file: FileNode<TMeta>, options?: PrintOptions): Promise<string> | string\n}\n\n/**\n * Defines a parser with type safety. Creates parsers that transform generated files to strings based on their extension.\n *\n * @note Call the returned factory with optional options to instantiate the parser.\n *\n * @example\n * ```ts\n * import { defineParser } from '@kubb/core'\n *\n * export const jsonParser = defineParser({\n * name: 'json',\n * extNames: ['.json'],\n * parse(file) {\n * const { extractStringsFromNodes } = await import('@kubb/ast')\n * return file.sources.map((s) => extractStringsFromNodes(s.nodes ?? [])).join('\\n')\n * },\n * })\n * ```\n */\nexport function defineParser<TMeta extends object = any>(parser: Parser<TMeta>): Parser<TMeta> {\n return parser\n}\n","import type { KubbHooks } from './Kubb.ts'\nimport type { KubbPluginSetupContext, PluginFactoryOptions } from './types.ts'\n\n/**\n * A plugin object produced by `definePlugin`.\n * Instead of flat lifecycle methods, it groups all handlers under a `hooks:` property\n * (matching Astro's integration naming convention).\n *\n * @template TFactory - The plugin's `PluginFactoryOptions` type.\n */\nexport type Plugin<TFactory extends PluginFactoryOptions = PluginFactoryOptions> = {\n /**\n * Unique name for the plugin, following the same naming convention as `createPlugin`.\n */\n name: string\n /**\n * Plugins that must be registered before this plugin executes.\n * An error is thrown at startup when any listed dependency is missing.\n */\n dependencies?: Array<string>\n /**\n * Controls the execution order of this plugin relative to others.\n *\n * - `'pre'` — runs before all normal plugins.\n * - `'post'` — runs after all normal plugins.\n * - `undefined` (default) — runs in declaration order among normal plugins.\n *\n * Dependency constraints always take precedence over `enforce`.\n */\n enforce?: 'pre' | 'post'\n /**\n * The options passed by the user when calling the plugin factory.\n */\n options?: TFactory['options']\n /**\n * Lifecycle event handlers for this plugin.\n * Any event from the global `KubbHooks` map can be subscribed to here.\n */\n hooks: {\n [K in Exclude<keyof KubbHooks, 'kubb:plugin:setup'>]?: (...args: KubbHooks[K]) => void | Promise<void>\n } & {\n 'kubb:plugin:setup'?(ctx: KubbPluginSetupContext<TFactory>): void | Promise<void>\n }\n}\n\n/**\n * Returns `true` when `plugin` is a hook-style plugin created with `definePlugin`.\n *\n * Used by `PluginDriver` to distinguish hook-style plugins from legacy `createPlugin` plugins\n * so it can normalize them and register their handlers on the `AsyncEventEmitter`.\n */\nexport function isPlugin(plugin: unknown): plugin is Plugin {\n return typeof plugin === 'object' && plugin !== null && 'hooks' in plugin\n}\n\n/**\n * Wraps a factory function and returns a typed `Plugin` with lifecycle handlers grouped under `hooks`.\n *\n * Handlers live in a single `hooks` object (inspired by Astro integrations).\n * All lifecycle events from `KubbHooks` are available for subscription.\n *\n * @note For real plugins, use a `PluginFactoryOptions` type parameter to get type-safe context in `kubb:plugin:setup`.\n * Plugin names should follow the convention `plugin-<feature>` (e.g., `plugin-react-query`, `plugin-zod`).\n *\n * @example\n * ```ts\n * import { definePlugin } from '@kubb/core'\n *\n * export const pluginTs = definePlugin((options: { prefix?: string } = {}) => ({\n * name: 'plugin-ts',\n * hooks: {\n * 'kubb:plugin:setup'(ctx) {\n * ctx.setResolver(resolverTs)\n * },\n * },\n * }))\n * ```\n */\nexport function definePlugin<TFactory extends PluginFactoryOptions = PluginFactoryOptions>(\n factory: (options: TFactory['options']) => Plugin<TFactory>,\n): (options?: TFactory['options']) => Plugin<TFactory> {\n return (options) => factory(options ?? ({} as TFactory['options']))\n}\n","import { createStorage } from '../createStorage.ts'\n\n/**\n * In-memory storage driver. Useful for testing and dry-run scenarios where\n * generated output should be captured without touching the filesystem.\n *\n * All data lives in a `Map` scoped to the storage instance and is discarded\n * when the instance is garbage-collected.\n *\n * @example\n * ```ts\n * import { memoryStorage } from '@kubb/core'\n * import { defineConfig } from 'kubb'\n *\n * export default defineConfig({\n * input: { path: './petStore.yaml' },\n * output: { path: './src/gen' },\n * storage: memoryStorage(),\n * })\n * ```\n */\nexport const memoryStorage = createStorage(() => {\n const store = new Map<string, string>()\n\n return {\n name: 'memory',\n async hasItem(key: string) {\n return store.has(key)\n },\n async getItem(key: string) {\n return store.get(key) ?? null\n },\n async setItem(key: string, value: string) {\n store.set(key, value)\n },\n async removeItem(key: string) {\n store.delete(key)\n },\n async getKeys(base?: string) {\n const keys = [...store.keys()]\n return base ? keys.filter((k) => k.startsWith(base)) : keys\n },\n async clear(base?: string) {\n if (!base) {\n store.clear()\n return\n }\n for (const key of store.keys()) {\n if (key.startsWith(base)) {\n store.delete(key)\n }\n }\n },\n }\n})\n"],"x_google_ignoreList":[7,8],"mappings":"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"}
1
+ {"version":3,"file":"index.cjs","names":["#emitter","NodeEventEmitter","#options","camelCase","#transformParam","#eachParam","#head","#tail","#size","#limit","DEFAULT_EXTENSION","DEFAULT_BANNER","DEFAULT_STUDIO_URL","PluginDriver","applyHookResult"],"sources":["../../../internals/utils/src/errors.ts","../../../internals/utils/src/asyncEventEmitter.ts","../../../internals/utils/src/time.ts","../../../internals/utils/src/fs.ts","../../../internals/utils/src/reserved.ts","../../../internals/utils/src/urlPath.ts","../src/createAdapter.ts","../../../node_modules/.pnpm/yocto-queue@1.2.2/node_modules/yocto-queue/index.js","../../../node_modules/.pnpm/p-limit@7.3.0/node_modules/p-limit/index.js","../src/FileProcessor.ts","../src/createStorage.ts","../src/storages/fsStorage.ts","../package.json","../src/utils/diagnostics.ts","../src/utils/isInputPath.ts","../src/createKubb.ts","../src/createRenderer.ts","../src/defineGenerator.ts","../src/defineLogger.ts","../src/defineMiddleware.ts","../src/defineParser.ts","../src/definePlugin.ts","../src/storages/memoryStorage.ts"],"sourcesContent":["/**\n * Thrown when one or more errors occur during a Kubb build.\n * Carries the full list of underlying errors on `errors`.\n *\n * @example\n * ```ts\n * throw new BuildError('Build failed', { errors: [err1, err2] })\n * ```\n */\nexport class BuildError extends Error {\n errors: Array<Error>\n\n constructor(message: string, options: { cause?: Error; errors: Array<Error> }) {\n super(message, { cause: options.cause })\n this.name = 'BuildError'\n this.errors = options.errors\n }\n}\n\n/**\n * Coerces an unknown thrown value to an `Error` instance.\n * Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.\n *\n * @example\n * ```ts\n * try { ... } catch(err) {\n * throw new BuildError('Build failed', { cause: toError(err), errors: [] })\n * }\n * ```\n */\nexport function toError(value: unknown): Error {\n return value instanceof Error ? value : new Error(String(value))\n}\n\n/**\n * Extracts a human-readable message from any thrown value.\n *\n * @example\n * ```ts\n * getErrorMessage(new Error('oops')) // 'oops'\n * getErrorMessage('plain string') // 'plain string'\n * ```\n */\nexport function getErrorMessage(value: unknown): string {\n return value instanceof Error ? value.message : String(value)\n}\n\n/**\n * Extracts the `.cause` of an `Error` as an `Error`, or `undefined` when absent or not an `Error`.\n *\n * @example\n * ```ts\n * const cause = toCause(buildError) // Error | undefined\n * ```\n */\nexport function toCause(error: Error): Error | undefined {\n return error.cause instanceof Error ? error.cause : undefined\n}\n","import { EventEmitter as NodeEventEmitter } from 'node:events'\nimport { toError } from './errors.ts'\n\n/**\n * A function that can be registered as an event listener, synchronous or async.\n */\ntype AsyncListener<TArgs extends unknown[]> = (...args: TArgs) => void | Promise<void>\n\n/**\n * Typed `EventEmitter` that awaits all async listeners before resolving.\n * Wraps Node's `EventEmitter` with full TypeScript event-map inference.\n *\n * @example\n * ```ts\n * const emitter = new AsyncEventEmitter<{ build: [name: string] }>()\n * emitter.on('build', async (name) => { console.log(name) })\n * await emitter.emit('build', 'petstore') // all listeners awaited\n * ```\n */\nexport class AsyncEventEmitter<TEvents extends { [K in keyof TEvents]: unknown[] }> {\n /**\n * Maximum number of listeners per event before Node emits a memory-leak warning.\n * @default 10\n */\n constructor(maxListener = 10) {\n this.#emitter.setMaxListeners(maxListener)\n }\n\n #emitter = new NodeEventEmitter()\n\n /**\n * Emits `eventName` and awaits all registered listeners sequentially.\n * Throws if any listener rejects, wrapping the cause with the event name and serialized arguments.\n *\n * @example\n * ```ts\n * await emitter.emit('build', 'petstore')\n * ```\n */\n async emit<TEventName extends keyof TEvents & string>(eventName: TEventName, ...eventArgs: TEvents[TEventName]): Promise<void> {\n const listeners = this.#emitter.listeners(eventName) as Array<AsyncListener<TEvents[TEventName]>>\n\n if (listeners.length === 0) {\n return\n }\n\n for (const listener of listeners) {\n try {\n await listener(...eventArgs)\n } catch (err) {\n let serializedArgs: string\n try {\n serializedArgs = JSON.stringify(eventArgs)\n } catch {\n serializedArgs = String(eventArgs)\n }\n throw new Error(`Error in async listener for \"${eventName}\" with eventArgs ${serializedArgs}`, { cause: toError(err) })\n }\n }\n }\n\n /**\n * Registers a persistent listener for `eventName`.\n *\n * @example\n * ```ts\n * emitter.on('build', async (name) => { console.log(name) })\n * ```\n */\n on<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n this.#emitter.on(eventName, handler as AsyncListener<unknown[]>)\n }\n\n /**\n * Registers a one-shot listener that removes itself after the first invocation.\n *\n * @example\n * ```ts\n * emitter.onOnce('build', async (name) => { console.log(name) })\n * ```\n */\n onOnce<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n const wrapper: AsyncListener<TEvents[TEventName]> = (...args) => {\n this.off(eventName, wrapper)\n return handler(...args)\n }\n this.on(eventName, wrapper)\n }\n\n /**\n * Removes a previously registered listener.\n *\n * @example\n * ```ts\n * emitter.off('build', handler)\n * ```\n */\n off<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n this.#emitter.off(eventName, handler as AsyncListener<unknown[]>)\n }\n\n /**\n * Returns the number of listeners registered for `eventName`.\n *\n * @example\n * ```ts\n * emitter.on('build', handler)\n * emitter.listenerCount('build') // 1\n * ```\n */\n listenerCount<TEventName extends keyof TEvents & string>(eventName: TEventName): number {\n return this.#emitter.listenerCount(eventName)\n }\n\n /**\n * Removes all listeners from every event channel.\n *\n * @example\n * ```ts\n * emitter.removeAll()\n * ```\n */\n removeAll(): void {\n this.#emitter.removeAllListeners()\n }\n}\n","/**\n * Calculates elapsed time in milliseconds from a high-resolution `process.hrtime` start time.\n * Rounds to 2 decimal places for sub-millisecond precision without noise.\n *\n * @example\n * ```ts\n * const start = process.hrtime()\n * doWork()\n * getElapsedMs(start) // 42.35\n * ```\n */\nexport function getElapsedMs(hrStart: [number, number]): number {\n const [seconds, nanoseconds] = process.hrtime(hrStart)\n const ms = seconds * 1000 + nanoseconds / 1e6\n return Math.round(ms * 100) / 100\n}\n\n/**\n * Converts a millisecond duration into a human-readable string (`ms`, `s`, or `m s`).\n *\n * @example\n * ```ts\n * formatMs(250) // '250ms'\n * formatMs(1500) // '1.50s'\n * formatMs(90000) // '1m 30.0s'\n * ```\n */\nexport function formatMs(ms: number): string {\n if (ms >= 60000) {\n const mins = Math.floor(ms / 60000)\n const secs = ((ms % 60000) / 1000).toFixed(1)\n return `${mins}m ${secs}s`\n }\n\n if (ms >= 1000) {\n return `${(ms / 1000).toFixed(2)}s`\n }\n return `${Math.round(ms)}ms`\n}\n\n/**\n * Formats the elapsed time since `hrStart` as a human-readable string.\n *\n * @example\n * ```ts\n * const start = process.hrtime()\n * doWork()\n * formatHrtime(start) // '1.50s'\n * ```\n */\nexport function formatHrtime(hrStart: [number, number]): string {\n return formatMs(getElapsedMs(hrStart))\n}\n","import { existsSync, readFileSync } from 'node:fs'\nimport { access, mkdir, readFile, rm, writeFile } from 'node:fs/promises'\nimport { dirname, join, posix, resolve } from 'node:path'\n\n/**\n * Walks up the directory tree from `cwd` (defaults to `process.cwd()`) and\n * returns the absolute path of the nearest `package.json`, or `null` when none\n * is found before reaching the filesystem root.\n *\n * @example\n * ```ts\n * const pkgPath = findPackageJSON('/home/user/project/src') // '/home/user/project/package.json'\n * ```\n */\nexport function findPackageJSON(cwd?: string): string | null {\n let dir = cwd ? resolve(cwd) : process.cwd()\n while (true) {\n const pkgPath = join(dir, 'package.json')\n if (existsSync(pkgPath)) return pkgPath\n const parent = dirname(dir)\n if (parent === dir) return null\n dir = parent\n }\n}\n\n/**\n * Converts all backslashes to forward slashes.\n * Extended-length Windows paths (`\\\\?\\...`) are left unchanged.\n */\nfunction toSlash(p: string): string {\n if (p.startsWith('\\\\\\\\?\\\\')) return p\n return p.replaceAll('\\\\', '/')\n}\n\n/**\n * Returns the relative path from `rootDir` to `filePath`, always using forward slashes\n * and prefixed with `./` when not already traversing upward.\n *\n * @example\n * ```ts\n * getRelativePath('/src/components', '/src/components/Button.tsx') // './Button.tsx'\n * getRelativePath('/src/components', '/src/utils/helpers.ts') // '../utils/helpers.ts'\n * ```\n */\nexport function getRelativePath(rootDir?: string | null, filePath?: string | null): string {\n if (!rootDir || !filePath) {\n throw new Error(`Root and file should be filled in when retrieving the relativePath, ${rootDir || ''} ${filePath || ''}`)\n }\n\n const relativePath = posix.relative(toSlash(rootDir), toSlash(filePath))\n\n return relativePath.startsWith('../') ? relativePath : `./${relativePath}`\n}\n\n/**\n * Resolves to `true` when the file or directory at `path` exists.\n * Uses `Bun.file().exists()` when running under Bun, `fs.access` otherwise.\n *\n * @example\n * ```ts\n * if (await exists('./kubb.config.ts')) {\n * const content = await read('./kubb.config.ts')\n * }\n * ```\n */\nexport async function exists(path: string): Promise<boolean> {\n if (typeof Bun !== 'undefined') {\n return Bun.file(path).exists()\n }\n return access(path).then(\n () => true,\n () => false,\n )\n}\n\n/**\n * Reads the file at `path` as a UTF-8 string.\n * Uses `Bun.file().text()` when running under Bun, `fs.readFile` otherwise.\n *\n * @example\n * ```ts\n * const source = await read('./src/Pet.ts')\n * ```\n */\nexport async function read(path: string): Promise<string> {\n if (typeof Bun !== 'undefined') {\n return Bun.file(path).text()\n }\n return readFile(path, { encoding: 'utf8' })\n}\n\n/**\n * Synchronous counterpart of `read`.\n *\n * @example\n * ```ts\n * const source = readSync('./src/Pet.ts')\n * ```\n */\nexport function readSync(path: string): string {\n return readFileSync(path, { encoding: 'utf8' })\n}\n\ntype WriteOptions = {\n /**\n * When `true`, re-reads the file immediately after writing and throws if the\n * content does not match — useful for catching write failures on unreliable file systems.\n */\n sanity?: boolean\n}\n\n/**\n * Writes `data` to `path`, trimming leading/trailing whitespace before saving.\n * Skips the write when the trimmed content is empty or identical to what is already on disk.\n * Creates any missing parent directories automatically.\n * When `sanity` is `true`, re-reads the file after writing and throws if the content does not match.\n *\n * @example\n * ```ts\n * await write('./src/Pet.ts', source) // writes and returns trimmed content\n * await write('./src/Pet.ts', source) // null — file unchanged\n * await write('./src/Pet.ts', ' ') // null — empty content skipped\n * ```\n */\nexport async function write(path: string, data: string, options: WriteOptions = {}): Promise<string | null> {\n const trimmed = data.trim()\n if (trimmed === '') return null\n\n const resolved = resolve(path)\n\n if (typeof Bun !== 'undefined') {\n const file = Bun.file(resolved)\n const oldContent = (await file.exists()) ? await file.text() : null\n if (oldContent === trimmed) return null\n await Bun.write(resolved, trimmed)\n return trimmed\n }\n\n try {\n const oldContent = await readFile(resolved, { encoding: 'utf-8' })\n if (oldContent === trimmed) return null\n } catch {\n /* file doesn't exist yet */\n }\n\n await mkdir(dirname(resolved), { recursive: true })\n await writeFile(resolved, trimmed, { encoding: 'utf-8' })\n\n if (options.sanity) {\n const savedData = await readFile(resolved, { encoding: 'utf-8' })\n if (savedData !== trimmed) {\n throw new Error(`Sanity check failed for ${path}\\n\\nData[${data.length}]:\\n${data}\\n\\nSaved[${savedData.length}]:\\n${savedData}\\n`)\n }\n return savedData\n }\n\n return trimmed\n}\n\n/**\n * Recursively removes `path`. Silently succeeds when `path` does not exist.\n *\n * @example\n * ```ts\n * await clean('./dist')\n * ```\n */\nexport async function clean(path: string): Promise<void> {\n return rm(path, { recursive: true, force: true })\n}\n","/**\n * JavaScript and Java reserved words.\n * @link https://github.com/jonschlinkert/reserved/blob/master/index.js\n */\nconst reservedWords = new Set([\n 'abstract',\n 'arguments',\n 'boolean',\n 'break',\n 'byte',\n 'case',\n 'catch',\n 'char',\n 'class',\n 'const',\n 'continue',\n 'debugger',\n 'default',\n 'delete',\n 'do',\n 'double',\n 'else',\n 'enum',\n 'eval',\n 'export',\n 'extends',\n 'false',\n 'final',\n 'finally',\n 'float',\n 'for',\n 'function',\n 'goto',\n 'if',\n 'implements',\n 'import',\n 'in',\n 'instanceof',\n 'int',\n 'interface',\n 'let',\n 'long',\n 'native',\n 'new',\n 'null',\n 'package',\n 'private',\n 'protected',\n 'public',\n 'return',\n 'short',\n 'static',\n 'super',\n 'switch',\n 'synchronized',\n 'this',\n 'throw',\n 'throws',\n 'transient',\n 'true',\n 'try',\n 'typeof',\n 'var',\n 'void',\n 'volatile',\n 'while',\n 'with',\n 'yield',\n 'Array',\n 'Date',\n 'hasOwnProperty',\n 'Infinity',\n 'isFinite',\n 'isNaN',\n 'isPrototypeOf',\n 'length',\n 'Math',\n 'name',\n 'NaN',\n 'Number',\n 'Object',\n 'prototype',\n 'String',\n 'toString',\n 'undefined',\n 'valueOf',\n] as const)\n\n/**\n * Prefixes `word` with `_` when it is a reserved JavaScript/Java identifier or starts with a digit.\n *\n * @example\n * ```ts\n * transformReservedWord('class') // '_class'\n * transformReservedWord('42foo') // '_42foo'\n * transformReservedWord('status') // 'status'\n * ```\n */\nexport function transformReservedWord(word: string): string {\n const firstChar = word.charCodeAt(0)\n if (word && (reservedWords.has(word as 'valueOf') || (firstChar >= 48 && firstChar <= 57))) {\n return `_${word}`\n }\n return word\n}\n\n/**\n * Returns `true` when `name` is a syntactically valid JavaScript variable name.\n *\n * @example\n * ```ts\n * isValidVarName('status') // true\n * isValidVarName('class') // false (reserved word)\n * isValidVarName('42foo') // false (starts with digit)\n * ```\n */\nexport function isValidVarName(name: string): boolean {\n if (!name || reservedWords.has(name as 'valueOf')) {\n return false\n }\n return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name)\n}\n","import { camelCase } from './casing.ts'\nimport { isValidVarName } from './reserved.ts'\n\nexport type URLObject = {\n /**\n * The resolved URL string (Express-style or template literal, depending on context).\n */\n url: string\n /**\n * Extracted path parameters as a key-value map, or `undefined` when the path has none.\n */\n params?: Record<string, string>\n}\n\ntype ObjectOptions = {\n /**\n * Controls whether the `url` is rendered as an Express path or a template literal.\n * @default 'path'\n */\n type?: 'path' | 'template'\n /**\n * Optional transform applied to each extracted parameter name.\n */\n replacer?: (pathParam: string) => string\n /**\n * When `true`, the result is serialized to a string expression instead of a plain object.\n */\n stringify?: boolean\n}\n\n/**\n * Supported identifier casing strategies for path parameters.\n */\ntype PathCasing = 'camelcase'\n\ntype Options = {\n /**\n * Casing strategy applied to path parameter names.\n * @default undefined (original identifier preserved)\n */\n casing?: PathCasing\n}\n\n/**\n * Parses and transforms an OpenAPI/Swagger path string into various URL formats.\n *\n * @example\n * const p = new URLPath('/pet/{petId}')\n * p.URL // '/pet/:petId'\n * p.template // '`/pet/${petId}`'\n */\nexport class URLPath {\n /**\n * The raw OpenAPI/Swagger path string, e.g. `/pet/{petId}`.\n */\n path: string\n\n #options: Options\n\n constructor(path: string, options: Options = {}) {\n this.path = path\n this.#options = options\n }\n\n /** Converts the OpenAPI path to Express-style colon syntax, e.g. `/pet/{petId}` → `/pet/:petId`.\n *\n * @example\n * ```ts\n * new URLPath('/pet/{petId}').URL // '/pet/:petId'\n * ```\n */\n get URL(): string {\n return this.toURLPath()\n }\n\n /** Returns `true` when `path` is a fully-qualified URL (e.g. starts with `https://`).\n *\n * @example\n * ```ts\n * new URLPath('https://petstore.swagger.io/v2/pet').isURL // true\n * new URLPath('/pet/{petId}').isURL // false\n * ```\n */\n get isURL(): boolean {\n try {\n return !!new URL(this.path).href\n } catch {\n return false\n }\n }\n\n /**\n * Converts the OpenAPI path to a TypeScript template literal string.\n *\n * @example\n * new URLPath('/pet/{petId}').template // '`/pet/${petId}`'\n * new URLPath('/account/monetary-accountID').template // '`/account/${monetaryAccountId}`'\n */\n get template(): string {\n return this.toTemplateString()\n }\n\n /** Returns the path and its extracted params as a structured `URLObject`, or as a stringified expression when `stringify` is set.\n *\n * @example\n * ```ts\n * new URLPath('/pet/{petId}').object\n * // { url: '/pet/:petId', params: { petId: 'petId' } }\n * ```\n */\n get object(): URLObject | string {\n return this.toObject()\n }\n\n /** Returns a map of path parameter names, or `undefined` when the path has no parameters.\n *\n * @example\n * ```ts\n * new URLPath('/pet/{petId}').params // { petId: 'petId' }\n * new URLPath('/pet').params // undefined\n * ```\n */\n get params(): Record<string, string> | undefined {\n return this.getParams()\n }\n\n #transformParam(raw: string): string {\n const param = isValidVarName(raw) ? raw : camelCase(raw)\n return this.#options.casing === 'camelcase' ? camelCase(param) : param\n }\n\n /**\n * Iterates over every `{param}` token in `path`, calling `fn` with the raw token and transformed name.\n */\n #eachParam(fn: (raw: string, param: string) => void): void {\n for (const match of this.path.matchAll(/\\{([^}]+)\\}/g)) {\n const raw = match[1]!\n fn(raw, this.#transformParam(raw))\n }\n }\n\n toObject({ type = 'path', replacer, stringify }: ObjectOptions = {}): URLObject | string {\n const object = {\n url: type === 'path' ? this.toURLPath() : this.toTemplateString({ replacer }),\n params: this.getParams(),\n }\n\n if (stringify) {\n if (type === 'template') {\n return JSON.stringify(object).replaceAll(\"'\", '').replaceAll(`\"`, '')\n }\n\n if (object.params) {\n return `{ url: '${object.url}', params: ${JSON.stringify(object.params).replaceAll(\"'\", '').replaceAll(`\"`, '')} }`\n }\n\n return `{ url: '${object.url}' }`\n }\n\n return object\n }\n\n /**\n * Converts the OpenAPI path to a TypeScript template literal string.\n * An optional `replacer` can transform each extracted parameter name before interpolation.\n *\n * @example\n * new URLPath('/pet/{petId}').toTemplateString() // '`/pet/${petId}`'\n */\n toTemplateString({\n prefix = '',\n replacer,\n }: {\n prefix?: string\n replacer?: (pathParam: string) => string\n } = {}): string {\n const parts = this.path.split(/\\{([^}]+)\\}/)\n const result = parts\n .map((part, i) => {\n if (i % 2 === 0) return part\n const param = this.#transformParam(part)\n return `\\${${replacer ? replacer(param) : param}}`\n })\n .join('')\n\n return `\\`${prefix}${result}\\``\n }\n\n /**\n * Extracts all `{param}` segments from the path and returns them as a key-value map.\n * An optional `replacer` transforms each parameter name in both key and value positions.\n * Returns `undefined` when no path parameters are found.\n *\n * @example\n * ```ts\n * new URLPath('/pet/{petId}/tag/{tagId}').getParams()\n * // { petId: 'petId', tagId: 'tagId' }\n * ```\n */\n getParams(replacer?: (pathParam: string) => string): Record<string, string> | undefined {\n const params: Record<string, string> = {}\n\n this.#eachParam((_raw, param) => {\n const key = replacer ? replacer(param) : param\n params[key] = key\n })\n\n return Object.keys(params).length > 0 ? params : undefined\n }\n\n /** Converts the OpenAPI path to Express-style colon syntax.\n *\n * @example\n * ```ts\n * new URLPath('/pet/{petId}').toURLPath() // '/pet/:petId'\n * ```\n */\n toURLPath(): string {\n return this.path.replace(/\\{([^}]+)\\}/g, ':$1')\n }\n}\n","import type { Adapter, AdapterFactoryOptions } from './types.ts'\n\ntype AdapterBuilder<T extends AdapterFactoryOptions> = (options: T['options']) => Adapter<T>\n\n/**\n * Factory for implementing custom adapters that translate non-OpenAPI specs into Kubb's AST.\n *\n * Use this to support GraphQL schemas, gRPC definitions, AsyncAPI, or custom domain-specific languages.\n * Built-in adapters include `@kubb/adapter-oas` for OpenAPI and Swagger documents.\n *\n * @note Adapters must parse their input format to Kubb's `InputNode` structure.\n *\n * @example\n * ```ts\n * export const myAdapter = createAdapter<MyAdapter>((options) => {\n * return {\n * name: 'my-adapter',\n * options,\n * async parse(source) {\n * // Transform source format to InputNode\n * return { ... }\n * },\n * }\n * })\n *\n * // Instantiate:\n * const adapter = myAdapter({ validate: true })\n * ```\n */\nexport function createAdapter<T extends AdapterFactoryOptions = AdapterFactoryOptions>(build: AdapterBuilder<T>): (options?: T['options']) => Adapter<T> {\n return (options) => build(options ?? ({} as T['options']))\n}\n","/*\nHow it works:\n`this.#head` is an instance of `Node` which keeps track of its current value and nests another instance of `Node` that keeps the value that comes after it. When a value is provided to `.enqueue()`, the code needs to iterate through `this.#head`, going deeper and deeper to find the last value. However, iterating through every single item is slow. This problem is solved by saving a reference to the last value as `this.#tail` so that it can reference it to add a new value.\n*/\n\nclass Node {\n\tvalue;\n\tnext;\n\n\tconstructor(value) {\n\t\tthis.value = value;\n\t}\n}\n\nexport default class Queue {\n\t#head;\n\t#tail;\n\t#size;\n\n\tconstructor() {\n\t\tthis.clear();\n\t}\n\n\tenqueue(value) {\n\t\tconst node = new Node(value);\n\n\t\tif (this.#head) {\n\t\t\tthis.#tail.next = node;\n\t\t\tthis.#tail = node;\n\t\t} else {\n\t\t\tthis.#head = node;\n\t\t\tthis.#tail = node;\n\t\t}\n\n\t\tthis.#size++;\n\t}\n\n\tdequeue() {\n\t\tconst current = this.#head;\n\t\tif (!current) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.#head = this.#head.next;\n\t\tthis.#size--;\n\n\t\t// Clean up tail reference when queue becomes empty\n\t\tif (!this.#head) {\n\t\t\tthis.#tail = undefined;\n\t\t}\n\n\t\treturn current.value;\n\t}\n\n\tpeek() {\n\t\tif (!this.#head) {\n\t\t\treturn;\n\t\t}\n\n\t\treturn this.#head.value;\n\n\t\t// TODO: Node.js 18.\n\t\t// return this.#head?.value;\n\t}\n\n\tclear() {\n\t\tthis.#head = undefined;\n\t\tthis.#tail = undefined;\n\t\tthis.#size = 0;\n\t}\n\n\tget size() {\n\t\treturn this.#size;\n\t}\n\n\t* [Symbol.iterator]() {\n\t\tlet current = this.#head;\n\n\t\twhile (current) {\n\t\t\tyield current.value;\n\t\t\tcurrent = current.next;\n\t\t}\n\t}\n\n\t* drain() {\n\t\twhile (this.#head) {\n\t\t\tyield this.dequeue();\n\t\t}\n\t}\n}\n","import Queue from 'yocto-queue';\n\nexport default function pLimit(concurrency) {\n\tlet rejectOnClear = false;\n\n\tif (typeof concurrency === 'object') {\n\t\t({concurrency, rejectOnClear = false} = concurrency);\n\t}\n\n\tvalidateConcurrency(concurrency);\n\n\tif (typeof rejectOnClear !== 'boolean') {\n\t\tthrow new TypeError('Expected `rejectOnClear` to be a boolean');\n\t}\n\n\tconst queue = new Queue();\n\tlet activeCount = 0;\n\n\tconst resumeNext = () => {\n\t\t// Process the next queued function if we're under the concurrency limit\n\t\tif (activeCount < concurrency && queue.size > 0) {\n\t\t\tactiveCount++;\n\t\t\tqueue.dequeue().run();\n\t\t}\n\t};\n\n\tconst next = () => {\n\t\tactiveCount--;\n\t\tresumeNext();\n\t};\n\n\tconst run = async (function_, resolve, arguments_) => {\n\t\t// Execute the function and capture the result promise\n\t\tconst result = (async () => function_(...arguments_))();\n\n\t\t// Resolve immediately with the promise (don't wait for completion)\n\t\tresolve(result);\n\n\t\t// Wait for the function to complete (success or failure)\n\t\t// We catch errors here to prevent unhandled rejections,\n\t\t// but the original promise rejection is preserved for the caller\n\t\ttry {\n\t\t\tawait result;\n\t\t} catch {}\n\n\t\t// Decrement active count and process next queued function\n\t\tnext();\n\t};\n\n\tconst enqueue = (function_, resolve, reject, arguments_) => {\n\t\tconst queueItem = {reject};\n\n\t\t// Queue the internal resolve function instead of the run function\n\t\t// to preserve the asynchronous execution context.\n\t\tnew Promise(internalResolve => { // eslint-disable-line promise/param-names\n\t\t\tqueueItem.run = internalResolve;\n\t\t\tqueue.enqueue(queueItem);\n\t\t}).then(run.bind(undefined, function_, resolve, arguments_)); // eslint-disable-line promise/prefer-await-to-then\n\n\t\t// Start processing immediately if we haven't reached the concurrency limit\n\t\tif (activeCount < concurrency) {\n\t\t\tresumeNext();\n\t\t}\n\t};\n\n\tconst generator = (function_, ...arguments_) => new Promise((resolve, reject) => {\n\t\tenqueue(function_, resolve, reject, arguments_);\n\t});\n\n\tObject.defineProperties(generator, {\n\t\tactiveCount: {\n\t\t\tget: () => activeCount,\n\t\t},\n\t\tpendingCount: {\n\t\t\tget: () => queue.size,\n\t\t},\n\t\tclearQueue: {\n\t\t\tvalue() {\n\t\t\t\tif (!rejectOnClear) {\n\t\t\t\t\tqueue.clear();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tconst abortError = AbortSignal.abort().reason;\n\n\t\t\t\twhile (queue.size > 0) {\n\t\t\t\t\tqueue.dequeue().reject(abortError);\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t\tconcurrency: {\n\t\t\tget: () => concurrency,\n\n\t\t\tset(newConcurrency) {\n\t\t\t\tvalidateConcurrency(newConcurrency);\n\t\t\t\tconcurrency = newConcurrency;\n\n\t\t\t\tqueueMicrotask(() => {\n\t\t\t\t\t// eslint-disable-next-line no-unmodified-loop-condition\n\t\t\t\t\twhile (activeCount < concurrency && queue.size > 0) {\n\t\t\t\t\t\tresumeNext();\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t},\n\t\t},\n\t\tmap: {\n\t\t\tasync value(iterable, function_) {\n\t\t\t\tconst promises = Array.from(iterable, (value, index) => this(function_, value, index));\n\t\t\t\treturn Promise.all(promises);\n\t\t\t},\n\t\t},\n\t});\n\n\treturn generator;\n}\n\nexport function limitFunction(function_, options) {\n\tconst limit = pLimit(options);\n\n\treturn (...arguments_) => limit(() => function_(...arguments_));\n}\n\nfunction validateConcurrency(concurrency) {\n\tif (!((Number.isInteger(concurrency) || concurrency === Number.POSITIVE_INFINITY) && concurrency > 0)) {\n\t\tthrow new TypeError('Expected `concurrency` to be a number from 1 and up');\n\t}\n}\n","import type { CodeNode, FileNode } from '@kubb/ast'\nimport { extractStringsFromNodes } from '@kubb/ast'\nimport pLimit from 'p-limit'\nimport { PARALLEL_CONCURRENCY_LIMIT } from './constants.ts'\nimport type { Parser } from './defineParser.ts'\n\ntype ParseOptions = {\n parsers?: Map<FileNode['extname'], Parser>\n extension?: Record<FileNode['extname'], FileNode['extname'] | ''>\n}\n\ntype RunOptions = ParseOptions & {\n /**\n * @default 'sequential'\n */\n mode?: 'sequential' | 'parallel'\n onStart?: (files: Array<FileNode>) => Promise<void> | void\n onEnd?: (files: Array<FileNode>) => Promise<void> | void\n onUpdate?: (params: { file: FileNode; source?: string; processed: number; total: number; percentage: number }) => Promise<void> | void\n}\n\nfunction joinSources(file: FileNode): string {\n return file.sources\n .map((item) => extractStringsFromNodes(item.nodes as Array<CodeNode>))\n .filter(Boolean)\n .join('\\n\\n')\n}\n\n/**\n * Converts a single file to a string using the registered parsers.\n * Falls back to joining source values when no matching parser is found.\n *\n * @internal\n */\nexport class FileProcessor {\n readonly #limit = pLimit(PARALLEL_CONCURRENCY_LIMIT)\n\n async parse(file: FileNode, { parsers, extension }: ParseOptions = {}): Promise<string> {\n const parseExtName = extension?.[file.extname] || undefined\n\n if (!parsers || !file.extname) {\n return joinSources(file)\n }\n\n const parser = parsers.get(file.extname)\n\n if (!parser) {\n return joinSources(file)\n }\n\n return parser.parse(file, { extname: parseExtName })\n }\n\n async run(files: Array<FileNode>, { parsers, mode = 'sequential', extension, onStart, onEnd, onUpdate }: RunOptions = {}): Promise<Array<FileNode>> {\n await onStart?.(files)\n\n const total = files.length\n let processed = 0\n\n const processOne = async (file: FileNode) => {\n const source = await this.parse(file, { extension, parsers })\n const currentProcessed = ++processed\n const percentage = (currentProcessed / total) * 100\n\n await onUpdate?.({\n file,\n source,\n processed: currentProcessed,\n percentage,\n total,\n })\n }\n\n if (mode === 'sequential') {\n for (const file of files) {\n await processOne(file)\n }\n } else {\n await Promise.all(files.map((file) => this.#limit(() => processOne(file))))\n }\n\n await onEnd?.(files)\n\n return files\n }\n}\n","export type Storage = {\n /**\n * Identifier used for logging and debugging (e.g. `'fs'`, `'s3'`).\n */\n readonly name: string\n /**\n * Returns `true` when an entry for `key` exists in storage.\n */\n hasItem(key: string): Promise<boolean>\n /**\n * Returns the stored string value, or `null` when `key` does not exist.\n */\n getItem(key: string): Promise<string | null>\n /**\n * Persists `value` under `key`, creating any required structure.\n */\n setItem(key: string, value: string): Promise<void>\n /**\n * Removes the entry for `key`. No-ops when the key does not exist.\n */\n removeItem(key: string): Promise<void>\n /**\n * Returns all keys, optionally filtered to those starting with `base`.\n */\n getKeys(base?: string): Promise<Array<string>>\n /**\n * Removes all entries, optionally scoped to those starting with `base`.\n */\n clear(base?: string): Promise<void>\n /**\n * Optional teardown hook called after the build completes.\n */\n dispose?(): Promise<void>\n}\n\n/**\n * Factory for implementing custom storage backends that control where generated files are written.\n *\n * Takes a builder function `(options: TOptions) => Storage` and returns a factory `(options?: TOptions) => Storage`.\n * Kubb provides filesystem and in-memory implementations out of the box.\n *\n * @note Call the returned factory with optional options to instantiate the storage adapter.\n *\n * @example\n * ```ts\n * import { createStorage } from '@kubb/core'\n *\n * export const memoryStorage = createStorage(() => {\n * const store = new Map<string, string>()\n * return {\n * name: 'memory',\n * async hasItem(key) { return store.has(key) },\n * async getItem(key) { return store.get(key) ?? null },\n * async setItem(key, value) { store.set(key, value) },\n * async removeItem(key) { store.delete(key) },\n * async getKeys(base) {\n * const keys = [...store.keys()]\n * return base ? keys.filter((k) => k.startsWith(base)) : keys\n * },\n * async clear(base) { if (!base) store.clear() },\n * }\n * })\n *\n * // Instantiate:\n * const storage = memoryStorage()\n * ```\n */\nexport function createStorage<TOptions = Record<string, never>>(build: (options: TOptions) => Storage): (options?: TOptions) => Storage {\n return (options) => build(options ?? ({} as TOptions))\n}\n","import type { Dirent } from 'node:fs'\nimport { access, readdir, readFile, rm } from 'node:fs/promises'\nimport { join, resolve } from 'node:path'\nimport { clean, write } from '@internals/utils'\nimport { createStorage } from '../createStorage.ts'\n\n/**\n * Detects the filesystem error used to indicate that a path does not exist.\n */\nfunction isMissingPathError(error: unknown): error is NodeJS.ErrnoException {\n return typeof error === 'object' && error !== null && 'code' in error && (error as NodeJS.ErrnoException).code === 'ENOENT'\n}\n\n/**\n * Built-in filesystem storage driver.\n *\n * This is the default storage when no `storage` option is configured in the root config.\n * Keys are resolved against `process.cwd()`, so root-relative paths such as\n * `src/gen/api/getPets.ts` are written to the correct location without extra configuration.\n *\n * Internally uses the `write` utility from `@internals/utils`, which:\n * - trims leading/trailing whitespace before writing\n * - skips the write when file content is already identical (deduplication)\n * - creates missing parent directories automatically\n * - supports Bun's native file API when running under Bun\n *\n * @example\n * ```ts\n * import { fsStorage } from '@kubb/core'\n * import { defineConfig } from 'kubb'\n *\n * export default defineConfig({\n * input: { path: './petStore.yaml' },\n * output: { path: './src/gen' },\n * storage: fsStorage(),\n * })\n * ```\n */\nexport const fsStorage = createStorage(() => ({\n name: 'fs',\n async hasItem(key: string) {\n try {\n await access(resolve(key))\n return true\n } catch (error) {\n if (isMissingPathError(error)) {\n return false\n }\n\n throw new Error(`Failed to access storage item \"${key}\"`, {\n cause: error as Error,\n })\n }\n },\n async getItem(key: string) {\n try {\n return await readFile(resolve(key), 'utf8')\n } catch (error) {\n if (isMissingPathError(error)) {\n return null\n }\n\n throw new Error(`Failed to read storage item \"${key}\"`, {\n cause: error as Error,\n })\n }\n },\n async setItem(key: string, value: string) {\n await write(resolve(key), value, { sanity: false })\n },\n async removeItem(key: string) {\n await rm(resolve(key), { force: true })\n },\n async getKeys(base?: string) {\n const keys: Array<string> = []\n const resolvedBase = resolve(base ?? process.cwd())\n\n async function walk(dir: string, prefix: string): Promise<void> {\n let entries: Array<Dirent>\n try {\n entries = (await readdir(dir, {\n withFileTypes: true,\n })) as Array<Dirent>\n } catch (error) {\n if (isMissingPathError(error)) {\n return\n }\n\n throw new Error(`Failed to list storage keys under \"${resolvedBase}\"`, {\n cause: error as Error,\n })\n }\n for (const entry of entries) {\n const rel = prefix ? `${prefix}/${entry.name}` : entry.name\n if (entry.isDirectory()) {\n await walk(join(dir, entry.name), rel)\n } else {\n keys.push(rel)\n }\n }\n }\n\n await walk(resolvedBase, '')\n\n return keys\n },\n async clear(base?: string) {\n if (!base) {\n return\n }\n\n await clean(resolve(base))\n },\n}))\n","","import { version as nodeVersion } from 'node:process'\nimport { version as KubbVersion } from '../../package.json'\n\n/**\n * Returns a snapshot of the current runtime environment.\n *\n * Useful for attaching context to debug logs and error reports so that\n * issues can be reproduced without manual information gathering.\n */\nexport function getDiagnosticInfo() {\n return {\n nodeVersion,\n KubbVersion,\n platform: process.platform,\n arch: process.arch,\n cwd: process.cwd(),\n } as const\n}\n","import type { Config, InputPath, UserConfig } from '../types'\n\n/**\n * Type guard to check if a given config has an `input.path`.\n */\nexport function isInputPath(config: UserConfig | undefined): config is UserConfig<InputPath>\nexport function isInputPath(config: Config | undefined): config is Config<InputPath>\nexport function isInputPath(config: Config | UserConfig | undefined): config is Config<InputPath> | UserConfig<InputPath> {\n return typeof config?.input === 'object' && config.input !== null && 'path' in config.input\n}\n","import { resolve } from 'node:path'\nimport { AsyncEventEmitter, BuildError, exists, formatMs, getElapsedMs, URLPath } from '@internals/utils'\nimport type { FileNode, OperationNode } from '@kubb/ast'\nimport { collectUsedSchemaNames, transform, walk } from '@kubb/ast'\nimport { DEFAULT_BANNER, DEFAULT_EXTENSION, DEFAULT_STUDIO_URL } from './constants.ts'\nimport type { RendererFactory } from './createRenderer.ts'\nimport type { Generator } from './defineGenerator.ts'\nimport type { Parser } from './defineParser.ts'\nimport type { Plugin } from './definePlugin.ts'\nimport { FileProcessor } from './FileProcessor.ts'\nimport type { Kubb } from './Kubb.ts'\nimport { PluginDriver } from './PluginDriver.ts'\nimport { applyHookResult } from './renderNode.ts'\nimport { fsStorage } from './storages/fsStorage.ts'\nimport type { AdapterSource, Config, GeneratorContext, KubbHooks, Middleware, NormalizedPlugin, Storage, UserConfig } from './types.ts'\nimport { getDiagnosticInfo } from './utils/diagnostics.ts'\nimport { isInputPath } from './utils/isInputPath.ts'\n\ntype SetupOptions = {\n hooks?: AsyncEventEmitter<KubbHooks>\n}\n\n/**\n * Full output produced by a successful or failed build.\n */\nexport type BuildOutput = {\n /**\n * Plugins that threw during installation, paired with the caught error.\n */\n failedPlugins: Set<{ plugin: Plugin; error: Error }>\n files: Array<FileNode>\n driver: PluginDriver\n /**\n * Elapsed time in milliseconds for each plugin, keyed by plugin name.\n */\n pluginTimings: Map<string, number>\n error?: Error\n /**\n * Raw generated source, keyed by absolute file path.\n */\n sources: Map<string, string>\n}\n\ntype SetupResult = {\n hooks: AsyncEventEmitter<KubbHooks>\n driver: PluginDriver\n sources: Map<string, string>\n config: Config\n storage: Storage | null\n}\n\nasync function setup(userConfig: UserConfig, options: SetupOptions = {}): Promise<SetupResult> {\n const hooks = options.hooks ?? new AsyncEventEmitter<KubbHooks>()\n\n const sources: Map<string, string> = new Map<string, string>()\n const diagnosticInfo = getDiagnosticInfo()\n\n if (Array.isArray(userConfig.input)) {\n await hooks.emit('kubb:warn', { message: 'This feature is still under development — use with caution' })\n }\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [\n 'Configuration:',\n ` • Name: ${userConfig.name || 'unnamed'}`,\n ` • Root: ${userConfig.root || process.cwd()}`,\n ` • Output: ${userConfig.output?.path || 'not specified'}`,\n ` • Plugins: ${userConfig.plugins?.length || 0}`,\n 'Output Settings:',\n ` • Storage: ${userConfig.storage ? `custom(${userConfig.storage.name})` : userConfig.output?.write === false ? 'disabled' : 'filesystem (default)'}`,\n ` • Formatter: ${userConfig.output?.format || 'none'}`,\n ` • Linter: ${userConfig.output?.lint || 'none'}`,\n 'Environment:',\n Object.entries(diagnosticInfo)\n .map(([key, value]) => ` • ${key}: ${value}`)\n .join('\\n'),\n ],\n })\n\n try {\n if (isInputPath(userConfig) && !new URLPath(userConfig.input.path).isURL) {\n await exists(userConfig.input.path)\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [`✓ Input file validated: ${userConfig.input.path}`],\n })\n }\n } catch (caughtError) {\n if (isInputPath(userConfig)) {\n const error = caughtError as Error\n\n throw new Error(\n `Cannot read file/URL defined in \\`input.path\\` or set with \\`kubb generate PATH\\` in the CLI of your Kubb config ${userConfig.input.path}`,\n {\n cause: error,\n },\n )\n }\n }\n\n if (!userConfig.adapter) {\n throw new Error('Adapter should be defined')\n }\n\n const config: Config = {\n ...userConfig,\n root: userConfig.root || process.cwd(),\n parsers: userConfig.parsers ?? [],\n adapter: userConfig.adapter,\n output: {\n format: false,\n lint: false,\n write: true,\n extension: DEFAULT_EXTENSION,\n defaultBanner: DEFAULT_BANNER,\n ...userConfig.output,\n },\n devtools: userConfig.devtools\n ? {\n studioUrl: DEFAULT_STUDIO_URL,\n ...(typeof userConfig.devtools === 'boolean' ? {} : userConfig.devtools),\n }\n : undefined,\n plugins: userConfig.plugins as unknown as Config['plugins'],\n }\n\n const storage: Storage | null = config.output.write === false ? null : (config.storage ?? fsStorage())\n\n if (config.output.clean) {\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: ['Cleaning output directories', ` • Output: ${config.output.path}`],\n })\n await storage?.clear(resolve(config.root, config.output.path))\n }\n\n const driver = new PluginDriver(config, {\n hooks,\n })\n\n // Register middleware hooks after all plugin hooks are registered.\n // Because AsyncEventEmitter calls listeners in registration order,\n // middleware hooks for any event fire after all plugin hooks for that event.\n function registerMiddlewareHook<K extends keyof KubbHooks & string>(event: K, middlewareHooks: Middleware['hooks']) {\n const handler = middlewareHooks[event]\n if (handler) {\n hooks.on(event, handler)\n }\n }\n\n for (const middleware of config.middleware ?? []) {\n for (const event of Object.keys(middleware.hooks) as Array<keyof KubbHooks & string>) {\n registerMiddlewareHook(event, middleware.hooks)\n }\n }\n\n const adapter = config.adapter\n if (!adapter) {\n throw new Error('No adapter configured. Please provide an adapter in your kubb.config.ts.')\n }\n const source = inputToAdapterSource(config)\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [`Running adapter: ${adapter.name}`],\n })\n\n driver.adapter = adapter\n driver.inputNode = await adapter.parse(source)\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [\n `✓ Adapter '${adapter.name}' resolved InputNode`,\n ` • Schemas: ${driver.inputNode.schemas.length}`,\n ` • Operations: ${driver.inputNode.operations.length}`,\n ],\n })\n\n return {\n config,\n hooks,\n driver,\n sources,\n storage,\n }\n}\n\n/**\n * Walks the AST and dispatches nodes to a plugin's direct AST hooks\n * (`schema`, `operation`, `operations`).\n *\n * When `include` contains only operation-scoped filters (`tag`, `operationId`, `path`,\n * `method`, `contentType`) and no `schemaName` filter, the function pre-computes the set\n * of top-level schema names transitively reachable from the included operations and skips\n * schemas that fall outside that set. This ensures that component schemas referenced\n * exclusively by excluded operations are not generated.\n */\nasync function runPluginAstHooks(plugin: NormalizedPlugin, context: GeneratorContext): Promise<void> {\n const { adapter, inputNode, resolver, driver } = context\n const { exclude, include, override } = plugin.options\n\n if (!adapter || !inputNode) {\n throw new Error(`[${plugin.name}] No adapter found. Add an OAS adapter (e.g. pluginOas()) before this plugin in your Kubb config.`)\n }\n\n function resolveRenderer(gen: Generator): RendererFactory | undefined {\n return gen.renderer === null ? undefined : (gen.renderer ?? plugin.renderer ?? context.config.renderer)\n }\n\n const generators = plugin.generators ?? []\n const collectedOperations: Array<OperationNode> = []\n\n const generatorContext = {\n ...context,\n resolver: driver.getResolver(plugin.name),\n }\n\n // When `include` has operation-based filters (tag, operationId, path, method, contentType)\n // but no schema-level filters (schemaName), pre-compute the set of top-level schema names\n // that are transitively referenced by the included operations. Schemas outside that set are\n // skipped so that types belonging exclusively to excluded operations are not generated.\n const operationFilterTypes = new Set(['tag', 'operationId', 'path', 'method', 'contentType'])\n const hasOperationBasedIncludes = include?.some(({ type }) => operationFilterTypes.has(type)) ?? false\n const hasSchemaNameIncludes = include?.some(({ type }) => type === 'schemaName') ?? false\n\n let allowedSchemaNames: Set<string> | undefined\n if (hasOperationBasedIncludes && !hasSchemaNameIncludes) {\n const includedOps = inputNode.operations.filter((op) => resolver.resolveOptions(op, { options: plugin.options, exclude, include, override }) !== null)\n allowedSchemaNames = collectUsedSchemaNames(includedOps, inputNode.schemas)\n }\n\n await walk(inputNode, {\n depth: 'shallow',\n async schema(node) {\n const transformedNode = plugin.transformer ? transform(node, plugin.transformer) : node\n\n // Skip named top-level schemas that are not reachable from any included operation.\n if (allowedSchemaNames !== undefined && transformedNode.name && !allowedSchemaNames.has(transformedNode.name)) {\n return\n }\n\n const options = resolver.resolveOptions(transformedNode, {\n options: plugin.options,\n exclude,\n include,\n override,\n })\n if (options === null) return\n\n const ctx = { ...generatorContext, options }\n\n for (const gen of generators) {\n if (!gen.schema) continue\n const result = await gen.schema(transformedNode, ctx)\n await applyHookResult(result, driver, resolveRenderer(gen))\n }\n\n await driver.hooks.emit('kubb:generate:schema', transformedNode, ctx)\n },\n async operation(node) {\n const transformedNode = plugin.transformer ? transform(node, plugin.transformer) : node\n const options = resolver.resolveOptions(transformedNode, {\n options: plugin.options,\n exclude,\n include,\n override,\n })\n if (options !== null) {\n collectedOperations.push(transformedNode)\n\n const ctx = { ...generatorContext, options }\n\n for (const gen of generators) {\n if (!gen.operation) continue\n const result = await gen.operation(transformedNode, ctx)\n await applyHookResult(result, driver, resolveRenderer(gen))\n }\n\n await driver.hooks.emit('kubb:generate:operation', transformedNode, ctx)\n }\n },\n })\n\n if (collectedOperations.length > 0) {\n const ctx = { ...generatorContext, options: plugin.options }\n\n for (const gen of generators) {\n if (!gen.operations) continue\n const result = await gen.operations(collectedOperations, ctx)\n await applyHookResult(result, driver, resolveRenderer(gen))\n }\n\n await driver.hooks.emit('kubb:generate:operations', collectedOperations, ctx)\n }\n}\n\nasync function safeBuild(setupResult: SetupResult): Promise<BuildOutput> {\n const { driver, hooks, sources, storage } = setupResult\n\n const failedPlugins = new Set<{ plugin: Plugin; error: Error }>()\n const pluginTimings = new Map<string, number>()\n const config = driver.config\n\n try {\n await driver.emitSetupHooks()\n\n if (driver.adapter && driver.inputNode) {\n await hooks.emit('kubb:build:start', {\n config,\n adapter: driver.adapter,\n inputNode: driver.inputNode,\n getPlugin: driver.getPlugin.bind(driver),\n get files() {\n return driver.fileManager.files\n },\n upsertFile: (...files) => driver.fileManager.upsert(...files),\n })\n }\n\n for (const plugin of driver.plugins.values()) {\n const context = driver.getContext(plugin)\n const hrStart = process.hrtime()\n\n try {\n const timestamp = new Date()\n\n await hooks.emit('kubb:plugin:start', { plugin })\n\n await hooks.emit('kubb:debug', {\n date: timestamp,\n logs: ['Starting plugin...', ` • Plugin Name: ${plugin.name}`],\n })\n\n if (plugin.generators?.length || driver.hasRegisteredGenerators(plugin.name)) {\n await runPluginAstHooks(plugin, context)\n }\n\n const duration = getElapsedMs(hrStart)\n pluginTimings.set(plugin.name, duration)\n\n await hooks.emit('kubb:plugin:end', {\n plugin,\n duration,\n success: true,\n config,\n get files() {\n return driver.fileManager.files\n },\n upsertFile: (...files) => driver.fileManager.upsert(...files),\n })\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [`✓ Plugin started successfully (${formatMs(duration)})`],\n })\n } catch (caughtError) {\n const error = caughtError as Error\n const errorTimestamp = new Date()\n const duration = getElapsedMs(hrStart)\n\n await hooks.emit('kubb:plugin:end', {\n plugin,\n duration,\n success: false,\n error,\n config,\n get files() {\n return driver.fileManager.files\n },\n upsertFile: (...files) => driver.fileManager.upsert(...files),\n })\n\n await hooks.emit('kubb:debug', {\n date: errorTimestamp,\n logs: [\n '✗ Plugin start failed',\n ` • Plugin Name: ${plugin.name}`,\n ` • Error: ${error.constructor.name} - ${error.message}`,\n ' • Stack Trace:',\n error.stack || 'No stack trace available',\n ],\n })\n\n failedPlugins.add({ plugin, error })\n }\n }\n\n await hooks.emit('kubb:plugins:end', {\n config,\n get files() {\n return driver.fileManager.files\n },\n upsertFile: (...files) => driver.fileManager.upsert(...files),\n })\n\n const files = driver.fileManager.files\n\n const parsersMap = new Map<FileNode['extname'], Parser>()\n for (const parser of config.parsers) {\n if (parser.extNames) {\n for (const extname of parser.extNames) {\n parsersMap.set(extname, parser)\n }\n }\n }\n\n const fileProcessor = new FileProcessor()\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [`Writing ${files.length} files...`],\n })\n\n await fileProcessor.run(files, {\n parsers: parsersMap,\n extension: config.output.extension,\n onStart: async (processingFiles) => {\n await hooks.emit('kubb:files:processing:start', { files: processingFiles })\n },\n onUpdate: async ({ file, source, processed, total, percentage }) => {\n await hooks.emit('kubb:file:processing:update', {\n file,\n source,\n processed,\n total,\n percentage,\n config,\n })\n if (source) {\n await storage?.setItem(file.path, source)\n sources.set(file.path, source)\n }\n },\n onEnd: async (processedFiles) => {\n await hooks.emit('kubb:files:processing:end', { files: processedFiles })\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [`✓ File write process completed for ${processedFiles.length} files`],\n })\n },\n })\n\n await hooks.emit('kubb:build:end', {\n files,\n config,\n outputDir: resolve(config.root, config.output.path),\n })\n\n return {\n failedPlugins,\n files,\n driver,\n pluginTimings,\n sources,\n }\n } catch (error) {\n return {\n failedPlugins,\n files: [],\n driver,\n pluginTimings,\n error: error as Error,\n sources,\n }\n } finally {\n driver.dispose()\n }\n}\n\nasync function build(setupResult: SetupResult): Promise<BuildOutput> {\n const { files, driver, failedPlugins, pluginTimings, error, sources } = await safeBuild(setupResult)\n\n if (error) {\n throw error\n }\n\n if (failedPlugins.size > 0) {\n const errors = [...failedPlugins].map(({ error }) => error)\n\n throw new BuildError(`Build Error with ${failedPlugins.size} failed plugins`, { errors })\n }\n\n return {\n failedPlugins,\n files,\n driver,\n pluginTimings,\n error: undefined,\n sources,\n }\n}\n\nfunction inputToAdapterSource(config: Config): AdapterSource {\n if (Array.isArray(config.input)) {\n return {\n type: 'paths',\n paths: config.input.map((i) => (new URLPath(i.path).isURL ? i.path : resolve(config.root, i.path))),\n }\n }\n\n if ('data' in config.input) {\n return { type: 'data', data: config.input.data }\n }\n\n if (new URLPath(config.input.path).isURL) {\n return { type: 'path', path: config.input.path }\n }\n\n const resolved = resolve(config.root, config.input.path)\n return { type: 'path', path: resolved }\n}\n\ntype CreateKubbOptions = {\n hooks?: AsyncEventEmitter<KubbHooks>\n}\n\n/**\n * Creates a Kubb instance bound to a single config entry.\n *\n * Accepts a user-facing config shape and resolves it to a full {@link Config} during\n * `setup()`. The instance then holds shared state (`hooks`, `sources`, `driver`, `config`)\n * across the `setup → build` lifecycle. Attach event listeners to `kubb.hooks` before\n * calling `setup()` or `build()`.\n *\n * @example\n * ```ts\n * const kubb = createKubb(userConfig)\n *\n * kubb.hooks.on('kubb:plugin:end', ({ plugin, duration }) => {\n * console.log(`${plugin.name} completed in ${duration}ms`)\n * })\n *\n * const { files, failedPlugins } = await kubb.safeBuild()\n * ```\n */\nexport function createKubb(userConfig: UserConfig, options: CreateKubbOptions = {}): Kubb {\n const hooks = options.hooks ?? new AsyncEventEmitter<KubbHooks>()\n let setupResult: SetupResult | undefined\n\n const instance: Kubb = {\n get hooks() {\n return hooks\n },\n get sources() {\n return setupResult?.sources ?? new Map()\n },\n get driver() {\n return setupResult?.driver\n },\n get config() {\n return setupResult?.config\n },\n async setup() {\n setupResult = await setup(userConfig, { hooks })\n },\n async build() {\n if (!setupResult) {\n await instance.setup()\n }\n return build(setupResult!)\n },\n async safeBuild() {\n if (!setupResult) {\n await instance.setup()\n }\n return safeBuild(setupResult!)\n },\n }\n\n return instance\n}\n","import type { FileNode } from '@kubb/ast'\n\n/**\n * Minimal interface any Kubb renderer must satisfy.\n *\n * The generic `TElement` is the type of the element the renderer accepts —\n * e.g. `KubbReactElement` for `@kubb/renderer-jsx`, or a custom type for\n * your own renderer. Defaults to `unknown` so that generators which do not\n * care about the element type continue to work without specifying it.\n *\n * This allows core to drive rendering without a hard dependency on\n * `@kubb/renderer-jsx` or any specific renderer implementation.\n */\nexport type Renderer<TElement = unknown> = {\n render(element: TElement): Promise<void>\n unmount(error?: Error | number | null): void\n readonly files: Array<FileNode>\n}\n\n/**\n * A factory function that produces a fresh {@link Renderer} per render.\n *\n * Generators use this to declare which renderer handles their output.\n */\nexport type RendererFactory<TElement = unknown> = () => Renderer<TElement>\n\n/**\n * Creates a renderer factory for use in generator definitions.\n *\n * Wrap your renderer factory function with this helper to register it as the\n * renderer for a generator. Core will call this factory once per render cycle\n * to obtain a fresh renderer instance.\n *\n * @example\n * ```ts\n * // packages/renderer-jsx/src/index.ts\n * export const jsxRenderer = createRenderer(() => {\n * const runtime = new Runtime()\n * return {\n * async render(element) { await runtime.render(element) },\n * get files() { return runtime.nodes },\n * unmount(error) { runtime.unmount(error) },\n * }\n * })\n *\n * // packages/plugin-zod/src/generators/zodGenerator.tsx\n * import { jsxRenderer } from '@kubb/renderer-jsx'\n * export const zodGenerator = defineGenerator<PluginZod>({\n * name: 'zod',\n * renderer: jsxRenderer,\n * schema(node, options) { return <File ...>...</File> },\n * })\n * ```\n */\nexport function createRenderer<TElement = unknown>(factory: RendererFactory<TElement>): RendererFactory<TElement> {\n return factory\n}\n","import type { PossiblePromise } from '@internals/utils'\nimport type { FileNode, OperationNode, SchemaNode } from '@kubb/ast'\nimport type { RendererFactory } from './createRenderer.ts'\nimport type { GeneratorContext, PluginFactoryOptions } from './types.ts'\n\nexport type { GeneratorContext } from './types.ts'\n\n/**\n * Declares a named generator unit that walks the AST and emits files.\n *\n * Each method (`schema`, `operation`, `operations`) is called for the matching node type.\n * Each method returns `TElement | Array<FileNode> | void`. JSX-based generators require a `renderer` factory.\n * Return `Array<FileNode>` directly or call `ctx.upsertFile()` manually and return `void` to bypass rendering.\n *\n * @note Generators are consumed by plugins and registered via `ctx.addGenerator()` in `kubb:plugin:setup`.\n *\n * @example\n * ```ts\n * import { defineGenerator } from '@kubb/core'\n * import { jsxRenderer } from '@kubb/renderer-jsx'\n *\n * export const typeGenerator = defineGenerator({\n * name: 'typescript',\n * renderer: jsxRenderer,\n * schema(node, ctx) {\n * const { adapter, resolver, root, options } = ctx\n * return <File ...><Type node={node} resolver={resolver} /></File>\n * },\n * })\n * ```\n */\nexport type Generator<TOptions extends PluginFactoryOptions = PluginFactoryOptions, TElement = unknown> = {\n /**\n * Used in diagnostic messages and debug output.\n */\n name: string\n /**\n * Optional renderer factory that produces a {@link Renderer} for each render cycle.\n *\n * Generators that return renderer elements (e.g. JSX via `@kubb/renderer-jsx`) must set this\n * to the matching renderer factory (e.g. `jsxRenderer` from `@kubb/renderer-jsx`).\n *\n * Generators that only return `Array<FileNode>` or `void` do not need to set this.\n *\n * Set `renderer: null` to explicitly opt out of rendering even when the parent plugin\n * declares a `renderer` (overrides the plugin-level fallback).\n *\n * @example\n * ```ts\n * import { jsxRenderer } from '@kubb/renderer-jsx'\n * export const myGenerator = defineGenerator<PluginTs>({\n * renderer: jsxRenderer,\n * schema(node, ctx) { return <File ...>...</File> },\n * })\n * ```\n */\n renderer?: RendererFactory<TElement> | null\n /**\n * Called for each schema node in the AST walk.\n * `ctx` carries the plugin context with `adapter` and `inputNode` guaranteed present,\n * plus `ctx.options` with the per-node resolved options (after exclude/include/override).\n */\n schema?: (node: SchemaNode, ctx: GeneratorContext<TOptions>) => PossiblePromise<TElement | Array<FileNode> | void>\n /**\n * Called for each operation node in the AST walk.\n * `ctx` carries the plugin context with `adapter` and `inputNode` guaranteed present,\n * plus `ctx.options` with the per-node resolved options (after exclude/include/override).\n */\n operation?: (node: OperationNode, ctx: GeneratorContext<TOptions>) => PossiblePromise<TElement | Array<FileNode> | void>\n /**\n * Called once after all operations have been walked.\n * `ctx` carries the plugin context with `adapter` and `inputNode` guaranteed present,\n * plus `ctx.options` with the plugin-level options for the batch call.\n */\n operations?: (nodes: Array<OperationNode>, ctx: GeneratorContext<TOptions>) => PossiblePromise<TElement | Array<FileNode> | void>\n}\n\n/**\n * Defines a generator. Returns the object as-is with correct `this` typings.\n * `applyHookResult` handles renderer elements and `File[]` uniformly using\n * the generator's declared `renderer` factory.\n */\nexport function defineGenerator<TOptions extends PluginFactoryOptions = PluginFactoryOptions, TElement = unknown>(\n generator: Generator<TOptions, TElement>,\n): Generator<TOptions, TElement> {\n return generator\n}\n","import type { Logger, LoggerOptions, UserLogger } from './types.ts'\n\n/**\n * Wraps a logger definition into a typed {@link Logger}.\n *\n * @example\n * ```ts\n * export const myLogger = defineLogger({\n * name: 'my-logger',\n * install(context, options) {\n * context.on('kubb:info', (message) => console.log('ℹ', message))\n * context.on('kubb:error', (error) => console.error('✗', error.message))\n * },\n * })\n * ```\n */\nexport function defineLogger<Options extends LoggerOptions = LoggerOptions>(logger: UserLogger<Options>): Logger<Options> {\n return logger\n}\n","import type { KubbHooks } from './Kubb.ts'\n\n/**\n * A middleware instance produced by calling a factory created with `defineMiddleware`.\n * It declares event handlers under a `hooks` object which are registered on the\n * shared emitter after all plugin hooks, so middleware handlers for any event\n * always fire last.\n */\nexport type Middleware = {\n /**\n * Unique identifier for this middleware.\n */\n name: string\n /**\n * Lifecycle event handlers for this middleware.\n * Any event from the global `KubbHooks` map can be subscribed to here.\n * Handlers are registered after all plugin handlers, so they always fire last.\n */\n hooks: {\n [K in keyof KubbHooks]?: (...args: KubbHooks[K]) => void | Promise<void>\n }\n}\n\n/**\n * Creates a middleware factory using the hook-style `hooks` API.\n *\n * Middleware handlers fire after all plugin handlers for any given event, making them ideal for post-processing, logging, and auditing.\n * Per-build state (such as accumulators) belongs inside the factory closure so each `createKubb` invocation gets its own isolated instance.\n *\n * @note The factory can accept typed options. See examples for using options and per-build state patterns.\n *\n * @example\n * ```ts\n * import { defineMiddleware } from '@kubb/core'\n *\n * // Stateless middleware\n * export const logMiddleware = defineMiddleware(() => ({\n * name: 'log-middleware',\n * hooks: {\n * 'kubb:build:end'({ files }) {\n * console.log(`Build complete with ${files.length} files`)\n * },\n * },\n * }))\n *\n * // Middleware with options and per-build state\n * export const prefixMiddleware = defineMiddleware((options: { prefix: string } = { prefix: '' }) => {\n * const seen = new Set<string>()\n * return {\n * name: 'prefix-middleware',\n * hooks: {\n * 'kubb:plugin:end'({ plugin }) {\n * seen.add(`${options.prefix}${plugin.name}`)\n * },\n * },\n * }\n * })\n * ```\n */\nexport function defineMiddleware<TOptions extends object = object>(factory: (options: TOptions) => Middleware): (options?: TOptions) => Middleware {\n return (options) => factory(options ?? ({} as TOptions))\n}\n","import type { FileNode } from '@kubb/ast'\n\ntype PrintOptions = {\n extname?: FileNode['extname']\n}\n\nexport type Parser<TMeta extends object = any> = {\n name: string\n /**\n * File extensions this parser handles.\n * Use `undefined` to create a catch-all fallback parser.\n *\n * @example Handled extensions\n * `['.ts', '.js']`\n */\n extNames: Array<FileNode['extname']> | undefined\n /**\n * Convert a resolved file to a string.\n */\n parse(file: FileNode<TMeta>, options?: PrintOptions): Promise<string> | string\n}\n\n/**\n * Defines a parser with type safety. Creates parsers that transform generated files to strings based on their extension.\n *\n * @note Call the returned factory with optional options to instantiate the parser.\n *\n * @example\n * ```ts\n * import { defineParser } from '@kubb/core'\n *\n * export const jsonParser = defineParser({\n * name: 'json',\n * extNames: ['.json'],\n * parse(file) {\n * const { extractStringsFromNodes } = await import('@kubb/ast')\n * return file.sources.map((s) => extractStringsFromNodes(s.nodes ?? [])).join('\\n')\n * },\n * })\n * ```\n */\nexport function defineParser<TMeta extends object = any>(parser: Parser<TMeta>): Parser<TMeta> {\n return parser\n}\n","import type { KubbHooks } from './Kubb.ts'\nimport type { KubbPluginSetupContext, PluginFactoryOptions } from './types.ts'\n\n/**\n * A plugin object produced by `definePlugin`.\n * Instead of flat lifecycle methods, it groups all handlers under a `hooks:` property\n * (matching Astro's integration naming convention).\n *\n * @template TFactory - The plugin's `PluginFactoryOptions` type.\n */\nexport type Plugin<TFactory extends PluginFactoryOptions = PluginFactoryOptions> = {\n /**\n * Unique name for the plugin, following the same naming convention as `createPlugin`.\n */\n name: string\n /**\n * Plugins that must be registered before this plugin executes.\n * An error is thrown at startup when any listed dependency is missing.\n */\n dependencies?: Array<string>\n /**\n * Controls the execution order of this plugin relative to others.\n *\n * - `'pre'` — runs before all normal plugins.\n * - `'post'` — runs after all normal plugins.\n * - `undefined` (default) — runs in declaration order among normal plugins.\n *\n * Dependency constraints always take precedence over `enforce`.\n */\n enforce?: 'pre' | 'post'\n /**\n * The options passed by the user when calling the plugin factory.\n */\n options?: TFactory['options']\n /**\n * Lifecycle event handlers for this plugin.\n * Any event from the global `KubbHooks` map can be subscribed to here.\n */\n hooks: {\n [K in Exclude<keyof KubbHooks, 'kubb:plugin:setup'>]?: (...args: KubbHooks[K]) => void | Promise<void>\n } & {\n 'kubb:plugin:setup'?(ctx: KubbPluginSetupContext<TFactory>): void | Promise<void>\n }\n}\n\n/**\n * Returns `true` when `plugin` is a hook-style plugin created with `definePlugin`.\n *\n * Used by `PluginDriver` to distinguish hook-style plugins from legacy `createPlugin` plugins\n * so it can normalize them and register their handlers on the `AsyncEventEmitter`.\n */\nexport function isPlugin(plugin: unknown): plugin is Plugin {\n return typeof plugin === 'object' && plugin !== null && 'hooks' in plugin\n}\n\n/**\n * Wraps a factory function and returns a typed `Plugin` with lifecycle handlers grouped under `hooks`.\n *\n * Handlers live in a single `hooks` object (inspired by Astro integrations).\n * All lifecycle events from `KubbHooks` are available for subscription.\n *\n * @note For real plugins, use a `PluginFactoryOptions` type parameter to get type-safe context in `kubb:plugin:setup`.\n * Plugin names should follow the convention `plugin-<feature>` (e.g., `plugin-react-query`, `plugin-zod`).\n *\n * @example\n * ```ts\n * import { definePlugin } from '@kubb/core'\n *\n * export const pluginTs = definePlugin((options: { prefix?: string } = {}) => ({\n * name: 'plugin-ts',\n * hooks: {\n * 'kubb:plugin:setup'(ctx) {\n * ctx.setResolver(resolverTs)\n * },\n * },\n * }))\n * ```\n */\nexport function definePlugin<TFactory extends PluginFactoryOptions = PluginFactoryOptions>(\n factory: (options: TFactory['options']) => Plugin<TFactory>,\n): (options?: TFactory['options']) => Plugin<TFactory> {\n return (options) => factory(options ?? ({} as TFactory['options']))\n}\n","import { createStorage } from '../createStorage.ts'\n\n/**\n * In-memory storage driver. Useful for testing and dry-run scenarios where\n * generated output should be captured without touching the filesystem.\n *\n * All data lives in a `Map` scoped to the storage instance and is discarded\n * when the instance is garbage-collected.\n *\n * @example\n * ```ts\n * import { memoryStorage } from '@kubb/core'\n * import { defineConfig } from 'kubb'\n *\n * export default defineConfig({\n * input: { path: './petStore.yaml' },\n * output: { path: './src/gen' },\n * storage: memoryStorage(),\n * })\n * ```\n */\nexport const memoryStorage = createStorage(() => {\n const store = new Map<string, string>()\n\n return {\n name: 'memory',\n async hasItem(key: string) {\n return store.has(key)\n },\n async getItem(key: string) {\n return store.get(key) ?? null\n },\n async setItem(key: string, value: string) {\n store.set(key, value)\n },\n async removeItem(key: string) {\n store.delete(key)\n },\n async getKeys(base?: string) {\n const keys = [...store.keys()]\n return base ? keys.filter((k) => k.startsWith(base)) : keys\n },\n async clear(base?: string) {\n if (!base) {\n store.clear()\n return\n }\n for (const key of store.keys()) {\n if (key.startsWith(base)) {\n store.delete(key)\n }\n }\n },\n }\n})\n"],"x_google_ignoreList":[7,8],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  import { t as __name } from "./chunk--u3MIqq1.js";
2
- import { $ as defineParser, A as KubbPluginStartContext, B as Override, C as KubbGenerationSummaryContext, D as KubbLifecycleStartContext, E as KubbInfoContext, F as Logger, G as ResolveOptionsContext, H as PossibleConfig, I as LoggerContext, J as ResolverFileParams, K as Resolver, L as LoggerOptions, M as KubbSuccessContext, N as KubbVersionNewContext, O as KubbPluginEndContext, P as KubbWarnContext, Q as Parser, R as NormalizedPlugin, S as KubbGenerationStartContext, T as KubbHookStartContext, U as ResolveBannerContext, V as PluginFactoryOptions, W as ResolveNameParams, X as UserConfig, Y as ResolverPathParams, Z as UserLogger, _ as KubbErrorContext, _t as logLevel, a as Config, at as createKubb, b as KubbFilesProcessingStartContext, c as GeneratorContext, ct as Plugin, d as InputData, dt as defineGenerator, et as Middleware, f as InputPath, ft as Storage, g as KubbDebugContext, gt as createRenderer, h as KubbConfigEndContext, ht as RendererFactory, i as CLIOptions, it as BuildOutput, j as KubbPluginsEndContext, k as KubbPluginSetupContext, l as Group, lt as definePlugin, m as KubbBuildStartContext, mt as Renderer, n as AdapterFactoryOptions, nt as Kubb, o as DevtoolsOptions, ot as PluginDriver, p as KubbBuildEndContext, pt as createStorage, q as ResolverContext, r as AdapterSource, rt as KubbHooks, s as Exclude, st as FileManager, t as Adapter, tt as defineMiddleware, u as Include, ut as Generator, v as KubbFileProcessingUpdateContext, vt as AsyncEventEmitter, w as KubbHookEndContext, x as KubbGenerationEndContext, y as KubbFilesProcessingEndContext, z as Output } from "./types-CuNocrbJ.js";
2
+ import { $ as defineParser, A as KubbPluginStartContext, B as Override, C as KubbGenerationSummaryContext, D as KubbLifecycleStartContext, E as KubbInfoContext, F as Logger, G as ResolveOptionsContext, H as PossibleConfig, I as LoggerContext, J as ResolverFileParams, K as Resolver, L as LoggerOptions, M as KubbSuccessContext, N as KubbVersionNewContext, O as KubbPluginEndContext, P as KubbWarnContext, Q as Parser, R as NormalizedPlugin, S as KubbGenerationStartContext, T as KubbHookStartContext, U as ResolveBannerContext, V as PluginFactoryOptions, W as ResolveNameParams, X as UserConfig, Y as ResolverPathParams, Z as UserLogger, _ as KubbErrorContext, _t as logLevel, a as Config, at as createKubb, b as KubbFilesProcessingStartContext, c as GeneratorContext, ct as Plugin, d as InputData, dt as defineGenerator, et as Middleware, f as InputPath, ft as Storage, g as KubbDebugContext, gt as createRenderer, h as KubbConfigEndContext, ht as RendererFactory, i as CLIOptions, it as BuildOutput, j as KubbPluginsEndContext, k as KubbPluginSetupContext, l as Group, lt as definePlugin, m as KubbBuildStartContext, mt as Renderer, n as AdapterFactoryOptions, nt as Kubb, o as DevtoolsOptions, ot as PluginDriver, p as KubbBuildEndContext, pt as createStorage, q as ResolverContext, r as AdapterSource, rt as KubbHooks, s as Exclude, st as FileManager, t as Adapter, tt as defineMiddleware, u as Include, ut as Generator, v as KubbFileProcessingUpdateContext, vt as AsyncEventEmitter, w as KubbHookEndContext, x as KubbGenerationEndContext, y as KubbFilesProcessingEndContext, z as Output } from "./types-CC09VtBt.js";
3
3
  import * as ast from "@kubb/ast";
4
4
  import { FileNode, InputNode, Node } from "@kubb/ast";
5
5
 
package/dist/index.js CHANGED
@@ -4,7 +4,7 @@ import { EventEmitter } from "node:events";
4
4
  import { access, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
5
5
  import { dirname, join, resolve } from "node:path";
6
6
  import * as ast from "@kubb/ast";
7
- import { extractStringsFromNodes, transform, walk } from "@kubb/ast";
7
+ import { collectUsedSchemaNames, extractStringsFromNodes, transform, walk } from "@kubb/ast";
8
8
  import { version } from "node:process";
9
9
  //#region ../../internals/utils/src/errors.ts
10
10
  /**
@@ -820,7 +820,7 @@ const fsStorage = createStorage(() => ({
820
820
  }));
821
821
  //#endregion
822
822
  //#region package.json
823
- var version$1 = "5.0.0-beta.1";
823
+ var version$1 = "5.0.0-beta.2";
824
824
  //#endregion
825
825
  //#region src/utils/diagnostics.ts
826
826
  /**
@@ -942,6 +942,12 @@ async function setup(userConfig, options = {}) {
942
942
  /**
943
943
  * Walks the AST and dispatches nodes to a plugin's direct AST hooks
944
944
  * (`schema`, `operation`, `operations`).
945
+ *
946
+ * When `include` contains only operation-scoped filters (`tag`, `operationId`, `path`,
947
+ * `method`, `contentType`) and no `schemaName` filter, the function pre-computes the set
948
+ * of top-level schema names transitively reachable from the included operations and skips
949
+ * schemas that fall outside that set. This ensures that component schemas referenced
950
+ * exclusively by excluded operations are not generated.
945
951
  */
946
952
  async function runPluginAstHooks(plugin, context) {
947
953
  const { adapter, inputNode, resolver, driver } = context;
@@ -956,10 +962,27 @@ async function runPluginAstHooks(plugin, context) {
956
962
  ...context,
957
963
  resolver: driver.getResolver(plugin.name)
958
964
  };
965
+ const operationFilterTypes = new Set([
966
+ "tag",
967
+ "operationId",
968
+ "path",
969
+ "method",
970
+ "contentType"
971
+ ]);
972
+ const hasOperationBasedIncludes = include?.some(({ type }) => operationFilterTypes.has(type)) ?? false;
973
+ const hasSchemaNameIncludes = include?.some(({ type }) => type === "schemaName") ?? false;
974
+ let allowedSchemaNames;
975
+ if (hasOperationBasedIncludes && !hasSchemaNameIncludes) allowedSchemaNames = collectUsedSchemaNames(inputNode.operations.filter((op) => resolver.resolveOptions(op, {
976
+ options: plugin.options,
977
+ exclude,
978
+ include,
979
+ override
980
+ }) !== null), inputNode.schemas);
959
981
  await walk(inputNode, {
960
982
  depth: "shallow",
961
983
  async schema(node) {
962
984
  const transformedNode = plugin.transformer ? transform(node, plugin.transformer) : node;
985
+ if (allowedSchemaNames !== void 0 && transformedNode.name && !allowedSchemaNames.has(transformedNode.name)) return;
963
986
  const options = resolver.resolveOptions(transformedNode, {
964
987
  options: plugin.options,
965
988
  exclude,
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":["#emitter","NodeEventEmitter","#options","#transformParam","#eachParam","Node","#head","#tail","#size","#limit"],"sources":["../../../internals/utils/src/errors.ts","../../../internals/utils/src/asyncEventEmitter.ts","../../../internals/utils/src/time.ts","../../../internals/utils/src/fs.ts","../../../internals/utils/src/reserved.ts","../../../internals/utils/src/urlPath.ts","../src/createAdapter.ts","../../../node_modules/.pnpm/yocto-queue@1.2.2/node_modules/yocto-queue/index.js","../../../node_modules/.pnpm/p-limit@7.3.0/node_modules/p-limit/index.js","../src/FileProcessor.ts","../src/createStorage.ts","../src/storages/fsStorage.ts","../package.json","../src/utils/diagnostics.ts","../src/utils/isInputPath.ts","../src/createKubb.ts","../src/createRenderer.ts","../src/defineGenerator.ts","../src/defineLogger.ts","../src/defineMiddleware.ts","../src/defineParser.ts","../src/definePlugin.ts","../src/storages/memoryStorage.ts"],"sourcesContent":["/**\n * Thrown when one or more errors occur during a Kubb build.\n * Carries the full list of underlying errors on `errors`.\n *\n * @example\n * ```ts\n * throw new BuildError('Build failed', { errors: [err1, err2] })\n * ```\n */\nexport class BuildError extends Error {\n errors: Array<Error>\n\n constructor(message: string, options: { cause?: Error; errors: Array<Error> }) {\n super(message, { cause: options.cause })\n this.name = 'BuildError'\n this.errors = options.errors\n }\n}\n\n/**\n * Coerces an unknown thrown value to an `Error` instance.\n * Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.\n *\n * @example\n * ```ts\n * try { ... } catch(err) {\n * throw new BuildError('Build failed', { cause: toError(err), errors: [] })\n * }\n * ```\n */\nexport function toError(value: unknown): Error {\n return value instanceof Error ? value : new Error(String(value))\n}\n\n/**\n * Extracts a human-readable message from any thrown value.\n *\n * @example\n * ```ts\n * getErrorMessage(new Error('oops')) // 'oops'\n * getErrorMessage('plain string') // 'plain string'\n * ```\n */\nexport function getErrorMessage(value: unknown): string {\n return value instanceof Error ? value.message : String(value)\n}\n\n/**\n * Extracts the `.cause` of an `Error` as an `Error`, or `undefined` when absent or not an `Error`.\n *\n * @example\n * ```ts\n * const cause = toCause(buildError) // Error | undefined\n * ```\n */\nexport function toCause(error: Error): Error | undefined {\n return error.cause instanceof Error ? error.cause : undefined\n}\n","import { EventEmitter as NodeEventEmitter } from 'node:events'\nimport { toError } from './errors.ts'\n\n/**\n * A function that can be registered as an event listener, synchronous or async.\n */\ntype AsyncListener<TArgs extends unknown[]> = (...args: TArgs) => void | Promise<void>\n\n/**\n * Typed `EventEmitter` that awaits all async listeners before resolving.\n * Wraps Node's `EventEmitter` with full TypeScript event-map inference.\n *\n * @example\n * ```ts\n * const emitter = new AsyncEventEmitter<{ build: [name: string] }>()\n * emitter.on('build', async (name) => { console.log(name) })\n * await emitter.emit('build', 'petstore') // all listeners awaited\n * ```\n */\nexport class AsyncEventEmitter<TEvents extends { [K in keyof TEvents]: unknown[] }> {\n /**\n * Maximum number of listeners per event before Node emits a memory-leak warning.\n * @default 10\n */\n constructor(maxListener = 10) {\n this.#emitter.setMaxListeners(maxListener)\n }\n\n #emitter = new NodeEventEmitter()\n\n /**\n * Emits `eventName` and awaits all registered listeners sequentially.\n * Throws if any listener rejects, wrapping the cause with the event name and serialized arguments.\n *\n * @example\n * ```ts\n * await emitter.emit('build', 'petstore')\n * ```\n */\n async emit<TEventName extends keyof TEvents & string>(eventName: TEventName, ...eventArgs: TEvents[TEventName]): Promise<void> {\n const listeners = this.#emitter.listeners(eventName) as Array<AsyncListener<TEvents[TEventName]>>\n\n if (listeners.length === 0) {\n return\n }\n\n for (const listener of listeners) {\n try {\n await listener(...eventArgs)\n } catch (err) {\n let serializedArgs: string\n try {\n serializedArgs = JSON.stringify(eventArgs)\n } catch {\n serializedArgs = String(eventArgs)\n }\n throw new Error(`Error in async listener for \"${eventName}\" with eventArgs ${serializedArgs}`, { cause: toError(err) })\n }\n }\n }\n\n /**\n * Registers a persistent listener for `eventName`.\n *\n * @example\n * ```ts\n * emitter.on('build', async (name) => { console.log(name) })\n * ```\n */\n on<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n this.#emitter.on(eventName, handler as AsyncListener<unknown[]>)\n }\n\n /**\n * Registers a one-shot listener that removes itself after the first invocation.\n *\n * @example\n * ```ts\n * emitter.onOnce('build', async (name) => { console.log(name) })\n * ```\n */\n onOnce<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n const wrapper: AsyncListener<TEvents[TEventName]> = (...args) => {\n this.off(eventName, wrapper)\n return handler(...args)\n }\n this.on(eventName, wrapper)\n }\n\n /**\n * Removes a previously registered listener.\n *\n * @example\n * ```ts\n * emitter.off('build', handler)\n * ```\n */\n off<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n this.#emitter.off(eventName, handler as AsyncListener<unknown[]>)\n }\n\n /**\n * Returns the number of listeners registered for `eventName`.\n *\n * @example\n * ```ts\n * emitter.on('build', handler)\n * emitter.listenerCount('build') // 1\n * ```\n */\n listenerCount<TEventName extends keyof TEvents & string>(eventName: TEventName): number {\n return this.#emitter.listenerCount(eventName)\n }\n\n /**\n * Removes all listeners from every event channel.\n *\n * @example\n * ```ts\n * emitter.removeAll()\n * ```\n */\n removeAll(): void {\n this.#emitter.removeAllListeners()\n }\n}\n","/**\n * Calculates elapsed time in milliseconds from a high-resolution `process.hrtime` start time.\n * Rounds to 2 decimal places for sub-millisecond precision without noise.\n *\n * @example\n * ```ts\n * const start = process.hrtime()\n * doWork()\n * getElapsedMs(start) // 42.35\n * ```\n */\nexport function getElapsedMs(hrStart: [number, number]): number {\n const [seconds, nanoseconds] = process.hrtime(hrStart)\n const ms = seconds * 1000 + nanoseconds / 1e6\n return Math.round(ms * 100) / 100\n}\n\n/**\n * Converts a millisecond duration into a human-readable string (`ms`, `s`, or `m s`).\n *\n * @example\n * ```ts\n * formatMs(250) // '250ms'\n * formatMs(1500) // '1.50s'\n * formatMs(90000) // '1m 30.0s'\n * ```\n */\nexport function formatMs(ms: number): string {\n if (ms >= 60000) {\n const mins = Math.floor(ms / 60000)\n const secs = ((ms % 60000) / 1000).toFixed(1)\n return `${mins}m ${secs}s`\n }\n\n if (ms >= 1000) {\n return `${(ms / 1000).toFixed(2)}s`\n }\n return `${Math.round(ms)}ms`\n}\n\n/**\n * Formats the elapsed time since `hrStart` as a human-readable string.\n *\n * @example\n * ```ts\n * const start = process.hrtime()\n * doWork()\n * formatHrtime(start) // '1.50s'\n * ```\n */\nexport function formatHrtime(hrStart: [number, number]): string {\n return formatMs(getElapsedMs(hrStart))\n}\n","import { existsSync, readFileSync } from 'node:fs'\nimport { access, mkdir, readFile, rm, writeFile } from 'node:fs/promises'\nimport { dirname, join, posix, resolve } from 'node:path'\n\n/**\n * Walks up the directory tree from `cwd` (defaults to `process.cwd()`) and\n * returns the absolute path of the nearest `package.json`, or `null` when none\n * is found before reaching the filesystem root.\n *\n * @example\n * ```ts\n * const pkgPath = findPackageJSON('/home/user/project/src') // '/home/user/project/package.json'\n * ```\n */\nexport function findPackageJSON(cwd?: string): string | null {\n let dir = cwd ? resolve(cwd) : process.cwd()\n while (true) {\n const pkgPath = join(dir, 'package.json')\n if (existsSync(pkgPath)) return pkgPath\n const parent = dirname(dir)\n if (parent === dir) return null\n dir = parent\n }\n}\n\n/**\n * Converts all backslashes to forward slashes.\n * Extended-length Windows paths (`\\\\?\\...`) are left unchanged.\n */\nfunction toSlash(p: string): string {\n if (p.startsWith('\\\\\\\\?\\\\')) return p\n return p.replaceAll('\\\\', '/')\n}\n\n/**\n * Returns the relative path from `rootDir` to `filePath`, always using forward slashes\n * and prefixed with `./` when not already traversing upward.\n *\n * @example\n * ```ts\n * getRelativePath('/src/components', '/src/components/Button.tsx') // './Button.tsx'\n * getRelativePath('/src/components', '/src/utils/helpers.ts') // '../utils/helpers.ts'\n * ```\n */\nexport function getRelativePath(rootDir?: string | null, filePath?: string | null): string {\n if (!rootDir || !filePath) {\n throw new Error(`Root and file should be filled in when retrieving the relativePath, ${rootDir || ''} ${filePath || ''}`)\n }\n\n const relativePath = posix.relative(toSlash(rootDir), toSlash(filePath))\n\n return relativePath.startsWith('../') ? relativePath : `./${relativePath}`\n}\n\n/**\n * Resolves to `true` when the file or directory at `path` exists.\n * Uses `Bun.file().exists()` when running under Bun, `fs.access` otherwise.\n *\n * @example\n * ```ts\n * if (await exists('./kubb.config.ts')) {\n * const content = await read('./kubb.config.ts')\n * }\n * ```\n */\nexport async function exists(path: string): Promise<boolean> {\n if (typeof Bun !== 'undefined') {\n return Bun.file(path).exists()\n }\n return access(path).then(\n () => true,\n () => false,\n )\n}\n\n/**\n * Reads the file at `path` as a UTF-8 string.\n * Uses `Bun.file().text()` when running under Bun, `fs.readFile` otherwise.\n *\n * @example\n * ```ts\n * const source = await read('./src/Pet.ts')\n * ```\n */\nexport async function read(path: string): Promise<string> {\n if (typeof Bun !== 'undefined') {\n return Bun.file(path).text()\n }\n return readFile(path, { encoding: 'utf8' })\n}\n\n/**\n * Synchronous counterpart of `read`.\n *\n * @example\n * ```ts\n * const source = readSync('./src/Pet.ts')\n * ```\n */\nexport function readSync(path: string): string {\n return readFileSync(path, { encoding: 'utf8' })\n}\n\ntype WriteOptions = {\n /**\n * When `true`, re-reads the file immediately after writing and throws if the\n * content does not match — useful for catching write failures on unreliable file systems.\n */\n sanity?: boolean\n}\n\n/**\n * Writes `data` to `path`, trimming leading/trailing whitespace before saving.\n * Skips the write when the trimmed content is empty or identical to what is already on disk.\n * Creates any missing parent directories automatically.\n * When `sanity` is `true`, re-reads the file after writing and throws if the content does not match.\n *\n * @example\n * ```ts\n * await write('./src/Pet.ts', source) // writes and returns trimmed content\n * await write('./src/Pet.ts', source) // null — file unchanged\n * await write('./src/Pet.ts', ' ') // null — empty content skipped\n * ```\n */\nexport async function write(path: string, data: string, options: WriteOptions = {}): Promise<string | null> {\n const trimmed = data.trim()\n if (trimmed === '') return null\n\n const resolved = resolve(path)\n\n if (typeof Bun !== 'undefined') {\n const file = Bun.file(resolved)\n const oldContent = (await file.exists()) ? await file.text() : null\n if (oldContent === trimmed) return null\n await Bun.write(resolved, trimmed)\n return trimmed\n }\n\n try {\n const oldContent = await readFile(resolved, { encoding: 'utf-8' })\n if (oldContent === trimmed) return null\n } catch {\n /* file doesn't exist yet */\n }\n\n await mkdir(dirname(resolved), { recursive: true })\n await writeFile(resolved, trimmed, { encoding: 'utf-8' })\n\n if (options.sanity) {\n const savedData = await readFile(resolved, { encoding: 'utf-8' })\n if (savedData !== trimmed) {\n throw new Error(`Sanity check failed for ${path}\\n\\nData[${data.length}]:\\n${data}\\n\\nSaved[${savedData.length}]:\\n${savedData}\\n`)\n }\n return savedData\n }\n\n return trimmed\n}\n\n/**\n * Recursively removes `path`. Silently succeeds when `path` does not exist.\n *\n * @example\n * ```ts\n * await clean('./dist')\n * ```\n */\nexport async function clean(path: string): Promise<void> {\n return rm(path, { recursive: true, force: true })\n}\n","/**\n * JavaScript and Java reserved words.\n * @link https://github.com/jonschlinkert/reserved/blob/master/index.js\n */\nconst reservedWords = new Set([\n 'abstract',\n 'arguments',\n 'boolean',\n 'break',\n 'byte',\n 'case',\n 'catch',\n 'char',\n 'class',\n 'const',\n 'continue',\n 'debugger',\n 'default',\n 'delete',\n 'do',\n 'double',\n 'else',\n 'enum',\n 'eval',\n 'export',\n 'extends',\n 'false',\n 'final',\n 'finally',\n 'float',\n 'for',\n 'function',\n 'goto',\n 'if',\n 'implements',\n 'import',\n 'in',\n 'instanceof',\n 'int',\n 'interface',\n 'let',\n 'long',\n 'native',\n 'new',\n 'null',\n 'package',\n 'private',\n 'protected',\n 'public',\n 'return',\n 'short',\n 'static',\n 'super',\n 'switch',\n 'synchronized',\n 'this',\n 'throw',\n 'throws',\n 'transient',\n 'true',\n 'try',\n 'typeof',\n 'var',\n 'void',\n 'volatile',\n 'while',\n 'with',\n 'yield',\n 'Array',\n 'Date',\n 'hasOwnProperty',\n 'Infinity',\n 'isFinite',\n 'isNaN',\n 'isPrototypeOf',\n 'length',\n 'Math',\n 'name',\n 'NaN',\n 'Number',\n 'Object',\n 'prototype',\n 'String',\n 'toString',\n 'undefined',\n 'valueOf',\n] as const)\n\n/**\n * Prefixes `word` with `_` when it is a reserved JavaScript/Java identifier or starts with a digit.\n *\n * @example\n * ```ts\n * transformReservedWord('class') // '_class'\n * transformReservedWord('42foo') // '_42foo'\n * transformReservedWord('status') // 'status'\n * ```\n */\nexport function transformReservedWord(word: string): string {\n const firstChar = word.charCodeAt(0)\n if (word && (reservedWords.has(word as 'valueOf') || (firstChar >= 48 && firstChar <= 57))) {\n return `_${word}`\n }\n return word\n}\n\n/**\n * Returns `true` when `name` is a syntactically valid JavaScript variable name.\n *\n * @example\n * ```ts\n * isValidVarName('status') // true\n * isValidVarName('class') // false (reserved word)\n * isValidVarName('42foo') // false (starts with digit)\n * ```\n */\nexport function isValidVarName(name: string): boolean {\n if (!name || reservedWords.has(name as 'valueOf')) {\n return false\n }\n return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name)\n}\n","import { camelCase } from './casing.ts'\nimport { isValidVarName } from './reserved.ts'\n\nexport type URLObject = {\n /**\n * The resolved URL string (Express-style or template literal, depending on context).\n */\n url: string\n /**\n * Extracted path parameters as a key-value map, or `undefined` when the path has none.\n */\n params?: Record<string, string>\n}\n\ntype ObjectOptions = {\n /**\n * Controls whether the `url` is rendered as an Express path or a template literal.\n * @default 'path'\n */\n type?: 'path' | 'template'\n /**\n * Optional transform applied to each extracted parameter name.\n */\n replacer?: (pathParam: string) => string\n /**\n * When `true`, the result is serialized to a string expression instead of a plain object.\n */\n stringify?: boolean\n}\n\n/**\n * Supported identifier casing strategies for path parameters.\n */\ntype PathCasing = 'camelcase'\n\ntype Options = {\n /**\n * Casing strategy applied to path parameter names.\n * @default undefined (original identifier preserved)\n */\n casing?: PathCasing\n}\n\n/**\n * Parses and transforms an OpenAPI/Swagger path string into various URL formats.\n *\n * @example\n * const p = new URLPath('/pet/{petId}')\n * p.URL // '/pet/:petId'\n * p.template // '`/pet/${petId}`'\n */\nexport class URLPath {\n /**\n * The raw OpenAPI/Swagger path string, e.g. `/pet/{petId}`.\n */\n path: string\n\n #options: Options\n\n constructor(path: string, options: Options = {}) {\n this.path = path\n this.#options = options\n }\n\n /** Converts the OpenAPI path to Express-style colon syntax, e.g. `/pet/{petId}` → `/pet/:petId`.\n *\n * @example\n * ```ts\n * new URLPath('/pet/{petId}').URL // '/pet/:petId'\n * ```\n */\n get URL(): string {\n return this.toURLPath()\n }\n\n /** Returns `true` when `path` is a fully-qualified URL (e.g. starts with `https://`).\n *\n * @example\n * ```ts\n * new URLPath('https://petstore.swagger.io/v2/pet').isURL // true\n * new URLPath('/pet/{petId}').isURL // false\n * ```\n */\n get isURL(): boolean {\n try {\n return !!new URL(this.path).href\n } catch {\n return false\n }\n }\n\n /**\n * Converts the OpenAPI path to a TypeScript template literal string.\n *\n * @example\n * new URLPath('/pet/{petId}').template // '`/pet/${petId}`'\n * new URLPath('/account/monetary-accountID').template // '`/account/${monetaryAccountId}`'\n */\n get template(): string {\n return this.toTemplateString()\n }\n\n /** Returns the path and its extracted params as a structured `URLObject`, or as a stringified expression when `stringify` is set.\n *\n * @example\n * ```ts\n * new URLPath('/pet/{petId}').object\n * // { url: '/pet/:petId', params: { petId: 'petId' } }\n * ```\n */\n get object(): URLObject | string {\n return this.toObject()\n }\n\n /** Returns a map of path parameter names, or `undefined` when the path has no parameters.\n *\n * @example\n * ```ts\n * new URLPath('/pet/{petId}').params // { petId: 'petId' }\n * new URLPath('/pet').params // undefined\n * ```\n */\n get params(): Record<string, string> | undefined {\n return this.getParams()\n }\n\n #transformParam(raw: string): string {\n const param = isValidVarName(raw) ? raw : camelCase(raw)\n return this.#options.casing === 'camelcase' ? camelCase(param) : param\n }\n\n /**\n * Iterates over every `{param}` token in `path`, calling `fn` with the raw token and transformed name.\n */\n #eachParam(fn: (raw: string, param: string) => void): void {\n for (const match of this.path.matchAll(/\\{([^}]+)\\}/g)) {\n const raw = match[1]!\n fn(raw, this.#transformParam(raw))\n }\n }\n\n toObject({ type = 'path', replacer, stringify }: ObjectOptions = {}): URLObject | string {\n const object = {\n url: type === 'path' ? this.toURLPath() : this.toTemplateString({ replacer }),\n params: this.getParams(),\n }\n\n if (stringify) {\n if (type === 'template') {\n return JSON.stringify(object).replaceAll(\"'\", '').replaceAll(`\"`, '')\n }\n\n if (object.params) {\n return `{ url: '${object.url}', params: ${JSON.stringify(object.params).replaceAll(\"'\", '').replaceAll(`\"`, '')} }`\n }\n\n return `{ url: '${object.url}' }`\n }\n\n return object\n }\n\n /**\n * Converts the OpenAPI path to a TypeScript template literal string.\n * An optional `replacer` can transform each extracted parameter name before interpolation.\n *\n * @example\n * new URLPath('/pet/{petId}').toTemplateString() // '`/pet/${petId}`'\n */\n toTemplateString({\n prefix = '',\n replacer,\n }: {\n prefix?: string\n replacer?: (pathParam: string) => string\n } = {}): string {\n const parts = this.path.split(/\\{([^}]+)\\}/)\n const result = parts\n .map((part, i) => {\n if (i % 2 === 0) return part\n const param = this.#transformParam(part)\n return `\\${${replacer ? replacer(param) : param}}`\n })\n .join('')\n\n return `\\`${prefix}${result}\\``\n }\n\n /**\n * Extracts all `{param}` segments from the path and returns them as a key-value map.\n * An optional `replacer` transforms each parameter name in both key and value positions.\n * Returns `undefined` when no path parameters are found.\n *\n * @example\n * ```ts\n * new URLPath('/pet/{petId}/tag/{tagId}').getParams()\n * // { petId: 'petId', tagId: 'tagId' }\n * ```\n */\n getParams(replacer?: (pathParam: string) => string): Record<string, string> | undefined {\n const params: Record<string, string> = {}\n\n this.#eachParam((_raw, param) => {\n const key = replacer ? replacer(param) : param\n params[key] = key\n })\n\n return Object.keys(params).length > 0 ? params : undefined\n }\n\n /** Converts the OpenAPI path to Express-style colon syntax.\n *\n * @example\n * ```ts\n * new URLPath('/pet/{petId}').toURLPath() // '/pet/:petId'\n * ```\n */\n toURLPath(): string {\n return this.path.replace(/\\{([^}]+)\\}/g, ':$1')\n }\n}\n","import type { Adapter, AdapterFactoryOptions } from './types.ts'\n\ntype AdapterBuilder<T extends AdapterFactoryOptions> = (options: T['options']) => Adapter<T>\n\n/**\n * Factory for implementing custom adapters that translate non-OpenAPI specs into Kubb's AST.\n *\n * Use this to support GraphQL schemas, gRPC definitions, AsyncAPI, or custom domain-specific languages.\n * Built-in adapters include `@kubb/adapter-oas` for OpenAPI and Swagger documents.\n *\n * @note Adapters must parse their input format to Kubb's `InputNode` structure.\n *\n * @example\n * ```ts\n * export const myAdapter = createAdapter<MyAdapter>((options) => {\n * return {\n * name: 'my-adapter',\n * options,\n * async parse(source) {\n * // Transform source format to InputNode\n * return { ... }\n * },\n * }\n * })\n *\n * // Instantiate:\n * const adapter = myAdapter({ validate: true })\n * ```\n */\nexport function createAdapter<T extends AdapterFactoryOptions = AdapterFactoryOptions>(build: AdapterBuilder<T>): (options?: T['options']) => Adapter<T> {\n return (options) => build(options ?? ({} as T['options']))\n}\n","/*\nHow it works:\n`this.#head` is an instance of `Node` which keeps track of its current value and nests another instance of `Node` that keeps the value that comes after it. When a value is provided to `.enqueue()`, the code needs to iterate through `this.#head`, going deeper and deeper to find the last value. However, iterating through every single item is slow. This problem is solved by saving a reference to the last value as `this.#tail` so that it can reference it to add a new value.\n*/\n\nclass Node {\n\tvalue;\n\tnext;\n\n\tconstructor(value) {\n\t\tthis.value = value;\n\t}\n}\n\nexport default class Queue {\n\t#head;\n\t#tail;\n\t#size;\n\n\tconstructor() {\n\t\tthis.clear();\n\t}\n\n\tenqueue(value) {\n\t\tconst node = new Node(value);\n\n\t\tif (this.#head) {\n\t\t\tthis.#tail.next = node;\n\t\t\tthis.#tail = node;\n\t\t} else {\n\t\t\tthis.#head = node;\n\t\t\tthis.#tail = node;\n\t\t}\n\n\t\tthis.#size++;\n\t}\n\n\tdequeue() {\n\t\tconst current = this.#head;\n\t\tif (!current) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.#head = this.#head.next;\n\t\tthis.#size--;\n\n\t\t// Clean up tail reference when queue becomes empty\n\t\tif (!this.#head) {\n\t\t\tthis.#tail = undefined;\n\t\t}\n\n\t\treturn current.value;\n\t}\n\n\tpeek() {\n\t\tif (!this.#head) {\n\t\t\treturn;\n\t\t}\n\n\t\treturn this.#head.value;\n\n\t\t// TODO: Node.js 18.\n\t\t// return this.#head?.value;\n\t}\n\n\tclear() {\n\t\tthis.#head = undefined;\n\t\tthis.#tail = undefined;\n\t\tthis.#size = 0;\n\t}\n\n\tget size() {\n\t\treturn this.#size;\n\t}\n\n\t* [Symbol.iterator]() {\n\t\tlet current = this.#head;\n\n\t\twhile (current) {\n\t\t\tyield current.value;\n\t\t\tcurrent = current.next;\n\t\t}\n\t}\n\n\t* drain() {\n\t\twhile (this.#head) {\n\t\t\tyield this.dequeue();\n\t\t}\n\t}\n}\n","import Queue from 'yocto-queue';\n\nexport default function pLimit(concurrency) {\n\tlet rejectOnClear = false;\n\n\tif (typeof concurrency === 'object') {\n\t\t({concurrency, rejectOnClear = false} = concurrency);\n\t}\n\n\tvalidateConcurrency(concurrency);\n\n\tif (typeof rejectOnClear !== 'boolean') {\n\t\tthrow new TypeError('Expected `rejectOnClear` to be a boolean');\n\t}\n\n\tconst queue = new Queue();\n\tlet activeCount = 0;\n\n\tconst resumeNext = () => {\n\t\t// Process the next queued function if we're under the concurrency limit\n\t\tif (activeCount < concurrency && queue.size > 0) {\n\t\t\tactiveCount++;\n\t\t\tqueue.dequeue().run();\n\t\t}\n\t};\n\n\tconst next = () => {\n\t\tactiveCount--;\n\t\tresumeNext();\n\t};\n\n\tconst run = async (function_, resolve, arguments_) => {\n\t\t// Execute the function and capture the result promise\n\t\tconst result = (async () => function_(...arguments_))();\n\n\t\t// Resolve immediately with the promise (don't wait for completion)\n\t\tresolve(result);\n\n\t\t// Wait for the function to complete (success or failure)\n\t\t// We catch errors here to prevent unhandled rejections,\n\t\t// but the original promise rejection is preserved for the caller\n\t\ttry {\n\t\t\tawait result;\n\t\t} catch {}\n\n\t\t// Decrement active count and process next queued function\n\t\tnext();\n\t};\n\n\tconst enqueue = (function_, resolve, reject, arguments_) => {\n\t\tconst queueItem = {reject};\n\n\t\t// Queue the internal resolve function instead of the run function\n\t\t// to preserve the asynchronous execution context.\n\t\tnew Promise(internalResolve => { // eslint-disable-line promise/param-names\n\t\t\tqueueItem.run = internalResolve;\n\t\t\tqueue.enqueue(queueItem);\n\t\t}).then(run.bind(undefined, function_, resolve, arguments_)); // eslint-disable-line promise/prefer-await-to-then\n\n\t\t// Start processing immediately if we haven't reached the concurrency limit\n\t\tif (activeCount < concurrency) {\n\t\t\tresumeNext();\n\t\t}\n\t};\n\n\tconst generator = (function_, ...arguments_) => new Promise((resolve, reject) => {\n\t\tenqueue(function_, resolve, reject, arguments_);\n\t});\n\n\tObject.defineProperties(generator, {\n\t\tactiveCount: {\n\t\t\tget: () => activeCount,\n\t\t},\n\t\tpendingCount: {\n\t\t\tget: () => queue.size,\n\t\t},\n\t\tclearQueue: {\n\t\t\tvalue() {\n\t\t\t\tif (!rejectOnClear) {\n\t\t\t\t\tqueue.clear();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tconst abortError = AbortSignal.abort().reason;\n\n\t\t\t\twhile (queue.size > 0) {\n\t\t\t\t\tqueue.dequeue().reject(abortError);\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t\tconcurrency: {\n\t\t\tget: () => concurrency,\n\n\t\t\tset(newConcurrency) {\n\t\t\t\tvalidateConcurrency(newConcurrency);\n\t\t\t\tconcurrency = newConcurrency;\n\n\t\t\t\tqueueMicrotask(() => {\n\t\t\t\t\t// eslint-disable-next-line no-unmodified-loop-condition\n\t\t\t\t\twhile (activeCount < concurrency && queue.size > 0) {\n\t\t\t\t\t\tresumeNext();\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t},\n\t\t},\n\t\tmap: {\n\t\t\tasync value(iterable, function_) {\n\t\t\t\tconst promises = Array.from(iterable, (value, index) => this(function_, value, index));\n\t\t\t\treturn Promise.all(promises);\n\t\t\t},\n\t\t},\n\t});\n\n\treturn generator;\n}\n\nexport function limitFunction(function_, options) {\n\tconst limit = pLimit(options);\n\n\treturn (...arguments_) => limit(() => function_(...arguments_));\n}\n\nfunction validateConcurrency(concurrency) {\n\tif (!((Number.isInteger(concurrency) || concurrency === Number.POSITIVE_INFINITY) && concurrency > 0)) {\n\t\tthrow new TypeError('Expected `concurrency` to be a number from 1 and up');\n\t}\n}\n","import type { CodeNode, FileNode } from '@kubb/ast'\nimport { extractStringsFromNodes } from '@kubb/ast'\nimport pLimit from 'p-limit'\nimport { PARALLEL_CONCURRENCY_LIMIT } from './constants.ts'\nimport type { Parser } from './defineParser.ts'\n\ntype ParseOptions = {\n parsers?: Map<FileNode['extname'], Parser>\n extension?: Record<FileNode['extname'], FileNode['extname'] | ''>\n}\n\ntype RunOptions = ParseOptions & {\n /**\n * @default 'sequential'\n */\n mode?: 'sequential' | 'parallel'\n onStart?: (files: Array<FileNode>) => Promise<void> | void\n onEnd?: (files: Array<FileNode>) => Promise<void> | void\n onUpdate?: (params: { file: FileNode; source?: string; processed: number; total: number; percentage: number }) => Promise<void> | void\n}\n\nfunction joinSources(file: FileNode): string {\n return file.sources\n .map((item) => extractStringsFromNodes(item.nodes as Array<CodeNode>))\n .filter(Boolean)\n .join('\\n\\n')\n}\n\n/**\n * Converts a single file to a string using the registered parsers.\n * Falls back to joining source values when no matching parser is found.\n *\n * @internal\n */\nexport class FileProcessor {\n readonly #limit = pLimit(PARALLEL_CONCURRENCY_LIMIT)\n\n async parse(file: FileNode, { parsers, extension }: ParseOptions = {}): Promise<string> {\n const parseExtName = extension?.[file.extname] || undefined\n\n if (!parsers || !file.extname) {\n return joinSources(file)\n }\n\n const parser = parsers.get(file.extname)\n\n if (!parser) {\n return joinSources(file)\n }\n\n return parser.parse(file, { extname: parseExtName })\n }\n\n async run(files: Array<FileNode>, { parsers, mode = 'sequential', extension, onStart, onEnd, onUpdate }: RunOptions = {}): Promise<Array<FileNode>> {\n await onStart?.(files)\n\n const total = files.length\n let processed = 0\n\n const processOne = async (file: FileNode) => {\n const source = await this.parse(file, { extension, parsers })\n const currentProcessed = ++processed\n const percentage = (currentProcessed / total) * 100\n\n await onUpdate?.({\n file,\n source,\n processed: currentProcessed,\n percentage,\n total,\n })\n }\n\n if (mode === 'sequential') {\n for (const file of files) {\n await processOne(file)\n }\n } else {\n await Promise.all(files.map((file) => this.#limit(() => processOne(file))))\n }\n\n await onEnd?.(files)\n\n return files\n }\n}\n","export type Storage = {\n /**\n * Identifier used for logging and debugging (e.g. `'fs'`, `'s3'`).\n */\n readonly name: string\n /**\n * Returns `true` when an entry for `key` exists in storage.\n */\n hasItem(key: string): Promise<boolean>\n /**\n * Returns the stored string value, or `null` when `key` does not exist.\n */\n getItem(key: string): Promise<string | null>\n /**\n * Persists `value` under `key`, creating any required structure.\n */\n setItem(key: string, value: string): Promise<void>\n /**\n * Removes the entry for `key`. No-ops when the key does not exist.\n */\n removeItem(key: string): Promise<void>\n /**\n * Returns all keys, optionally filtered to those starting with `base`.\n */\n getKeys(base?: string): Promise<Array<string>>\n /**\n * Removes all entries, optionally scoped to those starting with `base`.\n */\n clear(base?: string): Promise<void>\n /**\n * Optional teardown hook called after the build completes.\n */\n dispose?(): Promise<void>\n}\n\n/**\n * Factory for implementing custom storage backends that control where generated files are written.\n *\n * Takes a builder function `(options: TOptions) => Storage` and returns a factory `(options?: TOptions) => Storage`.\n * Kubb provides filesystem and in-memory implementations out of the box.\n *\n * @note Call the returned factory with optional options to instantiate the storage adapter.\n *\n * @example\n * ```ts\n * import { createStorage } from '@kubb/core'\n *\n * export const memoryStorage = createStorage(() => {\n * const store = new Map<string, string>()\n * return {\n * name: 'memory',\n * async hasItem(key) { return store.has(key) },\n * async getItem(key) { return store.get(key) ?? null },\n * async setItem(key, value) { store.set(key, value) },\n * async removeItem(key) { store.delete(key) },\n * async getKeys(base) {\n * const keys = [...store.keys()]\n * return base ? keys.filter((k) => k.startsWith(base)) : keys\n * },\n * async clear(base) { if (!base) store.clear() },\n * }\n * })\n *\n * // Instantiate:\n * const storage = memoryStorage()\n * ```\n */\nexport function createStorage<TOptions = Record<string, never>>(build: (options: TOptions) => Storage): (options?: TOptions) => Storage {\n return (options) => build(options ?? ({} as TOptions))\n}\n","import type { Dirent } from 'node:fs'\nimport { access, readdir, readFile, rm } from 'node:fs/promises'\nimport { join, resolve } from 'node:path'\nimport { clean, write } from '@internals/utils'\nimport { createStorage } from '../createStorage.ts'\n\n/**\n * Detects the filesystem error used to indicate that a path does not exist.\n */\nfunction isMissingPathError(error: unknown): error is NodeJS.ErrnoException {\n return typeof error === 'object' && error !== null && 'code' in error && (error as NodeJS.ErrnoException).code === 'ENOENT'\n}\n\n/**\n * Built-in filesystem storage driver.\n *\n * This is the default storage when no `storage` option is configured in the root config.\n * Keys are resolved against `process.cwd()`, so root-relative paths such as\n * `src/gen/api/getPets.ts` are written to the correct location without extra configuration.\n *\n * Internally uses the `write` utility from `@internals/utils`, which:\n * - trims leading/trailing whitespace before writing\n * - skips the write when file content is already identical (deduplication)\n * - creates missing parent directories automatically\n * - supports Bun's native file API when running under Bun\n *\n * @example\n * ```ts\n * import { fsStorage } from '@kubb/core'\n * import { defineConfig } from 'kubb'\n *\n * export default defineConfig({\n * input: { path: './petStore.yaml' },\n * output: { path: './src/gen' },\n * storage: fsStorage(),\n * })\n * ```\n */\nexport const fsStorage = createStorage(() => ({\n name: 'fs',\n async hasItem(key: string) {\n try {\n await access(resolve(key))\n return true\n } catch (error) {\n if (isMissingPathError(error)) {\n return false\n }\n\n throw new Error(`Failed to access storage item \"${key}\"`, {\n cause: error as Error,\n })\n }\n },\n async getItem(key: string) {\n try {\n return await readFile(resolve(key), 'utf8')\n } catch (error) {\n if (isMissingPathError(error)) {\n return null\n }\n\n throw new Error(`Failed to read storage item \"${key}\"`, {\n cause: error as Error,\n })\n }\n },\n async setItem(key: string, value: string) {\n await write(resolve(key), value, { sanity: false })\n },\n async removeItem(key: string) {\n await rm(resolve(key), { force: true })\n },\n async getKeys(base?: string) {\n const keys: Array<string> = []\n const resolvedBase = resolve(base ?? process.cwd())\n\n async function walk(dir: string, prefix: string): Promise<void> {\n let entries: Array<Dirent>\n try {\n entries = (await readdir(dir, {\n withFileTypes: true,\n })) as Array<Dirent>\n } catch (error) {\n if (isMissingPathError(error)) {\n return\n }\n\n throw new Error(`Failed to list storage keys under \"${resolvedBase}\"`, {\n cause: error as Error,\n })\n }\n for (const entry of entries) {\n const rel = prefix ? `${prefix}/${entry.name}` : entry.name\n if (entry.isDirectory()) {\n await walk(join(dir, entry.name), rel)\n } else {\n keys.push(rel)\n }\n }\n }\n\n await walk(resolvedBase, '')\n\n return keys\n },\n async clear(base?: string) {\n if (!base) {\n return\n }\n\n await clean(resolve(base))\n },\n}))\n","","import { version as nodeVersion } from 'node:process'\nimport { version as KubbVersion } from '../../package.json'\n\n/**\n * Returns a snapshot of the current runtime environment.\n *\n * Useful for attaching context to debug logs and error reports so that\n * issues can be reproduced without manual information gathering.\n */\nexport function getDiagnosticInfo() {\n return {\n nodeVersion,\n KubbVersion,\n platform: process.platform,\n arch: process.arch,\n cwd: process.cwd(),\n } as const\n}\n","import type { Config, InputPath, UserConfig } from '../types'\n\n/**\n * Type guard to check if a given config has an `input.path`.\n */\nexport function isInputPath(config: UserConfig | undefined): config is UserConfig<InputPath>\nexport function isInputPath(config: Config | undefined): config is Config<InputPath>\nexport function isInputPath(config: Config | UserConfig | undefined): config is Config<InputPath> | UserConfig<InputPath> {\n return typeof config?.input === 'object' && config.input !== null && 'path' in config.input\n}\n","import { resolve } from 'node:path'\nimport { AsyncEventEmitter, BuildError, exists, formatMs, getElapsedMs, URLPath } from '@internals/utils'\nimport type { FileNode, OperationNode } from '@kubb/ast'\nimport { transform, walk } from '@kubb/ast'\nimport { DEFAULT_BANNER, DEFAULT_EXTENSION, DEFAULT_STUDIO_URL } from './constants.ts'\nimport type { RendererFactory } from './createRenderer.ts'\nimport type { Generator } from './defineGenerator.ts'\nimport type { Parser } from './defineParser.ts'\nimport type { Plugin } from './definePlugin.ts'\nimport { FileProcessor } from './FileProcessor.ts'\nimport type { Kubb } from './Kubb.ts'\nimport { PluginDriver } from './PluginDriver.ts'\nimport { applyHookResult } from './renderNode.ts'\nimport { fsStorage } from './storages/fsStorage.ts'\nimport type { AdapterSource, Config, GeneratorContext, KubbHooks, Middleware, NormalizedPlugin, Storage, UserConfig } from './types.ts'\nimport { getDiagnosticInfo } from './utils/diagnostics.ts'\nimport { isInputPath } from './utils/isInputPath.ts'\n\ntype SetupOptions = {\n hooks?: AsyncEventEmitter<KubbHooks>\n}\n\n/**\n * Full output produced by a successful or failed build.\n */\nexport type BuildOutput = {\n /**\n * Plugins that threw during installation, paired with the caught error.\n */\n failedPlugins: Set<{ plugin: Plugin; error: Error }>\n files: Array<FileNode>\n driver: PluginDriver\n /**\n * Elapsed time in milliseconds for each plugin, keyed by plugin name.\n */\n pluginTimings: Map<string, number>\n error?: Error\n /**\n * Raw generated source, keyed by absolute file path.\n */\n sources: Map<string, string>\n}\n\ntype SetupResult = {\n hooks: AsyncEventEmitter<KubbHooks>\n driver: PluginDriver\n sources: Map<string, string>\n config: Config\n storage: Storage | null\n}\n\nasync function setup(userConfig: UserConfig, options: SetupOptions = {}): Promise<SetupResult> {\n const hooks = options.hooks ?? new AsyncEventEmitter<KubbHooks>()\n\n const sources: Map<string, string> = new Map<string, string>()\n const diagnosticInfo = getDiagnosticInfo()\n\n if (Array.isArray(userConfig.input)) {\n await hooks.emit('kubb:warn', { message: 'This feature is still under development — use with caution' })\n }\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [\n 'Configuration:',\n ` • Name: ${userConfig.name || 'unnamed'}`,\n ` • Root: ${userConfig.root || process.cwd()}`,\n ` • Output: ${userConfig.output?.path || 'not specified'}`,\n ` • Plugins: ${userConfig.plugins?.length || 0}`,\n 'Output Settings:',\n ` • Storage: ${userConfig.storage ? `custom(${userConfig.storage.name})` : userConfig.output?.write === false ? 'disabled' : 'filesystem (default)'}`,\n ` • Formatter: ${userConfig.output?.format || 'none'}`,\n ` • Linter: ${userConfig.output?.lint || 'none'}`,\n 'Environment:',\n Object.entries(diagnosticInfo)\n .map(([key, value]) => ` • ${key}: ${value}`)\n .join('\\n'),\n ],\n })\n\n try {\n if (isInputPath(userConfig) && !new URLPath(userConfig.input.path).isURL) {\n await exists(userConfig.input.path)\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [`✓ Input file validated: ${userConfig.input.path}`],\n })\n }\n } catch (caughtError) {\n if (isInputPath(userConfig)) {\n const error = caughtError as Error\n\n throw new Error(\n `Cannot read file/URL defined in \\`input.path\\` or set with \\`kubb generate PATH\\` in the CLI of your Kubb config ${userConfig.input.path}`,\n {\n cause: error,\n },\n )\n }\n }\n\n if (!userConfig.adapter) {\n throw new Error('Adapter should be defined')\n }\n\n const config: Config = {\n ...userConfig,\n root: userConfig.root || process.cwd(),\n parsers: userConfig.parsers ?? [],\n adapter: userConfig.adapter,\n output: {\n format: false,\n lint: false,\n write: true,\n extension: DEFAULT_EXTENSION,\n defaultBanner: DEFAULT_BANNER,\n ...userConfig.output,\n },\n devtools: userConfig.devtools\n ? {\n studioUrl: DEFAULT_STUDIO_URL,\n ...(typeof userConfig.devtools === 'boolean' ? {} : userConfig.devtools),\n }\n : undefined,\n plugins: userConfig.plugins as unknown as Config['plugins'],\n }\n\n const storage: Storage | null = config.output.write === false ? null : (config.storage ?? fsStorage())\n\n if (config.output.clean) {\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: ['Cleaning output directories', ` • Output: ${config.output.path}`],\n })\n await storage?.clear(resolve(config.root, config.output.path))\n }\n\n const driver = new PluginDriver(config, {\n hooks,\n })\n\n // Register middleware hooks after all plugin hooks are registered.\n // Because AsyncEventEmitter calls listeners in registration order,\n // middleware hooks for any event fire after all plugin hooks for that event.\n function registerMiddlewareHook<K extends keyof KubbHooks & string>(event: K, middlewareHooks: Middleware['hooks']) {\n const handler = middlewareHooks[event]\n if (handler) {\n hooks.on(event, handler)\n }\n }\n\n for (const middleware of config.middleware ?? []) {\n for (const event of Object.keys(middleware.hooks) as Array<keyof KubbHooks & string>) {\n registerMiddlewareHook(event, middleware.hooks)\n }\n }\n\n const adapter = config.adapter\n if (!adapter) {\n throw new Error('No adapter configured. Please provide an adapter in your kubb.config.ts.')\n }\n const source = inputToAdapterSource(config)\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [`Running adapter: ${adapter.name}`],\n })\n\n driver.adapter = adapter\n driver.inputNode = await adapter.parse(source)\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [\n `✓ Adapter '${adapter.name}' resolved InputNode`,\n ` • Schemas: ${driver.inputNode.schemas.length}`,\n ` • Operations: ${driver.inputNode.operations.length}`,\n ],\n })\n\n return {\n config,\n hooks,\n driver,\n sources,\n storage,\n }\n}\n\n/**\n * Walks the AST and dispatches nodes to a plugin's direct AST hooks\n * (`schema`, `operation`, `operations`).\n */\nasync function runPluginAstHooks(plugin: NormalizedPlugin, context: GeneratorContext): Promise<void> {\n const { adapter, inputNode, resolver, driver } = context\n const { exclude, include, override } = plugin.options\n\n if (!adapter || !inputNode) {\n throw new Error(`[${plugin.name}] No adapter found. Add an OAS adapter (e.g. pluginOas()) before this plugin in your Kubb config.`)\n }\n\n function resolveRenderer(gen: Generator): RendererFactory | undefined {\n return gen.renderer === null ? undefined : (gen.renderer ?? plugin.renderer ?? context.config.renderer)\n }\n\n const generators = plugin.generators ?? []\n const collectedOperations: Array<OperationNode> = []\n\n const generatorContext = {\n ...context,\n resolver: driver.getResolver(plugin.name),\n }\n\n await walk(inputNode, {\n depth: 'shallow',\n async schema(node) {\n const transformedNode = plugin.transformer ? transform(node, plugin.transformer) : node\n const options = resolver.resolveOptions(transformedNode, {\n options: plugin.options,\n exclude,\n include,\n override,\n })\n if (options === null) return\n\n const ctx = { ...generatorContext, options }\n\n for (const gen of generators) {\n if (!gen.schema) continue\n const result = await gen.schema(transformedNode, ctx)\n await applyHookResult(result, driver, resolveRenderer(gen))\n }\n\n await driver.hooks.emit('kubb:generate:schema', transformedNode, ctx)\n },\n async operation(node) {\n const transformedNode = plugin.transformer ? transform(node, plugin.transformer) : node\n const options = resolver.resolveOptions(transformedNode, {\n options: plugin.options,\n exclude,\n include,\n override,\n })\n if (options !== null) {\n collectedOperations.push(transformedNode)\n\n const ctx = { ...generatorContext, options }\n\n for (const gen of generators) {\n if (!gen.operation) continue\n const result = await gen.operation(transformedNode, ctx)\n await applyHookResult(result, driver, resolveRenderer(gen))\n }\n\n await driver.hooks.emit('kubb:generate:operation', transformedNode, ctx)\n }\n },\n })\n\n if (collectedOperations.length > 0) {\n const ctx = { ...generatorContext, options: plugin.options }\n\n for (const gen of generators) {\n if (!gen.operations) continue\n const result = await gen.operations(collectedOperations, ctx)\n await applyHookResult(result, driver, resolveRenderer(gen))\n }\n\n await driver.hooks.emit('kubb:generate:operations', collectedOperations, ctx)\n }\n}\n\nasync function safeBuild(setupResult: SetupResult): Promise<BuildOutput> {\n const { driver, hooks, sources, storage } = setupResult\n\n const failedPlugins = new Set<{ plugin: Plugin; error: Error }>()\n const pluginTimings = new Map<string, number>()\n const config = driver.config\n\n try {\n await driver.emitSetupHooks()\n\n if (driver.adapter && driver.inputNode) {\n await hooks.emit('kubb:build:start', {\n config,\n adapter: driver.adapter,\n inputNode: driver.inputNode,\n getPlugin: driver.getPlugin.bind(driver),\n get files() {\n return driver.fileManager.files\n },\n upsertFile: (...files) => driver.fileManager.upsert(...files),\n })\n }\n\n for (const plugin of driver.plugins.values()) {\n const context = driver.getContext(plugin)\n const hrStart = process.hrtime()\n\n try {\n const timestamp = new Date()\n\n await hooks.emit('kubb:plugin:start', { plugin })\n\n await hooks.emit('kubb:debug', {\n date: timestamp,\n logs: ['Starting plugin...', ` • Plugin Name: ${plugin.name}`],\n })\n\n if (plugin.generators?.length || driver.hasRegisteredGenerators(plugin.name)) {\n await runPluginAstHooks(plugin, context)\n }\n\n const duration = getElapsedMs(hrStart)\n pluginTimings.set(plugin.name, duration)\n\n await hooks.emit('kubb:plugin:end', {\n plugin,\n duration,\n success: true,\n config,\n get files() {\n return driver.fileManager.files\n },\n upsertFile: (...files) => driver.fileManager.upsert(...files),\n })\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [`✓ Plugin started successfully (${formatMs(duration)})`],\n })\n } catch (caughtError) {\n const error = caughtError as Error\n const errorTimestamp = new Date()\n const duration = getElapsedMs(hrStart)\n\n await hooks.emit('kubb:plugin:end', {\n plugin,\n duration,\n success: false,\n error,\n config,\n get files() {\n return driver.fileManager.files\n },\n upsertFile: (...files) => driver.fileManager.upsert(...files),\n })\n\n await hooks.emit('kubb:debug', {\n date: errorTimestamp,\n logs: [\n '✗ Plugin start failed',\n ` • Plugin Name: ${plugin.name}`,\n ` • Error: ${error.constructor.name} - ${error.message}`,\n ' • Stack Trace:',\n error.stack || 'No stack trace available',\n ],\n })\n\n failedPlugins.add({ plugin, error })\n }\n }\n\n await hooks.emit('kubb:plugins:end', {\n config,\n get files() {\n return driver.fileManager.files\n },\n upsertFile: (...files) => driver.fileManager.upsert(...files),\n })\n\n const files = driver.fileManager.files\n\n const parsersMap = new Map<FileNode['extname'], Parser>()\n for (const parser of config.parsers) {\n if (parser.extNames) {\n for (const extname of parser.extNames) {\n parsersMap.set(extname, parser)\n }\n }\n }\n\n const fileProcessor = new FileProcessor()\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [`Writing ${files.length} files...`],\n })\n\n await fileProcessor.run(files, {\n parsers: parsersMap,\n extension: config.output.extension,\n onStart: async (processingFiles) => {\n await hooks.emit('kubb:files:processing:start', { files: processingFiles })\n },\n onUpdate: async ({ file, source, processed, total, percentage }) => {\n await hooks.emit('kubb:file:processing:update', {\n file,\n source,\n processed,\n total,\n percentage,\n config,\n })\n if (source) {\n await storage?.setItem(file.path, source)\n sources.set(file.path, source)\n }\n },\n onEnd: async (processedFiles) => {\n await hooks.emit('kubb:files:processing:end', { files: processedFiles })\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [`✓ File write process completed for ${processedFiles.length} files`],\n })\n },\n })\n\n await hooks.emit('kubb:build:end', {\n files,\n config,\n outputDir: resolve(config.root, config.output.path),\n })\n\n return {\n failedPlugins,\n files,\n driver,\n pluginTimings,\n sources,\n }\n } catch (error) {\n return {\n failedPlugins,\n files: [],\n driver,\n pluginTimings,\n error: error as Error,\n sources,\n }\n } finally {\n driver.dispose()\n }\n}\n\nasync function build(setupResult: SetupResult): Promise<BuildOutput> {\n const { files, driver, failedPlugins, pluginTimings, error, sources } = await safeBuild(setupResult)\n\n if (error) {\n throw error\n }\n\n if (failedPlugins.size > 0) {\n const errors = [...failedPlugins].map(({ error }) => error)\n\n throw new BuildError(`Build Error with ${failedPlugins.size} failed plugins`, { errors })\n }\n\n return {\n failedPlugins,\n files,\n driver,\n pluginTimings,\n error: undefined,\n sources,\n }\n}\n\nfunction inputToAdapterSource(config: Config): AdapterSource {\n if (Array.isArray(config.input)) {\n return {\n type: 'paths',\n paths: config.input.map((i) => (new URLPath(i.path).isURL ? i.path : resolve(config.root, i.path))),\n }\n }\n\n if ('data' in config.input) {\n return { type: 'data', data: config.input.data }\n }\n\n if (new URLPath(config.input.path).isURL) {\n return { type: 'path', path: config.input.path }\n }\n\n const resolved = resolve(config.root, config.input.path)\n return { type: 'path', path: resolved }\n}\n\ntype CreateKubbOptions = {\n hooks?: AsyncEventEmitter<KubbHooks>\n}\n\n/**\n * Creates a Kubb instance bound to a single config entry.\n *\n * Accepts a user-facing config shape and resolves it to a full {@link Config} during\n * `setup()`. The instance then holds shared state (`hooks`, `sources`, `driver`, `config`)\n * across the `setup → build` lifecycle. Attach event listeners to `kubb.hooks` before\n * calling `setup()` or `build()`.\n *\n * @example\n * ```ts\n * const kubb = createKubb(userConfig)\n *\n * kubb.hooks.on('kubb:plugin:end', ({ plugin, duration }) => {\n * console.log(`${plugin.name} completed in ${duration}ms`)\n * })\n *\n * const { files, failedPlugins } = await kubb.safeBuild()\n * ```\n */\nexport function createKubb(userConfig: UserConfig, options: CreateKubbOptions = {}): Kubb {\n const hooks = options.hooks ?? new AsyncEventEmitter<KubbHooks>()\n let setupResult: SetupResult | undefined\n\n const instance: Kubb = {\n get hooks() {\n return hooks\n },\n get sources() {\n return setupResult?.sources ?? new Map()\n },\n get driver() {\n return setupResult?.driver\n },\n get config() {\n return setupResult?.config\n },\n async setup() {\n setupResult = await setup(userConfig, { hooks })\n },\n async build() {\n if (!setupResult) {\n await instance.setup()\n }\n return build(setupResult!)\n },\n async safeBuild() {\n if (!setupResult) {\n await instance.setup()\n }\n return safeBuild(setupResult!)\n },\n }\n\n return instance\n}\n","import type { FileNode } from '@kubb/ast'\n\n/**\n * Minimal interface any Kubb renderer must satisfy.\n *\n * The generic `TElement` is the type of the element the renderer accepts —\n * e.g. `KubbReactElement` for `@kubb/renderer-jsx`, or a custom type for\n * your own renderer. Defaults to `unknown` so that generators which do not\n * care about the element type continue to work without specifying it.\n *\n * This allows core to drive rendering without a hard dependency on\n * `@kubb/renderer-jsx` or any specific renderer implementation.\n */\nexport type Renderer<TElement = unknown> = {\n render(element: TElement): Promise<void>\n unmount(error?: Error | number | null): void\n readonly files: Array<FileNode>\n}\n\n/**\n * A factory function that produces a fresh {@link Renderer} per render.\n *\n * Generators use this to declare which renderer handles their output.\n */\nexport type RendererFactory<TElement = unknown> = () => Renderer<TElement>\n\n/**\n * Creates a renderer factory for use in generator definitions.\n *\n * Wrap your renderer factory function with this helper to register it as the\n * renderer for a generator. Core will call this factory once per render cycle\n * to obtain a fresh renderer instance.\n *\n * @example\n * ```ts\n * // packages/renderer-jsx/src/index.ts\n * export const jsxRenderer = createRenderer(() => {\n * const runtime = new Runtime()\n * return {\n * async render(element) { await runtime.render(element) },\n * get files() { return runtime.nodes },\n * unmount(error) { runtime.unmount(error) },\n * }\n * })\n *\n * // packages/plugin-zod/src/generators/zodGenerator.tsx\n * import { jsxRenderer } from '@kubb/renderer-jsx'\n * export const zodGenerator = defineGenerator<PluginZod>({\n * name: 'zod',\n * renderer: jsxRenderer,\n * schema(node, options) { return <File ...>...</File> },\n * })\n * ```\n */\nexport function createRenderer<TElement = unknown>(factory: RendererFactory<TElement>): RendererFactory<TElement> {\n return factory\n}\n","import type { PossiblePromise } from '@internals/utils'\nimport type { FileNode, OperationNode, SchemaNode } from '@kubb/ast'\nimport type { RendererFactory } from './createRenderer.ts'\nimport type { GeneratorContext, PluginFactoryOptions } from './types.ts'\n\nexport type { GeneratorContext } from './types.ts'\n\n/**\n * Declares a named generator unit that walks the AST and emits files.\n *\n * Each method (`schema`, `operation`, `operations`) is called for the matching node type.\n * Each method returns `TElement | Array<FileNode> | void`. JSX-based generators require a `renderer` factory.\n * Return `Array<FileNode>` directly or call `ctx.upsertFile()` manually and return `void` to bypass rendering.\n *\n * @note Generators are consumed by plugins and registered via `ctx.addGenerator()` in `kubb:plugin:setup`.\n *\n * @example\n * ```ts\n * import { defineGenerator } from '@kubb/core'\n * import { jsxRenderer } from '@kubb/renderer-jsx'\n *\n * export const typeGenerator = defineGenerator({\n * name: 'typescript',\n * renderer: jsxRenderer,\n * schema(node, ctx) {\n * const { adapter, resolver, root, options } = ctx\n * return <File ...><Type node={node} resolver={resolver} /></File>\n * },\n * })\n * ```\n */\nexport type Generator<TOptions extends PluginFactoryOptions = PluginFactoryOptions, TElement = unknown> = {\n /**\n * Used in diagnostic messages and debug output.\n */\n name: string\n /**\n * Optional renderer factory that produces a {@link Renderer} for each render cycle.\n *\n * Generators that return renderer elements (e.g. JSX via `@kubb/renderer-jsx`) must set this\n * to the matching renderer factory (e.g. `jsxRenderer` from `@kubb/renderer-jsx`).\n *\n * Generators that only return `Array<FileNode>` or `void` do not need to set this.\n *\n * Set `renderer: null` to explicitly opt out of rendering even when the parent plugin\n * declares a `renderer` (overrides the plugin-level fallback).\n *\n * @example\n * ```ts\n * import { jsxRenderer } from '@kubb/renderer-jsx'\n * export const myGenerator = defineGenerator<PluginTs>({\n * renderer: jsxRenderer,\n * schema(node, ctx) { return <File ...>...</File> },\n * })\n * ```\n */\n renderer?: RendererFactory<TElement> | null\n /**\n * Called for each schema node in the AST walk.\n * `ctx` carries the plugin context with `adapter` and `inputNode` guaranteed present,\n * plus `ctx.options` with the per-node resolved options (after exclude/include/override).\n */\n schema?: (node: SchemaNode, ctx: GeneratorContext<TOptions>) => PossiblePromise<TElement | Array<FileNode> | void>\n /**\n * Called for each operation node in the AST walk.\n * `ctx` carries the plugin context with `adapter` and `inputNode` guaranteed present,\n * plus `ctx.options` with the per-node resolved options (after exclude/include/override).\n */\n operation?: (node: OperationNode, ctx: GeneratorContext<TOptions>) => PossiblePromise<TElement | Array<FileNode> | void>\n /**\n * Called once after all operations have been walked.\n * `ctx` carries the plugin context with `adapter` and `inputNode` guaranteed present,\n * plus `ctx.options` with the plugin-level options for the batch call.\n */\n operations?: (nodes: Array<OperationNode>, ctx: GeneratorContext<TOptions>) => PossiblePromise<TElement | Array<FileNode> | void>\n}\n\n/**\n * Defines a generator. Returns the object as-is with correct `this` typings.\n * `applyHookResult` handles renderer elements and `File[]` uniformly using\n * the generator's declared `renderer` factory.\n */\nexport function defineGenerator<TOptions extends PluginFactoryOptions = PluginFactoryOptions, TElement = unknown>(\n generator: Generator<TOptions, TElement>,\n): Generator<TOptions, TElement> {\n return generator\n}\n","import type { Logger, LoggerOptions, UserLogger } from './types.ts'\n\n/**\n * Wraps a logger definition into a typed {@link Logger}.\n *\n * @example\n * ```ts\n * export const myLogger = defineLogger({\n * name: 'my-logger',\n * install(context, options) {\n * context.on('kubb:info', (message) => console.log('ℹ', message))\n * context.on('kubb:error', (error) => console.error('✗', error.message))\n * },\n * })\n * ```\n */\nexport function defineLogger<Options extends LoggerOptions = LoggerOptions>(logger: UserLogger<Options>): Logger<Options> {\n return logger\n}\n","import type { KubbHooks } from './Kubb.ts'\n\n/**\n * A middleware instance produced by calling a factory created with `defineMiddleware`.\n * It declares event handlers under a `hooks` object which are registered on the\n * shared emitter after all plugin hooks, so middleware handlers for any event\n * always fire last.\n */\nexport type Middleware = {\n /**\n * Unique identifier for this middleware.\n */\n name: string\n /**\n * Lifecycle event handlers for this middleware.\n * Any event from the global `KubbHooks` map can be subscribed to here.\n * Handlers are registered after all plugin handlers, so they always fire last.\n */\n hooks: {\n [K in keyof KubbHooks]?: (...args: KubbHooks[K]) => void | Promise<void>\n }\n}\n\n/**\n * Creates a middleware factory using the hook-style `hooks` API.\n *\n * Middleware handlers fire after all plugin handlers for any given event, making them ideal for post-processing, logging, and auditing.\n * Per-build state (such as accumulators) belongs inside the factory closure so each `createKubb` invocation gets its own isolated instance.\n *\n * @note The factory can accept typed options. See examples for using options and per-build state patterns.\n *\n * @example\n * ```ts\n * import { defineMiddleware } from '@kubb/core'\n *\n * // Stateless middleware\n * export const logMiddleware = defineMiddleware(() => ({\n * name: 'log-middleware',\n * hooks: {\n * 'kubb:build:end'({ files }) {\n * console.log(`Build complete with ${files.length} files`)\n * },\n * },\n * }))\n *\n * // Middleware with options and per-build state\n * export const prefixMiddleware = defineMiddleware((options: { prefix: string } = { prefix: '' }) => {\n * const seen = new Set<string>()\n * return {\n * name: 'prefix-middleware',\n * hooks: {\n * 'kubb:plugin:end'({ plugin }) {\n * seen.add(`${options.prefix}${plugin.name}`)\n * },\n * },\n * }\n * })\n * ```\n */\nexport function defineMiddleware<TOptions extends object = object>(factory: (options: TOptions) => Middleware): (options?: TOptions) => Middleware {\n return (options) => factory(options ?? ({} as TOptions))\n}\n","import type { FileNode } from '@kubb/ast'\n\ntype PrintOptions = {\n extname?: FileNode['extname']\n}\n\nexport type Parser<TMeta extends object = any> = {\n name: string\n /**\n * File extensions this parser handles.\n * Use `undefined` to create a catch-all fallback parser.\n *\n * @example Handled extensions\n * `['.ts', '.js']`\n */\n extNames: Array<FileNode['extname']> | undefined\n /**\n * Convert a resolved file to a string.\n */\n parse(file: FileNode<TMeta>, options?: PrintOptions): Promise<string> | string\n}\n\n/**\n * Defines a parser with type safety. Creates parsers that transform generated files to strings based on their extension.\n *\n * @note Call the returned factory with optional options to instantiate the parser.\n *\n * @example\n * ```ts\n * import { defineParser } from '@kubb/core'\n *\n * export const jsonParser = defineParser({\n * name: 'json',\n * extNames: ['.json'],\n * parse(file) {\n * const { extractStringsFromNodes } = await import('@kubb/ast')\n * return file.sources.map((s) => extractStringsFromNodes(s.nodes ?? [])).join('\\n')\n * },\n * })\n * ```\n */\nexport function defineParser<TMeta extends object = any>(parser: Parser<TMeta>): Parser<TMeta> {\n return parser\n}\n","import type { KubbHooks } from './Kubb.ts'\nimport type { KubbPluginSetupContext, PluginFactoryOptions } from './types.ts'\n\n/**\n * A plugin object produced by `definePlugin`.\n * Instead of flat lifecycle methods, it groups all handlers under a `hooks:` property\n * (matching Astro's integration naming convention).\n *\n * @template TFactory - The plugin's `PluginFactoryOptions` type.\n */\nexport type Plugin<TFactory extends PluginFactoryOptions = PluginFactoryOptions> = {\n /**\n * Unique name for the plugin, following the same naming convention as `createPlugin`.\n */\n name: string\n /**\n * Plugins that must be registered before this plugin executes.\n * An error is thrown at startup when any listed dependency is missing.\n */\n dependencies?: Array<string>\n /**\n * Controls the execution order of this plugin relative to others.\n *\n * - `'pre'` — runs before all normal plugins.\n * - `'post'` — runs after all normal plugins.\n * - `undefined` (default) — runs in declaration order among normal plugins.\n *\n * Dependency constraints always take precedence over `enforce`.\n */\n enforce?: 'pre' | 'post'\n /**\n * The options passed by the user when calling the plugin factory.\n */\n options?: TFactory['options']\n /**\n * Lifecycle event handlers for this plugin.\n * Any event from the global `KubbHooks` map can be subscribed to here.\n */\n hooks: {\n [K in Exclude<keyof KubbHooks, 'kubb:plugin:setup'>]?: (...args: KubbHooks[K]) => void | Promise<void>\n } & {\n 'kubb:plugin:setup'?(ctx: KubbPluginSetupContext<TFactory>): void | Promise<void>\n }\n}\n\n/**\n * Returns `true` when `plugin` is a hook-style plugin created with `definePlugin`.\n *\n * Used by `PluginDriver` to distinguish hook-style plugins from legacy `createPlugin` plugins\n * so it can normalize them and register their handlers on the `AsyncEventEmitter`.\n */\nexport function isPlugin(plugin: unknown): plugin is Plugin {\n return typeof plugin === 'object' && plugin !== null && 'hooks' in plugin\n}\n\n/**\n * Wraps a factory function and returns a typed `Plugin` with lifecycle handlers grouped under `hooks`.\n *\n * Handlers live in a single `hooks` object (inspired by Astro integrations).\n * All lifecycle events from `KubbHooks` are available for subscription.\n *\n * @note For real plugins, use a `PluginFactoryOptions` type parameter to get type-safe context in `kubb:plugin:setup`.\n * Plugin names should follow the convention `plugin-<feature>` (e.g., `plugin-react-query`, `plugin-zod`).\n *\n * @example\n * ```ts\n * import { definePlugin } from '@kubb/core'\n *\n * export const pluginTs = definePlugin((options: { prefix?: string } = {}) => ({\n * name: 'plugin-ts',\n * hooks: {\n * 'kubb:plugin:setup'(ctx) {\n * ctx.setResolver(resolverTs)\n * },\n * },\n * }))\n * ```\n */\nexport function definePlugin<TFactory extends PluginFactoryOptions = PluginFactoryOptions>(\n factory: (options: TFactory['options']) => Plugin<TFactory>,\n): (options?: TFactory['options']) => Plugin<TFactory> {\n return (options) => factory(options ?? ({} as TFactory['options']))\n}\n","import { createStorage } from '../createStorage.ts'\n\n/**\n * In-memory storage driver. Useful for testing and dry-run scenarios where\n * generated output should be captured without touching the filesystem.\n *\n * All data lives in a `Map` scoped to the storage instance and is discarded\n * when the instance is garbage-collected.\n *\n * @example\n * ```ts\n * import { memoryStorage } from '@kubb/core'\n * import { defineConfig } from 'kubb'\n *\n * export default defineConfig({\n * input: { path: './petStore.yaml' },\n * output: { path: './src/gen' },\n * storage: memoryStorage(),\n * })\n * ```\n */\nexport const memoryStorage = createStorage(() => {\n const store = new Map<string, string>()\n\n return {\n name: 'memory',\n async hasItem(key: string) {\n return store.has(key)\n },\n async getItem(key: string) {\n return store.get(key) ?? null\n },\n async setItem(key: string, value: string) {\n store.set(key, value)\n },\n async removeItem(key: string) {\n store.delete(key)\n },\n async getKeys(base?: string) {\n const keys = [...store.keys()]\n return base ? keys.filter((k) => k.startsWith(base)) : keys\n },\n async clear(base?: string) {\n if (!base) {\n store.clear()\n return\n }\n for (const key of store.keys()) {\n if (key.startsWith(base)) {\n store.delete(key)\n }\n }\n },\n }\n})\n"],"x_google_ignoreList":[7,8],"mappings":"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"}
1
+ {"version":3,"file":"index.js","names":["#emitter","NodeEventEmitter","#options","#transformParam","#eachParam","Node","#head","#tail","#size","#limit"],"sources":["../../../internals/utils/src/errors.ts","../../../internals/utils/src/asyncEventEmitter.ts","../../../internals/utils/src/time.ts","../../../internals/utils/src/fs.ts","../../../internals/utils/src/reserved.ts","../../../internals/utils/src/urlPath.ts","../src/createAdapter.ts","../../../node_modules/.pnpm/yocto-queue@1.2.2/node_modules/yocto-queue/index.js","../../../node_modules/.pnpm/p-limit@7.3.0/node_modules/p-limit/index.js","../src/FileProcessor.ts","../src/createStorage.ts","../src/storages/fsStorage.ts","../package.json","../src/utils/diagnostics.ts","../src/utils/isInputPath.ts","../src/createKubb.ts","../src/createRenderer.ts","../src/defineGenerator.ts","../src/defineLogger.ts","../src/defineMiddleware.ts","../src/defineParser.ts","../src/definePlugin.ts","../src/storages/memoryStorage.ts"],"sourcesContent":["/**\n * Thrown when one or more errors occur during a Kubb build.\n * Carries the full list of underlying errors on `errors`.\n *\n * @example\n * ```ts\n * throw new BuildError('Build failed', { errors: [err1, err2] })\n * ```\n */\nexport class BuildError extends Error {\n errors: Array<Error>\n\n constructor(message: string, options: { cause?: Error; errors: Array<Error> }) {\n super(message, { cause: options.cause })\n this.name = 'BuildError'\n this.errors = options.errors\n }\n}\n\n/**\n * Coerces an unknown thrown value to an `Error` instance.\n * Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.\n *\n * @example\n * ```ts\n * try { ... } catch(err) {\n * throw new BuildError('Build failed', { cause: toError(err), errors: [] })\n * }\n * ```\n */\nexport function toError(value: unknown): Error {\n return value instanceof Error ? value : new Error(String(value))\n}\n\n/**\n * Extracts a human-readable message from any thrown value.\n *\n * @example\n * ```ts\n * getErrorMessage(new Error('oops')) // 'oops'\n * getErrorMessage('plain string') // 'plain string'\n * ```\n */\nexport function getErrorMessage(value: unknown): string {\n return value instanceof Error ? value.message : String(value)\n}\n\n/**\n * Extracts the `.cause` of an `Error` as an `Error`, or `undefined` when absent or not an `Error`.\n *\n * @example\n * ```ts\n * const cause = toCause(buildError) // Error | undefined\n * ```\n */\nexport function toCause(error: Error): Error | undefined {\n return error.cause instanceof Error ? error.cause : undefined\n}\n","import { EventEmitter as NodeEventEmitter } from 'node:events'\nimport { toError } from './errors.ts'\n\n/**\n * A function that can be registered as an event listener, synchronous or async.\n */\ntype AsyncListener<TArgs extends unknown[]> = (...args: TArgs) => void | Promise<void>\n\n/**\n * Typed `EventEmitter` that awaits all async listeners before resolving.\n * Wraps Node's `EventEmitter` with full TypeScript event-map inference.\n *\n * @example\n * ```ts\n * const emitter = new AsyncEventEmitter<{ build: [name: string] }>()\n * emitter.on('build', async (name) => { console.log(name) })\n * await emitter.emit('build', 'petstore') // all listeners awaited\n * ```\n */\nexport class AsyncEventEmitter<TEvents extends { [K in keyof TEvents]: unknown[] }> {\n /**\n * Maximum number of listeners per event before Node emits a memory-leak warning.\n * @default 10\n */\n constructor(maxListener = 10) {\n this.#emitter.setMaxListeners(maxListener)\n }\n\n #emitter = new NodeEventEmitter()\n\n /**\n * Emits `eventName` and awaits all registered listeners sequentially.\n * Throws if any listener rejects, wrapping the cause with the event name and serialized arguments.\n *\n * @example\n * ```ts\n * await emitter.emit('build', 'petstore')\n * ```\n */\n async emit<TEventName extends keyof TEvents & string>(eventName: TEventName, ...eventArgs: TEvents[TEventName]): Promise<void> {\n const listeners = this.#emitter.listeners(eventName) as Array<AsyncListener<TEvents[TEventName]>>\n\n if (listeners.length === 0) {\n return\n }\n\n for (const listener of listeners) {\n try {\n await listener(...eventArgs)\n } catch (err) {\n let serializedArgs: string\n try {\n serializedArgs = JSON.stringify(eventArgs)\n } catch {\n serializedArgs = String(eventArgs)\n }\n throw new Error(`Error in async listener for \"${eventName}\" with eventArgs ${serializedArgs}`, { cause: toError(err) })\n }\n }\n }\n\n /**\n * Registers a persistent listener for `eventName`.\n *\n * @example\n * ```ts\n * emitter.on('build', async (name) => { console.log(name) })\n * ```\n */\n on<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n this.#emitter.on(eventName, handler as AsyncListener<unknown[]>)\n }\n\n /**\n * Registers a one-shot listener that removes itself after the first invocation.\n *\n * @example\n * ```ts\n * emitter.onOnce('build', async (name) => { console.log(name) })\n * ```\n */\n onOnce<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n const wrapper: AsyncListener<TEvents[TEventName]> = (...args) => {\n this.off(eventName, wrapper)\n return handler(...args)\n }\n this.on(eventName, wrapper)\n }\n\n /**\n * Removes a previously registered listener.\n *\n * @example\n * ```ts\n * emitter.off('build', handler)\n * ```\n */\n off<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void {\n this.#emitter.off(eventName, handler as AsyncListener<unknown[]>)\n }\n\n /**\n * Returns the number of listeners registered for `eventName`.\n *\n * @example\n * ```ts\n * emitter.on('build', handler)\n * emitter.listenerCount('build') // 1\n * ```\n */\n listenerCount<TEventName extends keyof TEvents & string>(eventName: TEventName): number {\n return this.#emitter.listenerCount(eventName)\n }\n\n /**\n * Removes all listeners from every event channel.\n *\n * @example\n * ```ts\n * emitter.removeAll()\n * ```\n */\n removeAll(): void {\n this.#emitter.removeAllListeners()\n }\n}\n","/**\n * Calculates elapsed time in milliseconds from a high-resolution `process.hrtime` start time.\n * Rounds to 2 decimal places for sub-millisecond precision without noise.\n *\n * @example\n * ```ts\n * const start = process.hrtime()\n * doWork()\n * getElapsedMs(start) // 42.35\n * ```\n */\nexport function getElapsedMs(hrStart: [number, number]): number {\n const [seconds, nanoseconds] = process.hrtime(hrStart)\n const ms = seconds * 1000 + nanoseconds / 1e6\n return Math.round(ms * 100) / 100\n}\n\n/**\n * Converts a millisecond duration into a human-readable string (`ms`, `s`, or `m s`).\n *\n * @example\n * ```ts\n * formatMs(250) // '250ms'\n * formatMs(1500) // '1.50s'\n * formatMs(90000) // '1m 30.0s'\n * ```\n */\nexport function formatMs(ms: number): string {\n if (ms >= 60000) {\n const mins = Math.floor(ms / 60000)\n const secs = ((ms % 60000) / 1000).toFixed(1)\n return `${mins}m ${secs}s`\n }\n\n if (ms >= 1000) {\n return `${(ms / 1000).toFixed(2)}s`\n }\n return `${Math.round(ms)}ms`\n}\n\n/**\n * Formats the elapsed time since `hrStart` as a human-readable string.\n *\n * @example\n * ```ts\n * const start = process.hrtime()\n * doWork()\n * formatHrtime(start) // '1.50s'\n * ```\n */\nexport function formatHrtime(hrStart: [number, number]): string {\n return formatMs(getElapsedMs(hrStart))\n}\n","import { existsSync, readFileSync } from 'node:fs'\nimport { access, mkdir, readFile, rm, writeFile } from 'node:fs/promises'\nimport { dirname, join, posix, resolve } from 'node:path'\n\n/**\n * Walks up the directory tree from `cwd` (defaults to `process.cwd()`) and\n * returns the absolute path of the nearest `package.json`, or `null` when none\n * is found before reaching the filesystem root.\n *\n * @example\n * ```ts\n * const pkgPath = findPackageJSON('/home/user/project/src') // '/home/user/project/package.json'\n * ```\n */\nexport function findPackageJSON(cwd?: string): string | null {\n let dir = cwd ? resolve(cwd) : process.cwd()\n while (true) {\n const pkgPath = join(dir, 'package.json')\n if (existsSync(pkgPath)) return pkgPath\n const parent = dirname(dir)\n if (parent === dir) return null\n dir = parent\n }\n}\n\n/**\n * Converts all backslashes to forward slashes.\n * Extended-length Windows paths (`\\\\?\\...`) are left unchanged.\n */\nfunction toSlash(p: string): string {\n if (p.startsWith('\\\\\\\\?\\\\')) return p\n return p.replaceAll('\\\\', '/')\n}\n\n/**\n * Returns the relative path from `rootDir` to `filePath`, always using forward slashes\n * and prefixed with `./` when not already traversing upward.\n *\n * @example\n * ```ts\n * getRelativePath('/src/components', '/src/components/Button.tsx') // './Button.tsx'\n * getRelativePath('/src/components', '/src/utils/helpers.ts') // '../utils/helpers.ts'\n * ```\n */\nexport function getRelativePath(rootDir?: string | null, filePath?: string | null): string {\n if (!rootDir || !filePath) {\n throw new Error(`Root and file should be filled in when retrieving the relativePath, ${rootDir || ''} ${filePath || ''}`)\n }\n\n const relativePath = posix.relative(toSlash(rootDir), toSlash(filePath))\n\n return relativePath.startsWith('../') ? relativePath : `./${relativePath}`\n}\n\n/**\n * Resolves to `true` when the file or directory at `path` exists.\n * Uses `Bun.file().exists()` when running under Bun, `fs.access` otherwise.\n *\n * @example\n * ```ts\n * if (await exists('./kubb.config.ts')) {\n * const content = await read('./kubb.config.ts')\n * }\n * ```\n */\nexport async function exists(path: string): Promise<boolean> {\n if (typeof Bun !== 'undefined') {\n return Bun.file(path).exists()\n }\n return access(path).then(\n () => true,\n () => false,\n )\n}\n\n/**\n * Reads the file at `path` as a UTF-8 string.\n * Uses `Bun.file().text()` when running under Bun, `fs.readFile` otherwise.\n *\n * @example\n * ```ts\n * const source = await read('./src/Pet.ts')\n * ```\n */\nexport async function read(path: string): Promise<string> {\n if (typeof Bun !== 'undefined') {\n return Bun.file(path).text()\n }\n return readFile(path, { encoding: 'utf8' })\n}\n\n/**\n * Synchronous counterpart of `read`.\n *\n * @example\n * ```ts\n * const source = readSync('./src/Pet.ts')\n * ```\n */\nexport function readSync(path: string): string {\n return readFileSync(path, { encoding: 'utf8' })\n}\n\ntype WriteOptions = {\n /**\n * When `true`, re-reads the file immediately after writing and throws if the\n * content does not match — useful for catching write failures on unreliable file systems.\n */\n sanity?: boolean\n}\n\n/**\n * Writes `data` to `path`, trimming leading/trailing whitespace before saving.\n * Skips the write when the trimmed content is empty or identical to what is already on disk.\n * Creates any missing parent directories automatically.\n * When `sanity` is `true`, re-reads the file after writing and throws if the content does not match.\n *\n * @example\n * ```ts\n * await write('./src/Pet.ts', source) // writes and returns trimmed content\n * await write('./src/Pet.ts', source) // null — file unchanged\n * await write('./src/Pet.ts', ' ') // null — empty content skipped\n * ```\n */\nexport async function write(path: string, data: string, options: WriteOptions = {}): Promise<string | null> {\n const trimmed = data.trim()\n if (trimmed === '') return null\n\n const resolved = resolve(path)\n\n if (typeof Bun !== 'undefined') {\n const file = Bun.file(resolved)\n const oldContent = (await file.exists()) ? await file.text() : null\n if (oldContent === trimmed) return null\n await Bun.write(resolved, trimmed)\n return trimmed\n }\n\n try {\n const oldContent = await readFile(resolved, { encoding: 'utf-8' })\n if (oldContent === trimmed) return null\n } catch {\n /* file doesn't exist yet */\n }\n\n await mkdir(dirname(resolved), { recursive: true })\n await writeFile(resolved, trimmed, { encoding: 'utf-8' })\n\n if (options.sanity) {\n const savedData = await readFile(resolved, { encoding: 'utf-8' })\n if (savedData !== trimmed) {\n throw new Error(`Sanity check failed for ${path}\\n\\nData[${data.length}]:\\n${data}\\n\\nSaved[${savedData.length}]:\\n${savedData}\\n`)\n }\n return savedData\n }\n\n return trimmed\n}\n\n/**\n * Recursively removes `path`. Silently succeeds when `path` does not exist.\n *\n * @example\n * ```ts\n * await clean('./dist')\n * ```\n */\nexport async function clean(path: string): Promise<void> {\n return rm(path, { recursive: true, force: true })\n}\n","/**\n * JavaScript and Java reserved words.\n * @link https://github.com/jonschlinkert/reserved/blob/master/index.js\n */\nconst reservedWords = new Set([\n 'abstract',\n 'arguments',\n 'boolean',\n 'break',\n 'byte',\n 'case',\n 'catch',\n 'char',\n 'class',\n 'const',\n 'continue',\n 'debugger',\n 'default',\n 'delete',\n 'do',\n 'double',\n 'else',\n 'enum',\n 'eval',\n 'export',\n 'extends',\n 'false',\n 'final',\n 'finally',\n 'float',\n 'for',\n 'function',\n 'goto',\n 'if',\n 'implements',\n 'import',\n 'in',\n 'instanceof',\n 'int',\n 'interface',\n 'let',\n 'long',\n 'native',\n 'new',\n 'null',\n 'package',\n 'private',\n 'protected',\n 'public',\n 'return',\n 'short',\n 'static',\n 'super',\n 'switch',\n 'synchronized',\n 'this',\n 'throw',\n 'throws',\n 'transient',\n 'true',\n 'try',\n 'typeof',\n 'var',\n 'void',\n 'volatile',\n 'while',\n 'with',\n 'yield',\n 'Array',\n 'Date',\n 'hasOwnProperty',\n 'Infinity',\n 'isFinite',\n 'isNaN',\n 'isPrototypeOf',\n 'length',\n 'Math',\n 'name',\n 'NaN',\n 'Number',\n 'Object',\n 'prototype',\n 'String',\n 'toString',\n 'undefined',\n 'valueOf',\n] as const)\n\n/**\n * Prefixes `word` with `_` when it is a reserved JavaScript/Java identifier or starts with a digit.\n *\n * @example\n * ```ts\n * transformReservedWord('class') // '_class'\n * transformReservedWord('42foo') // '_42foo'\n * transformReservedWord('status') // 'status'\n * ```\n */\nexport function transformReservedWord(word: string): string {\n const firstChar = word.charCodeAt(0)\n if (word && (reservedWords.has(word as 'valueOf') || (firstChar >= 48 && firstChar <= 57))) {\n return `_${word}`\n }\n return word\n}\n\n/**\n * Returns `true` when `name` is a syntactically valid JavaScript variable name.\n *\n * @example\n * ```ts\n * isValidVarName('status') // true\n * isValidVarName('class') // false (reserved word)\n * isValidVarName('42foo') // false (starts with digit)\n * ```\n */\nexport function isValidVarName(name: string): boolean {\n if (!name || reservedWords.has(name as 'valueOf')) {\n return false\n }\n return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name)\n}\n","import { camelCase } from './casing.ts'\nimport { isValidVarName } from './reserved.ts'\n\nexport type URLObject = {\n /**\n * The resolved URL string (Express-style or template literal, depending on context).\n */\n url: string\n /**\n * Extracted path parameters as a key-value map, or `undefined` when the path has none.\n */\n params?: Record<string, string>\n}\n\ntype ObjectOptions = {\n /**\n * Controls whether the `url` is rendered as an Express path or a template literal.\n * @default 'path'\n */\n type?: 'path' | 'template'\n /**\n * Optional transform applied to each extracted parameter name.\n */\n replacer?: (pathParam: string) => string\n /**\n * When `true`, the result is serialized to a string expression instead of a plain object.\n */\n stringify?: boolean\n}\n\n/**\n * Supported identifier casing strategies for path parameters.\n */\ntype PathCasing = 'camelcase'\n\ntype Options = {\n /**\n * Casing strategy applied to path parameter names.\n * @default undefined (original identifier preserved)\n */\n casing?: PathCasing\n}\n\n/**\n * Parses and transforms an OpenAPI/Swagger path string into various URL formats.\n *\n * @example\n * const p = new URLPath('/pet/{petId}')\n * p.URL // '/pet/:petId'\n * p.template // '`/pet/${petId}`'\n */\nexport class URLPath {\n /**\n * The raw OpenAPI/Swagger path string, e.g. `/pet/{petId}`.\n */\n path: string\n\n #options: Options\n\n constructor(path: string, options: Options = {}) {\n this.path = path\n this.#options = options\n }\n\n /** Converts the OpenAPI path to Express-style colon syntax, e.g. `/pet/{petId}` → `/pet/:petId`.\n *\n * @example\n * ```ts\n * new URLPath('/pet/{petId}').URL // '/pet/:petId'\n * ```\n */\n get URL(): string {\n return this.toURLPath()\n }\n\n /** Returns `true` when `path` is a fully-qualified URL (e.g. starts with `https://`).\n *\n * @example\n * ```ts\n * new URLPath('https://petstore.swagger.io/v2/pet').isURL // true\n * new URLPath('/pet/{petId}').isURL // false\n * ```\n */\n get isURL(): boolean {\n try {\n return !!new URL(this.path).href\n } catch {\n return false\n }\n }\n\n /**\n * Converts the OpenAPI path to a TypeScript template literal string.\n *\n * @example\n * new URLPath('/pet/{petId}').template // '`/pet/${petId}`'\n * new URLPath('/account/monetary-accountID').template // '`/account/${monetaryAccountId}`'\n */\n get template(): string {\n return this.toTemplateString()\n }\n\n /** Returns the path and its extracted params as a structured `URLObject`, or as a stringified expression when `stringify` is set.\n *\n * @example\n * ```ts\n * new URLPath('/pet/{petId}').object\n * // { url: '/pet/:petId', params: { petId: 'petId' } }\n * ```\n */\n get object(): URLObject | string {\n return this.toObject()\n }\n\n /** Returns a map of path parameter names, or `undefined` when the path has no parameters.\n *\n * @example\n * ```ts\n * new URLPath('/pet/{petId}').params // { petId: 'petId' }\n * new URLPath('/pet').params // undefined\n * ```\n */\n get params(): Record<string, string> | undefined {\n return this.getParams()\n }\n\n #transformParam(raw: string): string {\n const param = isValidVarName(raw) ? raw : camelCase(raw)\n return this.#options.casing === 'camelcase' ? camelCase(param) : param\n }\n\n /**\n * Iterates over every `{param}` token in `path`, calling `fn` with the raw token and transformed name.\n */\n #eachParam(fn: (raw: string, param: string) => void): void {\n for (const match of this.path.matchAll(/\\{([^}]+)\\}/g)) {\n const raw = match[1]!\n fn(raw, this.#transformParam(raw))\n }\n }\n\n toObject({ type = 'path', replacer, stringify }: ObjectOptions = {}): URLObject | string {\n const object = {\n url: type === 'path' ? this.toURLPath() : this.toTemplateString({ replacer }),\n params: this.getParams(),\n }\n\n if (stringify) {\n if (type === 'template') {\n return JSON.stringify(object).replaceAll(\"'\", '').replaceAll(`\"`, '')\n }\n\n if (object.params) {\n return `{ url: '${object.url}', params: ${JSON.stringify(object.params).replaceAll(\"'\", '').replaceAll(`\"`, '')} }`\n }\n\n return `{ url: '${object.url}' }`\n }\n\n return object\n }\n\n /**\n * Converts the OpenAPI path to a TypeScript template literal string.\n * An optional `replacer` can transform each extracted parameter name before interpolation.\n *\n * @example\n * new URLPath('/pet/{petId}').toTemplateString() // '`/pet/${petId}`'\n */\n toTemplateString({\n prefix = '',\n replacer,\n }: {\n prefix?: string\n replacer?: (pathParam: string) => string\n } = {}): string {\n const parts = this.path.split(/\\{([^}]+)\\}/)\n const result = parts\n .map((part, i) => {\n if (i % 2 === 0) return part\n const param = this.#transformParam(part)\n return `\\${${replacer ? replacer(param) : param}}`\n })\n .join('')\n\n return `\\`${prefix}${result}\\``\n }\n\n /**\n * Extracts all `{param}` segments from the path and returns them as a key-value map.\n * An optional `replacer` transforms each parameter name in both key and value positions.\n * Returns `undefined` when no path parameters are found.\n *\n * @example\n * ```ts\n * new URLPath('/pet/{petId}/tag/{tagId}').getParams()\n * // { petId: 'petId', tagId: 'tagId' }\n * ```\n */\n getParams(replacer?: (pathParam: string) => string): Record<string, string> | undefined {\n const params: Record<string, string> = {}\n\n this.#eachParam((_raw, param) => {\n const key = replacer ? replacer(param) : param\n params[key] = key\n })\n\n return Object.keys(params).length > 0 ? params : undefined\n }\n\n /** Converts the OpenAPI path to Express-style colon syntax.\n *\n * @example\n * ```ts\n * new URLPath('/pet/{petId}').toURLPath() // '/pet/:petId'\n * ```\n */\n toURLPath(): string {\n return this.path.replace(/\\{([^}]+)\\}/g, ':$1')\n }\n}\n","import type { Adapter, AdapterFactoryOptions } from './types.ts'\n\ntype AdapterBuilder<T extends AdapterFactoryOptions> = (options: T['options']) => Adapter<T>\n\n/**\n * Factory for implementing custom adapters that translate non-OpenAPI specs into Kubb's AST.\n *\n * Use this to support GraphQL schemas, gRPC definitions, AsyncAPI, or custom domain-specific languages.\n * Built-in adapters include `@kubb/adapter-oas` for OpenAPI and Swagger documents.\n *\n * @note Adapters must parse their input format to Kubb's `InputNode` structure.\n *\n * @example\n * ```ts\n * export const myAdapter = createAdapter<MyAdapter>((options) => {\n * return {\n * name: 'my-adapter',\n * options,\n * async parse(source) {\n * // Transform source format to InputNode\n * return { ... }\n * },\n * }\n * })\n *\n * // Instantiate:\n * const adapter = myAdapter({ validate: true })\n * ```\n */\nexport function createAdapter<T extends AdapterFactoryOptions = AdapterFactoryOptions>(build: AdapterBuilder<T>): (options?: T['options']) => Adapter<T> {\n return (options) => build(options ?? ({} as T['options']))\n}\n","/*\nHow it works:\n`this.#head` is an instance of `Node` which keeps track of its current value and nests another instance of `Node` that keeps the value that comes after it. When a value is provided to `.enqueue()`, the code needs to iterate through `this.#head`, going deeper and deeper to find the last value. However, iterating through every single item is slow. This problem is solved by saving a reference to the last value as `this.#tail` so that it can reference it to add a new value.\n*/\n\nclass Node {\n\tvalue;\n\tnext;\n\n\tconstructor(value) {\n\t\tthis.value = value;\n\t}\n}\n\nexport default class Queue {\n\t#head;\n\t#tail;\n\t#size;\n\n\tconstructor() {\n\t\tthis.clear();\n\t}\n\n\tenqueue(value) {\n\t\tconst node = new Node(value);\n\n\t\tif (this.#head) {\n\t\t\tthis.#tail.next = node;\n\t\t\tthis.#tail = node;\n\t\t} else {\n\t\t\tthis.#head = node;\n\t\t\tthis.#tail = node;\n\t\t}\n\n\t\tthis.#size++;\n\t}\n\n\tdequeue() {\n\t\tconst current = this.#head;\n\t\tif (!current) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.#head = this.#head.next;\n\t\tthis.#size--;\n\n\t\t// Clean up tail reference when queue becomes empty\n\t\tif (!this.#head) {\n\t\t\tthis.#tail = undefined;\n\t\t}\n\n\t\treturn current.value;\n\t}\n\n\tpeek() {\n\t\tif (!this.#head) {\n\t\t\treturn;\n\t\t}\n\n\t\treturn this.#head.value;\n\n\t\t// TODO: Node.js 18.\n\t\t// return this.#head?.value;\n\t}\n\n\tclear() {\n\t\tthis.#head = undefined;\n\t\tthis.#tail = undefined;\n\t\tthis.#size = 0;\n\t}\n\n\tget size() {\n\t\treturn this.#size;\n\t}\n\n\t* [Symbol.iterator]() {\n\t\tlet current = this.#head;\n\n\t\twhile (current) {\n\t\t\tyield current.value;\n\t\t\tcurrent = current.next;\n\t\t}\n\t}\n\n\t* drain() {\n\t\twhile (this.#head) {\n\t\t\tyield this.dequeue();\n\t\t}\n\t}\n}\n","import Queue from 'yocto-queue';\n\nexport default function pLimit(concurrency) {\n\tlet rejectOnClear = false;\n\n\tif (typeof concurrency === 'object') {\n\t\t({concurrency, rejectOnClear = false} = concurrency);\n\t}\n\n\tvalidateConcurrency(concurrency);\n\n\tif (typeof rejectOnClear !== 'boolean') {\n\t\tthrow new TypeError('Expected `rejectOnClear` to be a boolean');\n\t}\n\n\tconst queue = new Queue();\n\tlet activeCount = 0;\n\n\tconst resumeNext = () => {\n\t\t// Process the next queued function if we're under the concurrency limit\n\t\tif (activeCount < concurrency && queue.size > 0) {\n\t\t\tactiveCount++;\n\t\t\tqueue.dequeue().run();\n\t\t}\n\t};\n\n\tconst next = () => {\n\t\tactiveCount--;\n\t\tresumeNext();\n\t};\n\n\tconst run = async (function_, resolve, arguments_) => {\n\t\t// Execute the function and capture the result promise\n\t\tconst result = (async () => function_(...arguments_))();\n\n\t\t// Resolve immediately with the promise (don't wait for completion)\n\t\tresolve(result);\n\n\t\t// Wait for the function to complete (success or failure)\n\t\t// We catch errors here to prevent unhandled rejections,\n\t\t// but the original promise rejection is preserved for the caller\n\t\ttry {\n\t\t\tawait result;\n\t\t} catch {}\n\n\t\t// Decrement active count and process next queued function\n\t\tnext();\n\t};\n\n\tconst enqueue = (function_, resolve, reject, arguments_) => {\n\t\tconst queueItem = {reject};\n\n\t\t// Queue the internal resolve function instead of the run function\n\t\t// to preserve the asynchronous execution context.\n\t\tnew Promise(internalResolve => { // eslint-disable-line promise/param-names\n\t\t\tqueueItem.run = internalResolve;\n\t\t\tqueue.enqueue(queueItem);\n\t\t}).then(run.bind(undefined, function_, resolve, arguments_)); // eslint-disable-line promise/prefer-await-to-then\n\n\t\t// Start processing immediately if we haven't reached the concurrency limit\n\t\tif (activeCount < concurrency) {\n\t\t\tresumeNext();\n\t\t}\n\t};\n\n\tconst generator = (function_, ...arguments_) => new Promise((resolve, reject) => {\n\t\tenqueue(function_, resolve, reject, arguments_);\n\t});\n\n\tObject.defineProperties(generator, {\n\t\tactiveCount: {\n\t\t\tget: () => activeCount,\n\t\t},\n\t\tpendingCount: {\n\t\t\tget: () => queue.size,\n\t\t},\n\t\tclearQueue: {\n\t\t\tvalue() {\n\t\t\t\tif (!rejectOnClear) {\n\t\t\t\t\tqueue.clear();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tconst abortError = AbortSignal.abort().reason;\n\n\t\t\t\twhile (queue.size > 0) {\n\t\t\t\t\tqueue.dequeue().reject(abortError);\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t\tconcurrency: {\n\t\t\tget: () => concurrency,\n\n\t\t\tset(newConcurrency) {\n\t\t\t\tvalidateConcurrency(newConcurrency);\n\t\t\t\tconcurrency = newConcurrency;\n\n\t\t\t\tqueueMicrotask(() => {\n\t\t\t\t\t// eslint-disable-next-line no-unmodified-loop-condition\n\t\t\t\t\twhile (activeCount < concurrency && queue.size > 0) {\n\t\t\t\t\t\tresumeNext();\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t},\n\t\t},\n\t\tmap: {\n\t\t\tasync value(iterable, function_) {\n\t\t\t\tconst promises = Array.from(iterable, (value, index) => this(function_, value, index));\n\t\t\t\treturn Promise.all(promises);\n\t\t\t},\n\t\t},\n\t});\n\n\treturn generator;\n}\n\nexport function limitFunction(function_, options) {\n\tconst limit = pLimit(options);\n\n\treturn (...arguments_) => limit(() => function_(...arguments_));\n}\n\nfunction validateConcurrency(concurrency) {\n\tif (!((Number.isInteger(concurrency) || concurrency === Number.POSITIVE_INFINITY) && concurrency > 0)) {\n\t\tthrow new TypeError('Expected `concurrency` to be a number from 1 and up');\n\t}\n}\n","import type { CodeNode, FileNode } from '@kubb/ast'\nimport { extractStringsFromNodes } from '@kubb/ast'\nimport pLimit from 'p-limit'\nimport { PARALLEL_CONCURRENCY_LIMIT } from './constants.ts'\nimport type { Parser } from './defineParser.ts'\n\ntype ParseOptions = {\n parsers?: Map<FileNode['extname'], Parser>\n extension?: Record<FileNode['extname'], FileNode['extname'] | ''>\n}\n\ntype RunOptions = ParseOptions & {\n /**\n * @default 'sequential'\n */\n mode?: 'sequential' | 'parallel'\n onStart?: (files: Array<FileNode>) => Promise<void> | void\n onEnd?: (files: Array<FileNode>) => Promise<void> | void\n onUpdate?: (params: { file: FileNode; source?: string; processed: number; total: number; percentage: number }) => Promise<void> | void\n}\n\nfunction joinSources(file: FileNode): string {\n return file.sources\n .map((item) => extractStringsFromNodes(item.nodes as Array<CodeNode>))\n .filter(Boolean)\n .join('\\n\\n')\n}\n\n/**\n * Converts a single file to a string using the registered parsers.\n * Falls back to joining source values when no matching parser is found.\n *\n * @internal\n */\nexport class FileProcessor {\n readonly #limit = pLimit(PARALLEL_CONCURRENCY_LIMIT)\n\n async parse(file: FileNode, { parsers, extension }: ParseOptions = {}): Promise<string> {\n const parseExtName = extension?.[file.extname] || undefined\n\n if (!parsers || !file.extname) {\n return joinSources(file)\n }\n\n const parser = parsers.get(file.extname)\n\n if (!parser) {\n return joinSources(file)\n }\n\n return parser.parse(file, { extname: parseExtName })\n }\n\n async run(files: Array<FileNode>, { parsers, mode = 'sequential', extension, onStart, onEnd, onUpdate }: RunOptions = {}): Promise<Array<FileNode>> {\n await onStart?.(files)\n\n const total = files.length\n let processed = 0\n\n const processOne = async (file: FileNode) => {\n const source = await this.parse(file, { extension, parsers })\n const currentProcessed = ++processed\n const percentage = (currentProcessed / total) * 100\n\n await onUpdate?.({\n file,\n source,\n processed: currentProcessed,\n percentage,\n total,\n })\n }\n\n if (mode === 'sequential') {\n for (const file of files) {\n await processOne(file)\n }\n } else {\n await Promise.all(files.map((file) => this.#limit(() => processOne(file))))\n }\n\n await onEnd?.(files)\n\n return files\n }\n}\n","export type Storage = {\n /**\n * Identifier used for logging and debugging (e.g. `'fs'`, `'s3'`).\n */\n readonly name: string\n /**\n * Returns `true` when an entry for `key` exists in storage.\n */\n hasItem(key: string): Promise<boolean>\n /**\n * Returns the stored string value, or `null` when `key` does not exist.\n */\n getItem(key: string): Promise<string | null>\n /**\n * Persists `value` under `key`, creating any required structure.\n */\n setItem(key: string, value: string): Promise<void>\n /**\n * Removes the entry for `key`. No-ops when the key does not exist.\n */\n removeItem(key: string): Promise<void>\n /**\n * Returns all keys, optionally filtered to those starting with `base`.\n */\n getKeys(base?: string): Promise<Array<string>>\n /**\n * Removes all entries, optionally scoped to those starting with `base`.\n */\n clear(base?: string): Promise<void>\n /**\n * Optional teardown hook called after the build completes.\n */\n dispose?(): Promise<void>\n}\n\n/**\n * Factory for implementing custom storage backends that control where generated files are written.\n *\n * Takes a builder function `(options: TOptions) => Storage` and returns a factory `(options?: TOptions) => Storage`.\n * Kubb provides filesystem and in-memory implementations out of the box.\n *\n * @note Call the returned factory with optional options to instantiate the storage adapter.\n *\n * @example\n * ```ts\n * import { createStorage } from '@kubb/core'\n *\n * export const memoryStorage = createStorage(() => {\n * const store = new Map<string, string>()\n * return {\n * name: 'memory',\n * async hasItem(key) { return store.has(key) },\n * async getItem(key) { return store.get(key) ?? null },\n * async setItem(key, value) { store.set(key, value) },\n * async removeItem(key) { store.delete(key) },\n * async getKeys(base) {\n * const keys = [...store.keys()]\n * return base ? keys.filter((k) => k.startsWith(base)) : keys\n * },\n * async clear(base) { if (!base) store.clear() },\n * }\n * })\n *\n * // Instantiate:\n * const storage = memoryStorage()\n * ```\n */\nexport function createStorage<TOptions = Record<string, never>>(build: (options: TOptions) => Storage): (options?: TOptions) => Storage {\n return (options) => build(options ?? ({} as TOptions))\n}\n","import type { Dirent } from 'node:fs'\nimport { access, readdir, readFile, rm } from 'node:fs/promises'\nimport { join, resolve } from 'node:path'\nimport { clean, write } from '@internals/utils'\nimport { createStorage } from '../createStorage.ts'\n\n/**\n * Detects the filesystem error used to indicate that a path does not exist.\n */\nfunction isMissingPathError(error: unknown): error is NodeJS.ErrnoException {\n return typeof error === 'object' && error !== null && 'code' in error && (error as NodeJS.ErrnoException).code === 'ENOENT'\n}\n\n/**\n * Built-in filesystem storage driver.\n *\n * This is the default storage when no `storage` option is configured in the root config.\n * Keys are resolved against `process.cwd()`, so root-relative paths such as\n * `src/gen/api/getPets.ts` are written to the correct location without extra configuration.\n *\n * Internally uses the `write` utility from `@internals/utils`, which:\n * - trims leading/trailing whitespace before writing\n * - skips the write when file content is already identical (deduplication)\n * - creates missing parent directories automatically\n * - supports Bun's native file API when running under Bun\n *\n * @example\n * ```ts\n * import { fsStorage } from '@kubb/core'\n * import { defineConfig } from 'kubb'\n *\n * export default defineConfig({\n * input: { path: './petStore.yaml' },\n * output: { path: './src/gen' },\n * storage: fsStorage(),\n * })\n * ```\n */\nexport const fsStorage = createStorage(() => ({\n name: 'fs',\n async hasItem(key: string) {\n try {\n await access(resolve(key))\n return true\n } catch (error) {\n if (isMissingPathError(error)) {\n return false\n }\n\n throw new Error(`Failed to access storage item \"${key}\"`, {\n cause: error as Error,\n })\n }\n },\n async getItem(key: string) {\n try {\n return await readFile(resolve(key), 'utf8')\n } catch (error) {\n if (isMissingPathError(error)) {\n return null\n }\n\n throw new Error(`Failed to read storage item \"${key}\"`, {\n cause: error as Error,\n })\n }\n },\n async setItem(key: string, value: string) {\n await write(resolve(key), value, { sanity: false })\n },\n async removeItem(key: string) {\n await rm(resolve(key), { force: true })\n },\n async getKeys(base?: string) {\n const keys: Array<string> = []\n const resolvedBase = resolve(base ?? process.cwd())\n\n async function walk(dir: string, prefix: string): Promise<void> {\n let entries: Array<Dirent>\n try {\n entries = (await readdir(dir, {\n withFileTypes: true,\n })) as Array<Dirent>\n } catch (error) {\n if (isMissingPathError(error)) {\n return\n }\n\n throw new Error(`Failed to list storage keys under \"${resolvedBase}\"`, {\n cause: error as Error,\n })\n }\n for (const entry of entries) {\n const rel = prefix ? `${prefix}/${entry.name}` : entry.name\n if (entry.isDirectory()) {\n await walk(join(dir, entry.name), rel)\n } else {\n keys.push(rel)\n }\n }\n }\n\n await walk(resolvedBase, '')\n\n return keys\n },\n async clear(base?: string) {\n if (!base) {\n return\n }\n\n await clean(resolve(base))\n },\n}))\n","","import { version as nodeVersion } from 'node:process'\nimport { version as KubbVersion } from '../../package.json'\n\n/**\n * Returns a snapshot of the current runtime environment.\n *\n * Useful for attaching context to debug logs and error reports so that\n * issues can be reproduced without manual information gathering.\n */\nexport function getDiagnosticInfo() {\n return {\n nodeVersion,\n KubbVersion,\n platform: process.platform,\n arch: process.arch,\n cwd: process.cwd(),\n } as const\n}\n","import type { Config, InputPath, UserConfig } from '../types'\n\n/**\n * Type guard to check if a given config has an `input.path`.\n */\nexport function isInputPath(config: UserConfig | undefined): config is UserConfig<InputPath>\nexport function isInputPath(config: Config | undefined): config is Config<InputPath>\nexport function isInputPath(config: Config | UserConfig | undefined): config is Config<InputPath> | UserConfig<InputPath> {\n return typeof config?.input === 'object' && config.input !== null && 'path' in config.input\n}\n","import { resolve } from 'node:path'\nimport { AsyncEventEmitter, BuildError, exists, formatMs, getElapsedMs, URLPath } from '@internals/utils'\nimport type { FileNode, OperationNode } from '@kubb/ast'\nimport { collectUsedSchemaNames, transform, walk } from '@kubb/ast'\nimport { DEFAULT_BANNER, DEFAULT_EXTENSION, DEFAULT_STUDIO_URL } from './constants.ts'\nimport type { RendererFactory } from './createRenderer.ts'\nimport type { Generator } from './defineGenerator.ts'\nimport type { Parser } from './defineParser.ts'\nimport type { Plugin } from './definePlugin.ts'\nimport { FileProcessor } from './FileProcessor.ts'\nimport type { Kubb } from './Kubb.ts'\nimport { PluginDriver } from './PluginDriver.ts'\nimport { applyHookResult } from './renderNode.ts'\nimport { fsStorage } from './storages/fsStorage.ts'\nimport type { AdapterSource, Config, GeneratorContext, KubbHooks, Middleware, NormalizedPlugin, Storage, UserConfig } from './types.ts'\nimport { getDiagnosticInfo } from './utils/diagnostics.ts'\nimport { isInputPath } from './utils/isInputPath.ts'\n\ntype SetupOptions = {\n hooks?: AsyncEventEmitter<KubbHooks>\n}\n\n/**\n * Full output produced by a successful or failed build.\n */\nexport type BuildOutput = {\n /**\n * Plugins that threw during installation, paired with the caught error.\n */\n failedPlugins: Set<{ plugin: Plugin; error: Error }>\n files: Array<FileNode>\n driver: PluginDriver\n /**\n * Elapsed time in milliseconds for each plugin, keyed by plugin name.\n */\n pluginTimings: Map<string, number>\n error?: Error\n /**\n * Raw generated source, keyed by absolute file path.\n */\n sources: Map<string, string>\n}\n\ntype SetupResult = {\n hooks: AsyncEventEmitter<KubbHooks>\n driver: PluginDriver\n sources: Map<string, string>\n config: Config\n storage: Storage | null\n}\n\nasync function setup(userConfig: UserConfig, options: SetupOptions = {}): Promise<SetupResult> {\n const hooks = options.hooks ?? new AsyncEventEmitter<KubbHooks>()\n\n const sources: Map<string, string> = new Map<string, string>()\n const diagnosticInfo = getDiagnosticInfo()\n\n if (Array.isArray(userConfig.input)) {\n await hooks.emit('kubb:warn', { message: 'This feature is still under development — use with caution' })\n }\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [\n 'Configuration:',\n ` • Name: ${userConfig.name || 'unnamed'}`,\n ` • Root: ${userConfig.root || process.cwd()}`,\n ` • Output: ${userConfig.output?.path || 'not specified'}`,\n ` • Plugins: ${userConfig.plugins?.length || 0}`,\n 'Output Settings:',\n ` • Storage: ${userConfig.storage ? `custom(${userConfig.storage.name})` : userConfig.output?.write === false ? 'disabled' : 'filesystem (default)'}`,\n ` • Formatter: ${userConfig.output?.format || 'none'}`,\n ` • Linter: ${userConfig.output?.lint || 'none'}`,\n 'Environment:',\n Object.entries(diagnosticInfo)\n .map(([key, value]) => ` • ${key}: ${value}`)\n .join('\\n'),\n ],\n })\n\n try {\n if (isInputPath(userConfig) && !new URLPath(userConfig.input.path).isURL) {\n await exists(userConfig.input.path)\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [`✓ Input file validated: ${userConfig.input.path}`],\n })\n }\n } catch (caughtError) {\n if (isInputPath(userConfig)) {\n const error = caughtError as Error\n\n throw new Error(\n `Cannot read file/URL defined in \\`input.path\\` or set with \\`kubb generate PATH\\` in the CLI of your Kubb config ${userConfig.input.path}`,\n {\n cause: error,\n },\n )\n }\n }\n\n if (!userConfig.adapter) {\n throw new Error('Adapter should be defined')\n }\n\n const config: Config = {\n ...userConfig,\n root: userConfig.root || process.cwd(),\n parsers: userConfig.parsers ?? [],\n adapter: userConfig.adapter,\n output: {\n format: false,\n lint: false,\n write: true,\n extension: DEFAULT_EXTENSION,\n defaultBanner: DEFAULT_BANNER,\n ...userConfig.output,\n },\n devtools: userConfig.devtools\n ? {\n studioUrl: DEFAULT_STUDIO_URL,\n ...(typeof userConfig.devtools === 'boolean' ? {} : userConfig.devtools),\n }\n : undefined,\n plugins: userConfig.plugins as unknown as Config['plugins'],\n }\n\n const storage: Storage | null = config.output.write === false ? null : (config.storage ?? fsStorage())\n\n if (config.output.clean) {\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: ['Cleaning output directories', ` • Output: ${config.output.path}`],\n })\n await storage?.clear(resolve(config.root, config.output.path))\n }\n\n const driver = new PluginDriver(config, {\n hooks,\n })\n\n // Register middleware hooks after all plugin hooks are registered.\n // Because AsyncEventEmitter calls listeners in registration order,\n // middleware hooks for any event fire after all plugin hooks for that event.\n function registerMiddlewareHook<K extends keyof KubbHooks & string>(event: K, middlewareHooks: Middleware['hooks']) {\n const handler = middlewareHooks[event]\n if (handler) {\n hooks.on(event, handler)\n }\n }\n\n for (const middleware of config.middleware ?? []) {\n for (const event of Object.keys(middleware.hooks) as Array<keyof KubbHooks & string>) {\n registerMiddlewareHook(event, middleware.hooks)\n }\n }\n\n const adapter = config.adapter\n if (!adapter) {\n throw new Error('No adapter configured. Please provide an adapter in your kubb.config.ts.')\n }\n const source = inputToAdapterSource(config)\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [`Running adapter: ${adapter.name}`],\n })\n\n driver.adapter = adapter\n driver.inputNode = await adapter.parse(source)\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [\n `✓ Adapter '${adapter.name}' resolved InputNode`,\n ` • Schemas: ${driver.inputNode.schemas.length}`,\n ` • Operations: ${driver.inputNode.operations.length}`,\n ],\n })\n\n return {\n config,\n hooks,\n driver,\n sources,\n storage,\n }\n}\n\n/**\n * Walks the AST and dispatches nodes to a plugin's direct AST hooks\n * (`schema`, `operation`, `operations`).\n *\n * When `include` contains only operation-scoped filters (`tag`, `operationId`, `path`,\n * `method`, `contentType`) and no `schemaName` filter, the function pre-computes the set\n * of top-level schema names transitively reachable from the included operations and skips\n * schemas that fall outside that set. This ensures that component schemas referenced\n * exclusively by excluded operations are not generated.\n */\nasync function runPluginAstHooks(plugin: NormalizedPlugin, context: GeneratorContext): Promise<void> {\n const { adapter, inputNode, resolver, driver } = context\n const { exclude, include, override } = plugin.options\n\n if (!adapter || !inputNode) {\n throw new Error(`[${plugin.name}] No adapter found. Add an OAS adapter (e.g. pluginOas()) before this plugin in your Kubb config.`)\n }\n\n function resolveRenderer(gen: Generator): RendererFactory | undefined {\n return gen.renderer === null ? undefined : (gen.renderer ?? plugin.renderer ?? context.config.renderer)\n }\n\n const generators = plugin.generators ?? []\n const collectedOperations: Array<OperationNode> = []\n\n const generatorContext = {\n ...context,\n resolver: driver.getResolver(plugin.name),\n }\n\n // When `include` has operation-based filters (tag, operationId, path, method, contentType)\n // but no schema-level filters (schemaName), pre-compute the set of top-level schema names\n // that are transitively referenced by the included operations. Schemas outside that set are\n // skipped so that types belonging exclusively to excluded operations are not generated.\n const operationFilterTypes = new Set(['tag', 'operationId', 'path', 'method', 'contentType'])\n const hasOperationBasedIncludes = include?.some(({ type }) => operationFilterTypes.has(type)) ?? false\n const hasSchemaNameIncludes = include?.some(({ type }) => type === 'schemaName') ?? false\n\n let allowedSchemaNames: Set<string> | undefined\n if (hasOperationBasedIncludes && !hasSchemaNameIncludes) {\n const includedOps = inputNode.operations.filter((op) => resolver.resolveOptions(op, { options: plugin.options, exclude, include, override }) !== null)\n allowedSchemaNames = collectUsedSchemaNames(includedOps, inputNode.schemas)\n }\n\n await walk(inputNode, {\n depth: 'shallow',\n async schema(node) {\n const transformedNode = plugin.transformer ? transform(node, plugin.transformer) : node\n\n // Skip named top-level schemas that are not reachable from any included operation.\n if (allowedSchemaNames !== undefined && transformedNode.name && !allowedSchemaNames.has(transformedNode.name)) {\n return\n }\n\n const options = resolver.resolveOptions(transformedNode, {\n options: plugin.options,\n exclude,\n include,\n override,\n })\n if (options === null) return\n\n const ctx = { ...generatorContext, options }\n\n for (const gen of generators) {\n if (!gen.schema) continue\n const result = await gen.schema(transformedNode, ctx)\n await applyHookResult(result, driver, resolveRenderer(gen))\n }\n\n await driver.hooks.emit('kubb:generate:schema', transformedNode, ctx)\n },\n async operation(node) {\n const transformedNode = plugin.transformer ? transform(node, plugin.transformer) : node\n const options = resolver.resolveOptions(transformedNode, {\n options: plugin.options,\n exclude,\n include,\n override,\n })\n if (options !== null) {\n collectedOperations.push(transformedNode)\n\n const ctx = { ...generatorContext, options }\n\n for (const gen of generators) {\n if (!gen.operation) continue\n const result = await gen.operation(transformedNode, ctx)\n await applyHookResult(result, driver, resolveRenderer(gen))\n }\n\n await driver.hooks.emit('kubb:generate:operation', transformedNode, ctx)\n }\n },\n })\n\n if (collectedOperations.length > 0) {\n const ctx = { ...generatorContext, options: plugin.options }\n\n for (const gen of generators) {\n if (!gen.operations) continue\n const result = await gen.operations(collectedOperations, ctx)\n await applyHookResult(result, driver, resolveRenderer(gen))\n }\n\n await driver.hooks.emit('kubb:generate:operations', collectedOperations, ctx)\n }\n}\n\nasync function safeBuild(setupResult: SetupResult): Promise<BuildOutput> {\n const { driver, hooks, sources, storage } = setupResult\n\n const failedPlugins = new Set<{ plugin: Plugin; error: Error }>()\n const pluginTimings = new Map<string, number>()\n const config = driver.config\n\n try {\n await driver.emitSetupHooks()\n\n if (driver.adapter && driver.inputNode) {\n await hooks.emit('kubb:build:start', {\n config,\n adapter: driver.adapter,\n inputNode: driver.inputNode,\n getPlugin: driver.getPlugin.bind(driver),\n get files() {\n return driver.fileManager.files\n },\n upsertFile: (...files) => driver.fileManager.upsert(...files),\n })\n }\n\n for (const plugin of driver.plugins.values()) {\n const context = driver.getContext(plugin)\n const hrStart = process.hrtime()\n\n try {\n const timestamp = new Date()\n\n await hooks.emit('kubb:plugin:start', { plugin })\n\n await hooks.emit('kubb:debug', {\n date: timestamp,\n logs: ['Starting plugin...', ` • Plugin Name: ${plugin.name}`],\n })\n\n if (plugin.generators?.length || driver.hasRegisteredGenerators(plugin.name)) {\n await runPluginAstHooks(plugin, context)\n }\n\n const duration = getElapsedMs(hrStart)\n pluginTimings.set(plugin.name, duration)\n\n await hooks.emit('kubb:plugin:end', {\n plugin,\n duration,\n success: true,\n config,\n get files() {\n return driver.fileManager.files\n },\n upsertFile: (...files) => driver.fileManager.upsert(...files),\n })\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [`✓ Plugin started successfully (${formatMs(duration)})`],\n })\n } catch (caughtError) {\n const error = caughtError as Error\n const errorTimestamp = new Date()\n const duration = getElapsedMs(hrStart)\n\n await hooks.emit('kubb:plugin:end', {\n plugin,\n duration,\n success: false,\n error,\n config,\n get files() {\n return driver.fileManager.files\n },\n upsertFile: (...files) => driver.fileManager.upsert(...files),\n })\n\n await hooks.emit('kubb:debug', {\n date: errorTimestamp,\n logs: [\n '✗ Plugin start failed',\n ` • Plugin Name: ${plugin.name}`,\n ` • Error: ${error.constructor.name} - ${error.message}`,\n ' • Stack Trace:',\n error.stack || 'No stack trace available',\n ],\n })\n\n failedPlugins.add({ plugin, error })\n }\n }\n\n await hooks.emit('kubb:plugins:end', {\n config,\n get files() {\n return driver.fileManager.files\n },\n upsertFile: (...files) => driver.fileManager.upsert(...files),\n })\n\n const files = driver.fileManager.files\n\n const parsersMap = new Map<FileNode['extname'], Parser>()\n for (const parser of config.parsers) {\n if (parser.extNames) {\n for (const extname of parser.extNames) {\n parsersMap.set(extname, parser)\n }\n }\n }\n\n const fileProcessor = new FileProcessor()\n\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [`Writing ${files.length} files...`],\n })\n\n await fileProcessor.run(files, {\n parsers: parsersMap,\n extension: config.output.extension,\n onStart: async (processingFiles) => {\n await hooks.emit('kubb:files:processing:start', { files: processingFiles })\n },\n onUpdate: async ({ file, source, processed, total, percentage }) => {\n await hooks.emit('kubb:file:processing:update', {\n file,\n source,\n processed,\n total,\n percentage,\n config,\n })\n if (source) {\n await storage?.setItem(file.path, source)\n sources.set(file.path, source)\n }\n },\n onEnd: async (processedFiles) => {\n await hooks.emit('kubb:files:processing:end', { files: processedFiles })\n await hooks.emit('kubb:debug', {\n date: new Date(),\n logs: [`✓ File write process completed for ${processedFiles.length} files`],\n })\n },\n })\n\n await hooks.emit('kubb:build:end', {\n files,\n config,\n outputDir: resolve(config.root, config.output.path),\n })\n\n return {\n failedPlugins,\n files,\n driver,\n pluginTimings,\n sources,\n }\n } catch (error) {\n return {\n failedPlugins,\n files: [],\n driver,\n pluginTimings,\n error: error as Error,\n sources,\n }\n } finally {\n driver.dispose()\n }\n}\n\nasync function build(setupResult: SetupResult): Promise<BuildOutput> {\n const { files, driver, failedPlugins, pluginTimings, error, sources } = await safeBuild(setupResult)\n\n if (error) {\n throw error\n }\n\n if (failedPlugins.size > 0) {\n const errors = [...failedPlugins].map(({ error }) => error)\n\n throw new BuildError(`Build Error with ${failedPlugins.size} failed plugins`, { errors })\n }\n\n return {\n failedPlugins,\n files,\n driver,\n pluginTimings,\n error: undefined,\n sources,\n }\n}\n\nfunction inputToAdapterSource(config: Config): AdapterSource {\n if (Array.isArray(config.input)) {\n return {\n type: 'paths',\n paths: config.input.map((i) => (new URLPath(i.path).isURL ? i.path : resolve(config.root, i.path))),\n }\n }\n\n if ('data' in config.input) {\n return { type: 'data', data: config.input.data }\n }\n\n if (new URLPath(config.input.path).isURL) {\n return { type: 'path', path: config.input.path }\n }\n\n const resolved = resolve(config.root, config.input.path)\n return { type: 'path', path: resolved }\n}\n\ntype CreateKubbOptions = {\n hooks?: AsyncEventEmitter<KubbHooks>\n}\n\n/**\n * Creates a Kubb instance bound to a single config entry.\n *\n * Accepts a user-facing config shape and resolves it to a full {@link Config} during\n * `setup()`. The instance then holds shared state (`hooks`, `sources`, `driver`, `config`)\n * across the `setup → build` lifecycle. Attach event listeners to `kubb.hooks` before\n * calling `setup()` or `build()`.\n *\n * @example\n * ```ts\n * const kubb = createKubb(userConfig)\n *\n * kubb.hooks.on('kubb:plugin:end', ({ plugin, duration }) => {\n * console.log(`${plugin.name} completed in ${duration}ms`)\n * })\n *\n * const { files, failedPlugins } = await kubb.safeBuild()\n * ```\n */\nexport function createKubb(userConfig: UserConfig, options: CreateKubbOptions = {}): Kubb {\n const hooks = options.hooks ?? new AsyncEventEmitter<KubbHooks>()\n let setupResult: SetupResult | undefined\n\n const instance: Kubb = {\n get hooks() {\n return hooks\n },\n get sources() {\n return setupResult?.sources ?? new Map()\n },\n get driver() {\n return setupResult?.driver\n },\n get config() {\n return setupResult?.config\n },\n async setup() {\n setupResult = await setup(userConfig, { hooks })\n },\n async build() {\n if (!setupResult) {\n await instance.setup()\n }\n return build(setupResult!)\n },\n async safeBuild() {\n if (!setupResult) {\n await instance.setup()\n }\n return safeBuild(setupResult!)\n },\n }\n\n return instance\n}\n","import type { FileNode } from '@kubb/ast'\n\n/**\n * Minimal interface any Kubb renderer must satisfy.\n *\n * The generic `TElement` is the type of the element the renderer accepts —\n * e.g. `KubbReactElement` for `@kubb/renderer-jsx`, or a custom type for\n * your own renderer. Defaults to `unknown` so that generators which do not\n * care about the element type continue to work without specifying it.\n *\n * This allows core to drive rendering without a hard dependency on\n * `@kubb/renderer-jsx` or any specific renderer implementation.\n */\nexport type Renderer<TElement = unknown> = {\n render(element: TElement): Promise<void>\n unmount(error?: Error | number | null): void\n readonly files: Array<FileNode>\n}\n\n/**\n * A factory function that produces a fresh {@link Renderer} per render.\n *\n * Generators use this to declare which renderer handles their output.\n */\nexport type RendererFactory<TElement = unknown> = () => Renderer<TElement>\n\n/**\n * Creates a renderer factory for use in generator definitions.\n *\n * Wrap your renderer factory function with this helper to register it as the\n * renderer for a generator. Core will call this factory once per render cycle\n * to obtain a fresh renderer instance.\n *\n * @example\n * ```ts\n * // packages/renderer-jsx/src/index.ts\n * export const jsxRenderer = createRenderer(() => {\n * const runtime = new Runtime()\n * return {\n * async render(element) { await runtime.render(element) },\n * get files() { return runtime.nodes },\n * unmount(error) { runtime.unmount(error) },\n * }\n * })\n *\n * // packages/plugin-zod/src/generators/zodGenerator.tsx\n * import { jsxRenderer } from '@kubb/renderer-jsx'\n * export const zodGenerator = defineGenerator<PluginZod>({\n * name: 'zod',\n * renderer: jsxRenderer,\n * schema(node, options) { return <File ...>...</File> },\n * })\n * ```\n */\nexport function createRenderer<TElement = unknown>(factory: RendererFactory<TElement>): RendererFactory<TElement> {\n return factory\n}\n","import type { PossiblePromise } from '@internals/utils'\nimport type { FileNode, OperationNode, SchemaNode } from '@kubb/ast'\nimport type { RendererFactory } from './createRenderer.ts'\nimport type { GeneratorContext, PluginFactoryOptions } from './types.ts'\n\nexport type { GeneratorContext } from './types.ts'\n\n/**\n * Declares a named generator unit that walks the AST and emits files.\n *\n * Each method (`schema`, `operation`, `operations`) is called for the matching node type.\n * Each method returns `TElement | Array<FileNode> | void`. JSX-based generators require a `renderer` factory.\n * Return `Array<FileNode>` directly or call `ctx.upsertFile()` manually and return `void` to bypass rendering.\n *\n * @note Generators are consumed by plugins and registered via `ctx.addGenerator()` in `kubb:plugin:setup`.\n *\n * @example\n * ```ts\n * import { defineGenerator } from '@kubb/core'\n * import { jsxRenderer } from '@kubb/renderer-jsx'\n *\n * export const typeGenerator = defineGenerator({\n * name: 'typescript',\n * renderer: jsxRenderer,\n * schema(node, ctx) {\n * const { adapter, resolver, root, options } = ctx\n * return <File ...><Type node={node} resolver={resolver} /></File>\n * },\n * })\n * ```\n */\nexport type Generator<TOptions extends PluginFactoryOptions = PluginFactoryOptions, TElement = unknown> = {\n /**\n * Used in diagnostic messages and debug output.\n */\n name: string\n /**\n * Optional renderer factory that produces a {@link Renderer} for each render cycle.\n *\n * Generators that return renderer elements (e.g. JSX via `@kubb/renderer-jsx`) must set this\n * to the matching renderer factory (e.g. `jsxRenderer` from `@kubb/renderer-jsx`).\n *\n * Generators that only return `Array<FileNode>` or `void` do not need to set this.\n *\n * Set `renderer: null` to explicitly opt out of rendering even when the parent plugin\n * declares a `renderer` (overrides the plugin-level fallback).\n *\n * @example\n * ```ts\n * import { jsxRenderer } from '@kubb/renderer-jsx'\n * export const myGenerator = defineGenerator<PluginTs>({\n * renderer: jsxRenderer,\n * schema(node, ctx) { return <File ...>...</File> },\n * })\n * ```\n */\n renderer?: RendererFactory<TElement> | null\n /**\n * Called for each schema node in the AST walk.\n * `ctx` carries the plugin context with `adapter` and `inputNode` guaranteed present,\n * plus `ctx.options` with the per-node resolved options (after exclude/include/override).\n */\n schema?: (node: SchemaNode, ctx: GeneratorContext<TOptions>) => PossiblePromise<TElement | Array<FileNode> | void>\n /**\n * Called for each operation node in the AST walk.\n * `ctx` carries the plugin context with `adapter` and `inputNode` guaranteed present,\n * plus `ctx.options` with the per-node resolved options (after exclude/include/override).\n */\n operation?: (node: OperationNode, ctx: GeneratorContext<TOptions>) => PossiblePromise<TElement | Array<FileNode> | void>\n /**\n * Called once after all operations have been walked.\n * `ctx` carries the plugin context with `adapter` and `inputNode` guaranteed present,\n * plus `ctx.options` with the plugin-level options for the batch call.\n */\n operations?: (nodes: Array<OperationNode>, ctx: GeneratorContext<TOptions>) => PossiblePromise<TElement | Array<FileNode> | void>\n}\n\n/**\n * Defines a generator. Returns the object as-is with correct `this` typings.\n * `applyHookResult` handles renderer elements and `File[]` uniformly using\n * the generator's declared `renderer` factory.\n */\nexport function defineGenerator<TOptions extends PluginFactoryOptions = PluginFactoryOptions, TElement = unknown>(\n generator: Generator<TOptions, TElement>,\n): Generator<TOptions, TElement> {\n return generator\n}\n","import type { Logger, LoggerOptions, UserLogger } from './types.ts'\n\n/**\n * Wraps a logger definition into a typed {@link Logger}.\n *\n * @example\n * ```ts\n * export const myLogger = defineLogger({\n * name: 'my-logger',\n * install(context, options) {\n * context.on('kubb:info', (message) => console.log('ℹ', message))\n * context.on('kubb:error', (error) => console.error('✗', error.message))\n * },\n * })\n * ```\n */\nexport function defineLogger<Options extends LoggerOptions = LoggerOptions>(logger: UserLogger<Options>): Logger<Options> {\n return logger\n}\n","import type { KubbHooks } from './Kubb.ts'\n\n/**\n * A middleware instance produced by calling a factory created with `defineMiddleware`.\n * It declares event handlers under a `hooks` object which are registered on the\n * shared emitter after all plugin hooks, so middleware handlers for any event\n * always fire last.\n */\nexport type Middleware = {\n /**\n * Unique identifier for this middleware.\n */\n name: string\n /**\n * Lifecycle event handlers for this middleware.\n * Any event from the global `KubbHooks` map can be subscribed to here.\n * Handlers are registered after all plugin handlers, so they always fire last.\n */\n hooks: {\n [K in keyof KubbHooks]?: (...args: KubbHooks[K]) => void | Promise<void>\n }\n}\n\n/**\n * Creates a middleware factory using the hook-style `hooks` API.\n *\n * Middleware handlers fire after all plugin handlers for any given event, making them ideal for post-processing, logging, and auditing.\n * Per-build state (such as accumulators) belongs inside the factory closure so each `createKubb` invocation gets its own isolated instance.\n *\n * @note The factory can accept typed options. See examples for using options and per-build state patterns.\n *\n * @example\n * ```ts\n * import { defineMiddleware } from '@kubb/core'\n *\n * // Stateless middleware\n * export const logMiddleware = defineMiddleware(() => ({\n * name: 'log-middleware',\n * hooks: {\n * 'kubb:build:end'({ files }) {\n * console.log(`Build complete with ${files.length} files`)\n * },\n * },\n * }))\n *\n * // Middleware with options and per-build state\n * export const prefixMiddleware = defineMiddleware((options: { prefix: string } = { prefix: '' }) => {\n * const seen = new Set<string>()\n * return {\n * name: 'prefix-middleware',\n * hooks: {\n * 'kubb:plugin:end'({ plugin }) {\n * seen.add(`${options.prefix}${plugin.name}`)\n * },\n * },\n * }\n * })\n * ```\n */\nexport function defineMiddleware<TOptions extends object = object>(factory: (options: TOptions) => Middleware): (options?: TOptions) => Middleware {\n return (options) => factory(options ?? ({} as TOptions))\n}\n","import type { FileNode } from '@kubb/ast'\n\ntype PrintOptions = {\n extname?: FileNode['extname']\n}\n\nexport type Parser<TMeta extends object = any> = {\n name: string\n /**\n * File extensions this parser handles.\n * Use `undefined` to create a catch-all fallback parser.\n *\n * @example Handled extensions\n * `['.ts', '.js']`\n */\n extNames: Array<FileNode['extname']> | undefined\n /**\n * Convert a resolved file to a string.\n */\n parse(file: FileNode<TMeta>, options?: PrintOptions): Promise<string> | string\n}\n\n/**\n * Defines a parser with type safety. Creates parsers that transform generated files to strings based on their extension.\n *\n * @note Call the returned factory with optional options to instantiate the parser.\n *\n * @example\n * ```ts\n * import { defineParser } from '@kubb/core'\n *\n * export const jsonParser = defineParser({\n * name: 'json',\n * extNames: ['.json'],\n * parse(file) {\n * const { extractStringsFromNodes } = await import('@kubb/ast')\n * return file.sources.map((s) => extractStringsFromNodes(s.nodes ?? [])).join('\\n')\n * },\n * })\n * ```\n */\nexport function defineParser<TMeta extends object = any>(parser: Parser<TMeta>): Parser<TMeta> {\n return parser\n}\n","import type { KubbHooks } from './Kubb.ts'\nimport type { KubbPluginSetupContext, PluginFactoryOptions } from './types.ts'\n\n/**\n * A plugin object produced by `definePlugin`.\n * Instead of flat lifecycle methods, it groups all handlers under a `hooks:` property\n * (matching Astro's integration naming convention).\n *\n * @template TFactory - The plugin's `PluginFactoryOptions` type.\n */\nexport type Plugin<TFactory extends PluginFactoryOptions = PluginFactoryOptions> = {\n /**\n * Unique name for the plugin, following the same naming convention as `createPlugin`.\n */\n name: string\n /**\n * Plugins that must be registered before this plugin executes.\n * An error is thrown at startup when any listed dependency is missing.\n */\n dependencies?: Array<string>\n /**\n * Controls the execution order of this plugin relative to others.\n *\n * - `'pre'` — runs before all normal plugins.\n * - `'post'` — runs after all normal plugins.\n * - `undefined` (default) — runs in declaration order among normal plugins.\n *\n * Dependency constraints always take precedence over `enforce`.\n */\n enforce?: 'pre' | 'post'\n /**\n * The options passed by the user when calling the plugin factory.\n */\n options?: TFactory['options']\n /**\n * Lifecycle event handlers for this plugin.\n * Any event from the global `KubbHooks` map can be subscribed to here.\n */\n hooks: {\n [K in Exclude<keyof KubbHooks, 'kubb:plugin:setup'>]?: (...args: KubbHooks[K]) => void | Promise<void>\n } & {\n 'kubb:plugin:setup'?(ctx: KubbPluginSetupContext<TFactory>): void | Promise<void>\n }\n}\n\n/**\n * Returns `true` when `plugin` is a hook-style plugin created with `definePlugin`.\n *\n * Used by `PluginDriver` to distinguish hook-style plugins from legacy `createPlugin` plugins\n * so it can normalize them and register their handlers on the `AsyncEventEmitter`.\n */\nexport function isPlugin(plugin: unknown): plugin is Plugin {\n return typeof plugin === 'object' && plugin !== null && 'hooks' in plugin\n}\n\n/**\n * Wraps a factory function and returns a typed `Plugin` with lifecycle handlers grouped under `hooks`.\n *\n * Handlers live in a single `hooks` object (inspired by Astro integrations).\n * All lifecycle events from `KubbHooks` are available for subscription.\n *\n * @note For real plugins, use a `PluginFactoryOptions` type parameter to get type-safe context in `kubb:plugin:setup`.\n * Plugin names should follow the convention `plugin-<feature>` (e.g., `plugin-react-query`, `plugin-zod`).\n *\n * @example\n * ```ts\n * import { definePlugin } from '@kubb/core'\n *\n * export const pluginTs = definePlugin((options: { prefix?: string } = {}) => ({\n * name: 'plugin-ts',\n * hooks: {\n * 'kubb:plugin:setup'(ctx) {\n * ctx.setResolver(resolverTs)\n * },\n * },\n * }))\n * ```\n */\nexport function definePlugin<TFactory extends PluginFactoryOptions = PluginFactoryOptions>(\n factory: (options: TFactory['options']) => Plugin<TFactory>,\n): (options?: TFactory['options']) => Plugin<TFactory> {\n return (options) => factory(options ?? ({} as TFactory['options']))\n}\n","import { createStorage } from '../createStorage.ts'\n\n/**\n * In-memory storage driver. Useful for testing and dry-run scenarios where\n * generated output should be captured without touching the filesystem.\n *\n * All data lives in a `Map` scoped to the storage instance and is discarded\n * when the instance is garbage-collected.\n *\n * @example\n * ```ts\n * import { memoryStorage } from '@kubb/core'\n * import { defineConfig } from 'kubb'\n *\n * export default defineConfig({\n * input: { path: './petStore.yaml' },\n * output: { path: './src/gen' },\n * storage: memoryStorage(),\n * })\n * ```\n */\nexport const memoryStorage = createStorage(() => {\n const store = new Map<string, string>()\n\n return {\n name: 'memory',\n async hasItem(key: string) {\n return store.has(key)\n },\n async getItem(key: string) {\n return store.get(key) ?? null\n },\n async setItem(key: string, value: string) {\n store.set(key, value)\n },\n async removeItem(key: string) {\n store.delete(key)\n },\n async getKeys(base?: string) {\n const keys = [...store.keys()]\n return base ? keys.filter((k) => k.startsWith(base)) : keys\n },\n async clear(base?: string) {\n if (!base) {\n store.clear()\n return\n }\n for (const key of store.keys()) {\n if (key.startsWith(base)) {\n store.delete(key)\n }\n }\n },\n }\n})\n"],"x_google_ignoreList":[7,8],"mappings":"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"}
package/dist/mocks.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  import { t as __name } from "./chunk--u3MIqq1.js";
2
- import { R as NormalizedPlugin, V as PluginFactoryOptions, a as Config, n as AdapterFactoryOptions, ot as PluginDriver, t as Adapter, ut as Generator } from "./types-CuNocrbJ.js";
2
+ import { R as NormalizedPlugin, V as PluginFactoryOptions, a as Config, n as AdapterFactoryOptions, ot as PluginDriver, t as Adapter, ut as Generator } from "./types-CC09VtBt.js";
3
3
  import { OperationNode, SchemaNode, Visitor } from "@kubb/ast";
4
4
 
5
5
  //#region src/mocks.d.ts
@@ -798,7 +798,7 @@ declare global {
798
798
  * namespace Kubb {
799
799
  * interface ConfigOptionsRegistry {
800
800
  * output: {
801
- * barrelType?: import('./types.ts').BarrelType | false
801
+ * barrel?: import('./types.ts').BarrelConfig | false
802
802
  * }
803
803
  * }
804
804
  * }
@@ -818,7 +818,7 @@ declare global {
818
818
  * namespace Kubb {
819
819
  * interface PluginOptionsRegistry {
820
820
  * output: {
821
- * barrelType?: import('./types.ts').BarrelType | false
821
+ * barrel?: import('./types.ts').PluginBarrelConfig | false
822
822
  * }
823
823
  * }
824
824
  * }
@@ -2145,4 +2145,4 @@ type CLIOptions = {
2145
2145
  type PossibleConfig<TCliOptions = undefined> = PossiblePromise<Config | Config[]> | ((...args: [TCliOptions] extends [undefined] ? [] : [TCliOptions]) => PossiblePromise<Config | Config[]>);
2146
2146
  //#endregion
2147
2147
  export { defineParser as $, KubbPluginStartContext as A, Override as B, KubbGenerationSummaryContext as C, KubbLifecycleStartContext as D, KubbInfoContext as E, Logger as F, ResolveOptionsContext as G, PossibleConfig as H, LoggerContext as I, ResolverFileParams as J, Resolver as K, LoggerOptions as L, KubbSuccessContext as M, KubbVersionNewContext as N, KubbPluginEndContext as O, KubbWarnContext as P, Parser as Q, NormalizedPlugin as R, KubbGenerationStartContext as S, KubbHookStartContext as T, ResolveBannerContext as U, PluginFactoryOptions as V, ResolveNameParams as W, UserConfig as X, ResolverPathParams as Y, UserLogger as Z, KubbErrorContext as _, logLevel as _t, Config as a, createKubb as at, KubbFilesProcessingStartContext as b, GeneratorContext as c, Plugin as ct, InputData as d, defineGenerator as dt, Middleware as et, InputPath as f, Storage as ft, KubbDebugContext as g, createRenderer as gt, KubbConfigEndContext as h, RendererFactory as ht, CLIOptions as i, BuildOutput as it, KubbPluginsEndContext as j, KubbPluginSetupContext as k, Group as l, definePlugin as lt, KubbBuildStartContext as m, Renderer as mt, AdapterFactoryOptions as n, Kubb$1 as nt, DevtoolsOptions as o, PluginDriver as ot, KubbBuildEndContext as p, createStorage as pt, ResolverContext as q, AdapterSource as r, KubbHooks as rt, Exclude$1 as s, FileManager as st, Adapter as t, defineMiddleware as tt, Include as u, Generator as ut, KubbFileProcessingUpdateContext as v, AsyncEventEmitter as vt, KubbHookEndContext as w, KubbGenerationEndContext as x, KubbFilesProcessingEndContext as y, Output as z };
2148
- //# sourceMappingURL=types-CuNocrbJ.d.ts.map
2148
+ //# sourceMappingURL=types-CC09VtBt.d.ts.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kubb/core",
3
- "version": "5.0.0-beta.1",
3
+ "version": "5.0.0-beta.2",
4
4
  "description": "Core functionality for Kubb's plugin-based code generation system, providing the foundation for transforming OpenAPI specifications.",
5
5
  "keywords": [
6
6
  "ast",
@@ -65,15 +65,15 @@
65
65
  "dependencies": {
66
66
  "fflate": "^0.8.2",
67
67
  "tinyexec": "^1.1.2",
68
- "@kubb/ast": "5.0.0-beta.1"
68
+ "@kubb/ast": "5.0.0-beta.2"
69
69
  },
70
70
  "devDependencies": {
71
71
  "p-limit": "^7.3.0",
72
72
  "@internals/utils": "0.0.0",
73
- "@kubb/renderer-jsx": "5.0.0-beta.1"
73
+ "@kubb/renderer-jsx": "5.0.0-beta.2"
74
74
  },
75
75
  "peerDependencies": {
76
- "@kubb/renderer-jsx": "5.0.0-beta.1"
76
+ "@kubb/renderer-jsx": "5.0.0-beta.2"
77
77
  },
78
78
  "size-limit": [
79
79
  {
package/src/Kubb.ts CHANGED
@@ -267,7 +267,7 @@ declare global {
267
267
  * namespace Kubb {
268
268
  * interface ConfigOptionsRegistry {
269
269
  * output: {
270
- * barrelType?: import('./types.ts').BarrelType | false
270
+ * barrel?: import('./types.ts').BarrelConfig | false
271
271
  * }
272
272
  * }
273
273
  * }
@@ -288,7 +288,7 @@ declare global {
288
288
  * namespace Kubb {
289
289
  * interface PluginOptionsRegistry {
290
290
  * output: {
291
- * barrelType?: import('./types.ts').BarrelType | false
291
+ * barrel?: import('./types.ts').PluginBarrelConfig | false
292
292
  * }
293
293
  * }
294
294
  * }
package/src/createKubb.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  import { resolve } from 'node:path'
2
2
  import { AsyncEventEmitter, BuildError, exists, formatMs, getElapsedMs, URLPath } from '@internals/utils'
3
3
  import type { FileNode, OperationNode } from '@kubb/ast'
4
- import { transform, walk } from '@kubb/ast'
4
+ import { collectUsedSchemaNames, transform, walk } from '@kubb/ast'
5
5
  import { DEFAULT_BANNER, DEFAULT_EXTENSION, DEFAULT_STUDIO_URL } from './constants.ts'
6
6
  import type { RendererFactory } from './createRenderer.ts'
7
7
  import type { Generator } from './defineGenerator.ts'
@@ -191,6 +191,12 @@ async function setup(userConfig: UserConfig, options: SetupOptions = {}): Promis
191
191
  /**
192
192
  * Walks the AST and dispatches nodes to a plugin's direct AST hooks
193
193
  * (`schema`, `operation`, `operations`).
194
+ *
195
+ * When `include` contains only operation-scoped filters (`tag`, `operationId`, `path`,
196
+ * `method`, `contentType`) and no `schemaName` filter, the function pre-computes the set
197
+ * of top-level schema names transitively reachable from the included operations and skips
198
+ * schemas that fall outside that set. This ensures that component schemas referenced
199
+ * exclusively by excluded operations are not generated.
194
200
  */
195
201
  async function runPluginAstHooks(plugin: NormalizedPlugin, context: GeneratorContext): Promise<void> {
196
202
  const { adapter, inputNode, resolver, driver } = context
@@ -212,10 +218,30 @@ async function runPluginAstHooks(plugin: NormalizedPlugin, context: GeneratorCon
212
218
  resolver: driver.getResolver(plugin.name),
213
219
  }
214
220
 
221
+ // When `include` has operation-based filters (tag, operationId, path, method, contentType)
222
+ // but no schema-level filters (schemaName), pre-compute the set of top-level schema names
223
+ // that are transitively referenced by the included operations. Schemas outside that set are
224
+ // skipped so that types belonging exclusively to excluded operations are not generated.
225
+ const operationFilterTypes = new Set(['tag', 'operationId', 'path', 'method', 'contentType'])
226
+ const hasOperationBasedIncludes = include?.some(({ type }) => operationFilterTypes.has(type)) ?? false
227
+ const hasSchemaNameIncludes = include?.some(({ type }) => type === 'schemaName') ?? false
228
+
229
+ let allowedSchemaNames: Set<string> | undefined
230
+ if (hasOperationBasedIncludes && !hasSchemaNameIncludes) {
231
+ const includedOps = inputNode.operations.filter((op) => resolver.resolveOptions(op, { options: plugin.options, exclude, include, override }) !== null)
232
+ allowedSchemaNames = collectUsedSchemaNames(includedOps, inputNode.schemas)
233
+ }
234
+
215
235
  await walk(inputNode, {
216
236
  depth: 'shallow',
217
237
  async schema(node) {
218
238
  const transformedNode = plugin.transformer ? transform(node, plugin.transformer) : node
239
+
240
+ // Skip named top-level schemas that are not reachable from any included operation.
241
+ if (allowedSchemaNames !== undefined && transformedNode.name && !allowedSchemaNames.has(transformedNode.name)) {
242
+ return
243
+ }
244
+
219
245
  const options = resolver.resolveOptions(transformedNode, {
220
246
  options: plugin.options,
221
247
  exclude,