@kubb/core 5.0.0-alpha.21 → 5.0.0-alpha.23

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { $ as formatters, A as Printer, B as ResolverPathParams, C as PluginFactoryOptions, D as PluginWithLifeCycle, E as PluginParameter, F as ResolvePathOptions, G as UserResolver, H as UserLogger, I as ResolvePathParams, J as Generator, K as KubbEvents, L as Resolver, M as ResolveBannerContext, N as ResolveNameParams, O as Preset, P as ResolveOptionsContext, Q as createStorage, R as ResolverContext, S as PluginContext, T as PluginLifecycleHooks, U as UserPlugin, V as UserConfig, W as UserPluginWithLifeCycle, X as defineGenerator, Y as ReactGeneratorV2, Z as Storage, _ as LoggerContext, a as AdapterSource, b as Override, c as CompatibilityPreset, d as Exclude, et as linters, f as Group, g as Logger, h as InputPath, i as AdapterFactoryOptions, j as PrinterFactoryOptions, k as Presets, l as Config, m as InputData, n as getMode, nt as PossiblePromise, o as BarrelType, p as Include, q as CoreGeneratorV2, r as Adapter, rt as AsyncEventEmitter, s as Builder, t as PluginDriver, tt as logLevel, u as DevtoolsOptions, v as LoggerOptions, w as PluginLifecycle, x as Plugin, y as Output, z as ResolverFileParams } from "./PluginDriver-CEQPafXV.js";
+import { $ as formatters, A as PrinterFactoryOptions, B as UserConfig, C as PluginLifecycle, D as Preset, E as PluginWithLifeCycle, F as ResolvePathParams, G as UserResolver, H as UserLogger, I as Resolver, J as Generator, K as KubbEvents, L as ResolverContext, M as ResolveNameParams, N as ResolveOptionsContext, O as Presets, P as ResolvePathOptions, Q as createStorage, R as ResolverFileParams, S as PluginFactoryOptions, T as PluginParameter, U as UserPlugin, V as UserGroup, W as UserPluginWithLifeCycle, X as defineGenerator, Y as ReactGeneratorV2, Z as Storage, _ as LoggerOptions, a as AdapterSource, b as Plugin, c as Config, d as Group, et as linters, f as Include, g as LoggerContext, h as Logger, i as AdapterFactoryOptions, j as ResolveBannerContext, k as Printer, l as DevtoolsOptions, m as InputPath, n as getMode, nt as PossiblePromise, o as BarrelType, p as InputData, q as CoreGeneratorV2, r as Adapter, rt as AsyncEventEmitter, s as CompatibilityPreset, t as PluginDriver, tt as logLevel, u as Exclude, v as Output, w as PluginLifecycleHooks, x as PluginContext, y as Override, z as ResolverPathParams } from "./PluginDriver-P920mak9.js";
 import { definePrinter } from "@kubb/ast";
 import { Node, OperationNode, RootNode, SchemaNode, Visitor } from "@kubb/ast/types";
-import { Fabric, KubbFile } from "@kubb/fabric-core/types";
+import { Fabric, FabricFile } from "@kubb/fabric-core/types";
 import { Fabric as Fabric$1 } from "@kubb/react-fabric/types";
 
 //#region ../../internals/utils/src/urlPath.d.ts
@@ -158,7 +158,7 @@ type BuildOutput = {
     error: Error;
   }>;
   fabric: Fabric;
-  files: Array<KubbFile.ResolvedFile>;
+  files: Array<FabricFile.ResolvedFile>;
   driver: PluginDriver;
   /**
    * Elapsed time in milliseconds for each plugin, keyed by plugin name.
@@ -168,7 +168,7 @@ type BuildOutput = {
   /**
    * Raw generated source, keyed by absolute file path.
    */
-  sources: Map<KubbFile.Path, string>;
+  sources: Map<FabricFile.Path, string>;
 };
 /**
  * Intermediate result returned by {@link setup} and accepted by {@link safeBuild}.
@@ -177,7 +177,7 @@ type SetupResult = {
   events: AsyncEventEmitter<KubbEvents>;
   fabric: Fabric;
   driver: PluginDriver;
-  sources: Map<KubbFile.Path, string>;
+  sources: Map<FabricFile.Path, string>;
 };
 /**
  * Initializes all Kubb infrastructure for a build without executing any plugins.
@@ -303,29 +303,6 @@ type PluginBuilder<T extends PluginFactoryOptions = PluginFactoryOptions> = (opt
  */
 declare function createPlugin<T extends PluginFactoryOptions = PluginFactoryOptions>(build: PluginBuilder<T>): (options?: T['options']) => UserPluginWithLifeCycle<T>;
 //#endregion
-//#region src/defineBuilder.d.ts
-/**
- * Builder type for the plugin-specific builder fields.
- * `name` is required; all other methods are defined by the concrete plugin builder type.
- */
-type BuilderBuilder<T extends PluginFactoryOptions> = () => T['builder'] & ThisType<T['builder']>;
-/**
- * Defines a builder for a plugin — a named collection of schema-building helpers that
- * can be exported alongside the plugin and imported by other plugins or generators.
- *
- * @example
- * export const builder = defineBuilder<PluginTs>(() => ({
- *   name: 'default',
- *   buildParamsSchema({ params, node, resolver }) {
- *     return createSchema({ type: 'object', properties: [] })
- *   },
- *   buildDataSchemaNode({ node, resolver }) {
- *     return createSchema({ type: 'object', properties: [] })
- *   },
- * }))
- */
-declare function defineBuilder<T extends PluginFactoryOptions>(build: BuilderBuilder<T>): T['builder'];
-//#endregion
 //#region src/defineLogger.d.ts
 /**
  * Wraps a logger definition into a typed {@link Logger}.
@@ -341,37 +318,6 @@ declare function defineBuilder<T extends PluginFactoryOptions>(build: BuilderBui
  */
 declare function defineLogger<Options extends LoggerOptions = LoggerOptions>(logger: UserLogger<Options>): Logger<Options>;
 //#endregion
-//#region src/definePreset.d.ts
-/**
- * Creates a typed preset object that bundles a name, resolvers, optional
- * transformers, and optional generators — the building block for composable plugin presets.
- *
- * @example
- * import { definePreset } from '@kubb/core'
- * import { resolverTsLegacy } from '@kubb/plugin-ts'
- *
- * export const myPreset = definePreset('myPreset', { resolvers: [resolverTsLegacy] })
- *
- * @example
- * // With custom transformers
- * export const myPreset = definePreset('myPreset', { resolvers: [resolverTsLegacy], transformers: [myTransformer] })
- *
- * @example
- * // With generators
- * export const myPreset = definePreset('myPreset', { resolvers: [resolverTsLegacy], generators: [typeGeneratorLegacy] })
- */
-declare function definePreset<TResolver extends Resolver = Resolver, TName extends string = string>(name: TName, {
-  resolvers,
-  transformers,
-  generators
-}: {
-  resolvers: Array<TResolver>;
-  transformers?: Array<Visitor>;
-  generators?: Array<Generator<any>>;
-}): Preset<TResolver> & {
-  name: TName;
-};
-//#endregion
 //#region src/definePresets.d.ts
 /**
  * Creates a typed presets registry object — a named collection of {@link Preset} entries.
@@ -479,11 +425,11 @@ declare function defaultResolvePath({
   root,
   output,
   group
-}: ResolverContext): KubbFile.Path;
+}: ResolverContext): FabricFile.Path;
 /**
  * Default file resolver used by `defineResolver`.
  *
- * Resolves a `KubbFile.File` by combining name resolution (`resolver.default`) with
+ * Resolves a `FabricFile.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.
  *
@@ -512,7 +458,7 @@ declare function defaultResolveFile(this: Resolver, {
   extname,
   tag,
   path: groupPath
-}: ResolverFileParams, context: ResolverContext): KubbFile.File;
+}: ResolverFileParams, context: ResolverContext): FabricFile.File;
 /**
  * Generates the default "Generated by Kubb" banner from config and optional node metadata.
  */
@@ -589,7 +535,7 @@ declare function defaultResolveFooter(node: RootNode | undefined, {
  * - `default` — name casing strategy (camelCase / PascalCase)
  * - `resolveOptions` — include/exclude/override filtering
  * - `resolvePath` — output path computation
- * - `resolveFile` — full `KubbFile.File` construction
+ * - `resolveFile` — full `FabricFile.File` construction
  *
  * Methods in the builder have access to `this` (the full resolver object), so they
  * can call other resolver methods without circular imports.
@@ -638,6 +584,7 @@ type BuildOperationsV2Options<TOptions extends PluginFactoryOptions> = {
   adapter: Adapter;
   driver: PluginDriver;
   options: TOptions['resolvedOptions'];
+  resolver: TOptions['resolver'];
 };
 /**
  * Renders a React component for a list of operation nodes (V2 generators).
@@ -651,6 +598,7 @@ type BuildOperationV2Options<TOptions extends PluginFactoryOptions> = {
   adapter: Adapter;
   driver: PluginDriver;
   options: TOptions['resolvedOptions'];
+  resolver: TOptions['resolver'];
 };
 /**
  * Renders a React component for a single operation node (V2 generators).
@@ -664,6 +612,7 @@ type BuildSchemaV2Options<TOptions extends PluginFactoryOptions> = {
   adapter: Adapter;
   driver: PluginDriver;
   options: TOptions['resolvedOptions'];
+  resolver: TOptions['resolver'];
 };
 /**
  * Renders a React component for a single schema node (V2 generators).
@@ -808,12 +757,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<KubbFile.ResolvedFile>, {
+declare function getBarrelFiles(files: Array<FabricFile.ResolvedFile>, {
   type,
   meta,
   root,
   output
-}: AddIndexesProps): Promise<Array<KubbFile.File>>;
+}: AddIndexesProps): Promise<Array<FabricFile.File>>;
 //#endregion
 //#region src/utils/getConfigs.d.ts
 /**
@@ -829,11 +778,11 @@ declare function getConfigs(config: ConfigInput | UserConfig, args: CLIOptions):
 type GetPresetParams<TResolver extends Resolver> = {
   preset: CompatibilityPreset;
   presets: Presets<TResolver>;
-  resolvers: Array<TResolver>;
+  resolvers?: Array<TResolver>;
   /**
    * User-supplied generators to append after the preset's generators.
    */
-  generators: Array<Generator<any>>;
+  generators?: Array<Generator<any>>;
   transformers?: Array<Visitor>;
 };
 type GetPresetResult<TResolver extends Resolver> = {
@@ -872,7 +821,15 @@ declare function detectLinter(): Promise<Linter | null>;
 //#endregion
 //#region src/utils/mergeResolvers.d.ts
 /**
- * Merges an array of resolvers into a single resolver. Later entries override earlier ones (last wins).
+ * Merges an ordered list of resolvers into a single resolver by shallow-merging each entry left to right.
+ *
+ * Later entries win when keys conflict, so the last resolver in the list takes highest precedence.
+ *
+ * @example
+ * ```ts
+ * const resolver = mergeResolvers(resolverTs, resolverTsLegacy)
+ * // resolverTsLegacy methods override resolverTs where they overlap
+ * ```
  */
 declare function mergeResolvers<T extends Resolver>(...resolvers: Array<T>): T;
 //#endregion
@@ -896,5 +853,5 @@ type DependencyVersion = string;
  */
 declare function satisfiesDependency(dependency: DependencyName | RegExp, version: DependencyVersion, cwd?: string): boolean;
 //#endregion
-export { Adapter, AdapterFactoryOptions, AdapterSource, AsyncEventEmitter, BarrelType, Builder, type CLIOptions, CompatibilityPreset, Config, type ConfigInput, CoreGeneratorV2, DevtoolsOptions, Exclude, type FileMetaBase, FunctionParams, type FunctionParamsAST, Generator, Group, Include, InputData, InputPath, KubbEvents, Logger, LoggerContext, LoggerOptions, Output, Override, Plugin, PluginContext, PluginDriver, PluginFactoryOptions, PluginLifecycle, PluginLifecycleHooks, PluginParameter, PluginWithLifeCycle, Preset, Presets, Printer, PrinterFactoryOptions, ReactGeneratorV2, ResolveBannerContext, ResolveNameParams, ResolveOptionsContext, ResolvePathOptions, ResolvePathParams, Resolver, ResolverContext, ResolverFileParams, ResolverPathParams, Storage, URLPath, UserConfig, UserLogger, UserPlugin, UserPluginWithLifeCycle, UserResolver, build, build as default, buildDefaultBanner, createAdapter, createPlugin, createStorage, defaultResolveBanner, defaultResolveFile, defaultResolveFooter, defaultResolveOptions, defaultResolvePath, defineBuilder, defineConfig, defineGenerator, defineLogger, definePreset, definePresets, definePrinter, defineResolver, detectFormatter, detectLinter, formatters, fsStorage, getBarrelFiles, getConfigs, getMode, getPreset, isInputPath, linters, logLevel, memoryStorage, mergeResolvers, renderOperation, renderOperations, renderSchema, safeBuild, satisfiesDependency, setup };
+export { Adapter, AdapterFactoryOptions, AdapterSource, AsyncEventEmitter, BarrelType, type CLIOptions, CompatibilityPreset, Config, type ConfigInput, CoreGeneratorV2, DevtoolsOptions, Exclude, type FileMetaBase, FunctionParams, type FunctionParamsAST, Generator, Group, Include, InputData, InputPath, KubbEvents, Logger, LoggerContext, LoggerOptions, Output, Override, Plugin, PluginContext, PluginDriver, PluginFactoryOptions, PluginLifecycle, PluginLifecycleHooks, PluginParameter, PluginWithLifeCycle, Preset, Presets, Printer, PrinterFactoryOptions, ReactGeneratorV2, ResolveBannerContext, ResolveNameParams, ResolveOptionsContext, ResolvePathOptions, ResolvePathParams, Resolver, ResolverContext, ResolverFileParams, ResolverPathParams, Storage, URLPath, UserConfig, UserGroup, UserLogger, UserPlugin, UserPluginWithLifeCycle, UserResolver, build, build as default, buildDefaultBanner, 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, mergeResolvers, renderOperation, renderOperations, renderSchema, safeBuild, satisfiesDependency, setup };
 //# sourceMappingURL=index.d.ts.map