@kubb/plugin-vue-query 5.0.0-beta.79 → 5.0.0-beta.80

package/dist/index.d.ts

@@ -387,6 +387,13 @@ type Options = OutputOptions & {
    * Override how composable names and file paths are built.
    */
   resolver?: Partial<ResolverVueQuery> & ThisType<ResolverVueQuery>;
+  /**
+   * Set to `false` to skip generating `use*` composable functions. `queryOptions`,
+   * `mutationOptions`, `queryKey`, and `mutationKey` helpers are still emitted.
+   *
+   * @default false
+   */
+  hooks?: boolean;
   /**
    * Macros applied to each operation node before printing.
    */
@@ -419,6 +426,7 @@ type ResolvedOptions = {
   query: NonNullable<Required<Query>> | false;
   mutationKey: MutationKey | null;
   mutation: NonNullable<Required<Mutation>> | false;
+  hooks: boolean;
   resolver: ResolverVueQuery;
 };
 type PluginVueQuery = PluginFactoryOptions<'plugin-vue-query', Options, ResolvedOptions, ResolverVueQuery>;

package/dist/index.js

@@ -671,6 +671,19 @@ const requestGroupOrder$1 = [
 	"headers"
 ];
 /**
+* Widens a request-group member type so a generated TanStack hook accepts either the value or a
+* deferred value. Both plugins apply this through the `memberTypeWrapper` of `buildGroupedRequestParam`;
+* they only differ in how the deferred form is later resolved.
+*
+* `maybeRefOrGetter` is used by vue-query, which keeps the ref/getter live and unwraps it lazily with
+* `toValue` because vue-query keys are reactive. `maybeValueOrGetter` is used by react-query, which
+* resolves the getter once at the hook boundary and forwards a plain value because React Query hashes
+* keys structurally and cannot hold a function.
+*/
+function maybeRefOrGetter(type) {
+	return `MaybeRefOrGetter<${type}>`;
+}
+/**
 * 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
@@ -792,12 +805,6 @@ const queryKeyTransformer = ({ node }) => {
 };
 //#endregion
 //#region src/utils.ts
-/**
-* Wraps a type string in `MaybeRefOrGetter<…>` so a vue-query signature accepts refs or getters.
-*/
-function maybeRefOrGetter(type) {
-	return `MaybeRefOrGetter<${type}>`;
-}
 const requestGroupOrder = [
 	"path",
 	"query",
@@ -1241,7 +1248,7 @@ const infiniteQueryGenerator = defineGenerator({
 	operation(node, ctx) {
 		if (!ast.isHttpOperationNode(node)) return null;
 		const { config, driver, resolver, root } = ctx;
-		const { output, query, mutation, infinite, validator, client, group } = ctx.options;
+		const { output, query, mutation, infinite, validator, client, group, hooks } = ctx.options;
 		const pluginTs = driver.getPlugin(pluginTsName);
 		if (!pluginTs) return null;
 		const tsResolver = driver.getResolver(pluginTsName);
@@ -1380,30 +1387,32 @@ const infiniteQueryGenerator = defineGenerator({
 					initialPageParam: infiniteOptions.initialPageParam,
 					queryParam: infiniteOptions.queryParam
 				}),
-				/* @__PURE__ */ jsx(File.Import, {
-					name: ["useInfiniteQuery"],
-					path: importPath
-				}),
-				/* @__PURE__ */ jsx(File.Import, {
-					name: [
-						"QueryKey",
-						"QueryClient",
-						"UseInfiniteQueryOptions",
-						"UseInfiniteQueryReturnType"
-					],
-					path: importPath,
-					isTypeOnly: true
-				}),
-				/* @__PURE__ */ jsx(InfiniteQuery, {
-					name: queryName,
-					queryOptionsName,
-					queryKeyName,
-					queryKeyTypeName,
-					node,
-					tsResolver,
-					initialPageParam: infiniteOptions.initialPageParam,
-					queryParam: infiniteOptions.queryParam
-				})
+				hooks && /* @__PURE__ */ jsxs(Fragment, { children: [
+					/* @__PURE__ */ jsx(File.Import, {
+						name: ["useInfiniteQuery"],
+						path: importPath
+					}),
+					/* @__PURE__ */ jsx(File.Import, {
+						name: [
+							"QueryKey",
+							"QueryClient",
+							"UseInfiniteQueryOptions",
+							"UseInfiniteQueryReturnType"
+						],
+						path: importPath,
+						isTypeOnly: true
+					}),
+					/* @__PURE__ */ jsx(InfiniteQuery, {
+						name: queryName,
+						queryOptionsName,
+						queryKeyName,
+						queryKeyTypeName,
+						node,
+						tsResolver,
+						initialPageParam: infiniteOptions.initialPageParam,
+						queryParam: infiniteOptions.queryParam
+					})
+				] })
 			]
 		});
 	}
@@ -1421,7 +1430,7 @@ const mutationGenerator = defineGenerator({
 	operation(node, ctx) {
 		if (!ast.isHttpOperationNode(node)) return null;
 		const { config, driver, resolver, root } = ctx;
-		const { output, query, mutation, validator, client, group } = ctx.options;
+		const { output, query, mutation, validator, client, group, hooks } = ctx.options;
 		const pluginTs = driver.getPlugin(pluginTsName);
 		if (!pluginTs) return null;
 		const tsResolver = driver.getResolver(pluginTsName);
@@ -1524,7 +1533,7 @@ const mutationGenerator = defineGenerator({
 					node,
 					transformer: ctx.options.mutationKey
 				}),
-				mutation && /* @__PURE__ */ jsxs(Fragment, { children: [
+				mutation && hooks && /* @__PURE__ */ jsxs(Fragment, { children: [
 					/* @__PURE__ */ jsx(File.Import, {
 						name: ["useMutation"],
 						path: importPath
@@ -1560,7 +1569,7 @@ const queryGenerator = defineGenerator({
 	operation(node, ctx) {
 		if (!ast.isHttpOperationNode(node)) return null;
 		const { config, driver, resolver, root } = ctx;
-		const { output, query, mutation, validator, client, group } = ctx.options;
+		const { output, query, mutation, validator, client, group, hooks } = ctx.options;
 		const pluginTs = driver.getPlugin(pluginTsName);
 		if (!pluginTs) return null;
 		const tsResolver = driver.getResolver(pluginTsName);
@@ -1677,7 +1686,7 @@ const queryGenerator = defineGenerator({
 					node,
 					tsResolver
 				}),
-				query && /* @__PURE__ */ jsxs(Fragment, { children: [
+				query && hooks && /* @__PURE__ */ jsxs(Fragment, { children: [
 					/* @__PURE__ */ jsx(File.Import, {
 						name: ["useQuery"],
 						path: importPath
@@ -1813,7 +1822,7 @@ const pluginVueQuery = definePlugin((options) => {
 	const { output = {
 		path: "hooks",
 		barrel: { type: "named" }
-	}, group, exclude = [], include, override = [], validator = false, infinite = false, mutation = {}, query = {}, mutationKey = mutationKeyTransformer, queryKey = queryKeyTransformer, client, resolver: userResolver, macros: userMacros } = options;
+	}, group, exclude = [], include, override = [], validator = false, infinite = false, mutation = {}, query = {}, mutationKey = mutationKeyTransformer, queryKey = queryKeyTransformer, hooks = false, client, resolver: userResolver, macros: userMacros } = options;
 	const selectedGenerators = [
 		queryGenerator,
 		infiniteQueryGenerator,
@@ -1866,6 +1875,7 @@ const pluginVueQuery = definePlugin((options) => {
 					previousParam: null,
 					...infinite
 				} : false,
+				hooks,
 				validator,
 				group: groupConfig,
 				exclude,