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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/core",
-  "version": "5.0.0-alpha.14",
+  "version": "5.0.0-alpha.16",
   "description": "Core functionality for Kubb's plugin-based code generation system, providing the foundation for transforming OpenAPI specifications.",
   "keywords": [
     "typescript",
@@ -71,7 +71,7 @@
     "remeda": "^2.33.6",
     "semver": "^7.7.4",
     "tinyexec": "^1.0.4",
-    "@kubb/ast": "5.0.0-alpha.14"
+    "@kubb/ast": "5.0.0-alpha.16"
   },
   "devDependencies": {
     "@types/semver": "^7.7.1",

package/src/definePreset.ts

@@ -0,0 +1,23 @@
+import type { Visitor } from '@kubb/ast/types'
+import type { Preset, Resolver } from './types.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] })
+ */
+export function definePreset<TResolver extends Resolver = Resolver, TName extends string = string>(
+  name: TName,
+  { resolvers, transformers }: { resolvers: Array<TResolver>; transformers?: Array<Visitor> },
+): Preset<TResolver> & { name: TName } {
+  return { name, resolvers, transformers }
+}

package/src/definePresets.ts

@@ -0,0 +1,16 @@
+import type { Preset, Presets, Resolver } from './types.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] }),
+ * })
+ */
+export function definePresets<TResolver extends Resolver = Resolver>(presets: Presets<TResolver>): Presets<TResolver> {
+  return presets
+}

package/src/index.ts

@@ -7,6 +7,8 @@ export { createPlugin } from './createPlugin.ts'
 export { createStorage } from './createStorage.ts'
 export { defineGenerator } from './defineGenerator.ts'
 export { defineLogger } from './defineLogger.ts'
+export { definePreset } from './definePreset.ts'
+export { definePresets } from './definePresets.ts'
 export { defaultResolveOptions, defineResolver } from './defineResolver.ts'
 export { getMode, PluginDriver } from './PluginDriver.ts'
 export { renderOperation, renderOperations, renderSchema } from './renderNode.tsx'
@@ -19,6 +21,7 @@ export { detectFormatter } from './utils/formatters.ts'
 export type { FileMetaBase } from './utils/getBarrelFiles.ts'
 export { getBarrelFiles } from './utils/getBarrelFiles.ts'
 export { getConfigs } from './utils/getConfigs.ts'
+export { getPreset } from './utils/getPreset.ts'
 export { detectLinter } from './utils/linters.ts'
 export { mergeResolvers } from './utils/mergeResolvers.ts'
 export { satisfiesDependency } from './utils/packageJSON.ts'

package/src/types.ts

@@ -1,5 +1,5 @@
 import type { AsyncEventEmitter, PossiblePromise } from '@internals/utils'
-import type { Node, RootNode, SchemaNode } from '@kubb/ast/types'
+import type { Node, RootNode, SchemaNode, Visitor } from '@kubb/ast/types'
 import type { Fabric as FabricType, KubbFile } from '@kubb/fabric-core/types'
 import type { DEFAULT_STUDIO_URL, logLevel } from './constants.ts'
 import type { Storage } from './createStorage.ts'
@@ -544,6 +544,42 @@ export type Logger<TOptions extends LoggerOptions = LoggerOptions> = {
 
 export 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.
+ */
+export type CompatibilityPreset = 'default' | 'kubbV4'
+
 export type { Storage } from './createStorage.ts'
 export type { CoreGeneratorV2, Generator, ReactGeneratorV2 } from './defineGenerator.ts'
 export type { KubbEvents } from './Kubb.ts'
+
+/**
+ * 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.
+ */
+export 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.
+ */
+export type Presets<TResolver extends Resolver = Resolver> = Record<CompatibilityPreset, Preset<TResolver>>

package/src/utils/getPreset.ts

@@ -0,0 +1,34 @@
+import type { Visitor } from '@kubb/ast/types'
+import type { CompatibilityPreset, Preset, Presets, Resolver } from '../types.ts'
+import { mergeResolvers } from './mergeResolvers.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
+}
+
+export function getPreset<TResolver extends Resolver = Resolver>(params: GetPresetParams<TResolver>): GetPresetResult<TResolver> {
+  const { preset: presetName, presets, resolvers, transformers: userTransformers } = params
+  const [defaultResolver, ...userResolvers] = resolvers
+  const preset = presets[presetName]
+
+  const baseResolver = mergeResolvers(defaultResolver!, ...(preset?.resolvers ?? []))
+  const resolver = mergeResolvers(baseResolver, ...(userResolvers ?? []))
+  const transformers = [...(preset?.transformers ?? []), ...(userTransformers ?? [])]
+
+  return {
+    baseResolver,
+    resolver,
+    transformers,
+    preset,
+  }
+}