@kubb/core 5.0.0-alpha.31 → 5.0.0-alpha.32

package/dist/{PluginDriver-D0dY_hpJ.d.ts → PluginDriver-nm7tvGs9.d.ts}

@@ -1,6 +1,5 @@
-import { n as __name, t as __exportAll } from "./chunk-O_arW02_.js";
-import { Node, OperationNode, Printer, Printer as Printer$1, PrinterFactoryOptions, PrinterPartial, RootNode, SchemaNode, Visitor } from "@kubb/ast/types";
-import { Fabric } from "@kubb/fabric-core/types";
+import { t as __name } from "./chunk--u3MIqq1.js";
+import { FileNode, ImportNode, InputNode, Node, OperationNode, Printer, Printer as Printer$1, PrinterFactoryOptions, PrinterPartial, SchemaNode, Visitor } from "@kubb/ast/types";
 import { HttpMethod } from "@kubb/oas";
 import { FabricReactNode } from "@kubb/react-fabric/types";
 
@@ -86,138 +85,44 @@ declare class AsyncEventEmitter<TEvents extends { [K in keyof TEvents]: unknown[
  * ```
  */
 type PossiblePromise<T> = Promise<T> | T;
-declare namespace KubbFile_d_exports {
-  export { BaseName, Export, Extname, File, Import, Mode, Path, ResolvedFile, Source };
-}
-type ImportName = string | Array<string | {
-  propertyName: string;
-  name?: string;
-}>;
-type Import = {
-  /**
-   * Import name to be used.
-   * @example ["useState"]
-   * @example "React"
-   */
-  name: ImportName;
-  /**
-   * Path for the import.
-   * @example '@kubb/core'
-   */
-  path: string;
-  /**
-   * Add type-only import prefix.
-   * - `true` generates `import type { Type } from './path'`
-   * - `false` generates `import { Type } from './path'`
-   * @default false
-   */
-  isTypeOnly?: boolean;
-  /**
-   * Import entire module as namespace.
-   * - `true` generates `import * as Name from './path'`
-   * - `false` generates standard import
-   * @default false
-   */
-  isNameSpace?: boolean;
-  /**
-   * When root is set it will compute a relative path with `getRelativePath(root, path)`.
-   */
-  root?: string;
-};
-type Source = {
-  name?: string;
-  value?: string;
-  /**
-   * Make this source a type-only export.
-   * @default false
-   */
-  isTypeOnly?: boolean;
-  /**
-   * Include export keyword in source.
-   * @default false
-   */
-  isExportable?: boolean;
-  /**
-   * Include in barrel file generation.
-   * @default false
-   */
-  isIndexable?: boolean;
-};
-type Export = {
-  /**
-   * Export name to be used.
-   * @example ["useState"]
-   * @example "React"
-   */
-  name?: string | Array<string>;
-  /**
-   * Path for the export.
-   * @example '@kubb/core'
-   */
-  path: string;
-  /**
-   * Add type-only export prefix.
-   * - `true` generates `export type { Type } from './path'`
-   * - `false` generates `export { Type } from './path'`
-   * @default false
-   */
-  isTypeOnly?: boolean;
-  /**
-   * Export as aliased namespace.
-   * - `true` generates `export * as aliasName from './path'`
-   * - `false` generates standard export
-   * @default false
-   */
-  asAlias?: boolean;
-};
-type Extname = '.ts' | '.js' | '.tsx' | '.json' | `.${string}`;
-type Mode = 'single' | 'split';
-/**
- * Name to be used to dynamically create the baseName (based on input.path).
- * Based on UNIX basename.
- * @link https://nodejs.org/api/path.html#pathbasenamepath-suffix
- */
-type BaseName = `${string}.${string}`;
+//#endregion
+//#region src/FileManager.d.ts
 /**
- * Fully qualified path to a specified file.
+ * 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).
+ *
+ * @example
+ * ```ts
+ * import { FileManager } from '@kubb/core'
+ *
+ * const manager = new FileManager()
+ * manager.upsert(myFile)
+ * console.log(manager.files) // all stored files
+ * ```
  */
-type Path = string;
-type File<TMeta extends object = object> = {
-  /**
-   * Name used to create the path.
-   * Based on UNIX basename, `${name}${extname}`.
-   * @link https://nodejs.org/api/path.html#pathbasenamepath-suffix
-   */
-  baseName: BaseName;
-  /**
-   * Fully qualified path to the file.
-   */
-  path: Path;
-  sources: Array<Source>;
-  imports: Array<Import>;
-  exports: Array<Export>;
+declare class FileManager {
+  #private;
   /**
-   * Extra metadata used for barrel/index file generation.
+   * Adds one or more files. Files with the same path are merged — sources, imports,
+   * and exports from all calls with the same path are concatenated together.
    */
-  meta?: TMeta;
-  banner?: string;
-  footer?: string;
-};
-type ResolvedFile<TMeta extends object = object> = File<TMeta> & {
+  add(...files: Array<FileNode>): Array<FileNode>;
   /**
-   * Unique identifier, generated from a hash.
-   * @default hash
+   * Adds or merges one or more files.
+   * If a file with the same path already exists, its sources/imports/exports are merged together.
    */
-  id: string;
+  upsert(...files: Array<FileNode>): Array<FileNode>;
+  getByPath(path: string): FileNode | null;
+  deleteByPath(path: string): void;
+  clear(): void;
   /**
-   * First part of the `baseName`, derived from the file name.
-   * @link https://nodejs.org/api/path.html#pathformatpathobject
+   * All stored files, sorted by path length (shorter paths first).
+   * Barrel/index files (e.g. index.ts) are sorted last within each length bucket.
    */
-  name: string;
-  extname: Extname;
-  imports: Array<Import>;
-  exports: Array<Export>;
-};
+  get files(): Array<FileNode>;
+}
 //#endregion
 //#region src/constants.d.ts
 /**
@@ -347,10 +252,10 @@ declare function createStorage<TOptions = Record<string, never>>(build: (options
 /**
  * A generator is a named object with optional `schema`, `operation`, and `operations`
  * methods. Each method is called with `this = PluginContext` of the parent plugin,
- * giving full access to `this.config`, `this.resolver`, `this.adapter`, `this.fabric`,
+ * giving full access to `this.config`, `this.resolver`, `this.adapter`,
  * `this.driver`, etc.
  *
- * Return a React element, an array of `KubbFile.File`, or `void` to handle file
+ * Return a React element, an array of `FileNode`, or `void` to handle file
  * writing manually via `this.upsertFile`. Both React and core (non-React) generators
  * use the same method signatures — the return type determines how output is handled.
  *
@@ -372,20 +277,20 @@ type Generator<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
   /** Used in diagnostic messages and debug output. */name: string;
   /**
    * Called for each schema node in the AST walk.
-   * `this` is the parent plugin's context with `adapter` and `rootNode` guaranteed present.
+   * `this` is the parent plugin's context with `adapter` and `inputNode` guaranteed present.
    * `options` contains the per-node resolved options (after exclude/include/override).
    */
-  schema?: (this: GeneratorContext<TOptions>, node: SchemaNode, options: TOptions['resolvedOptions']) => PossiblePromise<FabricReactNode | Array<File> | void>;
+  schema?: (this: GeneratorContext<TOptions>, node: SchemaNode, options: TOptions['resolvedOptions']) => PossiblePromise<FabricReactNode | Array<FileNode> | void>;
   /**
    * Called for each operation node in the AST walk.
-   * `this` is the parent plugin's context with `adapter` and `rootNode` guaranteed present.
+   * `this` is the parent plugin's context with `adapter` and `inputNode` guaranteed present.
    */
-  operation?: (this: GeneratorContext<TOptions>, node: OperationNode, options: TOptions['resolvedOptions']) => PossiblePromise<FabricReactNode | Array<File> | void>;
+  operation?: (this: GeneratorContext<TOptions>, node: OperationNode, options: TOptions['resolvedOptions']) => PossiblePromise<FabricReactNode | Array<FileNode> | void>;
   /**
    * Called once after all operations have been walked.
-   * `this` is the parent plugin's context with `adapter` and `rootNode` guaranteed present.
+   * `this` is the parent plugin's context with `adapter` and `inputNode` guaranteed present.
    */
-  operations?: (this: GeneratorContext<TOptions>, nodes: Array<OperationNode>, options: TOptions['resolvedOptions']) => PossiblePromise<FabricReactNode | Array<File> | void>;
+  operations?: (this: GeneratorContext<TOptions>, nodes: Array<OperationNode>, options: TOptions['resolvedOptions']) => PossiblePromise<FabricReactNode | Array<FileNode> | void>;
 };
 /**
  * Defines a generator. Returns the object as-is with correct `this` typings.
@@ -419,7 +324,7 @@ declare function mergeGenerators<TOptions extends PluginFactoryOptions = PluginF
 //#endregion
 //#region src/defineParser.d.ts
 type PrintOptions = {
-  extname?: Extname;
+  extname?: FileNode['extname'];
 };
 type Parser<TMeta extends object = any> = {
   name: string;
@@ -430,7 +335,7 @@ type Parser<TMeta extends object = any> = {
    *
    * @example ['.ts', '.js']
    */
-  extNames: Array<Extname> | undefined;
+  extNames: Array<FileNode['extname']> | undefined;
   /**
    * @deprecated Will be removed once Fabric no longer requires it.
    * @default () => {}
@@ -439,7 +344,7 @@ type Parser<TMeta extends object = any> = {
   /**
    * Convert a resolved file to a string.
    */
-  parse(file: ResolvedFile<TMeta>, options?: PrintOptions): Promise<string> | string;
+  parse(file: FileNode<TMeta>, options?: PrintOptions): Promise<string> | string;
 };
 type UserParser<TMeta extends object = any> = Omit<Parser<TMeta>, 'type' | 'install'> & {
   install?(...args: unknown[]): void | Promise<void>;
@@ -534,7 +439,7 @@ interface KubbEvents {
   /**
    * Emitted when code generation phase completes.
    */
-  'generation:end': [config: Config, files: Array<ResolvedFile>, sources: Map<Path, string>];
+  'generation:end': [config: Config, files: Array<FileNode>, sources: Map<string, string>];
   /**
    * Emitted with a summary of the generation results.
    * Contains summary lines, title, and success status.
@@ -621,7 +526,7 @@ interface KubbEvents {
    * Emitted when file processing starts.
    * Contains the list of files to be processed.
    */
-  'files:processing:start': [files: Array<ResolvedFile>];
+  'files:processing:start': [files: Array<FileNode>];
   /**
    * Emitted for each file being processed, providing progress updates.
    * Contains processed count, total count, percentage, and file details.
@@ -646,7 +551,7 @@ interface KubbEvents {
     /**
      * The file being processed.
      */
-    file: ResolvedFile;
+    file: FileNode;
     /**
      * Kubb configuration (not present in Fabric).
      * Provides access to the current config during file processing.
@@ -657,7 +562,7 @@ interface KubbEvents {
    * Emitted when file processing completes.
    * Contains the list of processed files.
    */
-  'files:processing:end': [files: Array<ResolvedFile>];
+  'files:processing:end': [files: Array<FileNode>];
   /**
    * Emitted when a plugin starts executing.
    */
@@ -814,12 +719,12 @@ type AddIndexesProps = {
  * - When `type` is `'all'`, strips named exports so every re-export becomes a wildcard (`export * from`).
  * - Attaches `meta` to each barrel file for downstream plugin identification.
  */
-declare function getBarrelFiles(files: Array<ResolvedFile>, {
+declare function getBarrelFiles(files: Array<FileNode>, {
   type,
   meta,
   root,
   output
-}: AddIndexesProps): Promise<Array<File>>;
+}: AddIndexesProps): Promise<Array<FileNode>>;
 //#endregion
 //#region src/types.d.ts
 declare global {
@@ -879,7 +784,7 @@ type UserConfig<TInput = Input> = Omit<Config<TInput>, 'root' | 'plugins' | 'par
    */
   parsers?: Array<Parser>;
   /**
-   * Adapter that converts the input file into a `@kubb/ast` `RootNode` — the universal
+   * Adapter that converts the input file into a `@kubb/ast` `InputNode` — the universal
    * intermediate representation consumed by all Kubb plugins.
    *
    * When omitted, `adapterOas()` from `@kubb/adapter-oas` is used automatically as the
@@ -939,10 +844,10 @@ type AdapterFactoryOptions<TName extends string = string, TOptions extends objec
   document: TDocument;
 };
 /**
- * An adapter converts a source file or data into a `@kubb/ast` `RootNode`.
+ * An adapter converts a source file or data into a `@kubb/ast` `InputNode`.
  *
  * Adapters are the single entry-point for different schema formats
- * (OpenAPI, AsyncAPI, Drizzle, …) and produce the universal `RootNode`
+ * (OpenAPI, AsyncAPI, Drizzle, …) and produce the universal `InputNode`
  * that all Kubb plugins consume.
  *
  * @example
@@ -970,13 +875,13 @@ type Adapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptions> = {
    * `undefined` before parsing; typed by the adapter's `TDocument` generic.
    */
   document: TOptions['document'] | null;
-  rootNode: RootNode | null;
+  inputNode: InputNode | null;
   /**
-   * Convert the raw source into a universal `RootNode`.
+   * Convert the raw source into a universal `InputNode`.
    */
-  parse: (source: AdapterSource) => PossiblePromise<RootNode>;
+  parse: (source: AdapterSource) => PossiblePromise<InputNode>;
   /**
-   * Extracts `KubbFile.Import` entries needed by a `SchemaNode` tree.
+   * Extracts `ImportNode` entries needed by a `SchemaNode` tree.
    * Populated after the first `parse()` call. Returns an empty array before that.
    *
    * The `resolve` callback receives the collision-corrected schema name and must
@@ -985,7 +890,7 @@ type Adapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptions> = {
   getImports: (node: SchemaNode, resolve: (schemaName: string) => {
     name: string;
     path: string;
-  }) => Array<Import>;
+  }) => Array<ImportNode>;
 };
 type BarrelType = 'all' | 'named' | 'propagate';
 type DevtoolsOptions = {
@@ -1028,7 +933,7 @@ type Config<TInput = Input> = {
    */
   parsers: Array<Parser>;
   /**
-   * Adapter that converts the input file into a `@kubb/ast` `RootNode` — the universal
+   * Adapter that converts the input file into a `@kubb/ast` `InputNode` — the universal
    * intermediate representation consumed by all Kubb plugins.
    *
    * - Use `@kubb/adapter-oas` for OpenAPI / Swagger.
@@ -1101,7 +1006,7 @@ type Config<TInput = Input> = {
      * Overrides the extension for generated imports and exports. By default, each plugin adds an extension.
      * @default { '.ts': '.ts'}
      */
-    extension?: Record<Extname, Extname | ''>;
+    extension?: Record<FileNode['extname'], FileNode['extname'] | ''>;
     /**
      * Configures how `index.ts` files are created, including disabling barrel file generation. Each plugin has its own `barrelType` option; this setting controls the root barrel file (e.g., `src/gen/index.ts`).
      * @default 'named'
@@ -1193,10 +1098,10 @@ type Resolver = {
   pluginName: Plugin['name'];
   default(name: ResolveNameParams['name'], type?: ResolveNameParams['type']): string;
   resolveOptions<TOptions>(node: Node, context: ResolveOptionsContext<TOptions>): TOptions | null;
-  resolvePath(params: ResolverPathParams, context: ResolverContext): Path;
-  resolveFile(params: ResolverFileParams, context: ResolverContext): File;
-  resolveBanner(node: RootNode | null, context: ResolveBannerContext): string | undefined;
-  resolveFooter(node: RootNode | null, context: ResolveBannerContext): string | undefined;
+  resolvePath(params: ResolverPathParams, context: ResolverContext): string;
+  resolveFile(params: ResolverFileParams, context: ResolverContext): FileNode;
+  resolveBanner(node: InputNode | null, context: ResolveBannerContext): string | undefined;
+  resolveFooter(node: InputNode | null, context: ResolveBannerContext): string | undefined;
 };
 /**
  * The user-facing subset of a `Resolver` — everything except the four methods injected by
@@ -1313,15 +1218,15 @@ type UnknownUserPlugin = UserPlugin<PluginFactoryOptions<string, object, object,
 /**
  * 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<FabricReactNode | Array<File> | void>;
+type SchemaHook<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = (this: GeneratorContext<TOptions>, node: SchemaNode, options: TOptions['resolvedOptions']) => PossiblePromise<FabricReactNode | 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<FabricReactNode | Array<File> | void>;
+type OperationHook<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = (this: GeneratorContext<TOptions>, node: OperationNode, options: TOptions['resolvedOptions']) => PossiblePromise<FabricReactNode | 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<FabricReactNode | Array<File> | void>;
+type OperationsHook<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = (this: GeneratorContext<TOptions>, nodes: Array<OperationNode>, options: TOptions['resolvedOptions']) => PossiblePromise<FabricReactNode | Array<FileNode> | void>;
 type Plugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
   /**
    * Unique name used for the plugin
@@ -1375,7 +1280,7 @@ type Plugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
   buildEnd: (this: PluginContext<TOptions>) => PossiblePromise<void>;
   /**
    * Called for each schema node during the AST walk.
-   * Return a React element, an array of `KubbFile.File`, or `void` for manual handling.
+   * 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.
@@ -1383,7 +1288,7 @@ type Plugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
   schema?: SchemaHook<TOptions>;
   /**
    * Called for each operation node during the AST walk.
-   * Return a React element, an array of `KubbFile.File`, or `void` for manual handling.
+   * Return a React element, an array of `FileNode`, or `void` for manual handling.
    *
    * For multiple generators, use `composeGenerators` inside the plugin factory.
    */
@@ -1416,7 +1321,7 @@ type PluginLifecycle<TOptions extends PluginFactoryOptions = PluginFactoryOption
   buildEnd?: (this: PluginContext<TOptions>) => PossiblePromise<void>;
   /**
    * Called for each schema node during the AST walk.
-   * Return a React element (`<File>...</File>`), an array of `KubbFile.File` objects,
+   * 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.
    *
@@ -1425,7 +1330,7 @@ type PluginLifecycle<TOptions extends PluginFactoryOptions = PluginFactoryOption
   schema?: SchemaHook<TOptions>;
   /**
    * Called for each operation node during the AST walk.
-   * Return a React element (`<File>...</File>`), an array of `KubbFile.File` objects,
+   * 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.
@@ -1445,7 +1350,7 @@ type PluginLifecycle<TOptions extends PluginFactoryOptions = PluginFactoryOption
    * @example ('./Pet.ts', './src/gen/') => '/src/gen/Pet.ts'
    * @deprecated this will be replaced by resolvers
    */
-  resolvePath?: (this: PluginContext<TOptions>, baseName: BaseName, mode?: Mode, options?: TOptions['resolvePathOptions']) => Path;
+  resolvePath?: (this: PluginContext<TOptions>, baseName: FileNode['baseName'], mode?: 'single' | 'split', options?: TOptions['resolvePathOptions']) => string;
   /**
    * Resolve to a name based on a string.
    * Useful when converting to PascalCase or camelCase.
@@ -1459,8 +1364,8 @@ type PluginLifecycleHooks = keyof PluginLifecycle;
 type PluginParameter<H extends PluginLifecycleHooks> = Parameters<Required<PluginLifecycle>[H]>;
 type ResolvePathParams<TOptions = object> = {
   pluginName?: string;
-  baseName: BaseName;
-  mode?: Mode;
+  baseName: FileNode['baseName'];
+  mode?: 'single' | 'split';
   /**
    * Options to be passed to 'resolvePath' 3th parameter
    */
@@ -1480,7 +1385,6 @@ type ResolveNameParams = {
   type?: 'file' | 'function' | 'type' | 'const';
 };
 type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
-  fabric: Fabric;
   config: Config;
   /**
    * Absolute path to the output directory for the current plugin.
@@ -1494,7 +1398,7 @@ type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions>
    */
   getMode: (output: {
     path: string;
-  }) => Mode;
+  }) => 'single' | 'split';
   driver: PluginDriver;
   /**
    * Get a plugin by name. Returns the plugin typed via `Kubb.PluginRegistry` when
@@ -1511,11 +1415,11 @@ type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions>
   /**
    * Only add when the file does not exist yet
    */
-  addFile: (...file: Array<File>) => Promise<void>;
+  addFile: (...file: Array<FileNode>) => Promise<void>;
   /**
    * merging multiple sources into the same output file
    */
-  upsertFile: (...file: Array<File>) => Promise<void>;
+  upsertFile: (...file: Array<FileNode>) => Promise<void>;
   /**
    * @deprecated use this.warn, this.error, this.info instead
    */
@@ -1549,23 +1453,23 @@ type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions>
    */
   info: (message: string) => void;
   /**
-   * Opens the Kubb Studio URL for the current `rootNode` in the default browser.
+   * 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 a `rootNode`.
+   * No-ops silently when no adapter has set an `inputNode`.
    */
   openInStudio: (options?: DevtoolsOptions) => Promise<void>;
 } & ({
   /**
-   * Returns the universal `@kubb/ast` `RootNode` produced by the configured adapter.
+   * Returns the universal `@kubb/ast` `InputNode` produced by the configured adapter.
    * Returns `undefined` when no adapter was set (legacy OAS-only usage).
    */
-  rootNode: RootNode;
+  inputNode: InputNode;
   /**
    * Return the adapter from `@kubb/ast`
    */
   adapter: Adapter;
 } | {
-  rootNode?: never;
+  inputNode?: never;
   adapter?: never;
 }) & Kubb.PluginContext;
 /**
@@ -1573,12 +1477,12 @@ type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions>
  *
  * Generators and the `schema`/`operation`/`operations` plugin hooks are only invoked from
  * `runPluginAstHooks`, which already guards against a missing adapter. This type reflects
- * that guarantee — `this.adapter` and `this.rootNode` are always defined, so no runtime
+ * that guarantee — `this.adapter` and `this.inputNode` are always defined, so no runtime
  * checks or casts are needed inside the method bodies.
  */
-type GeneratorContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = Omit<PluginContext<TOptions>, 'adapter' | 'rootNode'> & {
+type GeneratorContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = Omit<PluginContext<TOptions>, 'adapter' | 'inputNode'> & {
   adapter: Adapter;
-  rootNode: RootNode;
+  inputNode: InputNode;
 };
 /**
  * Specify the export location for the files and define the behavior of the output
@@ -1596,11 +1500,11 @@ type Output<_TOptions = unknown> = {
   /**
    * Add a banner text in the beginning of every file
    */
-  banner?: string | ((node?: RootNode) => string);
+  banner?: string | ((node?: InputNode) => string);
   /**
    * Add a footer text in the beginning of every file
    */
-  footer?: string | ((node?: RootNode) => string);
+  footer?: string | ((node?: InputNode) => string);
   /**
    * Whether to override existing external files if they already exist.
    * @default false
@@ -1748,8 +1652,8 @@ type ResolvePathOptions = {
  * ```
  */
 type ResolverPathParams = {
-  baseName: BaseName;
-  pathMode?: Mode;
+  baseName: FileNode['baseName'];
+  pathMode?: 'single' | 'split';
   /**
    * Tag value used when `group.type === 'tag'`.
    */
@@ -1800,7 +1704,7 @@ type ResolverContext = {
  */
 type ResolverFileParams = {
   name: string;
-  extname: Extname;
+  extname: FileNode['extname'];
   /**
    * Tag value used when `group.type === 'tag'`.
    */
@@ -1818,7 +1722,7 @@ type ResolverFileParams = {
  *
  * @example
  * ```ts
- * resolver.resolveBanner(rootNode, { output: { banner: '// generated' }, config })
+ * resolver.resolveBanner(inputNode, { output: { banner: '// generated' }, config })
  * // → '// generated'
  * ```
  */
@@ -1844,7 +1748,6 @@ type SafeParseResult<H extends PluginLifecycleHooks, Result = ReturnType<ParseRe
   plugin: Plugin;
 };
 type Options = {
-  fabric: Fabric;
   events: AsyncEventEmitter<KubbEvents>;
   /**
    * @default Number.POSITIVE_INFINITY
@@ -1856,8 +1759,8 @@ type Options = {
  */
 type GetFileOptions<TOptions = object> = {
   name: string;
-  mode?: Mode;
-  extname: Extname;
+  mode?: 'single' | 'split';
+  extname: FileNode['extname'];
   pluginName: string;
   options?: TOptions;
 };
@@ -1870,17 +1773,23 @@ type GetFileOptions<TOptions = object> = {
  * getMode('src/gen/types')     // 'split'
  * ```
  */
-declare function getMode(fileOrFolder: string | undefined | null): Mode;
+declare function getMode(fileOrFolder: string | undefined | null): 'single' | 'split';
 declare class PluginDriver {
   #private;
   readonly config: Config;
   readonly options: Options;
   /**
-   * The universal `@kubb/ast` `RootNode` produced by the adapter, set by
+   * The universal `@kubb/ast` `InputNode` produced by the adapter, set by
    * the build pipeline after the adapter's `parse()` resolves.
    */
-  rootNode: RootNode | undefined;
+  inputNode: InputNode | undefined;
   adapter: Adapter | undefined;
+  /**
+   * Central file store for all generated files.
+   * Plugins should use `this.addFile()` / `this.upsertFile()` (via their context) to
+   * add files; this property gives direct read/write access when needed.
+   */
+  readonly fileManager: FileManager;
   readonly plugins: Map<string, Plugin>;
   constructor(config: Config, options: Options);
   get events(): AsyncEventEmitter<KubbEvents>;
@@ -1894,13 +1803,13 @@ declare class PluginDriver {
     extname,
     pluginName,
     options
-  }: GetFileOptions<TOptions>): File<{
+  }: GetFileOptions<TOptions>): FileNode<{
     pluginName: string;
   }>;
   /**
    * @deprecated use resolvers context instead
    */
-  resolvePath: <TOptions = object>(params: ResolvePathParams<TOptions>) => Path;
+  resolvePath: <TOptions = object>(params: ResolvePathParams<TOptions>) => string;
   /**
    * @deprecated use resolvers context instead
    */
@@ -1982,5 +1891,5 @@ declare class PluginDriver {
   requirePlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(pluginName: string): Plugin<TOptions>;
 }
 //#endregion
-export { FunctionParams as $, Preset as A, Resolver as B, Plugin as C, PluginLifecycleHooks as D, PluginLifecycle as E, ResolveBannerContext as F, UserConfig as G, ResolverFileParams as H, ResolveNameParams as I, UserPlugin as J, UserGroup as K, ResolveOptionsContext as L, Printer$1 as M, PrinterFactoryOptions as N, PluginParameter as O, PrinterPartial as P, getBarrelFiles as Q, ResolvePathOptions as R, Override as S, PluginFactoryOptions as T, ResolverPathParams as U, ResolverContext as V, SchemaHook as W, UserResolver as X, UserPluginWithLifeCycle as Y, FileMetaBase as Z, LoggerContext as _, KubbFile_d_exports as _t, AdapterSource as a, Parser as at, OperationsHook as b, ResolvedFile as bt, Config as c, Generator as ct, GeneratorContext as d, Storage as dt, FunctionParamsAST as et, Group as f, createStorage as ft, Logger as g, File as gt, InputPath as h, logLevel as ht, AdapterFactoryOptions as i, KubbEvents as it, Presets as j, PluginWithLifeCycle as k, DevtoolsOptions as l, defineGenerator as lt, InputData as m, linters as mt, getMode as n, ConfigInput as nt, BarrelType as o, UserParser as ot, Include as p, formatters as pt, UserLogger as q, Adapter as r, defineConfig as rt, CompatibilityPreset as s, defineParser as st, PluginDriver as t, CLIOptions as tt, Exclude as u, mergeGenerators as ut, LoggerOptions as v, Mode as vt, PluginContext as w, Output as x, AsyncEventEmitter as xt, OperationHook as y, Path as yt, ResolvePathParams as z };
-//# sourceMappingURL=PluginDriver-D0dY_hpJ.d.ts.map
+export { FunctionParams as $, Preset as A, Resolver as B, Plugin as C, PluginLifecycleHooks as D, PluginLifecycle as E, ResolveBannerContext as F, UserConfig as G, ResolverFileParams as H, ResolveNameParams as I, UserPlugin as J, UserGroup as K, ResolveOptionsContext as L, Printer$1 as M, PrinterFactoryOptions as N, PluginParameter as O, PrinterPartial as P, getBarrelFiles as Q, ResolvePathOptions as R, Override as S, PluginFactoryOptions as T, ResolverPathParams as U, ResolverContext as V, SchemaHook as W, UserResolver as X, UserPluginWithLifeCycle as Y, FileMetaBase as Z, LoggerContext as _, AdapterSource as a, Parser as at, OperationsHook as b, Config as c, Generator as ct, GeneratorContext as d, Storage as dt, FunctionParamsAST as et, Group as f, createStorage as ft, Logger as g, AsyncEventEmitter as gt, InputPath as h, logLevel as ht, AdapterFactoryOptions as i, KubbEvents as it, Presets as j, PluginWithLifeCycle as k, DevtoolsOptions as l, defineGenerator as lt, InputData as m, linters as mt, getMode as n, ConfigInput as nt, BarrelType as o, UserParser as ot, Include as p, formatters as pt, UserLogger as q, Adapter as r, defineConfig as rt, CompatibilityPreset as s, defineParser as st, PluginDriver as t, CLIOptions as tt, Exclude as u, mergeGenerators as ut, LoggerOptions as v, PluginContext as w, Output as x, OperationHook as y, ResolvePathParams as z };
+//# sourceMappingURL=PluginDriver-nm7tvGs9.d.ts.map

package/dist/chunk--u3MIqq1.js

@@ -0,0 +1,8 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", {
+	value,
+	configurable: true
+});
+//#endregion
+export { __name as t };