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

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 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-DZdEyCoa.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.
@@ -479,11 +479,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 +512,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 +589,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.
@@ -808,12 +808,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
 /**
@@ -872,7 +872,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

package/dist/index.js

@@ -965,6 +965,15 @@ function hookParallel(promises, concurrency = Number.POSITIVE_INFINITY) {
 }
 //#endregion
 //#region src/PluginDriver.ts
+/**
+* Returns `'single'` when `fileOrFolder` has a file extension, `'split'` otherwise.
+*
+* @example
+* ```ts
+* getMode('src/gen/types.ts')  // 'single'
+* getMode('src/gen/types')     // 'split'
+* ```
+*/
 function getMode(fileOrFolder) {
 	if (!fileOrFolder) return "split";
 	return extname(fileOrFolder) ? "single" : "split";
@@ -1463,7 +1472,7 @@ const fsStorage = createStorage(() => ({
 }));
 //#endregion
 //#region package.json
-var version$1 = "5.0.0-alpha.21";
+var version$1 = "5.0.0-alpha.22";
 //#endregion
 //#region src/utils/diagnostics.ts
 /**
@@ -2104,7 +2113,7 @@ function defaultResolvePath({ baseName, pathMode, tag, path: groupPath }, { root
 /**
 * 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.
 *
@@ -2240,7 +2249,7 @@ function defaultResolveFooter(node, { output }) {
 * - `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.
@@ -2527,7 +2536,7 @@ async function detectFormatter() {
 //#region src/utils/TreeNode.ts
 /**
 * Tree structure used to build per-directory barrel (`index.ts`) files from a
-* flat list of generated {@link KubbFile.File} entries.
+* flat list of generated {@link FabricFile.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
@@ -2569,24 +2578,39 @@ var TreeNode = class TreeNode {
 		this.#cachedLeaves = leaves;
 		return leaves;
 	}
+	/**
+	* Visits this node and every descendant in depth-first order.
+	*/
 	forEach(callback) {
 		if (typeof callback !== "function") throw new TypeError("forEach() callback must be a function");
 		callback(this);
 		for (const child of this.children) child.forEach(callback);
 		return this;
 	}
+	/**
+	* Finds the first leaf that satisfies `predicate`, or `undefined` when none match.
+	*/
 	findDeep(predicate) {
 		if (typeof predicate !== "function") throw new TypeError("find() predicate must be a function");
 		return this.leaves.find(predicate);
 	}
+	/**
+	* Calls `callback` for every leaf of this node.
+	*/
 	forEachDeep(callback) {
 		if (typeof callback !== "function") throw new TypeError("forEach() callback must be a function");
 		this.leaves.forEach(callback);
 	}
+	/**
+	* Returns all leaves that satisfy `callback`.
+	*/
 	filterDeep(callback) {
 		if (typeof callback !== "function") throw new TypeError("filter() callback must be a function");
 		return this.leaves.filter(callback);
 	}
+	/**
+	* Maps every leaf through `callback` and returns the resulting array.
+	*/
 	mapDeep(callback) {
 		if (typeof callback !== "function") throw new TypeError("map() callback must be a function");
 		return this.leaves.map(callback);
@@ -2759,7 +2783,15 @@ async function getConfigs(config, args) {
 //#endregion
 //#region src/utils/mergeResolvers.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
+* ```
 */
 function mergeResolvers(...resolvers) {
 	return resolvers.reduce((acc, curr) => ({