@kubb/plugin-client 5.0.0-beta.4 → 5.0.0-beta.56

package/dist/index.cjs

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_chunk = require("./chunk-ByKO4r7w.cjs");
+const require_chunk = require("./chunk-Bx3C2hgW.cjs");
 const require_templates_clients_axios_source = require("./templates/clients/axios.source.cjs");
 const require_templates_clients_fetch_source = require("./templates/clients/fetch.source.cjs");
 const require_templates_config_source = require("./templates/config.source.cjs");
@@ -10,6 +10,7 @@ let node_path = require("node:path");
 let node_path$1 = require_chunk.__toESM(node_path, 1);
 node_path = require_chunk.__toESM(node_path);
 let _kubb_core = require("@kubb/core");
+let _kubb_ast_utils = require("@kubb/ast/utils");
 let _kubb_plugin_ts = require("@kubb/plugin-ts");
 let _kubb_renderer_jsx = require("@kubb/renderer-jsx");
 let _kubb_renderer_jsx_jsx_runtime = require("@kubb/renderer-jsx/jsx-runtime");
@@ -25,68 +26,57 @@ let _kubb_plugin_zod = require("@kubb/plugin-zod");
 function toCamelOrPascal(text, pascal) {
 	return text.trim().replace(/([a-z\d])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").replace(/(\d)([a-z])/g, "$1 $2").split(/[\s\-_./\\:]+/).filter(Boolean).map((word, i) => {
 		if (word.length > 1 && word === word.toUpperCase()) return word;
-		if (i === 0 && !pascal) return word.charAt(0).toLowerCase() + word.slice(1);
-		return word.charAt(0).toUpperCase() + word.slice(1);
+		return (i === 0 && !pascal ? word.charAt(0).toLowerCase() : word.charAt(0).toUpperCase()) + word.slice(1);
 	}).join("").replace(/[^a-zA-Z0-9]/g, "");
 }
 /**
-* Splits `text` on `.` and applies `transformPart` to each segment.
-* The last segment receives `isLast = true`, all earlier segments receive `false`.
-* Segments are joined with `/` to form a file path.
-*
-* Only splits on dots followed by a letter so that version numbers
-* embedded in operationIds (e.g. `v2025.0`) are kept intact.
-*/
-function applyToFileParts(text, transformPart) {
-	const parts = text.split(/\.(?=[a-zA-Z])/);
-	return parts.map((part, i) => transformPart(part, i === parts.length - 1)).join("/");
-}
-/**
 * Converts `text` to camelCase.
-* When `isFile` is `true`, dot-separated segments are each cased independently and joined with `/`.
 *
-* @example
-* camelCase('hello-world')                   // 'helloWorld'
-* camelCase('pet.petId', { isFile: true })   // 'pet/petId'
+* @example Word boundaries
+* `camelCase('hello-world') // 'helloWorld'`
+*
+* @example With a prefix
+* `camelCase('tag', { prefix: 'create' }) // 'createTag'`
 */
-function camelCase(text, { isFile, prefix = "", suffix = "" } = {}) {
-	if (isFile) return applyToFileParts(text, (part, isLast) => camelCase(part, isLast ? {
-		prefix,
-		suffix
-	} : {}));
+function camelCase(text, { prefix = "", suffix = "" } = {}) {
 	return toCamelOrPascal(`${prefix} ${text} ${suffix}`, false);
 }
 /**
 * Converts `text` to PascalCase.
-* When `isFile` is `true`, the last dot-separated segment is PascalCased and earlier segments are camelCased.
 *
-* @example
-* pascalCase('hello-world')                  // 'HelloWorld'
-* pascalCase('pet.petId', { isFile: true })  // 'pet/PetId'
+* @example Word boundaries
+* `pascalCase('hello-world') // 'HelloWorld'`
+*
+* @example With a suffix
+* `pascalCase('tag', { suffix: 'schema' }) // 'TagSchema'`
 */
-function pascalCase(text, { isFile, prefix = "", suffix = "" } = {}) {
-	if (isFile) return applyToFileParts(text, (part, isLast) => isLast ? pascalCase(part, {
-		prefix,
-		suffix
-	}) : camelCase(part));
+function pascalCase(text, { prefix = "", suffix = "" } = {}) {
 	return toCamelOrPascal(`${prefix} ${text} ${suffix}`, true);
 }
 //#endregion
-//#region ../../internals/utils/src/jsdoc.ts
+//#region ../../internals/utils/src/fs.ts
 /**
-* Builds a JSDoc comment block from an array of lines.
-* Returns `fallback` when `comments` is empty so callers always get a usable string.
+* Builds a nested file path from a dotted name. Splits on dots that precede a letter
+* (so version numbers embedded in operationIds like `v2025.0` stay intact), camelCases
+* every earlier segment, applies `caseLast` to the final segment, and joins with `/`.
 *
-* @example
-* ```ts
-* buildJSDoc(['@type string', '@example hello'])
-* // '/**\n   * @type string\n   * @example hello\n   *\/\n  '
-* ```
+* Empty segments are dropped before joining. They arise when the name starts with a dot
+* followed by a letter (e.g. `..Schema` splits into `['..', 'Schema']` and `'..'` cases to
+* an empty string). Without this a leading `/` would form, which `path.resolve` reads as an
+* absolute path, letting generated files escape the configured output directory.
+*
+* @example Nested path from a dotted name
+* `toFilePath('pet.petId') // 'pet/petId'`
+*
+* @example PascalCase the final segment
+* `toFilePath('pet.Pet', pascalCase) // 'pet/Pet'`
+*
+* @example Suffix applied to the final segment only
+* `toFilePath('tag.tag', (part) => camelCase(part, { suffix: 'schema' })) // 'tag/tagSchema'`
 */
-function buildJSDoc(comments, options = {}) {
-	const { indent = "   * ", suffix = "\n  ", fallback = "  " } = options;
-	if (comments.length === 0) return fallback;
-	return `/**\n${comments.map((c) => `${indent}${c}`).join("\n")}\n   */${suffix}`;
+function toFilePath(name, caseLast = camelCase) {
+	const parts = name.split(/\.(?=[a-zA-Z])/);
+	return parts.map((part, i) => i === parts.length - 1 ? caseLast(part) : camelCase(part)).filter(Boolean).join("/");
 }
 //#endregion
 //#region ../../internals/utils/src/reserved.ts
@@ -191,100 +181,104 @@ function isValidVarName(name) {
 	if (!name || reservedWords.has(name)) return false;
 	return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name);
 }
-//#endregion
-//#region ../../internals/utils/src/urlPath.ts
 /**
-* Parses and transforms an OpenAPI/Swagger path string into various URL formats.
+* Returns `name` when it's a syntactically valid JavaScript variable name,
+* otherwise prefixes it with `_` so the result is a valid identifier.
+*
+* Useful for sanitizing OpenAPI schema names or operation IDs that start with
+* a digit (e.g. `409`, `504AccountCancel`) before using them as exported
+* variable, type, or function names.
 *
 * @example
-* const p = new URLPath('/pet/{petId}')
-* p.URL      // '/pet/:petId'
-* p.template // '`/pet/${petId}`'
+* ```ts
+* ensureValidVarName('409')             // '_409'
+* ensureValidVarName('504AccountCancel') // '_504AccountCancel'
+* ensureValidVarName('Pet')              // 'Pet'
+* ensureValidVarName('class')            // '_class'
+* ```
 */
-var URLPath = class {
-	/**
-	* The raw OpenAPI/Swagger path string, e.g. `/pet/{petId}`.
-	*/
-	path;
-	#options;
-	constructor(path, options = {}) {
-		this.path = path;
-		this.#options = options;
+function ensureValidVarName(name) {
+	if (!name || isValidVarName(name)) return name;
+	return `_${name}`;
+}
+//#endregion
+//#region ../../internals/utils/src/url.ts
+function transformParam(raw, casing) {
+	const param = isValidVarName(raw) ? raw : camelCase(raw);
+	return casing === "camelcase" ? camelCase(param) : param;
+}
+function toParamsObject(path, { replacer, casing } = {}) {
+	const params = {};
+	for (const match of path.matchAll(/\{([^}]+)\}/g)) {
+		const param = transformParam(match[1], casing);
+		const key = replacer ? replacer(param) : param;
+		params[key] = key;
 	}
-	/** Converts the OpenAPI path to Express-style colon syntax, e.g. `/pet/{petId}` → `/pet/:petId`.
-	*
-	* @example
-	* ```ts
-	* new URLPath('/pet/{petId}').URL // '/pet/:petId'
-	* ```
-	*/
-	get URL() {
-		return this.toURLPath();
+	return Object.keys(params).length > 0 ? params : null;
+}
+/**
+* Helpers for OpenAPI/Swagger paths, plus a thin wrapper over the native `URL`.
+*/
+var Url$1 = class Url$1 {
+	static {
+		require_chunk.__name(this, "Url");
 	}
-	/** Returns `true` when `path` is a fully-qualified URL (e.g. starts with `https://`).
+	/**
+	* Reports whether `url` is a parseable absolute URL. Delegates to the native `URL.canParse`.
 	*
 	* @example
-	* ```ts
-	* new URLPath('https://petstore.swagger.io/v2/pet').isURL // true
-	* new URLPath('/pet/{petId}').isURL                       // false
-	* ```
+	* Url.canParse('https://petstore.swagger.io/v2') // true
+	* Url.canParse('/pet/{petId}')                   // false
 	*/
-	get isURL() {
-		try {
-			return !!new URL(this.path).href;
-		} catch {
-			return false;
-		}
+	static canParse(url, base) {
+		return URL.canParse(url, base);
 	}
 	/**
-	* Converts the OpenAPI path to a TypeScript template literal string.
+	* Converts an OpenAPI/Swagger path to Express-style colon syntax.
 	*
 	* @example
-	* new URLPath('/pet/{petId}').template              // '`/pet/${petId}`'
-	* new URLPath('/account/monetary-accountID').template // '`/account/${monetaryAccountId}`'
+	* Url.toPath('/pet/{petId}') // '/pet/:petId'
 	*/
-	get template() {
-		return this.toTemplateString();
+	static toPath(path) {
+		return path.replace(/\{([^}]+)\}/g, ":$1");
 	}
-	/** Returns the path and its extracted params as a structured `URLObject`, or as a stringified expression when `stringify` is set.
+	/**
+	* Converts an OpenAPI/Swagger path to a TypeScript template literal string.
+	* `prefix` is prepended inside the literal, `replacer` transforms each parameter name,
+	* and `casing` controls parameter identifier casing.
 	*
 	* @example
-	* ```ts
-	* new URLPath('/pet/{petId}').object
-	* // { url: '/pet/:petId', params: { petId: 'petId' } }
-	* ```
-	*/
-	get object() {
-		return this.toObject();
-	}
-	/** Returns a map of path parameter names, or `undefined` when the path has no parameters.
+	* Url.toTemplateString('/pet/{petId}') // '`/pet/${petId}`'
 	*
 	* @example
-	* ```ts
-	* new URLPath('/pet/{petId}').params // { petId: 'petId' }
-	* new URLPath('/pet').params         // undefined
-	* ```
+	* Url.toTemplateString('/pet/{petId}', { prefix: 'https://api' }) // '`https://api/pet/${petId}`'
 	*/
-	get params() {
-		return this.getParams();
-	}
-	#transformParam(raw) {
-		const param = isValidVarName(raw) ? raw : camelCase(raw);
-		return this.#options.casing === "camelcase" ? camelCase(param) : param;
+	static toTemplateString(path, { prefix, replacer, casing } = {}) {
+		const result = path.split(/\{([^}]+)\}/).map((part, i) => {
+			if (i % 2 === 0) return part;
+			const param = transformParam(part, casing);
+			return `\${${replacer ? replacer(param) : param}}`;
+		}).join("");
+		return `\`${prefix ?? ""}${result}\``;
 	}
 	/**
-	* Iterates over every `{param}` token in `path`, calling `fn` with the raw token and transformed name.
+	* Returns the path and its extracted params as a structured `URLObject`, or as a stringified
+	* expression when `stringify` is set.
+	*
+	* @example
+	* Url.toObject('/pet/{petId}')
+	* // { url: '/pet/:petId', params: { petId: 'petId' } }
 	*/
-	#eachParam(fn) {
-		for (const match of this.path.matchAll(/\{([^}]+)\}/g)) {
-			const raw = match[1];
-			fn(raw, this.#transformParam(raw));
-		}
-	}
-	toObject({ type = "path", replacer, stringify } = {}) {
+	static toObject(path, { type = "path", replacer, stringify, casing } = {}) {
 		const object = {
-			url: type === "path" ? this.toURLPath() : this.toTemplateString({ replacer }),
-			params: this.getParams()
+			url: type === "path" ? Url$1.toPath(path) : Url$1.toTemplateString(path, {
+				replacer,
+				casing
+			}),
+			params: toParamsObject(path, {
+				replacer,
+				casing
+			})
 		};
 		if (stringify) {
 			if (type === "template") return JSON.stringify(object).replaceAll("'", "").replaceAll(`"`, "");
@@ -293,51 +287,211 @@ var URLPath = class {
 		}
 		return object;
 	}
-	/**
-	* Converts the OpenAPI path to a TypeScript template literal string.
-	* An optional `replacer` can transform each extracted parameter name before interpolation.
-	*
-	* @example
-	* new URLPath('/pet/{petId}').toTemplateString() // '`/pet/${petId}`'
-	*/
-	toTemplateString({ prefix = "", replacer } = {}) {
-		return `\`${prefix}${this.path.split(/\{([^}]+)\}/).map((part, i) => {
-			if (i % 2 === 0) return part;
-			const param = this.#transformParam(part);
-			return `\${${replacer ? replacer(param) : param}}`;
-		}).join("")}\``;
-	}
-	/**
-	* Extracts all `{param}` segments from the path and returns them as a key-value map.
-	* An optional `replacer` transforms each parameter name in both key and value positions.
-	* Returns `undefined` when no path parameters are found.
-	*
-	* @example
-	* ```ts
-	* new URLPath('/pet/{petId}/tag/{tagId}').getParams()
-	* // { petId: 'petId', tagId: 'tagId' }
-	* ```
-	*/
-	getParams(replacer) {
-		const params = {};
-		this.#eachParam((_raw, param) => {
-			const key = replacer ? replacer(param) : param;
-			params[key] = key;
-		});
-		return Object.keys(params).length > 0 ? params : void 0;
-	}
-	/** Converts the OpenAPI path to Express-style colon syntax.
-	*
-	* @example
-	* ```ts
-	* new URLPath('/pet/{petId}').toURLPath() // '/pet/:petId'
-	* ```
-	*/
-	toURLPath() {
-		return this.path.replace(/\{([^}]+)\}/g, ":$1");
-	}
 };
 //#endregion
+//#region ../../internals/shared/src/operation.ts
+/**
+* Builds the `ResolverFileParams` every operation generator passes to
+* `resolver.resolveFile`: a file named `name`, tagged by the operation's first
+* tag (or `'default'`), at the operation's path. Centralizes the entry object
+* that was repeated at dozens of call sites across the client and query plugins.
+*
+* @example
+* ```ts
+* resolver.resolveFile(operationFileEntry(node, node.operationId), { root, output, group })
+* ```
+*/
+function operationFileEntry(node, name, extname = ".ts") {
+	return {
+		name,
+		extname,
+		tag: node.tags[0] ?? "default",
+		path: node.path
+	};
+}
+function getOperationLink(node, link) {
+	if (!link) return null;
+	if (typeof link === "function") return link(node) ?? null;
+	if (link === "urlPath") return node.path ? `{@link ${Url$1.toPath(node.path)}}` : null;
+	return node.path ? `{@link ${node.path.replaceAll("{", ":").replaceAll("}", "")}}` : null;
+}
+function getContentTypeInfo(node) {
+	const contentTypes = node.requestBody?.content?.map((e) => e.contentType) ?? [];
+	const isMultipleContentTypes = contentTypes.length > 1;
+	return {
+		contentTypes,
+		isMultipleContentTypes,
+		contentTypeUnion: isMultipleContentTypes ? contentTypes.map((ct) => JSON.stringify(ct)).join(" | ") : "",
+		defaultContentType: contentTypes[0] ?? "application/json",
+		hasFormData: contentTypes.some((ct) => ct === "multipart/form-data")
+	};
+}
+/**
+* Derives the default `responseType` for an operation from its primary success response.
+*
+* Returns a value only when that response declares a single non-JSON content type — a binary type
+* (`application/octet-stream`, `application/pdf`, `image/*`, `audio/*`, `video/*`) maps to `'blob'`
+* and other `text/*` maps to `'text'`. Otherwise `undefined`, leaving the runtime client's
+* `Content-Type` auto-detection in charge.
+*/
+function getResponseType(node) {
+	const contentTypes = getPrimarySuccessResponse(node)?.content?.map((entry) => entry.contentType) ?? [];
+	if (contentTypes.length !== 1) return void 0;
+	const baseType = contentTypes[0].split(";")[0].trim().toLowerCase();
+	if (baseType === "application/json" || baseType.endsWith("+json") || baseType === "text/json") return void 0;
+	if (baseType.startsWith("text/")) return "text";
+	if (baseType === "application/octet-stream" || baseType === "application/pdf" || /^(image|audio|video)\//.test(baseType)) return "blob";
+}
+function buildRequestConfigType(node, resolver) {
+	const requestName = node.requestBody?.content?.[0]?.schema ? resolver.resolveDataName(node) : null;
+	const { isMultipleContentTypes, contentTypeUnion } = getContentTypeInfo(node);
+	return `${requestName ? `Partial<RequestConfig<${requestName}>>` : "Partial<RequestConfig>"} & { ${["client?: Client", isMultipleContentTypes ? `contentType?: ${contentTypeUnion}` : null].filter(Boolean).join("; ")} }`;
+}
+function buildOperationComments(node, options = {}) {
+	const { link = "pathTemplate", linkPosition = "afterDeprecated", splitLines = false } = options;
+	const linkComment = getOperationLink(node, link);
+	const filteredComments = (linkPosition === "beforeDeprecated" ? [
+		node.description && `@description ${node.description}`,
+		node.summary && `@summary ${node.summary}`,
+		linkComment,
+		node.deprecated && "@deprecated"
+	] : [
+		node.description && `@description ${node.description}`,
+		node.summary && `@summary ${node.summary}`,
+		node.deprecated && "@deprecated",
+		linkComment
+	]).filter((comment) => Boolean(comment));
+	if (!splitLines) return filteredComments;
+	return filteredComments.flatMap((text) => text.split(/\r?\n/).map((line) => line.trim())).filter((comment) => Boolean(comment));
+}
+function getOperationParameters(node, options = {}) {
+	const params = _kubb_core.ast.caseParams(node.parameters, options.paramsCasing);
+	return {
+		path: params.filter((param) => param.in === "path"),
+		query: params.filter((param) => param.in === "query"),
+		header: params.filter((param) => param.in === "header"),
+		cookie: params.filter((param) => param.in === "cookie")
+	};
+}
+function getStatusCodeNumber(statusCode) {
+	const code = Number(statusCode);
+	return Number.isNaN(code) ? null : code;
+}
+function isSuccessStatusCode(statusCode) {
+	const code = getStatusCodeNumber(statusCode);
+	return code !== null && code >= 200 && code < 300;
+}
+function isErrorStatusCode(statusCode) {
+	const code = getStatusCodeNumber(statusCode);
+	return code !== null && code >= 400;
+}
+function getSuccessResponses(responses) {
+	return responses.filter((response) => isSuccessStatusCode(response.statusCode));
+}
+function getOperationSuccessResponses(node) {
+	return getSuccessResponses(node.responses);
+}
+function getPrimarySuccessResponse(node) {
+	return getOperationSuccessResponses(node)[0] ?? null;
+}
+function resolveErrorNames(node, resolver) {
+	return node.responses.filter((response) => isErrorStatusCode(response.statusCode)).map((response) => resolver.resolveResponseStatusName(node, response.statusCode));
+}
+function resolveSuccessNames(node, resolver) {
+	return node.responses.filter((response) => isSuccessStatusCode(response.statusCode)).map((response) => resolver.resolveResponseStatusName(node, response.statusCode));
+}
+function resolveStatusCodeNames(node, resolver) {
+	return node.responses.map((response) => resolver.resolveResponseStatusName(node, response.statusCode));
+}
+/**
+* Builds the discriminated union type string for `dataReturnType: 'full'` return shapes.
+* Each member is `{ status: N; data: StatusNType; statusText: string }`.
+*/
+function buildStatusUnionType(node, resolver) {
+	const members = node.responses.map((r) => {
+		const typeName = resolver.resolveResponseStatusName(node, r.statusCode);
+		const statusCode = Number.parseInt(r.statusCode, 10);
+		return `{ status: ${Number.isNaN(statusCode) ? "number" : String(statusCode)}; data: ${typeName}; statusText: string }`;
+	});
+	if (members.length === 1) return members[0];
+	return `(${members.join(" | ")})`;
+}
+const typeNamesByResolver = /* @__PURE__ */ new WeakMap();
+function resolveOperationTypeNames(node, resolver, options = {}) {
+	const cacheKey = `${node.operationId}\0${options.paramsCasing ?? ""}\0${options.order ?? ""}\0${options.responseStatusNames ?? ""}\0${(options.exclude ?? []).join(",")}`;
+	let byResolver = typeNamesByResolver.get(resolver);
+	if (byResolver) {
+		const cached = byResolver.get(cacheKey);
+		if (cached) return cached;
+	} else {
+		byResolver = /* @__PURE__ */ new Map();
+		typeNamesByResolver.set(resolver, byResolver);
+	}
+	const { path, query, header } = getOperationParameters(node, { paramsCasing: options.paramsCasing });
+	const responseStatusNames = options.responseStatusNames === "error" ? resolveErrorNames(node, resolver) : options.responseStatusNames === false ? [] : resolveStatusCodeNames(node, resolver);
+	const exclude = new Set(options.exclude ?? []);
+	const paramNames = [
+		...path.map((param) => resolver.resolvePathParamsName(node, param)),
+		...query.map((param) => resolver.resolveQueryParamsName(node, param)),
+		...header.map((param) => resolver.resolveHeaderParamsName(node, param))
+	];
+	const bodyAndResponseNames = [node.requestBody?.content?.[0]?.schema ? resolver.resolveDataName(node) : null, resolver.resolveResponseName(node)];
+	const result = (options.order === "body-response-first" ? [
+		...bodyAndResponseNames,
+		...paramNames,
+		...responseStatusNames
+	] : [
+		...paramNames,
+		...bodyAndResponseNames,
+		...responseStatusNames
+	]).filter((name) => Boolean(name) && !exclude.has(name));
+	byResolver.set(cacheKey, result);
+	return result;
+}
+//#endregion
+//#region ../../internals/shared/src/group.ts
+/**
+* Builds the `group` config a Kubb plugin passes to `ctx.setOptions`, applying the
+* shared default naming so every plugin groups output consistently:
+*
+* - `path` groups use the second path segment (`/pet/findByStatus` → `pet`).
+* - other groups use the camelCased group (`pet store` → `petStore`).
+*
+* A user-provided `group.name` always wins over the default namer, so callers stay in
+* control of their output folders. Returns `null` when grouping is disabled, matching the
+* per-plugin convention.
+*
+* @param group - The user-supplied group option, or `undefined` to disable grouping.
+*
+* @example
+* ```ts
+* createGroupConfig(group) // shared across every plugin
+* ```
+*/
+function createGroupConfig(group) {
+	if (!group) return null;
+	const defaultName = (ctx) => {
+		if (group.type === "path") return `${ctx.group.split("/")[1]}`;
+		return camelCase(ctx.group);
+	};
+	return {
+		...group,
+		name: group.name ? group.name : defaultName
+	};
+}
+//#endregion
+//#region ../../internals/shared/src/params.ts
+function buildParamsMapping(originalParams, mappedParams) {
+	const mapping = {};
+	let hasChanged = false;
+	originalParams.forEach((param, i) => {
+		const mappedName = mappedParams[i]?.name ?? param.name;
+		mapping[param.name] = mappedName;
+		if (param.name !== mappedName) hasChanged = true;
+	});
+	return hasChanged ? mapping : null;
+}
+//#endregion
 //#region src/functionParams.ts
 const declarationPrinter$4 = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declaration" });
 const callPrinter = (0, _kubb_plugin_ts.functionPrinter)({ mode: "call" });
@@ -348,18 +502,18 @@ function createType(type) {
 	return type ? _kubb_core.ast.createParamsType({
 		variant: "reference",
 		name: type
-	}) : void 0;
+	}) : null;
 }
 function createDeclarationLeaf(name, spec) {
 	if (spec.default !== void 0) return _kubb_core.ast.createFunctionParameter({
 		name,
-		type: createType(spec.type),
+		type: createType(spec.type) ?? void 0,
 		default: spec.default,
 		rest: spec.mode === "inlineSpread"
 	});
 	return _kubb_core.ast.createFunctionParameter({
 		name,
-		type: createType(spec.type),
+		type: createType(spec.type) ?? void 0,
 		optional: !!spec.optional,
 		rest: spec.mode === "inlineSpread"
 	});
@@ -368,14 +522,14 @@ function createDeclarationParam(name, spec) {
 	if (isGroup(spec)) return _kubb_core.ast.createParameterGroup({
 		inline: spec.mode === "inlineSpread",
 		default: spec.default,
-		properties: Object.entries(spec.children).filter(([, child]) => child !== void 0).map(([childName, child]) => createDeclarationLeaf(childName, child))
+		properties: Object.entries(spec.children).filter(([, child]) => child != null).map(([childName, child]) => createDeclarationLeaf(childName, child))
 	});
 	return createDeclarationLeaf(name, spec);
 }
 function createCallParam(name, spec) {
 	if (isGroup(spec)) return _kubb_core.ast.createParameterGroup({
 		inline: spec.mode === "inlineSpread",
-		properties: Object.entries(spec.children).filter(([, child]) => child !== void 0).map(([childName, child]) => _kubb_core.ast.createFunctionParameter({
+		properties: Object.entries(spec.children).filter(([, child]) => child != null).map(([childName, child]) => _kubb_core.ast.createFunctionParameter({
 			name: child?.mode === "inlineSpread" ? spec.mode === "inlineSpread" ? child.value ?? childName : `...${child.value ?? childName}` : child?.value ? `${childName}: ${child.value}` : childName,
 			rest: spec.mode === "inlineSpread" && child?.mode === "inlineSpread"
 		}))
@@ -390,7 +544,7 @@ function createCallParam(name, spec) {
 * Returns utilities to output constructor signatures (`toConstructor()`) or call expressions (`toCall()`).
 */
 function createFunctionParams(params) {
-	const entries = Object.entries(params).filter(([, spec]) => spec !== void 0);
+	const entries = Object.entries(params).filter(([, spec]) => spec != null);
 	return {
 		toConstructor() {
 			return declarationPrinter$4.print(_kubb_core.ast.createFunctionParameters({ params: entries.map(([name, spec]) => createDeclarationParam(name, spec)) })) ?? "";
@@ -403,83 +557,118 @@ function createFunctionParams(params) {
 //#endregion
 //#region src/utils.ts
 /**
-* Extracts documentation comments from an operation node.
-* Includes description, summary, link, and deprecation information.
+* Returns `true` when any direction of the parser uses Zod (used for dependency checks).
 */
-function getComments(node) {
-	return [
-		node.description && `@description ${node.description}`,
-		node.summary && `@summary ${node.summary}`,
-		node.path && `{@link ${new URLPath(node.path).URL}}`,
-		node.deprecated && "@deprecated"
-	].filter((x) => Boolean(x)).flatMap((text) => text.split(/\r?\n/).map((line) => line.trim())).filter((x) => Boolean(x));
+function isParserEnabled(parser) {
+	if (!parser) return false;
+	if (parser === "zod") return true;
+	return !!(parser.request || parser.response);
 }
 /**
-* Builds a mapping of original parameter names to their transformed (cased) names.
-* Returns undefined if no names have changed.
+* Returns `'zod'` when request body parsing is enabled, `null` otherwise.
+* The string shorthand `'zod'` also enables request body parsing (existing behavior).
 */
-function buildParamsMapping(originalParams, casedParams) {
-	const mapping = {};
-	let hasChanged = false;
-	originalParams.forEach((param, i) => {
-		const casedName = casedParams[i]?.name ?? param.name;
-		mapping[param.name] = casedName;
-		if (param.name !== casedName) hasChanged = true;
-	});
-	return hasChanged ? mapping : void 0;
+function resolveRequestParser(parser) {
+	if (!parser) return null;
+	if (parser === "zod") return "zod";
+	return parser.request ?? null;
+}
+/**
+* Returns `'zod'` when query-parameters parsing is enabled, `null` otherwise.
+* Only the object form `{ request: 'zod' }` enables query-params parsing.
+* The string shorthand `'zod'` does not, preserving its existing behavior.
+*/
+function resolveQueryParamsParser(parser) {
+	if (!parser || parser === "zod") return null;
+	return parser.request ?? null;
+}
+/**
+* Returns `'zod'` when response-direction parsing is enabled, `null` otherwise.
+* `parser: 'zod'` (string shorthand) maps to response parsing and returns `'zod'`.
+*/
+function resolveResponseParser(parser) {
+	if (!parser) return null;
+	if (parser === "zod") return "zod";
+	return parser.response ?? null;
 }
 /**
 * Builds HTTP headers array for a client request.
 * Includes Content-Type (if not default) and spreads header parameters if present.
 */
 function buildHeaders(contentType, hasHeaderParams) {
-	return [contentType !== "application/json" && contentType !== "multipart/form-data" ? `'Content-Type': '${contentType}'` : void 0, hasHeaderParams ? "...headers" : void 0].filter(Boolean);
+	return [contentType !== "application/json" && contentType !== "multipart/form-data" ? `'Content-Type': '${contentType}'` : null, hasHeaderParams ? "...headers" : null].filter(Boolean);
 }
 /**
-* Builds TypeScript generic parameters for a client method.
-* Includes response type, error type, and optional request type.
+* Returns the generic type arguments — response, error, and request body — for a generated
+* client call.
+*
+* When `dataReturnType` is `'full'`, the response generic widens to a union of all documented
+* status types. When `parser` is `'zod'` and a request body schema exists, the request type
+* uses `z.output<typeof schema>` to reflect post-transform types (e.g. date coercion).
 */
-function buildGenerics(node, tsResolver) {
-	const responseName = tsResolver.resolveResponseName(node);
-	const requestName = node.requestBody?.content?.[0]?.schema ? tsResolver.resolveDataName(node) : void 0;
+function buildGenerics(node, tsResolver, options = {}) {
+	const allStatusNames = node.responses.map((r) => tsResolver.resolveResponseStatusName(node, r.statusCode));
+	const successNames = resolveSuccessNames(node, tsResolver);
+	const responseName = options.dataReturnType === "full" ? allStatusNames.length > 0 ? allStatusNames.join(" | ") : tsResolver.resolveResponseName(node) : successNames.length > 0 ? successNames.join(" | ") : tsResolver.resolveResponseName(node);
+	const requestName = node.requestBody?.content?.[0]?.schema ? tsResolver.resolveDataName(node) : null;
 	const errorNames = node.responses.filter((r) => Number.parseInt(r.statusCode, 10) >= 400).map((r) => tsResolver.resolveResponseStatusName(node, r.statusCode));
+	const TError = `ResponseErrorConfig<${errorNames.length > 0 ? errorNames.join(" | ") : "Error"}>`;
+	const zodRequestName = options.parser === "zod" && options.zodResolver && node.requestBody?.content?.[0]?.schema ? options.zodResolver.resolveDataName?.(node) ?? null : null;
 	return [
 		responseName,
-		`ResponseErrorConfig<${errorNames.length > 0 ? errorNames.join(" | ") : "Error"}>`,
-		requestName || "unknown"
+		TError,
+		zodRequestName ? `z.output<typeof ${zodRequestName}>` : requestName || "unknown"
 	].filter(Boolean);
 }
 /**
 * Builds the parameters object for a class-based client method.
 * Includes URL, method, base URL, headers, and request/response data.
 */
-function buildClassClientParams({ node, path, baseURL, tsResolver, isFormData, headers }) {
-	const queryParamsName = node.parameters.filter((p) => p.in === "query").length > 0 ? tsResolver.resolveQueryParamsName(node, node.parameters.filter((p) => p.in === "query")[0]) : void 0;
-	const requestName = node.requestBody?.content?.[0]?.schema ? tsResolver.resolveDataName(node) : void 0;
+function buildClassClientParams({ node, url, baseURL, tsResolver, isFormData, isMultipleContentTypes, hasFormData, headers, zodQueryParamsName }) {
+	const { query: queryParams } = getOperationParameters(node);
+	const queryParamsName = queryParams.length > 0 ? tsResolver.resolveQueryParamsName(node, queryParams[0]) : null;
+	const requestName = node.requestBody?.content?.[0]?.schema ? tsResolver.resolveDataName(node) : null;
+	const responseType = getResponseType(node);
 	return createFunctionParams({ config: {
 		mode: "object",
 		children: {
 			requestConfig: { mode: "inlineSpread" },
-			method: { value: JSON.stringify(node.method.toUpperCase()) },
-			url: { value: path.template },
-			baseURL: baseURL ? { value: JSON.stringify(baseURL) } : void 0,
-			params: queryParamsName ? {} : void 0,
-			data: requestName ? { value: isFormData ? "formData as FormData" : "requestData" } : void 0,
-			headers: headers.length ? { value: `{ ${headers.join(", ")}, ...requestConfig.headers }` } : void 0
+			method: { value: JSON.stringify(_kubb_core.ast.isHttpOperationNode(node) ? node.method.toUpperCase() : "") },
+			url: { value: url },
+			baseURL: baseURL ? { value: JSON.stringify(baseURL) } : null,
+			params: queryParamsName ? zodQueryParamsName ? { value: "requestParams" } : {} : null,
+			data: requestName ? { value: isMultipleContentTypes && hasFormData ? "contentType === 'multipart/form-data' ? formData as FormData : requestData" : isFormData ? "formData as FormData" : "requestData" } : null,
+			contentType: isMultipleContentTypes ? {} : null,
+			responseType: responseType ? { value: JSON.stringify(responseType) } : null,
+			headers: headers.length ? { value: `{ ${headers.join(", ")}, ...requestConfig.headers }` } : null
 		}
 	} });
 }
 /**
 * Builds the request data parsing line for client methods.
-* Applies Zod validation if configured, otherwise uses data directly.
+* Applies Zod validation when `parser.request === 'zod'`, otherwise assigns data directly.
 */
 function buildRequestDataLine({ parser, node, zodResolver }) {
-	const zodRequestName = zodResolver && parser === "zod" && node.requestBody?.content?.[0]?.schema ? zodResolver.resolveDataName?.(node) : void 0;
-	if (parser === "zod" && zodRequestName) return `const requestData = ${zodRequestName}.parse(data)`;
+	const requestParser = resolveRequestParser(parser);
+	const zodRequestName = zodResolver && requestParser === "zod" && node.requestBody?.content?.[0]?.schema ? zodResolver.resolveDataName?.(node) : null;
+	if (requestParser === "zod" && zodRequestName) return `const requestData = ${zodRequestName}.parse(data)`;
 	if (node.requestBody?.content?.[0]?.schema) return "const requestData = data";
 	return "";
 }
 /**
+* Builds the query parameters parsing line for client methods.
+* Returns an empty string when no query params exist or query-params parsing is not enabled.
+* Only the object form `parser: { request: 'zod' }` triggers this. `parser: 'zod'` does not.
+*/
+function buildQueryParamsLine({ parser, node, zodResolver }) {
+	if (resolveQueryParamsParser(parser) !== "zod" || !zodResolver) return "";
+	const { query: queryParams } = getOperationParameters(node);
+	if (queryParams.length === 0) return "";
+	const zodQueryParamsName = zodResolver.resolveQueryParamsName?.(node, queryParams[0]);
+	if (!zodQueryParamsName) return "";
+	return `const requestParams = ${zodQueryParamsName}.parse(params)`;
+}
+/**
 * Builds the form data conversion line for file upload requests.
 * Returns empty string if not applicable.
 */
@@ -488,19 +677,24 @@ function buildFormDataLine(isFormData, hasRequest) {
 }
 /**
 * Builds the return statement for a client method.
-* Applies Zod validation to response data if configured, otherwise returns raw response.
+* When `dataReturnType` is `'full'`, casts the response to the status-discriminated union type.
+* When `parser.response` is `'zod'`, pipes the response body through the Zod schema before returning.
 */
-function buildReturnStatement({ dataReturnType, parser, node, zodResolver }) {
-	const zodResponseName = zodResolver && parser === "zod" ? zodResolver.resolveResponseName?.(node) : void 0;
-	if (dataReturnType === "full" && parser === "zod" && zodResponseName) return `return {...res, data: ${zodResponseName}.parse(res.data)}`;
-	if (dataReturnType === "data" && parser === "zod" && zodResponseName) return `return ${zodResponseName}.parse(res.data)`;
-	if (dataReturnType === "full" && parser === "client") return "return res";
+function buildReturnStatement({ dataReturnType, parser, node, zodResolver, tsResolver }) {
+	const responseParser = resolveResponseParser(parser);
+	const zodResponseName = zodResolver && responseParser === "zod" ? zodResolver.resolveResponseName?.(node) : null;
+	if (dataReturnType === "full" && tsResolver) {
+		const unionType = buildStatusUnionType(node, tsResolver);
+		if (responseParser === "zod" && zodResponseName) return `return {...res, data: ${zodResponseName}.parse(res.data)} as ${unionType}`;
+		return `return res as ${unionType}`;
+	}
+	if (dataReturnType === "data" && responseParser === "zod" && zodResponseName) return `return ${zodResponseName}.parse(res.data)`;
 	return "return res.data";
 }
 //#endregion
 //#region src/components/Url.tsx
 const declarationPrinter$3 = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declaration" });
-function getParams$1({ paramsType, paramsCasing, pathParamsType, node, tsResolver }) {
+function buildUrlParamsNode({ paramsType, paramsCasing, pathParamsType, node, tsResolver }) {
 	const urlNode = {
 		...node,
 		parameters: node.parameters.filter((p) => p.in === "path"),
@@ -513,10 +707,9 @@ function getParams$1({ paramsType, paramsCasing, pathParamsType, node, tsResolve
 		resolver: tsResolver
 	});
 }
-require_chunk.__name(getParams$1, "getParams");
 function Url({ name, isExportable = true, isIndexable = true, baseURL, paramsType, paramsCasing, pathParamsType, node, tsResolver }) {
-	const path = new URLPath(node.path);
-	const paramsNode = getParams$1({
+	if (!_kubb_core.ast.isHttpOperationNode(node)) return null;
+	const paramsNode = buildUrlParamsNode({
 		paramsType,
 		paramsCasing,
 		pathParamsType,
@@ -524,9 +717,9 @@ function Url({ name, isExportable = true, isIndexable = true, baseURL, paramsTyp
 		tsResolver
 	});
 	const paramsSignature = declarationPrinter$3.print(paramsNode) ?? "";
-	const originalPathParams = node.parameters.filter((p) => p.in === "path");
-	const casedPathParams = _kubb_core.ast.caseParams(originalPathParams, paramsCasing);
-	const pathParamsMapping = paramsCasing ? buildParamsMapping(originalPathParams, casedPathParams) : void 0;
+	const { path: originalPathParams } = getOperationParameters(node);
+	const { path: casedPathParams } = getOperationParameters(node, { paramsCasing });
+	const pathParamsMapping = paramsCasing ? buildParamsMapping(originalPathParams, casedPathParams) : null;
 	return /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Source, {
 		name,
 		isExportable,
@@ -540,7 +733,7 @@ function Url({ name, isExportable = true, isIndexable = true, baseURL, paramsTyp
 				pathParamsMapping && Object.keys(pathParamsMapping).length > 0 && /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)("br", {}),
 				/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.Const, {
 					name: "res",
-					children: `{ method: '${node.method.toUpperCase()}', url: ${path.toTemplateString({ prefix: baseURL })} as const }`
+					children: `{ method: '${node.method.toUpperCase()}', url: ${Url$1.toTemplateString(node.path, { prefix: baseURL })} as const }`
 				}),
 				/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)("br", {}),
 				"return res"
@@ -548,56 +741,58 @@ function Url({ name, isExportable = true, isIndexable = true, baseURL, paramsTyp
 		})
 	});
 }
-Url.getParams = getParams$1;
 //#endregion
 //#region src/components/Client.tsx
 const declarationPrinter$2 = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declaration" });
-function getParams({ paramsType, paramsCasing, pathParamsType, node, tsResolver, isConfigurable }) {
-	const requestName = node.requestBody?.content?.[0]?.schema ? tsResolver.resolveDataName(node) : void 0;
+function buildClientParamsNode({ paramsType, paramsCasing, pathParamsType, node, tsResolver, isConfigurable }) {
 	return _kubb_core.ast.createOperationParams(node, {
 		paramsType,
 		pathParamsType: paramsType === "object" ? "object" : pathParamsType === "object" ? "object" : "inline",
 		paramsCasing,
 		resolver: tsResolver,
-		extraParams: isConfigurable ? [_kubb_core.ast.createFunctionParameter({
+		extraParams: [...isConfigurable ? [_kubb_core.ast.createFunctionParameter({
 			name: "config",
 			type: _kubb_core.ast.createParamsType({
 				variant: "reference",
-				name: requestName ? `Partial<RequestConfig<${requestName}>> & { client?: Client }` : "Partial<RequestConfig> & { client?: Client }"
+				name: buildRequestConfigType(node, tsResolver)
 			}),
 			default: "{}"
-		})] : []
+		})] : []]
 	});
 }
 function Client({ name, isExportable = true, isIndexable = true, returnType, baseURL, dataReturnType, parser, paramsType, paramsCasing, pathParamsType, node, tsResolver, zodResolver, urlName, children, isConfigurable = true }) {
-	const path = new URLPath(node.path);
-	const contentType = node.requestBody?.content?.[0]?.contentType ?? "application/json";
-	const isFormData = contentType === "multipart/form-data";
-	const originalPathParams = node.parameters.filter((p) => p.in === "path");
-	const casedPathParams = _kubb_core.ast.caseParams(originalPathParams, paramsCasing);
-	const originalQueryParams = node.parameters.filter((p) => p.in === "query");
-	const casedQueryParams = _kubb_core.ast.caseParams(originalQueryParams, paramsCasing);
-	const originalHeaderParams = node.parameters.filter((p) => p.in === "header");
-	const casedHeaderParams = _kubb_core.ast.caseParams(originalHeaderParams, paramsCasing);
-	const pathParamsMapping = paramsCasing && !urlName ? buildParamsMapping(originalPathParams, casedPathParams) : void 0;
-	const queryParamsMapping = paramsCasing ? buildParamsMapping(originalQueryParams, casedQueryParams) : void 0;
-	const headerParamsMapping = paramsCasing ? buildParamsMapping(originalHeaderParams, casedHeaderParams) : void 0;
-	const requestName = node.requestBody?.content?.[0]?.schema ? tsResolver.resolveDataName(node) : void 0;
-	const responseName = tsResolver.resolveResponseName(node);
-	const queryParamsName = originalQueryParams.length > 0 ? tsResolver.resolveQueryParamsName(node, originalQueryParams[0]) : void 0;
-	const headerParamsName = originalHeaderParams.length > 0 ? tsResolver.resolveHeaderParamsName(node, originalHeaderParams[0]) : void 0;
-	const zodResponseName = zodResolver && parser === "zod" ? zodResolver.resolveResponseName?.(node) : void 0;
-	const zodRequestName = zodResolver && parser === "zod" && node.requestBody?.content?.[0]?.schema ? zodResolver.resolveDataName?.(node) : void 0;
+	if (!_kubb_core.ast.isHttpOperationNode(node)) return null;
+	const { defaultContentType: contentType, isMultipleContentTypes, hasFormData } = getContentTypeInfo(node);
+	const isFormData = !isMultipleContentTypes && contentType === "multipart/form-data";
+	const responseType = getResponseType(node);
+	const { path: originalPathParams, query: originalQueryParams, header: originalHeaderParams } = getOperationParameters(node);
+	const { path: casedPathParams, query: casedQueryParams, header: casedHeaderParams } = getOperationParameters(node, { paramsCasing });
+	const pathParamsMapping = paramsCasing && !urlName ? buildParamsMapping(originalPathParams, casedPathParams) : null;
+	const queryParamsMapping = paramsCasing ? buildParamsMapping(originalQueryParams, casedQueryParams) : null;
+	const headerParamsMapping = paramsCasing ? buildParamsMapping(originalHeaderParams, casedHeaderParams) : null;
+	const requestName = node.requestBody?.content?.[0]?.schema ? tsResolver.resolveDataName(node) : null;
+	const successNames = resolveSuccessNames(node, tsResolver);
+	const responseName = successNames.length > 0 ? successNames.join(" | ") : tsResolver.resolveResponseName(node);
+	const queryParamsName = originalQueryParams.length > 0 ? tsResolver.resolveQueryParamsName(node, originalQueryParams[0]) : null;
+	const headerParamsName = originalHeaderParams.length > 0 ? tsResolver.resolveHeaderParamsName(node, originalHeaderParams[0]) : null;
+	const requestParser = resolveRequestParser(parser);
+	const responseParser = resolveResponseParser(parser);
+	const zodResponseName = zodResolver && responseParser === "zod" ? zodResolver.resolveResponseName?.(node) : null;
+	const zodRequestName = zodResolver && requestParser === "zod" && node.requestBody?.content?.[0]?.schema ? zodResolver.resolveDataName?.(node) : null;
+	const queryParamsParser = resolveQueryParamsParser(parser);
+	const zodQueryParamsName = zodResolver && queryParamsParser === "zod" && originalQueryParams.length > 0 ? zodResolver.resolveQueryParamsName?.(node, originalQueryParams[0]) : null;
 	const errorNames = node.responses.filter((r) => {
 		return Number.parseInt(r.statusCode, 10) >= 400;
 	}).map((r) => tsResolver.resolveResponseStatusName(node, r.statusCode));
-	const headers = [contentType !== "application/json" && contentType !== "multipart/form-data" ? `'Content-Type': '${contentType}'` : void 0, headerParamsName ? headerParamsMapping ? "...mappedHeaders" : "...headers" : void 0].filter(Boolean);
+	const headers = [!isMultipleContentTypes && contentType !== "application/json" && contentType !== "multipart/form-data" ? `'Content-Type': '${contentType}'` : null, headerParamsName ? headerParamsMapping ? "...mappedHeaders" : "...headers" : null].filter(Boolean);
+	const TError = `ResponseErrorConfig<${errorNames.length > 0 ? errorNames.join(" | ") : "Error"}>`;
+	const allStatusNames = node.responses.map((r) => tsResolver.resolveResponseStatusName(node, r.statusCode));
 	const generics = [
-		responseName,
-		`ResponseErrorConfig<${errorNames.length > 0 ? errorNames.join(" | ") : "Error"}>`,
-		requestName || "unknown"
+		dataReturnType === "full" ? allStatusNames.length > 0 ? allStatusNames.join(" | ") : responseName : responseName,
+		TError,
+		parser === "zod" && zodRequestName ? `z.output<typeof ${zodRequestName}>` : requestName || "unknown"
 	].filter(Boolean);
-	const paramsNode = getParams({
+	const paramsNode = buildClientParamsNode({
 		paramsType,
 		paramsCasing,
 		pathParamsType,
@@ -606,7 +801,7 @@ function Client({ name, isExportable = true, isIndexable = true, returnType, bas
 		isConfigurable
 	});
 	const paramsSignature = declarationPrinter$2.print(paramsNode) ?? "";
-	const urlParamsNode = Url.getParams({
+	const urlParamsNode = buildUrlParamsNode({
 		paramsType,
 		paramsCasing,
 		pathParamsType,
@@ -617,20 +812,23 @@ function Client({ name, isExportable = true, isIndexable = true, returnType, bas
 	const clientParams = createFunctionParams({ config: {
 		mode: "object",
 		children: {
-			method: { value: JSON.stringify(node.method.toUpperCase()) },
-			url: { value: urlName ? `${urlName}(${urlParamsCall}).url.toString()` : path.template },
-			baseURL: baseURL && !urlName ? { value: `\`${baseURL}\`` } : void 0,
-			params: queryParamsName ? queryParamsMapping ? { value: "mappedParams" } : {} : void 0,
-			data: requestName ? { value: isFormData ? "formData as FormData" : "requestData" } : void 0,
-			requestConfig: isConfigurable ? { mode: "inlineSpread" } : void 0,
-			headers: headers.length ? { value: isConfigurable ? `{ ${headers.join(", ")}, ...requestConfig.headers }` : `{ ${headers.join(", ")} }` } : void 0
+			method: { value: (0, _kubb_ast_utils.stringify)(node.method.toUpperCase()) },
+			url: { value: urlName ? `${urlName}(${urlParamsCall}).url.toString()` : Url$1.toTemplateString(node.path) },
+			baseURL: baseURL && !urlName ? { value: `\`${baseURL}\`` } : null,
+			params: queryParamsName ? zodQueryParamsName ? { value: "requestParams" } : queryParamsMapping ? { value: "mappedParams" } : {} : null,
+			data: requestName ? { value: isMultipleContentTypes && hasFormData ? "contentType === 'multipart/form-data' ? formData as FormData : requestData" : isFormData ? "formData as FormData" : "requestData" } : null,
+			contentType: isConfigurable && isMultipleContentTypes ? {} : null,
+			responseType: responseType ? { value: (0, _kubb_ast_utils.stringify)(responseType) } : null,
+			requestConfig: isConfigurable ? { mode: "inlineSpread" } : null,
+			headers: headers.length ? { value: isConfigurable ? `{ ${headers.join(", ")}, ...requestConfig.headers }` : `{ ${headers.join(", ")} }` } : null
 		}
 	} });
+	const statusUnionType = dataReturnType === "full" ? buildStatusUnionType(node, tsResolver) : null;
 	const childrenElement = children ? children : /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsxs)(_kubb_renderer_jsx_jsx_runtime.Fragment, { children: [
-		dataReturnType === "full" && parser === "zod" && zodResponseName && `return {...res, data: ${zodResponseName}.parse(res.data)}`,
-		dataReturnType === "data" && parser === "zod" && zodResponseName && `return ${zodResponseName}.parse(res.data)`,
-		dataReturnType === "full" && parser === "client" && "return res",
-		dataReturnType === "data" && parser === "client" && "return res.data"
+		dataReturnType === "full" && responseParser === "zod" && zodResponseName && statusUnionType && `return {...res, data: ${zodResponseName}.parse(res.data)} as ${statusUnionType}`,
+		dataReturnType === "full" && responseParser !== "zod" && statusUnionType && `return res as ${statusUnionType}`,
+		dataReturnType === "data" && responseParser === "zod" && zodResponseName && `return ${zodResponseName}.parse(res.data)`,
+		dataReturnType === "data" && responseParser !== "zod" && "return res.data"
 	] });
 	return /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsxs)(_kubb_renderer_jsx_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)("br", {}), /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Source, {
 		name,
@@ -641,46 +839,46 @@ function Client({ name, isExportable = true, isIndexable = true, returnType, bas
 			async: true,
 			export: isExportable,
 			params: paramsSignature,
-			JSDoc: { comments: getComments(node) },
+			JSDoc: { comments: buildOperationComments(node, {
+				link: "urlPath",
+				linkPosition: "beforeDeprecated",
+				splitLines: true
+			}) },
 			returnType,
 			children: [
-				isConfigurable ? "const { client: request = fetch, ...requestConfig } = config" : "",
-				/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)("br", {}),
+				isConfigurable ? `const { client: request = client, ${isMultipleContentTypes ? `contentType = ${(0, _kubb_ast_utils.stringify)(contentType)}, ` : ""}...requestConfig } = config` : "",
 				/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)("br", {}),
 				pathParamsMapping && Object.entries(pathParamsMapping).filter(([originalName, camelCaseName]) => isValidVarName(originalName) && originalName !== camelCaseName).map(([originalName, camelCaseName]) => `const ${originalName} = ${camelCaseName}`).join("\n"),
-				pathParamsMapping && /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsxs)(_kubb_renderer_jsx_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)("br", {}), /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)("br", {})] }),
-				queryParamsMapping && queryParamsName && /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsxs)(_kubb_renderer_jsx_jsx_runtime.Fragment, { children: [
-					`const mappedParams = params ? { ${Object.entries(queryParamsMapping).map(([originalName, camelCaseName]) => `"${originalName}": params.${camelCaseName}`).join(", ")} } : undefined`,
-					/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)("br", {}),
-					/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)("br", {})
-				] }),
-				headerParamsMapping && headerParamsName && /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsxs)(_kubb_renderer_jsx_jsx_runtime.Fragment, { children: [
-					`const mappedHeaders = headers ? { ${Object.entries(headerParamsMapping).map(([originalName, camelCaseName]) => `"${originalName}": headers.${camelCaseName}`).join(", ")} } : undefined`,
-					/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)("br", {}),
-					/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)("br", {})
-				] }),
-				parser === "zod" && zodRequestName ? `const requestData = ${zodRequestName}.parse(data)` : requestName && "const requestData = data",
-				/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)("br", {}),
-				isFormData && requestName && "const formData = buildFormData(requestData)",
+				pathParamsMapping && /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)("br", {}),
+				queryParamsMapping && queryParamsName && /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsxs)(_kubb_renderer_jsx_jsx_runtime.Fragment, { children: [`const mappedParams = params ? { ${Object.entries(queryParamsMapping).map(([originalName, camelCaseName]) => `"${originalName}": params.${camelCaseName}`).join(", ")} } : undefined`, /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)("br", {})] }),
+				headerParamsMapping && headerParamsName && /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsxs)(_kubb_renderer_jsx_jsx_runtime.Fragment, { children: [`const mappedHeaders = headers ? { ${Object.entries(headerParamsMapping).map(([originalName, camelCaseName]) => `"${originalName}": headers.${camelCaseName}`).join(", ")} } : undefined`, /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)("br", {})] }),
+				requestParser === "zod" && zodRequestName ? `const requestData = ${zodRequestName}.parse(data)` : requestName && "const requestData = data",
+				zodQueryParamsName && `const requestParams = ${zodQueryParamsName}.parse(params)`,
+				(isFormData || isMultipleContentTypes && hasFormData) && requestName && "const formData = buildFormData(requestData)",
 				/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)("br", {}),
-				isConfigurable ? `const res = await request<${generics.join(", ")}>(${clientParams.toCall()})` : `const res = await fetch<${generics.join(", ")}>(${clientParams.toCall()})`,
+				isConfigurable ? `const res = await request<${generics.join(", ")}>(${clientParams.toCall()})` : `const res = await client<${generics.join(", ")}>(${clientParams.toCall()})`,
 				/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)("br", {}),
 				childrenElement
 			]
 		})
 	})] });
 }
-Client.getParams = getParams;
 //#endregion
 //#region src/components/ClassClient.tsx
 const declarationPrinter$1 = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declaration" });
 function generateMethod$1({ node, name, tsResolver, zodResolver, baseURL, dataReturnType, parser, paramsType, paramsCasing, pathParamsType }) {
-	const path = new URLPath(node.path, { casing: paramsCasing });
-	const contentType = node.requestBody?.content?.[0]?.contentType ?? "application/json";
-	const isFormData = contentType === "multipart/form-data";
-	const headers = buildHeaders(contentType, !!(node.parameters.filter((p) => p.in === "header").length > 0 ? tsResolver.resolveHeaderParamsName(node, node.parameters.filter((p) => p.in === "header")[0]) : void 0));
-	const generics = buildGenerics(node, tsResolver);
-	const paramsNode = ClassClient.getParams({
+	if (!_kubb_core.ast.isHttpOperationNode(node)) return "";
+	const { defaultContentType: contentType, isMultipleContentTypes, hasFormData } = getContentTypeInfo(node);
+	const isFormData = !isMultipleContentTypes && contentType === "multipart/form-data";
+	const { header: headerParams } = getOperationParameters(node);
+	const headerParamsName = headerParams.length > 0 ? tsResolver.resolveHeaderParamsName(node, headerParams[0]) : null;
+	const headers = isMultipleContentTypes ? headerParamsName ? ["...headers"] : [] : buildHeaders(contentType, !!headerParamsName);
+	const generics = buildGenerics(node, tsResolver, {
+		dataReturnType,
+		zodResolver,
+		parser
+	});
+	const paramsNode = buildClientParamsNode({
 		paramsType,
 		paramsCasing,
 		pathParamsType,
@@ -689,31 +887,47 @@ function generateMethod$1({ node, name, tsResolver, zodResolver, baseURL, dataRe
 		isConfigurable: true
 	});
 	const paramsSignature = declarationPrinter$1.print(paramsNode) ?? "";
+	const { query: queryParams } = getOperationParameters(node);
+	const zodQueryParamsName = zodResolver && resolveQueryParamsParser(parser) === "zod" && queryParams.length > 0 ? zodResolver.resolveQueryParamsName?.(node, queryParams[0]) : null;
 	const clientParams = buildClassClientParams({
 		node,
-		path,
+		url: Url$1.toTemplateString(node.path, { casing: paramsCasing }),
 		baseURL,
 		tsResolver,
 		isFormData,
-		headers
+		isMultipleContentTypes,
+		hasFormData,
+		headers,
+		zodQueryParamsName
 	});
-	const jsdoc = buildJSDoc(getComments(node));
+	const jsdoc = (0, _kubb_ast_utils.buildJSDoc)(buildOperationComments(node, {
+		link: "urlPath",
+		linkPosition: "beforeDeprecated",
+		splitLines: true
+	}));
 	const requestDataLine = buildRequestDataLine({
 		parser,
 		node,
 		zodResolver
 	});
-	const formDataLine = buildFormDataLine(isFormData, !!node.requestBody?.content?.[0]?.schema);
+	const queryParamsLine = buildQueryParamsLine({
+		parser,
+		node,
+		zodResolver
+	});
+	const formDataLine = buildFormDataLine(isFormData || isMultipleContentTypes && hasFormData, !!node.requestBody?.content?.[0]?.schema);
 	const returnStatement = buildReturnStatement({
 		dataReturnType,
 		parser,
 		node,
-		zodResolver
+		zodResolver,
+		tsResolver
 	});
 	return `${jsdoc}async ${name}(${paramsSignature}) {\n${[
-		"const { client: request = fetch, ...requestConfig } = mergeConfig(this.#config, config)",
+		`const { client: request = client, ${isMultipleContentTypes ? `contentType = ${(0, _kubb_ast_utils.stringify)(contentType)}, ` : ""}...requestConfig } = mergeConfig(this.#config, config)`,
 		"",
 		requestDataLine,
+		queryParamsLine,
 		formDataLine,
 		`const res = await request<${generics.join(", ")}>(${clientParams.toCall()})`,
 		returnStatement
@@ -748,15 +962,14 @@ ${operations.map(({ node, name: methodName, tsResolver, zodResolver }) => genera
 		children: [classCode, children]
 	});
 }
-ClassClient.getParams = Client.getParams;
 //#endregion
 //#region src/components/WrapperClient.tsx
-function WrapperClient({ name, classNames, isExportable = true, isIndexable = true }) {
+function WrapperClient({ name, controllers, isExportable = true, isIndexable = true }) {
 	const classCode = `export class ${name} {
-${classNames.map((className) => `  readonly ${camelCase(className)}: ${className}`).join("\n")}
+${controllers.map(({ className, propertyName }) => `  readonly ${propertyName}: ${className}`).join("\n")}
 
   constructor(config: Partial<RequestConfig> & { client?: Client } = {}) {
-${classNames.map((className) => `    this.${camelCase(className)} = new ${className}(config)`).join("\n")}
+${controllers.map(({ className, propertyName }) => `    this.${propertyName} = new ${className}(config)`).join("\n")}
   }
 }`;
 	return /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Source, {
@@ -769,54 +982,47 @@ ${classNames.map((className) => `    this.${camelCase(className)} = new ${classN
 //#endregion
 //#region src/generators/classClientGenerator.tsx
 function resolveTypeImportNames$1(node, tsResolver) {
-	return [
-		node.requestBody?.content?.[0]?.schema ? tsResolver.resolveDataName(node) : void 0,
-		tsResolver.resolveResponseName(node),
-		...node.parameters.filter((p) => p.in === "path").map((p) => tsResolver.resolvePathParamsName(node, p)),
-		...node.parameters.filter((p) => p.in === "query").map((p) => tsResolver.resolveQueryParamsName(node, p)),
-		...node.parameters.filter((p) => p.in === "header").map((p) => tsResolver.resolveHeaderParamsName(node, p)),
-		...node.responses.map((res) => tsResolver.resolveResponseStatusName(node, res.statusCode))
-	].filter((n) => Boolean(n));
+	return resolveOperationTypeNames(node, tsResolver, { order: "body-response-first" });
 }
 require_chunk.__name(resolveTypeImportNames$1, "resolveTypeImportNames");
-function resolveZodImportNames$1(node, zodResolver) {
-	return [zodResolver.resolveResponseName?.(node), node.requestBody?.content?.[0]?.schema ? zodResolver.resolveDataName?.(node) : void 0].filter((n) => Boolean(n));
+function resolveZodImportNames$1(node, zodResolver, parser) {
+	const { query: queryParams } = getOperationParameters(node);
+	return [
+		resolveResponseParser(parser) === "zod" ? zodResolver.resolveResponseName?.(node) : null,
+		resolveRequestParser(parser) === "zod" && node.requestBody?.content?.[0]?.schema ? zodResolver.resolveDataName?.(node) : null,
+		resolveQueryParamsParser(parser) === "zod" && queryParams.length > 0 ? zodResolver.resolveQueryParamsName?.(node, queryParams[0]) : null
+	].filter((n) => Boolean(n));
 }
 require_chunk.__name(resolveZodImportNames$1, "resolveZodImportNames");
+/**
+* Built-in `operations` generator for `@kubb/plugin-client` when
+* `clientType: 'class'`. Emits one class per tag, with one instance method
+* per operation and a shared constructor for request configuration.
+*/
 const classClientGenerator = (0, _kubb_core.defineGenerator)({
 	name: "classClient",
 	renderer: _kubb_renderer_jsx.jsxRenderer,
 	operations(nodes, ctx) {
-		const { adapter, config, driver, resolver, root } = ctx;
+		const { config, driver, resolver, root } = ctx;
 		const { output, group, dataReturnType, paramsCasing, paramsType, pathParamsType, parser, importPath, sdk } = ctx.options;
-		const baseURL = ctx.options.baseURL ?? adapter.inputNode?.meta?.baseURL;
+		const baseURL = ctx.options.baseURL ?? ctx.meta.baseURL;
 		const pluginTs = driver.getPlugin(_kubb_plugin_ts.pluginTsName);
 		if (!pluginTs) return null;
 		const tsResolver = driver.getResolver(_kubb_plugin_ts.pluginTsName);
 		const tsPluginOptions = pluginTs.options;
-		const pluginZod = parser === "zod" ? driver.getPlugin(_kubb_plugin_zod.pluginZodName) : void 0;
-		const zodResolver = pluginZod ? driver.getResolver(_kubb_plugin_zod.pluginZodName) : void 0;
+		const pluginZod = isParserEnabled(parser) ? driver.getPlugin(_kubb_plugin_zod.pluginZodName) : null;
+		const zodResolver = pluginZod ? driver.getResolver(_kubb_plugin_zod.pluginZodName) : null;
 		function buildOperationData(node) {
-			const typeFile = tsResolver.resolveFile({
-				name: node.operationId,
-				extname: ".ts",
-				tag: node.tags[0] ?? "default",
-				path: node.path
-			}, {
+			const typeFile = tsResolver.resolveFile(operationFileEntry(node, node.operationId), {
 				root,
 				output: tsPluginOptions?.output ?? output,
 				group: tsPluginOptions?.group
 			});
-			const zodFile = zodResolver && pluginZod?.options ? zodResolver.resolveFile({
-				name: node.operationId,
-				extname: ".ts",
-				tag: node.tags[0] ?? "default",
-				path: node.path
-			}, {
+			const zodFile = zodResolver && pluginZod?.options ? zodResolver.resolveFile(operationFileEntry(node, node.operationId), {
 				root,
 				output: pluginZod.options?.output ?? output,
-				group: pluginZod.options?.group
-			}) : void 0;
+				group: pluginZod.options?.group ?? void 0
+			}) : null;
 			return {
 				node,
 				name: resolver.resolveName(node.operationId),
@@ -827,27 +1033,31 @@ const classClientGenerator = (0, _kubb_core.defineGenerator)({
 			};
 		}
 		const controllers = nodes.reduce((acc, operationNode) => {
+			if (!_kubb_core.ast.isHttpOperationNode(operationNode)) return acc;
 			const tag = operationNode.tags[0];
-			const groupName = tag ? group?.name?.({ group: camelCase(tag) }) ?? pascalCase(tag) : "Client";
+			const groupName = tag ? group?.name?.({ group: camelCase(tag) }) ?? resolver.resolveGroupName(tag) : resolver.resolveClassName("Client");
 			if (!tag && !group) {
-				const name = "ApiClient";
+				const name = resolver.resolveClassName("ApiClient");
 				const file = resolver.resolveFile({
 					name,
 					extname: ".ts"
 				}, {
 					root,
 					output,
-					group
+					group: group ?? void 0
 				});
 				const operationData = buildOperationData(operationNode);
 				const previous = acc.find((item) => item.file.path === file.path);
 				if (previous) previous.operations.push(operationData);
 				else acc.push({
 					name,
+					propertyName: resolver.resolveClientPropertyName(name),
 					file,
 					operations: [operationData]
 				});
-			} else if (tag) {
+				return acc;
+			}
+			if (tag) {
 				const name = groupName;
 				const file = resolver.resolveFile({
 					name,
@@ -856,13 +1066,14 @@ const classClientGenerator = (0, _kubb_core.defineGenerator)({
 				}, {
 					root,
 					output,
-					group
+					group: group ?? void 0
 				});
 				const operationData = buildOperationData(operationNode);
 				const previous = acc.find((item) => item.file.path === file.path);
 				if (previous) previous.operations.push(operationData);
 				else acc.push({
 					name,
+					propertyName: resolver.resolveClientPropertyName(name),
 					file,
 					operations: [operationData]
 				});
@@ -891,7 +1102,7 @@ const classClientGenerator = (0, _kubb_core.defineGenerator)({
 			const zodFilesByPath = /* @__PURE__ */ new Map();
 			ops.forEach((op) => {
 				if (!op.zodFile || !zodResolver) return;
-				const names = resolveZodImportNames$1(op.node, zodResolver);
+				const names = resolveZodImportNames$1(op.node, zodResolver, parser);
 				if (!zodImportsByFile.has(op.zodFile.path)) zodImportsByFile.set(op.zodFile.path, /* @__PURE__ */ new Set());
 				const imports = zodImportsByFile.get(op.zodFile.path);
 				names.forEach((n) => {
@@ -906,27 +1117,35 @@ const classClientGenerator = (0, _kubb_core.defineGenerator)({
 		}
 		const files = controllers.map(({ name, file, operations: ops }) => {
 			const { typeImportsByFile, typeFilesByPath } = collectTypeImports(ops);
-			const { zodImportsByFile, zodFilesByPath } = parser === "zod" ? collectZodImports(ops) : {
+			const { zodImportsByFile, zodFilesByPath } = isParserEnabled(parser) ? collectZodImports(ops) : {
 				zodImportsByFile: /* @__PURE__ */ new Map(),
 				zodFilesByPath: /* @__PURE__ */ new Map()
 			};
-			const hasFormData = ops.some((op) => op.node.requestBody?.content?.[0]?.contentType === "multipart/form-data");
+			const hasFormData = ops.some((op) => op.node.requestBody?.content?.some((e) => e.contentType === "multipart/form-data") ?? false);
 			return /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsxs)(_kubb_renderer_jsx.File, {
 				baseName: file.baseName,
 				path: file.path,
 				meta: file.meta,
-				banner: resolver.resolveBanner(adapter.inputNode, {
+				banner: resolver.resolveBanner(ctx.meta, {
 					output,
-					config
+					config,
+					file: {
+						path: file.path,
+						baseName: file.baseName
+					}
 				}),
-				footer: resolver.resolveFooter(adapter.inputNode, {
+				footer: resolver.resolveFooter(ctx.meta, {
 					output,
-					config
+					config,
+					file: {
+						path: file.path,
+						baseName: file.baseName
+					}
 				}),
 				children: [
 					importPath ? /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsxs)(_kubb_renderer_jsx_jsx_runtime.Fragment, { children: [
 						/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Import, {
-							name: "fetch",
+							name: "client",
 							path: importPath
 						}),
 						/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Import, {
@@ -944,7 +1163,7 @@ const classClientGenerator = (0, _kubb_core.defineGenerator)({
 						})
 					] }) : /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsxs)(_kubb_renderer_jsx_jsx_runtime.Fragment, { children: [
 						/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Import, {
-							name: ["fetch"],
+							name: ["client"],
 							root: file.path,
 							path: node_path.default.resolve(root, ".kubb/client.ts")
 						}),
@@ -969,6 +1188,11 @@ const classClientGenerator = (0, _kubb_core.defineGenerator)({
 						root: file.path,
 						path: node_path.default.resolve(root, ".kubb/config.ts")
 					}),
+					parser === "zod" && zodResolver && ops.some((op) => op.node.requestBody?.content?.[0]?.schema != null) && /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Import, {
+						name: ["z"],
+						path: "zod",
+						isTypeOnly: true
+					}),
 					Array.from(typeImportsByFile.entries()).map(([filePath, importSet]) => {
 						const typeFile = typeFilesByPath.get(filePath);
 						if (!typeFile) return null;
@@ -981,7 +1205,7 @@ const classClientGenerator = (0, _kubb_core.defineGenerator)({
 							isTypeOnly: true
 						}, filePath);
 					}),
-					parser === "zod" && Array.from(zodImportsByFile.entries()).map(([filePath, importSet]) => {
+					isParserEnabled(parser) && Array.from(zodImportsByFile.entries()).map(([filePath, importSet]) => {
 						const zodFile = zodFilesByPath.get(filePath);
 						if (!zodFile) return null;
 						const importNames = Array.from(importSet).filter(Boolean);
@@ -1012,19 +1236,27 @@ const classClientGenerator = (0, _kubb_core.defineGenerator)({
 			}, {
 				root,
 				output,
-				group
+				group: group ?? void 0
 			});
 			files.push(/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsxs)(_kubb_renderer_jsx.File, {
 				baseName: sdkFile.baseName,
 				path: sdkFile.path,
 				meta: sdkFile.meta,
-				banner: resolver.resolveBanner(adapter.inputNode, {
+				banner: resolver.resolveBanner(ctx.meta, {
 					output,
-					config
+					config,
+					file: {
+						path: sdkFile.path,
+						baseName: sdkFile.baseName
+					}
 				}),
-				footer: resolver.resolveFooter(adapter.inputNode, {
+				footer: resolver.resolveFooter(ctx.meta, {
 					output,
-					config
+					config,
+					file: {
+						path: sdkFile.path,
+						baseName: sdkFile.baseName
+					}
 				}),
 				children: [
 					importPath ? /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Import, {
@@ -1044,7 +1276,10 @@ const classClientGenerator = (0, _kubb_core.defineGenerator)({
 					}, name)),
 					/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(WrapperClient, {
 						name: sdk.className,
-						classNames: controllers.map(({ name }) => name)
+						controllers: controllers.map(({ name, propertyName }) => ({
+							className: name,
+							propertyName
+						}))
 					})
 				]
 			}, sdkFile.path));
@@ -1054,81 +1289,75 @@ const classClientGenerator = (0, _kubb_core.defineGenerator)({
 });
 //#endregion
 //#region src/generators/clientGenerator.tsx
+/**
+* Built-in operation generator for `@kubb/plugin-client`. Emits one async
+* function per OpenAPI operation, plus the matching URL helper. Used when
+* `clientType: 'function'` (the default).
+*/
 const clientGenerator = (0, _kubb_core.defineGenerator)({
 	name: "client",
 	renderer: _kubb_renderer_jsx.jsxRenderer,
 	operation(node, ctx) {
-		const { adapter, config, driver, resolver, root } = ctx;
+		if (!_kubb_core.ast.isHttpOperationNode(node)) return null;
+		const { config, driver, resolver, root } = ctx;
 		const { output, urlType, dataReturnType, paramsCasing, paramsType, pathParamsType, parser, importPath, group } = ctx.options;
-		const baseURL = ctx.options.baseURL ?? adapter.inputNode?.meta?.baseURL;
+		const baseURL = ctx.options.baseURL ?? ctx.meta.baseURL;
 		const pluginTs = driver.getPlugin(_kubb_plugin_ts.pluginTsName);
 		if (!pluginTs) return null;
 		const tsResolver = driver.getResolver(_kubb_plugin_ts.pluginTsName);
-		const pluginZod = parser === "zod" ? driver.getPlugin(_kubb_plugin_zod.pluginZodName) : void 0;
-		const zodResolver = pluginZod ? driver.getResolver(_kubb_plugin_zod.pluginZodName) : void 0;
-		const casedParams = _kubb_core.ast.caseParams(node.parameters, paramsCasing);
-		const pathParams = casedParams.filter((p) => p.in === "path");
-		const queryParams = casedParams.filter((p) => p.in === "query");
-		const headerParams = casedParams.filter((p) => p.in === "header");
-		const importedTypeNames = [
-			...pathParams.map((p) => tsResolver.resolvePathParamsName(node, p)),
-			...queryParams.map((p) => tsResolver.resolveQueryParamsName(node, p)),
-			...headerParams.map((p) => tsResolver.resolveHeaderParamsName(node, p)),
-			node.requestBody?.content?.[0]?.schema ? tsResolver.resolveDataName(node) : void 0,
-			tsResolver.resolveResponseName(node),
-			...node.responses.map((res) => tsResolver.resolveResponseStatusName(node, res.statusCode))
-		].filter(Boolean);
-		const importedZodNames = zodResolver && parser === "zod" ? [zodResolver.resolveResponseName?.(node), node.requestBody?.content?.[0]?.schema ? zodResolver.resolveDataName?.(node) : void 0].filter(Boolean) : [];
+		const pluginZod = isParserEnabled(parser) ? driver.getPlugin(_kubb_plugin_zod.pluginZodName) : null;
+		const zodResolver = pluginZod ? driver.getResolver(_kubb_plugin_zod.pluginZodName) : null;
+		const importedTypeNames = resolveOperationTypeNames(node, tsResolver, { paramsCasing });
+		const { query: queryParams } = getOperationParameters(node);
+		const importedZodNames = zodResolver ? [
+			resolveResponseParser(parser) === "zod" ? zodResolver.resolveResponseName?.(node) : null,
+			resolveRequestParser(parser) === "zod" && node.requestBody?.content?.[0]?.schema ? zodResolver.resolveDataName?.(node) : null,
+			resolveQueryParamsParser(parser) === "zod" && queryParams.length > 0 ? zodResolver.resolveQueryParamsName?.(node, queryParams[0]) : null
+		].filter((name) => Boolean(name)) : [];
+		const zodRequestName = zodResolver && parser === "zod" && node.requestBody?.content?.[0]?.schema ? zodResolver.resolveDataName?.(node) ?? null : null;
 		const meta = {
 			name: resolver.resolveName(node.operationId),
-			urlName: `get${resolver.resolveName(node.operationId).charAt(0).toUpperCase()}${resolver.resolveName(node.operationId).slice(1)}Url`,
-			file: resolver.resolveFile({
-				name: node.operationId,
-				extname: ".ts",
-				tag: node.tags[0] ?? "default",
-				path: node.path
-			}, {
+			urlName: resolver.resolveUrlName(node),
+			file: resolver.resolveFile(operationFileEntry(node, node.operationId), {
 				root,
 				output,
-				group
+				group: group ?? void 0
 			}),
-			fileTs: tsResolver.resolveFile({
-				name: node.operationId,
-				extname: ".ts",
-				tag: node.tags[0] ?? "default",
-				path: node.path
-			}, {
+			fileTs: tsResolver.resolveFile(operationFileEntry(node, node.operationId), {
 				root,
 				output: pluginTs.options?.output ?? output,
-				group: pluginTs.options?.group
+				group: pluginTs.options?.group ?? void 0
 			}),
-			fileZod: zodResolver && pluginZod?.options ? zodResolver.resolveFile({
-				name: node.operationId,
-				extname: ".ts",
-				tag: node.tags[0] ?? "default",
-				path: node.path
-			}, {
+			fileZod: zodResolver && pluginZod?.options ? zodResolver.resolveFile(operationFileEntry(node, node.operationId), {
 				root,
 				output: pluginZod.options.output ?? output,
-				group: pluginZod.options?.group
-			}) : void 0
+				group: pluginZod.options?.group ?? void 0
+			}) : null
 		};
-		const isFormData = node.requestBody?.content?.[0]?.contentType === "multipart/form-data";
+		const hasFormData = node.requestBody?.content?.some((e) => e.contentType === "multipart/form-data") ?? false;
 		return /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsxs)(_kubb_renderer_jsx.File, {
 			baseName: meta.file.baseName,
 			path: meta.file.path,
 			meta: meta.file.meta,
-			banner: resolver.resolveBanner(adapter.inputNode, {
+			banner: resolver.resolveBanner(ctx.meta, {
 				output,
-				config
+				config,
+				file: {
+					path: meta.file.path,
+					baseName: meta.file.baseName
+				}
 			}),
-			footer: resolver.resolveFooter(adapter.inputNode, {
+			footer: resolver.resolveFooter(ctx.meta, {
 				output,
-				config
+				config,
+				file: {
+					path: meta.file.path,
+					baseName: meta.file.baseName
+				}
 			}),
 			children: [
 				importPath ? /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsxs)(_kubb_renderer_jsx_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Import, {
-					name: "fetch",
+					name: "client",
 					path: importPath
 				}), /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Import, {
 					name: [
@@ -1139,7 +1368,7 @@ const clientGenerator = (0, _kubb_core.defineGenerator)({
 					path: importPath,
 					isTypeOnly: true
 				})] }) : /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsxs)(_kubb_renderer_jsx_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Import, {
-					name: ["fetch"],
+					name: ["client"],
 					root: meta.file.path,
 					path: node_path.default.resolve(root, ".kubb/client.ts")
 				}), /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Import, {
@@ -1152,11 +1381,16 @@ const clientGenerator = (0, _kubb_core.defineGenerator)({
 					path: node_path.default.resolve(root, ".kubb/client.ts"),
 					isTypeOnly: true
 				})] }),
-				isFormData && node.requestBody?.content?.[0]?.schema && /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Import, {
+				hasFormData && /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Import, {
 					name: ["buildFormData"],
 					root: meta.file.path,
 					path: node_path.default.resolve(root, ".kubb/config.ts")
 				}),
+				zodRequestName && /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Import, {
+					name: ["z"],
+					path: "zod",
+					isTypeOnly: true
+				}),
 				meta.fileZod && importedZodNames.length > 0 && /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Import, {
 					name: importedZodNames,
 					root: meta.file.path,
@@ -1198,16 +1432,22 @@ const clientGenerator = (0, _kubb_core.defineGenerator)({
 });
 //#endregion
 //#region src/generators/groupedClientGenerator.tsx
+/**
+* Emits one aggregate file per tag/group when `group` is configured. Each
+* file re-exports every client function for that group, so callers can
+* `import { petController } from './gen/clients'` instead of importing
+* each operation individually.
+*/
 const groupedClientGenerator = (0, _kubb_core.defineGenerator)({
 	name: "groupedClient",
 	renderer: _kubb_renderer_jsx.jsxRenderer,
 	operations(nodes, ctx) {
-		const { config, resolver, adapter, root } = ctx;
+		const { config, resolver, root } = ctx;
 		const { output, group } = ctx.options;
 		return /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx_jsx_runtime.Fragment, { children: nodes.reduce((acc, operationNode) => {
 			if (group?.type === "tag") {
 				const tag = operationNode.tags[0];
-				const name = tag ? group?.name?.({ group: camelCase(tag) }) : void 0;
+				const name = tag ? group?.name?.({ group: camelCase(tag) }) : null;
 				if (!tag || !name) return acc;
 				const file = resolver.resolveFile({
 					name,
@@ -1216,7 +1456,7 @@ const groupedClientGenerator = (0, _kubb_core.defineGenerator)({
 				}, {
 					root,
 					output,
-					group
+					group: group ?? void 0
 				});
 				const clientFile = resolver.resolveFile({
 					name: operationNode.operationId,
@@ -1226,7 +1466,7 @@ const groupedClientGenerator = (0, _kubb_core.defineGenerator)({
 				}, {
 					root,
 					output,
-					group
+					group: group ?? void 0
 				});
 				const client = {
 					name: resolver.resolveName(operationNode.operationId),
@@ -1246,13 +1486,23 @@ const groupedClientGenerator = (0, _kubb_core.defineGenerator)({
 				baseName: file.baseName,
 				path: file.path,
 				meta: file.meta,
-				banner: resolver.resolveBanner(adapter.inputNode, {
+				banner: resolver.resolveBanner(ctx.meta, {
 					output,
-					config
+					config,
+					file: {
+						path: file.path,
+						baseName: file.baseName,
+						isAggregation: true
+					}
 				}),
-				footer: resolver.resolveFooter(adapter.inputNode, {
+				footer: resolver.resolveFooter(ctx.meta, {
 					output,
-					config
+					config,
+					file: {
+						path: file.path,
+						baseName: file.baseName,
+						isAggregation: true
+					}
 				}),
 				children: [clients.map((client) => /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Import, {
 					name: [client.name],
@@ -1273,33 +1523,17 @@ const groupedClientGenerator = (0, _kubb_core.defineGenerator)({
 	}
 });
 //#endregion
-//#region src/components/Operations.tsx
-function Operations({ name, nodes }) {
-	const operationsObject = {};
-	nodes.forEach((node) => {
-		operationsObject[node.operationId] = {
-			path: new URLPath(node.path).URL,
-			method: node.method.toLowerCase()
-		};
-	});
-	return /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Source, {
-		name,
-		isExportable: true,
-		isIndexable: true,
-		children: /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.Const, {
-			name,
-			export: true,
-			children: JSON.stringify(operationsObject, void 0, 2)
-		})
-	});
-}
-//#endregion
-//#region src/generators/operationsGenerator.tsx
+//#region src/generators/operationsGenerator.ts
+/**
+* Generates an `operations.ts` file that re-exports every operation grouped
+* by HTTP method. Enabled when `pluginClient({ operations: true })`. Useful
+* for building meta-tooling on top of the generated client (route
+* registries, API explorers).
+*/
 const operationsGenerator = (0, _kubb_core.defineGenerator)({
 	name: "client",
-	renderer: _kubb_renderer_jsx.jsxRenderer,
 	operations(nodes, ctx) {
-		const { config, resolver, adapter, root } = ctx;
+		const { config, resolver, root } = ctx;
 		const { output, group } = ctx.options;
 		const name = "operations";
 		const file = resolver.resolveFile({
@@ -1308,37 +1542,65 @@ const operationsGenerator = (0, _kubb_core.defineGenerator)({
 		}, {
 			root,
 			output,
-			group
+			group: group ?? void 0
 		});
-		return /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File, {
+		const operationsObject = {};
+		for (const node of nodes) {
+			if (!_kubb_core.ast.isHttpOperationNode(node)) continue;
+			operationsObject[node.operationId] = {
+				path: Url$1.toPath(node.path),
+				method: node.method.toLowerCase()
+			};
+		}
+		return [_kubb_core.ast.createFile({
 			baseName: file.baseName,
 			path: file.path,
 			meta: file.meta,
-			banner: resolver.resolveBanner(adapter.inputNode, {
+			banner: resolver.resolveBanner(ctx.meta, {
 				output,
-				config
+				config,
+				file: {
+					path: file.path,
+					baseName: file.baseName
+				}
 			}),
-			footer: resolver.resolveFooter(adapter.inputNode, {
+			footer: resolver.resolveFooter(ctx.meta, {
 				output,
-				config
+				config,
+				file: {
+					path: file.path,
+					baseName: file.baseName
+				}
 			}),
-			children: /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(Operations, {
+			sources: [_kubb_core.ast.createSource({
 				name,
-				nodes
-			})
-		});
+				isExportable: true,
+				isIndexable: true,
+				nodes: [_kubb_core.ast.createConst({
+					name,
+					export: true,
+					nodes: [_kubb_core.ast.createText(JSON.stringify(operationsObject, void 0, 2))]
+				})]
+			})]
+		})];
 	}
 });
 //#endregion
 //#region src/components/StaticClassClient.tsx
 const declarationPrinter = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declaration" });
 function generateMethod({ node, name, tsResolver, zodResolver, baseURL, dataReturnType, parser, paramsType, paramsCasing, pathParamsType }) {
-	const path = new URLPath(node.path, { casing: paramsCasing });
-	const contentType = node.requestBody?.content?.[0]?.contentType ?? "application/json";
-	const isFormData = contentType === "multipart/form-data";
-	const headers = buildHeaders(contentType, !!(node.parameters.filter((p) => p.in === "header").length > 0 ? tsResolver.resolveHeaderParamsName(node, node.parameters.filter((p) => p.in === "header")[0]) : void 0));
-	const generics = buildGenerics(node, tsResolver);
-	const paramsNode = Client.getParams({
+	if (!_kubb_core.ast.isHttpOperationNode(node)) return "";
+	const { defaultContentType: contentType, isMultipleContentTypes, hasFormData } = getContentTypeInfo(node);
+	const isFormData = !isMultipleContentTypes && contentType === "multipart/form-data";
+	const { header: headerParams } = getOperationParameters(node);
+	const headerParamsName = headerParams.length > 0 ? tsResolver.resolveHeaderParamsName(node, headerParams[0]) : null;
+	const headers = isMultipleContentTypes ? headerParamsName ? ["...headers"] : [] : buildHeaders(contentType, !!headerParamsName);
+	const generics = buildGenerics(node, tsResolver, {
+		dataReturnType,
+		zodResolver,
+		parser
+	});
+	const paramsNode = buildClientParamsNode({
 		paramsType,
 		paramsCasing,
 		pathParamsType,
@@ -1347,31 +1609,47 @@ function generateMethod({ node, name, tsResolver, zodResolver, baseURL, dataRetu
 		isConfigurable: true
 	});
 	const paramsSignature = declarationPrinter.print(paramsNode) ?? "";
+	const { query: queryParams } = getOperationParameters(node);
+	const zodQueryParamsName = zodResolver && resolveQueryParamsParser(parser) === "zod" && queryParams.length > 0 ? zodResolver.resolveQueryParamsName?.(node, queryParams[0]) : null;
 	const clientParams = buildClassClientParams({
 		node,
-		path,
+		url: Url$1.toTemplateString(node.path, { casing: paramsCasing }),
 		baseURL,
 		tsResolver,
 		isFormData,
-		headers
+		isMultipleContentTypes,
+		hasFormData,
+		headers,
+		zodQueryParamsName
 	});
-	const jsdoc = buildJSDoc(getComments(node));
+	const jsdoc = (0, _kubb_ast_utils.buildJSDoc)(buildOperationComments(node, {
+		link: "urlPath",
+		linkPosition: "beforeDeprecated",
+		splitLines: true
+	}));
 	const requestDataLine = buildRequestDataLine({
 		parser,
 		node,
 		zodResolver
 	});
-	const formDataLine = buildFormDataLine(isFormData, !!node.requestBody?.content?.[0]?.schema);
+	const queryParamsLine = buildQueryParamsLine({
+		parser,
+		node,
+		zodResolver
+	});
+	const formDataLine = buildFormDataLine(isFormData || isMultipleContentTypes && hasFormData, !!node.requestBody?.content?.[0]?.schema);
 	const returnStatement = buildReturnStatement({
 		dataReturnType,
 		parser,
 		node,
-		zodResolver
+		zodResolver,
+		tsResolver
 	});
 	return `${jsdoc}  static async ${name}(${paramsSignature}) {\n${[
-		"const { client: request = fetch, ...requestConfig } = mergeConfig(this.#config, config)",
+		`const { client: request = client, ${isMultipleContentTypes ? `contentType = ${(0, _kubb_ast_utils.stringify)(contentType)}, ` : ""}...requestConfig } = mergeConfig(this.#config, config)`,
 		"",
 		requestDataLine,
+		queryParamsLine,
 		formDataLine,
 		`const res = await request<${generics.join(", ")}>(${clientParams.toCall()})`,
 		returnStatement
@@ -1397,56 +1675,49 @@ function StaticClassClient({ name, isExportable = true, isIndexable = true, oper
 		children: [classCode, children]
 	});
 }
-StaticClassClient.getParams = Client.getParams;
 //#endregion
 //#region src/generators/staticClassClientGenerator.tsx
 function resolveTypeImportNames(node, tsResolver) {
+	return resolveOperationTypeNames(node, tsResolver, { order: "body-response-first" });
+}
+function resolveZodImportNames(node, zodResolver, parser) {
+	const { query: queryParams } = getOperationParameters(node);
 	return [
-		node.requestBody?.content?.[0]?.schema ? tsResolver.resolveDataName(node) : void 0,
-		tsResolver.resolveResponseName(node),
-		...node.parameters.filter((p) => p.in === "path").map((p) => tsResolver.resolvePathParamsName(node, p)),
-		...node.parameters.filter((p) => p.in === "query").map((p) => tsResolver.resolveQueryParamsName(node, p)),
-		...node.parameters.filter((p) => p.in === "header").map((p) => tsResolver.resolveHeaderParamsName(node, p)),
-		...node.responses.map((res) => tsResolver.resolveResponseStatusName(node, res.statusCode))
+		resolveResponseParser(parser) === "zod" ? zodResolver.resolveResponseName?.(node) : null,
+		resolveRequestParser(parser) === "zod" && node.requestBody?.content?.[0]?.schema ? zodResolver.resolveDataName?.(node) : null,
+		resolveQueryParamsParser(parser) === "zod" && queryParams.length > 0 ? zodResolver.resolveQueryParamsName?.(node, queryParams[0]) : null
 	].filter((n) => Boolean(n));
 }
-function resolveZodImportNames(node, zodResolver) {
-	return [zodResolver.resolveResponseName?.(node), node.requestBody?.content?.[0]?.schema ? zodResolver.resolveDataName?.(node) : void 0].filter((n) => Boolean(n));
-}
+/**
+* Built-in `operations` generator for `@kubb/plugin-client` when
+* `clientType: 'staticClass'`. Emits one class per tag, with a static method
+* per operation so callers can use `Pet.getPetById(...)` without
+* instantiating the class.
+*/
 const staticClassClientGenerator = (0, _kubb_core.defineGenerator)({
 	name: "staticClassClient",
 	renderer: _kubb_renderer_jsx.jsxRenderer,
 	operations(nodes, ctx) {
-		const { adapter, config, driver, resolver, root } = ctx;
+		const { config, driver, resolver, root } = ctx;
 		const { output, group, dataReturnType, paramsCasing, paramsType, pathParamsType, parser, importPath } = ctx.options;
-		const baseURL = ctx.options.baseURL ?? adapter.inputNode?.meta?.baseURL;
+		const baseURL = ctx.options.baseURL ?? ctx.meta.baseURL;
 		const pluginTs = driver.getPlugin(_kubb_plugin_ts.pluginTsName);
 		if (!pluginTs) return null;
 		const tsResolver = driver.getResolver(_kubb_plugin_ts.pluginTsName);
 		const tsPluginOptions = pluginTs.options;
-		const pluginZod = parser === "zod" ? driver.getPlugin(_kubb_plugin_zod.pluginZodName) : void 0;
-		const zodResolver = pluginZod ? driver.getResolver(_kubb_plugin_zod.pluginZodName) : void 0;
+		const pluginZod = isParserEnabled(parser) ? driver.getPlugin(_kubb_plugin_zod.pluginZodName) : null;
+		const zodResolver = pluginZod ? driver.getResolver(_kubb_plugin_zod.pluginZodName) : null;
 		function buildOperationData(node) {
-			const typeFile = tsResolver.resolveFile({
-				name: node.operationId,
-				extname: ".ts",
-				tag: node.tags[0] ?? "default",
-				path: node.path
-			}, {
+			const typeFile = tsResolver.resolveFile(operationFileEntry(node, node.operationId), {
 				root,
 				output: tsPluginOptions?.output ?? output,
 				group: tsPluginOptions?.group
 			});
-			const zodFile = zodResolver && pluginZod?.options ? zodResolver.resolveFile({
-				name: node.operationId,
-				extname: ".ts",
-				tag: node.tags[0] ?? "default",
-				path: node.path
-			}, {
+			const zodFile = zodResolver && pluginZod?.options ? zodResolver.resolveFile(operationFileEntry(node, node.operationId), {
 				root,
 				output: pluginZod.options?.output ?? output,
-				group: pluginZod.options?.group
-			}) : void 0;
+				group: pluginZod.options?.group ?? void 0
+			}) : null;
 			return {
 				node,
 				name: resolver.resolveName(node.operationId),
@@ -1457,17 +1728,18 @@ const staticClassClientGenerator = (0, _kubb_core.defineGenerator)({
 			};
 		}
 		const controllers = nodes.reduce((acc, operationNode) => {
+			if (!_kubb_core.ast.isHttpOperationNode(operationNode)) return acc;
 			const tag = operationNode.tags[0];
-			const groupName = tag ? group?.name?.({ group: camelCase(tag) }) ?? pascalCase(tag) : "Client";
+			const groupName = tag ? group?.name?.({ group: camelCase(tag) }) ?? resolver.resolveGroupName(tag) : resolver.resolveClassName("Client");
 			if (!tag && !group) {
-				const name = "ApiClient";
+				const name = resolver.resolveClassName("ApiClient");
 				const file = resolver.resolveFile({
 					name,
 					extname: ".ts"
 				}, {
 					root,
 					output,
-					group
+					group: group ?? void 0
 				});
 				const operationData = buildOperationData(operationNode);
 				const previous = acc.find((item) => item.file.path === file.path);
@@ -1477,7 +1749,9 @@ const staticClassClientGenerator = (0, _kubb_core.defineGenerator)({
 					file,
 					operations: [operationData]
 				});
-			} else if (tag) {
+				return acc;
+			}
+			if (tag) {
 				const name = groupName;
 				const file = resolver.resolveFile({
 					name,
@@ -1486,7 +1760,7 @@ const staticClassClientGenerator = (0, _kubb_core.defineGenerator)({
 				}, {
 					root,
 					output,
-					group
+					group: group ?? void 0
 				});
 				const operationData = buildOperationData(operationNode);
 				const previous = acc.find((item) => item.file.path === file.path);
@@ -1521,7 +1795,7 @@ const staticClassClientGenerator = (0, _kubb_core.defineGenerator)({
 			const zodFilesByPath = /* @__PURE__ */ new Map();
 			ops.forEach((op) => {
 				if (!op.zodFile || !zodResolver) return;
-				const names = resolveZodImportNames(op.node, zodResolver);
+				const names = resolveZodImportNames(op.node, zodResolver, parser);
 				if (!zodImportsByFile.has(op.zodFile.path)) zodImportsByFile.set(op.zodFile.path, /* @__PURE__ */ new Set());
 				const imports = zodImportsByFile.get(op.zodFile.path);
 				names.forEach((n) => {
@@ -1536,27 +1810,35 @@ const staticClassClientGenerator = (0, _kubb_core.defineGenerator)({
 		}
 		return /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx_jsx_runtime.Fragment, { children: controllers.map(({ name, file, operations: ops }) => {
 			const { typeImportsByFile, typeFilesByPath } = collectTypeImports(ops);
-			const { zodImportsByFile, zodFilesByPath } = parser === "zod" ? collectZodImports(ops) : {
+			const { zodImportsByFile, zodFilesByPath } = isParserEnabled(parser) ? collectZodImports(ops) : {
 				zodImportsByFile: /* @__PURE__ */ new Map(),
 				zodFilesByPath: /* @__PURE__ */ new Map()
 			};
-			const hasFormData = ops.some((op) => op.node.requestBody?.content?.[0]?.contentType === "multipart/form-data");
+			const hasFormData = ops.some((op) => op.node.requestBody?.content?.some((e) => e.contentType === "multipart/form-data") ?? false);
 			return /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsxs)(_kubb_renderer_jsx.File, {
 				baseName: file.baseName,
 				path: file.path,
 				meta: file.meta,
-				banner: resolver.resolveBanner(adapter.inputNode, {
+				banner: resolver.resolveBanner(ctx.meta, {
 					output,
-					config
+					config,
+					file: {
+						path: file.path,
+						baseName: file.baseName
+					}
 				}),
-				footer: resolver.resolveFooter(adapter.inputNode, {
+				footer: resolver.resolveFooter(ctx.meta, {
 					output,
-					config
+					config,
+					file: {
+						path: file.path,
+						baseName: file.baseName
+					}
 				}),
 				children: [
 					importPath ? /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsxs)(_kubb_renderer_jsx_jsx_runtime.Fragment, { children: [
 						/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Import, {
-							name: "fetch",
+							name: "client",
 							path: importPath
 						}),
 						/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Import, {
@@ -1574,7 +1856,7 @@ const staticClassClientGenerator = (0, _kubb_core.defineGenerator)({
 						})
 					] }) : /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsxs)(_kubb_renderer_jsx_jsx_runtime.Fragment, { children: [
 						/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Import, {
-							name: ["fetch"],
+							name: ["client"],
 							root: file.path,
 							path: node_path.default.resolve(root, ".kubb/client.ts")
 						}),
@@ -1599,6 +1881,11 @@ const staticClassClientGenerator = (0, _kubb_core.defineGenerator)({
 						root: file.path,
 						path: node_path.default.resolve(root, ".kubb/config.ts")
 					}),
+					parser === "zod" && zodResolver && ops.some((op) => op.node.requestBody?.content?.[0]?.schema != null) && /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Import, {
+						name: ["z"],
+						path: "zod",
+						isTypeOnly: true
+					}),
 					Array.from(typeImportsByFile.entries()).map(([filePath, importSet]) => {
 						const typeFile = typeFilesByPath.get(filePath);
 						if (!typeFile) return null;
@@ -1611,7 +1898,7 @@ const staticClassClientGenerator = (0, _kubb_core.defineGenerator)({
 							isTypeOnly: true
 						}, filePath);
 					}),
-					parser === "zod" && Array.from(zodImportsByFile.entries()).map(([filePath, importSet]) => {
+					isParserEnabled(parser) && Array.from(zodImportsByFile.entries()).map(([filePath, importSet]) => {
 						const zodFile = zodFilesByPath.get(filePath);
 						if (!zodFile) return null;
 						const importNames = Array.from(importSet).filter(Boolean);
@@ -1640,64 +1927,95 @@ const staticClassClientGenerator = (0, _kubb_core.defineGenerator)({
 //#endregion
 //#region src/resolvers/resolverClient.ts
 /**
-* Naming convention resolver for client plugin.
+* Default resolver used by `@kubb/plugin-client`. Decides the names and file
+* paths for every generated client function or class. Functions and files use
+* camelCase; classes and tag groups use PascalCase.
 *
-* Provides default naming helpers using camelCase for functions and file paths.
+* @example Resolve client function and class names
+* ```ts
+* import { resolverClient } from '@kubb/plugin-client'
 *
-* @example
-* `resolverClient.default('list pets', 'function')  // → 'listPets'`
+* resolverClient.default('list pets', 'function') // 'listPets'
+* resolverClient.resolveClassName('pet')          // 'Pet'
+* resolverClient.resolveGroupName('pet')          // 'PetClient'
+* resolverClient.resolveUrlName(operationNode)    // 'getShowPetByIdUrl'
+* ```
 */
-const resolverClient = (0, _kubb_core.defineResolver)((ctx) => ({
+const resolverClient = (0, _kubb_core.defineResolver)(() => ({
 	name: "default",
 	pluginName: "plugin-client",
 	default(name, type) {
-		return camelCase(name, { isFile: type === "file" });
+		if (type === "file") return toFilePath(name);
+		return ensureValidVarName(camelCase(name));
 	},
 	resolveName(name) {
-		return ctx.default(name, "function");
+		return this.default(name, "function");
+	},
+	resolvePathName(name, type) {
+		return this.default(name, type);
+	},
+	resolveClassName(name) {
+		return ensureValidVarName(pascalCase(name));
+	},
+	resolveGroupName(name) {
+		return ensureValidVarName(pascalCase(`${name} Client`));
+	},
+	resolveClientPropertyName(name) {
+		return ensureValidVarName(camelCase(name));
+	},
+	resolveUrlName(node) {
+		const name = this.resolveName(node.operationId);
+		return `get${name.charAt(0).toUpperCase()}${name.slice(1)}Url`;
 	}
 }));
 //#endregion
 //#region src/plugin.ts
 /**
-* Canonical plugin name for `@kubb/plugin-client`, used in driver lookups and warnings.
+* Canonical plugin name for `@kubb/plugin-client`. Used for driver lookups and
+* cross-plugin dependency references.
 */
 const pluginClientName = "plugin-client";
 /**
-* Generates type-safe HTTP client functions or classes from an OpenAPI specification.
-* Creates client APIs by walking operations and delegating to generators.
-* Writes barrel files based on the configured `barrelType`.
+* Generates one HTTP client function per OpenAPI operation. Each function has
+* typed path params, query params, body, and response, so callers use the API
+* like any other typed function. Ships with `axios` and `fetch` runtimes; bring
+* your own by setting `importPath`.
 *
-* @example Client generator
+* @example
 * ```ts
-* import pluginClient from '@kubb/plugin-client'
+* import { defineConfig } from 'kubb'
+* import { pluginTs } from '@kubb/plugin-ts'
+* import { pluginClient } from '@kubb/plugin-client'
+*
 * export default defineConfig({
-*   plugins: [pluginClient({ output: { path: 'clients' } })]
+*   input: { path: './petStore.yaml' },
+*   output: { path: './src/gen' },
+*   plugins: [
+*     pluginTs(),
+*     pluginClient({
+*       output: { path: './clients' },
+*       client: 'fetch',
+*     }),
+*   ],
 * })
 * ```
 */
 const pluginClient = (0, _kubb_core.definePlugin)((options) => {
 	const { output = {
 		path: "clients",
-		barrelType: "named"
-	}, group, exclude = [], include, override = [], urlType = false, dataReturnType = "data", paramsType = "inline", pathParamsType = paramsType === "object" ? "object" : options.pathParamsType || "inline", operations = false, paramsCasing, clientType = options.sdk ? "class" : "function", parser = "client", client = "axios", importPath, bundle = false, sdk, baseURL, resolver: userResolver, transformer: userTransformer } = options;
+		barrel: { type: "named" }
+	}, group, exclude = [], include, override = [], urlType = false, dataReturnType = "data", paramsType = "inline", pathParamsType = paramsType === "object" ? "object" : options.pathParamsType || "inline", operations = false, paramsCasing, clientType = options.sdk ? "class" : "function", parser = false, client = "axios", importPath, bundle = false, sdk, baseURL, resolver: userResolver, transformer: userTransformer } = options;
 	const resolvedImportPath = importPath ?? (!bundle ? `@kubb/plugin-client/clients/${client}` : void 0);
 	const selectedGenerators = options.generators ?? [
 		clientType === "staticClass" ? staticClassClientGenerator : clientType === "class" ? classClientGenerator : clientGenerator,
-		group && clientType === "function" ? groupedClientGenerator : void 0,
-		operations ? operationsGenerator : void 0
+		group && clientType === "function" ? groupedClientGenerator : null,
+		operations ? operationsGenerator : null
 	].filter((x) => Boolean(x));
-	const groupConfig = group ? {
-		...group,
-		name: group.name ? group.name : (ctx) => {
-			if (group.type === "path") return `${ctx.group.split("/")[1]}`;
-			return `${camelCase(ctx.group)}Controller`;
-		}
-	} : void 0;
+	const groupConfig = createGroupConfig(group);
 	return {
 		name: pluginClientName,
 		options,
-		dependencies: [_kubb_plugin_ts.pluginTsName, parser === "zod" ? _kubb_plugin_zod.pluginZodName : void 0].filter(Boolean),
+		dependencies: [_kubb_plugin_ts.pluginTsName, isParserEnabled(parser) ? _kubb_plugin_zod.pluginZodName : null].filter((dependency) => Boolean(dependency)),
 		hooks: { "kubb:plugin:setup"(ctx) {
 			const resolver = userResolver ? {
 				...resolverClient,
@@ -1760,9 +2078,13 @@ exports.classClientGenerator = classClientGenerator;
 exports.clientGenerator = clientGenerator;
 exports.default = pluginClient;
 exports.groupedClientGenerator = groupedClientGenerator;
+exports.isParserEnabled = isParserEnabled;
 exports.operationsGenerator = operationsGenerator;
 exports.pluginClient = pluginClient;
 exports.pluginClientName = pluginClientName;
+exports.resolveQueryParamsParser = resolveQueryParamsParser;
+exports.resolveRequestParser = resolveRequestParser;
+exports.resolveResponseParser = resolveResponseParser;
 exports.resolverClient = resolverClient;
 exports.staticClassClientGenerator = staticClassClientGenerator;