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

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { t as __name } from "./chunk--u3MIqq1.js";
-import { $ as defineGenerator, A as Preset, B as Resolver, C as Plugin, D as PluginLifecycleHooks, E as PluginLifecycle, F as ResolveBannerContext, G as UserConfig, H as ResolverFileParams, I as ResolveNameParams, J as UserPlugin, K as UserGroup, L as ResolveOptionsContext, M as Printer, N as PrinterFactoryOptions, O as PluginParameter, P as PrinterPartial, Q as Generator, R as ResolvePathOptions, S as Override, T as PluginFactoryOptions, U as ResolverPathParams, V as ResolverContext, W as SchemaHook, X as UserResolver, Y as UserPluginWithLifeCycle, Z as KubbEvents, _ as LoggerContext, a as AdapterSource, at as logLevel, b as OperationsHook, c as Config, d as GeneratorContext, et as mergeGenerators, f as Group, g as Logger, h as InputPath, i as AdapterFactoryOptions, it as linters, j as Presets, k as PluginWithLifeCycle, l as DevtoolsOptions, m as InputData, n as getMode, nt as createStorage, o as BarrelType, ot as PossiblePromise, p as Include, q as UserLogger, r as Adapter, rt as formatters, s as CompatibilityPreset, st as AsyncEventEmitter, t as PluginDriver, tt as Storage, u as Exclude, v as LoggerOptions, w as PluginContext, x as Output, y as OperationHook, z as ResolvePathParams } from "./PluginDriver-D110FoJ-.js";
+import { n as __name } from "./chunk-O_arW02_.js";
+import { $ as FunctionParams, A as Preset, B as Resolver, C as Plugin, D as PluginLifecycleHooks, E as PluginLifecycle, F as ResolveBannerContext, G as UserConfig, H as ResolverFileParams, I as ResolveNameParams, J as UserPlugin, K as UserGroup, L as ResolveOptionsContext, M as Printer, N as PrinterFactoryOptions, O as PluginParameter, P as PrinterPartial, Q as getBarrelFiles, R as ResolvePathOptions, S as Override, T as PluginFactoryOptions, U as ResolverPathParams, V as ResolverContext, W as SchemaHook, X as UserResolver, Y as UserPluginWithLifeCycle, Z as FileMetaBase, _ as LoggerContext, _t as KubbFile_d_exports, a as AdapterSource, at as Parser, b as OperationsHook, bt as ResolvedFile, c as Config, ct as Generator, d as GeneratorContext, dt as Storage, et as FunctionParamsAST, f as Group, ft as createStorage, g as Logger, gt as File, h as InputPath, ht as logLevel, i as AdapterFactoryOptions, it as KubbEvents, j as Presets, k as PluginWithLifeCycle, l as DevtoolsOptions, lt as defineGenerator, m as InputData, mt as linters, n as getMode, nt as ConfigInput, o as BarrelType, ot as UserParser, p as Include, pt as formatters, q as UserLogger, r as Adapter, rt as defineConfig, s as CompatibilityPreset, st as defineParser, t as PluginDriver, tt as CLIOptions, u as Exclude, ut as mergeGenerators, v as LoggerOptions, w as PluginContext, x as Output, xt as AsyncEventEmitter, y as OperationHook, yt as Path, z as ResolvePathParams } from "./PluginDriver-D0dY_hpJ.js";
 import { composeTransformers, definePrinter } from "@kubb/ast";
 import { Node, RootNode, Visitor } from "@kubb/ast/types";
-import { Fabric, FabricFile } from "@kubb/fabric-core/types";
+import { Fabric } from "@kubb/fabric-core/types";
 
 //#region ../../internals/utils/src/urlPath.d.ts
 type URLObject = {
@@ -157,7 +157,7 @@ type BuildOutput = {
     error: Error;
   }>;
   fabric: Fabric;
-  files: Array<FabricFile.ResolvedFile>;
+  files: Array<ResolvedFile>;
   driver: PluginDriver;
   /**
    * Elapsed time in milliseconds for each plugin, keyed by plugin name.
@@ -167,7 +167,7 @@ type BuildOutput = {
   /**
    * Raw generated source, keyed by absolute file path.
    */
-  sources: Map<FabricFile.Path, string>;
+  sources: Map<Path, string>;
 };
 /**
  * Intermediate result returned by {@link setup} and accepted by {@link safeBuild}.
@@ -176,7 +176,8 @@ type SetupResult = {
   events: AsyncEventEmitter<KubbEvents>;
   fabric: Fabric;
   driver: PluginDriver;
-  sources: Map<FabricFile.Path, string>;
+  sources: Map<Path, string>;
+  config: Config;
 };
 /**
  * Initializes all Kubb infrastructure for a build without executing any plugins.
@@ -185,6 +186,7 @@ type SetupResult = {
  * - Applies config defaults (`root`, `output.*`, `devtools`).
  * - Creates the Fabric instance and wires storage, format, and lint hooks.
  * - Runs the adapter (if configured) to produce the universal `RootNode`.
+ *   When no adapter is supplied and `@kubb/adapter-oas` is installed as an
  *
  * Pass the returned {@link SetupResult} directly to {@link safeBuild} or {@link build}
  * via the `overrides` argument to reuse the same infrastructure across multiple runs.
@@ -209,54 +211,6 @@ declare function build(options: BuildOptions, overrides?: SetupResult): Promise<
  */
 declare function safeBuild(options: BuildOptions, overrides?: SetupResult): Promise<BuildOutput>;
 //#endregion
-//#region src/config.d.ts
-/**
- * CLI options derived from command-line flags.
- */
-type CLIOptions = {
-  /**
-   * Path to `kubb.config.js`.
-   */
-  config?: string;
-  /**
-   * Enable watch mode for input files.
-   */
-  watch?: boolean;
-  /**
-   * Logging verbosity for CLI usage.
-   *
-   * - `silent`: hide non-essential logs
-   * - `info`: show general logs (non-plugin-related)
-   * - `debug`: include detailed plugin lifecycle logs
-   * @default 'silent'
-   */
-  logLevel?: 'silent' | 'info' | 'debug';
-};
-/**
- * All accepted forms of a Kubb configuration.
- */
-type ConfigInput = PossiblePromise<UserConfig | UserConfig[]> | ((cli: CLIOptions) => PossiblePromise<UserConfig | UserConfig[]>);
-/**
- * Helper for defining a Kubb configuration.
- *
- * Accepts either:
- * - A config object or array of configs
- * - A function returning the config(s), optionally async,
- *   receiving the CLI options as argument
- *
- * @example
- * export default defineConfig(({ logLevel }) => ({
- *   root: 'src',
- *   plugins: [myPlugin()],
- * }))
- */
-declare function defineConfig(config: (cli: CLIOptions) => PossiblePromise<UserConfig | UserConfig[]>): typeof config;
-declare function defineConfig(config: PossiblePromise<UserConfig | UserConfig[]>): typeof config;
-/**
- * Type guard to check if a given config has an `input.path`.
- */
-declare function isInputPath(config: UserConfig | undefined): config is UserConfig<InputPath>;
-//#endregion
 //#region src/createAdapter.d.ts
 /**
  * Builder type for an {@link Adapter} — takes options and returns the adapter instance.
@@ -426,11 +380,11 @@ declare function defaultResolvePath({
   root,
   output,
   group
-}: ResolverContext): FabricFile.Path;
+}: ResolverContext): Path;
 /**
  * Default file resolver used by `defineResolver`.
  *
- * Resolves a `FabricFile.File` by combining name resolution (`resolver.default`) with
+ * Resolves a `KubbFile.File` 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.
  *
@@ -459,7 +413,7 @@ declare function defaultResolveFile(this: Resolver, {
   extname,
   tag,
   path: groupPath
-}: ResolverFileParams, context: ResolverContext): FabricFile.File;
+}: ResolverFileParams, context: ResolverContext): File;
 /**
  * Generates the default "Generated by Kubb" banner from config and optional node metadata.
  */
@@ -546,7 +500,7 @@ declare function defaultResolveFooter(node: RootNode | undefined, {
  * - `default` — name casing strategy (camelCase / PascalCase)
  * - `resolveOptions` — include/exclude/override filtering
  * - `resolvePath` — output path computation
- * - `resolveFile` — full `FabricFile.File` construction
+ * - `resolveFile` — full `KubbFile.File` construction
  *
  * Methods in the builder have access to `this` (the full resolver object), so they
  * can call other resolver methods without circular imports.
@@ -632,50 +586,6 @@ declare const fsStorage: (options?: Record<string, never> | undefined) => Storag
  */
 declare const memoryStorage: (options?: Record<string, never> | undefined) => Storage;
 //#endregion
-//#region src/utils/FunctionParams.d.ts
-type FunctionParamsASTWithoutType = {
-  name?: string;
-  type?: string;
-  /**
-   * @default true
-   */
-  required?: boolean;
-  /**
-   * @default true
-   */
-  enabled?: boolean;
-  default?: string;
-};
-type FunctionParamsASTWithType = {
-  name?: never;
-  type: string;
-  /**
-   * @default true
-   */
-  required?: boolean;
-  /**
-   * @default true
-   */
-  enabled?: boolean;
-  default?: string;
-};
-/**
- * @deprecated use ast package instead
- */
-type FunctionParamsAST = FunctionParamsASTWithoutType | FunctionParamsASTWithType;
-/**
- * @deprecated use ast package instead
- */
-declare class FunctionParams {
-  #private;
-  get items(): FunctionParamsAST[];
-  add(item: FunctionParamsAST | Array<FunctionParamsAST | FunctionParamsAST[] | undefined> | undefined): FunctionParams;
-  static toObject(items: FunctionParamsAST[]): FunctionParamsAST;
-  toObject(): FunctionParamsAST;
-  static toString(items: (FunctionParamsAST | FunctionParamsAST[])[]): string;
-  toString(): string;
-}
-//#endregion
 //#region src/utils/formatters.d.ts
 type Formatter = keyof typeof formatters;
 /**
@@ -694,43 +604,6 @@ type Formatter = keyof typeof formatters;
  */
 declare function detectFormatter(): Promise<Formatter | null>;
 //#endregion
-//#region src/utils/getBarrelFiles.d.ts
-type FileMetaBase = {
-  pluginName?: string;
-};
-type AddIndexesProps = {
-  type: BarrelType | false | undefined;
-  /**
-   * Root based on root and output.path specified in the config
-   */
-  root: string;
-  /**
-   * Output for plugin
-   */
-  output: {
-    path: string;
-  };
-  group?: {
-    output: string;
-    exportAs: string;
-  };
-  meta?: FileMetaBase;
-};
-/**
- * Generates `index.ts` barrel files for all directories under `root/output.path`.
- *
- * - Returns an empty array when `type` is falsy or `'propagate'`.
- * - Skips generation when the output path itself ends with `index` (already a barrel).
- * - 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<FabricFile.ResolvedFile>, {
-  type,
-  meta,
-  root,
-  output
-}: AddIndexesProps): Promise<Array<FabricFile.File>>;
-//#endregion
 //#region src/utils/getConfigs.d.ts
 /**
  * Resolves a {@link ConfigInput} into a normalized array of {@link Config} objects.
@@ -775,6 +648,12 @@ type GetPresetResult<TResolver extends Resolver> = {
  */
 declare function getPreset<TResolver extends Resolver = Resolver>(params: GetPresetParams<TResolver>): GetPresetResult<TResolver>;
 //#endregion
+//#region src/utils/isInputPath.d.ts
+/**
+ * Type guard to check if a given config has an `input.path`.
+ */
+declare function isInputPath(config: UserConfig | undefined): config is UserConfig<InputPath>;
+//#endregion
 //#region src/utils/linters.d.ts
 type Linter = keyof typeof linters;
 /**
@@ -813,5 +692,5 @@ type DependencyVersion = string;
  */
 declare function satisfiesDependency(dependency: DependencyName | RegExp, version: DependencyVersion, cwd?: string): boolean;
 //#endregion
-export { Adapter, AdapterFactoryOptions, AdapterSource, AsyncEventEmitter, BarrelType, type CLIOptions, CompatibilityPreset, Config, type ConfigInput, DevtoolsOptions, Exclude, type FileMetaBase, FunctionParams, type FunctionParamsAST, Generator, GeneratorContext, Group, Include, InputData, InputPath, KubbEvents, Logger, LoggerContext, LoggerOptions, OperationHook, OperationsHook, Output, Override, Plugin, PluginContext, PluginDriver, PluginFactoryOptions, PluginLifecycle, PluginLifecycleHooks, PluginParameter, PluginWithLifeCycle, Preset, Presets, Printer, PrinterFactoryOptions, PrinterPartial, ResolveBannerContext, ResolveNameParams, ResolveOptionsContext, ResolvePathOptions, ResolvePathParams, Resolver, ResolverContext, ResolverFileParams, ResolverPathParams, SchemaHook, Storage, URLPath, UserConfig, UserGroup, UserLogger, UserPlugin, UserPluginWithLifeCycle, UserResolver, build, build as default, buildDefaultBanner, composeTransformers, createAdapter, createPlugin, createStorage, defaultResolveBanner, defaultResolveFile, defaultResolveFooter, defaultResolveOptions, defaultResolvePath, defineConfig, defineGenerator, defineLogger, definePresets, definePrinter, defineResolver, detectFormatter, detectLinter, formatters, fsStorage, getBarrelFiles, getConfigs, getMode, getPreset, isInputPath, linters, logLevel, memoryStorage, mergeGenerators, safeBuild, satisfiesDependency, setup };
+export { Adapter, AdapterFactoryOptions, AdapterSource, AsyncEventEmitter, BarrelType, CLIOptions, CompatibilityPreset, Config, ConfigInput, DevtoolsOptions, Exclude, FileMetaBase, FunctionParams, FunctionParamsAST, Generator, GeneratorContext, Group, Include, InputData, InputPath, KubbEvents, KubbFile_d_exports as KubbFile, Logger, LoggerContext, LoggerOptions, OperationHook, OperationsHook, Output, Override, Parser, Plugin, PluginContext, PluginDriver, PluginFactoryOptions, PluginLifecycle, PluginLifecycleHooks, PluginParameter, PluginWithLifeCycle, Preset, Presets, Printer, PrinterFactoryOptions, PrinterPartial, ResolveBannerContext, ResolveNameParams, ResolveOptionsContext, ResolvePathOptions, ResolvePathParams, Resolver, ResolverContext, ResolverFileParams, ResolverPathParams, SchemaHook, Storage, URLPath, UserConfig, UserGroup, UserLogger, UserParser, UserPlugin, UserPluginWithLifeCycle, UserResolver, build, build as default, buildDefaultBanner, composeTransformers, createAdapter, createPlugin, createStorage, defaultResolveBanner, defaultResolveFile, defaultResolveFooter, defaultResolveOptions, defaultResolvePath, defineConfig, defineGenerator, defineLogger, defineParser, definePresets, definePrinter, defineResolver, detectFormatter, detectLinter, formatters, fsStorage, getBarrelFiles, getConfigs, getMode, getPreset, isInputPath, linters, logLevel, memoryStorage, mergeGenerators, safeBuild, satisfiesDependency, setup };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,11 +1,10 @@
-import "./chunk--u3MIqq1.js";
+import { t as __exportAll } from "./chunk-O_arW02_.js";
 import { EventEmitter } from "node:events";
 import { readFileSync } from "node:fs";
 import { access, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
 import path, { basename, dirname, extname, join, posix, relative, resolve } from "node:path";
 import { composeTransformers, composeTransformers as composeTransformers$1, definePrinter, isOperationNode, isSchemaNode, transform, walk } from "@kubb/ast";
 import { Fabric, createFabric, createReactFabric } from "@kubb/react-fabric";
-import { typescriptParser } from "@kubb/react-fabric/parsers";
 import { fsPlugin } from "@kubb/react-fabric/plugins";
 import { performance } from "node:perf_hooks";
 import { deflateSync } from "fflate";
@@ -615,17 +614,6 @@ var URLPath = class {
 	}
 };
 //#endregion
-//#region src/config.ts
-function defineConfig(config) {
-	return config;
-}
-/**
-* Type guard to check if a given config has an `input.path`.
-*/
-function isInputPath(config) {
-	return typeof config?.input === "object" && config.input !== null && "path" in config.input;
-}
-//#endregion
 //#region src/constants.ts
 /**
 * Base URL for the Kubb Studio web app.
@@ -717,6 +705,34 @@ const formatters = {
 	}
 };
 //#endregion
+//#region src/defineParser.ts
+/**
+* Defines a parser with type safety.
+*
+* Use this function to create parsers that transform generated files to strings
+* based on their extension.
+*
+* @example
+* ```ts
+* import { defineParser } from '@kubb/core'
+*
+* export const jsonParser = defineParser({
+*   name: 'json',
+*   extNames: ['.json'],
+*   parse(file) {
+*     return file.sources.map((s) => s.value).join('\n')
+*   },
+* })
+* ```
+*/
+function defineParser(parser) {
+	return {
+		install() {},
+		type: "parser",
+		...parser
+	};
+}
+//#endregion
 //#region src/devtools.ts
 /**
 * Encodes a `RootNode` as a compressed, URL-safe string.
@@ -1351,7 +1367,7 @@ var PluginDriver = class {
 * 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`
+* - `Array<KubbFile.File>` → upserted directly into `fabric`
 * - `void` / `null` / `undefined` → no-op (plugin handled it via `this.upsertFile`)
 */
 async function applyHookResult(result, fabric) {
@@ -1463,7 +1479,7 @@ const fsStorage = createStorage(() => ({
 }));
 //#endregion
 //#region package.json
-var version$1 = "5.0.0-alpha.30";
+var version$1 = "5.0.0-alpha.31";
 //#endregion
 //#region src/utils/diagnostics.ts
 /**
@@ -1485,7 +1501,7 @@ function getDiagnosticInfo() {
 //#region src/utils/TreeNode.ts
 /**
 * Tree structure used to build per-directory barrel (`index.ts`) files from a
-* flat list of generated {@link FabricFile.File} entries.
+* flat list of generated {@link KubbFile.File} entries.
 *
 * Each node represents either a directory or a file within the output tree.
 * Use {@link TreeNode.build} to construct a root node from a file list, then
@@ -1717,6 +1733,14 @@ async function getBarrelFiles(files, { type, meta = {}, root, output }) {
 	});
 }
 //#endregion
+//#region src/utils/isInputPath.ts
+/**
+* Type guard to check if a given config has an `input.path`.
+*/
+function isInputPath(config) {
+	return typeof config?.input === "object" && config.input !== null && "path" in config.input;
+}
+//#endregion
 //#region src/build.ts
 /**
 * Initializes all Kubb infrastructure for a build without executing any plugins.
@@ -1725,6 +1749,7 @@ async function getBarrelFiles(files, { type, meta = {}, root, output }) {
 * - Applies config defaults (`root`, `output.*`, `devtools`).
 * - Creates the Fabric instance and wires storage, format, and lint hooks.
 * - Runs the adapter (if configured) to produce the universal `RootNode`.
+*   When no adapter is supplied and `@kubb/adapter-oas` is installed as an
 *
 * Pass the returned {@link SetupResult} directly to {@link safeBuild} or {@link build}
 * via the `overrides` argument to reuse the same infrastructure across multiple runs.
@@ -1764,9 +1789,12 @@ async function setup(options) {
 			throw new Error(`Cannot read file/URL defined in \`input.path\` or set with \`kubb generate PATH\` in the CLI of your Kubb config ${userConfig.input.path}`, { cause: error });
 		}
 	}
-	const definedConfig = {
+	if (!userConfig.adapter) throw new Error("Adapter should be defined");
+	const config = {
 		root: userConfig.root || process.cwd(),
 		...userConfig,
+		parsers: userConfig.parsers ?? [],
+		adapter: userConfig.adapter,
 		output: {
 			write: true,
 			barrelType: "named",
@@ -1780,17 +1808,24 @@ async function setup(options) {
 		} : void 0,
 		plugins: userConfig.plugins
 	};
-	const storage = definedConfig.output.write === false ? null : definedConfig.output.storage ?? fsStorage();
-	if (definedConfig.output.clean) {
+	const storage = config.output.write === false ? null : config.output.storage ?? fsStorage();
+	if (config.output.clean) {
 		await events.emit("debug", {
 			date: /* @__PURE__ */ new Date(),
-			logs: ["Cleaning output directories", `  • Output: ${definedConfig.output.path}`]
+			logs: ["Cleaning output directories", `  • Output: ${config.output.path}`]
 		});
-		await storage?.clear(resolve(definedConfig.root, definedConfig.output.path));
+		await storage?.clear(resolve(config.root, config.output.path));
 	}
 	const fabric = createFabric();
 	fabric.use(fsPlugin);
-	fabric.use(typescriptParser);
+	for (const parser of config.parsers) fabric.use(parser);
+	fabric.use(defineParser({
+		name: "fallback",
+		extNames: void 0,
+		parse(file) {
+			return file.sources.map((item) => item.value).filter((value) => value != null).join("\n\n");
+		}
+	}));
 	fabric.context.on("files:processing:start", (files) => {
 		events.emit("files:processing:start", files);
 		events.emit("debug", {
@@ -1802,11 +1837,11 @@ async function setup(options) {
 		const { file, source } = params;
 		await events.emit("file:processing:update", {
 			...params,
-			config: definedConfig,
+			config,
 			source
 		});
 		if (source) {
-			const key = relative(resolve(definedConfig.root), file.path);
+			const key = relative(resolve(config.root), file.path);
 			await storage?.setItem(key, source);
 			sources.set(file.path, source);
 		}
@@ -1823,35 +1858,36 @@ async function setup(options) {
 		logs: [
 			"✓ Fabric initialized",
 			`  • Storage: ${storage ? storage.name : "disabled (dry-run)"}`,
-			`  • Barrel type: ${definedConfig.output.barrelType || "none"}`
+			`  • Barrel type: ${config.output.barrelType || "none"}`
 		]
 	});
-	const pluginDriver = new PluginDriver(definedConfig, {
+	const driver = new PluginDriver(config, {
 		fabric,
 		events,
 		concurrency: 15
 	});
-	if (definedConfig.adapter) {
-		const source = inputToAdapterSource(definedConfig);
-		await events.emit("debug", {
-			date: /* @__PURE__ */ new Date(),
-			logs: [`Running adapter: ${definedConfig.adapter.name}`]
-		});
-		pluginDriver.adapter = definedConfig.adapter;
-		pluginDriver.rootNode = await definedConfig.adapter.parse(source);
-		await events.emit("debug", {
-			date: /* @__PURE__ */ new Date(),
-			logs: [
-				`✓ Adapter '${definedConfig.adapter.name}' resolved RootNode`,
-				`  • Schemas: ${pluginDriver.rootNode.schemas.length}`,
-				`  • Operations: ${pluginDriver.rootNode.operations.length}`
-			]
-		});
-	}
+	const adapter = config.adapter;
+	if (!adapter) throw new Error("No adapter configured. Please provide an adapter in your kubb.config.ts.");
+	const source = inputToAdapterSource(config);
+	await events.emit("debug", {
+		date: /* @__PURE__ */ new Date(),
+		logs: [`Running adapter: ${adapter.name}`]
+	});
+	driver.adapter = adapter;
+	driver.rootNode = await adapter.parse(source);
+	await events.emit("debug", {
+		date: /* @__PURE__ */ new Date(),
+		logs: [
+			`✓ Adapter '${adapter.name}' resolved RootNode`,
+			`  • Schemas: ${driver.rootNode.schemas.length}`,
+			`  • Operations: ${driver.rootNode.operations.length}`
+		]
+	});
 	return {
+		config,
 		events,
 		fabric,
-		driver: pluginDriver,
+		driver,
 		sources
 	};
 }
@@ -1885,7 +1921,7 @@ async function build(options, overrides) {
 * - Each hook accepts a single handler **or an array** — all entries are called in sequence.
 * - Nodes that are excluded by `exclude`/`include` plugin options are skipped automatically.
 * - Return values are handled via `applyHookResult`: React elements are rendered,
-*   `FabricFile.File[]` are written via upsert, and `void` is a no-op (manual handling).
+*   `KubbFile.File[]` are written via upsert, and `void` is a no-op (manual handling).
 * - Barrel files are generated automatically when `output.barrelType` is set.
 */
 async function runPluginAstHooks(plugin, context) {
@@ -2148,6 +2184,11 @@ function createPlugin(build) {
 	return (options) => build(options ?? {});
 }
 //#endregion
+//#region src/defineConfig.ts
+function defineConfig(config) {
+	return config;
+}
+//#endregion
 //#region src/defineGenerator.ts
 /**
 * Defines a generator. Returns the object as-is with correct `this` typings.
@@ -2373,7 +2414,7 @@ function defaultResolvePath({ baseName, pathMode, tag, path: groupPath }, { root
 /**
 * Default file resolver used by `defineResolver`.
 *
-* Resolves a `FabricFile.File` by combining name resolution (`resolver.default`) with
+* Resolves a `KubbFile.File` 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.
 *
@@ -2523,7 +2564,7 @@ function defaultResolveFooter(node, { output }) {
 * - `default` — name casing strategy (camelCase / PascalCase)
 * - `resolveOptions` — include/exclude/override filtering
 * - `resolvePath` — output path computation
-* - `resolveFile` — full `FabricFile.File` construction
+* - `resolveFile` — full `KubbFile.File` construction
 *
 * Methods in the builder have access to `this` (the full resolver object), so they
 * can call other resolver methods without circular imports.
@@ -2573,6 +2614,9 @@ function defineResolver(build) {
 	};
 }
 //#endregion
+//#region src/KubbFile.ts
+var KubbFile_exports = /* @__PURE__ */ __exportAll({});
+//#endregion
 //#region src/storages/memoryStorage.ts
 /**
 * In-memory storage driver. Useful for testing and dry-run scenarios where
@@ -2875,6 +2919,6 @@ function satisfiesDependency(dependency, version, cwd) {
 	return satisfies(semVer, version);
 }
 //#endregion
-export { AsyncEventEmitter, FunctionParams, PluginDriver, URLPath, build, build as default, buildDefaultBanner, composeTransformers, createAdapter, createPlugin, createStorage, defaultResolveBanner, defaultResolveFile, defaultResolveFooter, defaultResolveOptions, defaultResolvePath, defineConfig, defineGenerator, defineLogger, definePresets, definePrinter, defineResolver, detectFormatter, detectLinter, formatters, fsStorage, getBarrelFiles, getConfigs, getMode, getPreset, isInputPath, linters, logLevel, memoryStorage, mergeGenerators, safeBuild, satisfiesDependency, setup };
+export { AsyncEventEmitter, FunctionParams, KubbFile_exports as KubbFile, PluginDriver, URLPath, build, build as default, buildDefaultBanner, composeTransformers, createAdapter, createPlugin, createStorage, defaultResolveBanner, defaultResolveFile, defaultResolveFooter, defaultResolveOptions, defaultResolvePath, defineConfig, defineGenerator, defineLogger, defineParser, definePresets, definePrinter, defineResolver, detectFormatter, detectLinter, formatters, fsStorage, getBarrelFiles, getConfigs, getMode, getPreset, isInputPath, linters, logLevel, memoryStorage, mergeGenerators, safeBuild, satisfiesDependency, setup };
 
 //# sourceMappingURL=index.js.map