@kubb/plugin-react-query 5.0.0-beta.22 → 5.0.0-beta.25

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["fetchClientSource","axiosClientSource","configSource"],"sources":["../src/resolvers/resolverReactQuery.ts","../src/plugin.ts"],"sourcesContent":["import { camelCase } from '@internals/utils'\nimport { defineResolver } from '@kubb/core'\nimport type { PluginReactQuery } from '../types.ts'\n\nfunction capitalize(name: string): string {\n  return `${name.charAt(0).toUpperCase()}${name.slice(1)}`\n}\n\n/**\n * Naming convention resolver for React Query plugin.\n *\n * Provides default naming helpers using camelCase for functions and file paths.\n *\n * @example\n * `resolverReactQuery.default('list pets', 'function')  // → 'listPets'`\n */\nexport const resolverReactQuery = defineResolver<PluginReactQuery>(() => ({\n  name: 'default',\n  pluginName: 'plugin-react-query',\n  default(name, type) {\n    return camelCase(name, { isFile: type === 'file' })\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  resolveSuspenseQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}Suspense`\n  },\n  resolveInfiniteQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}Infinite`\n  },\n  resolveSuspenseInfiniteQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}SuspenseInfinite`\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  resolveSuspenseQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseQueryOptions`\n  },\n  resolveInfiniteQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}InfiniteQueryOptions`\n  },\n  resolveSuspenseInfiniteQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseInfiniteQueryOptions`\n  },\n  resolveMutationOptionsName(node) {\n    return `${this.resolveName(node.operationId)}MutationOptions`\n  },\n  resolveQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}QueryKey`\n  },\n  resolveSuspenseQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseQueryKey`\n  },\n  resolveInfiniteQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}InfiniteQueryKey`\n  },\n  resolveSuspenseInfiniteQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseInfiniteQueryKey`\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  resolveSuspenseQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}SuspenseQueryKey`\n  },\n  resolveInfiniteQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}InfiniteQueryKey`\n  },\n  resolveSuspenseInfiniteQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}SuspenseInfiniteQueryKey`\n  },\n  resolveMutationTypeName(node) {\n    return capitalize(this.resolveName(node.operationId))\n  },\n  resolveClientName(node) {\n    return this.resolveName(node.operationId)\n  },\n  resolveSuspenseClientName(node) {\n    return `${this.resolveName(node.operationId)}Suspense`\n  },\n  resolveInfiniteClientName(node) {\n    return `${this.resolveName(node.operationId)}Infinite`\n  },\n  resolveSuspenseInfiniteClientName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseInfinite`\n  },\n  resolveHookOptionsName() {\n    return 'HookOptions'\n  },\n  resolveCustomHookOptionsName() {\n    return 'getCustomHookOptions'\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 { mutationKeyTransformer, queryKeyTransformer } from '@internals/tanstack-query'\nimport {\n  customHookOptionsFileGenerator,\n  hookOptionsGenerator,\n  infiniteQueryGenerator,\n  mutationGenerator,\n  queryGenerator,\n  suspenseInfiniteQueryGenerator,\n  suspenseQueryGenerator,\n} from './generators'\nimport { resolverReactQuery } from './resolvers/resolverReactQuery.ts'\nimport type { PluginReactQuery } from './types.ts'\n\nexport const pluginReactQueryName = 'plugin-react-query' satisfies PluginReactQuery['name']\n\nexport const pluginReactQuery = definePlugin<PluginReactQuery>((options) => {\n  const {\n    output = { path: 'hooks', barrelType: 'named' },\n    group,\n    exclude = [],\n    include,\n    override = [],\n    parser = 'client',\n    suspense = {},\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    customOptions,\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    [\n      queryGenerator,\n      suspenseQueryGenerator,\n      infiniteQueryGenerator,\n      suspenseInfiniteQueryGenerator,\n      mutationGenerator,\n      hookOptionsGenerator,\n      customHookOptionsFileGenerator,\n    ].filter((generator): generator is NonNullable<typeof generator> => Boolean(generator))\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: pluginReactQueryName,\n    options,\n    dependencies: [pluginTsName, parser === 'zod' ? pluginZodName : undefined].filter((dependency): dependency is string => Boolean(dependency)),\n    hooks: {\n      'kubb:plugin:setup'(ctx) {\n        const resolver = userResolver ? { ...resolverReactQuery, ...userResolver } : resolverReactQuery\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/react-query',\n                  methods: ['get'],\n                  ...query,\n                },\n          mutationKey,\n          mutation:\n            mutation === false\n              ? false\n              : {\n                  importPath: '@tanstack/react-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          suspense,\n          customOptions: customOptions ? { name: 'useCustomHookOptions', ...customOptions } : undefined,\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 pluginReactQuery\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["fetchClientSource","axiosClientSource","configSource"],"sources":["../src/resolvers/resolverReactQuery.ts","../src/plugin.ts"],"sourcesContent":["import { camelCase } from '@internals/utils'\nimport { defineResolver } from '@kubb/core'\nimport type { PluginReactQuery } 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-react-query`. Decides the names and\n * file paths for every generated TanStack Query hook (`useFooQuery`,\n * `useFooMutation`, `useFooInfiniteQuery`, ...) and its companion helpers\n * (`fooQueryKey`, `fooQueryOptions`).\n *\n * Functions and files use camelCase; hooks get the `use` prefix; suspense and\n * infinite variants are suffixed with `Suspense`/`Infinite`.\n *\n * @example Resolve hook and helper names\n * ```ts\n * import { resolverReactQuery } from '@kubb/plugin-react-query'\n *\n * resolverReactQuery.resolveQueryName(operationNode)       // 'useGetPetById'\n * resolverReactQuery.resolveMutationName(operationNode)    // 'useUpdatePet'\n * resolverReactQuery.resolveQueryKeyName(operationNode)    // 'getPetByIdQueryKey'\n * resolverReactQuery.resolveQueryOptionsName(operationNode) // 'getPetByIdQueryOptions'\n * ```\n */\nexport const resolverReactQuery = defineResolver<PluginReactQuery>(() => ({\n  name: 'default',\n  pluginName: 'plugin-react-query',\n  default(name, type) {\n    return camelCase(name, { isFile: type === 'file' })\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  resolveSuspenseQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}Suspense`\n  },\n  resolveInfiniteQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}Infinite`\n  },\n  resolveSuspenseInfiniteQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}SuspenseInfinite`\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  resolveSuspenseQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseQueryOptions`\n  },\n  resolveInfiniteQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}InfiniteQueryOptions`\n  },\n  resolveSuspenseInfiniteQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseInfiniteQueryOptions`\n  },\n  resolveMutationOptionsName(node) {\n    return `${this.resolveName(node.operationId)}MutationOptions`\n  },\n  resolveQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}QueryKey`\n  },\n  resolveSuspenseQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseQueryKey`\n  },\n  resolveInfiniteQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}InfiniteQueryKey`\n  },\n  resolveSuspenseInfiniteQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseInfiniteQueryKey`\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  resolveSuspenseQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}SuspenseQueryKey`\n  },\n  resolveInfiniteQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}InfiniteQueryKey`\n  },\n  resolveSuspenseInfiniteQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}SuspenseInfiniteQueryKey`\n  },\n  resolveMutationTypeName(node) {\n    return capitalize(this.resolveName(node.operationId))\n  },\n  resolveClientName(node) {\n    return this.resolveName(node.operationId)\n  },\n  resolveSuspenseClientName(node) {\n    return `${this.resolveName(node.operationId)}Suspense`\n  },\n  resolveInfiniteClientName(node) {\n    return `${this.resolveName(node.operationId)}Infinite`\n  },\n  resolveSuspenseInfiniteClientName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseInfinite`\n  },\n  resolveHookOptionsName() {\n    return 'HookOptions'\n  },\n  resolveCustomHookOptionsName() {\n    return 'getCustomHookOptions'\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 { mutationKeyTransformer, queryKeyTransformer } from '@internals/tanstack-query'\nimport {\n  customHookOptionsFileGenerator,\n  hookOptionsGenerator,\n  infiniteQueryGenerator,\n  mutationGenerator,\n  queryGenerator,\n  suspenseInfiniteQueryGenerator,\n  suspenseQueryGenerator,\n} from './generators'\nimport { resolverReactQuery } from './resolvers/resolverReactQuery.ts'\nimport type { PluginReactQuery } from './types.ts'\n\n/**\n * Canonical plugin name for `@kubb/plugin-react-query`. Used for driver lookups\n * and cross-plugin dependency references.\n */\nexport const pluginReactQueryName = 'plugin-react-query' satisfies PluginReactQuery['name']\n\n/**\n * Generates one TanStack Query hook per OpenAPI operation for React. Queries\n * become `useFooQuery`/`useFooSuspenseQuery`/`useFooInfiniteQuery`; mutations\n * become `useFooMutation`. Each hook is fully typed: query keys, input\n * variables, response data, and error shape all come from the spec.\n *\n * @example\n * ```ts\n * import { defineConfig } from 'kubb'\n * import { pluginTs } from '@kubb/plugin-ts'\n * import { pluginReactQuery } from '@kubb/plugin-react-query'\n *\n * export default defineConfig({\n *   input: { path: './petStore.yaml' },\n *   output: { path: './src/gen' },\n *   plugins: [\n *     pluginTs(),\n *     pluginReactQuery({\n *       output: { path: './hooks' },\n *       suspense: {},\n *     }),\n *   ],\n * })\n * ```\n */\nexport const pluginReactQuery = definePlugin<PluginReactQuery>((options) => {\n  const {\n    output = { path: 'hooks', barrelType: 'named' },\n    group,\n    exclude = [],\n    include,\n    override = [],\n    parser = 'client',\n    suspense = {},\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    customOptions,\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    [\n      queryGenerator,\n      suspenseQueryGenerator,\n      infiniteQueryGenerator,\n      suspenseInfiniteQueryGenerator,\n      mutationGenerator,\n      hookOptionsGenerator,\n      customHookOptionsFileGenerator,\n    ].filter((generator): generator is NonNullable<typeof generator> => Boolean(generator))\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    : null\n\n  return {\n    name: pluginReactQueryName,\n    options,\n    dependencies: [pluginTsName, parser === 'zod' ? pluginZodName : undefined].filter((dependency): dependency is string => Boolean(dependency)),\n    hooks: {\n      'kubb:plugin:setup'(ctx) {\n        const resolver = userResolver ? { ...resolverReactQuery, ...userResolver } : resolverReactQuery\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/react-query',\n                  methods: ['get'],\n                  ...query,\n                },\n          mutationKey,\n          mutation:\n            mutation === false\n              ? false\n              : {\n                  importPath: '@tanstack/react-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          suspense,\n          customOptions: customOptions ? { name: 'useCustomHookOptions', ...customOptions } : null,\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 pluginReactQuery\n"],"mappings":"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"}

package/dist/{types-DG_OxOym.d.ts → types-DiZPLTXl.d.ts}

@@ -17,7 +17,7 @@ type Props$1 = {
   node: ast.OperationNode;
   paramsCasing: 'camelcase' | undefined;
   pathParamsType: 'object' | 'inline';
-  transformer: Transformer | undefined;
+  transformer: Transformer | null | undefined;
 };
 declare function MutationKey$1({
   name,
@@ -34,7 +34,7 @@ type Props = {
   tsResolver: PluginTs['resolver'];
   paramsCasing: 'camelcase' | undefined;
   pathParamsType: 'object' | 'inline';
-  transformer: Transformer | undefined;
+  transformer: Transformer | null | undefined;
 };
 declare function QueryKey$1({
   name,
@@ -169,167 +169,204 @@ type ResolverReactQuery = Resolver & {
 };
 type Suspense = object;
 /**
- * Customize the queryKey.
+ * Builds the `queryKey` used by each generated query hook.
+ *
+ * @note String values are inlined verbatim into generated code. Wrap literal
+ * strings in `JSON.stringify(...)`.
  */
 type QueryKey = Transformer;
 /**
- * Customize the mutationKey.
+ * Builds the `mutationKey` used by each generated mutation hook.
+ *
+ * @note String values are inlined verbatim into generated code. Wrap literal
+ * strings in `JSON.stringify(...)`.
  */
 type MutationKey = Transformer;
 type Query = {
   /**
-   * HTTP methods to use for queries.
+   * HTTP methods treated as queries. Operations using these methods produce
+   * `useQuery`-style hooks.
    *
    * @default ['get']
    */
   methods?: Array<string>;
   /**
-   * Path to the useQuery hook for useQuery functionality.
-   * Used as `import { useQuery } from '${importPath}'`.
-   * Accepts relative and absolute paths.
-   * Path is used as-is; relative paths are based on the generated file location.
+   * Module specifier used in the `import { useQuery } from '...'` statement at
+   * the top of every generated hook file. Useful for routing through a wrapper
+   * that injects a default `queryClient`.
+   *
    * @default '@tanstack/react-query'
    */
   importPath?: string;
 };
 type Mutation = {
   /**
-   * HTTP methods to use for mutations.
+   * HTTP methods treated as mutations. Operations using these methods produce
+   * `useMutation`-style hooks.
    *
    * @default ['post', 'put', 'delete']
    */
   methods?: Array<string>;
   /**
-   * Path to the useMutation hook for useMutation functionality.
-   * Used as `import { useMutation } from '${importPath}'`.
-   * Accepts relative and absolute paths.
-   * Path is used as-is; relative paths are based on the generated file location.
+   * Module specifier used in the `import { useMutation } from '...'` statement
+   * at the top of every generated hook file.
+   *
    * @default '@tanstack/react-query'
    */
   importPath?: string;
 };
 type Infinite = {
   /**
-   * Specify the params key used for `pageParam`.
+   * Name of the query parameter that holds the page cursor.
+   *
    * @default 'id'
    */
-  queryParam: string;
+  queryParam?: string;
   /**
-   * Which field of the data is used, set it to undefined when no cursor is known.
-   * @deprecated Use `nextParam` and `previousParam` instead for more flexible pagination handling.
+   * 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 | undefined;
+  cursorParam?: string | null;
   /**
-   * Which field of the data is used to get the cursor for the next page.
-   * Supports dot notation (e.g. 'pagination.next.id') or array path (e.g. ['pagination', 'next', 'id']) to access nested fields.
+   * Path to the next-page cursor on the response. Supports dot notation
+   * (`'pagination.next.id'`) or array form (`['pagination', 'next', 'id']`).
    */
-  nextParam?: string | string[] | undefined;
+  nextParam?: string | Array<string> | null;
   /**
-   * Which field of the data is used to get the cursor for the previous page.
-   * Supports dot notation (e.g. 'pagination.prev.id') or array path (e.g. ['pagination', 'prev', 'id']) to access nested fields.
+   * Path to the previous-page cursor on the response. Supports dot notation
+   * or array form.
    */
-  previousParam?: string | string[] | undefined;
+  previousParam?: string | Array<string> | null;
   /**
-   * The initial value, the value of the first page.
+   * Initial value for `pageParam` on the first fetch.
+   *
    * @default 0
    */
-  initialPageParam: unknown;
+  initialPageParam?: unknown;
 };
 type CustomOptions = {
   /**
-   * Path to the hook that is used to customize the hook options.
-   * It used as `import ${customOptions.name} from '${customOptions.importPath}'`.
-   * It allows both relative and absolute paths but be aware that we will not change the path.
+   * Module specifier of your custom-options hook. Imported as
+   * `import ${name} from '${importPath}'`.
    */
   importPath: string;
   /**
-   * Name of the exported hook that is used to customize the hook options.
-   * It used as `import ${customOptions.name} from '${customOptions.importPath}'`.
+   * Exported function name of your custom-options hook.
+   *
    * @default 'useCustomHookOptions'
    */
   name?: string;
 };
 type Options = {
   /**
-   * Specify the export location for the files and define the behavior of the output
-   * @default { path: 'hooks', barrelType: 'named' }
+   * Where the generated hooks are written and how they are exported.
+   *
+   * @default { path: 'hooks', barrel: { type: 'named' } }
    */
   output?: Output;
   /**
-   * Group the @tanstack/query hooks based on the provided name.
+   * Split generated files into subfolders based on the operation's tag.
    */
   group?: Group;
+  /**
+   * HTTP client used inside every generated hook. Mirrors a subset of
+   * `pluginClient` options.
+   */
   client?: ClientImportPath & Pick<PluginClient['options'], 'clientType' | 'dataReturnType' | 'baseURL' | 'bundle' | 'paramsCasing'>;
   /**
-   * Tags, operations, or paths to exclude from generation.
+   * Skip operations matching at least one entry in the list.
    */
   exclude?: Array<Exclude>;
   /**
-   * Tags, operations, or paths to include in generation.
+   * Restrict generation to operations matching at least one entry in the list.
    */
   include?: Array<Include>;
   /**
-   * Override options for specific tags, operations, or paths.
+   * Apply a different options object to operations matching a pattern.
    */
   override?: Array<Override<ResolvedOptions>>;
   /**
-   * Apply casing to parameter names.
+   * Rename parameter properties in the generated hooks.
+   *
+   * @note Must match the value of `paramsCasing` on `@kubb/plugin-ts`.
    */
   paramsCasing?: 'camelcase';
   /**
-   * How parameters are passed: grouped in an object or spread inline.
+   * How operation parameters appear in the generated hook signature.
+   * - `'inline'` — positional arguments.
+   * - `'object'` — single destructured object argument.
    *
    * @default 'inline'
    */
   paramsType?: 'object' | 'inline';
   /**
-   * How path parameters are passed: grouped in an object or spread inline.
+   * How URL path parameters are arranged inside the inline argument list.
    *
    * @default 'inline'
    */
   pathParamsType?: PluginClient['options']['pathParamsType'];
   /**
-   * Add infinite query hooks.
+   * Enables `useInfiniteQuery` hooks 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;
   /**
-   * Add suspense query hooks.
+   * Adds `useSuspenseQuery` hooks alongside the regular `useQuery` ones.
+   * Pass an empty object (`{}`) to enable. TanStack Query v5+ only.
    */
   suspense?: Partial<Suspense> | false;
+  /**
+   * Custom `queryKey` builder. Use to add a version namespace, swap to
+   * operation IDs, or shape keys to match an existing invalidation strategy.
+   */
   queryKey?: QueryKey;
   /**
-   * Configure useQuery behavior.
+   * Configures query hooks. Set to `false` to skip generating hooks entirely
+   * and emit only `queryOptions(...)` helpers.
    */
   query?: Partial<Query> | false;
+  /**
+   * Custom `mutationKey` builder. Useful when you batch invalidations or read
+   * mutation state via `useMutationState`.
+   */
   mutationKey?: MutationKey;
   /**
-   * Configure useMutation behavior.
+   * Configures mutation hooks. Set to `false` to skip mutation generation.
    */
   mutation?: Partial<Mutation> | false;
   /**
-   * Use a custom hook to customize hook options and generate a HookOptions type.
+   * Wires every generated hook through a user-supplied function that returns
+   * extra options (`onSuccess`, `onError`, `select`, ...). Also emits a
+   * `HookOptions` type so the wrapper stays in sync with generated hooks.
    */
   customOptions?: CustomOptions;
   /**
-   * Parser to use for validating response data.
+   * Validator applied to response bodies before they reach the caller.
+   * - `'client'` — no validation. Trusts the API.
+   * - `'zod'` — pipes responses through schemas from `@kubb/plugin-zod`.
    */
   parser?: PluginClient['options']['parser'];
   /**
-   * Override naming conventions for function names and types.
+   * Override how hook names and file paths are built. Methods you omit fall
+   * back to the default `resolverReactQuery`.
    */
   resolver?: Partial<ResolverReactQuery> & ThisType<ResolverReactQuery>;
   /**
-   * AST visitor to transform generated nodes.
+   * AST visitor applied to each operation node before printing.
    */
   transformer?: ast.Visitor;
   /**
-   * Additional generators alongside the default generators.
+   * Custom generators that run alongside the built-in React Query generators.
    */
   generators?: Array<Generator<PluginReactQuery>>;
 };
 type ResolvedOptions = {
   output: Output;
-  group: Group | undefined;
+  group: Group | null;
   exclude: NonNullable<Options['exclude']>;
   include: Options['include'];
   override: NonNullable<Options['override']>;
@@ -343,11 +380,11 @@ type ResolvedOptions = {
    */
   infinite: NonNullable<Infinite> | false;
   suspense: Suspense | false;
-  queryKey: QueryKey | undefined;
+  queryKey: QueryKey | null;
   query: NonNullable<Required<Query>> | false;
-  mutationKey: MutationKey | undefined;
+  mutationKey: MutationKey | null;
   mutation: NonNullable<Required<Mutation>> | false;
-  customOptions: NonNullable<Required<CustomOptions>> | undefined;
+  customOptions: NonNullable<Required<CustomOptions>> | null;
   resolver: ResolverReactQuery;
 };
 type PluginReactQuery = PluginFactoryOptions<'plugin-react-query', Options, ResolvedOptions, ResolverReactQuery>;
@@ -360,4 +397,4 @@ declare global {
 }
 //#endregion
 export { MutationKey$1 as a, QueryKey$1 as i, Options as n, PluginReactQuery as r, Infinite as t };
-//# sourceMappingURL=types-DG_OxOym.d.ts.map
+//# sourceMappingURL=types-DiZPLTXl.d.ts.map