@kubb/plugin-ts 5.0.0-alpha.5 → 5.0.0-alpha.7

package/dist/{plugin-meWNDVe7.cjs → plugin-Cn85VLXR.cjs}

@@ -1,4 +1,4 @@
-const require_components = require("./components-CxTvawXI.cjs");
+const require_components = require("./components-DeNDKlzf.cjs");
 let node_path = require("node:path");
 node_path = require_components.__toESM(node_path);
 let _kubb_ast = require("@kubb/ast");
@@ -27,10 +27,10 @@ function stringify(value) {
 }
 //#endregion
 //#region src/generators/typeGenerator.tsx
-function printCombinedSchema({ name, schemas, pluginManager }) {
+function printCombinedSchema({ name, schemas, driver }) {
 	const properties = {};
 	if (schemas.response) properties["response"] = require_components.createUnionDeclaration({ nodes: schemas.responses.map((res) => {
-		const identifier = pluginManager.resolveName({
+		const identifier = driver.resolveName({
 			name: res.name,
 			pluginName: pluginTsName,
 			type: "function"
@@ -38,7 +38,7 @@ function printCombinedSchema({ name, schemas, pluginManager }) {
 		return require_components.createTypeReferenceNode(require_components.createIdentifier(identifier), void 0);
 	}) });
 	if (schemas.request) {
-		const identifier = pluginManager.resolveName({
+		const identifier = driver.resolveName({
 			name: schemas.request.name,
 			pluginName: pluginTsName,
 			type: "function"
@@ -46,7 +46,7 @@ function printCombinedSchema({ name, schemas, pluginManager }) {
 		properties["request"] = require_components.createTypeReferenceNode(require_components.createIdentifier(identifier), void 0);
 	}
 	if (schemas.pathParams) {
-		const identifier = pluginManager.resolveName({
+		const identifier = driver.resolveName({
 			name: schemas.pathParams.name,
 			pluginName: pluginTsName,
 			type: "function"
@@ -54,7 +54,7 @@ function printCombinedSchema({ name, schemas, pluginManager }) {
 		properties["pathParams"] = require_components.createTypeReferenceNode(require_components.createIdentifier(identifier), void 0);
 	}
 	if (schemas.queryParams) {
-		const identifier = pluginManager.resolveName({
+		const identifier = driver.resolveName({
 			name: schemas.queryParams.name,
 			pluginName: pluginTsName,
 			type: "function"
@@ -62,7 +62,7 @@ function printCombinedSchema({ name, schemas, pluginManager }) {
 		properties["queryParams"] = require_components.createTypeReferenceNode(require_components.createIdentifier(identifier), void 0);
 	}
 	if (schemas.headerParams) {
-		const identifier = pluginManager.resolveName({
+		const identifier = driver.resolveName({
 			name: schemas.headerParams.name,
 			pluginName: pluginTsName,
 			type: "function"
@@ -70,7 +70,7 @@ function printCombinedSchema({ name, schemas, pluginManager }) {
 		properties["headerParams"] = require_components.createTypeReferenceNode(require_components.createIdentifier(identifier), void 0);
 	}
 	if (schemas.errors) properties["errors"] = require_components.createUnionDeclaration({ nodes: schemas.errors.map((error) => {
-		const identifier = pluginManager.resolveName({
+		const identifier = driver.resolveName({
 			name: error.name,
 			pluginName: pluginTsName,
 			type: "function"
@@ -90,8 +90,8 @@ function printCombinedSchema({ name, schemas, pluginManager }) {
 		modifiers: [require_components.modifiers.export]
 	}));
 }
-function printRequestSchema({ baseName, operation, schemas, pluginManager }) {
-	const name = pluginManager.resolveName({
+function printRequestSchema({ baseName, operation, schemas, driver }) {
+	const name = driver.resolveName({
 		name: `${baseName} Request`,
 		pluginName: pluginTsName,
 		type: "type"
@@ -99,7 +99,7 @@ function printRequestSchema({ baseName, operation, schemas, pluginManager }) {
 	const results = [];
 	const dataRequestProperties = [];
 	if (schemas.request) {
-		const identifier = pluginManager.resolveName({
+		const identifier = driver.resolveName({
 			name: schemas.request.name,
 			pluginName: pluginTsName,
 			type: "type"
@@ -115,7 +115,7 @@ function printRequestSchema({ baseName, operation, schemas, pluginManager }) {
 		type: require_components.keywordTypeNodes.never
 	}));
 	if (schemas.pathParams) {
-		const identifier = pluginManager.resolveName({
+		const identifier = driver.resolveName({
 			name: schemas.pathParams.name,
 			pluginName: pluginTsName,
 			type: "type"
@@ -130,7 +130,7 @@ function printRequestSchema({ baseName, operation, schemas, pluginManager }) {
 		type: require_components.keywordTypeNodes.never
 	}));
 	if (schemas.queryParams) {
-		const identifier = pluginManager.resolveName({
+		const identifier = driver.resolveName({
 			name: schemas.queryParams.name,
 			pluginName: pluginTsName,
 			type: "type"
@@ -146,7 +146,7 @@ function printRequestSchema({ baseName, operation, schemas, pluginManager }) {
 		type: require_components.keywordTypeNodes.never
 	}));
 	if (schemas.headerParams) {
-		const identifier = pluginManager.resolveName({
+		const identifier = driver.resolveName({
 			name: schemas.headerParams.name,
 			pluginName: pluginTsName,
 			type: "type"
@@ -173,16 +173,16 @@ function printRequestSchema({ baseName, operation, schemas, pluginManager }) {
 	results.push((0, _kubb_fabric_core_parsers_typescript.safePrint)(dataRequestNode));
 	return results.join("\n\n");
 }
-function printResponseSchema({ baseName, schemas, pluginManager, unknownType }) {
+function printResponseSchema({ baseName, schemas, driver, unknownType }) {
 	const results = [];
-	const name = pluginManager.resolveName({
+	const name = driver.resolveName({
 		name: `${baseName} ResponseData`,
 		pluginName: pluginTsName,
 		type: "type"
 	});
 	if (schemas.responses && schemas.responses.length > 0) {
 		const responsesProperties = schemas.responses.map((res) => {
-			const identifier = pluginManager.resolveName({
+			const identifier = driver.resolveName({
 				name: res.name,
 				pluginName: pluginTsName,
 				type: "type"
@@ -217,9 +217,9 @@ function printResponseSchema({ baseName, schemas, pluginManager, unknownType })
 const typeGenerator$1 = (0, _kubb_plugin_oas_generators.createReactGenerator)({
 	name: "typescript",
 	Operation({ operation, generator, plugin }) {
-		const { options, options: { mapper, enumType, enumKeyCasing, syntaxType, optionalType, arrayType, unknownType, paramsCasing } } = plugin;
+		const { options, options: { enumType, enumKeyCasing, syntaxType, optionalType, arrayType, unknownType, paramsCasing } } = plugin;
 		const mode = (0, _kubb_core_hooks.useMode)();
-		const pluginManager = (0, _kubb_core_hooks.usePluginManager)();
+		const driver = (0, _kubb_core_hooks.usePluginDriver)();
 		const oas = (0, _kubb_plugin_oas_hooks.useOas)();
 		const { getSchemas, getFile, getName, getGroup } = (0, _kubb_plugin_oas_hooks.useOperationManager)(generator);
 		const schemaManager = (0, _kubb_plugin_oas_hooks.useSchemaManager)();
@@ -234,7 +234,7 @@ const typeGenerator$1 = (0, _kubb_plugin_oas_generators.createReactGenerator)({
 			oas,
 			events: generator.context.events,
 			plugin,
-			pluginManager,
+			driver,
 			mode,
 			override: options.override
 		});
@@ -276,7 +276,6 @@ const typeGenerator$1 = (0, _kubb_plugin_oas_generators.createReactGenerator)({
 				description,
 				tree,
 				schema: transformedSchema,
-				mapper,
 				enumType,
 				enumKeyCasing,
 				optionalType,
@@ -294,7 +293,7 @@ const typeGenerator$1 = (0, _kubb_plugin_oas_generators.createReactGenerator)({
 			banner: (0, _kubb_plugin_oas_utils.getBanner)({
 				oas,
 				output: plugin.options.output,
-				config: pluginManager.config
+				config: driver.config
 			}),
 			footer: (0, _kubb_plugin_oas_utils.getFooter)({
 				oas,
@@ -309,7 +308,7 @@ const typeGenerator$1 = (0, _kubb_plugin_oas_generators.createReactGenerator)({
 					baseName: name,
 					operation,
 					schemas,
-					pluginManager
+					driver
 				})
 			}), /* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(_kubb_react_fabric.File.Source, {
 				name: responseName,
@@ -319,7 +318,7 @@ const typeGenerator$1 = (0, _kubb_plugin_oas_generators.createReactGenerator)({
 				children: printResponseSchema({
 					baseName: name,
 					schemas,
-					pluginManager,
+					driver,
 					unknownType
 				})
 			})] }) : /* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(_kubb_react_fabric.File.Source, {
@@ -330,16 +329,16 @@ const typeGenerator$1 = (0, _kubb_plugin_oas_generators.createReactGenerator)({
 				children: printCombinedSchema({
 					name: combinedSchemaName,
 					schemas,
-					pluginManager
+					driver
 				})
 			})]
 		});
 	},
 	Schema({ schema, plugin }) {
-		const { options: { mapper, enumType, enumKeyCasing, syntaxType, optionalType, arrayType, output } } = plugin;
+		const { options: { enumType, enumKeyCasing, syntaxType, optionalType, arrayType, output } } = plugin;
 		const mode = (0, _kubb_core_hooks.useMode)();
 		const oas = (0, _kubb_plugin_oas_hooks.useOas)();
-		const pluginManager = (0, _kubb_core_hooks.usePluginManager)();
+		const driver = (0, _kubb_core_hooks.usePluginDriver)();
 		const { getName, getFile } = (0, _kubb_plugin_oas_hooks.useSchemaManager)();
 		const imports = (0, _kubb_plugin_oas_utils.getImports)(schema.tree);
 		const schemaFromTree = schema.tree.find((item) => item.keyword === _kubb_plugin_oas.schemaKeywords.schema);
@@ -357,7 +356,7 @@ const typeGenerator$1 = (0, _kubb_plugin_oas_generators.createReactGenerator)({
 			banner: (0, _kubb_plugin_oas_utils.getBanner)({
 				oas,
 				output,
-				config: pluginManager.config
+				config: driver.config
 			}),
 			footer: (0, _kubb_plugin_oas_utils.getFooter)({
 				oas,
@@ -378,7 +377,6 @@ const typeGenerator$1 = (0, _kubb_plugin_oas_generators.createReactGenerator)({
 				description: schema.value.description,
 				tree: schema.tree,
 				schema: schema.value,
-				mapper,
 				enumType,
 				enumKeyCasing,
 				optionalType,
@@ -389,7 +387,45 @@ const typeGenerator$1 = (0, _kubb_plugin_oas_generators.createReactGenerator)({
 	}
 });
 //#endregion
+//#region src/constants.ts
+/**
+* `optionalType` values that cause a property's type to include `| undefined`.
+*/
+const OPTIONAL_ADDS_UNDEFINED = new Set(["undefined", "questionTokenAndUndefined"]);
+/**
+* `optionalType` values that render the property key with a `?` token.
+*/
+const OPTIONAL_ADDS_QUESTION_TOKEN = new Set(["questionToken", "questionTokenAndUndefined"]);
+/**
+* `enumType` values that append a `Key` suffix to the generated enum type alias.
+*/
+const ENUM_TYPES_WITH_KEY_SUFFIX = new Set(["asConst", "asPascalConst"]);
+/**
+* `enumType` values that require a runtime value declaration (object, enum, or literal).
+*/
+const ENUM_TYPES_WITH_RUNTIME_VALUE = new Set([
+	"enum",
+	"asConst",
+	"asPascalConst",
+	"constEnum",
+	"literal",
+	void 0
+]);
+/**
+* `enumType` values whose type declaration is type-only (no runtime value emitted for the type alias).
+*/
+const ENUM_TYPES_WITH_TYPE_ONLY = new Set([
+	"asConst",
+	"asPascalConst",
+	"literal",
+	void 0
+]);
+//#endregion
 //#region src/printer.ts
+/**
+* Converts a primitive const value to a TypeScript literal type node.
+* Handles negative numbers via a prefix unary expression.
+*/
 function constToTypeNode(value, format) {
 	if (format === "boolean") return require_components.createLiteralTypeNode(value === true ? require_components.createTrue() : require_components.createFalse());
 	if (format === "number" && typeof value === "number") {
@@ -398,12 +434,22 @@ function constToTypeNode(value, format) {
 	}
 	return require_components.createLiteralTypeNode(require_components.createStringLiteral(String(value)));
 }
+/**
+* Returns a `Date` reference type node when `representation` is `'date'`, otherwise falls back to `string`.
+*/
 function dateOrStringNode(node) {
 	return node.representation === "date" ? require_components.createTypeReferenceNode(require_components.createIdentifier("Date")) : require_components.keywordTypeNodes.string;
 }
+/**
+* Maps an array of `SchemaNode`s through the printer, filtering out `null` and `undefined` results.
+*/
 function buildMemberNodes(members, print) {
 	return (members ?? []).map(print).filter(Boolean);
 }
+/**
+* Builds a TypeScript tuple type node from an array schema's `items`,
+* applying min/max slice and optional/rest element rules.
+*/
 function buildTupleNode(node, print) {
 	let items = (node.items ?? []).map(print).filter(Boolean);
 	const restNode = node.rest ? print(node.rest) ?? void 0 : void 0;
@@ -416,13 +462,19 @@ function buildTupleNode(node, print) {
 	if (max === void 0 && restNode) items.push(require_components.createRestTypeNode(require_components.createArrayTypeNode(restNode)));
 	return require_components.createTupleTypeNode(items);
 }
+/**
+* Applies `nullable` and optional/nullish `| undefined` union modifiers to a property's resolved base type.
+*/
 function buildPropertyType(schema, baseType, optionalType) {
-	const addsUndefined = ["undefined", "questionTokenAndUndefined"].includes(optionalType);
+	const addsUndefined = OPTIONAL_ADDS_UNDEFINED.has(optionalType);
 	let type = baseType;
 	if (schema.nullable) type = require_components.createUnionDeclaration({ nodes: [type, require_components.keywordTypeNodes.null] });
 	if ((schema.nullish || schema.optional) && addsUndefined) type = require_components.createUnionDeclaration({ nodes: [type, require_components.keywordTypeNodes.undefined] });
 	return type;
 }
+/**
+* Collects JSDoc annotation strings (description, deprecated, min/max, pattern, default, example, type) for a schema node.
+*/
 function buildPropertyJSDocComments(schema) {
 	return [
 		"description" in schema && schema.description ? `@description ${require_components.jsStringEscape(schema.description)}` : void 0,
@@ -435,6 +487,9 @@ function buildPropertyJSDocComments(schema) {
 		"primitive" in schema && schema.primitive ? [`@type ${schema.primitive || "unknown"}`, "optional" in schema && schema.optional ? " | undefined" : void 0].filter(Boolean).join("") : void 0
 	];
 }
+/**
+* Creates TypeScript index signatures for `additionalProperties` and `patternProperties` on an object schema node.
+*/
 function buildIndexSignatures(node, propertyCount, print) {
 	const elements = [];
 	if (node.additionalProperties && node.additionalProperties !== true) {
@@ -452,214 +507,247 @@ function buildIndexSignatures(node, propertyCount, print) {
 	return elements;
 }
 /**
-* Converts a `SchemaNode` AST node into a TypeScript `ts.TypeNode`.
+* TypeScript type printer built with `definePrinter`.
+*
+* Converts a `SchemaNode` AST node into a TypeScript AST node:
+* - **`printer.print(node)`** — when `options.typeName` is set, returns a full
+*   `type Name = …` or `interface Name { … }` declaration (`ts.Node`).
+*   Without `typeName`, returns the raw `ts.TypeNode` for the schema.
 *
-* Built on `definePrinter` — dispatches on `node.type`, with options closed over
-* per printer instance. Produces the same `ts.TypeNode` output as the keyword-based
-* `parse` in `parser.ts`.
+* Dispatches on `node.type` to the appropriate handler in `nodes`. Options are closed
+* over per printer instance, so each call to `printerTs(options)` produces an independent printer.
+*
+* @example Raw type node (no `typeName`)
+* ```ts
+* const printer = printerTs({ optionalType: 'questionToken', arrayType: 'array', enumType: 'inlineLiteral' })
+* const typeNode = printer.print(schemaNode) // ts.TypeNode
+* ```
+*
+* @example Full declaration (with `typeName`)
+* ```ts
+* const printer = printerTs({ optionalType: 'questionToken', arrayType: 'array', enumType: 'inlineLiteral', typeName: 'MyType' })
+* const declaration = printer.print(schemaNode) // ts.TypeAliasDeclaration | ts.InterfaceDeclaration
+* ```
 */
-const printerTs = (0, _kubb_core.definePrinter)((options) => ({
-	name: "typescript",
-	options,
-	nodes: {
-		any: () => require_components.keywordTypeNodes.any,
-		unknown: () => require_components.keywordTypeNodes.unknown,
-		void: () => require_components.keywordTypeNodes.void,
-		never: () => require_components.keywordTypeNodes.never,
-		boolean: () => require_components.keywordTypeNodes.boolean,
-		null: () => require_components.keywordTypeNodes.null,
-		blob: () => require_components.createTypeReferenceNode("Blob", []),
-		string: () => require_components.keywordTypeNodes.string,
-		uuid: () => require_components.keywordTypeNodes.string,
-		email: () => require_components.keywordTypeNodes.string,
-		url: (node) => {
-			if (node.path) return require_components.createUrlTemplateType(node.path);
-			return require_components.keywordTypeNodes.string;
-		},
-		datetime: () => require_components.keywordTypeNodes.string,
-		number: () => require_components.keywordTypeNodes.number,
-		integer: () => require_components.keywordTypeNodes.number,
-		bigint: () => require_components.keywordTypeNodes.bigint,
-		date: (node) => dateOrStringNode(node),
-		time: (node) => dateOrStringNode(node),
-		ref(node) {
-			if (!node.name) return;
-			return require_components.createTypeReferenceNode(node.name, void 0);
-		},
-		enum(node) {
-			const values = node.namedEnumValues?.map((v) => v.value) ?? node.enumValues ?? [];
-			if (this.options.enumType === "inlineLiteral" || !node.name) {
-				const literalNodes = values.filter((v) => v !== null).map((value) => constToTypeNode(value, typeof value === "number" ? "number" : typeof value === "boolean" ? "boolean" : "string")).filter(Boolean);
+const printerTs = (0, _kubb_core.definePrinter)((options) => {
+	const addsUndefined = OPTIONAL_ADDS_UNDEFINED.has(options.optionalType);
+	return {
+		name: "typescript",
+		options,
+		nodes: {
+			any: () => require_components.keywordTypeNodes.any,
+			unknown: () => require_components.keywordTypeNodes.unknown,
+			void: () => require_components.keywordTypeNodes.void,
+			never: () => require_components.keywordTypeNodes.never,
+			boolean: () => require_components.keywordTypeNodes.boolean,
+			null: () => require_components.keywordTypeNodes.null,
+			blob: () => require_components.createTypeReferenceNode("Blob", []),
+			string: () => require_components.keywordTypeNodes.string,
+			uuid: () => require_components.keywordTypeNodes.string,
+			email: () => require_components.keywordTypeNodes.string,
+			url: (node) => {
+				if (node.path) return require_components.createUrlTemplateType(node.path);
+				return require_components.keywordTypeNodes.string;
+			},
+			datetime: () => require_components.keywordTypeNodes.string,
+			number: () => require_components.keywordTypeNodes.number,
+			integer: () => require_components.keywordTypeNodes.number,
+			bigint: () => require_components.keywordTypeNodes.bigint,
+			date: dateOrStringNode,
+			time: dateOrStringNode,
+			ref(node) {
+				if (!node.name) return;
+				return require_components.createTypeReferenceNode(node.name, void 0);
+			},
+			enum(node) {
+				const values = node.namedEnumValues?.map((v) => v.value) ?? node.enumValues ?? [];
+				if (this.options.enumType === "inlineLiteral" || !node.name) {
+					const literalNodes = values.filter((v) => v !== null).map((value) => constToTypeNode(value, typeof value)).filter(Boolean);
+					return require_components.createUnionDeclaration({
+						withParentheses: true,
+						nodes: literalNodes
+					}) ?? void 0;
+				}
+				const resolvedName = require_components.pascalCase(node.name);
+				const typeName = ENUM_TYPES_WITH_KEY_SUFFIX.has(this.options.enumType) ? `${resolvedName}Key` : resolvedName;
+				return require_components.createTypeReferenceNode(typeName, void 0);
+			},
+			union(node) {
+				const members = node.members ?? [];
+				const hasStringLiteral = members.some((m) => m.type === "enum" && m.enumType === "string");
+				const hasPlainString = members.some((m) => (0, _kubb_ast.isPlainStringType)(m));
+				if (hasStringLiteral && hasPlainString) {
+					const memberNodes = members.map((m) => {
+						if ((0, _kubb_ast.isPlainStringType)(m)) return require_components.createIntersectionDeclaration({
+							nodes: [require_components.keywordTypeNodes.string, require_components.createTypeLiteralNode([])],
+							withParentheses: true
+						});
+						return this.print(m);
+					}).filter(Boolean);
+					return require_components.createUnionDeclaration({
+						withParentheses: true,
+						nodes: memberNodes
+					}) ?? void 0;
+				}
 				return require_components.createUnionDeclaration({
 					withParentheses: true,
-					nodes: literalNodes
+					nodes: buildMemberNodes(members, this.print)
 				}) ?? void 0;
-			}
-			const typeName = ["asConst", "asPascalConst"].includes(this.options.enumType) ? `${node.name}Key` : node.name;
-			return require_components.createTypeReferenceNode(typeName, void 0);
-		},
-		union(node) {
-			const members = node.members ?? [];
-			const hasStringLiteral = members.some((m) => m.type === "enum" && m.enumType === "string");
-			const hasPlainString = members.some((m) => (0, _kubb_ast.isPlainStringType)(m));
-			if (hasStringLiteral && hasPlainString) {
-				const nodes = members.map((m) => {
-					if ((0, _kubb_ast.isPlainStringType)(m)) return require_components.createIntersectionDeclaration({
-						nodes: [require_components.keywordTypeNodes.string, require_components.createTypeLiteralNode([])],
-						withParentheses: true
-					});
-					return this.print(m);
-				}).filter(Boolean);
-				return require_components.createUnionDeclaration({
+			},
+			intersection(node) {
+				return require_components.createIntersectionDeclaration({
 					withParentheses: true,
-					nodes
+					nodes: buildMemberNodes(node.members, this.print)
+				}) ?? void 0;
+			},
+			array(node) {
+				const itemNodes = (node.items ?? []).map((item) => this.print(item)).filter(Boolean);
+				return require_components.createArrayDeclaration({
+					nodes: itemNodes,
+					arrayType: this.options.arrayType
 				}) ?? void 0;
+			},
+			tuple(node) {
+				return buildTupleNode(node, this.print);
+			},
+			object(node) {
+				const { print, options } = this;
+				const addsQuestionToken = OPTIONAL_ADDS_QUESTION_TOKEN.has(options.optionalType);
+				const propertyNodes = node.properties.map((prop) => {
+					const baseType = print(prop.schema) ?? require_components.keywordTypeNodes.unknown;
+					const type = buildPropertyType(prop.schema, baseType, options.optionalType);
+					const propertyNode = require_components.createPropertySignature({
+						questionToken: prop.schema.optional || prop.schema.nullish ? addsQuestionToken : false,
+						name: prop.name,
+						type,
+						readOnly: prop.schema.readOnly
+					});
+					return require_components.appendJSDocToNode({
+						node: propertyNode,
+						comments: buildPropertyJSDocComments(prop.schema)
+					});
+				});
+				const allElements = [...propertyNodes, ...buildIndexSignatures(node, propertyNodes.length, print)];
+				if (!allElements.length) return require_components.keywordTypeNodes.object;
+				return require_components.createTypeLiteralNode(allElements);
 			}
-			return require_components.createUnionDeclaration({
-				withParentheses: true,
-				nodes: buildMemberNodes(members, this.print)
-			}) ?? void 0;
-		},
-		intersection(node) {
-			return require_components.createIntersectionDeclaration({
-				withParentheses: true,
-				nodes: buildMemberNodes(node.members, this.print)
-			}) ?? void 0;
-		},
-		array(node) {
-			const itemNodes = (node.items ?? []).map((item) => this.print(item)).filter(Boolean);
-			return require_components.createArrayDeclaration({
-				nodes: itemNodes,
-				arrayType: this.options.arrayType
-			}) ?? void 0;
 		},
-		tuple(node) {
-			return buildTupleNode(node, this.print);
-		},
-		object(node) {
-			const addsQuestionToken = ["questionToken", "questionTokenAndUndefined"].includes(this.options.optionalType);
-			const { print } = this;
-			const propertyNodes = node.properties.map((prop) => {
-				if (this.options.mapper && Object.hasOwn(this.options.mapper, prop.name)) return this.options.mapper[prop.name];
-				const baseType = print(prop.schema) ?? require_components.keywordTypeNodes.unknown;
-				const type = buildPropertyType(prop.schema, baseType, this.options.optionalType);
-				const propertyNode = require_components.createPropertySignature({
-					questionToken: prop.schema.optional || prop.schema.nullish ? addsQuestionToken : false,
-					name: prop.name,
+		print(node) {
+			let type = this.print(node);
+			if (!type) return;
+			if (node.nullable) type = require_components.createUnionDeclaration({ nodes: [type, require_components.keywordTypeNodes.null] });
+			if ((node.nullish || node.optional) && addsUndefined) type = require_components.createUnionDeclaration({ nodes: [type, require_components.keywordTypeNodes.undefined] });
+			const { typeName, syntaxType = "type", description, keysToOmit } = this.options;
+			if (!typeName) return type;
+			const useTypeGeneration = syntaxType === "type" || type.kind === require_components.syntaxKind.union || !!keysToOmit?.length;
+			return require_components.createTypeDeclaration({
+				name: typeName,
+				isExportable: true,
+				type: keysToOmit?.length ? require_components.createOmitDeclaration({
+					keys: keysToOmit,
 					type,
-					readOnly: prop.schema.readOnly
-				});
-				return require_components.appendJSDocToNode({
-					node: propertyNode,
-					comments: buildPropertyJSDocComments(prop.schema)
-				});
+					nonNullable: true
+				}) : type,
+				syntax: useTypeGeneration ? "type" : "interface",
+				comments: [
+					node?.title ? require_components.jsStringEscape(node.title) : void 0,
+					description ? `@description ${require_components.jsStringEscape(description)}` : void 0,
+					node?.deprecated ? "@deprecated" : void 0,
+					node && "min" in node && node.min !== void 0 ? `@minLength ${node.min}` : void 0,
+					node && "max" in node && node.max !== void 0 ? `@maxLength ${node.max}` : void 0,
+					node && "pattern" in node && node.pattern ? `@pattern ${node.pattern}` : void 0,
+					node?.default ? `@default ${node.default}` : void 0,
+					node?.example ? `@example ${node.example}` : void 0
+				]
 			});
-			const allElements = [...propertyNodes, ...buildIndexSignatures(node, propertyNodes.length, print)];
-			if (!allElements.length) return require_components.keywordTypeNodes.object;
-			return require_components.createTypeLiteralNode(allElements);
 		}
-	}
-}));
+	};
+});
+//#endregion
+//#region src/components/v2/Enum.tsx
+/**
+* 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.
+*/
+function getEnumNames(node, enumType) {
+	const resolved = require_components.pascalCase(node.name);
+	return {
+		enumName: enumType === "asPascalConst" ? resolved : require_components.camelCase(node.name),
+		typeName: ENUM_TYPES_WITH_KEY_SUFFIX.has(enumType) ? `${resolved}Key` : resolved
+	};
+}
+/**
+* Renders the enum declaration(s) for a single named `EnumSchemaNode`.
+*
+* Depending on `enumType` this may emit:
+* - A runtime object (`asConst` / `asPascalConst`) plus a `typeof` type alias
+* - A `const enum` or plain `enum` declaration (`constEnum` / `enum`)
+* - A union literal type alias (`literal`)
+*
+* The emitted `File.Source` nodes carry the resolved names so that the barrel
+* index picks up the correct export identifiers.
+*/
+function Enum({ node, enumType, enumKeyCasing }) {
+	const { enumName, typeName } = getEnumNames(node, enumType);
+	const [nameNode, typeNode] = require_components.createEnumDeclaration({
+		name: enumName,
+		typeName,
+		enums: node.namedEnumValues?.map((v) => [require_components.trimQuotes(v.name.toString()), v.value]) ?? node.enumValues?.filter((v) => v !== null && v !== void 0).map((v) => [require_components.trimQuotes(v.toString()), v]) ?? [],
+		type: enumType,
+		enumKeyCasing
+	});
+	return /* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsxs)(_kubb_react_fabric_jsx_runtime.Fragment, { children: [nameNode && /* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(_kubb_react_fabric.File.Source, {
+		name: enumName,
+		isExportable: true,
+		isIndexable: true,
+		isTypeOnly: false,
+		children: (0, _kubb_fabric_core_parsers_typescript.safePrint)(nameNode)
+	}), /* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(_kubb_react_fabric.File.Source, {
+		name: typeName,
+		isIndexable: true,
+		isExportable: ENUM_TYPES_WITH_RUNTIME_VALUE.has(enumType),
+		isTypeOnly: ENUM_TYPES_WITH_TYPE_ONLY.has(enumType),
+		children: (0, _kubb_fabric_core_parsers_typescript.safePrint)(typeNode)
+	})] });
+}
 //#endregion
 //#region src/components/v2/Type.tsx
-function Type({ name, typedName, node, keysToOmit, optionalType, arrayType, syntaxType, enumType, enumKeyCasing, mapper, ...rest }) {
-	const typeNodes = [];
-	const description = rest.description || node?.description;
+function Type({ name, typedName, node, keysToOmit, optionalType, arrayType, syntaxType, enumType, enumKeyCasing, description }) {
+	const resolvedDescription = description || node?.description;
 	const enumSchemaNodes = (0, _kubb_ast.collect)(node, { schema(n) {
 		if (n.type === "enum" && n.name) return n;
 	} });
-	let type = printerTs({
+	const typeNode = printerTs({
 		optionalType,
 		arrayType,
 		enumType,
-		mapper
+		typeName: name,
+		syntaxType,
+		description: resolvedDescription,
+		keysToOmit
 	}).print(node);
-	if (!type) return;
-	if (["asConst", "asPascalConst"].includes(enumType) && enumSchemaNodes.length > 0) {
-		const isDirectEnum = node.type === "array" && node.items !== void 0;
-		const isEnumOnly = "enum" in node && node.enum;
-		if (isDirectEnum || isEnumOnly) {
-			const typeNameWithKey = `${enumSchemaNodes[0].name}Key`;
-			type = require_components.createTypeReferenceNode(typeNameWithKey);
-			if (isDirectEnum) if (arrayType === "generic") type = require_components.createTypeReferenceNode(require_components.createIdentifier("Array"), [type]);
-			else type = require_components.createArrayTypeNode(type);
-		}
-	}
-	if (node) {
-		if (node.nullable) type = require_components.createUnionDeclaration({ nodes: [type, require_components.keywordTypeNodes.null] });
-		if (node.nullish && ["undefined", "questionTokenAndUndefined"].includes(optionalType)) type = require_components.createUnionDeclaration({ nodes: [type, require_components.keywordTypeNodes.undefined] });
-		if (node.optional && ["undefined", "questionTokenAndUndefined"].includes(optionalType)) type = require_components.createUnionDeclaration({ nodes: [type, require_components.keywordTypeNodes.undefined] });
-	}
-	const useTypeGeneration = syntaxType === "type" || [require_components.syntaxKind.union].includes(type.kind) || !!keysToOmit?.length;
-	typeNodes.push(require_components.createTypeDeclaration({
-		name,
-		isExportable: true,
-		type: keysToOmit?.length ? require_components.createOmitDeclaration({
-			keys: keysToOmit,
-			type,
-			nonNullable: true
-		}) : type,
-		syntax: useTypeGeneration ? "type" : "interface",
-		comments: [
-			node?.title ? `${require_components.jsStringEscape(node.title)}` : void 0,
-			description ? `@description ${require_components.jsStringEscape(description)}` : void 0,
-			node?.deprecated ? "@deprecated" : void 0,
-			node && "min" in node && node.min !== void 0 ? `@minLength ${node.min}` : void 0,
-			node && "max" in node && node.max !== void 0 ? `@maxLength ${node.max}` : void 0,
-			node && "pattern" in node && node.pattern ? `@pattern ${node.pattern}` : void 0,
-			node?.default ? `@default ${node.default}` : void 0,
-			node?.example ? `@example ${node.example}` : void 0
-		]
-	}));
-	const enums = [...new Map(enumSchemaNodes.map((n) => [n.name, n])).values()].map((enumSchemaNode) => {
-		const enumName = enumType === "asPascalConst" ? require_components.pascalCase(enumSchemaNode.name) : require_components.camelCase(enumSchemaNode.name);
-		const typeName = ["asConst", "asPascalConst"].includes(enumType) ? `${enumSchemaNode.name}Key` : enumSchemaNode.name;
-		const [nameNode, typeNode] = require_components.createEnumDeclaration({
-			name: enumName,
-			typeName,
-			enums: enumSchemaNode.namedEnumValues?.map((v) => [require_components.trimQuotes(v.name.toString()), v.value]) ?? enumSchemaNode.enumValues?.filter((v) => v !== null && v !== void 0).map((v) => [require_components.trimQuotes(v.toString()), v]) ?? [],
-			type: enumType,
-			enumKeyCasing
-		});
+	if (!typeNode) return;
+	const enums = [...new Map(enumSchemaNodes.map((n) => [n.name, n])).values()].map((node) => {
 		return {
-			nameNode,
-			typeNode,
-			name: enumName,
-			typeName
+			node,
+			...getEnumNames(node, enumType)
 		};
 	});
 	const shouldExportEnums = enumType !== "inlineLiteral";
 	const shouldExportType = enumType === "inlineLiteral" || enums.every((item) => item.typeName !== name);
-	return /* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsxs)(_kubb_react_fabric_jsx_runtime.Fragment, { children: [shouldExportEnums && enums.map(({ name: enumName, nameNode, typeName, typeNode }) => /* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsxs)(_kubb_react_fabric_jsx_runtime.Fragment, { children: [nameNode && /* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(_kubb_react_fabric.File.Source, {
-		name: enumName,
-		isExportable: true,
-		isIndexable: true,
-		isTypeOnly: false,
-		children: (0, _kubb_fabric_core_parsers_typescript.safePrint)(nameNode)
-	}), /* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(_kubb_react_fabric.File.Source, {
-		name: typeName,
-		isIndexable: true,
-		isExportable: [
-			"enum",
-			"asConst",
-			"asPascalConst",
-			"constEnum",
-			"literal",
-			void 0
-		].includes(enumType),
-		isTypeOnly: [
-			"asConst",
-			"asPascalConst",
-			"literal",
-			void 0
-		].includes(enumType),
-		children: (0, _kubb_fabric_core_parsers_typescript.safePrint)(typeNode)
-	})] })), shouldExportType && /* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(_kubb_react_fabric.File.Source, {
+	return /* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsxs)(_kubb_react_fabric_jsx_runtime.Fragment, { children: [shouldExportEnums && enums.map(({ node }) => /* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(Enum, {
+		node,
+		enumType,
+		enumKeyCasing
+	})), shouldExportType && /* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsx)(_kubb_react_fabric.File.Source, {
 		name: typedName,
 		isTypeOnly: true,
 		isExportable: true,
 		isIndexable: true,
-		children: (0, _kubb_fabric_core_parsers_typescript.safePrint)(...typeNodes)
+		children: (0, _kubb_fabric_core_parsers_typescript.safePrint)(typeNode)
 	})] });
 }
 //#endregion
@@ -667,6 +755,8 @@ function Type({ name, typedName, node, keysToOmit, optionalType, arrayType, synt
 /**
 * Builds an `ObjectSchemaNode` for a group of parameters (path/query/header).
 * Each property is a `ref` schema pointing to the individually-resolved parameter type.
+* The ref name includes the parameter location so generated type names follow
+* the `<OperationId><Location><ParamName>` convention.
 */
 function buildParamsSchema({ params, operationId, resolveName }) {
 	return (0, _kubb_ast.createSchema)({
@@ -676,7 +766,7 @@ function buildParamsSchema({ params, operationId, resolveName }) {
 			schema: (0, _kubb_ast.createSchema)({
 				type: "ref",
 				name: resolveName({
-					name: `${operationId} ${param.name}`,
+					name: `${operationId} ${require_components.pascalCase(param.in)} ${param.name}`,
 					type: "function"
 				}),
 				optional: !param.required
@@ -685,7 +775,7 @@ function buildParamsSchema({ params, operationId, resolveName }) {
 	});
 }
 /**
-* Builds an `ObjectSchemaNode` representing the `<OperationId>Data` type:
+* Builds an `ObjectSchemaNode` representing the `<OperationId>RequestConfig` type:
 * - `data`         → request body ref (optional) or `never`
 * - `pathParams`   → inline object of path param refs, or `never`
 * - `queryParams`  → inline object of query param refs (optional), or `never`
@@ -704,7 +794,7 @@ function buildDataSchemaNode({ node, resolveName }) {
 				schema: node.requestBody ? (0, _kubb_ast.createSchema)({
 					type: "ref",
 					name: resolveName({
-						name: `${node.operationId} MutationRequest`,
+						name: `${node.operationId} Data`,
 						type: "function"
 					}),
 					optional: true
@@ -764,11 +854,7 @@ function buildDataSchemaNode({ node, resolveName }) {
 }
 /**
 * Builds an `ObjectSchemaNode` representing `<OperationId>Responses` — keyed by HTTP status code.
-*
-* Example output:
-* ```ts
-* export type PlaceOrderPatchResponses = { 200: PlaceOrderPatch200; 405: PlaceOrderPatch405 }
-* ```
+* Numeric status codes produce unquoted numeric keys (e.g. `200:`).
 */
 function buildResponsesSchemaNode({ node, resolveName }) {
 	const responsesWithSchema = node.responses.filter((res) => res.schema);
@@ -780,7 +866,7 @@ function buildResponsesSchemaNode({ node, resolveName }) {
 			schema: (0, _kubb_ast.createSchema)({
 				type: "ref",
 				name: resolveName({
-					name: `${node.operationId} ${res.statusCode}`,
+					name: `${node.operationId} Status ${res.statusCode}`,
 					type: "function"
 				})
 			})
@@ -789,11 +875,7 @@ function buildResponsesSchemaNode({ node, resolveName }) {
 }
 /**
 * Builds a `UnionSchemaNode` representing `<OperationId>Response` — all response types in union format.
-*
-* Example output:
-* ```ts
-* export type PlaceOrderPatchResponse = PlaceOrderPatch200 | PlaceOrderPatch405
-* ```
+* Returns `null` when the operation has no responses with schemas.
 */
 function buildResponseUnionSchemaNode({ node, resolveName }) {
 	const responsesWithSchema = node.responses.filter((res) => res.schema);
@@ -803,7 +885,7 @@ function buildResponseUnionSchemaNode({ node, resolveName }) {
 		members: responsesWithSchema.map((res) => (0, _kubb_ast.createSchema)({
 			type: "ref",
 			name: resolveName({
-				name: `${node.operationId} ${res.statusCode}`,
+				name: `${node.operationId} Status ${res.statusCode}`,
 				type: "function"
 			})
 		}))
@@ -815,12 +897,13 @@ const typeGenerator = (0, _kubb_core.defineGenerator)({
 	name: "typescript",
 	type: "react",
 	Operation({ node, adapter, options }) {
-		const { enumType, enumKeyCasing, optionalType, arrayType, syntaxType, paramsCasing, mapper } = options;
+		const { enumType, enumKeyCasing, optionalType, arrayType, syntaxType, paramsCasing, group } = options;
 		const { mode, getFile, resolveName } = (0, _kubb_core_hooks.useKubb)();
 		const file = getFile({
 			name: node.operationId,
 			extname: ".ts",
-			mode
+			mode,
+			options: { group: group ? group.type === "tag" ? { tag: node.tags[0] } : { path: node.path } : void 0 }
 		});
 		const params = (0, _kubb_ast.applyParamsCasing)(node.parameters, paramsCasing);
 		function renderSchemaType({ node: schemaNode, name, typedName, description }) {
@@ -854,29 +937,28 @@ const typeGenerator = (0, _kubb_core.defineGenerator)({
 				enumKeyCasing,
 				optionalType,
 				arrayType,
-				syntaxType,
-				mapper
+				syntaxType
 			})] });
 		}
 		const paramTypes = params.map((param) => renderSchemaType({
 			node: param.schema,
 			name: resolveName({
-				name: `${node.operationId} ${param.name}`,
+				name: `${node.operationId} ${require_components.pascalCase(param.in)} ${param.name}`,
 				type: "function"
 			}),
 			typedName: resolveName({
-				name: `${node.operationId} ${param.name}`,
+				name: `${node.operationId} ${require_components.pascalCase(param.in)} ${param.name}`,
 				type: "type"
 			})
 		}));
 		const responseTypes = node.responses.filter((res) => res.schema).map((res) => renderSchemaType({
 			node: res.schema,
 			name: resolveName({
-				name: `${node.operationId} ${res.statusCode}`,
+				name: `${node.operationId} Status ${res.statusCode}`,
 				type: "function"
 			}),
 			typedName: resolveName({
-				name: `${node.operationId} ${res.statusCode}`,
+				name: `${node.operationId} Status ${res.statusCode}`,
 				type: "type"
 			}),
 			description: res.description
@@ -884,11 +966,11 @@ const typeGenerator = (0, _kubb_core.defineGenerator)({
 		const requestType = node.requestBody ? renderSchemaType({
 			node: node.requestBody,
 			name: resolveName({
-				name: `${node.operationId} MutationRequest`,
+				name: `${node.operationId} Data`,
 				type: "function"
 			}),
 			typedName: resolveName({
-				name: `${node.operationId} MutationRequest`,
+				name: `${node.operationId} Data`,
 				type: "type"
 			}),
 			description: node.requestBody.description
@@ -902,11 +984,11 @@ const typeGenerator = (0, _kubb_core.defineGenerator)({
 				resolveName
 			}),
 			name: resolveName({
-				name: `${node.operationId} Data`,
+				name: `${node.operationId} RequestConfig`,
 				type: "function"
 			}),
 			typedName: resolveName({
-				name: `${node.operationId} Data`,
+				name: `${node.operationId} RequestConfig`,
 				type: "type"
 			})
 		});
@@ -936,7 +1018,8 @@ const typeGenerator = (0, _kubb_core.defineGenerator)({
 			typedName: resolveName({
 				name: `${node.operationId} Response`,
 				type: "type"
-			})
+			}),
+			description: "Union of all possible responses"
 		});
 		return /* @__PURE__ */ (0, _kubb_react_fabric_jsx_runtime.jsxs)(_kubb_react_fabric.File, {
 			baseName: file.baseName,
@@ -953,7 +1036,7 @@ const typeGenerator = (0, _kubb_core.defineGenerator)({
 		});
 	},
 	Schema({ node, adapter, options }) {
-		const { enumType, enumKeyCasing, syntaxType, optionalType, arrayType, mapper } = options;
+		const { enumType, enumKeyCasing, syntaxType, optionalType, arrayType } = options;
 		const { mode, resolveName, getFile } = (0, _kubb_core_hooks.useKubb)();
 		if (!node.name) return;
 		const imports = adapter.getImports(node, (schemaName) => ({
@@ -972,7 +1055,7 @@ const typeGenerator = (0, _kubb_core.defineGenerator)({
 			name: node.name,
 			type: "type"
 		});
-		if (["asConst", "asPascalConst"].includes(enumType) && isEnumSchema) typedName += "Key";
+		if (ENUM_TYPES_WITH_KEY_SUFFIX.has(enumType) && isEnumSchema) typedName += "Key";
 		const type = {
 			name: resolveName({
 				name: node.name,
@@ -1006,8 +1089,7 @@ const typeGenerator = (0, _kubb_core.defineGenerator)({
 				enumKeyCasing,
 				optionalType,
 				arrayType,
-				syntaxType,
-				mapper
+				syntaxType
 			})]
 		});
 	}
@@ -1019,7 +1101,7 @@ const pluginTs = (0, _kubb_core.definePlugin)((options) => {
 	const { output = {
 		path: "types",
 		barrelType: "named"
-	}, group, exclude = [], include, override = [], enumType = "asConst", enumKeyCasing = "none", enumSuffix = "enum", dateType = "string", integerType = "number", unknownType = "any", optionalType = "questionToken", arrayType = "array", emptySchemaType = unknownType, syntaxType = "type", transformers = {}, mapper = {}, paramsCasing, generators = [typeGenerator$1, typeGenerator].filter(Boolean), contentType, UNSTABLE_NAMING } = options;
+	}, group, exclude = [], include, override = [], enumType = "asConst", enumKeyCasing = "none", enumSuffix = "enum", dateType = "string", integerType = "number", unknownType = "any", optionalType = "questionToken", arrayType = "array", emptySchemaType = unknownType, syntaxType = "type", transformers = {}, paramsCasing, generators = [typeGenerator$1, typeGenerator].filter(Boolean), contentType, UNSTABLE_NAMING } = options;
 	return {
 		name: pluginTsName,
 		options: {
@@ -1037,7 +1119,6 @@ const pluginTs = (0, _kubb_core.definePlugin)((options) => {
 			syntaxType,
 			group,
 			override,
-			mapper,
 			paramsCasing,
 			usedEnumNames: {}
 		},
@@ -1065,7 +1146,7 @@ const pluginTs = (0, _kubb_core.definePlugin)((options) => {
 			return resolvedName;
 		},
 		async install() {
-			const { config, fabric, plugin, adapter, rootNode, pluginManager, openInStudio } = this;
+			const { config, fabric, plugin, adapter, rootNode, driver, openInStudio } = this;
 			const root = node_path.default.resolve(config.root, config.output.path);
 			const mode = (0, _kubb_core.getMode)(node_path.default.resolve(root, output.path));
 			if (adapter) {
@@ -1088,7 +1169,7 @@ const pluginTs = (0, _kubb_core.definePlugin)((options) => {
 									fabric,
 									Component: generator.Schema,
 									plugin,
-									pluginManager,
+									driver,
 									mode,
 									version: generator.version
 								});
@@ -1113,7 +1194,7 @@ const pluginTs = (0, _kubb_core.definePlugin)((options) => {
 									fabric,
 									Component: generator.Operation,
 									plugin,
-									pluginManager,
+									driver,
 									mode,
 									version: generator.version
 								});
@@ -1135,7 +1216,7 @@ const pluginTs = (0, _kubb_core.definePlugin)((options) => {
 			const schemaFiles = await new _kubb_plugin_oas.SchemaGenerator(this.plugin.options, {
 				fabric: this.fabric,
 				oas,
-				pluginManager: this.pluginManager,
+				driver: this.driver,
 				events: this.events,
 				plugin: this.plugin,
 				contentType,
@@ -1148,7 +1229,7 @@ const pluginTs = (0, _kubb_core.definePlugin)((options) => {
 			const operationFiles = await new _kubb_plugin_oas.OperationGenerator(this.plugin.options, {
 				fabric: this.fabric,
 				oas,
-				pluginManager: this.pluginManager,
+				driver: this.driver,
 				events: this.events,
 				plugin: this.plugin,
 				contentType,
@@ -1195,4 +1276,4 @@ Object.defineProperty(exports, "typeGenerator$1", {
 	}
 });
 
-//# sourceMappingURL=plugin-meWNDVe7.cjs.map
+//# sourceMappingURL=plugin-Cn85VLXR.cjs.map