@kubb/core 5.0.0-beta.85 → 5.0.0-beta.87

package/dist/{Diagnostics-PnPLU3kj.d.ts → Diagnostics-aWJg-H2d.d.ts}

@@ -277,7 +277,7 @@ type ReporterContext = {
 };
 /**
  * Host-facing reporter, as installed onto a run. Unlike a Logger (the live TUI view), a reporter
- * never sees the event emitter. `report` runs once per config. `drain`, when present, runs once
+ * never sees the hook emitter. `report` runs once per config. `drain`, when present, runs once
  * after the last config.
  */
 type Reporter = {
@@ -309,7 +309,7 @@ type UserReporter<T = void> = {
 /**
  * Defines a reporter. When the definition has a `drain`, the returned reporter buffers each value
  * `report` returns and hands the array to `drain` once, then clears it. Without a `drain`, nothing
- * is buffered. Wiring the reporter onto the run's events is the host's job, so the reporter only
+ * is buffered. Wiring the reporter onto the run's hooks is the host's job, so the reporter only
  * ever deals with a {@link GenerationResult}.
  *
  * @example
@@ -473,7 +473,7 @@ type RendererFactory<TElement = unknown> = () => Renderer<TElement>;
  */
 declare function createRenderer<TElement = unknown>(factory: RendererFactory<TElement>): RendererFactory<TElement>;
 //#endregion
-//#region src/createResolver.d.ts
+//#region src/Resolver.d.ts
 /**
  * Context for resolving filtered options for a given operation or schema node.
  *
@@ -635,19 +635,14 @@ type ResolverBuildOptions = {
   [key: string]: unknown;
 };
 /**
- * Partial resolver fields accepted by `Resolver.merge` and `setResolver`.
+ * Partial resolver fields accepted by `Resolver.merge` and `setResolver`. Parameterize with a
+ * concrete resolver type (e.g. `ResolverPatch<ResolverTs>`) to type-check namespace overrides
+ * and bind `this` to the full resolver. The bare form accepts any resolver's fields.
  */
-type ResolverOverride = Omit<ResolverBuildOptions, 'pluginName'>;
-/**
- * The plugin-specific resolver fields handed to `createResolver`. `name` and `file` fall
- * back to the built-ins when omitted. Every method reaches sibling helpers through `this`,
- * which `ThisType` types as the full resolver.
- */
-type ResolverOptions<T extends PluginFactoryOptions> = Omit<T['resolver'], keyof Resolver> & {
-  pluginName: T['name'];
-  name?: T['resolver']['name'];
-  file?: T['resolver']['file'];
-} & ThisType<T['resolver']>;
+type ResolverPatch<T extends Resolver = Resolver> = Partial<Omit<T, keyof Resolver>> & {
+  name?: T['name'];
+  file?: T['file'];
+} & ThisType<T>;
 /**
  * Base constraint for all plugin resolver objects.
  *
@@ -687,29 +682,8 @@ declare class Resolver {
    * Merges `override` over `base` and returns a new resolver with helpers re-bound.
    * Each key is replaced wholesale. Used when applying `setResolver` partial overrides.
    */
-  static merge<T extends Resolver>(base: T, override: ResolverOverride | Resolver): T;
+  static merge<T extends Resolver>(base: T, override: ResolverPatch<T> | Resolver): T;
 }
-/**
- * Defines a plugin resolver, the object that decides what every generated symbol and file
- * path is called. Override the top-level `name` and `file` to set the plugin's conventions,
- * and add your own naming helpers, top-level (`typeName`, …) or grouped in namespaces
- * (`query`, `schema`, …). Every method reaches sibling helpers and the built-in machinery
- * through `this.name`, `this.file`, and `this.default`.
- *
- * @example Custom identifier and file casing
- * ```ts
- * export const resolverTs = createResolver<PluginTs>({
- *   pluginName: 'plugin-ts',
- *   name(name) {
- *     return ensureValidVarName(pascalCase(name))
- *   },
- *   file(params, context) {
- *     return this.default.file({ ...params, resolveName: (name) => toFilePath(name, pascalCase) }, context)
- *   },
- * })
- * ```
- */
-declare function createResolver<T extends PluginFactoryOptions>(options: ResolverOptions<T>): T['resolver'];
 //#endregion
 //#region src/definePlugin.d.ts
 type ExtractRegistryKey$1<T, K extends PropertyKey> = K extends keyof T ? T[K] : {};
@@ -970,7 +944,7 @@ type KubbPluginSetupContext<TFactory extends PluginFactoryOptions = PluginFactor
    * The resolver controls file naming and path resolution. Overrides merge over the built-in
    * defaults, so a partial `core` or a single namespace method replaces only what it names.
    */
-  setResolver(resolver: ResolverOverride): void;
+  setResolver(resolver: ResolverPatch<TFactory['resolver']> | TFactory['resolver']): void;
   /**
    * Add a macro that rewrites AST nodes before they reach generators. Macros run in the order they
    * are added, after any macros from earlier `addMacro` calls.
@@ -1034,8 +1008,8 @@ type Plugin<TFactory extends PluginFactoryOptions = PluginFactoryOptions> = {
    */
   options?: TFactory['options'];
   /**
-   * Lifecycle event handlers for this plugin.
-   * Any event from the global `KubbHooks` map can be subscribed to here.
+   * Lifecycle hook handlers for this plugin.
+   * Any hook from the global `KubbHooks` map can be subscribed to here.
    */
   hooks: { [K in keyof KubbHooks as K extends 'kubb:plugin:setup' ? never : K]?: (...args: KubbHooks[K]) => void | Promise<void> } & {
     'kubb:plugin:setup'?(ctx: KubbPluginSetupContext<TFactory>): void | Promise<void>;
@@ -1057,6 +1031,11 @@ type NormalizedPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptio
   resolver: TOptions['resolver'];
   macros?: Array<Macro>;
   generators?: Array<Generator>;
+  /**
+   * Set by the driver when the plugin registers a generator via `addGenerator()` in
+   * `kubb:plugin:setup`. Drives whether the build walks the AST for this plugin.
+   */
+  hasHookGenerators?: boolean;
   apply?: (config: Config) => boolean;
   version?: string;
 };
@@ -1162,86 +1141,99 @@ type Parser<TMeta extends object = object, TNode = unknown> = {
  */
 declare function defineParser<T extends Parser>(parser: T): T;
 //#endregion
-//#region src/asyncEventEmitter.d.ts
+//#region src/Hookable.d.ts
 /**
- * A function that can be registered as an event listener, synchronous or async.
+ * A function that can be registered as a hook listener, synchronous or async. Any return value is
+ * allowed and ignored, so handlers that return a result for their own callers still register.
  */
-type AsyncListener<TArgs extends Array<unknown>> = (...args: TArgs) => void | Promise<void>;
+type AsyncListener<TArgs extends Array<unknown>> = (...args: TArgs) => unknown;
 /**
- * Typed `EventEmitter` that awaits all async listeners before resolving.
- * Wraps Node's `EventEmitter` with full TypeScript event-map inference.
+ * Typed hook emitter that awaits all async listeners before resolving.
+ * Wraps Node's `EventEmitter` with full TypeScript hook-map inference.
  *
  * @example
  * ```ts
- * const emitter = new AsyncEventEmitter<{ build: [name: string] }>()
- * emitter.on('build', async (name) => { console.log(name) })
- * await emitter.emit('build', 'petstore') // all listeners awaited
+ * const hooks = new Hookable<{ build: [name: string] }>()
+ * hooks.hook('build', async (name) => { console.log(name) })
+ * await hooks.callHook('build', 'petstore') // all listeners awaited
  * ```
  */
-declare class AsyncEventEmitter<TEvents extends { [K in keyof TEvents]: Array<unknown> }> {
+declare class Hookable<THooks extends { [K in keyof THooks]: Array<unknown> }> {
   #private;
   /**
-   * Maximum number of listeners per event before Node emits a memory-leak warning.
+   * Maximum number of listeners per hook before Node emits a memory-leak warning.
    * @default 10
    */
   constructor(maxListener?: number);
   /**
-   * Emits `eventName` and awaits all registered listeners sequentially.
-   * Throws if any listener rejects, wrapping the cause with the event name and serialized arguments.
+   * Calls `hookName` and awaits all registered listeners sequentially.
+   * Throws if any listener rejects, wrapping the cause with the hook name and serialized arguments.
    *
    * @example
    * ```ts
-   * await emitter.emit('build', 'petstore')
+   * await hooks.callHook('build', 'petstore')
    * ```
    */
-  emit<TEventName extends keyof TEvents & string>(eventName: TEventName, ...eventArgs: TEvents[TEventName]): Promise<void> | void;
+  callHook<THookName extends keyof THooks & string>(hookName: THookName, ...hookArgs: THooks[THookName]): Promise<void> | void;
   /**
-   * Registers a persistent listener for `eventName`.
+   * Registers a persistent listener for `hookName` and returns a function that removes it.
    *
    * @example
    * ```ts
-   * emitter.on('build', async (name) => { console.log(name) })
+   * const unhook = hooks.hook('build', async (name) => { console.log(name) })
+   * unhook() // removes it
    * ```
    */
-  on<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void;
+  hook<THookName extends keyof THooks & string>(hookName: THookName, handler: AsyncListener<THooks[THookName]>): () => void;
+  /**
+   * Registers every handler in `configHooks` at once and returns a function that removes them
+   * all. Undefined entries are skipped, so a partial hook object registers only its present keys.
+   *
+   * @example
+   * ```ts
+   * const unhook = hooks.addHooks({ build: onBuild, done: onDone })
+   * unhook() // removes both
+   * ```
+   */
+  addHooks(configHooks: Partial<{ [K in keyof THooks & string]: AsyncListener<THooks[K]> }>): () => void;
   /**
    * Removes a previously registered listener.
    *
    * @example
    * ```ts
-   * emitter.off('build', handler)
+   * hooks.removeHook('build', handler)
    * ```
    */
-  off<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: AsyncListener<TEvents[TEventName]>): void;
+  removeHook<THookName extends keyof THooks & string>(hookName: THookName, handler: AsyncListener<THooks[THookName]>): void;
   /**
-   * Returns the number of listeners registered for `eventName`.
+   * Returns the number of listeners registered for `hookName`.
    *
    * @example
    * ```ts
-   * emitter.on('build', handler)
-   * emitter.listenerCount('build') // 1
+   * hooks.hook('build', handler)
+   * hooks.listenerCount('build') // 1
    * ```
    */
-  listenerCount<TEventName extends keyof TEvents & string>(eventName: TEventName): number;
+  listenerCount<THookName extends keyof THooks & string>(hookName: THookName): number;
   /**
-   * Raises or lowers the per-event listener ceiling before Node warns about a memory leak.
+   * Raises or lowers the per-hook listener ceiling before Node warns about a memory leak.
    * Set this above the expected listener count when many listeners attach by design.
    *
    * @example
    * ```ts
-   * emitter.setMaxListeners(40)
+   * hooks.setMaxListeners(40)
    * ```
    */
   setMaxListeners(max: number): void;
   /**
-   * Removes all listeners from every event channel.
+   * Removes all listeners from every hook channel.
    *
    * @example
    * ```ts
-   * emitter.removeAll()
+   * hooks.removeAllHooks()
    * ```
    */
-  removeAll(): void;
+  removeAllHooks(): void;
 }
 //#endregion
 //#region src/FileManager.d.ts
@@ -1282,7 +1274,7 @@ type WriteOptions = ParseOptions & {
  */
 declare class FileManager {
   #private;
-  readonly hooks: AsyncEventEmitter<FileManagerHooks>;
+  readonly hooks: Hookable<FileManagerHooks>;
   add(...files: Array<FileNode>): Array<FileNode>;
   upsert(...files: Array<FileNode>): Array<FileNode>;
   clear(): void;
@@ -1316,7 +1308,7 @@ declare class FileManager {
 //#endregion
 //#region src/KubbDriver.d.ts
 type Options = {
-  hooks: AsyncEventEmitter<KubbHooks>;
+  hooks: Hookable<KubbHooks>;
 };
 type RequirePluginContext = {
   /**
@@ -1349,16 +1341,16 @@ declare class KubbDriver {
    * so `run` can parse it later.
    */
   setup(): Promise<void>;
-  get hooks(): AsyncEventEmitter<KubbHooks>;
+  get hooks(): Hookable<KubbHooks>;
   /**
-   * Emits the `kubb:plugin:setup` event so that all registered hook-style plugin listeners
-   * can configure generators, resolvers, macros and renderers before `buildStart` runs.
-   *
-   * Called once from `run` before the plugin execution loop begins.
+   * Runs each plugin's `kubb:plugin:setup` handler, in plugin order, with a context scoped to that
+   * plugin so `addGenerator`, `setResolver`, `addMacro`, `setMacros`, and `setOptions` target its
+   * `NormalizedPlugin` entry. Called once from `run` before the plugin execution loop begins, so
+   * plugins can configure generators, resolvers, macros, and options before `buildStart`.
    */
-  emitSetupHooks(): Promise<void>;
+  setupHooks(): Promise<void>;
   /**
-   * Registers a generator for the given plugin on the shared event emitter.
+   * Registers a generator for the given plugin on the shared hook emitter.
    *
    * The generator's `schema`, `operation`, and `operations` methods are registered as
    * listeners on `kubb:generate:schema`, `kubb:generate:operation`, and `kubb:generate:operations`
@@ -1375,10 +1367,10 @@ declare class KubbDriver {
    * Returns `true` when at least one generator was registered for the given plugin
    * via `addGenerator()` in `kubb:plugin:setup`.
    *
-   * Used by the build loop to decide whether to walk the AST and emit generator events
+   * Used by the build loop to decide whether to walk the AST and emit generator hooks
    * for a plugin.
    */
-  hasEventGenerators(pluginName: string): boolean;
+  hasHookGenerators(pluginName: string): boolean;
   /**
    * Runs the full plugin pipeline. Returns the diagnostics collected so far even
    * when an outer hook throws, since the orchestrator preserves partial state by capturing
@@ -1424,7 +1416,7 @@ declare class KubbDriver {
    * Also mirrors it onto `plugin.resolver` so callers using `getPlugin(name).resolver`
    * get the up-to-date resolver without going through `getResolver()`.
    */
-  setPluginResolver(pluginName: string, partial: ResolverOverride): void;
+  setPluginResolver(pluginName: string, partial: ResolverPatch | Resolver): void;
   /**
    * Returns the resolver for the given plugin.
    *
@@ -1490,10 +1482,10 @@ type GeneratorContext<TOptions extends PluginFactoryOptions = PluginFactoryOptio
    */
   upsertFile: (...file: Array<FileNode>) => Promise<void>;
   /**
-   * The build's event bus. Emit or listen to any `KubbHooks` event, for example to react to
+   * The build's hook bus. Emit or listen to any `KubbHooks` hook, for example to react to
    * `kubb:build:end` from inside a generator.
    */
-  hooks: AsyncEventEmitter<KubbHooks>;
+  hooks: Hookable<KubbHooks>;
   /**
    * The current plugin instance.
    */
@@ -1642,7 +1634,7 @@ declare function defineGenerator<TOptions extends PluginFactoryOptions = PluginF
 //#endregion
 //#region src/createKubb.d.ts
 type CreateKubbOptions = {
-  hooks?: AsyncEventEmitter<KubbHooks>;
+  hooks?: Hookable<KubbHooks>;
 };
 /**
  * Kubb code-generation instance bound to a single config entry. Resolves the user
@@ -1652,18 +1644,18 @@ type CreateKubbOptions = {
  * `createKubb` takes a plain config object (the shape `defineConfig` produces),
  * not a fluent builder.
  *
- * Attach event listeners to `.hooks` before calling `setup()` or `build()`.
+ * Attach hook 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, duration))
+ * kubb.hooks.hook('kubb:plugin:end', ({ plugin, duration }) => console.log(plugin.name, duration))
  * const { files, diagnostics } = await kubb.safeBuild()
  * ```
  */
 declare class Kubb$1 {
   #private;
-  readonly hooks: AsyncEventEmitter<KubbHooks>;
+  readonly hooks: Hookable<KubbHooks>;
   readonly config: Config;
   constructor(userConfig: UserConfig, options?: CreateKubbOptions);
   get storage(): Storage;
@@ -1922,7 +1914,7 @@ type Config<TInput = Input> = {
    */
   plugins: Array<Plugin>;
   /**
-   * Lifecycle hooks that run external tools (prettier, eslint, a custom script) on build events.
+   * Lifecycle hooks that run external tools (prettier, eslint, a custom script) at points in the build.
    *
    * Currently supports the `done` hook, which fires after all plugins complete.
    *
@@ -2081,16 +2073,16 @@ declare global {
   }
 }
 /**
- * Lifecycle events emitted during Kubb code generation.
+ * Lifecycle hooks emitted during Kubb code generation.
  * Attach listeners before calling `setup()` or `build()` to observe and react to build progress.
  *
  * @example
  * ```ts
- * kubb.hooks.on('kubb:lifecycle:start', () => {
+ * kubb.hooks.hook('kubb:lifecycle:start', () => {
  *   console.log('Starting Kubb generation')
  * })
  *
- * kubb.hooks.on('kubb:plugin:end', ({ plugin, duration }) => {
+ * kubb.hooks.hook('kubb:plugin:end', ({ plugin, duration }) => {
  *   console.log(`${plugin.name} completed in ${duration}ms`)
  * })
  * ```
@@ -2326,7 +2318,7 @@ type KubbFilesProcessingEndContext = {
 };
 type KubbHookStartContext = {
   /**
-   * Optional identifier for correlating start/end events.
+   * Optional identifier for correlating start/end hooks.
    */
   id?: string;
   /**
@@ -2344,7 +2336,7 @@ type KubbHookStartContext = {
  */
 type KubbHookLineContext = {
   /**
-   * Identifier matching the corresponding `kubb:hook:start` event.
+   * Identifier matching the corresponding `kubb:hook:start` hook.
    */
   id: string;
   /**
@@ -2354,7 +2346,7 @@ type KubbHookLineContext = {
 };
 type KubbHookEndContext = {
   /**
-   * Optional identifier matching the corresponding `kubb:hook:start` event.
+   * Optional identifier matching the corresponding `kubb:hook:start` hook.
    */
   id?: string;
   /**
@@ -2707,11 +2699,11 @@ declare class Diagnostics {
    */
   static report(diagnostic: Diagnostic): boolean;
   /**
-   * Emits a diagnostic on the run's `kubb:diagnostic` event so the loggers render it live.
-   * Use it instead of calling `hooks.emit('kubb:diagnostic', ...)` directly. To collect a
+   * Emits a diagnostic on the run's `kubb:diagnostic` hook so the loggers render it live.
+   * Use it instead of calling `hooks.callHook('kubb:diagnostic', ...)` directly. To collect a
    * diagnostic into the build result from deep in a run, use {@link Diagnostics.report} instead.
    */
-  static emit(hooks: AsyncEventEmitter<KubbHooks>, diagnostic: ProblemDiagnostic | UpdateDiagnostic): Promise<void>;
+  static emit(hooks: Hookable<KubbHooks>, diagnostic: ProblemDiagnostic | UpdateDiagnostic): Promise<void>;
   /**
    * Coerces any thrown value into a {@link ProblemDiagnostic}. A {@link Diagnostics.Error}
    * keeps its structured data, and anything else becomes a `KUBB_UNKNOWN` error.
@@ -2797,5 +2789,5 @@ declare class Diagnostics {
   static formatLines(diagnostic: Diagnostic): Array<string>;
 }
 //#endregion
-export { Include as $, KubbHookStartContext as A, ReporterName as At, Kubb$1 as B, KubbFilesProcessingEndContext as C, RendererFactory as Ct, KubbGenerationStartContext as D, GenerationResult as Dt, KubbGenerationEndContext as E, createStorage as Et, KubbSuccessContext as F, AdapterFactoryOptions as Ft, KubbDriver as G, Generator as H, KubbWarnContext as I, AdapterSource as It, Parser as J, FileManagerHooks as K, PossibleConfig as L, createAdapter as Lt, KubbInfoContext as M, createReporter as Mt, KubbLifecycleStartContext as N, logLevel as Nt, KubbHookEndContext as O, Reporter as Ot, KubbPluginsEndContext as P, Adapter as Pt, Group as Q, UserConfig as R, KubbFileProcessingUpdate as S, Renderer as St, KubbFilesProcessingUpdateContext as T, Storage as Tt, GeneratorContext as U, createKubb as V, defineGenerator as W, Exclude$1 as X, defineParser as Y, Filter as Z, InputPath as _, ResolverDefault as _t, DiagnosticLocation as a, OutputMode as at, KubbDiagnosticContext as b, ResolverPathParams as bt, PerformanceDiagnostic as c, Plugin as ct, SerializedDiagnostic as d, BannerMeta as dt, KubbPluginEndContext as et, UpdateDiagnostic as f, ResolveBannerContext as ft, InputData as g, ResolverContext as gt, Config as h, Resolver as ht, DiagnosticKind as i, Output as it, KubbHooks as j, UserReporter as jt, KubbHookLineContext as k, ReporterContext as kt, ProblemCode as l, PluginFactoryOptions as lt, CLIOptions as m, ResolveOptionsContext as mt, DiagnosticByCode as n, KubbPluginStartContext as nt, DiagnosticSeverity as o, OutputOptions as ot, BuildOutput as p, ResolveBannerFile as pt, AsyncEventEmitter as q, DiagnosticDoc as r, NormalizedPlugin as rt, Diagnostics as s, Override as st, Diagnostic as t, KubbPluginSetupContext as tt, ProblemDiagnostic as u, definePlugin as ut, KubbBuildEndContext as v, ResolverFileParams as vt, KubbFilesProcessingStartContext as w, createRenderer as wt, KubbErrorContext as x, createResolver as xt, KubbBuildStartContext as y, ResolverOverride as yt, CreateKubbOptions as z };
-//# sourceMappingURL=Diagnostics-PnPLU3kj.d.ts.map
+export { Include as $, KubbHookStartContext as A, UserReporter as At, Kubb$1 as B, KubbFilesProcessingEndContext as C, createRenderer as Ct, KubbGenerationStartContext as D, Reporter as Dt, KubbGenerationEndContext as E, GenerationResult as Et, KubbSuccessContext as F, AdapterSource as Ft, KubbDriver as G, Generator as H, KubbWarnContext as I, createAdapter as It, Parser as J, FileManagerHooks as K, PossibleConfig as L, KubbInfoContext as M, logLevel as Mt, KubbLifecycleStartContext as N, Adapter as Nt, KubbHookEndContext as O, ReporterContext as Ot, KubbPluginsEndContext as P, AdapterFactoryOptions as Pt, Group as Q, UserConfig as R, KubbFileProcessingUpdate as S, RendererFactory as St, KubbFilesProcessingUpdateContext as T, createStorage as Tt, GeneratorContext as U, createKubb as V, defineGenerator as W, Exclude$1 as X, defineParser as Y, Filter as Z, InputPath as _, ResolverDefault as _t, DiagnosticLocation as a, OutputMode as at, KubbDiagnosticContext as b, ResolverPathParams as bt, PerformanceDiagnostic as c, Plugin as ct, SerializedDiagnostic as d, BannerMeta as dt, KubbPluginEndContext as et, UpdateDiagnostic as f, ResolveBannerContext as ft, InputData as g, ResolverContext as gt, Config as h, Resolver as ht, DiagnosticKind as i, Output as it, KubbHooks as j, createReporter as jt, KubbHookLineContext as k, ReporterName as kt, ProblemCode as l, PluginFactoryOptions as lt, CLIOptions as m, ResolveOptionsContext as mt, DiagnosticByCode as n, KubbPluginStartContext as nt, DiagnosticSeverity as o, OutputOptions as ot, BuildOutput as p, ResolveBannerFile as pt, Hookable as q, DiagnosticDoc as r, NormalizedPlugin as rt, Diagnostics as s, Override as st, Diagnostic as t, KubbPluginSetupContext as tt, ProblemDiagnostic as u, definePlugin as ut, KubbBuildEndContext as v, ResolverFileParams as vt, KubbFilesProcessingStartContext as w, Storage as wt, KubbErrorContext as x, Renderer as xt, KubbBuildStartContext as y, ResolverPatch as yt, CreateKubbOptions as z };
+//# sourceMappingURL=Diagnostics-aWJg-H2d.d.ts.map