@kubb/plugin-ts 5.0.0-alpha.11 → 5.0.0-alpha.12

package/dist/index.js

@@ -1,2 +1,305 @@
-import { i as resolverTs, n as pluginTsName, t as pluginTs } from "./plugin-D60XNJSD.js";
-export { pluginTs, pluginTsName, resolverTs };
+import "./chunk--u3MIqq1.js";
+import { a as pascalCase, i as camelCase } from "./Type-CX1HRooG.js";
+import { t as typeGenerator } from "./generators-CLuCmfUz.js";
+import path from "node:path";
+import { walk } from "@kubb/ast";
+import { createPlugin, defineResolver, getBarrelFiles, getMode, renderOperation, renderSchema } from "@kubb/core";
+//#region src/resolverTs.ts
+function resolveName(name, type) {
+	return pascalCase(name, { isFile: type === "file" });
+}
+/**
+* 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'
+* ```
+*/
+const resolverTs = defineResolver(() => {
+	return {
+		default(name, type) {
+			return resolveName(name, type);
+		},
+		resolveName(name) {
+			return this.default(name, "function");
+		},
+		resolveTypedName(name) {
+			return this.default(name, "type");
+		},
+		resolvePathName(name, type) {
+			return this.default(name, type);
+		},
+		resolveParamName(node, param) {
+			return this.resolveName(`${node.operationId} ${this.default(param.in)} ${param.name}`);
+		},
+		resolveParamTypedName(node, param) {
+			return this.resolveTypedName(`${node.operationId} ${this.default(param.in)} ${param.name}`);
+		},
+		resolveResponseStatusName(node, statusCode) {
+			return this.resolveName(`${node.operationId} Status ${statusCode}`);
+		},
+		resolveResponseStatusTypedName(node, statusCode) {
+			return this.resolveTypedName(`${node.operationId} Status ${statusCode}`);
+		},
+		resolveDataName(node) {
+			return this.resolveName(`${node.operationId} Data`);
+		},
+		resolveDataTypedName(node) {
+			return this.resolveTypedName(`${node.operationId} Data`);
+		},
+		resolveRequestConfigName(node) {
+			return this.resolveName(`${node.operationId} RequestConfig`);
+		},
+		resolveRequestConfigTypedName(node) {
+			return this.resolveTypedName(`${node.operationId} RequestConfig`);
+		},
+		resolveResponsesName(node) {
+			return this.resolveName(`${node.operationId} Responses`);
+		},
+		resolveResponsesTypedName(node) {
+			return this.resolveTypedName(`${node.operationId} Responses`);
+		},
+		resolveResponseName(node) {
+			return this.resolveName(`${node.operationId} Response`);
+		},
+		resolveResponseTypedName(node) {
+			return this.resolveTypedName(`${node.operationId} Response`);
+		},
+		resolveEnumKeyTypedName(node) {
+			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.");
+		},
+		resolvePathParamsTypedName(_node) {
+			throw new Error("resolvePathParamsTypedName is only available in legacy mode (legacy: true). Use resolveParamTypedName per individual parameter instead.");
+		},
+		resolveQueryParamsName(_node) {
+			throw new Error("resolveQueryParamsName is only available in legacy mode (legacy: true). Use resolveParamName per individual parameter instead.");
+		},
+		resolveQueryParamsTypedName(_node) {
+			throw new Error("resolveQueryParamsTypedName is only available in legacy mode (legacy: true). Use resolveParamTypedName per individual parameter instead.");
+		},
+		resolveHeaderParamsName(_node) {
+			throw new Error("resolveHeaderParamsName is only available in legacy mode (legacy: true). 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.");
+		}
+	};
+});
+/**
+* Legacy resolver for `@kubb/plugin-ts` that reproduces the naming conventions
+* used before the v2 resolver refactor. Enable via `legacy: true` in plugin options.
+*
+* 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)
+* ```
+*/
+const resolverTsLegacy = defineResolver(() => {
+	return {
+		...resolverTs,
+		resolveResponseStatusName(node, statusCode) {
+			if (statusCode === "default") return this.resolveName(`${node.operationId} Error`);
+			return this.resolveName(`${node.operationId} ${statusCode}`);
+		},
+		resolveResponseStatusTypedName(node, statusCode) {
+			if (statusCode === "default") return this.resolveTypedName(`${node.operationId} Error`);
+			return this.resolveTypedName(`${node.operationId} ${statusCode}`);
+		},
+		resolveDataName(node) {
+			const suffix = node.method === "GET" ? "QueryRequest" : "MutationRequest";
+			return this.resolveName(`${node.operationId} ${suffix}`);
+		},
+		resolveDataTypedName(node) {
+			const suffix = node.method === "GET" ? "QueryRequest" : "MutationRequest";
+			return this.resolveTypedName(`${node.operationId} ${suffix}`);
+		},
+		resolveResponsesName(node) {
+			const suffix = node.method === "GET" ? "Query" : "Mutation";
+			return this.resolveName(`${node.operationId} ${suffix}`);
+		},
+		resolveResponsesTypedName(node) {
+			const suffix = node.method === "GET" ? "Query" : "Mutation";
+			return this.resolveTypedName(`${node.operationId} ${suffix}`);
+		},
+		resolveResponseName(node) {
+			const suffix = node.method === "GET" ? "QueryResponse" : "MutationResponse";
+			return this.resolveName(`${node.operationId} ${suffix}`);
+		},
+		resolveResponseTypedName(node) {
+			const suffix = node.method === "GET" ? "QueryResponse" : "MutationResponse";
+			return this.resolveTypedName(`${node.operationId} ${suffix}`);
+		},
+		resolvePathParamsName(node) {
+			return this.resolveName(`${node.operationId} PathParams`);
+		},
+		resolvePathParamsTypedName(node) {
+			return this.resolveTypedName(`${node.operationId} PathParams`);
+		},
+		resolveQueryParamsName(node) {
+			return this.resolveName(`${node.operationId} QueryParams`);
+		},
+		resolveQueryParamsTypedName(node) {
+			return this.resolveTypedName(`${node.operationId} QueryParams`);
+		},
+		resolveHeaderParamsName(node) {
+			return this.resolveName(`${node.operationId} HeaderParams`);
+		},
+		resolveHeaderParamsTypedName(node) {
+			return this.resolveTypedName(`${node.operationId} HeaderParams`);
+		}
+	};
+});
+//#endregion
+//#region src/plugin.ts
+const pluginTsName = "plugin-ts";
+const pluginTs = createPlugin((options) => {
+	const { output = {
+		path: "types",
+		barrelType: "named"
+	}, group, exclude = [], include, override = [], enumType = "asConst", enumKeyCasing = "none", optionalType = "questionToken", arrayType = "array", syntaxType = "type", transformers = {}, paramsCasing, generators = [typeGenerator].filter(Boolean), legacy = false } = options;
+	const baseResolver = legacy ? resolverTsLegacy : resolverTs;
+	const resolver = transformers?.name ? {
+		...baseResolver,
+		default(name, type) {
+			const resolved = baseResolver.default(name, type);
+			return transformers.name(resolved, type) || resolved;
+		}
+	} : baseResolver;
+	let resolveNameWarning = false;
+	return {
+		name: pluginTsName,
+		options: {
+			output,
+			transformers,
+			optionalType,
+			arrayType,
+			enumType,
+			enumKeyCasing,
+			syntaxType,
+			group,
+			override,
+			paramsCasing,
+			legacy,
+			resolver
+		},
+		resolvePath(baseName, pathMode, options) {
+			const root = path.resolve(this.config.root, this.config.output.path);
+			if ((pathMode ?? getMode(path.resolve(root, output.path))) === "single")
+ /**
+			* when output is a file then we will always append to the same file(output file), see fileManager.addOrAppend
+			* Other plugins then need to call addOrAppend instead of just add from the fileManager class
+			*/
+			return path.resolve(root, output.path);
+			if (group && (options?.group?.path || options?.group?.tag)) {
+				const groupName = group?.name ? group.name : (ctx) => {
+					if (group?.type === "path") return `${ctx.group.split("/")[1]}`;
+					return `${camelCase(ctx.group)}Controller`;
+				};
+				return path.resolve(root, output.path, groupName({ group: group.type === "path" ? options.group.path : options.group.tag }), baseName);
+			}
+			return path.resolve(root, output.path, baseName);
+		},
+		resolveName(name, type) {
+			if (!resolveNameWarning) {
+				this.driver.events.emit("warn", "Do not use resolveName for pluginTs, use resolverTs instead");
+				resolveNameWarning = true;
+			}
+			return resolver.default(name, type);
+		},
+		async install() {
+			const { config, fabric, plugin, adapter, rootNode, driver, openInStudio } = this;
+			const root = path.resolve(config.root, config.output.path);
+			const mode = getMode(path.resolve(root, output.path));
+			if (!adapter) throw new Error("Plugin cannot work without adapter being set");
+			await openInStudio({ ast: true });
+			await walk(rootNode, {
+				async schema(schemaNode) {
+					const writeTasks = generators.map(async (generator) => {
+						if (generator.type === "react" && generator.version === "2") {
+							const options = resolver.resolveOptions(schemaNode, {
+								options: plugin.options,
+								exclude,
+								include,
+								override
+							});
+							if (options === null) return;
+							await renderSchema(schemaNode, {
+								options,
+								adapter,
+								config,
+								fabric,
+								Component: generator.Schema,
+								plugin,
+								driver,
+								mode
+							});
+						}
+					});
+					await Promise.all(writeTasks);
+				},
+				async operation(operationNode) {
+					const writeTasks = generators.map(async (generator) => {
+						if (generator.type === "react" && generator.version === "2") {
+							const options = resolver.resolveOptions(operationNode, {
+								options: plugin.options,
+								exclude,
+								include,
+								override
+							});
+							if (options === null) return;
+							await renderOperation(operationNode, {
+								options,
+								adapter,
+								config,
+								fabric,
+								Component: generator.Operation,
+								plugin,
+								driver,
+								mode
+							});
+						}
+					});
+					await Promise.all(writeTasks);
+				}
+			}, { depth: "shallow" });
+			const barrelFiles = await getBarrelFiles(this.fabric.files, {
+				type: output.barrelType ?? "named",
+				root,
+				output,
+				meta: { pluginName: this.plugin.name }
+			});
+			await this.upsertFile(...barrelFiles);
+		}
+	};
+});
+//#endregion
+export { pluginTs, pluginTsName, resolverTs, resolverTsLegacy };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/resolverTs.ts","../src/plugin.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    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 in legacy mode (legacy: true). Use resolveParamName per individual parameter instead.')\n    },\n    resolvePathParamsTypedName(_node) {\n      throw new Error('resolvePathParamsTypedName is only available in legacy mode (legacy: true). Use resolveParamTypedName per individual parameter instead.')\n    },\n    resolveQueryParamsName(_node) {\n      throw new Error('resolveQueryParamsName is only available in legacy mode (legacy: true). Use resolveParamName per individual parameter instead.')\n    },\n    resolveQueryParamsTypedName(_node) {\n      throw new Error(\n        'resolveQueryParamsTypedName is only available in legacy mode (legacy: true). Use resolveParamTypedName per individual parameter instead.',\n      )\n    },\n    resolveHeaderParamsName(_node) {\n      throw new Error('resolveHeaderParamsName is only available in legacy mode (legacy: true). Use resolveParamName per individual parameter instead.')\n    },\n    resolveHeaderParamsTypedName(_node) {\n      throw new Error(\n        'resolveHeaderParamsTypedName is only available in legacy mode (legacy: true). Use resolveParamTypedName per individual parameter instead.',\n      )\n    },\n  }\n})\n\n/**\n * Legacy resolver for `@kubb/plugin-ts` that reproduces the naming conventions\n * used before the v2 resolver refactor. Enable via `legacy: true` in plugin options.\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    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.resolveName(`${node.operationId} ${suffix}`)\n    },\n    resolveResponsesTypedName(node) {\n      const suffix = node.method === 'GET' ? 'Query' : 'Mutation'\n      return this.resolveTypedName(`${node.operationId} ${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","import path from 'node:path'\nimport { camelCase } from '@internals/utils'\nimport { walk } from '@kubb/ast'\nimport { createPlugin, type Group, getBarrelFiles, getMode, renderOperation, renderSchema } from '@kubb/core'\nimport { typeGenerator } from './generators'\nimport { resolverTs, resolverTsLegacy } from './resolverTs.ts'\nimport type { PluginTs } from './types.ts'\n\nexport const pluginTsName = 'plugin-ts' satisfies PluginTs['name']\n\nexport const pluginTs = createPlugin<PluginTs>((options) => {\n  const {\n    output = { path: 'types', barrelType: 'named' },\n    group,\n    exclude = [],\n    include,\n    override = [],\n    enumType = 'asConst',\n    enumKeyCasing = 'none',\n    optionalType = 'questionToken',\n    arrayType = 'array',\n    syntaxType = 'type',\n    transformers = {},\n    paramsCasing,\n    generators = [typeGenerator].filter(Boolean),\n    legacy = false,\n  } = options\n\n  const baseResolver = legacy ? resolverTsLegacy : resolverTs\n\n  // When a `transformers.name` callback is provided, wrap the resolver so that\n  // every name produced by `default()` (and therefore by every helper that calls\n  // `this.default(...)`) flows through the user's transformer.\n  const resolver: typeof baseResolver = transformers?.name\n    ? {\n        ...baseResolver,\n        default(name, type) {\n          const resolved = baseResolver.default(name, type)\n\n          return transformers.name!(resolved, type) || resolved\n        },\n      }\n    : baseResolver\n\n  let resolveNameWarning = false\n\n  return {\n    name: pluginTsName,\n    options: {\n      output,\n      transformers,\n      optionalType,\n      arrayType,\n      enumType,\n      enumKeyCasing,\n      syntaxType,\n      group,\n      override,\n      paramsCasing,\n      legacy,\n      resolver,\n    },\n    resolvePath(baseName, pathMode, options) {\n      const root = path.resolve(this.config.root, this.config.output.path)\n      const mode = pathMode ?? getMode(path.resolve(root, output.path))\n\n      if (mode === 'single') {\n        /**\n         * when output is a file then we will always append to the same file(output file), see fileManager.addOrAppend\n         * Other plugins then need to call addOrAppend instead of just add from the fileManager class\n         */\n        return path.resolve(root, output.path)\n      }\n\n      if (group && (options?.group?.path || options?.group?.tag)) {\n        const groupName: Group['name'] = group?.name\n          ? group.name\n          : (ctx) => {\n              if (group?.type === 'path') {\n                return `${ctx.group.split('/')[1]}`\n              }\n              return `${camelCase(ctx.group)}Controller`\n            }\n\n        return path.resolve(\n          root,\n          output.path,\n          groupName({\n            group: group.type === 'path' ? options.group.path! : options.group.tag!,\n          }),\n          baseName,\n        )\n      }\n\n      return path.resolve(root, output.path, baseName)\n    },\n    resolveName(name, type) {\n      if (!resolveNameWarning) {\n        this.driver.events.emit('warn', 'Do not use resolveName for pluginTs, use resolverTs instead')\n        resolveNameWarning = true\n      }\n\n      return resolver.default(name, type)\n    },\n    async install() {\n      const { config, fabric, plugin, adapter, rootNode, driver, openInStudio } = this\n\n      const root = path.resolve(config.root, config.output.path)\n      const mode = getMode(path.resolve(root, output.path))\n\n      if (!adapter) {\n        throw new Error('Plugin cannot work without adapter being set')\n      }\n\n      await openInStudio({ ast: true })\n\n      await walk(\n        rootNode,\n        {\n          async schema(schemaNode) {\n            const writeTasks = generators.map(async (generator) => {\n              if (generator.type === 'react' && generator.version === '2') {\n                const options = resolver.resolveOptions(schemaNode, { options: plugin.options, exclude, include, override })\n\n                if (options === null) {\n                  return\n                }\n\n                await renderSchema(schemaNode, {\n                  options,\n                  adapter,\n                  config,\n                  fabric,\n                  Component: generator.Schema,\n                  plugin,\n                  driver,\n                  mode,\n                })\n              }\n            })\n\n            await Promise.all(writeTasks)\n          },\n          async operation(operationNode) {\n            const writeTasks = generators.map(async (generator) => {\n              if (generator.type === 'react' && generator.version === '2') {\n                const options = resolver.resolveOptions(operationNode, { options: plugin.options, exclude, include, override })\n\n                if (options === null) {\n                  return\n                }\n\n                await renderOperation(operationNode, {\n                  options,\n                  adapter,\n                  config,\n                  fabric,\n                  Component: generator.Operation,\n                  plugin,\n                  driver,\n                  mode,\n                })\n              }\n            })\n\n            await Promise.all(writeTasks)\n          },\n        },\n        { depth: 'shallow' },\n      )\n\n      const barrelFiles = await getBarrelFiles(this.fabric.files, {\n        type: output.barrelType ?? 'named',\n        root,\n        output,\n        meta: {\n          pluginName: this.plugin.name,\n        },\n      })\n\n      await this.upsertFile(...barrelFiles)\n    },\n  }\n})\n"],"mappings":"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"}

package/dist/{types-mSXmB8WU.d.ts → types-BA1ZCQ5p.d.ts}

@@ -1,9 +1,9 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
 import { Group, Output, PluginFactoryOptions, ResolveNameParams, Resolver } from "@kubb/core";
-import { Exclude, Include, Override, ResolvePathOptions } from "@kubb/plugin-oas";
-import { Generator as Generator$1 } from "@kubb/plugin-oas/generators";
-import { Oas, contentType } from "@kubb/oas";
 import { OperationNode, ParameterNode, SchemaNode, StatusCode } from "@kubb/ast/types";
+import { Oas, contentType } from "@kubb/oas";
+import { Exclude, Include, Override, ResolvePathOptions } from "@kubb/plugin-oas";
+import { Generator } from "@kubb/plugin-oas/generators";
 
 //#region src/types.d.ts
 /**
@@ -135,6 +135,60 @@ type ResolverTs = Resolver & {
    * resolver.resolveEnumKeyTypedName(node) // → 'PetStatusKey'
    */
   resolveEnumKeyTypedName(node: SchemaNode): string;
+  /**
+   * Resolves the variable/function name for an operation's grouped path parameters type.
+   * Only available in legacy mode (`legacy: true`).
+   *
+   * @deprecated Legacy only — will be removed in v6. 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`).
+   *
+   * @deprecated Legacy only — will be removed in v6. 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`).
+   *
+   * @deprecated Legacy only — will be removed in v6. 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`).
+   *
+   * @deprecated Legacy only — will be removed in v6. 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`).
+   *
+   * @deprecated Legacy only — will be removed in v6. 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`).
+   *
+   * @deprecated Legacy only — will be removed in v6. Use `resolveParamTypedName` per individual parameter instead.
+   * @example
+   * resolver.resolveHeaderParamsTypedName(node) // → 'DeletePetHeaderParams'
+   */
+  resolveHeaderParamsTypedName?(node: OperationNode): string;
 };
 type Options = {
   /**
@@ -192,52 +246,6 @@ type Options = {
    * @default 'type'
    */
   syntaxType?: 'type' | 'interface';
-  /**
-   * Set a suffix for the generated enums.
-   * @default 'enum'
-   * @deprecated Set `enumSuffix` on the adapter (`adapterOas({ enumSuffix })`) instead.
-   * In v5, the adapter owns this decision at parse time; the plugin option is ignored.
-   */
-  enumSuffix?: string;
-  /**
-   * Choose to use date or datetime as JavaScript Date instead of string.
-   * - 'string' represents dates as string values.
-   * - 'date' represents dates as JavaScript Date objects.
-   * @default 'string'
-   * @deprecated Set `dateType` on the adapter (`adapterOas({ dateType })`) instead.
-   * In v5, the adapter owns this decision at parse time; the plugin option is ignored.
-   */
-  dateType?: 'string' | 'date';
-  /**
-   * Choose to use `number` or `bigint` for integer fields with `int64` format.
-   * - 'number' uses the TypeScript `number` type (matches JSON.parse() runtime behavior).
-   * - 'bigint' uses the TypeScript `bigint` type (accurate for values exceeding Number.MAX_SAFE_INTEGER).
-   * @note in v5 of Kubb 'bigint' will become the default to better align with OpenAPI's int64 specification.
-   * @default 'number'
-   * @deprecated Set `integerType` on the adapter (`adapterOas({ integerType })`) instead.
-   * In v5, the adapter owns this decision at parse time; the plugin option is ignored.
-   */
-  integerType?: 'number' | 'bigint';
-  /**
-   * Which type to use when the Swagger/OpenAPI file is not providing more information.
-   * - 'any' allows any value.
-   * - 'unknown' requires type narrowing before use.
-   * - 'void' represents no value.
-   * @default 'any'
-   * @deprecated Set `unknownType` on the adapter (`adapterOas({ unknownType })`) instead.
-   * In v5, the adapter owns this decision at parse time; the plugin option is ignored.
-   */
-  unknownType?: 'any' | 'unknown' | 'void';
-  /**
-   * Which type to use for empty schema values.
-   * - 'any' allows any value.
-   * - 'unknown' requires type narrowing before use.
-   * - 'void' represents no value.
-   * @default `unknownType`
-   * @deprecated Set `emptySchemaType` on the adapter (`adapterOas({ emptySchemaType })`) instead.
-   * In v5, the adapter owns this decision at parse time; the plugin option is ignored.
-   */
-  emptySchemaType?: 'any' | 'unknown' | 'void';
   /**
    * Choose what to use as mode for an optional value.
    * - 'questionToken' marks the property as optional with ? (e.g., type?: string).
@@ -269,11 +277,22 @@ type Options = {
   /**
    * Define some generators next to the ts generators
    */
-  generators?: Array<Generator$1<PluginTs>>;
+  generators?: Array<Generator<PluginTs>>;
   /**
    * Unstable naming for v5
    */
   UNSTABLE_NAMING?: true;
+  /**
+   * Enable legacy naming conventions for backwards compatibility.
+   * When enabled, operation-level types use the old naming scheme:
+   * - GET responses → `<OperationId>QueryResponse`, `<OperationId>Query`
+   * - Non-GET responses → `<OperationId>MutationResponse`, `<OperationId>Mutation`
+   * - Request body → `<OperationId>QueryRequest` / `<OperationId>MutationRequest`
+   * - Response status codes → `<OperationId><StatusCode>` (e.g. `CreatePets201`)
+   * - Default/error response → `<OperationId>Error`
+   * @default false
+   */
+  legacy?: boolean;
 };
 type ResolvedOptions = {
   output: Output<Oas>;
@@ -281,18 +300,15 @@ type ResolvedOptions = {
   override: NonNullable<Options['override']>;
   enumType: NonNullable<Options['enumType']>;
   enumKeyCasing: NonNullable<Options['enumKeyCasing']>;
-  enumSuffix: NonNullable<Options['enumSuffix']>;
-  dateType: NonNullable<Options['dateType']>;
-  integerType: NonNullable<Options['integerType']>;
-  unknownType: NonNullable<Options['unknownType']>;
-  emptySchemaType: NonNullable<Options['emptySchemaType']>;
   optionalType: NonNullable<Options['optionalType']>;
   arrayType: NonNullable<Options['arrayType']>;
   transformers: NonNullable<Options['transformers']>;
   syntaxType: NonNullable<Options['syntaxType']>;
   paramsCasing: Options['paramsCasing'];
+  legacy: NonNullable<Options['legacy']>;
+  resolver: ResolverTs;
 };
 type PluginTs = PluginFactoryOptions<'plugin-ts', Options, ResolvedOptions, never, ResolvePathOptions, ResolverTs>;
 //#endregion
-export { PluginTs as n, Options as t };
-//# sourceMappingURL=types-mSXmB8WU.d.ts.map
+export { PluginTs as n, ResolverTs as r, Options as t };
+//# sourceMappingURL=types-BA1ZCQ5p.d.ts.map

package/package.json

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

package/src/components/{v2/Enum.tsx → Enum.tsx}

@@ -1,31 +1,40 @@
-import { camelCase, pascalCase, trimQuotes } from '@internals/utils'
+import { camelCase, trimQuotes } from '@internals/utils'
 import type { EnumSchemaNode } from '@kubb/ast/types'
 import { safePrint } from '@kubb/fabric-core/parsers/typescript'
 import { File } from '@kubb/react-fabric'
 import type { FabricReactNode } from '@kubb/react-fabric/types'
-import { ENUM_TYPES_WITH_KEY_SUFFIX, ENUM_TYPES_WITH_RUNTIME_VALUE, ENUM_TYPES_WITH_TYPE_ONLY } from '../../constants.ts'
-import * as factory from '../../factory.ts'
-import type { PluginTs } from '../../types.ts'
+import { ENUM_TYPES_WITH_KEY_SUFFIX, ENUM_TYPES_WITH_RUNTIME_VALUE, ENUM_TYPES_WITH_TYPE_ONLY } from '../constants.ts'
+import * as factory from '../factory.ts'
+import type { PluginTs, ResolverTs } from '../types.ts'
 
 type Props = {
   node: EnumSchemaNode
   enumType: PluginTs['resolvedOptions']['enumType']
   enumKeyCasing: PluginTs['resolvedOptions']['enumKeyCasing']
+  resolver: ResolverTs
 }
 
 /**
  * Resolves the runtime identifier name and the TypeScript type name for an enum schema node.
  *
  * The raw `node.name` may be a YAML key such as `"enumNames.Type"` which is not a
- * valid TypeScript identifier. `pascalCase` normalizes it unconditionally; for inline enum
- * properties the adapter already emits a PascalCase+suffix name so `pascalCase` is a no-op.
+ * valid TypeScript identifier. The resolver normalizes it; for inline enum
+ * properties the adapter already emits a PascalCase+suffix name so resolution is typically a no-op.
  */
-export function getEnumNames(node: EnumSchemaNode, enumType: PluginTs['resolvedOptions']['enumType']): { enumName: string; typeName: string } {
-  const resolved = pascalCase(node.name!)
+export function getEnumNames({ node, enumType, resolver }: { node: EnumSchemaNode; enumType: PluginTs['resolvedOptions']['enumType']; resolver: ResolverTs }): {
+  enumName: string
+  typeName: string
+  /**
+   * The PascalCase name that `$ref` importers will use to reference this enum type.
+   * For `asConst`/`asPascalConst` this differs from `typeName` (which has a `Key` suffix).
+   */
+  refName: string
+} {
+  const resolved = resolver.default(node.name!, 'type')
   const enumName = enumType === 'asPascalConst' ? resolved : camelCase(node.name!)
   const typeName = ENUM_TYPES_WITH_KEY_SUFFIX.has(enumType) ? `${resolved}Key` : resolved
 
-  return { enumName, typeName }
+  return { enumName, typeName, refName: resolved }
 }
 
 /**
@@ -39,8 +48,8 @@ export function getEnumNames(node: EnumSchemaNode, enumType: PluginTs['resolvedO
  * The emitted `File.Source` nodes carry the resolved names so that the barrel
  * index picks up the correct export identifiers.
  */
-export function Enum({ node, enumType, enumKeyCasing }: Props): FabricReactNode {
-  const { enumName, typeName } = getEnumNames(node, enumType)
+export function Enum({ node, enumType, enumKeyCasing, resolver }: Props): FabricReactNode {
+  const { enumName, typeName, refName } = getEnumNames({ node, enumType, resolver })
 
   const [nameNode, typeNode] = factory.createEnumDeclaration({
     name: enumName,
@@ -52,6 +61,8 @@ export function Enum({ node, enumType, enumKeyCasing }: Props): FabricReactNode
     enumKeyCasing,
   })
 
+  const needsRefAlias = ENUM_TYPES_WITH_KEY_SUFFIX.has(enumType) && refName !== typeName
+
   return (
     <>
       {nameNode && (
@@ -62,6 +73,11 @@ export function Enum({ node, enumType, enumKeyCasing }: Props): FabricReactNode
       <File.Source name={typeName} isIndexable isExportable={ENUM_TYPES_WITH_RUNTIME_VALUE.has(enumType)} isTypeOnly={ENUM_TYPES_WITH_TYPE_ONLY.has(enumType)}>
         {safePrint(typeNode)}
       </File.Source>
+      {needsRefAlias && (
+        <File.Source name={refName} isExportable isIndexable isTypeOnly>
+          {`export type ${refName} = ${typeName}`}
+        </File.Source>
+      )}
     </>
   )
 }