@kubb/plugin-ts 5.0.0-alpha.15 → 5.0.0-alpha.17

package/dist/{resolvers-DDZC7d43.cjs → resolvers-YIpeP5YD.cjs}

@@ -77,10 +77,10 @@ const resolverTs = (0, _kubb_core.defineResolver)(() => {
 			return `${this.resolveTypedName(node.name ?? "")}Key`;
 		},
 		resolvePathParamsName(_node) {
-			throw new Error("resolvePathParamsName is only available in legacy mode (legacy: true). Use resolveParamName per individual parameter instead.");
+			throw new Error("resolvePathParamsName is only available with compatibilityPreset: 'kubbV4'. Use resolveParamName per individual parameter instead.");
 		},
 		resolvePathParamsTypedName(_node) {
-			throw new Error("resolvePathParamsTypedName is only available in legacy mode (legacy: true). Use resolveParamTypedName per individual parameter instead.");
+			throw new Error("resolvePathParamsTypedName is only available with compatibilityPreset: 'kubbV4'. Use resolveParamTypedName per individual parameter instead.");
 		},
 		resolveQueryParamsName(node) {
 			return this.resolveName(`${node.operationId} QueryParams`);
@@ -89,10 +89,10 @@ const resolverTs = (0, _kubb_core.defineResolver)(() => {
 			return this.resolveTypedName(`${node.operationId} QueryParams`);
 		},
 		resolveHeaderParamsName(_node) {
-			throw new Error("resolveHeaderParamsName is only available in legacy mode (legacy: true). Use resolveParamName per individual parameter instead.");
+			throw new Error("resolveHeaderParamsName is only available with compatibilityPreset: 'kubbV4'. Use resolveParamName per individual parameter instead.");
 		},
 		resolveHeaderParamsTypedName(_node) {
-			throw new Error("resolveHeaderParamsTypedName is only available in legacy mode (legacy: true). Use resolveParamTypedName per individual parameter instead.");
+			throw new Error("resolveHeaderParamsTypedName is only available with compatibilityPreset: 'kubbV4'. Use resolveParamTypedName per individual parameter instead.");
 		}
 	};
 });
@@ -100,7 +100,8 @@ const resolverTs = (0, _kubb_core.defineResolver)(() => {
 //#region src/resolvers/resolverTsLegacy.ts
 /**
 * Legacy resolver for `@kubb/plugin-ts` that reproduces the naming conventions
-* used before the v2 resolver refactor. Enable via `legacy: true` in plugin options.
+* used before the v2 resolver refactor. Enable via `compatibilityPreset: 'kubbV4'`
+* (or by composing this resolver manually).
 *
 * Key differences from the default resolver:
 * - Response status types: `<OperationId><StatusCode>` (e.g. `CreatePets201`) instead of `<OperationId>Status201`
@@ -190,4 +191,4 @@ Object.defineProperty(exports, "resolverTsLegacy", {
 	}
 });
 
-//# sourceMappingURL=resolvers-DDZC7d43.cjs.map
+//# sourceMappingURL=resolvers-YIpeP5YD.cjs.map

package/dist/resolvers-YIpeP5YD.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvers-YIpeP5YD.cjs","names":["pascalCase"],"sources":["../src/resolvers/resolverTs.ts","../src/resolvers/resolverTsLegacy.ts"],"sourcesContent":["import { pascalCase } from '@internals/utils'\nimport { defineResolver } from '@kubb/core'\nimport type { PluginTs } from '../types.ts'\n\nfunction resolveName(name: string, type?: 'file' | 'function' | 'type' | 'const'): string {\n  return pascalCase(name, { isFile: type === 'file' })\n}\n\n/**\n * Resolver for `@kubb/plugin-ts` that provides the default naming and path-resolution\n * helpers used by the plugin. Import this in other plugins to resolve the exact names and\n * paths that `plugin-ts` generates without hardcoding the conventions.\n *\n * The `default` method is automatically injected by `defineResolver` — it uses `camelCase`\n * for identifiers/files and `pascalCase` for type names.\n *\n * @example\n * ```ts\n * import { resolver } from '@kubb/plugin-ts'\n *\n * resolver.default('list pets', 'type')              // → 'ListPets'\n * resolver.resolveName('list pets status 200')        // → 'listPetsStatus200'\n * resolver.resolveTypedName('list pets status 200')   // → 'ListPetsStatus200'\n * resolver.resolvePathName('list pets', 'file')       // → 'listPets'\n * ```\n */\nexport const resolverTs = defineResolver<PluginTs>(() => {\n  return {\n    name: 'default',\n    default(name, type) {\n      return resolveName(name, type)\n    },\n    resolveName(name) {\n      return this.default(name, 'function')\n    },\n    resolveTypedName(name) {\n      return this.default(name, 'type')\n    },\n    resolvePathName(name, type) {\n      return this.default(name, type)\n    },\n    resolveParamName(node, param) {\n      return this.resolveName(`${node.operationId} ${this.default(param.in)} ${param.name}`)\n    },\n    resolveParamTypedName(node, param) {\n      return this.resolveTypedName(`${node.operationId} ${this.default(param.in)} ${param.name}`)\n    },\n    resolveResponseStatusName(node, statusCode) {\n      return this.resolveName(`${node.operationId} Status ${statusCode}`)\n    },\n    resolveResponseStatusTypedName(node, statusCode) {\n      return this.resolveTypedName(`${node.operationId} Status ${statusCode}`)\n    },\n    resolveDataName(node) {\n      return this.resolveName(`${node.operationId} Data`)\n    },\n    resolveDataTypedName(node) {\n      return this.resolveTypedName(`${node.operationId} Data`)\n    },\n    resolveRequestConfigName(node) {\n      return this.resolveName(`${node.operationId} RequestConfig`)\n    },\n    resolveRequestConfigTypedName(node) {\n      return this.resolveTypedName(`${node.operationId} RequestConfig`)\n    },\n    resolveResponsesName(node) {\n      return this.resolveName(`${node.operationId} Responses`)\n    },\n    resolveResponsesTypedName(node) {\n      return this.resolveTypedName(`${node.operationId} Responses`)\n    },\n    resolveResponseName(node) {\n      return this.resolveName(`${node.operationId} Response`)\n    },\n    resolveResponseTypedName(node) {\n      return this.resolveTypedName(`${node.operationId} Response`)\n    },\n    resolveEnumKeyTypedName(node) {\n      return `${this.resolveTypedName(node.name ?? '')}Key`\n    },\n    resolvePathParamsName(_node) {\n      throw new Error(\"resolvePathParamsName is only available with compatibilityPreset: 'kubbV4'. Use resolveParamName per individual parameter instead.\")\n    },\n    resolvePathParamsTypedName(_node) {\n      throw new Error(\n        \"resolvePathParamsTypedName is only available with compatibilityPreset: 'kubbV4'. Use resolveParamTypedName per individual parameter instead.\",\n      )\n    },\n    resolveQueryParamsName(node) {\n      return this.resolveName(`${node.operationId} QueryParams`)\n    },\n    resolveQueryParamsTypedName(node) {\n      return this.resolveTypedName(`${node.operationId} QueryParams`)\n    },\n    resolveHeaderParamsName(_node) {\n      throw new Error(\"resolveHeaderParamsName is only available with compatibilityPreset: 'kubbV4'. Use resolveParamName per individual parameter instead.\")\n    },\n    resolveHeaderParamsTypedName(_node) {\n      throw new Error(\n        \"resolveHeaderParamsTypedName is only available with compatibilityPreset: 'kubbV4'. Use resolveParamTypedName per individual parameter instead.\",\n      )\n    },\n  }\n})\n","import { defineResolver } from '@kubb/core'\nimport type { PluginTs } from '../types.ts'\nimport { resolverTs } from './resolverTs.ts'\n\n/**\n * Legacy resolver for `@kubb/plugin-ts` that reproduces the naming conventions\n * used before the v2 resolver refactor. Enable via `compatibilityPreset: 'kubbV4'`\n * (or by composing this resolver manually).\n *\n * Key differences from the default resolver:\n * - Response status types: `<OperationId><StatusCode>` (e.g. `CreatePets201`) instead of `<OperationId>Status201`\n * - Default/error responses: `<OperationId>Error` instead of `<OperationId>StatusDefault`\n * - Request body: `<OperationId>MutationRequest` (non-GET) / `<OperationId>QueryRequest` (GET)\n * - Combined responses type: `<OperationId>Mutation` / `<OperationId>Query`\n * - Response union: `<OperationId>MutationResponse` / `<OperationId>QueryResponse`\n *\n * @example\n * ```ts\n * import { resolverTsLegacy } from '@kubb/plugin-ts'\n *\n * resolverTsLegacy.resolveResponseStatusTypedName(node, 201)  // → 'CreatePets201'\n * resolverTsLegacy.resolveResponseStatusTypedName(node, 'default')  // → 'CreatePetsError'\n * resolverTsLegacy.resolveDataTypedName(node)  // → 'CreatePetsMutationRequest' (POST)\n * resolverTsLegacy.resolveResponsesTypedName(node)  // → 'CreatePetsMutation' (POST)\n * resolverTsLegacy.resolveResponseTypedName(node)  // → 'CreatePetsMutationResponse' (POST)\n * ```\n */\nexport const resolverTsLegacy = defineResolver<PluginTs>(() => {\n  return {\n    ...resolverTs,\n    name: 'legacy',\n    resolveResponseStatusName(node, statusCode) {\n      if (statusCode === 'default') {\n        return this.resolveName(`${node.operationId} Error`)\n      }\n      return this.resolveName(`${node.operationId} ${statusCode}`)\n    },\n    resolveResponseStatusTypedName(node, statusCode) {\n      if (statusCode === 'default') {\n        return this.resolveTypedName(`${node.operationId} Error`)\n      }\n      return this.resolveTypedName(`${node.operationId} ${statusCode}`)\n    },\n    resolveDataName(node) {\n      const suffix = node.method === 'GET' ? 'QueryRequest' : 'MutationRequest'\n      return this.resolveName(`${node.operationId} ${suffix}`)\n    },\n    resolveDataTypedName(node) {\n      const suffix = node.method === 'GET' ? 'QueryRequest' : 'MutationRequest'\n      return this.resolveTypedName(`${node.operationId} ${suffix}`)\n    },\n    resolveResponsesName(node) {\n      const suffix = node.method === 'GET' ? 'Query' : 'Mutation'\n      return `${this.default(node.operationId, 'function')}${suffix}`\n    },\n    resolveResponsesTypedName(node) {\n      const suffix = node.method === 'GET' ? 'Query' : 'Mutation'\n      return `${this.default(node.operationId, 'type')}${suffix}`\n    },\n    resolveResponseName(node) {\n      const suffix = node.method === 'GET' ? 'QueryResponse' : 'MutationResponse'\n      return this.resolveName(`${node.operationId} ${suffix}`)\n    },\n    resolveResponseTypedName(node) {\n      const suffix = node.method === 'GET' ? 'QueryResponse' : 'MutationResponse'\n      return this.resolveTypedName(`${node.operationId} ${suffix}`)\n    },\n    resolvePathParamsName(node) {\n      return this.resolveName(`${node.operationId} PathParams`)\n    },\n    resolvePathParamsTypedName(node) {\n      return this.resolveTypedName(`${node.operationId} PathParams`)\n    },\n    resolveQueryParamsName(node) {\n      return this.resolveName(`${node.operationId} QueryParams`)\n    },\n    resolveQueryParamsTypedName(node) {\n      return this.resolveTypedName(`${node.operationId} QueryParams`)\n    },\n    resolveHeaderParamsName(node) {\n      return this.resolveName(`${node.operationId} HeaderParams`)\n    },\n    resolveHeaderParamsTypedName(node) {\n      return this.resolveTypedName(`${node.operationId} HeaderParams`)\n    },\n  }\n})\n"],"mappings":"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"}

package/dist/resolvers.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_resolvers = require("./resolvers-DDZC7d43.cjs");
+const require_resolvers = require("./resolvers-YIpeP5YD.cjs");
 exports.resolverTs = require_resolvers.resolverTs;
 exports.resolverTsLegacy = require_resolvers.resolverTsLegacy;

package/dist/resolvers.d.ts

@@ -1,2 +1,52 @@
-import { n as resolverTs, t as resolverTsLegacy } from "./index-B5pSjbZv.js";
-export { resolverTs, resolverTsLegacy };
+import { t as __name } from "./chunk--u3MIqq1.js";
+import { r as ResolverTs } from "./types-zqLMbIqZ.js";
+
+//#region src/resolvers/resolverTs.d.ts
+/**
+ * Resolver for `@kubb/plugin-ts` that provides the default naming and path-resolution
+ * helpers used by the plugin. Import this in other plugins to resolve the exact names and
+ * paths that `plugin-ts` generates without hardcoding the conventions.
+ *
+ * The `default` method is automatically injected by `defineResolver` — it uses `camelCase`
+ * for identifiers/files and `pascalCase` for type names.
+ *
+ * @example
+ * ```ts
+ * import { resolver } from '@kubb/plugin-ts'
+ *
+ * resolver.default('list pets', 'type')              // → 'ListPets'
+ * resolver.resolveName('list pets status 200')        // → 'listPetsStatus200'
+ * resolver.resolveTypedName('list pets status 200')   // → 'ListPetsStatus200'
+ * resolver.resolvePathName('list pets', 'file')       // → 'listPets'
+ * ```
+ */
+declare const resolverTs: ResolverTs;
+//#endregion
+//#region src/resolvers/resolverTsLegacy.d.ts
+/**
+ * Legacy resolver for `@kubb/plugin-ts` that reproduces the naming conventions
+ * used before the v2 resolver refactor. Enable via `compatibilityPreset: 'kubbV4'`
+ * (or by composing this resolver manually).
+ *
+ * Key differences from the default resolver:
+ * - Response status types: `<OperationId><StatusCode>` (e.g. `CreatePets201`) instead of `<OperationId>Status201`
+ * - Default/error responses: `<OperationId>Error` instead of `<OperationId>StatusDefault`
+ * - Request body: `<OperationId>MutationRequest` (non-GET) / `<OperationId>QueryRequest` (GET)
+ * - Combined responses type: `<OperationId>Mutation` / `<OperationId>Query`
+ * - Response union: `<OperationId>MutationResponse` / `<OperationId>QueryResponse`
+ *
+ * @example
+ * ```ts
+ * import { resolverTsLegacy } from '@kubb/plugin-ts'
+ *
+ * resolverTsLegacy.resolveResponseStatusTypedName(node, 201)  // → 'CreatePets201'
+ * resolverTsLegacy.resolveResponseStatusTypedName(node, 'default')  // → 'CreatePetsError'
+ * resolverTsLegacy.resolveDataTypedName(node)  // → 'CreatePetsMutationRequest' (POST)
+ * resolverTsLegacy.resolveResponsesTypedName(node)  // → 'CreatePetsMutation' (POST)
+ * resolverTsLegacy.resolveResponseTypedName(node)  // → 'CreatePetsMutationResponse' (POST)
+ * ```
+ */
+declare const resolverTsLegacy: ResolverTs;
+//#endregion
+export { resolverTs, resolverTsLegacy };
+//# sourceMappingURL=resolvers.d.ts.map

package/dist/resolvers.js

@@ -1,2 +1,2 @@
-import { n as resolverTs, t as resolverTsLegacy } from "./resolvers-C_vYX56l.js";
+import { n as resolverTs, t as resolverTsLegacy } from "./resolvers-DsKabI0F.js";
 export { resolverTs, resolverTsLegacy };

package/dist/{types-D9zzvE0V.d.ts → types-zqLMbIqZ.d.ts}

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { Group, Output, PluginFactoryOptions, Resolver } from "@kubb/core";
+import { CompatibilityPreset, Group, Output, PluginFactoryOptions, Resolver } from "@kubb/core";
 import { OperationNode, ParameterNode, SchemaNode, StatusCode, Visitor } from "@kubb/ast/types";
 import { Oas, contentType } from "@kubb/oas";
 import { Exclude, Include, Override, ResolvePathOptions } from "@kubb/plugin-oas";
@@ -137,54 +137,54 @@ type ResolverTs = Resolver & {
   resolveEnumKeyTypedName(node: SchemaNode): string;
   /**
    * Resolves the variable/function name for an operation's grouped path parameters type.
-   * Only available in legacy mode (`legacy: true`).
+   * Only available with `compatibilityPreset: 'kubbV4'`.
    *
-   * @deprecated Legacy only — will be removed in v6. Use `resolveParamName` per individual parameter instead.
+   * @deprecated Kubb v4 compatibility only — use `resolveParamName` per individual parameter instead.
    * @example
    * resolver.resolvePathParamsName(node) // → 'GetPetByIdPathParams'
    */
   resolvePathParamsName?(node: OperationNode): string;
   /**
    * Resolves the TypeScript type alias name for an operation's grouped path parameters type.
-   * Only available in legacy mode (`legacy: true`).
+   * Only available with `compatibilityPreset: 'kubbV4'`.
    *
-   * @deprecated Legacy only — will be removed in v6. Use `resolveParamTypedName` per individual parameter instead.
+   * @deprecated Kubb v4 compatibility only — use `resolveParamTypedName` per individual parameter instead.
    * @example
    * resolver.resolvePathParamsTypedName(node) // → 'GetPetByIdPathParams'
    */
   resolvePathParamsTypedName?(node: OperationNode): string;
   /**
    * Resolves the variable/function name for an operation's grouped query parameters type.
-   * Only available in legacy mode (`legacy: true`).
+   * Only available with `compatibilityPreset: 'kubbV4'`.
    *
-   * @deprecated Legacy only — will be removed in v6. Use `resolveParamName` per individual parameter instead.
+   * @deprecated Kubb v4 compatibility only — use `resolveParamName` per individual parameter instead.
    * @example
    * resolver.resolveQueryParamsName(node) // → 'FindPetsByStatusQueryParams'
    */
   resolveQueryParamsName?(node: OperationNode): string;
   /**
    * Resolves the TypeScript type alias name for an operation's grouped query parameters type.
-   * Only available in legacy mode (`legacy: true`).
+   * Only available with `compatibilityPreset: 'kubbV4'`.
    *
-   * @deprecated Legacy only — will be removed in v6. Use `resolveParamTypedName` per individual parameter instead.
+   * @deprecated Kubb v4 compatibility only — use `resolveParamTypedName` per individual parameter instead.
    * @example
    * resolver.resolveQueryParamsTypedName(node) // → 'FindPetsByStatusQueryParams'
    */
   resolveQueryParamsTypedName?(node: OperationNode): string;
   /**
    * Resolves the variable/function name for an operation's grouped header parameters type.
-   * Only available in legacy mode (`legacy: true`).
+   * Only available with `compatibilityPreset: 'kubbV4'`.
    *
-   * @deprecated Legacy only — will be removed in v6. Use `resolveParamName` per individual parameter instead.
+   * @deprecated Kubb v4 compatibility only — use `resolveParamName` per individual parameter instead.
    * @example
    * resolver.resolveHeaderParamsName(node) // → 'DeletePetHeaderParams'
    */
   resolveHeaderParamsName?(node: OperationNode): string;
   /**
    * Resolves the TypeScript type alias name for an operation's grouped header parameters type.
-   * Only available in legacy mode (`legacy: true`).
+   * Only available with `compatibilityPreset: 'kubbV4'`.
    *
-   * @deprecated Legacy only — will be removed in v6. Use `resolveParamTypedName` per individual parameter instead.
+   * @deprecated Kubb v4 compatibility only — use `resolveParamTypedName` per individual parameter instead.
    * @example
    * resolver.resolveHeaderParamsTypedName(node) // → 'DeletePetHeaderParams'
    */
@@ -277,10 +277,12 @@ type Options = {
    */
   UNSTABLE_NAMING?: true;
   /**
-   * Enable legacy naming conventions for backwards compatibility.
-   * @default false
+   * Apply a compatibility naming preset.
+   * Use `kubbV4` for strict v4 type-generation compatibility.
+   * You can further customize naming with `resolvers`.
+   * @default 'default'
    */
-  legacy?: boolean;
+  compatibilityPreset?: CompatibilityPreset;
   /**
    * Array of named resolvers that control naming conventions.
    * Later entries override earlier ones (last wins).
@@ -322,7 +324,7 @@ type ResolvedOptions = {
   arrayType: NonNullable<Options['arrayType']>;
   syntaxType: NonNullable<Options['syntaxType']>;
   paramsCasing: Options['paramsCasing'];
-  legacy: NonNullable<Options['legacy']>;
+  compatibilityPreset: NonNullable<CompatibilityPreset>;
   resolver: ResolverTs;
   /**
    * The resolver without user naming overrides applied.
@@ -335,4 +337,4 @@ type ResolvedOptions = {
 type PluginTs = PluginFactoryOptions<'plugin-ts', Options, ResolvedOptions, never, ResolvePathOptions, ResolverTs>;
 //#endregion
 export { PluginTs as n, ResolverTs as r, Options as t };
-//# sourceMappingURL=types-D9zzvE0V.d.ts.map
+//# sourceMappingURL=types-zqLMbIqZ.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-ts",
-  "version": "5.0.0-alpha.15",
+  "version": "5.0.0-alpha.17",
   "description": "TypeScript code generation plugin for Kubb, transforming OpenAPI schemas into TypeScript interfaces, types, and utility functions.",
   "keywords": [
     "typescript",
@@ -78,10 +78,10 @@
     "@kubb/react-fabric": "0.14.0",
     "remeda": "^2.33.6",
     "typescript": "5.9.3",
-    "@kubb/core": "5.0.0-alpha.15",
-    "@kubb/oas": "5.0.0-alpha.15",
-    "@kubb/ast": "5.0.0-alpha.15",
-    "@kubb/plugin-oas": "5.0.0-alpha.15"
+    "@kubb/ast": "5.0.0-alpha.17",
+    "@kubb/oas": "5.0.0-alpha.17",
+    "@kubb/core": "5.0.0-alpha.17",
+    "@kubb/plugin-oas": "5.0.0-alpha.17"
   },
   "peerDependencies": {
     "@kubb/react-fabric": "0.14.0"

package/src/components/Type.tsx

@@ -1,4 +1,4 @@
-import { collect } from '@kubb/ast'
+import { collect, narrowSchema, schemaTypes } from '@kubb/ast'
 import type { EnumSchemaNode, SchemaNode } from '@kubb/ast/types'
 import { safePrint } from '@kubb/fabric-core/parsers/typescript'
 import { File } from '@kubb/react-fabric'
@@ -38,7 +38,8 @@ export function Type({
   const resolvedDescription = description || node?.description
   const enumSchemaNodes = collect<EnumSchemaNode>(node, {
     schema(n): EnumSchemaNode | undefined {
-      if (n.type === 'enum' && n.name) return n as EnumSchemaNode
+      const enumNode = narrowSchema(n, schemaTypes.enum)
+      if (enumNode?.name) return enumNode
     },
   })
 

package/src/generators/typeGenerator.tsx

@@ -1,4 +1,4 @@
-import { applyParamsCasing, composeTransformers, transform } from '@kubb/ast'
+import { caseParams, composeTransformers, narrowSchema, schemaTypes, transform } from '@kubb/ast'
 import type { SchemaNode } from '@kubb/ast/types'
 import { defineGenerator } from '@kubb/core'
 import { useKubb } from '@kubb/core/hooks'
@@ -21,7 +21,20 @@ export const typeGenerator = defineGenerator<PluginTs>({
   name: 'typescript',
   type: 'react',
   Operation({ node, adapter, options }) {
-    const { enumType, enumKeyCasing, optionalType, arrayType, syntaxType, paramsCasing, group, resolver, baseResolver, legacy, transformers = [] } = options
+    const {
+      enumType,
+      enumKeyCasing,
+      optionalType,
+      arrayType,
+      syntaxType,
+      paramsCasing,
+      group,
+      resolver,
+      baseResolver,
+      compatibilityPreset,
+      transformers = [],
+    } = options
+    const isKubbV4Compatibility = compatibilityPreset === 'kubbV4'
     const { mode, getFile, resolveBanner, resolveFooter } = useKubb<PluginTs>()
 
     const file = getFile({
@@ -32,7 +45,7 @@ export const typeGenerator = defineGenerator<PluginTs>({
         group: group ? (group.type === 'tag' ? { tag: node.tags[0] ?? 'default' } : { path: node.path }) : undefined,
       },
     })
-    const params = applyParamsCasing(node.parameters, paramsCasing)
+    const params = caseParams(node.parameters, paramsCasing)
 
     function renderSchemaType({
       node: schemaNode,
@@ -74,13 +87,13 @@ export const typeGenerator = defineGenerator<PluginTs>({
             syntaxType={syntaxType}
             resolver={resolver}
             keysToOmit={keysToOmit}
-            legacy={legacy}
+            legacy={isKubbV4Compatibility}
           />
         </>
       )
     }
 
-    const responseTypes = legacy
+    const responseTypes = isKubbV4Compatibility
       ? node.responses.map((res) => {
           const responseName = resolver.resolveResponseStatusName(node, res.statusCode)
           const baseResponseName = baseResolver.resolveResponseStatusName(node, res.statusCode)
@@ -105,7 +118,7 @@ export const typeGenerator = defineGenerator<PluginTs>({
 
     const requestType = node.requestBody?.schema
       ? renderSchemaType({
-          node: legacy ? nameUnnamedEnums(node.requestBody.schema, baseResolver.resolveDataName(node)) : node.requestBody.schema,
+          node: isKubbV4Compatibility ? nameUnnamedEnums(node.requestBody.schema, baseResolver.resolveDataName(node)) : node.requestBody.schema,
           name: resolver.resolveDataName(node),
           typedName: resolver.resolveDataTypedName(node),
           description: node.requestBody.description ?? node.requestBody.schema.description,
@@ -113,7 +126,7 @@ export const typeGenerator = defineGenerator<PluginTs>({
         })
       : null
 
-    if (legacy) {
+    if (isKubbV4Compatibility) {
       const pathParams = params.filter((p) => p.in === 'path')
       const queryParams = params.filter((p) => p.in === 'query')
       const headerParams = params.filter((p) => p.in === 'header')
@@ -215,7 +228,8 @@ export const typeGenerator = defineGenerator<PluginTs>({
     )
   },
   Schema({ node, adapter, options }) {
-    const { enumType, enumKeyCasing, syntaxType, optionalType, arrayType, resolver, legacy, transformers = [] } = options
+    const { enumType, enumKeyCasing, syntaxType, optionalType, arrayType, resolver, compatibilityPreset, transformers = [] } = options
+    const isKubbV4Compatibility = compatibilityPreset === 'kubbV4'
     const { mode, getFile, resolveBanner, resolveFooter } = useKubb<PluginTs>()
 
     if (!node.name) {
@@ -229,7 +243,7 @@ export const typeGenerator = defineGenerator<PluginTs>({
       path: getFile({ name: schemaName, extname: '.ts', mode }).path,
     }))
 
-    const isEnumSchema = node.type === 'enum'
+    const isEnumSchema = !!narrowSchema(node, schemaTypes.enum)
 
     const typedName = ENUM_TYPES_WITH_KEY_SUFFIX.has(enumType) && isEnumSchema ? resolver.resolveEnumKeyTypedName(node) : resolver.resolveTypedName(node.name)
 
@@ -255,7 +269,7 @@ export const typeGenerator = defineGenerator<PluginTs>({
           arrayType={arrayType}
           syntaxType={syntaxType}
           resolver={resolver}
-          legacy={legacy}
+          legacy={isKubbV4Compatibility}
         />
       </File>
     )

package/src/generators/utils.ts

@@ -288,8 +288,9 @@ export function buildLegacyResponseUnionSchemaNode({ node, resolver }: BuildOper
 export function nameUnnamedEnums(node: SchemaNode, parentName: string): SchemaNode {
   return transform(node, {
     schema(n) {
-      if (n.type === 'enum' && !n.name) {
-        return { ...n, name: pascalCase([parentName, 'enum'].join(' ')) }
+      const enumNode = narrowSchema(n, 'enum')
+      if (enumNode && !enumNode.name) {
+        return { ...enumNode, name: pascalCase([parentName, 'enum'].join(' ')) }
       }
       return undefined
     },

package/src/index.ts

@@ -1,3 +1,2 @@
 export { pluginTs, pluginTsName } from './plugin.ts'
-export { resolverTs, resolverTsLegacy } from './resolvers/index.ts'
 export type { PluginTs, ResolverTs } from './types.ts'

package/src/plugin.ts

@@ -1,9 +1,9 @@
 import path from 'node:path'
 import { camelCase } from '@internals/utils'
 import { walk } from '@kubb/ast'
-import { createPlugin, type Group, getBarrelFiles, getMode, mergeResolvers, renderOperation, renderSchema } from '@kubb/core'
+import { createPlugin, type Group, getBarrelFiles, getMode, renderOperation, renderSchema } from '@kubb/core'
 import { typeGenerator } from './generators/index.ts'
-import { resolverTs, resolverTsLegacy } from './resolvers/index.ts'
+import { getPreset } from './presets.ts'
 import type { PluginTs } from './types.ts'
 
 export const pluginTsName = 'plugin-ts' satisfies PluginTs['name']
@@ -22,13 +22,15 @@ export const pluginTs = createPlugin<PluginTs>((options) => {
     syntaxType = 'type',
     paramsCasing,
     generators = [typeGenerator].filter(Boolean),
-    legacy = false,
+    compatibilityPreset = 'default',
     resolvers: userResolvers,
-    transformers = [],
+    transformers: userTransformers = [],
   } = options
 
-  const baseResolver = legacy ? resolverTsLegacy : resolverTs
-  const resolver = mergeResolvers(...(userResolvers ?? [baseResolver]))
+  const { baseResolver, resolver, transformers } = getPreset(compatibilityPreset, {
+    resolvers: userResolvers,
+    transformers: userTransformers,
+  })
 
   let resolveNameWarning = false
 
@@ -44,9 +46,9 @@ export const pluginTs = createPlugin<PluginTs>((options) => {
       group,
       override,
       paramsCasing,
-      legacy,
-      resolver,
+      compatibilityPreset,
       baseResolver,
+      resolver,
       transformers,
     },
     resolvePath(baseName, pathMode, options) {

package/src/presets.ts

@@ -0,0 +1,23 @@
+import type { Visitor } from '@kubb/ast/types'
+import { type CompatibilityPreset, definePreset, definePresets, getPreset as getCorePreset } from '@kubb/core'
+import { resolverTs, resolverTsLegacy } from './resolvers/index.ts'
+import type { ResolverTs } from './types.ts'
+
+export const presets = definePresets<ResolverTs>({
+  default: definePreset('default', { resolvers: [resolverTs] }),
+  kubbV4: definePreset('kubbV4', { resolvers: [resolverTsLegacy] }),
+})
+
+type GetPresetOptions = {
+  resolvers?: Array<ResolverTs>
+  transformers?: Array<Visitor>
+}
+
+export function getPreset(preset: CompatibilityPreset, { resolvers, transformers }: GetPresetOptions = {}) {
+  return getCorePreset({
+    preset,
+    presets,
+    resolvers: [resolverTs, ...(resolvers ?? [])],
+    transformers,
+  })
+}

package/src/printer.ts

@@ -1,5 +1,5 @@
 import { jsStringEscape, stringify } from '@internals/utils'
-import { isPlainStringType } from '@kubb/ast'
+import { isStringType, narrowSchema, schemaTypes } from '@kubb/ast'
 import type { ArraySchemaNode, SchemaNode } from '@kubb/ast/types'
 import type { PrinterFactoryOptions } from '@kubb/core'
 import { definePrinter } from '@kubb/core'
@@ -271,13 +271,16 @@ export const printerTs = definePrinter<TsPrinter>((options) => {
       union(node) {
         const members = node.members ?? []
 
-        const hasStringLiteral = members.some((m) => m.type === 'enum' && (m.enumType === 'string' || m.primitive === 'string'))
-        const hasPlainString = members.some((m) => isPlainStringType(m))
+        const hasStringLiteral = members.some((m) => {
+          const enumNode = narrowSchema(m, schemaTypes.enum)
+          return enumNode?.primitive === 'string'
+        })
+        const hasPlainString = members.some((m) => isStringType(m))
 
         if (hasStringLiteral && hasPlainString) {
           const memberNodes = members
             .map((m) => {
-              if (isPlainStringType(m)) {
+              if (isStringType(m)) {
                 return factory.createIntersectionDeclaration({
                   nodes: [factory.keywordTypeNodes.string, factory.createTypeLiteralNode([])],
                   withParentheses: true,

package/src/resolvers/resolverTs.ts

@@ -79,10 +79,12 @@ export const resolverTs = defineResolver<PluginTs>(() => {
       return `${this.resolveTypedName(node.name ?? '')}Key`
     },
     resolvePathParamsName(_node) {
-      throw new Error('resolvePathParamsName is only available in legacy mode (legacy: true). Use resolveParamName per individual parameter instead.')
+      throw new Error("resolvePathParamsName is only available with compatibilityPreset: 'kubbV4'. Use resolveParamName per individual parameter instead.")
     },
     resolvePathParamsTypedName(_node) {
-      throw new Error('resolvePathParamsTypedName is only available in legacy mode (legacy: true). Use resolveParamTypedName per individual parameter instead.')
+      throw new Error(
+        "resolvePathParamsTypedName is only available with compatibilityPreset: 'kubbV4'. Use resolveParamTypedName per individual parameter instead.",
+      )
     },
     resolveQueryParamsName(node) {
       return this.resolveName(`${node.operationId} QueryParams`)
@@ -91,11 +93,11 @@ export const resolverTs = defineResolver<PluginTs>(() => {
       return this.resolveTypedName(`${node.operationId} QueryParams`)
     },
     resolveHeaderParamsName(_node) {
-      throw new Error('resolveHeaderParamsName is only available in legacy mode (legacy: true). Use resolveParamName per individual parameter instead.')
+      throw new Error("resolveHeaderParamsName is only available with compatibilityPreset: 'kubbV4'. Use resolveParamName per individual parameter instead.")
     },
     resolveHeaderParamsTypedName(_node) {
       throw new Error(
-        'resolveHeaderParamsTypedName is only available in legacy mode (legacy: true). Use resolveParamTypedName per individual parameter instead.',
+        "resolveHeaderParamsTypedName is only available with compatibilityPreset: 'kubbV4'. Use resolveParamTypedName per individual parameter instead.",
       )
     },
   }

package/src/resolvers/resolverTsLegacy.ts

@@ -4,7 +4,8 @@ import { resolverTs } from './resolverTs.ts'
 
 /**
  * Legacy resolver for `@kubb/plugin-ts` that reproduces the naming conventions
- * used before the v2 resolver refactor. Enable via `legacy: true` in plugin options.
+ * used before the v2 resolver refactor. Enable via `compatibilityPreset: 'kubbV4'`
+ * (or by composing this resolver manually).
  *
  * Key differences from the default resolver:
  * - Response status types: `<OperationId><StatusCode>` (e.g. `CreatePets201`) instead of `<OperationId>Status201`

package/src/types.ts

@@ -1,5 +1,5 @@
 import type { OperationNode, ParameterNode, SchemaNode, StatusCode, Visitor } from '@kubb/ast/types'
-import type { Group, Output, PluginFactoryOptions, Resolver } from '@kubb/core'
+import type { CompatibilityPreset, Group, Output, PluginFactoryOptions, Resolver } from '@kubb/core'
 import type { contentType, Oas } from '@kubb/oas'
 import type { Exclude, Include, Override, ResolvePathOptions } from '@kubb/plugin-oas'
 import type { Generator } from '@kubb/plugin-oas/generators'
@@ -135,54 +135,54 @@ export type ResolverTs = Resolver & {
   resolveEnumKeyTypedName(node: SchemaNode): string
   /**
    * Resolves the variable/function name for an operation's grouped path parameters type.
-   * Only available in legacy mode (`legacy: true`).
+   * Only available with `compatibilityPreset: 'kubbV4'`.
    *
-   * @deprecated Legacy only — will be removed in v6. Use `resolveParamName` per individual parameter instead.
+   * @deprecated Kubb v4 compatibility only — use `resolveParamName` per individual parameter instead.
    * @example
    * resolver.resolvePathParamsName(node) // → 'GetPetByIdPathParams'
    */
   resolvePathParamsName?(node: OperationNode): string
   /**
    * Resolves the TypeScript type alias name for an operation's grouped path parameters type.
-   * Only available in legacy mode (`legacy: true`).
+   * Only available with `compatibilityPreset: 'kubbV4'`.
    *
-   * @deprecated Legacy only — will be removed in v6. Use `resolveParamTypedName` per individual parameter instead.
+   * @deprecated Kubb v4 compatibility only — use `resolveParamTypedName` per individual parameter instead.
    * @example
    * resolver.resolvePathParamsTypedName(node) // → 'GetPetByIdPathParams'
    */
   resolvePathParamsTypedName?(node: OperationNode): string
   /**
    * Resolves the variable/function name for an operation's grouped query parameters type.
-   * Only available in legacy mode (`legacy: true`).
+   * Only available with `compatibilityPreset: 'kubbV4'`.
    *
-   * @deprecated Legacy only — will be removed in v6. Use `resolveParamName` per individual parameter instead.
+   * @deprecated Kubb v4 compatibility only — use `resolveParamName` per individual parameter instead.
    * @example
    * resolver.resolveQueryParamsName(node) // → 'FindPetsByStatusQueryParams'
    */
   resolveQueryParamsName?(node: OperationNode): string
   /**
    * Resolves the TypeScript type alias name for an operation's grouped query parameters type.
-   * Only available in legacy mode (`legacy: true`).
+   * Only available with `compatibilityPreset: 'kubbV4'`.
    *
-   * @deprecated Legacy only — will be removed in v6. Use `resolveParamTypedName` per individual parameter instead.
+   * @deprecated Kubb v4 compatibility only — use `resolveParamTypedName` per individual parameter instead.
    * @example
    * resolver.resolveQueryParamsTypedName(node) // → 'FindPetsByStatusQueryParams'
    */
   resolveQueryParamsTypedName?(node: OperationNode): string
   /**
    * Resolves the variable/function name for an operation's grouped header parameters type.
-   * Only available in legacy mode (`legacy: true`).
+   * Only available with `compatibilityPreset: 'kubbV4'`.
    *
-   * @deprecated Legacy only — will be removed in v6. Use `resolveParamName` per individual parameter instead.
+   * @deprecated Kubb v4 compatibility only — use `resolveParamName` per individual parameter instead.
    * @example
    * resolver.resolveHeaderParamsName(node) // → 'DeletePetHeaderParams'
    */
   resolveHeaderParamsName?(node: OperationNode): string
   /**
    * Resolves the TypeScript type alias name for an operation's grouped header parameters type.
-   * Only available in legacy mode (`legacy: true`).
+   * Only available with `compatibilityPreset: 'kubbV4'`.
    *
-   * @deprecated Legacy only — will be removed in v6. Use `resolveParamTypedName` per individual parameter instead.
+   * @deprecated Kubb v4 compatibility only — use `resolveParamTypedName` per individual parameter instead.
    * @example
    * resolver.resolveHeaderParamsTypedName(node) // → 'DeletePetHeaderParams'
    */
@@ -276,10 +276,12 @@ export type Options = {
    */
   UNSTABLE_NAMING?: true
   /**
-   * Enable legacy naming conventions for backwards compatibility.
-   * @default false
+   * Apply a compatibility naming preset.
+   * Use `kubbV4` for strict v4 type-generation compatibility.
+   * You can further customize naming with `resolvers`.
+   * @default 'default'
    */
-  legacy?: boolean
+  compatibilityPreset?: CompatibilityPreset
   /**
    * Array of named resolvers that control naming conventions.
    * Later entries override earlier ones (last wins).
@@ -322,7 +324,7 @@ type ResolvedOptions = {
   arrayType: NonNullable<Options['arrayType']>
   syntaxType: NonNullable<Options['syntaxType']>
   paramsCasing: Options['paramsCasing']
-  legacy: NonNullable<Options['legacy']>
+  compatibilityPreset: NonNullable<CompatibilityPreset>
   resolver: ResolverTs
   /**
    * The resolver without user naming overrides applied.