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

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { A as UserConfig, B as Storage, C as PluginWithLifeCycle, D as ResolveOptionsContext, E as ResolveNameParams, F as CoreGeneratorV2, G as AsyncEventEmitter, H as formatters, I as Generator, L as ReactGeneratorV2, M as UserPlugin, N as UserPluginWithLifeCycle, O as ResolvePathParams, P as UserResolver, R as defineGenerator, S as PluginParameter, T as PrinterFactoryOptions, U as linters, V as createStorage, W as logLevel, _ as Plugin, a as AdapterFactoryOptions, b as PluginLifecycle, c as Config, d as InputData, f as InputPath, g as Output, h as LoggerOptions, i as Adapter, j as UserLogger, k as Resolver, l as DevtoolsOptions, m as LoggerContext, n as PluginDriver, o as AdapterSource, p as Logger, r as getMode, s as BarrelType, u as Group, v as PluginContext, w as Printer, x as PluginLifecycleHooks, y as PluginFactoryOptions, z as KubbEvents } from "./PluginDriver-By5lhDKP.js";
+import { A as ResolveOptionsContext, B as ReactGeneratorV2, C as PluginParameter, D as Printer, E as Presets, F as UserPlugin, G as formatters, H as KubbEvents, I as UserPluginWithLifeCycle, J as AsyncEventEmitter, K as linters, L as UserResolver, M as Resolver, N as UserConfig, O as PrinterFactoryOptions, P as UserLogger, R as CoreGeneratorV2, S as PluginLifecycleHooks, T as Preset, U as Storage, V as defineGenerator, W as createStorage, _ as Output, a as AdapterFactoryOptions, b as PluginFactoryOptions, c as CompatibilityPreset, d as Group, f as InputData, g as LoggerOptions, h as LoggerContext, i as Adapter, j as ResolvePathParams, k as ResolveNameParams, l as Config, m as Logger, n as PluginDriver, o as AdapterSource, p as InputPath, q as logLevel, r as getMode, s as BarrelType, u as DevtoolsOptions, v as Plugin, w as PluginWithLifeCycle, x as PluginLifecycle, y as PluginContext, z as Generator } from "./PluginDriver-CNKhDf-w.js";
 import { definePrinter } from "@kubb/ast";
-import { Node, OperationNode, SchemaNode } from "@kubb/ast/types";
+import { Node, OperationNode, SchemaNode, Visitor } from "@kubb/ast/types";
 import { Fabric, KubbFile } from "@kubb/fabric-core/types";
 import { Fabric as Fabric$1 } from "@kubb/react-fabric/types";
 
@@ -133,6 +133,45 @@ declare function createPlugin<T extends PluginFactoryOptions = PluginFactoryOpti
  */
 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, 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] })
+ */
+declare function definePreset<TResolver extends Resolver = Resolver, TName extends string = string>(name: TName, {
+  resolvers,
+  transformers
+}: {
+  resolvers: Array<TResolver>;
+  transformers?: Array<Visitor>;
+}): Preset<TResolver> & {
+  name: TName;
+};
+//#endregion
+//#region src/definePresets.d.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] }),
+ * })
+ */
+declare function definePresets<TResolver extends Resolver = Resolver>(presets: Presets<TResolver>): Presets<TResolver>;
+//#endregion
 //#region src/defineResolver.d.ts
 /**
  * Builder type for the plugin-specific resolver fields.
@@ -364,6 +403,21 @@ declare function getBarrelFiles(files: Array<KubbFile.ResolvedFile>, {
  */
 declare function getConfigs(config: ConfigInput | UserConfig, args: CLIOptions): Promise<Array<Config>>;
 //#endregion
+//#region src/utils/getPreset.d.ts
+type GetPresetParams<TResolver extends Resolver> = {
+  preset: CompatibilityPreset;
+  presets: Presets<TResolver>;
+  resolvers: Array<TResolver>;
+  transformers?: Array<Visitor>;
+};
+type GetPresetResult<TResolver extends Resolver> = {
+  baseResolver: TResolver;
+  resolver: TResolver;
+  transformers: Array<Visitor>;
+  preset: Preset<TResolver> | undefined;
+};
+declare function getPreset<TResolver extends Resolver = Resolver>(params: GetPresetParams<TResolver>): GetPresetResult<TResolver>;
+//#endregion
 //#region src/utils/linters.d.ts
 type Linter = keyof typeof linters;
 declare function detectLinter(): Promise<Linter | undefined>;
@@ -379,5 +433,5 @@ type DependencyName = string;
 type DependencyVersion = string;
 declare function satisfiesDependency(dependency: DependencyName | RegExp, version: DependencyVersion, cwd?: string): boolean;
 //#endregion
-export { Adapter, AdapterFactoryOptions, AdapterSource, BarrelType, type CLIOptions, Config, type ConfigInput, CoreGeneratorV2, DevtoolsOptions, type FileMetaBase, FunctionParams, type FunctionParamsAST, Generator, Group, InputData, InputPath, KubbEvents, Logger, LoggerContext, LoggerOptions, Output, Plugin, PluginContext, PluginDriver, PluginFactoryOptions, PluginLifecycle, PluginLifecycleHooks, PluginParameter, PluginWithLifeCycle, Printer, PrinterFactoryOptions, ReactGeneratorV2, ResolveNameParams, ResolveOptionsContext, ResolvePathParams, Resolver, Storage, UserConfig, UserLogger, UserPlugin, UserPluginWithLifeCycle, UserResolver, build, build as default, createAdapter, createPlugin, createStorage, defaultResolveOptions, defineConfig, defineGenerator, defineLogger, definePrinter, defineResolver, detectFormatter, detectLinter, formatters, fsStorage, getBarrelFiles, getConfigs, getMode, isInputPath, linters, logLevel, memoryStorage, mergeResolvers, renderOperation, renderOperations, renderSchema, safeBuild, satisfiesDependency, setup };
+export { Adapter, AdapterFactoryOptions, AdapterSource, BarrelType, type CLIOptions, CompatibilityPreset, Config, type ConfigInput, CoreGeneratorV2, DevtoolsOptions, type FileMetaBase, FunctionParams, type FunctionParamsAST, Generator, Group, InputData, InputPath, KubbEvents, Logger, LoggerContext, LoggerOptions, Output, Plugin, PluginContext, PluginDriver, PluginFactoryOptions, PluginLifecycle, PluginLifecycleHooks, PluginParameter, PluginWithLifeCycle, Preset, Presets, Printer, PrinterFactoryOptions, ReactGeneratorV2, ResolveNameParams, ResolveOptionsContext, ResolvePathParams, Resolver, Storage, UserConfig, UserLogger, UserPlugin, UserPluginWithLifeCycle, UserResolver, build, build as default, createAdapter, createPlugin, createStorage, defaultResolveOptions, 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 };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1441,7 +1441,7 @@ const fsStorage = createStorage(() => ({
 }));
 //#endregion
 //#region package.json
-var version$1 = "5.0.0-alpha.14";
+var version$1 = "5.0.0-alpha.16";
 //#endregion
 //#region src/utils/diagnostics.ts
 /**
@@ -1846,6 +1846,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`).
@@ -2369,6 +2408,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 {
@@ -2387,17 +2451,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 = pkg.up({ cwd });
@@ -2426,6 +2479,6 @@ function satisfiesDependency(dependency, version, cwd) {
 	return satisfies(semVer, version);
 }
 //#endregion
-export { FunctionParams, PluginDriver, build, build as default, createAdapter, createPlugin, createStorage, defaultResolveOptions, defineConfig, defineGenerator, defineLogger, definePrinter, defineResolver, detectFormatter, detectLinter, formatters, fsStorage, getBarrelFiles, getConfigs, getMode, isInputPath, linters, logLevel, memoryStorage, mergeResolvers, renderOperation, renderOperations, renderSchema, safeBuild, satisfiesDependency, setup };
+export { FunctionParams, PluginDriver, build, build as default, createAdapter, createPlugin, createStorage, defaultResolveOptions, 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 };
 
 //# sourceMappingURL=index.js.map