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

package/dist/{createKubb-Dcmtjqds.d.ts → createKubb-CYrw_xaR.d.ts}

@@ -250,6 +250,10 @@ type Renderer<TElement = unknown> = {
    * Pass an `Error` to signal a failure, a number for an exit code, or omit for a clean shutdown.
    */
   unmount(error?: Error | number | null): void;
+  /**
+   * Releases any held resources. `[Symbol.dispose]` delegates here.
+   */
+  dispose(): void;
   /**
    * Accumulated {@link FileNode} results produced by the last {@link render} call.
    * Not populated when {@link stream} is implemented.
@@ -260,6 +264,11 @@ type Renderer<TElement = unknown> = {
    * forwarding each file to `FileManager` as soon as it is ready.
    */
   stream?(element: TElement): Iterable<FileNode>;
+  /**
+   * Disposer hook so renderers participate in `using` blocks: `using r = rendererFactory()`
+   * guarantees {@link dispose} runs on every exit path, including thrown errors.
+   */
+  [Symbol.dispose](): void;
 };
 /**
  * A factory function that produces a fresh {@link Renderer} per render cycle.
@@ -277,6 +286,7 @@ type RendererFactory<TElement = unknown> = () => Renderer<TElement>;
  *   return {
  *     async render(element) { await runtime.render(element) },
  *     get files() { return runtime.nodes },
+ *     dispose() { runtime.unmount() },
  *     unmount(error) { runtime.unmount(error) },
  *   }
  * })
@@ -439,6 +449,11 @@ declare class FileProcessor {
   }?: ParseOptions): string;
   stream(files: ReadonlyArray<FileNode>, options?: ParseOptions): Generator<ParsedFile>;
   run(files: Array<FileNode>, options?: ParseOptions): Promise<Array<FileNode>>;
+  /**
+   * Clears all registered event listeners.
+   */
+  dispose(): void;
+  [Symbol.dispose](): void;
 }
 //#endregion
 //#region src/defineLogger.d.ts
@@ -592,8 +607,8 @@ type Resolver = {
   resolveOptions<TOptions>(node: Node, context: ResolveOptionsContext<TOptions>): TOptions | null;
   resolvePath(params: ResolverPathParams, context: ResolverContext): string;
   resolveFile(params: ResolverFileParams, context: ResolverContext): FileNode;
-  resolveBanner(meta: InputMeta | undefined, context: ResolveBannerContext): string | undefined;
-  resolveFooter(meta: InputMeta | undefined, context: ResolveBannerContext): string | undefined;
+  resolveBanner(meta: InputMeta | undefined, context: ResolveBannerContext): string | null;
+  resolveFooter(meta: InputMeta | undefined, context: ResolveBannerContext): string | null;
 };
 /**
  * File-specific parameters for `Resolver.resolvePath`.
@@ -1086,45 +1101,39 @@ declare function definePlugin<TFactory extends PluginFactoryOptions = PluginFact
 //#endregion
 //#region src/FileManager.d.ts
 /**
- * In-memory file store for generated files.
- *
- * Files with the same `path` are merged — sources, imports, and exports are concatenated.
- * The `files` getter returns all stored files sorted by path length (shortest first).
+ * In-memory file store for generated files. Files sharing a `path` are merged
+ * (sources/imports/exports concatenated). The `files` getter is sorted by
+ * path length (barrel `index.ts` last within a bucket).
  *
  * @example
  * ```ts
- * import { FileManager } from '@kubb/core'
- *
  * const manager = new FileManager()
  * manager.upsert(myFile)
- * console.log(manager.files) // all stored files
+ * manager.files // sorted view
  * ```
  */
 declare class FileManager {
   #private;
   /**
-   * Adds one or more files. Incoming files with the same path are merged
-   * (sources/imports/exports concatenated), but existing cache entries are
-   * replaced — use {@link upsert} when you want to merge into the cache too.
+   * Registers a callback invoked with the resolved {@link FileNode} on every
+   * `add` / `upsert`. Used by the build loop to track newly written files
+   * without keeping its own scan-based diff. Single subscriber by design —
+   * setting again replaces the previous callback. Pass `null` to detach.
    */
+  setOnUpsert(callback: ((file: FileNode) => void) | null): void;
   add(...files: Array<FileNode>): Array<FileNode>;
-  /**
-   * Adds or merges one or more files.
-   * If a file with the same path already exists in the cache, its
-   * sources/imports/exports are merged into the incoming file.
-   */
   upsert(...files: Array<FileNode>): Array<FileNode>;
   getByPath(path: string): FileNode | null;
   deleteByPath(path: string): void;
   clear(): void;
   /**
-   * Releases all stored files. Called by the core after `kubb:build:end` to
-   * free the per-plugin FileNode caches for the rest of the process lifetime.
+   * Releases all stored files. Called by the core after `kubb:build:end`.
    */
   dispose(): void;
   [Symbol.dispose](): void;
   /**
-   * All stored files, sorted by path length (shorter paths first).
+   * All stored files in stable sort order (shortest path first, barrel files
+   * last within a length bucket). Returns a cached view — do not mutate.
    */
   get files(): Array<FileNode>;
 }
@@ -1151,8 +1160,8 @@ declare class KubbDriver {
    * The streaming `InputStreamNode` produced by the adapter.
    * Always set after adapter setup — parse-only adapters are wrapped automatically.
    */
-  inputNode: InputStreamNode | undefined;
-  adapter: Adapter | undefined;
+  inputNode: InputStreamNode | null;
+  adapter: Adapter | null;
   /**
    * Central file store for all generated files.
    * Plugins should use `this.addFile()` / `this.upsertFile()` (via their context) to
@@ -1193,6 +1202,23 @@ declare class KubbDriver {
    * for a plugin that has no static `plugin.generators`.
    */
   hasEventGenerators(pluginName: string): boolean;
+  /**
+   * Runs the full plugin pipeline. Returns timings/failures collected so far even
+   * when an outer hook throws — the orchestrator preserves partial state by capturing
+   * the error into `error` instead of propagating.
+   */
+  run({
+    storage
+  }: {
+    storage: Storage;
+  }): Promise<{
+    failedPlugins: Set<{
+      plugin: Plugin;
+      error: Error;
+    }>;
+    pluginTimings: Map<string, number>;
+    error?: Error;
+  }>;
   /**
    * Unregisters all plugin lifecycle listeners from the shared event emitter.
    * Called at the end of a build to prevent listener leaks across repeated builds.
@@ -1878,7 +1904,7 @@ interface KubbHooks {
   'kubb:warn': [ctx: KubbWarnContext];
   'kubb:debug': [ctx: KubbDebugContext];
   'kubb:files:processing:start': [ctx: KubbFilesProcessingStartContext];
-  'kubb:file:processing:update': [ctx: KubbFileProcessingUpdateContext];
+  'kubb:files:processing:update': [ctx: KubbFilesProcessingUpdateContext];
   'kubb:files:processing:end': [ctx: KubbFilesProcessingEndContext];
   'kubb:plugin:start': [ctx: KubbPluginStartContext];
   'kubb:plugin:end': [ctx: KubbPluginEndContext];
@@ -2084,7 +2110,7 @@ type KubbFilesProcessingStartContext = {
    */
   files: Array<FileNode>;
 };
-type KubbFileProcessingUpdateContext = {
+type KubbFileProcessingUpdate = {
   /**
    * Number of files processed so far in this batch.
    */
@@ -2110,6 +2136,12 @@ type KubbFileProcessingUpdateContext = {
    */
   config: Config;
 };
+type KubbFilesProcessingUpdateContext = {
+  /**
+   * All files processed in this flush chunk.
+   */
+  files: Array<KubbFileProcessingUpdate>;
+};
 type KubbFilesProcessingEndContext = {
   /**
    * All files that were serialised in this batch.
@@ -2215,59 +2247,6 @@ type BuildOutput = {
    */
   storage: Storage;
 };
-/**
- * Kubb code generation instance returned by {@link createKubb}.
- *
- * Use this when orchestrating multiple builds, inspecting plugin timings, or integrating Kubb into a larger toolchain.
- * For a single one-off build, chain directly: `await createKubb(config).build()`.
- */
-type Kubb$1 = {
-  /**
-   * Shared event emitter for lifecycle and status events. Attach listeners before calling `setup()` or `build()`.
-   */
-  readonly hooks: AsyncEventEmitter<KubbHooks>;
-  /**
-   * Read-only view of the files from the most recent `build()` or `safeBuild()` call.
-   * Only populated after the build completes.
-   *
-   * Keys are scoped to the current run. Reads go straight to `config.storage`,
-   * so nothing extra is held in memory.
-   *
-   * @example Read a generated file
-   * ```ts
-   * const { storage } = await kubb.safeBuild()
-   * const code = await storage.getItem('/src/gen/pet.ts')
-   * ```
-   *
-   * @example Walk every generated file
-   * ```ts
-   * for (const path of await kubb.storage.getKeys()) {
-   *   const code = await kubb.storage.getItem(path)
-   * }
-   * ```
-   */
-  readonly storage: Storage;
-  /**
-   * Plugin driver managing all plugins. Available after `setup()` completes.
-   */
-  readonly driver: KubbDriver;
-  /**
-   * Resolved configuration with defaults applied. Available after `setup()` completes.
-   */
-  readonly config: Config;
-  /**
-   * Resolves config and initializes the driver. `build()` calls this automatically.
-   */
-  setup(): Promise<void>;
-  /**
-   * Runs the full pipeline and throws on any plugin error. Automatically calls `setup()` if needed.
-   */
-  build(): Promise<BuildOutput>;
-  /**
-   * Runs the full pipeline and captures errors in `BuildOutput` instead of throwing. Automatically calls `setup()` if needed.
-   */
-  safeBuild(): Promise<BuildOutput>;
-};
 /**
  * Type guard to check if a given config has an `input.path`.
  */
@@ -2281,25 +2260,48 @@ type CreateKubbOptions = {
   hooks?: AsyncEventEmitter<KubbHooks>;
 };
 /**
- * Creates a Kubb instance bound to a single config entry.
+ * Kubb code-generation instance bound to a single config entry. Resolves the user
+ * config during `setup()` and shares `hooks`, `storage`, `driver`, and `config` across
+ * the `setup → build` lifecycle.
  *
- * Accepts a user-facing config shape and resolves it to a full {@link Config} during
- * `setup()`. The instance then holds shared state (`hooks`, `storage`, `driver`, `config`)
- * across the `setup → build` lifecycle. Attach event listeners to `kubb.hooks` before
- * calling `setup()` or `build()`.
+ * Attach event listeners to `.hooks` before calling `setup()` or `build()`.
  *
  * @example
  * ```ts
  * const kubb = createKubb(userConfig)
- *
- * kubb.hooks.on('kubb:plugin:end', ({ plugin, duration }) => {
- *   console.log(`${plugin.name} completed in ${duration}ms`)
- * })
- *
+ * kubb.hooks.on('kubb:plugin:end', ({ plugin, duration }) => console.log(plugin.name, duration))
  * const { files, failedPlugins } = await kubb.safeBuild()
  * ```
  */
+declare class Kubb$1 {
+  #private;
+  readonly hooks: AsyncEventEmitter<KubbHooks>;
+  constructor(userConfig: UserConfig, options?: CreateKubbOptions);
+  get storage(): Storage;
+  get driver(): KubbDriver;
+  get config(): Config;
+  /**
+   * Resolves config and initializes the driver. `build()` calls this automatically.
+   */
+  setup(): Promise<void>;
+  /**
+   * Runs the full pipeline and throws on any plugin error.
+   * Automatically calls `setup()` if needed.
+   */
+  build(): Promise<BuildOutput>;
+  /**
+   * Runs the full pipeline and captures errors in `BuildOutput` instead of throwing.
+   * Automatically calls `setup()` if needed.
+   */
+  safeBuild(): Promise<BuildOutput>;
+  dispose(): void;
+  [Symbol.dispose](): void;
+}
+/**
+ * Factory for {@link Kubb}. Equivalent to `new Kubb(userConfig, options)` and kept
+ * as the canonical public entry point.
+ */
 declare function createKubb(userConfig: UserConfig, options?: CreateKubbOptions): Kubb$1;
 //#endregion
-export { ResolverPathParams as $, isInputPath as A, KubbPluginSetupContext as B, KubbPluginsEndContext as C, logLevel as Ct, PossibleConfig as D, KubbWarnContext as E, FileManager as F, Plugin as G, NormalizedPlugin as H, Exclude as I, ResolveBannerContext as J, PluginFactoryOptions as K, Group as L, GeneratorContext as M, defineGenerator as N, UserConfig as O, KubbDriver as P, ResolverFileParams as Q, Include as R, KubbLifecycleStartContext as S, createAdapter as St, KubbVersionNewContext as T, Output as U, KubbPluginStartContext as V, Override as W, Resolver as X, ResolveOptionsContext as Y, ResolverContext as Z, KubbGenerationSummaryContext as _, RendererFactory as _t, InputPath as a, LoggerOptions as at, KubbHooks as b, AdapterFactoryOptions as bt, KubbBuildStartContext as c, FileProcessor as ct, KubbErrorContext as d, Parser as dt, defineResolver as et, KubbFileProcessingUpdateContext as f, defineParser as ft, KubbGenerationStartContext as g, Renderer as gt, KubbGenerationEndContext as h, createStorage as ht, InputData as i, LoggerContext as it, Generator$1 as j, createKubb as k, KubbConfigEndContext as l, FileProcessorEvents as lt, KubbFilesProcessingStartContext as m, Storage as mt, CLIOptions as n, defineMiddleware as nt, Kubb$1 as o, UserLogger as ot, KubbFilesProcessingEndContext as p, DevtoolsOptions as pt, definePlugin as q, Config as r, Logger as rt, KubbBuildEndContext as s, defineLogger as st, BuildOutput as t, Middleware as tt, KubbDebugContext as u, ParsedFile as ut, KubbHookEndContext as v, createRenderer as vt, KubbSuccessContext as w, AsyncEventEmitter as wt, KubbInfoContext as x, AdapterSource as xt, KubbHookStartContext as y, Adapter as yt, KubbPluginEndContext as z };
-//# sourceMappingURL=createKubb-Dcmtjqds.d.ts.map
+export { ResolverFileParams as $, createKubb as A, KubbPluginEndContext as B, KubbLifecycleStartContext as C, createAdapter as Ct, KubbWarnContext as D, KubbVersionNewContext as E, KubbDriver as F, Override as G, KubbPluginStartContext as H, FileManager as I, definePlugin as J, Plugin as K, Exclude as L, Generator$1 as M, GeneratorContext as N, PossibleConfig as O, defineGenerator as P, ResolverContext as Q, Group as R, KubbInfoContext as S, AdapterSource as St, KubbSuccessContext as T, AsyncEventEmitter as Tt, NormalizedPlugin as U, KubbPluginSetupContext as V, Output as W, ResolveOptionsContext as X, ResolveBannerContext as Y, Resolver as Z, KubbGenerationStartContext as _, Renderer as _t, InputPath as a, LoggerContext as at, KubbHookStartContext as b, Adapter as bt, KubbBuildStartContext as c, defineLogger as ct, KubbErrorContext as d, ParsedFile as dt, ResolverPathParams as et, KubbFileProcessingUpdate as f, Parser as ft, KubbGenerationEndContext as g, createStorage as gt, KubbFilesProcessingUpdateContext as h, Storage as ht, InputData as i, Logger as it, isInputPath as j, UserConfig as k, KubbConfigEndContext as l, FileProcessor as lt, KubbFilesProcessingStartContext as m, DevtoolsOptions as mt, CLIOptions as n, Middleware as nt, Kubb$1 as o, LoggerOptions as ot, KubbFilesProcessingEndContext as p, defineParser as pt, PluginFactoryOptions as q, Config as r, defineMiddleware as rt, KubbBuildEndContext as s, UserLogger as st, BuildOutput as t, defineResolver as tt, KubbDebugContext as u, FileProcessorEvents as ut, KubbGenerationSummaryContext as v, RendererFactory as vt, KubbPluginsEndContext as w, logLevel as wt, KubbHooks as x, AdapterFactoryOptions as xt, KubbHookEndContext as y, createRenderer as yt, Include as z };
+//# sourceMappingURL=createKubb-CYrw_xaR.d.ts.map