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

package/src/defineResolver.ts

@@ -1,8 +1,7 @@
 import path from 'node:path'
 import { camelCase, pascalCase } from '@internals/utils'
-import { isOperationNode, isSchemaNode } from '@kubb/ast'
-import type { Node, OperationNode, RootNode, SchemaNode } from '@kubb/ast/types'
-import type { FabricFile } from '@kubb/fabric-core/types'
+import { createFile, isOperationNode, isSchemaNode } from '@kubb/ast'
+import type { FileNode, InputNode, Node, OperationNode, SchemaNode } from '@kubb/ast/types'
 import { getMode } from './PluginDriver.ts'
 import type {
   Config,
@@ -195,27 +194,24 @@ export function defaultResolveOptions<TOptions>(
  * // → '/src/types'
  * ```
  */
-export function defaultResolvePath(
-  { baseName, pathMode, tag, path: groupPath }: ResolverPathParams,
-  { root, output, group }: ResolverContext,
-): FabricFile.Path {
+export function defaultResolvePath({ baseName, pathMode, tag, path: groupPath }: ResolverPathParams, { root, output, group }: ResolverContext): string {
   const mode = pathMode ?? getMode(path.resolve(root, output.path))
 
   if (mode === 'single') {
-    return path.resolve(root, output.path) as FabricFile.Path
+    return path.resolve(root, output.path)
   }
 
   if (group && (groupPath || tag)) {
-    return path.resolve(root, output.path, group.name({ group: group.type === 'path' ? groupPath! : tag! }), baseName) as FabricFile.Path
+    return path.resolve(root, output.path, group.name({ group: group.type === 'path' ? groupPath! : tag! }), baseName)
   }
 
-  return path.resolve(root, output.path, baseName) as FabricFile.Path
+  return path.resolve(root, output.path, baseName)
 }
 
 /**
  * Default file resolver used by `defineResolver`.
  *
- * Resolves a `FabricFile.File` by combining name resolution (`resolver.default`) with
+ * Resolves a `FileNode` by combining name resolution (`resolver.default`) with
  * path resolution (`resolver.resolvePath`). The resolved file always has empty
  * `sources`, `imports`, and `exports` arrays — consumers populate those separately.
  *
@@ -239,22 +235,22 @@ export function defaultResolvePath(
  * // → { baseName: 'listPets.ts', path: '/src/types/petsController/listPets.ts', ... }
  * ```
  */
-export function defaultResolveFile(this: Resolver, { name, extname, tag, path: groupPath }: ResolverFileParams, context: ResolverContext): FabricFile.File {
+export function defaultResolveFile(this: Resolver, { name, extname, tag, path: groupPath }: ResolverFileParams, context: ResolverContext): FileNode {
   const pathMode = getMode(path.resolve(context.root, context.output.path))
   const resolvedName = pathMode === 'single' ? '' : this.default(name, 'file')
-  const baseName = `${resolvedName}${extname}` as FabricFile.BaseName
+  const baseName = `${resolvedName}${extname}` as FileNode['baseName']
   const filePath = this.resolvePath({ baseName, pathMode, tag, path: groupPath }, context)
 
-  return {
+  return createFile({
     path: filePath,
-    baseName: path.basename(filePath) as FabricFile.BaseName,
+    baseName: path.basename(filePath) as `${string}.${string}`,
     meta: {
       pluginName: this.pluginName,
     },
     sources: [],
     imports: [],
     exports: [],
-  }
+  })
 }
 
 /**
@@ -336,13 +332,13 @@ export function buildDefaultBanner({
  *
  * @example Function banner with node
  * ```ts
- * defaultResolveBanner(rootNode, { output: { banner: (node) => `// v${node.version}` }, config })
+ * defaultResolveBanner(inputNode, { output: { banner: (node) => `// v${node.version}` }, config })
  * // → '// v3.0.0'
  * ```
  *
  * @example No user banner — Kubb notice with OAS metadata
  * ```ts
- * defaultResolveBanner(rootNode, { config })
+ * defaultResolveBanner(inputNode, { config })
  * // → '/** Generated by Kubb ... Title: Pet Store ... *\/'
  * ```
  *
@@ -352,7 +348,7 @@ export function buildDefaultBanner({
  * // → undefined
  * ```
  */
-export function defaultResolveBanner(node: RootNode | undefined, { output, config }: ResolveBannerContext): string | undefined {
+export function defaultResolveBanner(node: InputNode | undefined, { output, config }: ResolveBannerContext): string | undefined {
   if (typeof output?.banner === 'function') {
     return output.banner(node)
   }
@@ -384,11 +380,11 @@ export function defaultResolveBanner(node: RootNode | undefined, { output, confi
  *
  * @example Function footer with node
  * ```ts
- * defaultResolveFooter(rootNode, { output: { footer: (node) => `// ${node.title}` }, config })
+ * defaultResolveFooter(inputNode, { output: { footer: (node) => `// ${node.title}` }, config })
  * // → '// Pet Store'
  * ```
  */
-export function defaultResolveFooter(node: RootNode | undefined, { output }: ResolveBannerContext): string | undefined {
+export function defaultResolveFooter(node: InputNode | undefined, { output }: ResolveBannerContext): string | undefined {
   if (typeof output?.footer === 'function') {
     return node ? output.footer(node) : undefined
   }
@@ -406,7 +402,7 @@ export function defaultResolveFooter(node: RootNode | undefined, { output }: Res
  * - `default` — name casing strategy (camelCase / PascalCase)
  * - `resolveOptions` — include/exclude/override filtering
  * - `resolvePath` — output path computation
- * - `resolveFile` — full `FabricFile.File` construction
+ * - `resolveFile` — full `FileNode` construction
  *
  * Methods in the builder have access to `this` (the full resolver object), so they
  * can call other resolver methods without circular imports.

package/src/devtools.ts

@@ -1,10 +1,10 @@
-import type { RootNode } from '@kubb/ast/types'
+import type { InputNode } from '@kubb/ast/types'
 import { deflateSync, inflateSync } from 'fflate'
 import { x } from 'tinyexec'
 import type { DevtoolsOptions } from './types.ts'
 
 /**
- * Encodes a `RootNode` as a compressed, URL-safe string.
+ * Encodes an `InputNode` as a compressed, URL-safe string.
  *
  * The JSON representation is deflate-compressed with {@link deflateSync} before
  * base64url encoding, which typically reduces payload size by 70–80 % and
@@ -12,41 +12,41 @@ import type { DevtoolsOptions } from './types.ts'
  *
  * Use {@link decodeAst} to reverse.
  */
-export function encodeAst(root: RootNode): string {
-  const compressed = deflateSync(new TextEncoder().encode(JSON.stringify(root)))
+export function encodeAst(input: InputNode): string {
+  const compressed = deflateSync(new TextEncoder().encode(JSON.stringify(input)))
   return Buffer.from(compressed).toString('base64url')
 }
 
 /**
- * Decodes a `RootNode` from a string produced by {@link encodeAst}.
+ * Decodes an `InputNode` from a string produced by {@link encodeAst}.
  *
  * Works in both Node.js and the browser — no streaming APIs required.
  */
-export function decodeAst(encoded: string): RootNode {
+export function decodeAst(encoded: string): InputNode {
   const bytes = Buffer.from(encoded, 'base64url')
-  return JSON.parse(new TextDecoder().decode(inflateSync(bytes))) as RootNode
+  return JSON.parse(new TextDecoder().decode(inflateSync(bytes))) as InputNode
 }
 
 /**
- * Constructs the Kubb Studio URL for the given `RootNode`.
+ * Constructs the Kubb Studio URL for the given `InputNode`.
  * When `options.ast` is `true`, navigates to the AST inspector (`/ast`).
- * The `root` is encoded and attached as the `?root=` query parameter so Studio
+ * The `input` is encoded and attached as the `?root=` query parameter so Studio
  * can decode and render it without a round-trip to any server.
  */
-export function getStudioUrl(root: RootNode, studioUrl: string, options: DevtoolsOptions = {}): string {
+export function getStudioUrl(input: InputNode, studioUrl: string, options: DevtoolsOptions = {}): string {
   const baseUrl = studioUrl.replace(/\/$/, '')
   const path = options.ast ? '/ast' : ''
 
-  return `${baseUrl}${path}?root=${encodeAst(root)}`
+  return `${baseUrl}${path}?root=${encodeAst(input)}`
 }
 
 /**
- * Opens the Kubb Studio URL for the given `RootNode` in the default browser —
+ * Opens the Kubb Studio URL for the given `InputNode` in the default browser —
  *
  * Falls back to printing the URL if the browser cannot be launched.
  */
-export async function openInStudio(root: RootNode, studioUrl: string, options: DevtoolsOptions = {}): Promise<void> {
-  const url = getStudioUrl(root, studioUrl, options)
+export async function openInStudio(input: InputNode, studioUrl: string, options: DevtoolsOptions = {}): Promise<void> {
+  const url = getStudioUrl(input, studioUrl, options)
 
   const cmd = process.platform === 'win32' ? 'cmd' : process.platform === 'darwin' ? 'open' : 'xdg-open'
   const args = process.platform === 'win32' ? ['/c', 'start', '', url] : [url]

package/src/hooks/useMode.ts

@@ -1,11 +1,10 @@
-import type { FabricFile } from '@kubb/fabric-core/types'
 import { useFabric } from '@kubb/react-fabric'
 
 /**
  * @deprecated use `mode` from the generator component props instead
  */
-export function useMode(): FabricFile.Mode {
-  const { meta } = useFabric<{ mode: FabricFile.Mode }>()
+export function useMode(): 'single' | 'split' {
+  const { meta } = useFabric<{ mode: 'single' | 'split' }>()
 
   return meta.mode
 }

package/src/index.ts

@@ -1,13 +1,14 @@
 export { AsyncEventEmitter, URLPath } from '@internals/utils'
 export { composeTransformers, definePrinter } from '@kubb/ast'
 export { build, build as default, safeBuild, setup } from './build.ts'
-export { type CLIOptions, type ConfigInput, defineConfig, isInputPath } from './config.ts'
 export { formatters, linters, logLevel } from './constants.ts'
 export { createAdapter } from './createAdapter.ts'
 export { createPlugin } from './createPlugin.ts'
 export { createStorage } from './createStorage.ts'
+export { defineConfig } from './defineConfig.ts'
 export { defineGenerator, mergeGenerators } from './defineGenerator.ts'
 export { defineLogger } from './defineLogger.ts'
+export { defineParser } from './defineParser.ts'
 export { definePresets } from './definePresets.ts'
 export {
   buildDefaultBanner,
@@ -22,12 +23,11 @@ export { getMode, PluginDriver } from './PluginDriver.ts'
 export { fsStorage } from './storages/fsStorage.ts'
 export { memoryStorage } from './storages/memoryStorage.ts'
 export * from './types.ts'
-export type { FunctionParamsAST } from './utils/FunctionParams.ts'
 export { FunctionParams } from './utils/FunctionParams.ts'
 export { detectFormatter } from './utils/formatters.ts'
-export type { FileMetaBase } from './utils/getBarrelFiles.ts'
 export { getBarrelFiles } from './utils/getBarrelFiles.ts'
 export { getConfigs } from './utils/getConfigs.ts'
 export { getPreset } from './utils/getPreset.ts'
+export { isInputPath } from './utils/isInputPath.ts'
 export { detectLinter } from './utils/linters.ts'
 export { satisfiesDependency } from './utils/packageJSON.ts'

package/src/renderNode.tsx

@@ -1,25 +1,26 @@
-import type { FabricFile } from '@kubb/fabric-core/types'
+import type { FileNode } from '@kubb/ast/types'
 import { createReactFabric, Fabric } from '@kubb/react-fabric'
-import type { FabricReactNode, Fabric as FabricType } from '@kubb/react-fabric/types'
+import type { FabricReactNode } from '@kubb/react-fabric/types'
+import type { PluginDriver } from './PluginDriver.ts'
 
 /**
  * Handles the return value of a plugin AST hook or generator method.
  *
- * - React element → rendered via an isolated react-fabric context, files merged into `fabric`
- * - `Array<FabricFile.File>` → upserted directly into `fabric`
+ * - React element → rendered via an isolated react-fabric context, files stored in `driver.fileManager`
+ * - `Array<FileNode>` → upserted directly into `driver.fileManager`
  * - `void` / `null` / `undefined` → no-op (plugin handled it via `this.upsertFile`)
  */
-export async function applyHookResult(result: FabricReactNode | Array<FabricFile.File> | void, fabric: FabricType): Promise<void> {
+export async function applyHookResult(result: FabricReactNode | Array<FileNode> | void, driver: PluginDriver): Promise<void> {
   if (!result) return
 
   if (Array.isArray(result)) {
-    await fabric.upsertFile(...(result as Array<FabricFile.File>))
+    driver.fileManager.upsert(...(result as Array<FileNode>))
     return
   }
 
   // Non-array truthy result is treated as a React element (FabricReactNode)
   const fabricChild = createReactFabric()
   await fabricChild.render(<Fabric>{result as FabricReactNode}</Fabric>)
-  fabric.context.fileManager.upsert(...fabricChild.files)
+  driver.fileManager.upsert(...(fabricChild.files as unknown as Array<FileNode>))
   fabricChild.unmount()
 }

package/src/types.ts

@@ -1,11 +1,11 @@
 import type { AsyncEventEmitter, PossiblePromise } from '@internals/utils'
-import type { Node, OperationNode, Printer, RootNode, SchemaNode, Visitor } from '@kubb/ast/types'
-import type { FabricFile, Fabric as FabricType } from '@kubb/fabric-core/types'
+import type { FileNode, ImportNode, InputNode, Node, OperationNode, Printer, SchemaNode, Visitor } from '@kubb/ast/types'
 import type { HttpMethod } from '@kubb/oas'
 import type { FabricReactNode } from '@kubb/react-fabric/types'
 import type { DEFAULT_STUDIO_URL, logLevel } from './constants.ts'
 import type { Storage } from './createStorage.ts'
 import type { Generator } from './defineGenerator.ts'
+import type { Parser } from './defineParser.ts'
 import type { KubbEvents } from './Kubb.ts'
 import type { PluginDriver } from './PluginDriver.ts'
 
@@ -44,12 +44,43 @@ declare global {
  * ...
  * })
  */
-export type UserConfig<TInput = Input> = Omit<Config<TInput>, 'root' | 'plugins'> & {
+export type UserConfig<TInput = Input> = Omit<Config<TInput>, 'root' | 'plugins' | 'parsers' | 'adapter'> & {
   /**
    * The project root directory, which can be either an absolute path or a path relative to the location of your `kubb.config.ts` file.
    * @default process.cwd()
    */
   root?: string
+  /**
+   * An array of parsers used to convert generated files to strings.
+   * Each parser handles specific file extensions (e.g. `.ts`, `.tsx`).
+   *
+   * A catch-all fallback parser is always appended last for any unhandled extension.
+   *
+   * When omitted, `parserTs` from `@kubb/parser-ts` is used automatically as the
+   * default (requires `@kubb/parser-ts` to be installed as an optional dependency).
+   * @default [parserTs] — from `@kubb/parser-ts`
+   * @example
+   * ```ts
+   * import { parserTs, tsxParser } from '@kubb/parser-ts'
+   * export default defineConfig({
+   *   parsers: [parserTs, tsxParser],
+   * })
+   * ```
+   */
+  parsers?: Array<Parser>
+  /**
+   * 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
+   * default (requires `@kubb/adapter-oas` to be installed as an optional dependency).
+   *
+   * - Use `@kubb/adapter-oas` for OpenAPI / Swagger (default).
+   * - Use `@kubb/adapter-drizzle` or `@kubb/adapter-asyncapi` for other formats.
+   *
+   * @default adapterOas() — from `@kubb/adapter-oas`
+   */
+  adapter?: Adapter
   /**
    * An array of Kubb plugins used for generation. Each plugin may have additional configurable options (defined within the plugin itself). If a plugin relies on another plugin, an error will occur if the required dependency is missing. Refer to “pre” for more details.
    */
@@ -71,7 +102,7 @@ export type InputData = {
   data: string | unknown
 }
 
-type Input = InputPath | InputData | Array<InputPath>
+type Input = InputPath | InputData
 
 /**
  * The raw source passed to an adapter's `parse` function.
@@ -101,10 +132,10 @@ export type AdapterFactoryOptions<
 }
 
 /**
- * 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
@@ -132,19 +163,19 @@ export type Adapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptio
    * `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 `FabricFile.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
    * return the `{ name, path }` pair for the import, or `undefined` to skip it.
    */
-  getImports: (node: SchemaNode, resolve: (schemaName: string) => { name: string; path: string }) => Array<FabricFile.Import>
+  getImports: (node: SchemaNode, resolve: (schemaName: string) => { name: string; path: string }) => Array<ImportNode>
 }
 
 export type BarrelType = 'all' | 'named' | 'propagate'
@@ -172,23 +203,40 @@ export type Config<TInput = Input> = {
    */
   root: string
   /**
-   * Adapter that converts the input file into a `@kubb/ast` `RootNode` — the universal
+   * An array of parsers used to convert generated files to strings.
+   * Each parser handles specific file extensions (e.g. `.ts`, `.tsx`).
+   *
+   * A catch-all fallback parser is always appended last for any unhandled extension.
+   *
+   * When omitted, `parserTs` from `@kubb/parser-ts` is used automatically as the
+   * default (requires `@kubb/parser-ts` to be installed as an optional dependency).
+   * @default [parserTs] — from `@kubb/parser-ts`
+   * @example
+   * ```ts
+   * import { parserTs, tsxParser } from '@kubb/parser-ts'
+   * export default defineConfig({
+   *   parsers: [parserTs, tsxParser],
+   * })
+   * ```
+   */
+  parsers: Array<Parser>
+  /**
+   * Adapter that converts the input file into a `@kubb/ast` `InputNode` — the universal
    * intermediate representation consumed by all Kubb plugins.
    *
-   * - Omit (or pass `undefined`) to use the built-in OpenAPI/Swagger adapter.
-   * - Use `@kubb/adapter-oas` for explicit OpenAPI configuration (validate, contentType, …).
+   * - Use `@kubb/adapter-oas` for OpenAPI / Swagger.
    * - Use `@kubb/adapter-drizzle` or `@kubb/adapter-asyncapi` for other formats.
    *
    * @example
    * ```ts
-   * import { drizzleAdapter } from '@kubb/adapter-drizzle'
+   * import { adapterOas } from '@kubb/adapter-oas'
    * export default defineConfig({
-   *   adapter: drizzleAdapter(),
-   *   input: { path: './src/schema.ts' },
+   *   adapter: adapterOas(),
+   *   input: { path: './petStore.yaml' },
    * })
    * ```
    */
-  adapter?: Adapter
+  adapter: Adapter
   /**
    * You can use either `input.path` or `input.data`, depending on your specific needs.
    */
@@ -246,7 +294,7 @@ export type Config<TInput = Input> = {
      * Overrides the extension for generated imports and exports. By default, each plugin adds an extension.
      * @default { '.ts': '.ts'}
      */
-    extension?: Record<FabricFile.Extname, FabricFile.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'
@@ -346,10 +394,10 @@ export 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): FabricFile.Path
-  resolveFile(params: ResolverFileParams, context: ResolverContext): FabricFile.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
 }
 
 /**
@@ -477,7 +525,7 @@ export type SchemaHook<TOptions extends PluginFactoryOptions = PluginFactoryOpti
   this: GeneratorContext<TOptions>,
   node: SchemaNode,
   options: TOptions['resolvedOptions'],
-) => PossiblePromise<FabricReactNode | Array<FabricFile.File> | void>
+) => PossiblePromise<FabricReactNode | Array<FileNode> | void>
 
 /**
  * Handler for a single operation node. Used by the `operation` hook on a plugin.
@@ -486,7 +534,7 @@ export type OperationHook<TOptions extends PluginFactoryOptions = PluginFactoryO
   this: GeneratorContext<TOptions>,
   node: OperationNode,
   options: TOptions['resolvedOptions'],
-) => PossiblePromise<FabricReactNode | Array<FabricFile.File> | void>
+) => PossiblePromise<FabricReactNode | Array<FileNode> | void>
 
 /**
  * Handler for all collected operation nodes. Used by the `operations` hook on a plugin.
@@ -495,7 +543,7 @@ export type OperationsHook<TOptions extends PluginFactoryOptions = PluginFactory
   this: GeneratorContext<TOptions>,
   nodes: Array<OperationNode>,
   options: TOptions['resolvedOptions'],
-) => PossiblePromise<FabricReactNode | Array<FabricFile.File> | void>
+) => PossiblePromise<FabricReactNode | Array<FileNode> | void>
 
 export type Plugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
   /**
@@ -552,7 +600,7 @@ export 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 `FabricFile.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.
@@ -560,7 +608,7 @@ export 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 `FabricFile.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.
    */
@@ -595,7 +643,7 @@ export type PluginLifecycle<TOptions extends PluginFactoryOptions = PluginFactor
   buildEnd?: (this: PluginContext<TOptions>) => PossiblePromise<void>
   /**
    * Called for each schema node during the AST walk.
-   * Return a React element (`<File>...</File>`), an array of `FabricFile.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.
    *
@@ -604,7 +652,7 @@ export type PluginLifecycle<TOptions extends PluginFactoryOptions = PluginFactor
   schema?: SchemaHook<TOptions>
   /**
    * Called for each operation node during the AST walk.
-   * Return a React element (`<File>...</File>`), an array of `FabricFile.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.
@@ -624,12 +672,7 @@ export type PluginLifecycle<TOptions extends PluginFactoryOptions = PluginFactor
    * @example ('./Pet.ts', './src/gen/') => '/src/gen/Pet.ts'
    * @deprecated this will be replaced by resolvers
    */
-  resolvePath?: (
-    this: PluginContext<TOptions>,
-    baseName: FabricFile.BaseName,
-    mode?: FabricFile.Mode,
-    options?: TOptions['resolvePathOptions'],
-  ) => FabricFile.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.
@@ -646,8 +689,8 @@ export type PluginParameter<H extends PluginLifecycleHooks> = Parameters<Require
 
 export type ResolvePathParams<TOptions = object> = {
   pluginName?: string
-  baseName: FabricFile.BaseName
-  mode?: FabricFile.Mode
+  baseName: FileNode['baseName']
+  mode?: 'single' | 'split'
   /**
    * Options to be passed to 'resolvePath' 3th parameter
    */
@@ -669,7 +712,6 @@ export type ResolveNameParams = {
 }
 
 export type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
-  fabric: FabricType
   config: Config
   /**
    * Absolute path to the output directory for the current plugin.
@@ -681,7 +723,7 @@ export type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryO
    * Returns `'single'` when `output.path` has a file extension, `'split'` otherwise.
    * Shorthand for `getMode(path.resolve(this.root, output.path))`.
    */
-  getMode: (output: { path: string }) => FabricFile.Mode
+  getMode: (output: { path: string }) => 'single' | 'split'
   driver: PluginDriver
   /**
    * Get a plugin by name. Returns the plugin typed via `Kubb.PluginRegistry` when
@@ -698,11 +740,11 @@ export type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryO
   /**
    * Only add when the file does not exist yet
    */
-  addFile: (...file: Array<FabricFile.File>) => Promise<void>
+  addFile: (...file: Array<FileNode>) => Promise<void>
   /**
    * merging multiple sources into the same output file
    */
-  upsertFile: (...file: Array<FabricFile.File>) => Promise<void>
+  upsertFile: (...file: Array<FileNode>) => Promise<void>
   /**
    * @deprecated use this.warn, this.error, this.info instead
    */
@@ -737,25 +779,25 @@ export type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryO
    */
   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
     }
 ) &
@@ -766,12 +808,12 @@ export type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryO
  *
  * 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.
  */
-export type GeneratorContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = Omit<PluginContext<TOptions>, 'adapter' | 'rootNode'> & {
+export 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
@@ -789,11 +831,11 @@ export 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
@@ -966,8 +1008,8 @@ export type ResolvePathOptions = {
  * ```
  */
 export type ResolverPathParams = {
-  baseName: FabricFile.BaseName
-  pathMode?: FabricFile.Mode
+  baseName: FileNode['baseName']
+  pathMode?: 'single' | 'split'
   /**
    * Tag value used when `group.type === 'tag'`.
    */
@@ -1020,7 +1062,7 @@ export type ResolverContext = {
  */
 export type ResolverFileParams = {
   name: string
-  extname: FabricFile.Extname
+  extname: FileNode['extname']
   /**
    * Tag value used when `group.type === 'tag'`.
    */
@@ -1039,7 +1081,7 @@ export type ResolverFileParams = {
  *
  * @example
  * ```ts
- * resolver.resolveBanner(rootNode, { output: { banner: '// generated' }, config })
+ * resolver.resolveBanner(inputNode, { output: { banner: '// generated' }, config })
  * // → '// generated'
  * ```
  */
@@ -1047,3 +1089,8 @@ export type ResolveBannerContext = {
   output?: Pick<Output, 'banner' | 'footer'>
   config: Config
 }
+
+export type { CLIOptions, ConfigInput } from './defineConfig.ts'
+export type { Parser, UserParser } from './defineParser.ts'
+export type { FunctionParamsAST } from './utils/FunctionParams.ts'
+export type { FileMetaBase } from './utils/getBarrelFiles.ts'