@kubb/plugin-swr 5.0.0-beta.84 → 5.0.0-beta.86

package/dist/index.cjs

@@ -28,10 +28,10 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-let node_path = require("node:path");
-node_path = __toESM(node_path, 1);
 let kubb_kit = require("kubb/kit");
 let _kubb_plugin_ts = require("@kubb/plugin-ts");
+let node_path = require("node:path");
+node_path = __toESM(node_path, 1);
 let kubb_jsx = require("kubb/jsx");
 let kubb_jsx_jsx_runtime = require("kubb/jsx/jsx-runtime");
 //#region ../../internals/utils/src/casing.ts
@@ -61,31 +61,6 @@ function camelCase(text, { prefix = "", suffix = "" } = {}) {
 	return toCamelOrPascal(`${prefix} ${text} ${suffix}`, false);
 }
 //#endregion
-//#region ../../internals/utils/src/fs.ts
-/**
-* 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 `/`.
-*
-* 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 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
 /**
 * JavaScript and Java reserved words.
@@ -341,13 +316,13 @@ function dedupeByCasedName(params) {
 //#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
+* `resolver.file`: 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 })
+* resolver.file(operationFileEntry(node, node.operationId), { root, output, group })
 * ```
 */
 function operationFileEntry(node, name, extname = ".ts") {
@@ -485,10 +460,10 @@ 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));
+	return node.responses.filter((response) => isErrorStatusCode(response.statusCode)).map((response) => resolver.response.status(node, response.statusCode));
 }
 function resolveStatusCodeNames(node, resolver) {
-	return node.responses.map((response) => resolver.resolveResponseStatusName(node, response.statusCode));
+	return node.responses.map((response) => resolver.response.status(node, response.statusCode));
 }
 const typeNamesByResolver = /* @__PURE__ */ new WeakMap();
 function resolveOperationTypeNames(node, resolver, options = {}) {
@@ -505,11 +480,11 @@ function resolveOperationTypeNames(node, resolver, options = {}) {
 	const responseStatusNames = options.responseStatusNames === "error" ? resolveErrorNames(node, resolver) : options.responseStatusNames === false ? [] : resolveStatusCodeNames(node, resolver);
 	const exclude = new Set(options.exclude ?? []);
 	const paramNames = options.includeParams === false ? [] : [
-		...path.map((param) => resolver.resolvePathParamsName(node, param)),
-		...query.map((param) => resolver.resolveQueryParamsName(node, param)),
-		...header.map((param) => resolver.resolveHeaderParamsName(node, param))
+		...path.map((param) => resolver.param.path(node, param)),
+		...query.map((param) => resolver.param.query(node, param)),
+		...header.map((param) => resolver.param.headers(node, param))
 	];
-	const bodyAndResponseNames = [node.requestBody?.content?.[0]?.schema ? resolver.resolveDataName(node) : null, resolver.resolveResponseName(node)];
+	const bodyAndResponseNames = [node.requestBody?.content?.[0]?.schema ? resolver.response.body(node) : null, resolver.response.response(node)];
 	const result = (options.order === "body-response-first" ? [
 		...bodyAndResponseNames,
 		...paramNames,
@@ -633,15 +608,15 @@ function resolveClientOperation(options) {
 	const { clientPlugin, driver, node, root, output } = options;
 	if (!clientPlugin) return null;
 	const resolver = driver.getResolver(clientPlugin.pluginName);
-	if (!resolver) return null;
 	const plugin = driver.getPlugin(clientPlugin.pluginName);
-	const file = resolver.resolveFile(operationFileEntry(node, node.operationId), {
+	const file = resolver.file({
+		...operationFileEntry(node, node.operationId),
 		root,
 		output: plugin?.options?.output ?? output,
 		group: plugin?.options?.group ?? void 0
 	});
 	return {
-		name: resolver.resolveName(node.operationId),
+		name: resolver.name(node.operationId),
 		path: file.path,
 		clientPath: node_path.default.resolve(root, ".kubb/client.ts")
 	};
@@ -689,12 +664,12 @@ const requestGroupOrder = [
 /**
 * Builds the grouped `{ path, query, body, headers }` parameter that mirrors the client
 * function signature. Only the groups the operation carries are emitted, typed from the
-* operation's `RequestConfig`. `keys` narrows the emitted groups, used by the query key which
+* operation's `Options`. `keys` narrows the emitted groups, used by the query key which
 * never carries `headers`.
 *
-* By default the whole group is typed as the single `RequestConfig` reference. When
+* By default the whole group is typed as the single `Options` reference. When
 * `memberTypeWrapper` is set, each group is emitted as its own member typed from the matching
-* `RequestConfig['<group>']` slice and wrapped, used by vue-query to apply
+* `Options['<group>']` slice and wrapped, used by vue-query to apply
 * `MaybeRefOrGetter` per group.
 */
 function buildGroupedRequestParam(node, options) {
@@ -709,13 +684,13 @@ function buildGroupedRequestParam(node, options) {
 		headers: hasRequiredHeader
 	};
 	const isOptional = names.every((name) => !requiredByGroup[name]);
-	const requestConfigName = resolver.resolveRequestConfigName(node);
+	const optionsName = resolver.response.options(node);
 	const omittedKeys = requestGroupOrder.filter((key) => !keys.includes(key));
-	const requestConfigType = omittedKeys.length > 0 ? `Omit<${requestConfigName}, ${omittedKeys.map((key) => `'${key}'`).join(" | ")}>` : requestConfigName;
+	const optionsType = omittedKeys.length > 0 ? `Omit<${optionsName}, ${omittedKeys.map((key) => `'${key}'`).join(" | ")}>` : optionsName;
 	if (memberTypeWrapper) {
 		const members = names.map((name) => ({
 			name,
-			type: memberTypeWrapper(`${requestConfigType}['${name}']`),
+			type: memberTypeWrapper(`${optionsType}['${name}']`),
 			optional: !requiredByGroup[name]
 		}));
 		return (0, _kubb_plugin_ts.createFunctionParameter)({
@@ -727,7 +702,7 @@ function buildGroupedRequestParam(node, options) {
 	}
 	return (0, _kubb_plugin_ts.createFunctionParameter)({
 		name: (0, _kubb_plugin_ts.createObjectBindingPattern)({ elements: names.map((name) => ({ name })) }),
-		type: requestConfigType,
+		type: optionsType,
 		optional: false,
 		...isOptional ? { default: "{}" } : {}
 	});
@@ -773,7 +748,7 @@ function buildClientCall(node, options) {
 }
 /**
 * Build QueryKey params as the grouped `{ path, query, body }` object (NO headers, NO config),
-* typed from the operation's `RequestConfig` minus `url`. The query key transformer reads the
+* typed from the operation's `Options` minus `url`. The query key transformer reads the
 * grouped `path`/`query`/`body` bindings.
 */
 function buildQueryKeyParams(node, options) {
@@ -835,7 +810,7 @@ const declarationPrinter$2 = (0, _kubb_plugin_ts.functionPrinter)({ mode: "decla
 const callPrinter$1 = (0, _kubb_plugin_ts.functionPrinter)({ mode: "call" });
 function buildMutationParamsNode(node, options) {
 	const { mutationKeyTypeName, mutationArgTypeName, resolver } = options;
-	const responseName = resolver.resolveResponseName(node);
+	const responseName = resolver.response.response(node);
 	const errorNames = resolveErrorNames(node, resolver);
 	return (0, _kubb_plugin_ts.createFunctionParameters)({ params: [(0, _kubb_plugin_ts.createFunctionParameter)({
 		name: "options",
@@ -848,14 +823,14 @@ function buildMutationParamsNode(node, options) {
 	})] });
 }
 function Mutation({ name, clientName, mutationKeyName, mutationKeyTypeName, mutationArgTypeName, node, tsResolver }) {
-	const responseName = tsResolver.resolveResponseName(node);
+	const responseName = tsResolver.response.response(node);
 	const errorNames = resolveErrorNames(node, tsResolver);
 	const TData = responseName;
 	const TError = `ResponseErrorConfig<${errorNames.length > 0 ? errorNames.join(" | ") : "Error"}>`;
 	const groupedParam = buildGroupedRequestParam(node, { resolver: tsResolver });
 	const hasMutationParams = groupedParam !== null;
 	const groupedParamsNode = (0, _kubb_plugin_ts.createFunctionParameters)({ params: groupedParam ? [groupedParam] : [] });
-	const argTypeBody = hasMutationParams ? tsResolver.resolveRequestConfigName(node) : "";
+	const argTypeBody = hasMutationParams ? tsResolver.response.options(node) : "";
 	const argBindingStr = hasMutationParams ? callPrinter$1.print(groupedParamsNode) ?? "" : "";
 	const mutationFnBody = `const { data } = await ${buildClientCall(node, {
 		clientName,
@@ -965,7 +940,7 @@ const declarationPrinter = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declara
 const callPrinter = (0, _kubb_plugin_ts.functionPrinter)({ mode: "call" });
 function buildQueryParamsNode(node, options) {
 	const { resolver } = options;
-	const responseName = resolver.resolveResponseName(node);
+	const responseName = resolver.response.response(node);
 	const errorNames = resolveErrorNames(node, resolver);
 	const optionsParam = (0, _kubb_plugin_ts.createFunctionParameter)({
 		name: "options",
@@ -980,7 +955,7 @@ function buildQueryParamsNode(node, options) {
 	return (0, _kubb_plugin_ts.createFunctionParameters)({ params: [buildGroupedRequestParam(node, { resolver }), optionsParam].filter((param) => param !== null) });
 }
 function Query({ name, queryKeyTypeName, queryOptionsName, queryKeyName, node, tsResolver }) {
-	const responseName = tsResolver.resolveResponseName(node);
+	const responseName = tsResolver.response.response(node);
 	const errorNames = resolveErrorNames(node, tsResolver);
 	const generics = [
 		responseName,
@@ -1052,33 +1027,31 @@ const mutationGenerator = (0, kubb_kit.defineGenerator)({
 			output
 		});
 		if (!contractOp) return null;
-		const mutationHookName = resolver.resolveMutationName(node);
-		const mutationKeyName = resolver.resolveMutationKeyName(node);
-		const mutationKeyTypeName = resolver.resolveMutationKeyTypeName(node);
-		const mutationArgTypeName = resolver.resolveMutationArgTypeName(node);
+		const mutationHookName = resolver.mutation.name(node);
+		const mutationKeyName = resolver.mutation.keyName(node);
+		const mutationKeyTypeName = resolver.mutation.keyTypeName(node);
+		const mutationArgTypeName = resolver.mutation.argTypeName(node);
 		const meta = {
-			file: resolver.resolveFile({
+			file: resolver.file({
 				name: mutationHookName,
 				extname: ".ts",
 				tag: node.tags[0] ?? "default",
-				path: node.path
-			}, {
+				path: node.path,
 				root,
 				output,
 				group
 			}),
-			fileTs: tsResolver.resolveFile({
+			fileTs: tsResolver.file({
 				name: node.operationId,
 				extname: ".ts",
 				tag: node.tags[0] ?? "default",
-				path: node.path
-			}, {
+				path: node.path,
 				root,
 				output: pluginTs.options?.output ?? output,
 				group: pluginTs.options?.group
 			})
 		};
-		const importedTypeNames = [tsResolver.resolveRequestConfigName(node), ...resolveOperationTypeNames(node, tsResolver, {
+		const importedTypeNames = [tsResolver.response.options(node), ...resolveOperationTypeNames(node, tsResolver, {
 			order: "body-response-first",
 			includeParams: false
 		})].filter((name) => Boolean(name));
@@ -1087,7 +1060,7 @@ const mutationGenerator = (0, kubb_kit.defineGenerator)({
 			baseName: meta.file.baseName,
 			path: meta.file.path,
 			meta: meta.file.meta,
-			banner: resolver.resolveBanner(ctx.meta, {
+			banner: resolver.default.banner(ctx.meta, {
 				output,
 				config,
 				file: {
@@ -1095,7 +1068,7 @@ const mutationGenerator = (0, kubb_kit.defineGenerator)({
 					baseName: meta.file.baseName
 				}
 			}),
-			footer: resolver.resolveFooter(ctx.meta, {
+			footer: resolver.default.footer(ctx.meta, {
 				output,
 				config,
 				file: {
@@ -1180,33 +1153,31 @@ const queryGenerator = (0, kubb_kit.defineGenerator)({
 			output
 		});
 		if (!contractOp) return null;
-		const queryName = resolver.resolveQueryName(node);
-		const queryOptionsName = resolver.resolveQueryOptionsName(node);
-		const queryKeyName = resolver.resolveQueryKeyName(node);
-		const queryKeyTypeName = resolver.resolveQueryKeyTypeName(node);
+		const queryName = resolver.query.name(node);
+		const queryOptionsName = resolver.query.optionsName(node);
+		const queryKeyName = resolver.query.keyName(node);
+		const queryKeyTypeName = resolver.query.keyTypeName(node);
 		const meta = {
-			file: resolver.resolveFile({
+			file: resolver.file({
 				name: queryName,
 				extname: ".ts",
 				tag: node.tags[0] ?? "default",
-				path: node.path
-			}, {
+				path: node.path,
 				root,
 				output,
 				group
 			}),
-			fileTs: tsResolver.resolveFile({
+			fileTs: tsResolver.file({
 				name: node.operationId,
 				extname: ".ts",
 				tag: node.tags[0] ?? "default",
-				path: node.path
-			}, {
+				path: node.path,
 				root,
 				output: pluginTs.options?.output ?? output,
 				group: pluginTs.options?.group
 			})
 		};
-		const importedTypeNames = [tsResolver.resolveRequestConfigName(node), ...resolveOperationTypeNames(node, tsResolver, {
+		const importedTypeNames = [tsResolver.response.options(node), ...resolveOperationTypeNames(node, tsResolver, {
 			exclude: [queryKeyTypeName],
 			order: "body-response-first",
 			includeParams: false
@@ -1216,7 +1187,7 @@ const queryGenerator = (0, kubb_kit.defineGenerator)({
 			baseName: meta.file.baseName,
 			path: meta.file.path,
 			meta: meta.file.meta,
-			banner: resolver.resolveBanner(ctx.meta, {
+			banner: resolver.default.banner(ctx.meta, {
 				output,
 				config,
 				file: {
@@ -1224,7 +1195,7 @@ const queryGenerator = (0, kubb_kit.defineGenerator)({
 					baseName: meta.file.baseName
 				}
 			}),
-			footer: resolver.resolveFooter(ctx.meta, {
+			footer: resolver.default.footer(ctx.meta, {
 				output,
 				config,
 				file: {
@@ -1292,53 +1263,55 @@ function capitalize(name) {
 	return `${name.charAt(0).toUpperCase()}${name.slice(1)}`;
 }
 /**
-* Naming convention resolver for the SWR plugin.
+* Default resolver used by `@kubb/plugin-swr`. Decides the names and file paths for every generated
+* SWR hook (`useFoo`, `useFooMutation`) and its companion helpers (`fooQueryKey`, `fooQueryOptions`,
+* `fooMutationKey`).
 *
-* Provides default naming helpers using camelCase for functions and file paths.
+* Functions and files use the built-in camelCase casing; hooks get the `use` prefix.
 *
-* @example
-* `resolverSwr.default('list pets', 'function')  // → 'listPets'`
+* @example Resolve hook and helper names
+* ```ts
+* import { resolverSwr } from '@kubb/plugin-swr'
+*
+* resolverSwr.query.name(operationNode)       // 'useGetPetById'
+* resolverSwr.query.keyName(operationNode)     // 'getPetByIdQueryKey'
+* resolverSwr.mutation.name(operationNode)     // 'useUpdatePet'
+* ```
 */
-const resolverSwr = (0, kubb_kit.defineResolver)(() => ({
-	name: "default",
+const resolverSwr = (0, kubb_kit.createResolver)({
 	pluginName: "plugin-swr",
-	default(name, type) {
-		return type === "file" ? toFilePath(name) : camelCase(name);
-	},
-	resolveName(name) {
-		return this.default(name, "function");
-	},
-	resolvePathName(name, type) {
-		return this.default(name, type);
-	},
-	resolveQueryName(node) {
-		return `use${capitalize(this.resolveName(node.operationId))}`;
-	},
-	resolveMutationName(node) {
-		return `use${capitalize(this.resolveName(node.operationId))}`;
-	},
-	resolveQueryOptionsName(node) {
-		return `${this.resolveName(node.operationId)}QueryOptions`;
-	},
-	resolveQueryKeyName(node) {
-		return `${this.resolveName(node.operationId)}QueryKey`;
-	},
-	resolveMutationKeyName(node) {
-		return `${this.resolveName(node.operationId)}MutationKey`;
-	},
-	resolveQueryKeyTypeName(node) {
-		return `${capitalize(this.resolveName(node.operationId))}QueryKey`;
-	},
-	resolveMutationKeyTypeName(node) {
-		return `${capitalize(this.resolveName(node.operationId))}MutationKey`;
-	},
-	resolveMutationArgTypeName(node) {
-		return `${capitalize(this.resolveName(node.operationId))}MutationArg`;
+	query: {
+		name(node) {
+			return `use${capitalize(this.name(node.operationId))}`;
+		},
+		optionsName(node) {
+			return `${this.name(node.operationId)}QueryOptions`;
+		},
+		keyName(node) {
+			return `${this.name(node.operationId)}QueryKey`;
+		},
+		keyTypeName(node) {
+			return `${capitalize(this.name(node.operationId))}QueryKey`;
+		},
+		clientName(node) {
+			return this.name(node.operationId);
+		}
 	},
-	resolveClientName(node) {
-		return this.resolveName(node.operationId);
+	mutation: {
+		name(node) {
+			return `use${capitalize(this.name(node.operationId))}`;
+		},
+		keyName(node) {
+			return `${this.name(node.operationId)}MutationKey`;
+		},
+		keyTypeName(node) {
+			return `${capitalize(this.name(node.operationId))}MutationKey`;
+		},
+		argTypeName(node) {
+			return `${capitalize(this.name(node.operationId))}MutationArg`;
+		}
 	}
-}));
+});
 //#endregion
 //#region src/plugin.ts
 /**
@@ -1379,10 +1352,7 @@ const pluginSwr = (0, kubb_kit.definePlugin)((options) => {
 		options,
 		dependencies: [_kubb_plugin_ts.pluginTsName],
 		hooks: { "kubb:plugin:setup"(ctx) {
-			const resolver = userResolver ? {
-				...resolverSwr,
-				...userResolver
-			} : resolverSwr;
+			const resolver = userResolver ? kubb_kit.Resolver.merge(resolverSwr, userResolver) : resolverSwr;
 			const resolvedClient = resolveClient({
 				client,
 				pluginNames: (ctx.config.plugins ?? []).map((p) => p.name).filter((name) => Boolean(name))