@kubb/core 5.0.0-alpha.43 → 5.0.0-alpha.45

package/dist/{types-BJX_uR-y.d.ts → types-BUgxQiWY.d.ts}

@@ -387,37 +387,8 @@ declare class FileManager {
 }
 //#endregion
 //#region src/PluginDriver.d.ts
-type RequiredPluginLifecycle = Required<PluginLifecycle>;
-/**
- * Hook dispatch strategy used by the `PluginDriver`.
- *
- * - `hookFirst` — stops at the first non-null result.
- * - `hookForPlugin` — calls only the matching plugin.
- * - `hookParallel` — calls all plugins concurrently.
- * - `hookSeq` — calls all plugins in order, threading the result.
- */
-type Strategy = 'hookFirst' | 'hookForPlugin' | 'hookParallel' | 'hookSeq';
-type ParseResult<H extends PluginLifecycleHooks> = RequiredPluginLifecycle[H];
-type SafeParseResult<H extends PluginLifecycleHooks, Result = ReturnType<ParseResult<H>>> = {
-  result: Result;
-  plugin: Plugin;
-};
 type Options = {
-  hooks?: AsyncEventEmitter<KubbHooks>;
-  /**
-   * @default Number.POSITIVE_INFINITY
-   */
-  concurrency?: number;
-};
-/**
- * Parameters accepted by `PluginDriver.getFile` to resolve a generated file descriptor.
- */
-type GetFileOptions<TOptions = object> = {
-  name: string;
-  mode?: 'single' | 'split';
-  extname: FileNode['extname'];
-  pluginName: string;
-  options?: TOptions;
+  hooks: AsyncEventEmitter<KubbHooks>;
 };
 declare class PluginDriver {
   #private;
@@ -445,7 +416,7 @@ declare class PluginDriver {
    * add files; this property gives direct read/write access when needed.
    */
   readonly fileManager: FileManager;
-  readonly plugins: Map<string, Plugin>;
+  readonly plugins: Map<string, NormalizedPlugin>;
   constructor(config: Config, options: Options);
   get hooks(): AsyncEventEmitter<KubbHooks>;
   /**
@@ -460,8 +431,10 @@ declare class PluginDriver {
    *
    * External tooling can subscribe to any of these events via `hooks.on(...)` to observe
    * the plugin lifecycle without modifying plugin behavior.
+   *
+   * @internal
    */
-  registerPluginHooks(hookPlugin: HookStylePlugin, normalizedPlugin: Plugin): void;
+  registerPluginHooks(hookPlugin: Plugin, normalizedPlugin: NormalizedPlugin): void;
   /**
    * Emits the `kubb:plugin:setup` event so that all registered hook-style plugin listeners
    * can configure generators, resolvers, transformers and renderers before `buildStart` runs.
@@ -492,98 +465,27 @@ declare class PluginDriver {
    * for a plugin that has no static `plugin.generators`.
    */
   hasRegisteredGenerators(pluginName: string): boolean;
+  /**
+   * Unregisters all plugin lifecycle listeners from the shared event emitter.
+   * Called at the end of a build to prevent listener leaks across repeated builds.
+   *
+   * @internal
+   */
   dispose(): void;
+  /**
+   * Merges `partial` with the plugin's default resolver and stores the result.
+   * 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: Partial<Resolver>): void;
-  getResolver(pluginName: string): Resolver;
-  getContext<TOptions extends PluginFactoryOptions>(plugin: Plugin<TOptions>): PluginContext<TOptions> & Record<string, unknown>;
-  /**
-   * @deprecated use resolvers context instead
-   */
-  getFile<TOptions = object>({
-    name,
-    mode,
-    extname,
-    pluginName,
-    options
-  }: GetFileOptions<TOptions>): FileNode<{
-    pluginName: string;
-  }>;
   /**
-   * @deprecated use resolvers context instead
-   */
-  resolvePath: <TOptions = object>(params: ResolvePathParams<TOptions>) => string;
-  /**
-   * @deprecated use resolvers context instead
-   */
-  resolveName: (params: ResolveNameParams) => string;
-  /**
-   * Run a specific hookName for plugin x.
-   */
-  hookForPlugin<H extends PluginLifecycleHooks>({
-    pluginName,
-    hookName,
-    parameters
-  }: {
-    pluginName: string;
-    hookName: H;
-    parameters: PluginParameter<H>;
-  }): Promise<Array<ReturnType<ParseResult<H>> | null>>;
-  /**
-   * Run a specific hookName for plugin x.
-   */
-  hookForPluginSync<H extends PluginLifecycleHooks>({
-    pluginName,
-    hookName,
-    parameters
-  }: {
-    pluginName: string;
-    hookName: H;
-    parameters: PluginParameter<H>;
-  }): Array<ReturnType<ParseResult<H>>> | null;
-  /**
-   * Returns the first non-null result.
-   */
-  hookFirst<H extends PluginLifecycleHooks>({
-    hookName,
-    parameters,
-    skipped
-  }: {
-    hookName: H;
-    parameters: PluginParameter<H>;
-    skipped?: ReadonlySet<Plugin> | null;
-  }): Promise<SafeParseResult<H>>;
-  /**
-   * Returns the first non-null result.
-   */
-  hookFirstSync<H extends PluginLifecycleHooks>({
-    hookName,
-    parameters,
-    skipped
-  }: {
-    hookName: H;
-    parameters: PluginParameter<H>;
-    skipped?: ReadonlySet<Plugin> | null;
-  }): SafeParseResult<H> | null;
-  /**
-   * Runs all plugins in parallel based on `this.plugin` order and `dependencies` settings.
-   */
-  hookParallel<H extends PluginLifecycleHooks, TOutput = void>({
-    hookName,
-    parameters
-  }: {
-    hookName: H;
-    parameters?: Parameters<RequiredPluginLifecycle[H]> | undefined;
-  }): Promise<Awaited<TOutput>[]>;
-  /**
-   * Execute a lifecycle hook sequentially for all plugins that implement it.
-   */
-  hookSeq<H extends PluginLifecycleHooks>({
-    hookName,
-    parameters
-  }: {
-    hookName: H;
-    parameters?: PluginParameter<H>;
-  }): Promise<void>;
+   * Returns the resolver for the given plugin.
+   *
+   * Resolution order: dynamic resolver set via `setPluginResolver` → static resolver on the
+   * plugin → lazily created default resolver (identity name, no path transforms).
+   */
+  getResolver(pluginName: string): Resolver;
+  getContext<TOptions extends PluginFactoryOptions>(plugin: NormalizedPlugin<TOptions>): GeneratorContext<TOptions> & Record<string, unknown>;
   getPlugin<TName extends keyof Kubb.PluginRegistry>(pluginName: TName): Plugin<Kubb.PluginRegistry[TName]> | undefined;
   getPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(pluginName: string): Plugin<TOptions> | undefined;
   /**
@@ -647,25 +549,6 @@ type DebugInfo = {
   logs: Array<string>;
   fileName?: string;
 };
-type HookProgress<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
-  hookName: H;
-  plugins: Array<Plugin>;
-};
-type HookExecution<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
-  strategy: Strategy;
-  hookName: H;
-  plugin: Plugin;
-  parameters?: Array<unknown>;
-  output?: unknown;
-};
-type HookResult<H extends PluginLifecycleHooks = PluginLifecycleHooks> = {
-  duration: number;
-  strategy: Strategy;
-  hookName: H;
-  plugin: Plugin;
-  parameters?: Array<unknown>;
-  output?: unknown;
-};
 /**
  * The instance returned by {@link createKubb}.
  */
@@ -887,28 +770,6 @@ interface KubbHooks {
     success: boolean;
     error?: Error;
   }];
-  /**
-   * Emitted when plugin hook progress tracking starts.
-   * Contains the hook name and list of plugins to execute.
-   */
-  'kubb:plugins:hook:progress:start': [progress: HookProgress];
-  /**
-   * Emitted when plugin hook progress tracking ends.
-   * Contains the hook name that completed.
-   */
-  'kubb:plugins:hook:progress:end': [{
-    hookName: PluginLifecycleHooks;
-  }];
-  /**
-   * Emitted when a plugin hook starts processing.
-   * Contains strategy, hook name, plugin, parameters, and output.
-   */
-  'kubb:plugins:hook:processing:start': [execution: HookExecution];
-  /**
-   * Emitted when a plugin hook completes processing.
-   * Contains duration, strategy, hook name, plugin, parameters, and output.
-   */
-  'kubb:plugins:hook:processing:end': [result: HookResult];
   /**
    * Fired once — before any plugin's `buildStart` runs — so that hook-style plugins
    * can register generators, configure resolvers/transformers/renderers, or inject
@@ -950,7 +811,6 @@ interface KubbHooks {
 }
 declare global {
   namespace Kubb {
-    interface PluginContext {}
     /**
      * Registry that maps plugin names to their `PluginFactoryOptions`.
      * Augment this interface in each plugin's `types.ts` to enable automatic
@@ -974,35 +834,13 @@ declare global {
 //#endregion
 //#region src/definePlugin.d.ts
 /**
- * Base hook handlers for all events except `kubb:plugin:setup`.
- * These handlers have identical signatures regardless of the plugin's
- * `PluginFactoryOptions` generic — they are split out so that the
- * interface below only needs to override the one event that depends on
- * the plugin type.
- */
-type PluginHooksBase = { [K in Exclude<keyof KubbHooks, 'kubb:plugin:setup'>]?: (...args: KubbHooks[K]) => void | Promise<void> };
-/**
- * Plugin hook handlers.
- *
- * `kubb:plugin:setup` is typed with the plugin's own `PluginFactoryOptions` so
- * `ctx.setResolver`, `ctx.setOptions`, `ctx.options` etc. use the correct types.
- *
- * Uses interface + method shorthand for `kubb:plugin:setup`
- * checking, allowing `PluginHooks<PluginTs>` to be assignable to `PluginHooks`.
- *
- * @template TFactory - The plugin's `PluginFactoryOptions` type.
- */
-interface PluginHooks<TFactory extends PluginFactoryOptions = PluginFactoryOptions> extends PluginHooksBase {
-  'kubb:plugin:setup'?(ctx: KubbPluginSetupContext<TFactory>): void | Promise<void>;
-}
-/**
- * A hook-style plugin object produced by `definePlugin`.
+ * A plugin object produced by `definePlugin`.
  * Instead of flat lifecycle methods, it groups all handlers under a `hooks:` property
  * (matching Astro's integration naming convention).
  *
  * @template TFactory - The plugin's `PluginFactoryOptions` type.
  */
-type HookStylePlugin<TFactory extends PluginFactoryOptions = PluginFactoryOptions> = {
+type Plugin<TFactory extends PluginFactoryOptions = PluginFactoryOptions> = {
   /**
    * Unique name for the plugin, following the same naming convention as `createPlugin`.
    */
@@ -1020,12 +858,14 @@ type HookStylePlugin<TFactory extends PluginFactoryOptions = PluginFactoryOption
    * Lifecycle event handlers for this plugin.
    * Any event from the global `KubbHooks` map can be subscribed to here.
    */
-  hooks: PluginHooks<TFactory>;
+  hooks: { [K in Exclude<keyof KubbHooks, 'kubb:plugin:setup'>]?: (...args: KubbHooks[K]) => void | Promise<void> } & {
+    'kubb:plugin:setup'?(ctx: KubbPluginSetupContext<TFactory>): void | Promise<void>;
+  };
 };
 /**
- * Creates a plugin factory using the new hook-style (`hooks:`) API.
+ * Creates a plugin factory using the hook-style (`hooks:`) API.
  *
- * The returned factory is called with optional options and produces a `HookStylePlugin`
+ * The returned factory is called with optional options and produces a `Plugin`
  * that coexists with plugins created via the legacy `createPlugin` API in the same
  * `kubb.config.ts`.
  *
@@ -1045,9 +885,14 @@ type HookStylePlugin<TFactory extends PluginFactoryOptions = PluginFactoryOption
  * }))
  * ```
  */
-declare function definePlugin<TFactory extends PluginFactoryOptions = PluginFactoryOptions>(factory: (options: TFactory['options']) => HookStylePlugin<TFactory>): (options?: TFactory['options']) => HookStylePlugin<TFactory>;
+declare function definePlugin<TFactory extends PluginFactoryOptions = PluginFactoryOptions>(factory: (options: TFactory['options']) => Plugin<TFactory>): (options?: TFactory['options']) => Plugin<TFactory>;
 //#endregion
 //#region src/utils/getBarrelFiles.d.ts
+/**
+ * Minimal file metadata attached to every generated file for barrel-file bookkeeping.
+ *
+ * @internal
+ */
 type FileMetaBase = {
   pluginName?: string;
 };
@@ -1348,6 +1193,11 @@ type PatternOverride<TOptions> = PatternFilter & {
  * Context passed to `resolver.resolveOptions` to apply include/exclude/override filtering
  * for a given operation or schema node.
  */
+/**
+ * Resolves filtered options for a given operation or schema node.
+ *
+ * @internal
+ */
 type ResolveOptionsContext<TOptions> = {
   options: TOptions;
   exclude?: Array<PatternFilter>;
@@ -1372,7 +1222,7 @@ type ResolveOptionsContext<TOptions> = {
 type Resolver = {
   name: string;
   pluginName: Plugin['name'];
-  default(name: ResolveNameParams['name'], type?: ResolveNameParams['type']): string;
+  default(name: string, type?: 'file' | 'function' | 'type' | 'const'): string;
   resolveOptions<TOptions>(node: Node, context: ResolveOptionsContext<TOptions>): TOptions | null;
   resolvePath(params: ResolverPathParams, context: ResolverContext): string;
   resolveFile(params: ResolverFileParams, context: ResolverContext): FileNode;
@@ -1413,95 +1263,25 @@ TResolver extends Resolver = Resolver> = {
   resolver: TResolver;
 };
 /**
- * @deprecated
+ * Internal representation of a plugin after normalization.
+ * Extends the user-facing `Plugin` with runtime fields populated during `kubb:plugin:setup`.
+ * Not part of the public API — use `Plugin` for external-facing interactions.
+ * @internal
  */
-type UserPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
-  /**
-   * Unique name used for the plugin.
-   * The name follows the format `scope:foo-bar` or `foo-bar` — adding a scope avoids conflicts with other plugins.
-   *
-   * @example Plugin name
-   * `'@kubb/typescript'`
-   */
-  name: TOptions['name'];
-  /**
-   * Resolved options merged with output/include/exclude/override defaults for the current plugin.
-   */
+type NormalizedPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = Plugin<TOptions> & {
   options: TOptions['resolvedOptions'] & {
     output: Output;
     include?: Array<Include>;
     exclude: Array<Exclude$1>;
     override: Array<Override<TOptions['resolvedOptions']>>;
   };
-  /**
-   * The resolver for this plugin.
-   * Set via `setResolver()` in `kubb:plugin:setup` or passed as a user option.
-   */
-  resolver?: TOptions['resolver'];
-  /**
-   * The composed transformer for this plugin.
-   * Set via `setTransformer()` in `kubb:plugin:setup` or passed as a user option.
-   */
+  resolver: TOptions['resolver'];
   transformer?: Visitor;
-  /**
-   * Plugin-level renderer factory. All generators that do not declare their own `renderer`
-   * inherit this value. A generator can explicitly opt out by setting `renderer: null`.
-   *
-   * @example
-   * ```ts
-   * import { jsxRenderer } from '@kubb/renderer-jsx'
-   * createPlugin((options) => ({
-   *   name: 'my-plugin',
-   *   renderer: jsxRenderer,
-   *   generators: [
-   *     { name: 'types', schema(node) { return <File>...</File> } },   // inherits jsxRenderer
-   *     { name: 'raw', renderer: null, schema(node) { return [...] } }, // explicit opt-out
-   *   ],
-   * }))
-   * ```
-   */
   renderer?: RendererFactory;
-  /**
-   * Generators declared directly on the plugin. Each generator's `renderer` takes precedence
-   * over `plugin.renderer`; set `renderer: null` on a generator to opt out of rendering even
-   * when the plugin declares a renderer.
-   */
   generators?: Array<Generator>;
-  /**
-   * Specifies the plugins that the current plugin depends on. The current plugin is executed after all listed plugins.
-   * An error is returned if any required dependency plugin is missing.
-   */
-  dependencies?: Array<string>;
-  /**
-   * When `apply` is defined, the plugin is only activated when `apply(config)` returns `true`.
-   * Inspired by Vite's `apply` option.
-   *
-   * @example
-   * ```ts
-   * apply: (config) => config.output.path !== 'disabled'
-   * ```
-   */
   apply?: (config: Config) => boolean;
-  /**
-   * Expose shared helpers or data to all other plugins via `PluginContext`.
-   * The object returned is merged into the context that every plugin receives.
-   * Use the `declare global { namespace Kubb { interface PluginContext { … } } }` pattern
-   * to make the injected properties type-safe.
-   *
-   * @example
-   * ```ts
-   * inject() {
-   *   return { getOas: () => parseSpec(this.config) }
-   * }
-   * // Other plugins can then call `this.getOas()` inside buildStart()
-   * ```
-   */
-  inject?: (this: PluginContext<TOptions>) => TOptions['context'];
+  version?: string;
 };
-/**
- * @deprecated
- */
-type UserPluginWithLifeCycle<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = UserPlugin<TOptions> & PluginLifecycle<TOptions>;
 /**
  * Partial version of {@link Config} intended for user-facing config entry points.
  *
@@ -1525,187 +1305,10 @@ type UserConfig<TInput = Input> = Omit<Config<TInput>, 'root' | 'plugins' | 'par
    */
   adapter?: Adapter;
   /**
-   * User-facing plugins can be either legacy createPlugin instances or hook-style plugins.
-   */
-  plugins?: Array<Omit<UserPlugin<any>, 'inject'> | HookStylePlugin<any>>;
-};
-/**
- * Handler for a single schema node. Used by the `schema` hook on a plugin.
- */
-type SchemaHook<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = (this: GeneratorContext<TOptions>, node: SchemaNode, options: TOptions['resolvedOptions']) => PossiblePromise<unknown | Array<FileNode> | void>;
-/**
- * Handler for a single operation node. Used by the `operation` hook on a plugin.
- */
-type OperationHook<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = (this: GeneratorContext<TOptions>, node: OperationNode, options: TOptions['resolvedOptions']) => PossiblePromise<unknown | Array<FileNode> | void>;
-/**
- * Handler for all collected operation nodes. Used by the `operations` hook on a plugin.
- */
-type OperationsHook<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = (this: GeneratorContext<TOptions>, nodes: Array<OperationNode>, options: TOptions['resolvedOptions']) => PossiblePromise<unknown | Array<FileNode> | void>;
-/**
- * @deprecated will be replaced with HookStylePlugin
- */
-type Plugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
-  /**
-   * Unique name used for the plugin.
-   *
-   * @example Plugin name
-   * `'@kubb/typescript'`
-   */
-  name: TOptions['name'];
-  /**
-   * Specifies the plugins that the current plugin depends on. The current plugin is executed after all listed plugins.
-   * An error is returned if any required dependency plugin is missing.
-   */
-  dependencies?: Array<string>;
-  /**
-   * Options set for a specific plugin(see kubb.config.js), passthrough of options.
-   */
-  options: TOptions['resolvedOptions'] & {
-    output: Output;
-    include?: Array<Include>;
-    exclude: Array<Exclude$1>;
-    override: Array<Override<TOptions['resolvedOptions']>>;
-  };
-  /**
-   * The resolver for this plugin.
-   * Set via `setResolver()` in `kubb:plugin:setup` or passed as a user option.
-   */
-  resolver: TOptions['resolver'];
-  /**
-   * The composed transformer for this plugin.
-   * Set via `setTransformer()` in `kubb:plugin:setup` or passed as a user option.
-   */
-  transformer?: Visitor;
-  /**
-   * When `apply` is defined, the plugin is only activated when `apply(config)` returns `true`.
-   * Inspired by Vite's `apply` option.
-   */
-  apply?: (config: Config) => boolean;
-  /**
-   * Optional semver version string for this plugin, e.g. `"1.2.3"`.
-   * Used in diagnostic messages and version-conflict detection.
-   */
-  version?: string;
-  /**
-   * Plugin-level renderer factory. All generators that do not declare their own `renderer`
-   * inherit this value. A generator can explicitly opt out by setting `renderer: null`.
-   */
-  renderer?: RendererFactory;
-  /**
-   * Generators declared directly on the plugin. Each generator's `renderer` takes precedence
-   * over `plugin.renderer`; set `renderer: null` on a generator to opt out of rendering even
-   * when the plugin declares a renderer.
-   */
-  generators?: Array<Generator>;
-  buildStart: (this: PluginContext<TOptions>) => PossiblePromise<void>;
-  /**
-   * Called once per plugin after all files have been written to disk.
-   * Use this for post-processing, copying assets, or generating summary reports.
-   */
-  buildEnd: (this: PluginContext<TOptions>) => PossiblePromise<void>;
-  /**
-   * Called for each schema node during the AST walk.
-   * Return a React element, an array of `FileNode`, or `void` for manual handling.
-   * Nodes matching `exclude`/`include` filters are skipped automatically.
-   *
-   * For multiple generators, use `composeGenerators` inside the plugin factory.
-   */
-  schema?: SchemaHook<TOptions>;
-  /**
-   * Called for each operation node during the AST walk.
-   * Return a React element, an array of `FileNode`, or `void` for manual handling.
-   *
-   * For multiple generators, use `composeGenerators` inside the plugin factory.
-   */
-  operation?: OperationHook<TOptions>;
-  /**
-   * Called once after all operations have been walked, with the full collected set.
-   *
-   * For multiple generators, use `composeGenerators` inside the plugin factory.
-   */
-  operations?: OperationsHook<TOptions>;
-  /**
-   * Expose shared helpers or data to all other plugins via `PluginContext`.
-   * The returned object is merged into the context received by every plugin.
-   */
-  inject: (this: PluginContext<TOptions>) => TOptions['context'];
-};
-/**
- * @deprecated
- */
-type PluginWithLifeCycle<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = Plugin<TOptions> & PluginLifecycle<TOptions>;
-/**
- * @deprecated
- */
-type PluginLifecycle<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
-  /**
-   * Called once per plugin at the start of its processing phase, before schema/operation/operations hooks run.
-   * Use this to set up shared state, fetch remote data, or perform any async initialization.
-   */
-  buildStart?: (this: PluginContext<TOptions>) => PossiblePromise<void>;
-  /**
-   * Called once per plugin after all files have been written to disk.
-   * Use this for post-processing, copying assets, or generating summary reports.
-   */
-  buildEnd?: (this: PluginContext<TOptions>) => PossiblePromise<void>;
-  /**
-   * Called for each schema node during the AST walk.
-   * Return a React element (`<File>...</File>`), an array of `FileNode` objects,
-   * or `void` to handle file writing manually via `this.upsertFile`.
-   * Nodes matching `exclude` / `include` filters are skipped automatically.
-   *
-   * For multiple generators, use `composeGenerators` inside the plugin factory.
-   */
-  schema?: SchemaHook<TOptions>;
-  /**
-   * Called for each operation node during the AST walk.
-   * Return a React element (`<File>...</File>`), an array of `FileNode` objects,
-   * or `void` to handle file writing manually via `this.upsertFile`.
-   *
-   * For multiple generators, use `composeGenerators` inside the plugin factory.
-   */
-  operation?: OperationHook<TOptions>;
-  /**
-   * Called once after all operation nodes have been walked, with the full collection.
-   * Useful for generating index/barrel files per group or aggregate operation handlers.
-   *
-   * For multiple generators, use `composeGenerators` inside the plugin factory.
-   */
-  operations?: OperationsHook<TOptions>;
-  /**
-   * Resolves a path from a baseName and directory.
-   * Options can also be included.
-   *
-   * @example
-   * `('./Pet.ts', './src/gen/') => '/src/gen/Pet.ts'`
-   *
-   * @deprecated Use resolvers instead.
-   */
-  resolvePath?: (this: PluginContext<TOptions>, baseName: FileNode['baseName'], mode?: 'single' | 'split', options?: TOptions['resolvePathOptions']) => string;
-  /**
-   * Resolves a display name from a raw string.
-   * Useful when converting to PascalCase or camelCase.
-   *
-   * @example
-   * `('pet') => 'Pet'`
-   *
-   * @deprecated Use resolvers instead.
-   */
-  resolveName?: (this: PluginContext<TOptions>, name: ResolveNameParams['name'], type?: ResolveNameParams['type']) => string;
-};
-/**
- * @deprecated
- */
-type PluginLifecycleHooks = keyof PluginLifecycle;
-type PluginParameter<H extends PluginLifecycleHooks> = Parameters<Required<PluginLifecycle>[H]>;
-type ResolvePathParams<TOptions = object> = {
-  pluginName?: string;
-  baseName: FileNode['baseName'];
-  mode?: 'single' | 'split';
-  /**
-   * Options passed as the third argument to `resolvePath`.
+   * An array of Kubb plugins used for code generation.
+   * Each entry is a hook-style plugin created with `definePlugin`.
    */
-  options?: TOptions;
+  plugins?: Array<Plugin>;
 };
 type ResolveNameParams = {
   name: string;
@@ -1720,9 +1323,17 @@ type ResolveNameParams = {
   type?: 'file' | 'function' | 'type' | 'const';
 };
 /**
- * @deprecated
+ * Context object passed as the second argument to generator `schema`, `operation`, and
+ * `operations` methods.
+ *
+ * Generators are only invoked from `runPluginAstHooks`, which already guards against a
+ * missing adapter. This type reflects that guarantee — `ctx.adapter` and `ctx.inputNode`
+ * are always defined, so no runtime checks or casts are needed inside generator bodies.
+ *
+ * `ctx.options` carries the per-node resolved options for `schema`/`operation` calls
+ * (after exclude/include/override filtering) and the plugin-level options for `operations`.
  */
-type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
+type GeneratorContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
   config: Config;
   /**
    * Absolute path to the output directory for the current plugin.
@@ -1732,7 +1343,6 @@ type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions>
   /**
    * Returns the output mode for the given output config.
    * Returns `'single'` when `output.path` has a file extension, `'split'` otherwise.
-   * Shorthand for `PluginDriver.getMode(path.resolve(this.root, output.path))`.
    */
   getMode: (output: {
     path: string;
@@ -1746,7 +1356,6 @@ type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions>
   getPlugin(name: string): Plugin | undefined;
   /**
    * Like `getPlugin` but throws a descriptive error when the plugin is not found.
-   * Useful for enforcing dependencies inside `buildStart()`.
    */
   requirePlugin<TName extends keyof Kubb.PluginRegistry>(name: TName): Plugin<Kubb.PluginRegistry[TName]>;
   requirePlugin(name: string): Plugin;
@@ -1764,63 +1373,40 @@ type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions>
    */
   plugin: Plugin<TOptions>;
   /**
-   * Resolver for the current plugin. Shorthand for `plugin.resolver`.
+   * Resolver for the current plugin.
    */
   resolver: TOptions['resolver'];
   /**
-   * Composed transformer for the current plugin. Shorthand for `plugin.transformer`.
-   * Apply with `transform(node, context.transformer)` to pre-process AST nodes before printing.
+   * Composed transformer for the current plugin.
    */
   transformer: Visitor | undefined;
   /**
    * Emit a warning via the build event system.
-   * Shorthand for `this.hooks.emit('kubb:warn', message)`.
    */
   warn: (message: string) => void;
   /**
    * Emit an error via the build event system.
-   * Shorthand for `this.hooks.emit('kubb:error', error)`.
    */
   error: (error: string | Error) => void;
   /**
    * Emit an info message via the build event system.
-   * Shorthand for `this.hooks.emit('kubb:info', message)`.
    */
   info: (message: string) => void;
   /**
    * Opens the Kubb Studio URL for the current `inputNode` in the default browser.
-   * Falls back to printing the URL if the browser cannot be launched.
-   * No-ops silently when no adapter has set an `inputNode`.
    */
   openInStudio: (options?: DevtoolsOptions) => Promise<void>;
-} & ({
-  /**
-   * Returns the universal `@kubb/ast` `InputNode` produced by the configured adapter.
-   * Returns `undefined` when no adapter was set (legacy OAS-only usage).
-   */
-  inputNode: InputNode;
   /**
    * The adapter from `@kubb/ast`.
    */
   adapter: Adapter;
-} | {
-  inputNode?: never;
-  adapter?: never;
-}) & Kubb.PluginContext;
-/**
- * Context object passed as the second argument to generator `schema`, `operation`, and
- * `operations` methods.
- *
- * Generators are only invoked from `runPluginAstHooks`, which already guards against a
- * missing adapter. This type reflects that guarantee — `ctx.adapter` and `ctx.inputNode`
- * are always defined, so no runtime checks or casts are needed inside generator bodies.
- *
- * `ctx.options` carries the per-node resolved options for `schema`/`operation` calls
- * (after exclude/include/override filtering) and the plugin-level options for `operations`.
- */
-type GeneratorContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = Omit<PluginContext<TOptions>, 'adapter' | 'inputNode'> & {
-  adapter: Adapter;
+  /**
+   * The universal `@kubb/ast` `InputNode` produced by the configured adapter.
+   */
   inputNode: InputNode;
+  /**
+   * Per-node resolved options (after exclude/include/override filtering).
+   */
   options: TOptions['resolvedOptions'];
 };
 /**
@@ -1896,12 +1482,6 @@ type Logger<TOptions extends LoggerOptions = LoggerOptions> = {
   install: (context: LoggerContext, options?: TOptions) => void | Promise<void>;
 };
 type UserLogger<TOptions extends LoggerOptions = LoggerOptions> = Logger<TOptions>;
-/**
- * Compatibility preset for code generation tools.
- * - `'default'` – no compatibility adjustments (default behavior).
- * - `'kubbV4'` – align generated names and structures with Kubb v4 output.
- */
-type CompatibilityPreset = 'default' | 'kubbV4';
 /**
  * Context passed to a hook-style plugin's `kubb:plugin:setup` handler.
  * Provides methods to register generators, configure the resolver, transformer,
@@ -2018,14 +1598,6 @@ type Include = ByTag | ByOperationId | ByPath | ByMethod | ByContentType | BySch
 type Override<TOptions> = (ByTag | ByOperationId | ByPath | ByMethod | BySchemaName | ByContentType) & {
   options: Partial<TOptions>;
 };
-type ResolvePathOptions = {
-  pluginName?: string;
-  group?: {
-    tag?: string;
-    path?: string;
-  };
-  type?: ResolveNameParams['type'];
-};
 /**
  * File-specific parameters for `Resolver.resolvePath`.
  *
@@ -2147,5 +1719,5 @@ type CLIOptions = {
  */
 type PossibleConfig<TCliOptions = undefined> = PossiblePromise<Config | Config[]> | ((...args: [TCliOptions] extends [undefined] ? [] : [TCliOptions]) => PossiblePromise<Config | Config[]>);
 //#endregion
-export { KubbHooks as $, PluginParameter as A, ResolverFileParams as B, Output as C, PluginFactoryOptions as D, PluginContext as E, ResolveOptionsContext as F, UserLogger as G, SchemaHook as H, ResolvePathOptions as I, FileMetaBase as J, UserPlugin as K, ResolvePathParams as L, PossibleConfig as M, ResolveBannerContext as N, PluginLifecycle as O, ResolveNameParams as P, Kubb$1 as Q, Resolver as R, OperationsHook as S, Plugin as T, UserConfig as U, ResolverPathParams as V, UserGroup as W, PluginHooks as X, HookStylePlugin as Y, definePlugin as Z, KubbPluginSetupContext as _, CLIOptions as a, defineParser as at, LoggerOptions as b, DevtoolsOptions as c, Storage as ct, Group as d, RendererFactory as dt, BuildOutput as et, Include as f, createRenderer as ft, KubbBuildStartContext as g, KubbBuildEndContext as h, BarrelType as i, Parser as it, PluginWithLifeCycle as j, PluginLifecycleHooks as k, Exclude$1 as l, createStorage as lt, InputPath as m, AsyncEventEmitter as mt, AdapterFactoryOptions as n, PluginDriver as nt, CompatibilityPreset as o, Generator as ot, InputData as p, logLevel as pt, UserPluginWithLifeCycle as q, AdapterSource as r, FileManager as rt, Config as s, defineGenerator as st, Adapter as t, createKubb as tt, GeneratorContext as u, Renderer as ut, Logger as v, Override as w, OperationHook as x, LoggerContext as y, ResolverContext as z };
-//# sourceMappingURL=types-BJX_uR-y.d.ts.map
+export { logLevel as $, ResolverFileParams as A, BuildOutput as B, PluginFactoryOptions as C, ResolveOptionsContext as D, ResolveNameParams as E, FileMetaBase as F, defineParser as G, PluginDriver as H, Plugin as I, Storage as J, Generator as K, definePlugin as L, UserConfig as M, UserGroup as N, Resolver as O, UserLogger as P, createRenderer as Q, Kubb$1 as R, Override as S, ResolveBannerContext as T, FileManager as U, createKubb as V, Parser as W, Renderer as X, createStorage as Y, RendererFactory as Z, Logger as _, CLIOptions as a, NormalizedPlugin as b, Exclude$1 as c, Include as d, AsyncEventEmitter as et, InputData as f, KubbPluginSetupContext as g, KubbBuildStartContext as h, BarrelType as i, ResolverPathParams as j, ResolverContext as k, GeneratorContext as l, KubbBuildEndContext as m, AdapterFactoryOptions as n, Config as o, InputPath as p, defineGenerator as q, AdapterSource as r, DevtoolsOptions as s, Adapter as t, Group as u, LoggerContext as v, PossibleConfig as w, Output as x, LoggerOptions as y, KubbHooks as z };
+//# sourceMappingURL=types-BUgxQiWY.d.ts.map