@kubb/plugin-vue-query 5.0.0-beta.4 → 5.0.0-beta.56

package/dist/index.js

@@ -1,56 +1,190 @@
-import "./chunk--u3MIqq1.js";
-import { c as MutationKey, l as camelCase, o as QueryKey } from "./components-D1UhYFgY.js";
-import { n as mutationGenerator, r as infiniteQueryGenerator, t as queryGenerator } from "./generators-CbnIVBgY.js";
+import "./chunk-C0LytTxp.js";
+import { m as camelCase, s as queryKeyTransformer, u as mutationKeyTransformer } from "./components-B79Gljyl.js";
+import { n as mutationGenerator, r as infiniteQueryGenerator, t as queryGenerator } from "./generators-D95ddIFV.js";
 import path from "node:path";
 import { ast, definePlugin, defineResolver } from "@kubb/core";
-import { pluginClientName } from "@kubb/plugin-client";
+import { isParserEnabled, pluginClientName } from "@kubb/plugin-client";
 import { source } from "@kubb/plugin-client/templates/clients/axios.source";
 import { source as source$1 } from "@kubb/plugin-client/templates/clients/fetch.source";
 import { source as source$2 } from "@kubb/plugin-client/templates/config.source";
 import { pluginTsName } from "@kubb/plugin-ts";
 import { pluginZodName } from "@kubb/plugin-zod";
+//#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/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 src/resolvers/resolverVueQuery.ts
+function capitalize(name) {
+	return `${name.charAt(0).toUpperCase()}${name.slice(1)}`;
+}
 /**
-* Naming convention resolver for Vue Query plugin.
+* Default resolver used by `@kubb/plugin-vue-query`. Decides the names and
+* file paths for every generated TanStack Query composable (`useFooQuery`,
+* `useFooMutation`, `useFooInfiniteQuery`) and its companion helpers.
+*
+* Functions and files use camelCase; composables get the `use` prefix.
 *
-* Provides default naming helpers using camelCase for functions and file paths.
+* @example Resolve composable and helper names
+* ```ts
+* import { resolverVueQuery } from '@kubb/plugin-vue-query'
+*
+* resolverVueQuery.resolveQueryName(operationNode)       // 'useGetPetById'
+* resolverVueQuery.resolveQueryKeyName(operationNode)    // 'getPetByIdQueryKey'
+* resolverVueQuery.resolveQueryOptionsName(operationNode) // 'getPetByIdQueryOptions'
+* ```
 */
-const resolverVueQuery = defineResolver((ctx) => ({
+const resolverVueQuery = defineResolver(() => ({
 	name: "default",
 	pluginName: "plugin-vue-query",
 	default(name, type) {
-		return camelCase(name, { isFile: type === "file" });
+		return type === "file" ? toFilePath(name) : camelCase(name);
 	},
 	resolveName(name) {
-		return ctx.default(name, "function");
+		return this.default(name, "function");
+	},
+	resolvePathName(name, type) {
+		return this.default(name, type);
+	},
+	resolveQueryName(node) {
+		return `use${capitalize(this.resolveName(node.operationId))}`;
+	},
+	resolveInfiniteQueryName(node) {
+		return `use${capitalize(this.resolveName(node.operationId))}Infinite`;
+	},
+	resolveMutationName(node) {
+		return `use${capitalize(this.resolveName(node.operationId))}`;
+	},
+	resolveQueryOptionsName(node) {
+		return `${this.resolveName(node.operationId)}QueryOptions`;
+	},
+	resolveInfiniteQueryOptionsName(node) {
+		return `${this.resolveName(node.operationId)}InfiniteQueryOptions`;
+	},
+	resolveQueryKeyName(node) {
+		return `${this.resolveName(node.operationId)}QueryKey`;
+	},
+	resolveInfiniteQueryKeyName(node) {
+		return `${this.resolveName(node.operationId)}InfiniteQueryKey`;
+	},
+	resolveMutationKeyName(node) {
+		return `${this.resolveName(node.operationId)}MutationKey`;
+	},
+	resolveQueryKeyTypeName(node) {
+		return `${capitalize(this.resolveName(node.operationId))}QueryKey`;
+	},
+	resolveInfiniteQueryKeyTypeName(node) {
+		return `${capitalize(this.resolveName(node.operationId))}InfiniteQueryKey`;
+	},
+	resolveMutationTypeName(node) {
+		return capitalize(this.resolveName(node.operationId));
+	},
+	resolveClientName(node) {
+		return this.resolveName(node.operationId);
+	},
+	resolveInfiniteClientName(node) {
+		return `${this.resolveName(node.operationId)}Infinite`;
 	}
 }));
 //#endregion
 //#region src/plugin.ts
+/**
+* Canonical plugin name for `@kubb/plugin-vue-query`. Used for driver lookups
+* and cross-plugin dependency references.
+*/
 const pluginVueQueryName = "plugin-vue-query";
+/**
+* Generates one TanStack Query composable per OpenAPI operation for Vue's
+* Composition API. Queries become `useFooQuery` (and optionally
+* `useFooInfiniteQuery`); mutations become `useFooMutation`. Each composable
+* is fully typed end to end.
+*
+* @example
+* ```ts
+* import { defineConfig } from 'kubb'
+* import { pluginTs } from '@kubb/plugin-ts'
+* import { pluginVueQuery } from '@kubb/plugin-vue-query'
+*
+* export default defineConfig({
+*   input: { path: './petStore.yaml' },
+*   output: { path: './src/gen' },
+*   plugins: [
+*     pluginTs(),
+*     pluginVueQuery({
+*       output: { path: './hooks' },
+*     }),
+*   ],
+* })
+* ```
+*/
 const pluginVueQuery = definePlugin((options) => {
 	const { output = {
 		path: "hooks",
-		barrelType: "named"
-	}, group, exclude = [], include, override = [], parser = "client", infinite = false, transformers = {}, paramsType = "inline", pathParamsType = paramsType === "object" ? "object" : options.pathParamsType || "inline", mutation = {}, query = {}, mutationKey = MutationKey.getTransformer, queryKey = QueryKey.getTransformer, paramsCasing, client, resolver: userResolver, transformer: userTransformer, generators: userGenerators = [] } = options;
+		barrel: { type: "named" }
+	}, group, exclude = [], include, override = [], parser = false, infinite = false, paramsType = "inline", pathParamsType = paramsType === "object" ? "object" : options.pathParamsType || "inline", mutation = {}, query = {}, mutationKey = mutationKeyTransformer, queryKey = queryKeyTransformer, paramsCasing, client, resolver: userResolver, transformer: userTransformer, generators: userGenerators = [] } = options;
 	const clientName = client?.client ?? "axios";
 	const clientImportPath = client?.importPath ?? (!client?.bundle ? `@kubb/plugin-client/clients/${clientName}` : void 0);
 	const selectedGenerators = options.generators ?? [
 		queryGenerator,
 		infiniteQueryGenerator,
 		mutationGenerator
-	].filter(Boolean);
-	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;
+	].filter((generator) => Boolean(generator));
+	const groupConfig = createGroupConfig(group);
 	return {
 		name: pluginVueQueryName,
 		options,
-		dependencies: [pluginTsName, parser === "zod" ? pluginZodName : void 0].filter(Boolean),
+		dependencies: [pluginTsName, isParserEnabled(parser) ? pluginZodName : void 0].filter((dependency) => Boolean(dependency)),
 		hooks: { "kubb:plugin:setup"(ctx) {
 			const resolver = userResolver ? {
 				...resolverVueQuery,
@@ -58,7 +192,6 @@ const pluginVueQuery = definePlugin((options) => {
 			} : resolverVueQuery;
 			ctx.setOptions({
 				output,
-				transformers,
 				client: {
 					bundle: client?.bundle,
 					baseURL: client?.baseURL,
@@ -88,9 +221,9 @@ const pluginVueQuery = definePlugin((options) => {
 				infinite: infinite ? {
 					queryParam: "id",
 					initialPageParam: 0,
-					cursorParam: void 0,
-					nextParam: void 0,
-					previousParam: void 0,
+					cursorParam: null,
+					nextParam: null,
+					previousParam: null,
 					...infinite
 				} : false,
 				parser,
@@ -110,10 +243,10 @@ const pluginVueQuery = definePlugin((options) => {
 			const root = path.resolve(ctx.config.root, ctx.config.output.path);
 			const hasClientPlugin = !!ctx.config.plugins?.some((p) => p.name === pluginClientName);
 			if (client?.bundle && !hasClientPlugin && !clientImportPath) ctx.injectFile({
-				baseName: "fetch.ts",
-				path: path.resolve(root, ".kubb/fetch.ts"),
+				baseName: "client.ts",
+				path: path.resolve(root, ".kubb/client.ts"),
 				sources: [ast.createSource({
-					name: "fetch",
+					name: "client",
 					nodes: [ast.createText(clientName === "fetch" ? source$1 : source)],
 					isExportable: true,
 					isIndexable: true

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["fetchClientSource","axiosClientSource","configSource"],"sources":["../src/resolvers/resolverVueQuery.ts","../src/plugin.ts"],"sourcesContent":["import { camelCase } from '@internals/utils'\nimport { defineResolver } from '@kubb/core'\nimport type { PluginVueQuery } from '../types.ts'\n\n/**\n * Naming convention resolver for Vue Query plugin.\n *\n * Provides default naming helpers using camelCase for functions and file paths.\n */\nexport const resolverVueQuery = defineResolver<PluginVueQuery>((ctx) => ({\n  name: 'default',\n  pluginName: 'plugin-vue-query',\n  default(name, type) {\n    return camelCase(name, { isFile: type === 'file' })\n  },\n  resolveName(name) {\n    return ctx.default(name, 'function')\n  },\n}))\n","import path from 'node:path'\nimport { camelCase } from '@internals/utils'\nimport { ast, definePlugin, type Group } from '@kubb/core'\nimport { pluginClientName } from '@kubb/plugin-client'\nimport { source as axiosClientSource } from '@kubb/plugin-client/templates/clients/axios.source'\nimport { source as fetchClientSource } from '@kubb/plugin-client/templates/clients/fetch.source'\nimport { source as configSource } from '@kubb/plugin-client/templates/config.source'\nimport { pluginTsName } from '@kubb/plugin-ts'\nimport { pluginZodName } from '@kubb/plugin-zod'\nimport { MutationKey } from './components/MutationKey.tsx'\nimport { QueryKey } from './components/QueryKey.tsx'\nimport { infiniteQueryGenerator, mutationGenerator, queryGenerator } from './generators'\nimport { resolverVueQuery } from './resolvers/resolverVueQuery.ts'\nimport type { PluginVueQuery } from './types.ts'\n\nexport const pluginVueQueryName = 'plugin-vue-query' satisfies PluginVueQuery['name']\n\nexport const pluginVueQuery = definePlugin<PluginVueQuery>((options) => {\n  const {\n    output = { path: 'hooks', barrelType: 'named' },\n    group,\n    exclude = [],\n    include,\n    override = [],\n    parser = 'client',\n    infinite = false,\n    transformers = {},\n    paramsType = 'inline',\n    pathParamsType = paramsType === 'object' ? 'object' : options.pathParamsType || 'inline',\n    mutation = {},\n    query = {},\n    mutationKey = MutationKey.getTransformer,\n    queryKey = QueryKey.getTransformer,\n    paramsCasing,\n    client,\n    resolver: userResolver,\n    transformer: userTransformer,\n    generators: userGenerators = [],\n  } = options\n\n  const clientName = client?.client ?? 'axios'\n  const clientImportPath = client?.importPath ?? (!client?.bundle ? `@kubb/plugin-client/clients/${clientName}` : undefined)\n\n  const selectedGenerators = options.generators ?? [queryGenerator, infiniteQueryGenerator, mutationGenerator].filter(Boolean)\n\n  const groupConfig = group\n    ? ({\n        ...group,\n        name: group.name\n          ? group.name\n          : (ctx: { group: string }) => {\n              if (group.type === 'path') {\n                return `${ctx.group.split('/')[1]}`\n              }\n              return `${camelCase(ctx.group)}Controller`\n            },\n      } satisfies Group)\n    : undefined\n\n  return {\n    name: pluginVueQueryName,\n    options,\n    dependencies: [pluginTsName, parser === 'zod' ? pluginZodName : undefined].filter(Boolean),\n    hooks: {\n      'kubb:plugin:setup'(ctx) {\n        const resolver = userResolver ? { ...resolverVueQuery, ...userResolver } : resolverVueQuery\n\n        ctx.setOptions({\n          output,\n          transformers,\n          client: {\n            bundle: client?.bundle,\n            baseURL: client?.baseURL,\n            client: clientName,\n            clientType: client?.clientType ?? 'function',\n            importPath: clientImportPath,\n            dataReturnType: client?.dataReturnType ?? 'data',\n            paramsCasing,\n          },\n          queryKey,\n          query:\n            query === false\n              ? false\n              : {\n                  importPath: '@tanstack/vue-query',\n                  methods: ['get'],\n                  ...query,\n                },\n          mutationKey,\n          mutation:\n            mutation === false\n              ? false\n              : {\n                  importPath: '@tanstack/vue-query',\n                  methods: ['post', 'put', 'patch', 'delete'],\n                  ...mutation,\n                },\n          infinite: infinite\n            ? {\n                queryParam: 'id',\n                initialPageParam: 0,\n                cursorParam: undefined,\n                nextParam: undefined,\n                previousParam: undefined,\n                ...infinite,\n              }\n            : false,\n          parser,\n          paramsType,\n          pathParamsType,\n          paramsCasing,\n          group: groupConfig,\n          exclude,\n          include,\n          override,\n          resolver,\n        })\n        ctx.setResolver(resolver)\n        if (userTransformer) {\n          ctx.setTransformer(userTransformer)\n        }\n\n        for (const gen of selectedGenerators) {\n          ctx.addGenerator(gen)\n        }\n        for (const gen of userGenerators) {\n          ctx.addGenerator(gen)\n        }\n\n        const root = path.resolve(ctx.config.root, ctx.config.output.path)\n        const hasClientPlugin = !!ctx.config.plugins?.some((p) => (p as { name?: string }).name === pluginClientName)\n\n        if (client?.bundle && !hasClientPlugin && !clientImportPath) {\n          ctx.injectFile({\n            baseName: 'fetch.ts',\n            path: path.resolve(root, '.kubb/fetch.ts'),\n            sources: [\n              ast.createSource({\n                name: 'fetch',\n                nodes: [ast.createText(clientName === 'fetch' ? fetchClientSource : axiosClientSource)],\n                isExportable: true,\n                isIndexable: true,\n              }),\n            ],\n          })\n        }\n\n        if (!hasClientPlugin) {\n          ctx.injectFile({\n            baseName: 'config.ts',\n            path: path.resolve(root, '.kubb/config.ts'),\n            sources: [\n              ast.createSource({\n                name: 'config',\n                nodes: [ast.createText(configSource)],\n                isExportable: false,\n                isIndexable: false,\n              }),\n            ],\n          })\n        }\n      },\n    },\n  }\n})\n\nexport default pluginVueQuery\n"],"mappings":";;;;;;;;;;;;;;;;;AASA,MAAa,mBAAmB,gBAAgC,SAAS;CACvE,MAAM;CACN,YAAY;CACZ,QAAQ,MAAM,MAAM;AAClB,SAAO,UAAU,MAAM,EAAE,QAAQ,SAAS,QAAQ,CAAC;;CAErD,YAAY,MAAM;AAChB,SAAO,IAAI,QAAQ,MAAM,WAAW;;CAEvC,EAAE;;;ACHH,MAAa,qBAAqB;AAElC,MAAa,iBAAiB,cAA8B,YAAY;CACtE,MAAM,EACJ,SAAS;EAAE,MAAM;EAAS,YAAY;EAAS,EAC/C,OACA,UAAU,EAAE,EACZ,SACA,WAAW,EAAE,EACb,SAAS,UACT,WAAW,OACX,eAAe,EAAE,EACjB,aAAa,UACb,iBAAiB,eAAe,WAAW,WAAW,QAAQ,kBAAkB,UAChF,WAAW,EAAE,EACb,QAAQ,EAAE,EACV,cAAc,YAAY,gBAC1B,WAAW,SAAS,gBACpB,cACA,QACA,UAAU,cACV,aAAa,iBACb,YAAY,iBAAiB,EAAE,KAC7B;CAEJ,MAAM,aAAa,QAAQ,UAAU;CACrC,MAAM,mBAAmB,QAAQ,eAAe,CAAC,QAAQ,SAAS,+BAA+B,eAAe,KAAA;CAEhH,MAAM,qBAAqB,QAAQ,cAAc;EAAC;EAAgB;EAAwB;EAAkB,CAAC,OAAO,QAAQ;CAE5H,MAAM,cAAc,QACf;EACC,GAAG;EACH,MAAM,MAAM,OACR,MAAM,QACL,QAA2B;AAC1B,OAAI,MAAM,SAAS,OACjB,QAAO,GAAG,IAAI,MAAM,MAAM,IAAI,CAAC;AAEjC,UAAO,GAAG,UAAU,IAAI,MAAM,CAAC;;EAEtC,GACD,KAAA;AAEJ,QAAO;EACL,MAAM;EACN;EACA,cAAc,CAAC,cAAc,WAAW,QAAQ,gBAAgB,KAAA,EAAU,CAAC,OAAO,QAAQ;EAC1F,OAAO,EACL,oBAAoB,KAAK;GACvB,MAAM,WAAW,eAAe;IAAE,GAAG;IAAkB,GAAG;IAAc,GAAG;AAE3E,OAAI,WAAW;IACb;IACA;IACA,QAAQ;KACN,QAAQ,QAAQ;KAChB,SAAS,QAAQ;KACjB,QAAQ;KACR,YAAY,QAAQ,cAAc;KAClC,YAAY;KACZ,gBAAgB,QAAQ,kBAAkB;KAC1C;KACD;IACD;IACA,OACE,UAAU,QACN,QACA;KACE,YAAY;KACZ,SAAS,CAAC,MAAM;KAChB,GAAG;KACJ;IACP;IACA,UACE,aAAa,QACT,QACA;KACE,YAAY;KACZ,SAAS;MAAC;MAAQ;MAAO;MAAS;MAAS;KAC3C,GAAG;KACJ;IACP,UAAU,WACN;KACE,YAAY;KACZ,kBAAkB;KAClB,aAAa,KAAA;KACb,WAAW,KAAA;KACX,eAAe,KAAA;KACf,GAAG;KACJ,GACD;IACJ;IACA;IACA;IACA;IACA,OAAO;IACP;IACA;IACA;IACA;IACD,CAAC;AACF,OAAI,YAAY,SAAS;AACzB,OAAI,gBACF,KAAI,eAAe,gBAAgB;AAGrC,QAAK,MAAM,OAAO,mBAChB,KAAI,aAAa,IAAI;AAEvB,QAAK,MAAM,OAAO,eAChB,KAAI,aAAa,IAAI;GAGvB,MAAM,OAAO,KAAK,QAAQ,IAAI,OAAO,MAAM,IAAI,OAAO,OAAO,KAAK;GAClE,MAAM,kBAAkB,CAAC,CAAC,IAAI,OAAO,SAAS,MAAM,MAAO,EAAwB,SAAS,iBAAiB;AAE7G,OAAI,QAAQ,UAAU,CAAC,mBAAmB,CAAC,iBACzC,KAAI,WAAW;IACb,UAAU;IACV,MAAM,KAAK,QAAQ,MAAM,iBAAiB;IAC1C,SAAS,CACP,IAAI,aAAa;KACf,MAAM;KACN,OAAO,CAAC,IAAI,WAAW,eAAe,UAAUA,WAAoBC,OAAkB,CAAC;KACvF,cAAc;KACd,aAAa;KACd,CAAC,CACH;IACF,CAAC;AAGJ,OAAI,CAAC,gBACH,KAAI,WAAW;IACb,UAAU;IACV,MAAM,KAAK,QAAQ,MAAM,kBAAkB;IAC3C,SAAS,CACP,IAAI,aAAa;KACf,MAAM;KACN,OAAO,CAAC,IAAI,WAAWC,SAAa,CAAC;KACrC,cAAc;KACd,aAAa;KACd,CAAC,CACH;IACF,CAAC;KAGP;EACF;EACD"}
+{"version":3,"file":"index.js","names":["fetchClientSource","axiosClientSource","configSource"],"sources":["../../../internals/utils/src/fs.ts","../../../internals/shared/src/group.ts","../src/resolvers/resolverVueQuery.ts","../src/plugin.ts"],"sourcesContent":["import { posix } from 'node:path'\nimport { camelCase } from './casing.ts'\n\nfunction toSlash(p: string): string {\n  if (p.startsWith('\\\\\\\\?\\\\')) return p\n  return p.replaceAll('\\\\', '/')\n}\n\n/**\n * Returns the relative path from `rootDir` to `filePath`, always using forward slashes\n * and prefixed with `./` when not already traversing upward.\n *\n * @example\n * ```ts\n * getRelativePath('/src/components', '/src/components/Button.tsx') // './Button.tsx'\n * getRelativePath('/src/components', '/src/utils/helpers.ts')      // '../utils/helpers.ts'\n * ```\n */\nexport function getRelativePath(rootDir?: string | null, filePath?: string | null): string {\n  if (!rootDir || !filePath) {\n    throw new Error(`Root and file should be filled in when retrieving the relativePath, ${rootDir || ''} ${filePath || ''}`)\n  }\n\n  const relativePath = posix.relative(toSlash(rootDir), toSlash(filePath))\n\n  return relativePath.startsWith('../') ? relativePath : `./${relativePath}`\n}\n\n/**\n * Builds a nested file path from a dotted name. Splits on dots that precede a letter\n * (so version numbers embedded in operationIds like `v2025.0` stay intact), camelCases\n * every earlier segment, applies `caseLast` to the final segment, and joins with `/`.\n *\n * Empty segments are dropped before joining. They arise when the name starts with a dot\n * followed by a letter (e.g. `..Schema` splits into `['..', 'Schema']` and `'..'` cases to\n * an empty string). Without this a leading `/` would form, which `path.resolve` reads as an\n * absolute path, letting generated files escape the configured output directory.\n *\n * @example Nested path from a dotted name\n * `toFilePath('pet.petId') // 'pet/petId'`\n *\n * @example PascalCase the final segment\n * `toFilePath('pet.Pet', pascalCase) // 'pet/Pet'`\n *\n * @example Suffix applied to the final segment only\n * `toFilePath('tag.tag', (part) => camelCase(part, { suffix: 'schema' })) // 'tag/tagSchema'`\n */\nexport function toFilePath(name: string, caseLast: (part: string) => string = camelCase): string {\n  const parts = name.split(/\\.(?=[a-zA-Z])/)\n  return parts\n    .map((part, i) => (i === parts.length - 1 ? caseLast(part) : camelCase(part)))\n    .filter(Boolean)\n    .join('/')\n}\n","import { camelCase } from '@internals/utils'\nimport type { Group } from '@kubb/core'\n\n/**\n * Builds the `group` config a Kubb plugin passes to `ctx.setOptions`, applying the\n * shared default naming so every plugin groups output consistently:\n *\n * - `path` groups use the second path segment (`/pet/findByStatus` → `pet`).\n * - other groups use the camelCased group (`pet store` → `petStore`).\n *\n * A user-provided `group.name` always wins over the default namer, so callers stay in\n * control of their output folders. Returns `null` when grouping is disabled, matching the\n * per-plugin convention.\n *\n * @param group - The user-supplied group option, or `undefined` to disable grouping.\n *\n * @example\n * ```ts\n * createGroupConfig(group) // shared across every plugin\n * ```\n */\nexport function createGroupConfig(group: Group | undefined): Group | null {\n  if (!group) {\n    return null\n  }\n\n  const defaultName = (ctx: { group: string }): string => {\n    if (group.type === 'path') {\n      return `${ctx.group.split('/')[1]}`\n    }\n\n    return camelCase(ctx.group)\n  }\n\n  return {\n    ...group,\n    name: group.name ? group.name : defaultName,\n  } satisfies Group\n}\n","import { camelCase, toFilePath } from '@internals/utils'\nimport { defineResolver } from '@kubb/core'\nimport type { PluginVueQuery } from '../types.ts'\n\nfunction capitalize(name: string): string {\n  return `${name.charAt(0).toUpperCase()}${name.slice(1)}`\n}\n\n/**\n * Default resolver used by `@kubb/plugin-vue-query`. Decides the names and\n * file paths for every generated TanStack Query composable (`useFooQuery`,\n * `useFooMutation`, `useFooInfiniteQuery`) and its companion helpers.\n *\n * Functions and files use camelCase; composables get the `use` prefix.\n *\n * @example Resolve composable and helper names\n * ```ts\n * import { resolverVueQuery } from '@kubb/plugin-vue-query'\n *\n * resolverVueQuery.resolveQueryName(operationNode)       // 'useGetPetById'\n * resolverVueQuery.resolveQueryKeyName(operationNode)    // 'getPetByIdQueryKey'\n * resolverVueQuery.resolveQueryOptionsName(operationNode) // 'getPetByIdQueryOptions'\n * ```\n */\nexport const resolverVueQuery = defineResolver<PluginVueQuery>(() => ({\n  name: 'default',\n  pluginName: 'plugin-vue-query',\n  default(name, type) {\n    return type === 'file' ? toFilePath(name) : camelCase(name)\n  },\n  resolveName(name) {\n    return this.default(name, 'function')\n  },\n  resolvePathName(name, type) {\n    return this.default(name, type)\n  },\n  resolveQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}`\n  },\n  resolveInfiniteQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}Infinite`\n  },\n  resolveMutationName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}`\n  },\n  resolveQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}QueryOptions`\n  },\n  resolveInfiniteQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}InfiniteQueryOptions`\n  },\n  resolveQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}QueryKey`\n  },\n  resolveInfiniteQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}InfiniteQueryKey`\n  },\n  resolveMutationKeyName(node) {\n    return `${this.resolveName(node.operationId)}MutationKey`\n  },\n  resolveQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}QueryKey`\n  },\n  resolveInfiniteQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}InfiniteQueryKey`\n  },\n  resolveMutationTypeName(node) {\n    return capitalize(this.resolveName(node.operationId))\n  },\n  resolveClientName(node) {\n    return this.resolveName(node.operationId)\n  },\n  resolveInfiniteClientName(node) {\n    return `${this.resolveName(node.operationId)}Infinite`\n  },\n}))\n","import path from 'node:path'\nimport { createGroupConfig } from '@internals/shared'\nimport { ast, definePlugin } from '@kubb/core'\nimport { isParserEnabled, pluginClientName } from '@kubb/plugin-client'\nimport { source as axiosClientSource } from '@kubb/plugin-client/templates/clients/axios.source'\nimport { source as fetchClientSource } from '@kubb/plugin-client/templates/clients/fetch.source'\nimport { source as configSource } from '@kubb/plugin-client/templates/config.source'\nimport { pluginTsName } from '@kubb/plugin-ts'\nimport { pluginZodName } from '@kubb/plugin-zod'\nimport { mutationKeyTransformer } from '@internals/tanstack-query'\nimport { queryKeyTransformer } from '@internals/tanstack-query'\nimport { infiniteQueryGenerator, mutationGenerator, queryGenerator } from './generators'\nimport { resolverVueQuery } from './resolvers/resolverVueQuery.ts'\nimport type { PluginVueQuery } from './types.ts'\n\n/**\n * Canonical plugin name for `@kubb/plugin-vue-query`. Used for driver lookups\n * and cross-plugin dependency references.\n */\nexport const pluginVueQueryName = 'plugin-vue-query' satisfies PluginVueQuery['name']\n\n/**\n * Generates one TanStack Query composable per OpenAPI operation for Vue's\n * Composition API. Queries become `useFooQuery` (and optionally\n * `useFooInfiniteQuery`); mutations become `useFooMutation`. Each composable\n * is fully typed end to end.\n *\n * @example\n * ```ts\n * import { defineConfig } from 'kubb'\n * import { pluginTs } from '@kubb/plugin-ts'\n * import { pluginVueQuery } from '@kubb/plugin-vue-query'\n *\n * export default defineConfig({\n *   input: { path: './petStore.yaml' },\n *   output: { path: './src/gen' },\n *   plugins: [\n *     pluginTs(),\n *     pluginVueQuery({\n *       output: { path: './hooks' },\n *     }),\n *   ],\n * })\n * ```\n */\nexport const pluginVueQuery = definePlugin<PluginVueQuery>((options) => {\n  const {\n    output = { path: 'hooks', barrel: { type: 'named' } },\n    group,\n    exclude = [],\n    include,\n    override = [],\n    parser = false,\n    infinite = false,\n    paramsType = 'inline',\n    pathParamsType = paramsType === 'object' ? 'object' : options.pathParamsType || 'inline',\n    mutation = {},\n    query = {},\n    mutationKey = mutationKeyTransformer,\n    queryKey = queryKeyTransformer,\n    paramsCasing,\n    client,\n    resolver: userResolver,\n    transformer: userTransformer,\n    generators: userGenerators = [],\n  } = options\n\n  const clientName = client?.client ?? 'axios'\n  const clientImportPath = client?.importPath ?? (!client?.bundle ? `@kubb/plugin-client/clients/${clientName}` : undefined)\n\n  const selectedGenerators =\n    options.generators ??\n    [queryGenerator, infiniteQueryGenerator, mutationGenerator].filter((generator): generator is NonNullable<typeof generator> => Boolean(generator))\n\n  const groupConfig = createGroupConfig(group)\n\n  return {\n    name: pluginVueQueryName,\n    options,\n    dependencies: [pluginTsName, isParserEnabled(parser) ? pluginZodName : undefined].filter((dependency): dependency is string => Boolean(dependency)),\n    hooks: {\n      'kubb:plugin:setup'(ctx) {\n        const resolver = userResolver ? { ...resolverVueQuery, ...userResolver } : resolverVueQuery\n\n        ctx.setOptions({\n          output,\n          client: {\n            bundle: client?.bundle,\n            baseURL: client?.baseURL,\n            client: clientName,\n            clientType: client?.clientType ?? 'function',\n            importPath: clientImportPath,\n            dataReturnType: client?.dataReturnType ?? 'data',\n            paramsCasing,\n          },\n          queryKey,\n          query:\n            query === false\n              ? false\n              : {\n                  importPath: '@tanstack/vue-query',\n                  methods: ['get'],\n                  ...query,\n                },\n          mutationKey,\n          mutation:\n            mutation === false\n              ? false\n              : {\n                  importPath: '@tanstack/vue-query',\n                  methods: ['post', 'put', 'patch', 'delete'],\n                  ...mutation,\n                },\n          infinite: infinite\n            ? {\n                queryParam: 'id',\n                initialPageParam: 0,\n                cursorParam: null,\n                nextParam: null,\n                previousParam: null,\n                ...infinite,\n              }\n            : false,\n          parser,\n          paramsType,\n          pathParamsType,\n          paramsCasing,\n          group: groupConfig,\n          exclude,\n          include,\n          override,\n          resolver,\n        })\n        ctx.setResolver(resolver)\n        if (userTransformer) {\n          ctx.setTransformer(userTransformer)\n        }\n\n        for (const gen of selectedGenerators) {\n          ctx.addGenerator(gen)\n        }\n        for (const gen of userGenerators) {\n          ctx.addGenerator(gen)\n        }\n\n        const root = path.resolve(ctx.config.root, ctx.config.output.path)\n        const hasClientPlugin = !!ctx.config.plugins?.some((p) => (p as { name?: string }).name === pluginClientName)\n\n        if (client?.bundle && !hasClientPlugin && !clientImportPath) {\n          ctx.injectFile({\n            baseName: 'client.ts',\n            path: path.resolve(root, '.kubb/client.ts'),\n            sources: [\n              ast.createSource({\n                name: 'client',\n                nodes: [ast.createText(clientName === 'fetch' ? fetchClientSource : axiosClientSource)],\n                isExportable: true,\n                isIndexable: true,\n              }),\n            ],\n          })\n        }\n\n        if (!hasClientPlugin) {\n          ctx.injectFile({\n            baseName: 'config.ts',\n            path: path.resolve(root, '.kubb/config.ts'),\n            sources: [\n              ast.createSource({\n                name: 'config',\n                nodes: [ast.createText(configSource)],\n                isExportable: false,\n                isIndexable: false,\n              }),\n            ],\n          })\n        }\n      },\n    },\n  }\n})\n\nexport default pluginVueQuery\n"],"mappings":"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"}

package/dist/types-CwabLiFK.d.ts

@@ -0,0 +1,266 @@
+import { t as __name } from "./chunk-C0LytTxp.js";
+import { Exclude, Generator, Group, Include, Output, OutputOptions, Override, PluginFactoryOptions, Resolver, ast } from "@kubb/core";
+import { ClientImportPath, PluginClient } from "@kubb/plugin-client";
+
+//#region src/types.d.ts
+type Transformer = (props: {
+  node: ast.OperationNode;
+  casing: 'camelcase' | undefined;
+}) => Array<unknown>;
+/**
+ * Resolver for Vue Query that provides naming methods for hook functions.
+ */
+type ResolverVueQuery = Resolver & {
+  /**
+   * Resolves the base function name for an operation.
+   */
+  resolveName(this: ResolverVueQuery, name: string): string;
+  /**
+   * Resolves the output file name for a hook module.
+   */
+  resolvePathName(this: ResolverVueQuery, name: string, type?: 'file' | 'function' | 'type' | 'const'): string;
+  /**
+   * Resolves a query hook function name.
+   */
+  resolveQueryName(this: ResolverVueQuery, node: ast.OperationNode): string;
+  /**
+   * Resolves an infinite query hook function name.
+   */
+  resolveInfiniteQueryName(this: ResolverVueQuery, node: ast.OperationNode): string;
+  /**
+   * Resolves a mutation hook function name.
+   */
+  resolveMutationName(this: ResolverVueQuery, node: ast.OperationNode): string;
+  /**
+   * Resolves the query options helper name.
+   */
+  resolveQueryOptionsName(this: ResolverVueQuery, node: ast.OperationNode): string;
+  /**
+   * Resolves the infinite query options helper name.
+   */
+  resolveInfiniteQueryOptionsName(this: ResolverVueQuery, node: ast.OperationNode): string;
+  /**
+   * Resolves the query key helper name.
+   */
+  resolveQueryKeyName(this: ResolverVueQuery, node: ast.OperationNode): string;
+  /**
+   * Resolves the infinite query key helper name.
+   */
+  resolveInfiniteQueryKeyName(this: ResolverVueQuery, node: ast.OperationNode): string;
+  /**
+   * Resolves the mutation key helper name.
+   */
+  resolveMutationKeyName(this: ResolverVueQuery, node: ast.OperationNode): string;
+  /**
+   * Resolves the query key type name.
+   */
+  resolveQueryKeyTypeName(this: ResolverVueQuery, node: ast.OperationNode): string;
+  /**
+   * Resolves the infinite query key type name.
+   */
+  resolveInfiniteQueryKeyTypeName(this: ResolverVueQuery, node: ast.OperationNode): string;
+  /**
+   * Resolves the mutation type name.
+   */
+  resolveMutationTypeName(this: ResolverVueQuery, node: ast.OperationNode): string;
+  /**
+   * Resolves the client function name generated inline by query hooks.
+   */
+  resolveClientName(this: ResolverVueQuery, node: ast.OperationNode): string;
+  /**
+   * Resolves the client function name generated inline by infinite query hooks.
+   */
+  resolveInfiniteClientName(this: ResolverVueQuery, node: ast.OperationNode): string;
+};
+/**
+ * Builds the `queryKey` used by each generated query composable.
+ *
+ * @note String values are inlined verbatim into generated code. Wrap literal
+ * strings in `JSON.stringify(...)`.
+ */
+type QueryKey = Transformer;
+/**
+ * Builds the `mutationKey` used by each generated mutation composable.
+ *
+ * @note String values are inlined verbatim into generated code. Wrap literal
+ * strings in `JSON.stringify(...)`.
+ */
+type MutationKey = Transformer;
+type Query = {
+  /**
+   * HTTP methods treated as queries.
+   *
+   * @default ['get']
+   */
+  methods?: Array<string>;
+  /**
+   * Module specifier used in the `import { useQuery } from '...'` statement at
+   * the top of every generated composable file.
+   *
+   * @default '@tanstack/vue-query'
+   */
+  importPath?: string;
+};
+type Mutation = {
+  /**
+   * HTTP methods treated as mutations.
+   *
+   * @default ['post', 'put', 'delete']
+   */
+  methods?: Array<string>;
+  /**
+   * Module specifier used in the `import { useMutation } from '...'` statement
+   * at the top of every generated composable file.
+   *
+   * @default '@tanstack/vue-query'
+   */
+  importPath?: string;
+};
+type Infinite = {
+  /**
+   * Name of the query parameter that holds the page cursor.
+   *
+   * @default 'id'
+   */
+  queryParam?: string;
+  /**
+   * Path to the cursor field on the response. Leave undefined when the cursor
+   * is not known.
+   *
+   * @deprecated Use `nextParam` and `previousParam` for richer pagination control.
+   */
+  cursorParam?: string | null;
+  /**
+   * Path to the next-page cursor on the response. Supports dot notation
+   * (`'pagination.next.id'`) or array form.
+   */
+  nextParam?: string | Array<string> | null;
+  /**
+   * Path to the previous-page cursor on the response. Supports dot notation
+   * or array form.
+   */
+  previousParam?: string | Array<string> | null;
+  /**
+   * Initial value for `pageParam` on the first fetch.
+   *
+   * @default 0
+   */
+  initialPageParam?: unknown;
+};
+/**
+ * Where the generated composables are written and how they are exported, plus the optional
+ * `group` strategy. The `group` option organizes `output.mode: 'directory'` output into per-tag or per-path subdirectories.
+ *
+ * @default { path: 'hooks', barrel: { type: 'named' } }
+ */
+type Options = OutputOptions & {
+  /**
+   * HTTP client used inside every generated composable. Mirrors a subset of
+   * `pluginClient` options.
+   */
+  client?: ClientImportPath & Pick<PluginClient['options'], 'clientType' | 'dataReturnType' | 'baseURL' | 'bundle' | 'paramsCasing'>;
+  /**
+   * Skip operations matching at least one entry in the list.
+   */
+  exclude?: Array<Exclude>;
+  /**
+   * Restrict generation to operations matching at least one entry in the list.
+   */
+  include?: Array<Include>;
+  /**
+   * Apply a different options object to operations matching a pattern.
+   */
+  override?: Array<Override<ResolvedOptions>>;
+  /**
+   * Rename parameter properties in the generated composables.
+   *
+   * @note Must match the value of `paramsCasing` on `@kubb/plugin-ts`.
+   */
+  paramsCasing?: 'camelcase';
+  /**
+   * How operation parameters appear in the generated composable signature.
+   *
+   * @default 'inline'
+   */
+  paramsType?: 'object' | 'inline';
+  /**
+   * How URL path parameters are arranged inside the inline argument list.
+   *
+   * @default 'inline'
+   */
+  pathParamsType?: PluginClient['options']['pathParamsType'];
+  /**
+   * Enables `useInfiniteQuery` composables for cursor- or page-based pagination.
+   * Pass an object to configure how the cursor is read; pass `false` to skip.
+   *
+   * @default false
+   */
+  infinite?: Partial<Infinite> | false;
+  /**
+   * Custom `queryKey` builder.
+   */
+  queryKey?: QueryKey;
+  /**
+   * Configures query composables. Set to `false` to skip composable generation
+   * and emit only `queryOptions(...)` helpers.
+   */
+  query?: Partial<Query> | false;
+  /**
+   * Custom `mutationKey` builder.
+   */
+  mutationKey?: MutationKey;
+  /**
+   * Configures mutation composables. Set to `false` to skip mutation generation.
+   */
+  mutation?: Partial<Mutation> | false;
+  /**
+   * Validator applied to response bodies before they reach the caller.
+   * - `'client'` — no validation.
+   * - `'zod'` — pipes responses through schemas from `@kubb/plugin-zod`.
+   */
+  parser?: PluginClient['options']['parser'];
+  /**
+   * Override how composable names and file paths are built.
+   */
+  resolver?: Partial<ResolverVueQuery> & ThisType<ResolverVueQuery>;
+  /**
+   * AST visitor applied to each operation node before printing.
+   */
+  transformer?: ast.Visitor;
+  /**
+   * Custom generators that run alongside the built-in Vue Query generators.
+   */
+  generators?: Array<Generator<PluginVueQuery>>;
+};
+type ResolvedOptions = {
+  output: Output;
+  group: Group | null;
+  exclude: NonNullable<Options['exclude']>;
+  include: Options['include'];
+  override: NonNullable<Options['override']>;
+  client: Pick<PluginClient['options'], 'client' | 'clientType' | 'dataReturnType' | 'importPath' | 'baseURL' | 'bundle' | 'paramsCasing'>;
+  parser: NonNullable<Options['parser']>;
+  pathParamsType: NonNullable<Options['pathParamsType']>;
+  paramsCasing: Options['paramsCasing'];
+  paramsType: NonNullable<Options['paramsType']>;
+  /**
+   * Only used for infinite
+   */
+  infinite: NonNullable<Infinite> | false;
+  queryKey: QueryKey | null;
+  query: NonNullable<Required<Query>> | false;
+  mutationKey: MutationKey | null;
+  mutation: NonNullable<Required<Mutation>> | false;
+  resolver: ResolverVueQuery;
+};
+type PluginVueQuery = PluginFactoryOptions<'plugin-vue-query', Options, ResolvedOptions, ResolverVueQuery>;
+declare global {
+  namespace Kubb {
+    interface PluginRegistry {
+      'plugin-vue-query': PluginVueQuery;
+    }
+  }
+}
+//#endregion
+export { Transformer as i, Options as n, PluginVueQuery as r, Infinite as t };
+//# sourceMappingURL=types-CwabLiFK.d.ts.map

package/package.json

@@ -1,26 +1,23 @@
 {
   "name": "@kubb/plugin-vue-query",
-  "version": "5.0.0-beta.4",
-  "description": "Vue Query hooks generator plugin for Kubb, creating type-safe API client hooks from OpenAPI specifications for Vue.js applications.",
+  "version": "5.0.0-beta.56",
+  "description": "Generate type-safe TanStack Query (Vue Query) composables from your OpenAPI specification. Covers useQuery, useMutation, useInfiniteQuery, and queryOptions with Vue 3 Composition API support.",
   "keywords": [
-    "api-client",
-    "code-generator",
+    "code-generation",
     "codegen",
     "composables",
+    "composition-api",
     "data-fetching",
-    "hooks",
     "kubb",
-    "oas",
     "openapi",
-    "plugins",
-    "sdk-generator",
     "swagger",
+    "tanstack",
     "tanstack-query",
-    "type-safe",
     "typescript",
+    "use-mutation",
+    "use-query",
     "vue",
     "vue-query",
-    "vue.js",
     "vue3"
   ],
   "license": "MIT",
@@ -33,7 +30,6 @@
   "files": [
     "src",
     "dist",
-    "extension.yaml",
     "!/**/**.test.**",
     "!/**/__tests__/**",
     "!/**/__snapshots__/**"
@@ -73,37 +69,32 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@kubb/core": "5.0.0-beta.4",
-    "@kubb/renderer-jsx": "5.0.0-beta.4",
-    "remeda": "^2.34.0",
-    "@kubb/plugin-client": "5.0.0-beta.4",
-    "@kubb/plugin-ts": "5.0.0-beta.4",
-    "@kubb/plugin-zod": "5.0.0-beta.4"
+    "@kubb/ast": "5.0.0-beta.55",
+    "@kubb/core": "5.0.0-beta.55",
+    "@kubb/renderer-jsx": "5.0.0-beta.55",
+    "@kubb/plugin-client": "5.0.0-beta.56",
+    "@kubb/plugin-ts": "5.0.0-beta.56",
+    "@kubb/plugin-zod": "5.0.0-beta.56"
   },
   "devDependencies": {
+    "@internals/shared": "0.0.0",
     "@internals/tanstack-query": "0.0.0",
     "@internals/utils": "0.0.0"
   },
   "peerDependencies": {
-    "@kubb/renderer-jsx": "5.0.0-beta.4"
+    "@kubb/renderer-jsx": "5.0.0-beta.55"
   },
-  "size-limit": [
-    {
-      "path": "./dist/*.js",
-      "limit": "510 KiB",
-      "gzip": true
-    }
-  ],
   "engines": {
     "node": ">=22"
   },
   "scripts": {
-    "build": "tsdown && size-limit",
-    "clean": "npx rimraf ./dist",
+    "build": "tsdown",
+    "clean": "node -e \"require('node:fs').rmSync('./dist', {recursive:true,force:true})\"",
     "lint": "oxlint .",
     "lint:fix": "oxlint --fix .",
     "release": "pnpm publish --no-git-check",
     "release:canary": "bash ../../.github/canary.sh && node ../../scripts/build.js canary && pnpm publish --no-git-check",
+    "release:stage": "pnpm stage publish --no-git-check",
     "start": "tsdown --watch",
     "test": "vitest --passWithNoTests",
     "typecheck": "tsc -p ./tsconfig.json --noEmit --emitDeclarationOnly false"