@kubb/core 5.0.0-alpha.15 → 5.0.0-alpha.16

package/dist/{PluginDriver-By5lhDKP.d.ts → PluginDriver-CNKhDf-w.d.ts}

@@ -1,6 +1,6 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
 import { EventEmitter } from "node:events";
-import { Node, OperationNode, Printer, PrinterFactoryOptions, RootNode, SchemaNode } from "@kubb/ast/types";
+import { Node, OperationNode, Printer, PrinterFactoryOptions, RootNode, SchemaNode, Visitor } from "@kubb/ast/types";
 import { Fabric, KubbFile } from "@kubb/fabric-core/types";
 import { FabricReactNode } from "@kubb/react-fabric/types";
 
@@ -929,6 +929,39 @@ type Logger<TOptions extends LoggerOptions = LoggerOptions> = {
   install: (context: LoggerContext, options?: TOptions) => void | Promise<void>;
 };
 type UserLogger<TOptions extends LoggerOptions = LoggerOptions> = Logger<TOptions>;
+/**
+ * Compatibility preset for code generation tools.
+ * - `'default'` – no compatibility adjustments (default behavior).
+ * - `'kubbV4'` – align generated names and structures with Kubb v4 output.
+ */
+type CompatibilityPreset = 'default' | 'kubbV4';
+/**
+ * A preset bundles a name, one or more resolvers, and optional AST transformers
+ * into a single reusable configuration object.
+ *
+ * @template TResolver - The concrete resolver type for this preset.
+ */
+type Preset<TResolver extends Resolver = Resolver> = {
+  /**
+   * Unique identifier for this preset.
+   */
+  name: string;
+  /**
+   * Ordered list of resolvers applied by this preset (last entry wins on merge).
+   */
+  resolvers: Array<TResolver>;
+  /**
+   * Optional AST visitors / transformers applied after resolving.
+   */
+  transformers?: Array<Visitor>;
+};
+/**
+ * A named registry of presets, keyed by preset name.
+ *
+ * @template TResolver - The concrete resolver type shared by all presets in this registry.
+ * @template TName - The union of valid preset name keys.
+ */
+type Presets<TResolver extends Resolver = Resolver> = Record<CompatibilityPreset, Preset<TResolver>>;
 //#endregion
 //#region src/PluginDriver.d.ts
 type RequiredPluginLifecycle = Required<PluginLifecycle>;
@@ -1051,5 +1084,5 @@ declare class PluginDriver {
   getPluginsByName(hookName: keyof PluginWithLifeCycle, pluginName: string): Plugin[];
 }
 //#endregion
-export { UserConfig as A, Storage as B, PluginWithLifeCycle as C, ResolveOptionsContext as D, ResolveNameParams as E, CoreGeneratorV2 as F, AsyncEventEmitter as G, formatters as H, Generator as I, ReactGeneratorV2 as L, UserPlugin as M, UserPluginWithLifeCycle as N, ResolvePathParams as O, UserResolver as P, defineGenerator as R, PluginParameter as S, PrinterFactoryOptions as T, linters as U, createStorage as V, logLevel as W, Plugin as _, AdapterFactoryOptions as a, PluginLifecycle as b, Config as c, InputData as d, InputPath as f, Output as g, LoggerOptions as h, Adapter as i, UserLogger as j, Resolver as k, DevtoolsOptions as l, LoggerContext as m, PluginDriver as n, AdapterSource as o, Logger as p, getMode as r, BarrelType as s, GetFileOptions as t, Group as u, PluginContext as v, Printer as w, PluginLifecycleHooks as x, PluginFactoryOptions as y, KubbEvents as z };
-//# sourceMappingURL=PluginDriver-By5lhDKP.d.ts.map
+export { ResolveOptionsContext as A, ReactGeneratorV2 as B, PluginParameter as C, Printer as D, Presets as E, UserPlugin as F, formatters as G, KubbEvents as H, UserPluginWithLifeCycle as I, AsyncEventEmitter as J, linters as K, UserResolver as L, Resolver as M, UserConfig as N, PrinterFactoryOptions as O, UserLogger as P, CoreGeneratorV2 as R, PluginLifecycleHooks as S, Preset as T, Storage as U, defineGenerator as V, createStorage as W, Output as _, AdapterFactoryOptions as a, PluginFactoryOptions as b, CompatibilityPreset as c, Group as d, InputData as f, LoggerOptions as g, LoggerContext as h, Adapter as i, ResolvePathParams as j, ResolveNameParams as k, Config as l, Logger as m, PluginDriver as n, AdapterSource as o, InputPath as p, logLevel as q, getMode as r, BarrelType as s, GetFileOptions as t, DevtoolsOptions as u, Plugin as v, PluginWithLifeCycle as w, PluginLifecycle as x, PluginContext as y, Generator as z };
+//# sourceMappingURL=PluginDriver-CNKhDf-w.d.ts.map

package/dist/hooks.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { E as ResolveNameParams, O as ResolvePathParams, _ as Plugin, c as Config, n as PluginDriver, t as GetFileOptions, y as PluginFactoryOptions } from "./PluginDriver-By5lhDKP.js";
+import { b as PluginFactoryOptions, j as ResolvePathParams, k as ResolveNameParams, l as Config, n as PluginDriver, t as GetFileOptions, v as Plugin } from "./PluginDriver-CNKhDf-w.js";
 import { RootNode } from "@kubb/ast/types";
 import { KubbFile } from "@kubb/fabric-core/types";
 

package/dist/index.cjs

@@ -1447,7 +1447,7 @@ const fsStorage = createStorage(() => ({
 }));
 //#endregion
 //#region package.json
-var version = "5.0.0-alpha.15";
+var version = "5.0.0-alpha.16";
 //#endregion
 //#region src/utils/diagnostics.ts
 /**
@@ -1852,6 +1852,45 @@ function defineLogger(logger) {
 	return logger;
 }
 //#endregion
+//#region src/definePreset.ts
+/**
+* Creates a typed preset object that bundles a name, resolvers, and optional
+* transformers — 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] })
+*/
+function definePreset(name, { resolvers, transformers }) {
+	return {
+		name,
+		resolvers,
+		transformers
+	};
+}
+//#endregion
+//#region src/definePresets.ts
+/**
+* Creates a typed presets registry object — a named collection of {@link Preset} entries.
+*
+* @example
+* import { definePreset, definePresets } from '@kubb/core'
+* import { resolverTsLegacy } from '@kubb/plugin-ts'
+*
+* export const myPresets = definePresets({
+*   kubbV4: definePreset('kubbV4', { resolvers: [resolverTsLegacy] }),
+* })
+*/
+function definePresets(presets) {
+	return presets;
+}
+//#endregion
 //#region src/defineResolver.ts
 /**
 * Checks if an operation matches a pattern for a given filter type (`tag`, `operationId`, `path`, `method`).
@@ -2375,6 +2414,31 @@ async function getConfigs(config, args) {
 	return (Array.isArray(resolved) ? resolved : [resolved]).map((item) => ({ ...item }));
 }
 //#endregion
+//#region src/utils/mergeResolvers.ts
+/**
+* Merges an array of resolvers into a single resolver. Later entries override earlier ones (last wins).
+*/
+function mergeResolvers(...resolvers) {
+	return resolvers.reduce((acc, curr) => ({
+		...acc,
+		...curr
+	}), resolvers[0]);
+}
+//#endregion
+//#region src/utils/getPreset.ts
+function getPreset(params) {
+	const { preset: presetName, presets, resolvers, transformers: userTransformers } = params;
+	const [defaultResolver, ...userResolvers] = resolvers;
+	const preset = presets[presetName];
+	const baseResolver = mergeResolvers(defaultResolver, ...preset?.resolvers ?? []);
+	return {
+		baseResolver,
+		resolver: mergeResolvers(baseResolver, ...userResolvers ?? []),
+		transformers: [...preset?.transformers ?? [], ...userTransformers ?? []],
+		preset
+	};
+}
+//#endregion
 //#region src/utils/linters.ts
 async function isLinterAvailable(linter) {
 	try {
@@ -2393,17 +2457,6 @@ async function detectLinter() {
 	for (const linter of linterNames) if (await isLinterAvailable(linter)) return linter;
 }
 //#endregion
-//#region src/utils/mergeResolvers.ts
-/**
-* Merges an array of resolvers into a single resolver. Later entries override earlier ones (last wins).
-*/
-function mergeResolvers(...resolvers) {
-	return resolvers.reduce((acc, curr) => ({
-		...acc,
-		...curr
-	}), resolvers[0]);
-}
-//#endregion
 //#region src/utils/packageJSON.ts
 function getPackageJSONSync(cwd) {
 	const pkgPath = empathic_package.up({ cwd });
@@ -2443,6 +2496,8 @@ exports.defaultResolveOptions = defaultResolveOptions;
 exports.defineConfig = defineConfig;
 exports.defineGenerator = defineGenerator;
 exports.defineLogger = defineLogger;
+exports.definePreset = definePreset;
+exports.definePresets = definePresets;
 Object.defineProperty(exports, "definePrinter", {
 	enumerable: true,
 	get: function() {
@@ -2457,6 +2512,7 @@ exports.fsStorage = fsStorage;
 exports.getBarrelFiles = getBarrelFiles;
 exports.getConfigs = getConfigs;
 exports.getMode = getMode;
+exports.getPreset = getPreset;
 exports.isInputPath = isInputPath;
 exports.linters = linters;
 exports.logLevel = logLevel;