@kubb/core 5.0.0-alpha.26 → 5.0.0-alpha.27

package/dist/{PluginDriver-BGRDpPpK.d.ts → PluginDriver-B12z6KO-.d.ts}

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { Node, OperationNode, Printer, PrinterFactoryOptions, RootNode, SchemaNode, Visitor } from "@kubb/ast/types";
+import { Node, OperationNode, Printer, Printer as Printer$1, PrinterFactoryOptions, PrinterPartial, RootNode, SchemaNode, Visitor } from "@kubb/ast/types";
 import { Fabric, FabricFile } from "@kubb/fabric-core/types";
 import { HttpMethod } from "@kubb/oas";
 import { FabricReactNode } from "@kubb/react-fabric/types";
@@ -921,9 +921,16 @@ type UserPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> =
    */
   options: TOptions['resolvedOptions'];
   /**
-   * The resolver for this plugin, accessible via `driver.getPluginByName(name)?.resolver`.
+   * The resolver for this plugin.
+   * Composed by `getPreset` from the preset resolver and the user's `resolver` partial override.
    */
   resolver?: TOptions['resolver'];
+  /**
+   * The composed transformer for this plugin.
+   * Composed by `getPreset` from the preset's transformers and the user's `transformer` visitor.
+   * When a visitor method returns `null`/`undefined`, the preset transformer's result is used instead.
+   */
+  transformer?: Visitor;
   /**
    * Specifies the preceding plugins for the current plugin. You can pass an array of preceding plugin names, and the current plugin is executed after these plugins.
    * Can be used to validate dependent plugins.
@@ -957,9 +964,16 @@ type Plugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
    */
   options: TOptions['resolvedOptions'];
   /**
-   * The resolver for this plugin, accessible via `driver.getPluginByName(name)?.resolver`.
+   * The resolver for this plugin.
+   * Composed by `getPreset` from the preset resolver and the user's `resolver` partial override.
    */
   resolver: TOptions['resolver'];
+  /**
+   * The composed transformer for this plugin. Accessible via `context.transformer`.
+   * Composed by `getPreset` from the preset's transformers and the user's `transformer` visitor.
+   * When a visitor method returns `null`/`undefined`, the preset transformer's result is used instead.
+   */
+  transformer?: Visitor;
   install: (this: PluginContext<TOptions>, context: PluginContext<TOptions>) => PossiblePromise<void>;
   /**
    * Defines a context that can be used by other plugins, see `PluginDriver` where we convert from `UserPlugin` to `Plugin` (used when calling `createPlugin`).
@@ -1036,6 +1050,11 @@ type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryOptions>
    * Resolver for the current plugin. Shorthand for `plugin.resolver`.
    */
   resolver: TOptions['resolver'];
+  /**
+   * Composed transformer for the current plugin. Shorthand for `plugin.transformer`.
+   * Apply with `transform(node, context.transformer)` to pre-process AST nodes before printing.
+   */
+  transformer: Visitor | undefined;
   /**
    * Opens the Kubb Studio URL for the current `rootNode` in the default browser.
    * Falls back to printing the URL if the browser cannot be launched.
@@ -1135,7 +1154,7 @@ type UserLogger<TOptions extends LoggerOptions = LoggerOptions> = Logger<TOption
  */
 type CompatibilityPreset = 'default' | 'kubbV4';
 /**
- * A preset bundles a name, one or more resolvers, optional AST transformers,
+ * A preset bundles a name, a resolver, optional AST transformers,
  * and optional generators into a single reusable configuration object.
  *
  * @template TResolver - The concrete resolver type for this preset.
@@ -1146,9 +1165,9 @@ type Preset<TResolver extends Resolver = Resolver> = {
    */
   name: string;
   /**
-   * Ordered list of resolvers applied by this preset (last entry wins on merge).
+   * The resolver used by this preset.
    */
-  resolvers: Array<TResolver>;
+  resolver: TResolver;
   /**
    * Optional AST visitors / transformers applied after resolving.
    */
@@ -1158,6 +1177,11 @@ type Preset<TResolver extends Resolver = Resolver> = {
    * to their concrete generator type.
    */
   generators?: Array<Generator<any>>;
+  /**
+   * Optional printer factory used by this preset.
+   * The generator calls this function at render-time to produce a configured printer instance.
+   */
+  printer?: (options: any) => Printer;
 };
 /**
  * A named registry of presets, keyed by preset name.
@@ -1447,5 +1471,5 @@ declare class PluginDriver {
   getPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(pluginName: string): Plugin<TOptions> | undefined;
 }
 //#endregion
-export { formatters as $, PrinterFactoryOptions as A, UserConfig as B, PluginLifecycle as C, Preset as D, PluginWithLifeCycle as E, ResolvePathParams as F, UserResolver as G, UserLogger as H, Resolver as I, Generator as J, KubbEvents as K, ResolverContext as L, ResolveNameParams as M, ResolveOptionsContext as N, Presets as O, ResolvePathOptions as P, createStorage as Q, ResolverFileParams as R, PluginFactoryOptions as S, PluginParameter as T, UserPlugin as U, UserGroup as V, UserPluginWithLifeCycle as W, defineGenerator as X, ReactGeneratorV2 as Y, Storage as Z, LoggerOptions as _, AdapterSource as a, Plugin as b, Config as c, Group as d, linters as et, Include as f, LoggerContext as g, Logger as h, AdapterFactoryOptions as i, ResolveBannerContext as j, Printer as k, DevtoolsOptions as l, InputPath as m, getMode as n, PossiblePromise as nt, BarrelType as o, InputData as p, CoreGeneratorV2 as q, Adapter as r, AsyncEventEmitter as rt, CompatibilityPreset as s, PluginDriver as t, logLevel as tt, Exclude as u, Output as v, PluginLifecycleHooks as w, PluginContext as x, Override as y, ResolverPathParams as z };
-//# sourceMappingURL=PluginDriver-BGRDpPpK.d.ts.map
+export { createStorage as $, PrinterFactoryOptions as A, ResolverPathParams as B, PluginLifecycle as C, Preset as D, PluginWithLifeCycle as E, ResolvePathOptions as F, UserPluginWithLifeCycle as G, UserGroup as H, ResolvePathParams as I, CoreGeneratorV2 as J, UserResolver as K, Resolver as L, ResolveBannerContext as M, ResolveNameParams as N, Presets as O, ResolveOptionsContext as P, Storage as Q, ResolverContext as R, PluginFactoryOptions as S, PluginParameter as T, UserLogger as U, UserConfig as V, UserPlugin as W, ReactGeneratorV2 as X, Generator as Y, defineGenerator as Z, LoggerOptions as _, AdapterSource as a, Plugin as b, Config as c, Group as d, formatters as et, Include as f, LoggerContext as g, Logger as h, AdapterFactoryOptions as i, AsyncEventEmitter as it, PrinterPartial as j, Printer$1 as k, DevtoolsOptions as l, InputPath as m, getMode as n, logLevel as nt, BarrelType as o, InputData as p, KubbEvents as q, Adapter as r, PossiblePromise as rt, CompatibilityPreset as s, PluginDriver as t, linters as tt, Exclude as u, Output as v, PluginLifecycleHooks as w, PluginContext as x, Override as y, ResolverFileParams as z };
+//# sourceMappingURL=PluginDriver-B12z6KO-.d.ts.map

package/dist/hooks.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { S as PluginFactoryOptions, b as Plugin, t as PluginDriver } from "./PluginDriver-BGRDpPpK.js";
+import { S as PluginFactoryOptions, b as Plugin, t as PluginDriver } from "./PluginDriver-B12z6KO-.js";
 import { FabricFile } from "@kubb/fabric-core/types";
 
 //#region src/hooks/useDriver.d.ts

package/dist/index.cjs

@@ -1002,6 +1002,9 @@ var PluginDriver = class {
 			get resolver() {
 				return plugin.resolver;
 			},
+			get transformer() {
+				return plugin.transformer;
+			},
 			openInStudio(options) {
 				if (!driver.config.devtools || driver.#studioIsOpen) return;
 				if (typeof driver.config.devtools !== "object") throw new Error("Devtools must be an object");
@@ -1416,7 +1419,7 @@ const fsStorage = createStorage(() => ({
 }));
 //#endregion
 //#region package.json
-var version = "5.0.0-alpha.26";
+var version = "5.0.0-alpha.27";
 //#endregion
 //#region src/utils/diagnostics.ts
 /**
@@ -2769,46 +2772,43 @@ async function getConfigs(config, args) {
 	}));
 }
 //#endregion
-//#region src/utils/mergeResolvers.ts
+//#region src/utils/getPreset.ts
 /**
-* 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
-* ```
+* Returns a copy of `defaults` where each function in `userOverrides` is wrapped
+* so a `null`/`undefined` return falls back to the original. Non-function values
+* are assigned directly. All calls use the merged object as `this`.
 */
-function mergeResolvers(...resolvers) {
-	return resolvers.reduce((acc, curr) => ({
-		...acc,
-		...curr
-	}), resolvers[0]);
+function withFallback(defaults, userOverrides) {
+	const merged = { ...defaults };
+	for (const key of Object.keys(userOverrides)) {
+		const userVal = userOverrides[key];
+		const defaultVal = defaults[key];
+		if (typeof userVal === "function" && typeof defaultVal === "function") merged[key] = (...args) => userVal.apply(merged, args) ?? defaultVal.apply(merged, args);
+		else if (userVal !== void 0) merged[key] = userVal;
+	}
+	return merged;
 }
-//#endregion
-//#region src/utils/getPreset.ts
 /**
-* Resolves a named preset into merged resolvers, transformers, and generators.
+* Resolves a named preset into a resolver, transformer, and generators.
 *
-* - Merges the preset's resolvers on top of the first (default)
-* - Merges any additional user-supplied resolvers on top of that to produce the final `resolver`.
-* - Concatenates preset transformers before user-supplied transformers.
+* - Selects the preset resolver; wraps it with user overrides using null/undefined fallback.
+* - Composes the preset's transformers into a single visitor; wraps it with the user transformer using null/undefined fallback.
 * - Combines preset generators with user-supplied generators; falls back to the `default` preset's generators when neither provides any.
 */
 function getPreset(params) {
-	const { preset: presetName, presets, resolvers = [], transformers: userTransformers = [], generators: userGenerators = [] } = params;
-	const [defaultResolver, ...userResolvers] = resolvers;
+	const { preset: presetName, presets, resolver: userResolver, transformer: userTransformer, generators: userGenerators = [] } = params;
 	const preset = presets[presetName];
-	const resolver = mergeResolvers(mergeResolvers(defaultResolver, ...preset?.resolvers ?? []), ...userResolvers ?? []);
-	const transformers = [...preset?.transformers ?? [], ...userTransformers ?? []];
+	const presetResolver = preset?.resolver ?? presets["default"].resolver;
+	const resolver = userResolver ? withFallback(presetResolver, userResolver) : presetResolver;
+	const presetTransformers = preset?.transformers ?? [];
+	const presetTransformer = presetTransformers.length > 0 ? (0, _kubb_ast.composeTransformers)(...presetTransformers) : void 0;
+	const transformer = presetTransformer && userTransformer ? withFallback(presetTransformer, userTransformer) : userTransformer ?? presetTransformer;
 	const presetGenerators = preset?.generators ?? [];
-	const defaultPresetGenerators = presets["default"]?.generators ?? [];
+	const defaultGenerators = presets["default"]?.generators ?? [];
 	return {
 		resolver,
-		transformers,
-		generators: presetGenerators.length > 0 || userGenerators.length ? [...presetGenerators, ...userGenerators] : defaultPresetGenerators,
+		transformer,
+		generators: presetGenerators.length > 0 || userGenerators.length > 0 ? [...presetGenerators, ...userGenerators] : defaultGenerators,
 		preset
 	};
 }
@@ -2901,6 +2901,12 @@ exports.PluginDriver = PluginDriver;
 exports.URLPath = URLPath;
 exports.build = build;
 exports.buildDefaultBanner = buildDefaultBanner;
+Object.defineProperty(exports, "composeTransformers", {
+	enumerable: true,
+	get: function() {
+		return _kubb_ast.composeTransformers;
+	}
+});
 exports.createAdapter = createAdapter;
 exports.createPlugin = createPlugin;
 exports.createStorage = createStorage;
@@ -2933,7 +2939,6 @@ exports.isInputPath = isInputPath;
 exports.linters = linters;
 exports.logLevel = logLevel;
 exports.memoryStorage = memoryStorage;
-exports.mergeResolvers = mergeResolvers;
 exports.renderOperation = renderOperation;
 exports.renderOperations = renderOperations;
 exports.renderSchema = renderSchema;