@kubb/core 5.0.0-beta.20 → 5.0.0-beta.22

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["#emitter","NodeEventEmitter","#emitAll","DEFAULT_EXTENSION","DEFAULT_BANNER","DEFAULT_STUDIO_URL","KubbDriver","URLPath","applyHookResult","isPromise","forBatches","withDrain"],"sources":["../../../internals/utils/src/errors.ts","../../../internals/utils/src/asyncEventEmitter.ts","../../../internals/utils/src/time.ts","../../../internals/utils/src/fs.ts","../src/createAdapter.ts","../package.json","../src/createStorage.ts","../src/FileProcessor.ts","../src/storages/fsStorage.ts","../src/createKubb.ts","../src/createRenderer.ts","../src/defineGenerator.ts","../src/defineLogger.ts","../src/defineMiddleware.ts","../src/defineParser.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  emit<TEventName extends keyof TEvents & string>(eventName: TEventName, ...eventArgs: TEvents[TEventName]): Promise<void> | void {\n    const listeners = this.#emitter.listeners(eventName) as Array<AsyncListener<TEvents[TEventName]>>\n\n    if (listeners.length === 0) {\n      return\n    }\n\n    return this.#emitAll(eventName, listeners, eventArgs)\n  }\n\n  async #emitAll<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    listeners: Array<AsyncListener<TEvents[TEventName]>>,\n    eventArgs: TEvents[TEventName],\n  ): Promise<void> {\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","import type { PossiblePromise } from '@internals/utils'\nimport type { ImportNode, InputNode, InputStreamNode, SchemaNode } from '@kubb/ast'\n\n/**\n * Source data passed to an adapter's `parse` function.\n * Mirrors the config input shape with paths resolved to absolute.\n */\nexport type AdapterSource = { type: 'path'; path: string } | { type: 'data'; data: string | unknown } | { type: 'paths'; paths: Array<string> }\n\n/**\n * Generic type parameters for an adapter definition.\n *\n * - `TName` — unique identifier (e.g. `'oas'`, `'asyncapi'`)\n * - `TOptions` — user-facing options passed to the adapter factory\n * - `TResolvedOptions` — options after defaults applied\n * - `TDocument` — type of the parsed source document\n */\nexport type AdapterFactoryOptions<\n  TName extends string = string,\n  TOptions extends object = object,\n  TResolvedOptions extends object = TOptions,\n  TDocument = unknown,\n> = {\n  name: TName\n  options: TOptions\n  resolvedOptions: TResolvedOptions\n  document: TDocument\n}\n\n/**\n * Adapter that converts input files or data into an `InputNode`.\n *\n * Adapters parse different schema formats (OpenAPI, AsyncAPI, Drizzle, etc.) into Kubb's\n * universal intermediate representation that all plugins consume.\n *\n * @example\n * ```ts\n * import { adapterOas } from '@kubb/adapter-oas'\n *\n * export default defineConfig({\n *   adapter: adapterOas(),\n *   input: { path: './openapi.yaml' },\n *   plugins: [pluginTs(), pluginZod()],\n * })\n * ```\n */\nexport type Adapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptions> = {\n  /**\n   * Human-readable adapter identifier (e.g. `'oas'`, `'asyncapi'`).\n   */\n  name: TOptions['name']\n  /**\n   * Resolved adapter options after defaults have been applied.\n   */\n  options: TOptions['resolvedOptions']\n  /**\n   * Parsed source document after the first `parse()` call. `null` before parsing.\n   */\n  document: TOptions['document'] | null\n  /**\n   * Parse the source into a universal `InputNode`.\n   */\n  parse: (source: AdapterSource) => PossiblePromise<InputNode>\n  /**\n   * Extract `ImportNode` entries for a schema tree.\n   * Returns an empty array before the first `parse()` call.\n   *\n   * The `resolve` callback receives the collision-corrected schema name and must\n   * return `{ name, path }` for the import, or `undefined` to skip it.\n   */\n  getImports: (node: SchemaNode, resolve: (schemaName: string) => { name: string; path: string }) => Array<ImportNode>\n  /**\n   * Validate the document at the given path or URL.\n   */\n  validate: (input: string, options?: { throwOnError?: boolean }) => Promise<void>\n  /**\n   * Memory-efficient streaming variant of `parse()`.\n   *\n   * Returns an `InputStreamNode` whose `schemas` and `operations` are `AsyncIterable`.\n   * Each `for await` loop creates a fresh parse pass over the cached in-memory document —\n   * no pre-built arrays are held in memory.\n   */\n  stream?: (source: AdapterSource) => Promise<InputStreamNode>\n}\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","","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 { CodeNode, FileNode } from '@kubb/ast'\nimport { extractStringsFromNodes } from '@kubb/ast'\nimport { AsyncEventEmitter } from '@internals/utils'\nimport type { Parser } from './defineParser.ts'\n\ntype ParseOptions = {\n  parsers?: Map<FileNode['extname'], Parser>\n  extension?: Record<FileNode['extname'], FileNode['extname'] | ''>\n}\n\nexport type FileProcessorEvents = {\n  start: [files: Array<FileNode>]\n  update: [params: { file: FileNode; source?: string; processed: number; total: number; percentage: number }]\n  end: [files: Array<FileNode>]\n}\n\nexport type ParsedFile = {\n  file: FileNode\n  source: string\n  processed: number\n  total: number\n  percentage: number\n}\n\nfunction joinSources(file: FileNode): string {\n  const sources = file.sources\n  if (sources.length === 0) return ''\n  const parts: string[] = []\n  for (const source of sources) {\n    const s = extractStringsFromNodes(source.nodes as Array<CodeNode>)\n    if (s) parts.push(s)\n  }\n  return parts.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 events = new AsyncEventEmitter<FileProcessorEvents>()\n\n  parse(file: FileNode, { parsers, extension }: ParseOptions = {}): 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  *stream(files: ReadonlyArray<FileNode>, options: ParseOptions = {}): Generator<ParsedFile> {\n    const total = files.length\n    if (total === 0) return\n\n    let processed = 0\n    for (const file of files) {\n      const source = this.parse(file, options)\n      processed++\n\n      yield { file, source, processed, total, percentage: (processed / total) * 100 }\n    }\n  }\n\n  async run(files: Array<FileNode>, options: ParseOptions = {}): Promise<Array<FileNode>> {\n    await this.events.emit('start', files)\n\n    for (const { file, source, processed, total, percentage } of this.stream(files, options)) {\n      await this.events.emit('update', { file, source, processed, percentage, total })\n    }\n\n    await this.events.emit('end', files)\n\n    return files\n  }\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 * 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      return false\n    }\n  },\n  async getItem(key: string) {\n    try {\n      return await readFile(resolve(key), 'utf8')\n    } catch (_error) {\n      return null\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 resolvedBase = resolve(base ?? process.cwd())\n\n    async function* walk(dir: string, prefix: string): AsyncGenerator<string, void, undefined> {\n      let entries: Array<Dirent>\n      try {\n        entries = (await readdir(dir, {\n          withFileTypes: true,\n        })) as Array<Dirent>\n      } catch (_error) {\n        return\n      }\n      for (const entry of entries) {\n        const rel = prefix ? `${prefix}/${entry.name}` : entry.name\n        if (entry.isDirectory()) {\n          yield* walk(join(dir, entry.name), rel)\n        } else {\n          yield rel\n        }\n      }\n    }\n\n    const keys: Array<string> = []\n    for await (const key of walk(resolvedBase, '')) {\n      keys.push(key)\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 { resolve } from 'node:path'\nimport { version as nodeVersion } from 'node:process'\nimport type { PossiblePromise } from '@internals/utils'\nimport { AsyncEventEmitter, BuildError, exists, forBatches, formatMs, getElapsedMs, URLPath, isPromise, withDrain } from '@internals/utils'\nimport type { FileNode, InputMeta, OperationNode, SchemaNode } from '@kubb/ast'\nimport { collectUsedSchemaNames, transform } from '@kubb/ast'\nimport { version as KubbVersion } from '../package.json'\nimport { DEFAULT_BANNER, DEFAULT_EXTENSION, DEFAULT_STUDIO_URL, SCHEMA_PARALLEL, STREAM_FLUSH_EVERY } from './constants.ts'\nimport type { Adapter } from './createAdapter.ts'\nimport type { RendererFactory } from './createRenderer.ts'\nimport { createStorage, type Storage } from './createStorage.ts'\nimport type { GeneratorContext, Generator } from './defineGenerator.ts'\nimport type { Middleware } from './defineMiddleware.ts'\nimport type { Parser } from './defineParser.ts'\nimport type { KubbPluginEndContext, KubbPluginSetupContext, KubbPluginStartContext, NormalizedPlugin, Plugin } from './definePlugin.ts'\nimport { FileProcessor } from './FileProcessor.ts'\n\nimport { applyHookResult, KubbDriver } from './KubbDriver.ts'\nimport { fsStorage } from './storages/fsStorage.ts'\n\n/**\n * Safely extracts a type from a registry, returning `{}` if the key doesn't exist.\n * Enables optional interface augmentation for `Kubb.ConfigOptionsRegistry` and `Kubb.PluginOptionsRegistry`\n * without requiring changes to core.\n *\n * @internal\n */\ntype ExtractRegistryKey<T, K extends PropertyKey> = K extends keyof T ? T[K] : {}\n\n/**\n * Reference to an input file to generate code from.\n *\n * Specify an absolute path or a path relative to the config file location.\n * The adapter will parse this file (e.g., OpenAPI YAML or JSON) into the universal AST.\n */\nexport type InputPath = {\n  /**\n   * Path to your Swagger/OpenAPI file, absolute or relative to the config file location.\n   *\n   * @example\n   * ```ts\n   * { path: './petstore.yaml' }\n   * { path: '/absolute/path/to/openapi.json' }\n   * ```\n   */\n  path: string\n}\n\n/**\n * Inline input data to generate code from.\n *\n * Useful when you want to pass the specification directly instead of from a file.\n * Can be a string (YAML/JSON) or a parsed object.\n */\nexport type InputData = {\n  /**\n   * Swagger/OpenAPI data as a string (YAML/JSON) or a parsed object.\n   *\n   * @example\n   * ```ts\n   * { data: fs.readFileSync('./openapi.yaml', 'utf8') }\n   * { data: { openapi: '3.1.0', info: { ... } } }\n   * ```\n   */\n  data: string | unknown\n}\n\ntype Input = InputPath | InputData\n\n/**\n * Build configuration for Kubb code generation.\n *\n * The Config is the main entry point for customizing how Kubb generates code. It specifies:\n * - What to generate from (adapter + input)\n * - Where to output generated code (output)\n * - How to generate (plugins + middleware)\n * - Runtime details (parsers, storage, renderer)\n *\n * See `UserConfig` for a relaxed version with sensible defaults.\n *\n * @private\n */\nexport type Config<TInput = Input> = {\n  /**\n   * Display name for this configuration in CLI output and logs.\n   * Useful when running multiple builds with `defineConfig` arrays.\n   *\n   * @example\n   * ```ts\n   * name: 'api-client'\n   * ```\n   */\n  name?: string\n  /**\n   * Project root directory, absolute or relative to the config file.\n   * @default process.cwd()\n   */\n  root: string\n  /**\n   * Parsers that convert generated files to strings.\n   * Each parser handles specific extensions (e.g. `.ts`, `.tsx`).\n   * A fallback parser is appended for unhandled extensions.\n   * When omitted, defaults to `parserTs` from `@kubb/parser-ts`.\n   *\n   * @default [parserTs] from `@kubb/parser-ts`\n   * @example\n   * ```ts\n   * import { parserTs, tsxParser } from '@kubb/parser-ts'\n   * export default defineConfig({\n   *   parsers: [parserTs, tsxParser],\n   * })\n   * ```\n   */\n  parsers: Array<Parser>\n  /**\n   * Adapter that parses input files into the universal AST representation.\n   * Use `@kubb/adapter-oas` for OpenAPI/Swagger or `@kubb/adapter-asyncapi` for other formats.\n   *\n   * When omitted, Kubb runs in plugin-only mode: `kubb:plugin:setup` fires and files\n   * injected via `injectFile` are written, but no AST walk occurs and generator hooks\n   * (`kubb:generate:schema`, `kubb:generate:operation`) are never emitted.\n   *\n   * @example\n   * ```ts\n   * import { adapterOas } from '@kubb/adapter-oas'\n   * export default defineConfig({\n   *   adapter: adapterOas(),\n   *   input: { path: './petstore.yaml' },\n   * })\n   * ```\n   */\n  adapter?: Adapter\n  /**\n   * Source file or data to generate code from.\n   * Use `input.path` for a file path or `input.data` for inline data.\n   * Required when an adapter is configured; omit when running in plugin-only mode.\n   */\n  input?: TInput\n  output: {\n    /**\n     * Output directory for generated files, absolute or relative to `root`.\n     *\n     * All generated files will be written under this directory. Subdirectories can be created\n     * by plugins based on grouping strategy (by tag, path, etc.).\n     *\n     * @example\n     * ```ts\n     * output: {\n     *   path: './src/gen',  // generates ./src/gen/api.ts, ./src/gen/types.ts, etc.\n     * }\n     * ```\n     */\n    path: string\n    /**\n     * Remove all files from the output directory before starting the build.\n     *\n     * Useful to ensure old generated files aren't mixed with new ones.\n     * Set to `true` for fresh builds, `false` to preserve manual edits in output dir.\n     *\n     * @default false\n     * @example\n     * ```ts\n     * clean: true  // wipes ./src/gen/* before generating\n     * ```\n     */\n    clean?: boolean\n    /**\n     * Auto-format generated files after code generation completes.\n     *\n     * Applies a code formatter to all generated files. Use `'auto'` to detect which formatter\n     * is available on your system. Pass `false` to skip formatting (useful for CI or specific workflows).\n     *\n     * @default false\n     * @example\n     * ```ts\n     * format: 'auto'        // auto-detect prettier, biome, or oxfmt\n     * format: 'prettier'    // force prettier\n     * format: false         // skip formatting\n     * ```\n     */\n    format?: 'auto' | 'prettier' | 'biome' | 'oxfmt' | false\n    /**\n     * Auto-lint generated files after code generation completes.\n     *\n     * Analyzes all generated files for style/correctness issues. Use `'auto'` to detect which linter\n     * is available on your system. Pass `false` to skip linting.\n     *\n     * @default false\n     * @example\n     * ```ts\n     * lint: 'auto'      // auto-detect oxlint, biome, or eslint\n     * lint: 'eslint'    // force eslint\n     * lint: false       // skip linting\n     * ```\n     */\n    lint?: 'auto' | 'eslint' | 'biome' | 'oxlint' | false\n    /**\n     * Map file extensions to different output extensions.\n     *\n     * Useful when you want generated `.ts` imports to reference `.js` files or vice versa (e.g., for ESM dual packages).\n     * Keys are the original extension, values are the output extension. Use empty string `''` to omit extension.\n     *\n     * @default { '.ts': '.ts' }\n     * @example\n     * ```ts\n     * extension: { '.ts': '.js' }      // generates import './api.js' instead of './api.ts'\n     * extension: { '.ts': '', '.tsx': '.jsx' }\n     * ```\n     */\n    extension?: Record<FileNode['extname'], FileNode['extname'] | ''>\n    /**\n     * Banner text prepended to every generated file.\n     *\n     * Useful for auto-generation notices or license headers. Choose a preset or write custom text.\n     * Use `'simple'` for a basic Kubb banner, `'full'` for detailed metadata, or `false` to omit.\n     *\n     * @default 'simple'\n     * @example\n     * ```ts\n     * defaultBanner: 'simple'   // \"This file was autogenerated by Kubb\"\n     * defaultBanner: 'full'     // adds source, title, description, API version\n     * defaultBanner: false      // no banner\n     * ```\n     */\n    defaultBanner?: 'simple' | 'full' | false\n    /**\n     * When `true`, overwrites existing files. When `false`, skips generated files that already exist.\n     *\n     * Individual plugins can override this setting. This is useful for preventing accidental data loss\n     * when re-generating while you have local edits in the output folder.\n     *\n     * @default false\n     * @example\n     * ```ts\n     * override: true   // regenerate everything, even existing files\n     * override: false  // skip files that already exist\n     * ```\n     */\n    override?: boolean\n  } & ExtractRegistryKey<Kubb.ConfigOptionsRegistry, 'output'>\n  /**\n   * Storage backend that controls where and how generated files are persisted.\n   *\n   * Defaults to `fsStorage()` which writes to the file system. Pass `memoryStorage()` to keep files in RAM,\n   * or implement a custom `Storage` interface to write to cloud storage, databases, or other backends.\n   *\n   * @default fsStorage()\n   * @example\n   * ```ts\n   * import { memoryStorage } from '@kubb/core'\n   *\n   * // Keep generated files in memory (useful for testing, CI pipelines)\n   * storage: memoryStorage()\n   *\n   * // Use custom S3 storage\n   * storage: myS3Storage()\n   * ```\n   *\n   * @see {@link Storage} interface for implementing custom backends.\n   */\n  storage: Storage\n  /**\n   * Plugins that execute during the build to generate code and transform the AST.\n   *\n   * Each plugin processes the AST produced by the adapter and can emit files for different\n   * programming languages or formats (TypeScript, Zod schemas, Faker data, etc.).\n   * Dependencies are enforced — an error is thrown if a plugin requires another plugin that isn't registered.\n   *\n   * Plugins can declare their own options via `PluginFactoryOptions`. See plugin documentation for details.\n   *\n   * @example\n   * ```ts\n   * import { pluginTs } from '@kubb/plugin-ts'\n   * import { pluginZod } from '@kubb/plugin-zod'\n   *\n   * plugins: [\n   *   pluginTs({ output: { path: './src/gen' } }),\n   *   pluginZod({ output: { path: './src/gen' } }),\n   * ]\n   * ```\n   */\n  plugins: Array<Plugin>\n  /**\n   * Middleware instances that observe build events and post-process generated code.\n   *\n   * Middleware fires AFTER all plugins for each event. Perfect for tasks like:\n   * - Auditing what was generated\n   * - Adding barrel/index files\n   * - Validating output\n   * - Running custom transformations\n   *\n   * @example\n   * ```ts\n   * import { middlewareBarrel } from '@kubb/middleware-barrel'\n   *\n   * middleware: [middlewareBarrel()]\n   * ```\n   *\n   * @see {@link defineMiddleware} to create custom middleware.\n   */\n  middleware?: Array<Middleware>\n  /**\n   * Renderer that converts generated AST nodes to code strings.\n   *\n   * By default, Kubb uses the JSX renderer (`rendererJsx`). Pass a custom renderer to support\n   * different output formats (template engines, code generation DSLs, etc.).\n   *\n   * @default rendererJsx()  // from @kubb/renderer-jsx\n   * @example\n   * ```ts\n   * import { rendererJsx } from '@kubb/renderer-jsx'\n   * renderer: rendererJsx()\n   * ```\n   *\n   * @see {@link Renderer} to implement a custom renderer.\n   */\n  renderer?: RendererFactory\n  /**\n   * Kubb Studio cloud integration settings.\n   *\n   * Kubb Studio (https://kubb.studio) is a web-based IDE for managing API specs and generated code.\n   * Set to `true` to enable with default settings, or pass an object to customize the Studio URL.\n   *\n   * @default false  // disabled by default\n   * @example\n   * ```ts\n   * devtools: true                                   // use default Kubb Studio\n   * devtools: { studioUrl: 'https://my-studio.dev' } // custom Studio instance\n   * ```\n   */\n  devtools?:\n    | true\n    | {\n        /**\n         * Override the Kubb Studio base URL.\n         * @default 'https://kubb.studio'\n         */\n        studioUrl?: typeof DEFAULT_STUDIO_URL | (string & {})\n      }\n  /**\n   * Lifecycle hooks that execute during or after the build process.\n   *\n   * Hooks allow you to run external tools (prettier, eslint, custom scripts) based on build events.\n   * Currently supports the `done` hook which fires after all plugins and middleware complete.\n   *\n   * @example\n   * ```ts\n   * hooks: {\n   *   done: 'prettier --write \"./src/gen\"',      // auto-format generated files\n   *   // or multiple commands:\n   *   done: ['prettier --write \"./src/gen\"', 'eslint --fix \"./src/gen\"']\n   * }\n   * ```\n   */\n  hooks?: {\n    /**\n     * Command(s) to run after all plugins and middleware complete generation.\n     *\n     * Useful for post-processing: formatting, linting, copying files, or custom validation.\n     * Pass a single command string or array of command strings to run sequentially.\n     * Commands are executed relative to the `root` directory.\n     *\n     * @example\n     * ```ts\n     * done: 'prettier --write \"./src/gen\"'\n     * done: ['prettier --write \"./src/gen\"', 'eslint --fix \"./src/gen\"']\n     * ```\n     */\n    done?: string | Array<string>\n  }\n}\n\n/**\n * Partial `Config` for user-facing entry points with sensible defaults.\n *\n * `UserConfig` is what you pass to `defineConfig()`. It has optional `root`, `plugins`, `parsers`, and `adapter`\n * fields (which fall back to sensible defaults). All other Config options are available, including `output`, `input`,\n * `storage`, `middleware`, `renderer`, `devtools`, and `hooks`.\n *\n * @example\n * ```ts\n * export default defineConfig({\n *   input: { path: './petstore.yaml' },\n *   output: { path: './src/gen' },\n *   plugins: [pluginTs(), pluginZod()],\n * })\n * ```\n */\nexport type UserConfig<TInput = Input> = Omit<Config<TInput>, 'root' | 'plugins' | 'parsers' | 'adapter' | 'storage'> & {\n  /**\n   * Project root directory, absolute or relative to the config file location.\n   * @default process.cwd()\n   */\n  root?: string\n  /**\n   * Custom parsers that convert generated AST nodes to strings (TypeScript, JSON, markdown, etc.).\n   * @default [parserTs]  // from `@kubb/parser-ts`\n   */\n  parsers?: Array<Parser>\n  /**\n   * Adapter that parses your API specification into Kubb's universal AST.\n   * When omitted, Kubb runs in plugin-only mode.\n   */\n  adapter?: Adapter\n  /**\n   * Plugins that execute during the build to generate code and transform the AST.\n   * @default []\n   */\n  plugins?: Array<Plugin>\n  /**\n   * Storage backend that controls where and how generated files are persisted.\n   * @default fsStorage()\n   */\n  storage?: Storage\n}\n\ndeclare global {\n  namespace Kubb {\n    /**\n     * Registry that maps plugin names to their `PluginFactoryOptions`.\n     * Augment this interface in each plugin's `types.ts` to enable automatic\n     * typing for `getPlugin` and `requirePlugin`.\n     *\n     * @example\n     * ```ts\n     * // packages/plugin-ts/src/types.ts\n     * declare global {\n     *   namespace Kubb {\n     *     interface PluginRegistry {\n     *       'plugin-ts': PluginTs\n     *     }\n     *   }\n     * }\n     * ```\n     */\n    interface PluginRegistry {}\n\n    /**\n     * Extension point for root `Config['output']` options.\n     * Augment the `output` key in middleware or plugin packages to add extra fields\n     * to the global output configuration without touching core types.\n     *\n     * @example\n     * ```ts\n     * // packages/middleware-barrel/src/types.ts\n     * declare global {\n     *   namespace Kubb {\n     *     interface ConfigOptionsRegistry {\n     *       output: {\n     *         barrel?: import('./types.ts').BarrelConfig | false\n     *       }\n     *     }\n     *   }\n     * }\n     * ```\n     */\n    interface ConfigOptionsRegistry {}\n\n    /**\n     * Extension point for per-plugin `Output` options.\n     * Augment the `output` key in middleware or plugin packages to add extra fields\n     * to the per-plugin output configuration without touching core types.\n     *\n     * @example\n     * ```ts\n     * // packages/middleware-barrel/src/types.ts\n     * declare global {\n     *   namespace Kubb {\n     *     interface PluginOptionsRegistry {\n     *       output: {\n     *         barrel?: import('./types.ts').PluginBarrelConfig | false\n     *       }\n     *     }\n     *   }\n     * }\n     * ```\n     */\n    interface PluginOptionsRegistry {}\n  }\n}\n\n/**\n * Lifecycle events emitted during Kubb code generation.\n * Attach listeners before calling `setup()` or `build()` to observe and react to build progress.\n *\n * @example\n * ```ts\n * kubb.hooks.on('kubb:lifecycle:start', () => {\n *   console.log('Starting Kubb generation')\n * })\n *\n * kubb.hooks.on('kubb:plugin:end', ({ plugin, duration }) => {\n *   console.log(`${plugin.name} completed in ${duration}ms`)\n * })\n * ```\n */\nexport interface KubbHooks {\n  'kubb:lifecycle:start': [ctx: KubbLifecycleStartContext]\n  'kubb:lifecycle:end': []\n  'kubb:config:start': []\n  'kubb:config:end': [ctx: KubbConfigEndContext]\n  'kubb:generation:start': [ctx: KubbGenerationStartContext]\n  'kubb:generation:end': [ctx: KubbGenerationEndContext]\n  'kubb:generation:summary': [ctx: KubbGenerationSummaryContext]\n  'kubb:format:start': []\n  'kubb:format:end': []\n  'kubb:lint:start': []\n  'kubb:lint:end': []\n  'kubb:hooks:start': []\n  'kubb:hooks:end': []\n  'kubb:hook:start': [ctx: KubbHookStartContext]\n  'kubb:hook:end': [ctx: KubbHookEndContext]\n  'kubb:version:new': [ctx: KubbVersionNewContext]\n  'kubb:info': [ctx: KubbInfoContext]\n  'kubb:error': [ctx: KubbErrorContext]\n  'kubb:success': [ctx: KubbSuccessContext]\n  'kubb:warn': [ctx: KubbWarnContext]\n  'kubb:debug': [ctx: KubbDebugContext]\n  'kubb:files:processing:start': [ctx: KubbFilesProcessingStartContext]\n  'kubb:file:processing:update': [ctx: KubbFileProcessingUpdateContext]\n  'kubb:files:processing:end': [ctx: KubbFilesProcessingEndContext]\n  'kubb:plugin:start': [ctx: KubbPluginStartContext]\n  'kubb:plugin:end': [ctx: KubbPluginEndContext]\n  'kubb:plugin:setup': [ctx: KubbPluginSetupContext]\n  'kubb:build:start': [ctx: KubbBuildStartContext]\n  'kubb:plugins:end': [ctx: KubbPluginsEndContext]\n  'kubb:build:end': [ctx: KubbBuildEndContext]\n  'kubb:generate:schema': [node: SchemaNode, ctx: GeneratorContext]\n  'kubb:generate:operation': [node: OperationNode, ctx: GeneratorContext]\n  'kubb:generate:operations': [nodes: Array<OperationNode>, ctx: GeneratorContext]\n}\n\nexport type KubbBuildStartContext = {\n  /**\n   * Resolved configuration for this build.\n   */\n  config: Config\n  /**\n   * Adapter that parsed the input into the universal AST.\n   */\n  adapter: Adapter\n  /**\n   * Metadata about the parsed document (title, version, base URL, circular schema names, enum names).\n   * To observe individual schemas and operations use the `kubb:generate:schema` / `kubb:generate:operation` hooks.\n   */\n  meta: InputMeta | undefined\n  /**\n   * Looks up a registered plugin by name, typed by the plugin registry.\n   */\n  getPlugin<TName extends keyof Kubb.PluginRegistry>(name: TName): Plugin<Kubb.PluginRegistry[TName]> | undefined\n  getPlugin(name: string): Plugin | undefined\n  /**\n   * Snapshot of all files accumulated so far.\n   */\n  readonly files: ReadonlyArray<FileNode>\n  /**\n   * Adds or merges one or more files into the file manager.\n   */\n  upsertFile: (...files: Array<FileNode>) => void\n}\n\nexport type KubbPluginsEndContext = {\n  /**\n   * Resolved configuration for this build.\n   */\n  config: Config\n  /**\n   * Snapshot of all files accumulated across all plugins.\n   */\n  readonly files: ReadonlyArray<FileNode>\n  /**\n   * Adds or merges one or more files into the file manager.\n   */\n  upsertFile: (...files: Array<FileNode>) => void\n}\n\nexport type KubbBuildEndContext = {\n  /**\n   * All files generated during this build.\n   */\n  files: Array<FileNode>\n  /**\n   * Resolved configuration for this build.\n   */\n  config: Config\n  /**\n   * Absolute path to the output directory.\n   */\n  outputDir: string\n}\n\nexport type KubbLifecycleStartContext = {\n  /**\n   * Current Kubb version string.\n   */\n  version: string\n}\n\nexport type KubbConfigEndContext = {\n  /**\n   * All resolved configs after defaults are applied.\n   */\n  configs: Array<Config>\n}\n\nexport type KubbGenerationStartContext = {\n  /**\n   * Resolved configuration for this generation run.\n   */\n  config: Config\n}\n\nexport type KubbGenerationEndContext = {\n  /**\n   * Resolved configuration for this generation run.\n   */\n  config: Config\n  /**\n   * Read-only view of the files written during this build.\n   * Reads go directly to `config.storage` — nothing extra is held in memory.\n   *\n   * @example Read a generated file\n   * `const code = await storage.getItem('/src/gen/pet.ts')`\n   *\n   * @example Walk every generated file\n   * ```ts\n   * for (const path of await storage.getKeys()) {\n   *   const code = await storage.getItem(path)\n   * }\n   * ```\n   */\n  storage: Storage\n}\n\nexport type KubbGenerationSummaryContext = {\n  /**\n   * Resolved configuration for this generation run.\n   */\n  config: Config\n  /**\n   * Plugins that threw during generation, paired with their errors.\n   */\n  failedPlugins: Set<{ plugin: Plugin; error: Error }>\n  /**\n   * `'success'` when all plugins completed without errors, `'failed'` otherwise.\n   */\n  status: 'success' | 'failed'\n  /**\n   * High-resolution start time from `process.hrtime()`.\n   */\n  hrStart: [number, number]\n  /**\n   * Total number of files created during this run.\n   */\n  filesCreated: number\n  /**\n   * Elapsed milliseconds per plugin, keyed by plugin name.\n   */\n  pluginTimings?: Map<Plugin['name'], number>\n}\n\nexport type KubbVersionNewContext = {\n  /**\n   * The installed Kubb version.\n   */\n  currentVersion: string\n  /**\n   * The newest available version on npm.\n   */\n  latestVersion: string\n}\n\nexport type KubbInfoContext = {\n  /**\n   * Human-readable info message.\n   */\n  message: string\n  /**\n   * Optional supplementary detail.\n   */\n  info?: string\n}\n\nexport type KubbErrorContext = {\n  /**\n   * The caught error.\n   */\n  error: Error\n  /**\n   * Optional structured metadata for additional context.\n   */\n  meta?: Record<string, unknown>\n}\n\nexport type KubbSuccessContext = {\n  /**\n   * Human-readable success message.\n   */\n  message: string\n  /**\n   * Optional supplementary detail.\n   */\n  info?: string\n}\n\nexport type KubbWarnContext = {\n  /**\n   * Human-readable warning message.\n   */\n  message: string\n  /**\n   * Optional supplementary detail.\n   */\n  info?: string\n}\n\nexport type KubbDebugContext = {\n  /**\n   * Timestamp when the debug entry was created.\n   */\n  date: Date\n  /**\n   * One or more log lines to emit.\n   */\n  logs: Array<string>\n  /**\n   * Optional source file name associated with this entry.\n   */\n  fileName?: string\n}\n\nexport type KubbFilesProcessingStartContext = {\n  /**\n   * Files about to be serialised and written.\n   */\n  files: Array<FileNode>\n}\n\nexport type KubbFileProcessingUpdateContext = {\n  /**\n   * Number of files processed so far in this batch.\n   */\n  processed: number\n  /**\n   * Total number of files in this batch.\n   */\n  total: number\n  /**\n   * Completion percentage (`0`–`100`).\n   */\n  percentage: number\n  /**\n   * Serialised file content, or `undefined` when the file produced no output.\n   */\n  source?: string\n  /**\n   * The file that was just processed.\n   */\n  file: FileNode\n  /**\n   * Resolved configuration for this build.\n   */\n  config: Config\n}\n\nexport type KubbFilesProcessingEndContext = {\n  /**\n   * All files that were serialised in this batch.\n   */\n  files: Array<FileNode>\n}\n\nexport type KubbHookStartContext = {\n  /**\n   * Optional identifier for correlating start/end events.\n   */\n  id?: string\n  /**\n   * The shell command that is about to run.\n   */\n  command: string\n  /**\n   * Parsed argument list, when available.\n   */\n  args?: readonly string[]\n}\n\nexport type KubbHookEndContext = {\n  /**\n   * Optional identifier matching the corresponding `kubb:hook:start` event.\n   */\n  id?: string\n  /**\n   * The shell command that ran.\n   */\n  command: string\n  /**\n   * Parsed argument list, when available.\n   */\n  args?: readonly string[]\n  /**\n   * `true` when the command exited with code `0`.\n   */\n  success: boolean\n  /**\n   * Error thrown by the command, or `null` on success.\n   */\n  error: Error | null\n}\n\n/**\n * CLI options derived from command-line flags.\n */\nexport type CLIOptions = {\n  /**\n   * Path to the Kubb config file.\n   */\n  config?: string\n  /**\n   * Re-run generation whenever input files change.\n   */\n  watch?: boolean\n  /**\n   * Controls how much output the CLI prints.\n   *\n   * @default 'silent'\n   */\n  logLevel?: 'silent' | 'info' | 'debug'\n}\n\n/**\n * All accepted forms of a Kubb configuration.\n * Accepts `Config`/`Config[]`/promise or a factory (optionally receiving `TCliOptions`.\n */\nexport type PossibleConfig<TCliOptions = undefined> =\n  | PossiblePromise<Config | Config[]>\n  | ((...args: [TCliOptions] extends [undefined] ? [] : [TCliOptions]) => PossiblePromise<Config | Config[]>)\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 generation, paired with their errors.\n   */\n  failedPlugins: Set<{ plugin: Plugin; error: Error }>\n  /**\n   * All files generated during this build.\n   */\n  files: Array<FileNode>\n  /**\n   * The plugin driver that orchestrated this build.\n   */\n  driver: KubbDriver\n  /**\n   * Elapsed milliseconds per plugin, keyed by plugin name.\n   */\n  pluginTimings: Map<string, number>\n  /**\n   * Top-level error when the build threw before completing, otherwise `undefined`.\n   */\n  error?: Error\n  /**\n   * Read-only view of every file written during this build.\n   * Reads go straight to `config.storage` — nothing extra is held in memory.\n   *\n   * @example Read a generated file\n   * `const code = await buildOutput.storage.getItem('/src/gen/pet.ts')`\n   *\n   * @example List all generated file paths\n   * `const paths = await buildOutput.storage.getKeys()`\n   */\n  storage: Storage\n}\n\n/**\n * Kubb code generation instance returned by {@link createKubb}.\n *\n * Use this when orchestrating multiple builds, inspecting plugin timings, or integrating Kubb into a larger toolchain.\n * For a single one-off build, chain directly: `await createKubb(config).build()`.\n */\nexport type Kubb = {\n  /**\n   * Shared event emitter for lifecycle and status events. Attach listeners before calling `setup()` or `build()`.\n   */\n  readonly hooks: AsyncEventEmitter<KubbHooks>\n  /**\n   * Read-only view of the files from the most recent `build()` or `safeBuild()` call.\n   * Only populated after the build completes.\n   *\n   * Keys are scoped to the current run. Reads go straight to `config.storage`,\n   * so nothing extra is held in memory.\n   *\n   * @example Read a generated file\n   * ```ts\n   * const { storage } = await kubb.safeBuild()\n   * const code = await storage.getItem('/src/gen/pet.ts')\n   * ```\n   *\n   * @example Walk every generated file\n   * ```ts\n   * for (const path of await kubb.storage.getKeys()) {\n   *   const code = await kubb.storage.getItem(path)\n   * }\n   * ```\n   */\n  readonly storage: Storage\n  /**\n   * Plugin driver managing all plugins. Available after `setup()` completes.\n   */\n  readonly driver: KubbDriver\n  /**\n   * Resolved configuration with defaults applied. Available after `setup()` completes.\n   */\n  readonly config: Config\n  /**\n   * Resolves config and initializes the driver. `build()` calls this automatically.\n   */\n  setup(): Promise<void>\n  /**\n   * Runs the full pipeline and throws on any plugin error. Automatically calls `setup()` if needed.\n   */\n  build(): Promise<BuildOutput>\n  /**\n   * Runs the full pipeline and captures errors in `BuildOutput` instead of throwing. Automatically calls `setup()` if needed.\n   */\n  safeBuild(): Promise<BuildOutput>\n}\n\ntype SetupResult = {\n  hooks: AsyncEventEmitter<KubbHooks>\n  driver: KubbDriver\n  storage: Storage\n  config: Config\n  dispose: () => void\n  [Symbol.dispose](): void\n}\n\n/**\n * Builds a `Storage` view scoped to the file paths produced by the current build.\n *\n * Reads delegate to the underlying `storage` (typically `fsStorage()`) so source bytes\n * stay where they were written instead of being held in an extra in-memory map.\n * Writing via `setItem` stores the content in the underlying storage and registers the\n * key so subsequent reads and `getKeys` are scoped to this build's output.\n */\nfunction createSourcesView(storage: Storage): Storage {\n  const paths = new Set<string>()\n\n  return createStorage(() => ({\n    name: `${storage.name}:sources`,\n    async hasItem(key: string) {\n      return paths.has(key) && (await storage.hasItem(key))\n    },\n    async getItem(key: string) {\n      return paths.has(key) ? storage.getItem(key) : null\n    },\n    async setItem(key: string, value: string) {\n      paths.add(key)\n      await storage.setItem(key, value)\n    },\n    async removeItem(key: string) {\n      paths.delete(key)\n      await storage.removeItem(key)\n    },\n    async getKeys(base?: string) {\n      if (!base) return [...paths]\n      const result: Array<string> = []\n      for (const key of paths) {\n        if (key.startsWith(base)) result.push(key)\n      }\n      return result\n    },\n    async clear() {\n      paths.clear()\n      await storage.clear()\n    },\n  }))()\n}\n\nasync function setup(userConfig: UserConfig, options: SetupOptions = {}): Promise<SetupResult> {\n  const hooks = options.hooks ?? new AsyncEventEmitter<KubbHooks>()\n  const config: Config = {\n    ...userConfig,\n    root: userConfig.root || process.cwd(),\n    parsers: userConfig.parsers ?? [],\n    output: {\n      format: false,\n      lint: false,\n      extension: DEFAULT_EXTENSION,\n      defaultBanner: DEFAULT_BANNER,\n      ...userConfig.output,\n    },\n    storage: userConfig.storage ?? fsStorage(),\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  const driver = new KubbDriver(config, {\n    hooks,\n  })\n  const storage = createSourcesView(config.storage)\n  const diagnosticInfo = getDiagnosticInfo()\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: ${config.storage.name}`,\n      `  • Formatter: ${userConfig.output?.format || 'none'}`,\n      `  • Linter: ${userConfig.output?.lint || 'none'}`,\n      `Running adapter: ${config.adapter?.name || '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 (config.output.clean) {\n    await hooks.emit('kubb:debug', {\n      date: new Date(),\n      logs: ['Cleaning output directories', `  • Output: ${config.output.path}`],\n    })\n\n    await config.storage.clear(resolve(config.root, config.output.path))\n  }\n\n  await driver.setup()\n\n  return {\n    config,\n    hooks,\n    driver,\n    storage,\n    dispose,\n    [Symbol.dispose]: dispose,\n  }\n\n  function dispose() {\n    driver.dispose()\n  }\n}\n\ntype GeneratorEntry = { plugin: NormalizedPlugin; context: GeneratorContext; hrStart: ReturnType<typeof process.hrtime> }\n\nasync function safeBuild(setupResult: SetupResult): Promise<BuildOutput> {\n  using _cleanup = setupResult\n  const { driver, hooks, 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  const writtenPaths = new Set<string>()\n  const parsersMap = new Map<FileNode['extname'], Parser>()\n  const fileProcessor = new FileProcessor()\n\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  async function flushPendingFiles(): Promise<void> {\n    const files = driver.fileManager.files.filter((f) => !writtenPaths.has(f.path))\n    if (files.length === 0) {\n      return\n    }\n\n    await hooks.emit('kubb:debug', {\n      date: new Date(),\n      logs: [`Writing ${files.length} files...`],\n    })\n\n    await hooks.emit('kubb:files:processing:start', { files })\n\n    const stream = fileProcessor.stream(files, { parsers: parsersMap, extension: config.output.extension })\n\n    const queue: Array<Promise<void>> = []\n    for (const { file, source, processed, total, percentage } of stream) {\n      writtenPaths.add(file.path)\n      queue.push(\n        (async () => {\n          await hooks.emit('kubb:file:processing:update', { file, source, processed, total, percentage, config })\n          if (source) {\n            await storage.setItem(file.path, source)\n          }\n        })(),\n      )\n      if (queue.length >= STREAM_FLUSH_EVERY) {\n        await Promise.all(queue.splice(0))\n      }\n    }\n    await Promise.all(queue)\n\n    await hooks.emit('kubb:files:processing:end', { files })\n    await hooks.emit('kubb:debug', {\n      date: new Date(),\n      logs: [`✓ File write process completed for ${files.length} files`],\n    })\n  }\n\n  async function dispatchOperationsToGenerators(\n    generators: Generator[],\n    collectedOperations: OperationNode[],\n    ctx: GeneratorContext,\n    rendererFor: (gen: Generator) => RendererFactory | undefined,\n  ): Promise<void> {\n    for (const gen of generators) {\n      if (!gen.operations) continue\n      const result = await gen.operations(collectedOperations, ctx)\n      await applyHookResult({ result, driver, rendererFactory: rendererFor(gen) })\n    }\n    await driver.hooks.emit('kubb:generate:operations', collectedOperations, ctx)\n  }\n\n  /**\n   * Single-pass fan-out: iterates all schemas and operations once, distributing each node\n   * to every generator-plugin in parallel. This replaces the N-pass-per-plugin pattern\n   * (each plugin getting its own iterator) with one parse pass fanned to all plugins,\n   * eliminating the N×parse-time overhead for multi-plugin builds.\n   */\n  async function runPlugins(entries: Array<GeneratorEntry>): Promise<void> {\n    type PluginState = {\n      plugin: NormalizedPlugin\n      generatorContext: GeneratorContext\n      generators: Generator[]\n      hrStart: ReturnType<typeof process.hrtime>\n      failed: boolean\n      error: Error | undefined\n      /**\n       * `true` when the plugin's options have no `include`, `exclude`, or `override`\n       * filters. The per-node `resolveOptions` call always returns the same `options`\n       * reference in that case, so the inner loop can skip it entirely.\n       */\n      optionsAreStatic: boolean\n      /**\n       * Set when the plugin has operation-based includes (tag, operationId, path, method, contentType)\n       * but no schemaName includes. Schema nodes whose name is not in this set are skipped,\n       * matching the pruning behavior of the eager path.\n       */\n      allowedSchemaNames: Set<string> | undefined\n    }\n\n    const { schemas, operations } = driver.inputNode!\n    const operationFilterTypes = new Set(['tag', 'operationId', 'path', 'method', 'contentType'])\n    const states: PluginState[] = entries.map(({ plugin, context, hrStart }) => {\n      const { exclude, include, override } = plugin.options\n      const hasExclude = Array.isArray(exclude) && exclude.length > 0\n      const hasInclude = Array.isArray(include) && include.length > 0\n      const hasOverride = Array.isArray(override) && override.length > 0\n      return {\n        plugin,\n        generatorContext: { ...context, resolver: driver.getResolver(plugin.name) },\n        generators: plugin.generators ?? [],\n        hrStart,\n        failed: false,\n        error: undefined,\n        optionsAreStatic: !hasExclude && !hasInclude && !hasOverride,\n        allowedSchemaNames: undefined,\n      }\n    })\n\n    // Pre-scan: compute allowedSchemaNames for plugins that use operation-based includes\n    // without schemaName filters. Each AsyncIterable yields a fresh iterator on every call,\n    // so consuming them here does not affect the main dispatch passes below.\n    const pruningStates = states.filter(({ plugin }) => {\n      const { include } = plugin.options\n      return (include?.some(({ type }) => operationFilterTypes.has(type)) ?? false) && !(include?.some(({ type }) => type === 'schemaName') ?? false)\n    })\n\n    if (pruningStates.length > 0) {\n      // Known trade-off: computing the reachable-schema set for operation-based includes\n      // requires the full schema graph in memory at once — there is no way to determine\n      // transitive reachability from a single schema node in isolation.\n      // `allSchemas` is released as soon as this block exits; it is never held past\n      // the pruning pre-scan. The main dispatch passes below each get their own\n      // fresh iterator from the AsyncIterable, so this consumption does not affect them.\n      const allSchemas: SchemaNode[] = []\n      for await (const schema of schemas) {\n        allSchemas.push(schema)\n      }\n\n      // Collect the included operations for each pruning plugin in one shared pass.\n      const includedOpsByState = new Map<PluginState, OperationNode[]>(pruningStates.map((s) => [s, []]))\n      for await (const operation of operations) {\n        for (const state of pruningStates) {\n          const { exclude, include, override } = state.plugin.options\n          const options = state.generatorContext.resolver.resolveOptions(operation, { options: state.plugin.options, exclude, include, override })\n          if (options !== null) includedOpsByState.get(state)?.push(operation)\n        }\n      }\n\n      // Derive the allowed schema name set per pruning plugin.\n      for (const state of pruningStates) {\n        state.allowedSchemaNames = collectUsedSchemaNames(includedOpsByState.get(state) ?? [], allSchemas)\n      }\n    }\n\n    function resolveRendererFor(gen: Generator, state: PluginState): RendererFactory | undefined {\n      return gen.renderer === null ? undefined : (gen.renderer ?? state.plugin.renderer ?? state.generatorContext.config.renderer)\n    }\n\n    async function dispatchSchema(state: PluginState, node: SchemaNode): Promise<void> {\n      if (state.failed) return\n\n      try {\n        const { plugin, generatorContext, generators } = state\n\n        const transformedNode = plugin.transformer ? transform(node, plugin.transformer) : node\n\n        // Skip named top-level schemas not reachable from any included operation.\n        if (state.allowedSchemaNames !== undefined && transformedNode.name && !state.allowedSchemaNames.has(transformedNode.name)) {\n          return\n        }\n\n        const { exclude, include, override } = plugin.options\n        const options = state.optionsAreStatic\n          ? plugin.options\n          : generatorContext.resolver.resolveOptions(transformedNode, { options: plugin.options, exclude, include, override })\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 raw = gen.schema(transformedNode, ctx)\n          const result = isPromise(raw) ? await raw : raw\n          const applied = applyHookResult({ result, driver, rendererFactory: resolveRendererFor(gen, state) })\n          if (isPromise(applied)) await applied\n        }\n\n        await driver.hooks.emit('kubb:generate:schema', transformedNode, ctx)\n      } catch (caughtError) {\n        state.failed = true\n        state.error = caughtError as Error\n      }\n    }\n\n    async function dispatchOperation(state: PluginState, node: OperationNode): Promise<void> {\n      if (state.failed) return\n\n      try {\n        const { plugin, generatorContext, generators } = state\n\n        const transformedNode = plugin.transformer ? transform(node, plugin.transformer) : node\n        const { exclude, include, override } = plugin.options\n        const options = state.optionsAreStatic\n          ? plugin.options\n          : generatorContext.resolver.resolveOptions(transformedNode, { options: plugin.options, exclude, include, override })\n        if (options === null) return\n\n        const ctx = { ...generatorContext, options }\n\n        for (const gen of generators) {\n          if (!gen.operation) continue\n          const raw = gen.operation(transformedNode, ctx)\n          const result = isPromise(raw) ? await raw : raw\n          const applied = applyHookResult({ result, driver, rendererFactory: resolveRendererFor(gen, state) })\n          if (isPromise(applied)) await applied\n        }\n\n        await driver.hooks.emit('kubb:generate:operation', transformedNode, ctx)\n      } catch (caughtError) {\n        state.failed = true\n        state.error = caughtError as Error\n      }\n    }\n\n    // Batch schemas: SCHEMA_PARALLEL nodes dispatched across all plugins concurrently.\n    // Per-plugin work inside dispatchSchema stays sequential so FileManager.upsert\n    // ordering for any single plugin chain remains deterministic.\n    await forBatches(schemas, (nodes) => Promise.all(nodes.flatMap((n) => states.map((state) => dispatchSchema(state, n)))), {\n      concurrency: SCHEMA_PARALLEL,\n      flush: flushPendingFiles,\n    })\n\n    const collectedOperations: OperationNode[] = []\n\n    await forBatches(\n      operations,\n      (nodes) => {\n        collectedOperations.push(...nodes)\n        return Promise.all(nodes.flatMap((n) => states.map((state) => dispatchOperation(state, n))))\n      },\n      { concurrency: SCHEMA_PARALLEL, flush: flushPendingFiles },\n    )\n\n    for (const state of states) {\n      if (!state.failed) {\n        try {\n          const { plugin, generatorContext, generators } = state\n          const ctx = { ...generatorContext, options: plugin.options }\n          await dispatchOperationsToGenerators(generators, collectedOperations, ctx, (gen) => resolveRendererFor(gen, state))\n        } catch (caughtError) {\n          state.failed = true\n          state.error = caughtError as Error\n        }\n      }\n\n      const duration = getElapsedMs(state.hrStart)\n      pluginTimings.set(state.plugin.name, duration)\n\n      await driver.hooks.emit('kubb:plugin:end', {\n        plugin: state.plugin,\n        duration,\n        success: !state.failed,\n        ...(state.failed && state.error ? { error: state.error } : {}),\n        config: driver.config,\n        get files() {\n          return driver.fileManager.files\n        },\n        upsertFile: (...files) => driver.fileManager.upsert(...files),\n      })\n\n      if (state.failed && state.error) {\n        failedPlugins.add({ plugin: state.plugin, error: state.error })\n      }\n\n      await driver.hooks.emit('kubb:debug', {\n        date: new Date(),\n        logs: [state.failed ? '✗ Plugin start failed' : `✓ Plugin started successfully (${formatMs(duration)})`],\n      })\n    }\n  }\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        meta: driver.inputNode.meta,\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    // Always run the plugin lifecycle so middleware hooks (kubb:plugin:start,\n    // kubb:plugin:end) fire even when no adapter is configured.\n    // Generator-plugins are collected for the stream fan-out pass below.\n    const generatorPlugins: Array<GeneratorEntry> = []\n\n    for (const plugin of driver.plugins.values()) {\n      const context = driver.getContext(plugin)\n      const hrStart = process.hrtime()\n\n      try {\n        await hooks.emit('kubb:plugin:start', { plugin })\n        await hooks.emit('kubb:debug', {\n          date: new Date(),\n          logs: ['Starting plugin...', `  • Plugin Name: ${plugin.name}`],\n        })\n      } catch (caughtError) {\n        const error = caughtError as Error\n        const duration = getElapsedMs(hrStart)\n        pluginTimings.set(plugin.name, duration)\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        failedPlugins.add({ plugin, error })\n        continue\n      }\n\n      if (plugin.generators?.length || driver.hasEventGenerators(plugin.name)) {\n        generatorPlugins.push({ plugin, context, hrStart })\n        continue\n      }\n      // No generators: plugin ran via setup hooks; finish it now.\n      const duration = getElapsedMs(hrStart)\n      pluginTimings.set(plugin.name, duration)\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      await hooks.emit('kubb:debug', {\n        date: new Date(),\n        logs: [`✓ Plugin started successfully (${formatMs(duration)})`],\n      })\n    }\n\n    if (generatorPlugins.length > 0) {\n      if (driver.inputNode) {\n        // Normal path: fan-out schemas and operations to all generator-plugins in one pass.\n        await withDrain(() => runPlugins(generatorPlugins), flushPendingFiles)\n      } else {\n        // No adapter configured — generator-plugins have nothing to process.\n        // Still emit plugin:end so middleware hooks (e.g. barrel) complete their lifecycle.\n        for (const { plugin, hrStart } of generatorPlugins) {\n          const duration = getElapsedMs(hrStart)\n          pluginTimings.set(plugin.name, duration)\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      }\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    await flushPendingFiles()\n\n    const files = driver.fileManager.files\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      storage,\n    }\n  } catch (error) {\n    return {\n      failedPlugins,\n      files: [],\n      driver,\n      pluginTimings,\n      error: error as Error,\n      storage,\n    }\n  }\n}\n\nasync function build(setupResult: SetupResult): Promise<BuildOutput> {\n  const { files, driver, failedPlugins, pluginTimings, error, storage } = 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    storage,\n  }\n}\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\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> & { input: InputPath }\nexport function isInputPath(config: Config | undefined): config is Config<InputPath> & { input: InputPath }\nexport function isInputPath(config: Config | UserConfig | undefined): config is (Config<InputPath> | UserConfig<InputPath>) & { input: InputPath } {\n  return typeof config?.input === 'object' && config.input !== null && 'path' in config.input\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`, `storage`, `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 storage() {\n      if (!setupResult) {\n        throw new Error('[kubb] setup() must be called before accessing storage')\n      }\n      return setupResult.storage\n    },\n    get driver() {\n      if (!setupResult) {\n        throw new Error('[kubb] setup() must be called before accessing driver')\n      }\n      return setupResult.driver\n    },\n    get config() {\n      if (!setupResult) {\n        throw new Error('[kubb] setup() must be called before accessing config')\n      }\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 * `TElement` is the type the renderer accepts, for example `KubbReactElement`\n * for `@kubb/renderer-jsx` or a custom type for your own renderer. Defaults to\n * `unknown` so generators that don't care about the element type work without\n * specifying it.\n */\nexport type Renderer<TElement = unknown> = {\n  /**\n   * Renders `element` and populates {@link files} with the resulting {@link FileNode} objects.\n   * Called once per render cycle; must resolve before {@link files} is read.\n   */\n  render(element: TElement): Promise<void>\n  /**\n   * Tears down the renderer and releases any held resources.\n   * Pass an `Error` to signal a failure, a number for an exit code, or omit for a clean shutdown.\n   */\n  unmount(error?: Error | number | null): void\n  /**\n   * Accumulated {@link FileNode} results produced by the last {@link render} call.\n   * Not populated when {@link stream} is implemented.\n   */\n  readonly files: Array<FileNode>\n  /**\n   * When present, core calls this instead of {@link render} and {@link files},\n   * forwarding each file to `FileManager` as soon as it is ready.\n   */\n  stream?(element: TElement): Iterable<FileNode>\n}\n\n/**\n * A factory function that produces a fresh {@link Renderer} per render cycle.\n *\n * Generators use this to declare which renderer handles their output.\n */\nexport type RendererFactory<TElement = unknown> = () => Renderer<TElement>\n\n/**\n * Wraps a renderer factory for use in generator definitions.\n *\n * @example\n * ```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 */\nexport function createRenderer<TElement = unknown>(factory: RendererFactory<TElement>): RendererFactory<TElement> {\n  return factory\n}\n","import type { AsyncEventEmitter, PossiblePromise } from '@internals/utils'\nimport type { FileNode, InputMeta, OperationNode, SchemaNode, Visitor } from '@kubb/ast'\nimport type { Adapter } from './createAdapter.ts'\nimport type { RendererFactory } from './createRenderer.ts'\nimport type { KubbHooks } from './types.ts'\nimport type { KubbDriver } from './KubbDriver.ts'\nimport type { Plugin, PluginFactoryOptions } from './definePlugin.ts'\nimport type { Resolver } from './defineResolver.ts'\nimport type { Config, DevtoolsOptions } from './types.ts'\n\n/**\n * Context object passed to generator `schema`, `operation`, and `operations` methods.\n *\n * The adapter is always defined (guaranteed by `runPluginAstHooks`) so no runtime checks\n * are needed. `ctx.options` carries resolved per-node options after exclude/include/override\n * filtering for individual schema/operation calls, or plugin-level options for operations.\n */\nexport type GeneratorContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {\n  config: Config\n  /**\n   * Absolute path to the current plugin's output directory.\n   */\n  root: string\n  /**\n   * Determine output mode based on the output config.\n   * Returns `'single'` when `output.path` is a file, `'split'` for a directory.\n   */\n  getMode: (output: { path: string }) => 'single' | 'split'\n  driver: KubbDriver\n  /**\n   * Get a plugin by name, typed via `Kubb.PluginRegistry` when registered.\n   */\n  getPlugin<TName extends keyof Kubb.PluginRegistry>(name: TName): Plugin<Kubb.PluginRegistry[TName]> | undefined\n  getPlugin(name: string): Plugin | undefined\n  /**\n   * Get a plugin by name, throws an error if not found.\n   */\n  requirePlugin<TName extends keyof Kubb.PluginRegistry>(name: TName): Plugin<Kubb.PluginRegistry[TName]>\n  requirePlugin(name: string): Plugin\n  /**\n   * Get a resolver by plugin name, typed via `Kubb.PluginRegistry` when registered.\n   */\n  getResolver<TName extends keyof Kubb.PluginRegistry>(name: TName): Kubb.PluginRegistry[TName]['resolver']\n  getResolver(name: string): Resolver\n  /**\n   * Add files only if they don't exist.\n   */\n  addFile: (...file: Array<FileNode>) => Promise<void>\n  /**\n   * Merge sources into the same output file.\n   */\n  upsertFile: (...file: Array<FileNode>) => Promise<void>\n  hooks: AsyncEventEmitter<KubbHooks>\n  /**\n   * The current plugin instance.\n   */\n  plugin: Plugin<TOptions>\n  /**\n   * The current plugin's resolver.\n   */\n  resolver: TOptions['resolver']\n  /**\n   * The current plugin's transformer.\n   */\n  transformer: Visitor | undefined\n  /**\n   * Emit a warning.\n   */\n  warn: (message: string) => void\n  /**\n   * Emit an error.\n   */\n  error: (error: string | Error) => void\n  /**\n   * Emit an info message.\n   */\n  info: (message: string) => void\n  /**\n   * Open the current input node in Kubb Studio.\n   */\n  openInStudio: (options?: DevtoolsOptions) => Promise<void>\n  /**\n   * The configured adapter instance.\n   */\n  adapter: Adapter\n  /**\n   * Document metadata from the adapter — title, version, base URL, and pre-computed\n   * schema index fields (`circularNames`, `enumNames`).\n   */\n  meta: InputMeta\n  /**\n   * Resolved options after exclude/include/override filtering.\n   */\n  options: TOptions['resolvedOptions']\n}\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 `meta` (document metadata),\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 `meta` (document metadata),\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 `meta` (document metadata),\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 { AsyncEventEmitter } from '@internals/utils'\nimport type { logLevel } from './constants.ts'\nimport type { KubbHooks } from './types.ts'\n\nexport type LoggerOptions = {\n  /**\n   * Log level for output verbosity.\n   * @default 3\n   */\n  logLevel: (typeof logLevel)[keyof typeof logLevel]\n}\n\n/**\n * Shared context passed to plugins, parsers, and other internals.\n */\nexport type LoggerContext = AsyncEventEmitter<KubbHooks>\n\nexport type Logger<TOptions extends LoggerOptions = LoggerOptions, TInstallReturn = void> = {\n  name: string\n  install: (context: LoggerContext, options?: TOptions) => TInstallReturn | Promise<TInstallReturn>\n}\n\nexport type UserLogger<TOptions extends LoggerOptions = LoggerOptions, TInstallReturn = void> = Logger<TOptions, TInstallReturn>\n\n/**\n * Wraps a logger definition into a typed {@link Logger}.\n *\n * The optional second type parameter `TInstallReturn` allows loggers to return\n * a value from `install` — for example, a sink factory that the caller can\n * forward to hook execution.\n *\n * @example Basic logger\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 *\n * @example Logger that returns a hook sink factory\n * ```ts\n * export const myLogger = defineLogger<LoggerOptions, HookSinkFactory>({\n *   name: 'my-logger',\n *   install(context, options) {\n *     // … register event handlers …\n *     return (commandWithArgs) => ({ onStdout: console.log })\n *   },\n * })\n * ```\n */\nexport function defineLogger<Options extends LoggerOptions = LoggerOptions, TInstallReturn = void>(\n  logger: UserLogger<Options, TInstallReturn>,\n): Logger<Options, TInstallReturn> {\n  return logger\n}\n","import type { KubbHooks } from './types.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): 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 { 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"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["DEFAULT_EXTENSION","DEFAULT_BANNER","DEFAULT_STUDIO_URL","#userConfig","AsyncEventEmitter","#storage","#driver","#config","KubbDriver","#configLogs","URLPath","BuildError"],"sources":["../../../internals/utils/src/fs.ts","../src/createAdapter.ts","../package.json","../src/createStorage.ts","../src/storages/fsStorage.ts","../src/createKubb.ts","../src/createRenderer.ts","../src/defineGenerator.ts","../src/defineLogger.ts","../src/defineMiddleware.ts","../src/defineParser.ts","../src/storages/memoryStorage.ts"],"sourcesContent":["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","import type { PossiblePromise } from '@internals/utils'\nimport type { ImportNode, InputNode, InputStreamNode, SchemaNode } from '@kubb/ast'\n\n/**\n * Source data passed to an adapter's `parse` function.\n * Mirrors the config input shape with paths resolved to absolute.\n */\nexport type AdapterSource = { type: 'path'; path: string } | { type: 'data'; data: string | unknown } | { type: 'paths'; paths: Array<string> }\n\n/**\n * Generic type parameters for an adapter definition.\n *\n * - `TName` — unique identifier (e.g. `'oas'`, `'asyncapi'`)\n * - `TOptions` — user-facing options passed to the adapter factory\n * - `TResolvedOptions` — options after defaults applied\n * - `TDocument` — type of the parsed source document\n */\nexport type AdapterFactoryOptions<\n  TName extends string = string,\n  TOptions extends object = object,\n  TResolvedOptions extends object = TOptions,\n  TDocument = unknown,\n> = {\n  name: TName\n  options: TOptions\n  resolvedOptions: TResolvedOptions\n  document: TDocument\n}\n\n/**\n * Adapter that converts input files or data into an `InputNode`.\n *\n * Adapters parse different schema formats (OpenAPI, AsyncAPI, Drizzle, etc.) into Kubb's\n * universal intermediate representation that all plugins consume.\n *\n * @example\n * ```ts\n * import { adapterOas } from '@kubb/adapter-oas'\n *\n * export default defineConfig({\n *   adapter: adapterOas(),\n *   input: { path: './openapi.yaml' },\n *   plugins: [pluginTs(), pluginZod()],\n * })\n * ```\n */\nexport type Adapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptions> = {\n  /**\n   * Human-readable adapter identifier (e.g. `'oas'`, `'asyncapi'`).\n   */\n  name: TOptions['name']\n  /**\n   * Resolved adapter options after defaults have been applied.\n   */\n  options: TOptions['resolvedOptions']\n  /**\n   * Parsed source document after the first `parse()` call. `null` before parsing.\n   */\n  document: TOptions['document'] | null\n  /**\n   * Parse the source into a universal `InputNode`.\n   */\n  parse: (source: AdapterSource) => PossiblePromise<InputNode>\n  /**\n   * Extract `ImportNode` entries for a schema tree.\n   * Returns an empty array before the first `parse()` call.\n   *\n   * The `resolve` callback receives the collision-corrected schema name and must\n   * return `{ name, path }` for the import, or `undefined` to skip it.\n   */\n  getImports: (node: SchemaNode, resolve: (schemaName: string) => { name: string; path: string }) => Array<ImportNode>\n  /**\n   * Validate the document at the given path or URL.\n   */\n  validate: (input: string, options?: { throwOnError?: boolean }) => Promise<void>\n  /**\n   * Memory-efficient streaming variant of `parse()`.\n   *\n   * Returns an `InputStreamNode` whose `schemas` and `operations` are `AsyncIterable`.\n   * Each `for await` loop creates a fresh parse pass over the cached in-memory document —\n   * no pre-built arrays are held in memory.\n   */\n  stream?: (source: AdapterSource) => Promise<InputStreamNode>\n}\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","","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 * 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      return false\n    }\n  },\n  async getItem(key: string) {\n    try {\n      return await readFile(resolve(key), 'utf8')\n    } catch (_error) {\n      return null\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 resolvedBase = resolve(base ?? process.cwd())\n\n    async function* walk(dir: string, prefix: string): AsyncGenerator<string, void, undefined> {\n      let entries: Array<Dirent>\n      try {\n        entries = (await readdir(dir, {\n          withFileTypes: true,\n        })) as Array<Dirent>\n      } catch (_error) {\n        return\n      }\n      for (const entry of entries) {\n        const rel = prefix ? `${prefix}/${entry.name}` : entry.name\n        if (entry.isDirectory()) {\n          yield* walk(join(dir, entry.name), rel)\n        } else {\n          yield rel\n        }\n      }\n    }\n\n    const keys: Array<string> = []\n    for await (const key of walk(resolvedBase, '')) {\n      keys.push(key)\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 { resolve } from 'node:path'\nimport { version as nodeVersion } from 'node:process'\nimport type { PossiblePromise } from '@internals/utils'\nimport { AsyncEventEmitter, BuildError, exists, URLPath } from '@internals/utils'\nimport type { FileNode, InputMeta, OperationNode, SchemaNode } from '@kubb/ast'\nimport { version as KubbVersion } from '../package.json'\nimport { DEFAULT_BANNER, DEFAULT_EXTENSION, DEFAULT_STUDIO_URL } from './constants.ts'\nimport type { Adapter } from './createAdapter.ts'\nimport type { RendererFactory } from './createRenderer.ts'\nimport { createStorage, type Storage } from './createStorage.ts'\nimport type { GeneratorContext } from './defineGenerator.ts'\nimport type { Middleware } from './defineMiddleware.ts'\nimport type { Parser } from './defineParser.ts'\nimport type { KubbPluginEndContext, KubbPluginSetupContext, KubbPluginStartContext, Plugin } from './definePlugin.ts'\n\nimport { KubbDriver } from './KubbDriver.ts'\nimport { fsStorage } from './storages/fsStorage.ts'\n\n/**\n * Safely extracts a type from a registry, returning `{}` if the key doesn't exist.\n * Enables optional interface augmentation for `Kubb.ConfigOptionsRegistry` and `Kubb.PluginOptionsRegistry`\n * without requiring changes to core.\n *\n * @internal\n */\ntype ExtractRegistryKey<T, K extends PropertyKey> = K extends keyof T ? T[K] : {}\n\n/**\n * Reference to an input file to generate code from.\n *\n * Specify an absolute path or a path relative to the config file location.\n * The adapter will parse this file (e.g., OpenAPI YAML or JSON) into the universal AST.\n */\nexport type InputPath = {\n  /**\n   * Path to your Swagger/OpenAPI file, absolute or relative to the config file location.\n   *\n   * @example\n   * ```ts\n   * { path: './petstore.yaml' }\n   * { path: '/absolute/path/to/openapi.json' }\n   * ```\n   */\n  path: string\n}\n\n/**\n * Inline input data to generate code from.\n *\n * Useful when you want to pass the specification directly instead of from a file.\n * Can be a string (YAML/JSON) or a parsed object.\n */\nexport type InputData = {\n  /**\n   * Swagger/OpenAPI data as a string (YAML/JSON) or a parsed object.\n   *\n   * @example\n   * ```ts\n   * { data: fs.readFileSync('./openapi.yaml', 'utf8') }\n   * { data: { openapi: '3.1.0', info: { ... } } }\n   * ```\n   */\n  data: string | unknown\n}\n\ntype Input = InputPath | InputData\n\n/**\n * Build configuration for Kubb code generation.\n *\n * The Config is the main entry point for customizing how Kubb generates code. It specifies:\n * - What to generate from (adapter + input)\n * - Where to output generated code (output)\n * - How to generate (plugins + middleware)\n * - Runtime details (parsers, storage, renderer)\n *\n * See `UserConfig` for a relaxed version with sensible defaults.\n *\n * @private\n */\nexport type Config<TInput = Input> = {\n  /**\n   * Display name for this configuration in CLI output and logs.\n   * Useful when running multiple builds with `defineConfig` arrays.\n   *\n   * @example\n   * ```ts\n   * name: 'api-client'\n   * ```\n   */\n  name?: string\n  /**\n   * Project root directory, absolute or relative to the config file.\n   * @default process.cwd()\n   */\n  root: string\n  /**\n   * Parsers that convert generated files to strings.\n   * Each parser handles specific extensions (e.g. `.ts`, `.tsx`).\n   * A fallback parser is appended for unhandled extensions.\n   * When omitted, defaults to `parserTs` from `@kubb/parser-ts`.\n   *\n   * @default [parserTs] from `@kubb/parser-ts`\n   * @example\n   * ```ts\n   * import { parserTs, tsxParser } from '@kubb/parser-ts'\n   * export default defineConfig({\n   *   parsers: [parserTs, tsxParser],\n   * })\n   * ```\n   */\n  parsers: Array<Parser>\n  /**\n   * Adapter that parses input files into the universal AST representation.\n   * Use `@kubb/adapter-oas` for OpenAPI/Swagger or `@kubb/adapter-asyncapi` for other formats.\n   *\n   * When omitted, Kubb runs in plugin-only mode: `kubb:plugin:setup` fires and files\n   * injected via `injectFile` are written, but no AST walk occurs and generator hooks\n   * (`kubb:generate:schema`, `kubb:generate:operation`) are never emitted.\n   *\n   * @example\n   * ```ts\n   * import { adapterOas } from '@kubb/adapter-oas'\n   * export default defineConfig({\n   *   adapter: adapterOas(),\n   *   input: { path: './petstore.yaml' },\n   * })\n   * ```\n   */\n  adapter?: Adapter\n  /**\n   * Source file or data to generate code from.\n   * Use `input.path` for a file path or `input.data` for inline data.\n   * Required when an adapter is configured; omit when running in plugin-only mode.\n   */\n  input?: TInput\n  output: {\n    /**\n     * Output directory for generated files, absolute or relative to `root`.\n     *\n     * All generated files will be written under this directory. Subdirectories can be created\n     * by plugins based on grouping strategy (by tag, path, etc.).\n     *\n     * @example\n     * ```ts\n     * output: {\n     *   path: './src/gen',  // generates ./src/gen/api.ts, ./src/gen/types.ts, etc.\n     * }\n     * ```\n     */\n    path: string\n    /**\n     * Remove all files from the output directory before starting the build.\n     *\n     * Useful to ensure old generated files aren't mixed with new ones.\n     * Set to `true` for fresh builds, `false` to preserve manual edits in output dir.\n     *\n     * @default false\n     * @example\n     * ```ts\n     * clean: true  // wipes ./src/gen/* before generating\n     * ```\n     */\n    clean?: boolean\n    /**\n     * Auto-format generated files after code generation completes.\n     *\n     * Applies a code formatter to all generated files. Use `'auto'` to detect which formatter\n     * is available on your system. Pass `false` to skip formatting (useful for CI or specific workflows).\n     *\n     * @default false\n     * @example\n     * ```ts\n     * format: 'auto'        // auto-detect prettier, biome, or oxfmt\n     * format: 'prettier'    // force prettier\n     * format: false         // skip formatting\n     * ```\n     */\n    format?: 'auto' | 'prettier' | 'biome' | 'oxfmt' | false\n    /**\n     * Auto-lint generated files after code generation completes.\n     *\n     * Analyzes all generated files for style/correctness issues. Use `'auto'` to detect which linter\n     * is available on your system. Pass `false` to skip linting.\n     *\n     * @default false\n     * @example\n     * ```ts\n     * lint: 'auto'      // auto-detect oxlint, biome, or eslint\n     * lint: 'eslint'    // force eslint\n     * lint: false       // skip linting\n     * ```\n     */\n    lint?: 'auto' | 'eslint' | 'biome' | 'oxlint' | false\n    /**\n     * Map file extensions to different output extensions.\n     *\n     * Useful when you want generated `.ts` imports to reference `.js` files or vice versa (e.g., for ESM dual packages).\n     * Keys are the original extension, values are the output extension. Use empty string `''` to omit extension.\n     *\n     * @default { '.ts': '.ts' }\n     * @example\n     * ```ts\n     * extension: { '.ts': '.js' }      // generates import './api.js' instead of './api.ts'\n     * extension: { '.ts': '', '.tsx': '.jsx' }\n     * ```\n     */\n    extension?: Record<FileNode['extname'], FileNode['extname'] | ''>\n    /**\n     * Banner text prepended to every generated file.\n     *\n     * Useful for auto-generation notices or license headers. Choose a preset or write custom text.\n     * Use `'simple'` for a basic Kubb banner, `'full'` for detailed metadata, or `false` to omit.\n     *\n     * @default 'simple'\n     * @example\n     * ```ts\n     * defaultBanner: 'simple'   // \"This file was autogenerated by Kubb\"\n     * defaultBanner: 'full'     // adds source, title, description, API version\n     * defaultBanner: false      // no banner\n     * ```\n     */\n    defaultBanner?: 'simple' | 'full' | false\n    /**\n     * When `true`, overwrites existing files. When `false`, skips generated files that already exist.\n     *\n     * Individual plugins can override this setting. This is useful for preventing accidental data loss\n     * when re-generating while you have local edits in the output folder.\n     *\n     * @default false\n     * @example\n     * ```ts\n     * override: true   // regenerate everything, even existing files\n     * override: false  // skip files that already exist\n     * ```\n     */\n    override?: boolean\n  } & ExtractRegistryKey<Kubb.ConfigOptionsRegistry, 'output'>\n  /**\n   * Storage backend that controls where and how generated files are persisted.\n   *\n   * Defaults to `fsStorage()` which writes to the file system. Pass `memoryStorage()` to keep files in RAM,\n   * or implement a custom `Storage` interface to write to cloud storage, databases, or other backends.\n   *\n   * @default fsStorage()\n   * @example\n   * ```ts\n   * import { memoryStorage } from '@kubb/core'\n   *\n   * // Keep generated files in memory (useful for testing, CI pipelines)\n   * storage: memoryStorage()\n   *\n   * // Use custom S3 storage\n   * storage: myS3Storage()\n   * ```\n   *\n   * @see {@link Storage} interface for implementing custom backends.\n   */\n  storage: Storage\n  /**\n   * Plugins that execute during the build to generate code and transform the AST.\n   *\n   * Each plugin processes the AST produced by the adapter and can emit files for different\n   * programming languages or formats (TypeScript, Zod schemas, Faker data, etc.).\n   * Dependencies are enforced — an error is thrown if a plugin requires another plugin that isn't registered.\n   *\n   * Plugins can declare their own options via `PluginFactoryOptions`. See plugin documentation for details.\n   *\n   * @example\n   * ```ts\n   * import { pluginTs } from '@kubb/plugin-ts'\n   * import { pluginZod } from '@kubb/plugin-zod'\n   *\n   * plugins: [\n   *   pluginTs({ output: { path: './src/gen' } }),\n   *   pluginZod({ output: { path: './src/gen' } }),\n   * ]\n   * ```\n   */\n  plugins: Array<Plugin>\n  /**\n   * Middleware instances that observe build events and post-process generated code.\n   *\n   * Middleware fires AFTER all plugins for each event. Perfect for tasks like:\n   * - Auditing what was generated\n   * - Adding barrel/index files\n   * - Validating output\n   * - Running custom transformations\n   *\n   * @example\n   * ```ts\n   * import { middlewareBarrel } from '@kubb/middleware-barrel'\n   *\n   * middleware: [middlewareBarrel()]\n   * ```\n   *\n   * @see {@link defineMiddleware} to create custom middleware.\n   */\n  middleware?: Array<Middleware>\n  /**\n   * Renderer that converts generated AST nodes to code strings.\n   *\n   * By default, Kubb uses the JSX renderer (`rendererJsx`). Pass a custom renderer to support\n   * different output formats (template engines, code generation DSLs, etc.).\n   *\n   * @default rendererJsx()  // from @kubb/renderer-jsx\n   * @example\n   * ```ts\n   * import { rendererJsx } from '@kubb/renderer-jsx'\n   * renderer: rendererJsx()\n   * ```\n   *\n   * @see {@link Renderer} to implement a custom renderer.\n   */\n  renderer?: RendererFactory\n  /**\n   * Kubb Studio cloud integration settings.\n   *\n   * Kubb Studio (https://kubb.studio) is a web-based IDE for managing API specs and generated code.\n   * Set to `true` to enable with default settings, or pass an object to customize the Studio URL.\n   *\n   * @default false  // disabled by default\n   * @example\n   * ```ts\n   * devtools: true                                   // use default Kubb Studio\n   * devtools: { studioUrl: 'https://my-studio.dev' } // custom Studio instance\n   * ```\n   */\n  devtools?:\n    | true\n    | {\n        /**\n         * Override the Kubb Studio base URL.\n         * @default 'https://kubb.studio'\n         */\n        studioUrl?: typeof DEFAULT_STUDIO_URL | (string & {})\n      }\n  /**\n   * Lifecycle hooks that execute during or after the build process.\n   *\n   * Hooks allow you to run external tools (prettier, eslint, custom scripts) based on build events.\n   * Currently supports the `done` hook which fires after all plugins and middleware complete.\n   *\n   * @example\n   * ```ts\n   * hooks: {\n   *   done: 'prettier --write \"./src/gen\"',      // auto-format generated files\n   *   // or multiple commands:\n   *   done: ['prettier --write \"./src/gen\"', 'eslint --fix \"./src/gen\"']\n   * }\n   * ```\n   */\n  hooks?: {\n    /**\n     * Command(s) to run after all plugins and middleware complete generation.\n     *\n     * Useful for post-processing: formatting, linting, copying files, or custom validation.\n     * Pass a single command string or array of command strings to run sequentially.\n     * Commands are executed relative to the `root` directory.\n     *\n     * @example\n     * ```ts\n     * done: 'prettier --write \"./src/gen\"'\n     * done: ['prettier --write \"./src/gen\"', 'eslint --fix \"./src/gen\"']\n     * ```\n     */\n    done?: string | Array<string>\n  }\n}\n\n/**\n * Partial `Config` for user-facing entry points with sensible defaults.\n *\n * `UserConfig` is what you pass to `defineConfig()`. It has optional `root`, `plugins`, `parsers`, and `adapter`\n * fields (which fall back to sensible defaults). All other Config options are available, including `output`, `input`,\n * `storage`, `middleware`, `renderer`, `devtools`, and `hooks`.\n *\n * @example\n * ```ts\n * export default defineConfig({\n *   input: { path: './petstore.yaml' },\n *   output: { path: './src/gen' },\n *   plugins: [pluginTs(), pluginZod()],\n * })\n * ```\n */\nexport type UserConfig<TInput = Input> = Omit<Config<TInput>, 'root' | 'plugins' | 'parsers' | 'adapter' | 'storage'> & {\n  /**\n   * Project root directory, absolute or relative to the config file location.\n   * @default process.cwd()\n   */\n  root?: string\n  /**\n   * Custom parsers that convert generated AST nodes to strings (TypeScript, JSON, markdown, etc.).\n   * @default [parserTs]  // from `@kubb/parser-ts`\n   */\n  parsers?: Array<Parser>\n  /**\n   * Adapter that parses your API specification into Kubb's universal AST.\n   * When omitted, Kubb runs in plugin-only mode.\n   */\n  adapter?: Adapter\n  /**\n   * Plugins that execute during the build to generate code and transform the AST.\n   * @default []\n   */\n  plugins?: Array<Plugin>\n  /**\n   * Storage backend that controls where and how generated files are persisted.\n   * @default fsStorage()\n   */\n  storage?: Storage\n}\n\ndeclare global {\n  namespace Kubb {\n    /**\n     * Registry that maps plugin names to their `PluginFactoryOptions`.\n     * Augment this interface in each plugin's `types.ts` to enable automatic\n     * typing for `getPlugin` and `requirePlugin`.\n     *\n     * @example\n     * ```ts\n     * // packages/plugin-ts/src/types.ts\n     * declare global {\n     *   namespace Kubb {\n     *     interface PluginRegistry {\n     *       'plugin-ts': PluginTs\n     *     }\n     *   }\n     * }\n     * ```\n     */\n    interface PluginRegistry {}\n\n    /**\n     * Extension point for root `Config['output']` options.\n     * Augment the `output` key in middleware or plugin packages to add extra fields\n     * to the global output configuration without touching core types.\n     *\n     * @example\n     * ```ts\n     * // packages/middleware-barrel/src/types.ts\n     * declare global {\n     *   namespace Kubb {\n     *     interface ConfigOptionsRegistry {\n     *       output: {\n     *         barrel?: import('./types.ts').BarrelConfig | false\n     *       }\n     *     }\n     *   }\n     * }\n     * ```\n     */\n    interface ConfigOptionsRegistry {}\n\n    /**\n     * Extension point for per-plugin `Output` options.\n     * Augment the `output` key in middleware or plugin packages to add extra fields\n     * to the per-plugin output configuration without touching core types.\n     *\n     * @example\n     * ```ts\n     * // packages/middleware-barrel/src/types.ts\n     * declare global {\n     *   namespace Kubb {\n     *     interface PluginOptionsRegistry {\n     *       output: {\n     *         barrel?: import('./types.ts').PluginBarrelConfig | false\n     *       }\n     *     }\n     *   }\n     * }\n     * ```\n     */\n    interface PluginOptionsRegistry {}\n  }\n}\n\n/**\n * Lifecycle events emitted during Kubb code generation.\n * Attach listeners before calling `setup()` or `build()` to observe and react to build progress.\n *\n * @example\n * ```ts\n * kubb.hooks.on('kubb:lifecycle:start', () => {\n *   console.log('Starting Kubb generation')\n * })\n *\n * kubb.hooks.on('kubb:plugin:end', ({ plugin, duration }) => {\n *   console.log(`${plugin.name} completed in ${duration}ms`)\n * })\n * ```\n */\nexport interface KubbHooks {\n  'kubb:lifecycle:start': [ctx: KubbLifecycleStartContext]\n  'kubb:lifecycle:end': []\n  'kubb:config:start': []\n  'kubb:config:end': [ctx: KubbConfigEndContext]\n  'kubb:generation:start': [ctx: KubbGenerationStartContext]\n  'kubb:generation:end': [ctx: KubbGenerationEndContext]\n  'kubb:generation:summary': [ctx: KubbGenerationSummaryContext]\n  'kubb:format:start': []\n  'kubb:format:end': []\n  'kubb:lint:start': []\n  'kubb:lint:end': []\n  'kubb:hooks:start': []\n  'kubb:hooks:end': []\n  'kubb:hook:start': [ctx: KubbHookStartContext]\n  'kubb:hook:end': [ctx: KubbHookEndContext]\n  'kubb:version:new': [ctx: KubbVersionNewContext]\n  'kubb:info': [ctx: KubbInfoContext]\n  'kubb:error': [ctx: KubbErrorContext]\n  'kubb:success': [ctx: KubbSuccessContext]\n  'kubb:warn': [ctx: KubbWarnContext]\n  'kubb:debug': [ctx: KubbDebugContext]\n  'kubb:files:processing:start': [ctx: KubbFilesProcessingStartContext]\n  'kubb:files:processing:update': [ctx: KubbFilesProcessingUpdateContext]\n  'kubb:files:processing:end': [ctx: KubbFilesProcessingEndContext]\n  'kubb:plugin:start': [ctx: KubbPluginStartContext]\n  'kubb:plugin:end': [ctx: KubbPluginEndContext]\n  'kubb:plugin:setup': [ctx: KubbPluginSetupContext]\n  'kubb:build:start': [ctx: KubbBuildStartContext]\n  'kubb:plugins:end': [ctx: KubbPluginsEndContext]\n  'kubb:build:end': [ctx: KubbBuildEndContext]\n  'kubb:generate:schema': [node: SchemaNode, ctx: GeneratorContext]\n  'kubb:generate:operation': [node: OperationNode, ctx: GeneratorContext]\n  'kubb:generate:operations': [nodes: Array<OperationNode>, ctx: GeneratorContext]\n}\n\nexport type KubbBuildStartContext = {\n  /**\n   * Resolved configuration for this build.\n   */\n  config: Config\n  /**\n   * Adapter that parsed the input into the universal AST.\n   */\n  adapter: Adapter\n  /**\n   * Metadata about the parsed document (title, version, base URL, circular schema names, enum names).\n   * To observe individual schemas and operations use the `kubb:generate:schema` / `kubb:generate:operation` hooks.\n   */\n  meta: InputMeta | undefined\n  /**\n   * Looks up a registered plugin by name, typed by the plugin registry.\n   */\n  getPlugin<TName extends keyof Kubb.PluginRegistry>(name: TName): Plugin<Kubb.PluginRegistry[TName]> | undefined\n  getPlugin(name: string): Plugin | undefined\n  /**\n   * Snapshot of all files accumulated so far.\n   */\n  readonly files: ReadonlyArray<FileNode>\n  /**\n   * Adds or merges one or more files into the file manager.\n   */\n  upsertFile: (...files: Array<FileNode>) => void\n}\n\nexport type KubbPluginsEndContext = {\n  /**\n   * Resolved configuration for this build.\n   */\n  config: Config\n  /**\n   * Snapshot of all files accumulated across all plugins.\n   */\n  readonly files: ReadonlyArray<FileNode>\n  /**\n   * Adds or merges one or more files into the file manager.\n   */\n  upsertFile: (...files: Array<FileNode>) => void\n}\n\nexport type KubbBuildEndContext = {\n  /**\n   * All files generated during this build.\n   */\n  files: Array<FileNode>\n  /**\n   * Resolved configuration for this build.\n   */\n  config: Config\n  /**\n   * Absolute path to the output directory.\n   */\n  outputDir: string\n}\n\nexport type KubbLifecycleStartContext = {\n  /**\n   * Current Kubb version string.\n   */\n  version: string\n}\n\nexport type KubbConfigEndContext = {\n  /**\n   * All resolved configs after defaults are applied.\n   */\n  configs: Array<Config>\n}\n\nexport type KubbGenerationStartContext = {\n  /**\n   * Resolved configuration for this generation run.\n   */\n  config: Config\n}\n\nexport type KubbGenerationEndContext = {\n  /**\n   * Resolved configuration for this generation run.\n   */\n  config: Config\n  /**\n   * Read-only view of the files written during this build.\n   * Reads go directly to `config.storage` — nothing extra is held in memory.\n   *\n   * @example Read a generated file\n   * `const code = await storage.getItem('/src/gen/pet.ts')`\n   *\n   * @example Walk every generated file\n   * ```ts\n   * for (const path of await storage.getKeys()) {\n   *   const code = await storage.getItem(path)\n   * }\n   * ```\n   */\n  storage: Storage\n}\n\nexport type KubbGenerationSummaryContext = {\n  /**\n   * Resolved configuration for this generation run.\n   */\n  config: Config\n  /**\n   * Plugins that threw during generation, paired with their errors.\n   */\n  failedPlugins: Set<{ plugin: Plugin; error: Error }>\n  /**\n   * `'success'` when all plugins completed without errors, `'failed'` otherwise.\n   */\n  status: 'success' | 'failed'\n  /**\n   * High-resolution start time from `process.hrtime()`.\n   */\n  hrStart: [number, number]\n  /**\n   * Total number of files created during this run.\n   */\n  filesCreated: number\n  /**\n   * Elapsed milliseconds per plugin, keyed by plugin name.\n   */\n  pluginTimings?: Map<Plugin['name'], number>\n}\n\nexport type KubbVersionNewContext = {\n  /**\n   * The installed Kubb version.\n   */\n  currentVersion: string\n  /**\n   * The newest available version on npm.\n   */\n  latestVersion: string\n}\n\nexport type KubbInfoContext = {\n  /**\n   * Human-readable info message.\n   */\n  message: string\n  /**\n   * Optional supplementary detail.\n   */\n  info?: string\n}\n\nexport type KubbErrorContext = {\n  /**\n   * The caught error.\n   */\n  error: Error\n  /**\n   * Optional structured metadata for additional context.\n   */\n  meta?: Record<string, unknown>\n}\n\nexport type KubbSuccessContext = {\n  /**\n   * Human-readable success message.\n   */\n  message: string\n  /**\n   * Optional supplementary detail.\n   */\n  info?: string\n}\n\nexport type KubbWarnContext = {\n  /**\n   * Human-readable warning message.\n   */\n  message: string\n  /**\n   * Optional supplementary detail.\n   */\n  info?: string\n}\n\nexport type KubbDebugContext = {\n  /**\n   * Timestamp when the debug entry was created.\n   */\n  date: Date\n  /**\n   * One or more log lines to emit.\n   */\n  logs: Array<string>\n  /**\n   * Optional source file name associated with this entry.\n   */\n  fileName?: string\n}\n\nexport type KubbFilesProcessingStartContext = {\n  /**\n   * Files about to be serialised and written.\n   */\n  files: Array<FileNode>\n}\n\nexport type KubbFileProcessingUpdate = {\n  /**\n   * Number of files processed so far in this batch.\n   */\n  processed: number\n  /**\n   * Total number of files in this batch.\n   */\n  total: number\n  /**\n   * Completion percentage (`0`–`100`).\n   */\n  percentage: number\n  /**\n   * Serialised file content, or `undefined` when the file produced no output.\n   */\n  source?: string\n  /**\n   * The file that was just processed.\n   */\n  file: FileNode\n  /**\n   * Resolved configuration for this build.\n   */\n  config: Config\n}\n\nexport type KubbFilesProcessingUpdateContext = {\n  /**\n   * All files processed in this flush chunk.\n   */\n  files: Array<KubbFileProcessingUpdate>\n}\n\nexport type KubbFilesProcessingEndContext = {\n  /**\n   * All files that were serialised in this batch.\n   */\n  files: Array<FileNode>\n}\n\nexport type KubbHookStartContext = {\n  /**\n   * Optional identifier for correlating start/end events.\n   */\n  id?: string\n  /**\n   * The shell command that is about to run.\n   */\n  command: string\n  /**\n   * Parsed argument list, when available.\n   */\n  args?: readonly string[]\n}\n\nexport type KubbHookEndContext = {\n  /**\n   * Optional identifier matching the corresponding `kubb:hook:start` event.\n   */\n  id?: string\n  /**\n   * The shell command that ran.\n   */\n  command: string\n  /**\n   * Parsed argument list, when available.\n   */\n  args?: readonly string[]\n  /**\n   * `true` when the command exited with code `0`.\n   */\n  success: boolean\n  /**\n   * Error thrown by the command, or `null` on success.\n   */\n  error: Error | null\n}\n\n/**\n * CLI options derived from command-line flags.\n */\nexport type CLIOptions = {\n  /**\n   * Path to the Kubb config file.\n   */\n  config?: string\n  /**\n   * Re-run generation whenever input files change.\n   */\n  watch?: boolean\n  /**\n   * Controls how much output the CLI prints.\n   *\n   * @default 'silent'\n   */\n  logLevel?: 'silent' | 'info' | 'debug'\n}\n\n/**\n * All accepted forms of a Kubb configuration.\n * Accepts `Config`/`Config[]`/promise or a factory (optionally receiving `TCliOptions`.\n */\nexport type PossibleConfig<TCliOptions = undefined> =\n  | PossiblePromise<Config | Config[]>\n  | ((...args: [TCliOptions] extends [undefined] ? [] : [TCliOptions]) => PossiblePromise<Config | Config[]>)\n\n/**\n * Full output produced by a successful or failed build.\n */\nexport type BuildOutput = {\n  /**\n   * Plugins that threw during generation, paired with their errors.\n   */\n  failedPlugins: Set<{ plugin: Plugin; error: Error }>\n  /**\n   * All files generated during this build.\n   */\n  files: Array<FileNode>\n  /**\n   * The plugin driver that orchestrated this build.\n   */\n  driver: KubbDriver\n  /**\n   * Elapsed milliseconds per plugin, keyed by plugin name.\n   */\n  pluginTimings: Map<string, number>\n  /**\n   * Top-level error when the build threw before completing, otherwise `undefined`.\n   */\n  error?: Error\n  /**\n   * Read-only view of every file written during this build.\n   * Reads go straight to `config.storage` — nothing extra is held in memory.\n   *\n   * @example Read a generated file\n   * `const code = await buildOutput.storage.getItem('/src/gen/pet.ts')`\n   *\n   * @example List all generated file paths\n   * `const paths = await buildOutput.storage.getKeys()`\n   */\n  storage: Storage\n}\n\n/**\n * Builds a `Storage` view scoped to the file paths produced by the current build.\n * Reads delegate to the underlying `storage` so source bytes stay where they were\n * written; writes register the key so subsequent reads and `getKeys` are scoped\n * to this build's output.\n */\nfunction createSourcesView(storage: Storage): Storage {\n  const paths = new Set<string>()\n\n  return createStorage(() => ({\n    name: `${storage.name}:sources`,\n    async hasItem(key: string) {\n      return paths.has(key) && (await storage.hasItem(key))\n    },\n    async getItem(key: string) {\n      return paths.has(key) ? storage.getItem(key) : null\n    },\n    async setItem(key: string, value: string) {\n      paths.add(key)\n      await storage.setItem(key, value)\n    },\n    async removeItem(key: string) {\n      paths.delete(key)\n      await storage.removeItem(key)\n    },\n    async getKeys(base?: string) {\n      if (!base) return [...paths]\n      const result: Array<string> = []\n      for (const key of paths) {\n        if (key.startsWith(base)) result.push(key)\n      }\n      return result\n    },\n    async clear() {\n      paths.clear()\n      await storage.clear()\n    },\n  }))()\n}\n\nfunction resolveConfig(userConfig: UserConfig): Config {\n  return {\n    ...userConfig,\n    root: userConfig.root || process.cwd(),\n    parsers: userConfig.parsers ?? [],\n    output: {\n      format: false,\n      lint: false,\n      extension: DEFAULT_EXTENSION,\n      defaultBanner: DEFAULT_BANNER,\n      ...userConfig.output,\n    },\n    storage: userConfig.storage ?? fsStorage(),\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\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\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> & { input: InputPath }\nexport function isInputPath(config: Config | undefined): config is Config<InputPath> & { input: InputPath }\nexport function isInputPath(config: Config | UserConfig | undefined): config is (Config<InputPath> | UserConfig<InputPath>) & { input: InputPath } {\n  return typeof config?.input === 'object' && config.input !== null && 'path' in config.input\n}\n\ntype CreateKubbOptions = {\n  hooks?: AsyncEventEmitter<KubbHooks>\n}\n\n/**\n * Kubb code-generation instance bound to a single config entry. Resolves the user\n * config during `setup()` and shares `hooks`, `storage`, `driver`, and `config` across\n * the `setup → build` lifecycle.\n *\n * Attach event listeners to `.hooks` before calling `setup()` or `build()`.\n *\n * @example\n * ```ts\n * const kubb = createKubb(userConfig)\n * kubb.hooks.on('kubb:plugin:end', ({ plugin, duration }) => console.log(plugin.name, duration))\n * const { files, failedPlugins } = await kubb.safeBuild()\n * ```\n */\nexport class Kubb {\n  readonly hooks: AsyncEventEmitter<KubbHooks>\n  readonly #userConfig: UserConfig\n  #config: Config | null = null\n  #driver: KubbDriver | null = null\n  #storage: Storage | null = null\n\n  constructor(userConfig: UserConfig, options: CreateKubbOptions = {}) {\n    this.#userConfig = userConfig\n    this.hooks = options.hooks ?? new AsyncEventEmitter<KubbHooks>()\n  }\n\n  get storage(): Storage {\n    if (!this.#storage) throw new Error('[kubb] setup() must be called before accessing storage')\n    return this.#storage\n  }\n\n  get driver(): KubbDriver {\n    if (!this.#driver) throw new Error('[kubb] setup() must be called before accessing driver')\n    return this.#driver\n  }\n\n  get config(): Config {\n    if (!this.#config) throw new Error('[kubb] setup() must be called before accessing config')\n    return this.#config\n  }\n\n  /**\n   * Resolves config and initializes the driver. `build()` calls this automatically.\n   */\n  async setup(): Promise<void> {\n    const config = resolveConfig(this.#userConfig)\n    const driver = new KubbDriver(config, { hooks: this.hooks })\n    const storage = createSourcesView(config.storage)\n\n    await this.hooks.emit('kubb:debug', { date: new Date(), logs: this.#configLogs(config) })\n\n    if (isInputPath(this.#userConfig) && !new URLPath(this.#userConfig.input.path).isURL) {\n      try {\n        await exists(this.#userConfig.input.path)\n        await this.hooks.emit('kubb:debug', { date: new Date(), logs: [`✓ Input file validated: ${this.#userConfig.input.path}`] })\n      } catch (caughtError) {\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 ${this.#userConfig.input.path}`,\n          { cause: caughtError as Error },\n        )\n      }\n    }\n\n    if (config.output.clean) {\n      await this.hooks.emit('kubb:debug', { date: new Date(), logs: ['Cleaning output directories', `  • Output: ${config.output.path}`] })\n      await config.storage.clear(resolve(config.root, config.output.path))\n    }\n\n    await driver.setup()\n\n    this.#config = config\n    this.#driver = driver\n    this.#storage = storage\n  }\n\n  /**\n   * Runs the full pipeline and throws on any plugin error.\n   * Automatically calls `setup()` if needed.\n   */\n  async build(): Promise<BuildOutput> {\n    const out = await this.safeBuild()\n    if (out.error) throw out.error\n    if (out.failedPlugins.size > 0) {\n      const errors = [...out.failedPlugins].map(({ error }) => error)\n      throw new BuildError(`Build Error with ${out.failedPlugins.size} failed plugins`, { errors })\n    }\n    return out\n  }\n\n  /**\n   * Runs the full pipeline and captures errors in `BuildOutput` instead of throwing.\n   * Automatically calls `setup()` if needed.\n   */\n  async safeBuild(): Promise<BuildOutput> {\n    if (!this.#driver) await this.setup()\n    using cleanup = this\n    const driver = cleanup.driver\n    const storage = cleanup.storage\n    const { failedPlugins, pluginTimings, error } = await driver.run({ storage })\n    return { failedPlugins, files: driver.fileManager.files, driver, pluginTimings, storage, ...(error ? { error } : {}) }\n  }\n\n  dispose(): void {\n    this.#driver?.dispose()\n  }\n\n  [Symbol.dispose](): void {\n    this.dispose()\n  }\n\n  #configLogs(config: Config): Array<string> {\n    const u = this.#userConfig\n    const diag = getDiagnosticInfo()\n    return [\n      'Configuration:',\n      `  • Name: ${u.name || 'unnamed'}`,\n      `  • Root: ${u.root || process.cwd()}`,\n      `  • Output: ${u.output?.path || 'not specified'}`,\n      `  • Plugins: ${u.plugins?.length || 0}`,\n      'Output Settings:',\n      `  • Storage: ${config.storage.name}`,\n      `  • Formatter: ${u.output?.format || 'none'}`,\n      `  • Linter: ${u.output?.lint || 'none'}`,\n      `Running adapter: ${config.adapter?.name || 'none'}`,\n      'Environment:',\n      Object.entries(diag)\n        .map(([key, value]) => `  • ${key}: ${value}`)\n        .join('\\n'),\n    ]\n  }\n}\n\n/**\n * Factory for {@link Kubb}. Equivalent to `new Kubb(userConfig, options)` and kept\n * as the canonical public entry point.\n */\nexport function createKubb(userConfig: UserConfig, options: CreateKubbOptions = {}): Kubb {\n  return new Kubb(userConfig, options)\n}\n","import type { FileNode } from '@kubb/ast'\n\n/**\n * Minimal interface any Kubb renderer must satisfy.\n *\n * `TElement` is the type the renderer accepts, for example `KubbReactElement`\n * for `@kubb/renderer-jsx` or a custom type for your own renderer. Defaults to\n * `unknown` so generators that don't care about the element type work without\n * specifying it.\n */\nexport type Renderer<TElement = unknown> = {\n  /**\n   * Renders `element` and populates {@link files} with the resulting {@link FileNode} objects.\n   * Called once per render cycle; must resolve before {@link files} is read.\n   */\n  render(element: TElement): Promise<void>\n  /**\n   * Tears down the renderer and releases any held resources.\n   * Pass an `Error` to signal a failure, a number for an exit code, or omit for a clean shutdown.\n   */\n  unmount(error?: Error | number | null): void\n  /**\n   * Releases any held resources. `[Symbol.dispose]` delegates here.\n   */\n  dispose(): void\n  /**\n   * Accumulated {@link FileNode} results produced by the last {@link render} call.\n   * Not populated when {@link stream} is implemented.\n   */\n  readonly files: Array<FileNode>\n  /**\n   * When present, core calls this instead of {@link render} and {@link files},\n   * forwarding each file to `FileManager` as soon as it is ready.\n   */\n  stream?(element: TElement): Iterable<FileNode>\n  /**\n   * Disposer hook so renderers participate in `using` blocks: `using r = rendererFactory()`\n   * guarantees {@link dispose} runs on every exit path, including thrown errors.\n   */\n  [Symbol.dispose](): void\n}\n\n/**\n * A factory function that produces a fresh {@link Renderer} per render cycle.\n *\n * Generators use this to declare which renderer handles their output.\n */\nexport type RendererFactory<TElement = unknown> = () => Renderer<TElement>\n\n/**\n * Wraps a renderer factory for use in generator definitions.\n *\n * @example\n * ```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 *     dispose() { runtime.unmount() },\n *     unmount(error) { runtime.unmount(error) },\n *   }\n * })\n * ```\n */\nexport function createRenderer<TElement = unknown>(factory: RendererFactory<TElement>): RendererFactory<TElement> {\n  return factory\n}\n","import type { AsyncEventEmitter, PossiblePromise } from '@internals/utils'\nimport type { FileNode, InputMeta, OperationNode, SchemaNode, Visitor } from '@kubb/ast'\nimport type { Adapter } from './createAdapter.ts'\nimport type { RendererFactory } from './createRenderer.ts'\nimport type { KubbHooks } from './types.ts'\nimport type { KubbDriver } from './KubbDriver.ts'\nimport type { Plugin, PluginFactoryOptions } from './definePlugin.ts'\nimport type { Resolver } from './defineResolver.ts'\nimport type { Config, DevtoolsOptions } from './types.ts'\n\n/**\n * Context object passed to generator `schema`, `operation`, and `operations` methods.\n *\n * The adapter is always defined (guaranteed by `runPluginAstHooks`) so no runtime checks\n * are needed. `ctx.options` carries resolved per-node options after exclude/include/override\n * filtering for individual schema/operation calls, or plugin-level options for operations.\n */\nexport type GeneratorContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {\n  config: Config\n  /**\n   * Absolute path to the current plugin's output directory.\n   */\n  root: string\n  /**\n   * Determine output mode based on the output config.\n   * Returns `'single'` when `output.path` is a file, `'split'` for a directory.\n   */\n  getMode: (output: { path: string }) => 'single' | 'split'\n  driver: KubbDriver\n  /**\n   * Get a plugin by name, typed via `Kubb.PluginRegistry` when registered.\n   */\n  getPlugin<TName extends keyof Kubb.PluginRegistry>(name: TName): Plugin<Kubb.PluginRegistry[TName]> | undefined\n  getPlugin(name: string): Plugin | undefined\n  /**\n   * Get a plugin by name, throws an error if not found.\n   */\n  requirePlugin<TName extends keyof Kubb.PluginRegistry>(name: TName): Plugin<Kubb.PluginRegistry[TName]>\n  requirePlugin(name: string): Plugin\n  /**\n   * Get a resolver by plugin name, typed via `Kubb.PluginRegistry` when registered.\n   */\n  getResolver<TName extends keyof Kubb.PluginRegistry>(name: TName): Kubb.PluginRegistry[TName]['resolver']\n  getResolver(name: string): Resolver\n  /**\n   * Add files only if they don't exist.\n   */\n  addFile: (...file: Array<FileNode>) => Promise<void>\n  /**\n   * Merge sources into the same output file.\n   */\n  upsertFile: (...file: Array<FileNode>) => Promise<void>\n  hooks: AsyncEventEmitter<KubbHooks>\n  /**\n   * The current plugin instance.\n   */\n  plugin: Plugin<TOptions>\n  /**\n   * The current plugin's resolver.\n   */\n  resolver: TOptions['resolver']\n  /**\n   * The current plugin's transformer.\n   */\n  transformer: Visitor | undefined\n  /**\n   * Emit a warning.\n   */\n  warn: (message: string) => void\n  /**\n   * Emit an error.\n   */\n  error: (error: string | Error) => void\n  /**\n   * Emit an info message.\n   */\n  info: (message: string) => void\n  /**\n   * Open the current input node in Kubb Studio.\n   */\n  openInStudio: (options?: DevtoolsOptions) => Promise<void>\n  /**\n   * The configured adapter instance.\n   */\n  adapter: Adapter\n  /**\n   * Document metadata from the adapter — title, version, base URL, and pre-computed\n   * schema index fields (`circularNames`, `enumNames`).\n   */\n  meta: InputMeta\n  /**\n   * Resolved options after exclude/include/override filtering.\n   */\n  options: TOptions['resolvedOptions']\n}\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 `meta` (document metadata),\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 `meta` (document metadata),\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 `meta` (document metadata),\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 { AsyncEventEmitter } from '@internals/utils'\nimport type { logLevel } from './constants.ts'\nimport type { KubbHooks } from './types.ts'\n\nexport type LoggerOptions = {\n  /**\n   * Log level for output verbosity.\n   * @default 3\n   */\n  logLevel: (typeof logLevel)[keyof typeof logLevel]\n}\n\n/**\n * Shared context passed to plugins, parsers, and other internals.\n */\nexport type LoggerContext = AsyncEventEmitter<KubbHooks>\n\nexport type Logger<TOptions extends LoggerOptions = LoggerOptions, TInstallReturn = void> = {\n  name: string\n  install: (context: LoggerContext, options?: TOptions) => TInstallReturn | Promise<TInstallReturn>\n}\n\nexport type UserLogger<TOptions extends LoggerOptions = LoggerOptions, TInstallReturn = void> = Logger<TOptions, TInstallReturn>\n\n/**\n * Wraps a logger definition into a typed {@link Logger}.\n *\n * The optional second type parameter `TInstallReturn` allows loggers to return\n * a value from `install` — for example, a sink factory that the caller can\n * forward to hook execution.\n *\n * @example Basic logger\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 *\n * @example Logger that returns a hook sink factory\n * ```ts\n * export const myLogger = defineLogger<LoggerOptions, HookSinkFactory>({\n *   name: 'my-logger',\n *   install(context, options) {\n *     // … register event handlers …\n *     return (commandWithArgs) => ({ onStdout: console.log })\n *   },\n * })\n * ```\n */\nexport function defineLogger<Options extends LoggerOptions = LoggerOptions, TInstallReturn = void>(\n  logger: UserLogger<Options, TInstallReturn>,\n): Logger<Options, TInstallReturn> {\n  return logger\n}\n","import type { KubbHooks } from './types.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): 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 { 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"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { $ as ResolverPathParams, A as isInputPath, B as KubbPluginSetupContext, C as KubbPluginsEndContext, Ct as logLevel, D as PossibleConfig, E as KubbWarnContext, F as FileManager, G as Plugin, H as NormalizedPlugin, I as Exclude, J as ResolveBannerContext, K as PluginFactoryOptions, L as Group, M as GeneratorContext, N as defineGenerator, O as UserConfig, P as KubbDriver, Q as ResolverFileParams, R as Include, S as KubbLifecycleStartContext, St as createAdapter, T as KubbVersionNewContext, U as Output, V as KubbPluginStartContext, W as Override, X as Resolver, Y as ResolveOptionsContext, Z as ResolverContext, _ as KubbGenerationSummaryContext, _t as RendererFactory, a as InputPath, at as LoggerOptions, b as KubbHooks, bt as AdapterFactoryOptions, c as KubbBuildStartContext, ct as FileProcessor, d as KubbErrorContext, dt as Parser, et as defineResolver, f as KubbFileProcessingUpdateContext, ft as defineParser, g as KubbGenerationStartContext, gt as Renderer, h as KubbGenerationEndContext, ht as createStorage, i as InputData, it as LoggerContext, j as Generator, k as createKubb, l as KubbConfigEndContext, lt as FileProcessorEvents, m as KubbFilesProcessingStartContext, mt as Storage, n as CLIOptions, nt as defineMiddleware, o as Kubb, ot as UserLogger, p as KubbFilesProcessingEndContext, pt as DevtoolsOptions, q as definePlugin, r as Config, rt as Logger, s as KubbBuildEndContext, st as defineLogger, t as BuildOutput, tt as Middleware, u as KubbDebugContext, ut as ParsedFile, v as KubbHookEndContext, vt as createRenderer, w as KubbSuccessContext, wt as AsyncEventEmitter, x as KubbInfoContext, xt as AdapterSource, y as KubbHookStartContext, yt as Adapter, z as KubbPluginEndContext } from "./createKubb-Dcmtjqds.js";
+import { $ as ResolverFileParams, A as createKubb, B as KubbPluginEndContext, C as KubbLifecycleStartContext, Ct as createAdapter, D as KubbWarnContext, E as KubbVersionNewContext, F as KubbDriver, G as Override, H as KubbPluginStartContext, I as FileManager, J as definePlugin, K as Plugin, L as Exclude, M as Generator, N as GeneratorContext, O as PossibleConfig, P as defineGenerator, Q as ResolverContext, R as Group, S as KubbInfoContext, St as AdapterSource, T as KubbSuccessContext, Tt as AsyncEventEmitter, U as NormalizedPlugin, V as KubbPluginSetupContext, W as Output, X as ResolveOptionsContext, Y as ResolveBannerContext, Z as Resolver, _ as KubbGenerationStartContext, _t as Renderer, a as InputPath, at as LoggerContext, b as KubbHookStartContext, bt as Adapter, c as KubbBuildStartContext, ct as defineLogger, d as KubbErrorContext, dt as ParsedFile, et as ResolverPathParams, f as KubbFileProcessingUpdate, ft as Parser, g as KubbGenerationEndContext, gt as createStorage, h as KubbFilesProcessingUpdateContext, ht as Storage, i as InputData, it as Logger, j as isInputPath, k as UserConfig, l as KubbConfigEndContext, lt as FileProcessor, m as KubbFilesProcessingStartContext, mt as DevtoolsOptions, n as CLIOptions, nt as Middleware, o as Kubb, ot as LoggerOptions, p as KubbFilesProcessingEndContext, pt as defineParser, q as PluginFactoryOptions, r as Config, rt as defineMiddleware, s as KubbBuildEndContext, st as UserLogger, t as BuildOutput, tt as defineResolver, u as KubbDebugContext, ut as FileProcessorEvents, v as KubbGenerationSummaryContext, vt as RendererFactory, w as KubbPluginsEndContext, wt as logLevel, x as KubbHooks, xt as AdapterFactoryOptions, y as KubbHookEndContext, yt as createRenderer, z as Include } from "./createKubb-CYrw_xaR.js";
 import * as ast from "@kubb/ast";
 
 //#region ../../internals/utils/src/urlPath.d.ts
@@ -113,7 +113,7 @@ declare class URLPath {
     prefix,
     replacer
   }?: {
-    prefix?: string;
+    prefix?: string | null;
     replacer?: (pathParam: string) => string;
   }): string;
   /**
@@ -188,5 +188,5 @@ declare const fsStorage: (options?: Record<string, never> | undefined) => Storag
  */
 declare const memoryStorage: (options?: Record<string, never> | undefined) => Storage;
 //#endregion
-export { Adapter, AdapterFactoryOptions, AdapterSource, AsyncEventEmitter, BuildOutput, CLIOptions, Config, DevtoolsOptions, Exclude, FileManager, FileProcessor, FileProcessorEvents, Generator, GeneratorContext, Group, Include, InputData, InputPath, Kubb, KubbBuildEndContext, KubbBuildStartContext, KubbConfigEndContext, KubbDebugContext, KubbDriver, KubbErrorContext, KubbFileProcessingUpdateContext, KubbFilesProcessingEndContext, KubbFilesProcessingStartContext, KubbGenerationEndContext, KubbGenerationStartContext, KubbGenerationSummaryContext, KubbHookEndContext, KubbHookStartContext, KubbHooks, KubbInfoContext, KubbLifecycleStartContext, KubbPluginEndContext, KubbPluginSetupContext, KubbPluginStartContext, KubbPluginsEndContext, KubbSuccessContext, KubbVersionNewContext, KubbWarnContext, Logger, LoggerContext, LoggerOptions, Middleware, NormalizedPlugin, Output, Override, ParsedFile, Parser, Plugin, PluginFactoryOptions, PossibleConfig, Renderer, RendererFactory, ResolveBannerContext, ResolveOptionsContext, Resolver, ResolverContext, ResolverFileParams, ResolverPathParams, Storage, URLPath, UserConfig, UserLogger, ast, createAdapter, createKubb, createRenderer, createStorage, defineGenerator, defineLogger, defineMiddleware, defineParser, definePlugin, defineResolver, fsStorage, isInputPath, logLevel, memoryStorage };
+export { Adapter, AdapterFactoryOptions, AdapterSource, AsyncEventEmitter, BuildOutput, CLIOptions, Config, DevtoolsOptions, Exclude, FileManager, FileProcessor, FileProcessorEvents, Generator, GeneratorContext, Group, Include, InputData, InputPath, Kubb, KubbBuildEndContext, KubbBuildStartContext, KubbConfigEndContext, KubbDebugContext, KubbDriver, KubbErrorContext, KubbFileProcessingUpdate, KubbFilesProcessingEndContext, KubbFilesProcessingStartContext, KubbFilesProcessingUpdateContext, KubbGenerationEndContext, KubbGenerationStartContext, KubbGenerationSummaryContext, KubbHookEndContext, KubbHookStartContext, KubbHooks, KubbInfoContext, KubbLifecycleStartContext, KubbPluginEndContext, KubbPluginSetupContext, KubbPluginStartContext, KubbPluginsEndContext, KubbSuccessContext, KubbVersionNewContext, KubbWarnContext, Logger, LoggerContext, LoggerOptions, Middleware, NormalizedPlugin, Output, Override, ParsedFile, Parser, Plugin, PluginFactoryOptions, PossibleConfig, Renderer, RendererFactory, ResolveBannerContext, ResolveOptionsContext, Resolver, ResolverContext, ResolverFileParams, ResolverPathParams, Storage, URLPath, UserConfig, UserLogger, ast, createAdapter, createKubb, createRenderer, createStorage, defineGenerator, defineLogger, defineMiddleware, defineParser, definePlugin, defineResolver, fsStorage, isInputPath, logLevel, memoryStorage };
 //# sourceMappingURL=index.d.ts.map