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

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["camelCase","MutationKey","QueryKey","queryGenerator","suspenseQueryGenerator","infiniteQueryGenerator","suspenseInfiniteQueryGenerator","mutationGenerator","hookOptionsGenerator","customHookOptionsFileGenerator","camelCase","pluginTsName","pluginZodName","path","pluginClientName","ast","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\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>((ctx) => ({\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 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 {\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    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    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(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: pluginReactQueryName,\n    options,\n    dependencies: [pluginTsName, parser === 'zod' ? pluginZodName : undefined].filter(Boolean),\n    hooks: {\n      'kubb:plugin:setup'(ctx) {\n        const resolver = userResolver ? { ...resolverReactQuery, ...userResolver } : resolverReactQuery\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/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.cjs","names":["camelCase","camelCase","camelCase","mutationKeyTransformer","queryKeyTransformer","queryGenerator","suspenseQueryGenerator","infiniteQueryGenerator","suspenseInfiniteQueryGenerator","mutationGenerator","hookOptionsGenerator","customHookOptionsFileGenerator","pluginTsName","pluginZodName","path","pluginClientName","ast","fetchClientSource","axiosClientSource","configSource"],"sources":["../../../internals/utils/src/fs.ts","../../../internals/shared/src/group.ts","../src/resolvers/resolverReactQuery.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 { 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 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  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 { 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, 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', barrel: { type: 'named' } },\n    group,\n    exclude = [],\n    include,\n    override = [],\n    parser = false,\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 = createGroupConfig(group)\n\n  return {\n    name: pluginReactQueryName,\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 ? { ...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: '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 pluginReactQuery\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,10 +1,38 @@
-import { t as __name } from "./chunk--u3MIqq1.js";
-import { n as Options, r as PluginReactQuery } from "./types-DfaFRSBf.js";
-import * as _$_kubb_core0 from "@kubb/core";
+import { t as __name } from "./chunk-C0LytTxp.js";
+import { n as Options, r as PluginReactQuery } from "./types-X7D0NSvJ.js";
 
 //#region src/plugin.d.ts
+/**
+ * Canonical plugin name for `@kubb/plugin-react-query`. Used for driver lookups
+ * and cross-plugin dependency references.
+ */
 declare const pluginReactQueryName = "plugin-react-query";
-declare const pluginReactQuery: (options?: Options | undefined) => _$_kubb_core0.Plugin<PluginReactQuery>;
+/**
+ * Generates one TanStack Query hook per OpenAPI operation for React. Queries
+ * become `useFooQuery`/`useFooSuspenseQuery`/`useFooInfiniteQuery`; mutations
+ * become `useFooMutation`. Each hook is fully typed: query keys, input
+ * variables, response data, and error shape all come from the spec.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from 'kubb'
+ * import { pluginTs } from '@kubb/plugin-ts'
+ * import { pluginReactQuery } from '@kubb/plugin-react-query'
+ *
+ * export default defineConfig({
+ *   input: { path: './petStore.yaml' },
+ *   output: { path: './src/gen' },
+ *   plugins: [
+ *     pluginTs(),
+ *     pluginReactQuery({
+ *       output: { path: './hooks' },
+ *       suspense: {},
+ *     }),
+ *   ],
+ * })
+ * ```
+ */
+declare const pluginReactQuery: (options?: Options | undefined) => import("@kubb/core").Plugin<PluginReactQuery>;
 //#endregion
 export { type PluginReactQuery, pluginReactQuery as default, pluginReactQuery, pluginReactQueryName };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,41 +1,221 @@
-import "./chunk--u3MIqq1.js";
-import { f as QueryKey, m as camelCase, p as MutationKey } from "./components-DTGLu4UV.js";
-import { a as infiniteQueryGenerator, i as mutationGenerator, n as suspenseInfiniteQueryGenerator, o as hookOptionsGenerator, r as queryGenerator, s as customHookOptionsFileGenerator, t as suspenseQueryGenerator } from "./generators-C_fbcjpG.js";
+import "./chunk-C0LytTxp.js";
+import { d as queryKeyTransformer, h as mutationKeyTransformer, y as camelCase } from "./components-DL0Cai7l.js";
+import { a as infiniteQueryGenerator, i as mutationGenerator, n as suspenseInfiniteQueryGenerator, o as hookOptionsGenerator, r as queryGenerator, s as customHookOptionsFileGenerator, t as suspenseQueryGenerator } from "./generators-BG-Vcvfg.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 src/resolvers/resolverReactQuery.ts
+//#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
 /**
-* Naming convention resolver for React Query plugin.
+* 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`).
 *
-* Provides default naming helpers using camelCase for functions and file paths.
+* 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
-* `resolverReactQuery.default('list pets', 'function')  // → 'listPets'`
+* ```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/resolverReactQuery.ts
+function capitalize(name) {
+	return `${name.charAt(0).toUpperCase()}${name.slice(1)}`;
+}
+/**
+* Default resolver used by `@kubb/plugin-react-query`. Decides the names and
+* file paths for every generated TanStack Query hook (`useFooQuery`,
+* `useFooMutation`, `useFooInfiniteQuery`, ...) and its companion helpers
+* (`fooQueryKey`, `fooQueryOptions`).
+*
+* Functions and files use camelCase; hooks get the `use` prefix; suspense and
+* infinite variants are suffixed with `Suspense`/`Infinite`.
+*
+* @example Resolve hook and helper names
+* ```ts
+* import { resolverReactQuery } from '@kubb/plugin-react-query'
+*
+* resolverReactQuery.resolveQueryName(operationNode)       // 'useGetPetById'
+* resolverReactQuery.resolveMutationName(operationNode)    // 'useUpdatePet'
+* resolverReactQuery.resolveQueryKeyName(operationNode)    // 'getPetByIdQueryKey'
+* resolverReactQuery.resolveQueryOptionsName(operationNode) // 'getPetByIdQueryOptions'
+* ```
 */
-const resolverReactQuery = defineResolver((ctx) => ({
+const resolverReactQuery = defineResolver(() => ({
 	name: "default",
 	pluginName: "plugin-react-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))}`;
+	},
+	resolveSuspenseQueryName(node) {
+		return `use${capitalize(this.resolveName(node.operationId))}Suspense`;
+	},
+	resolveInfiniteQueryName(node) {
+		return `use${capitalize(this.resolveName(node.operationId))}Infinite`;
+	},
+	resolveSuspenseInfiniteQueryName(node) {
+		return `use${capitalize(this.resolveName(node.operationId))}SuspenseInfinite`;
+	},
+	resolveMutationName(node) {
+		return `use${capitalize(this.resolveName(node.operationId))}`;
+	},
+	resolveQueryOptionsName(node) {
+		return `${this.resolveName(node.operationId)}QueryOptions`;
+	},
+	resolveSuspenseQueryOptionsName(node) {
+		return `${this.resolveName(node.operationId)}SuspenseQueryOptions`;
+	},
+	resolveInfiniteQueryOptionsName(node) {
+		return `${this.resolveName(node.operationId)}InfiniteQueryOptions`;
+	},
+	resolveSuspenseInfiniteQueryOptionsName(node) {
+		return `${this.resolveName(node.operationId)}SuspenseInfiniteQueryOptions`;
+	},
+	resolveMutationOptionsName(node) {
+		return `${this.resolveName(node.operationId)}MutationOptions`;
+	},
+	resolveQueryKeyName(node) {
+		return `${this.resolveName(node.operationId)}QueryKey`;
+	},
+	resolveSuspenseQueryKeyName(node) {
+		return `${this.resolveName(node.operationId)}SuspenseQueryKey`;
+	},
+	resolveInfiniteQueryKeyName(node) {
+		return `${this.resolveName(node.operationId)}InfiniteQueryKey`;
+	},
+	resolveSuspenseInfiniteQueryKeyName(node) {
+		return `${this.resolveName(node.operationId)}SuspenseInfiniteQueryKey`;
+	},
+	resolveMutationKeyName(node) {
+		return `${this.resolveName(node.operationId)}MutationKey`;
+	},
+	resolveQueryKeyTypeName(node) {
+		return `${capitalize(this.resolveName(node.operationId))}QueryKey`;
+	},
+	resolveSuspenseQueryKeyTypeName(node) {
+		return `${capitalize(this.resolveName(node.operationId))}SuspenseQueryKey`;
+	},
+	resolveInfiniteQueryKeyTypeName(node) {
+		return `${capitalize(this.resolveName(node.operationId))}InfiniteQueryKey`;
+	},
+	resolveSuspenseInfiniteQueryKeyTypeName(node) {
+		return `${capitalize(this.resolveName(node.operationId))}SuspenseInfiniteQueryKey`;
+	},
+	resolveMutationTypeName(node) {
+		return capitalize(this.resolveName(node.operationId));
+	},
+	resolveClientName(node) {
+		return this.resolveName(node.operationId);
+	},
+	resolveSuspenseClientName(node) {
+		return `${this.resolveName(node.operationId)}Suspense`;
+	},
+	resolveInfiniteClientName(node) {
+		return `${this.resolveName(node.operationId)}Infinite`;
+	},
+	resolveSuspenseInfiniteClientName(node) {
+		return `${this.resolveName(node.operationId)}SuspenseInfinite`;
+	},
+	resolveHookOptionsName() {
+		return "HookOptions";
+	},
+	resolveCustomHookOptionsName() {
+		return "getCustomHookOptions";
 	}
 }));
 //#endregion
 //#region src/plugin.ts
+/**
+* Canonical plugin name for `@kubb/plugin-react-query`. Used for driver lookups
+* and cross-plugin dependency references.
+*/
 const pluginReactQueryName = "plugin-react-query";
+/**
+* Generates one TanStack Query hook per OpenAPI operation for React. Queries
+* become `useFooQuery`/`useFooSuspenseQuery`/`useFooInfiniteQuery`; mutations
+* become `useFooMutation`. Each hook is fully typed: query keys, input
+* variables, response data, and error shape all come from the spec.
+*
+* @example
+* ```ts
+* import { defineConfig } from 'kubb'
+* import { pluginTs } from '@kubb/plugin-ts'
+* import { pluginReactQuery } from '@kubb/plugin-react-query'
+*
+* export default defineConfig({
+*   input: { path: './petStore.yaml' },
+*   output: { path: './src/gen' },
+*   plugins: [
+*     pluginTs(),
+*     pluginReactQuery({
+*       output: { path: './hooks' },
+*       suspense: {},
+*     }),
+*   ],
+* })
+* ```
+*/
 const pluginReactQuery = definePlugin((options) => {
 	const { output = {
 		path: "hooks",
-		barrelType: "named"
-	}, group, exclude = [], include, override = [], parser = "client", suspense = {}, infinite = false, transformers = {}, paramsType = "inline", pathParamsType = paramsType === "object" ? "object" : options.pathParamsType || "inline", mutation = {}, query = {}, mutationKey = MutationKey.getTransformer, queryKey = QueryKey.getTransformer, customOptions, paramsCasing, client, resolver: userResolver, transformer: userTransformer, generators: userGenerators = [] } = options;
+		barrel: { type: "named" }
+	}, group, exclude = [], include, override = [], parser = false, suspense = {}, infinite = false, paramsType = "inline", pathParamsType = paramsType === "object" ? "object" : options.pathParamsType || "inline", mutation = {}, query = {}, mutationKey = mutationKeyTransformer, queryKey = queryKeyTransformer, customOptions, 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 ?? [
@@ -46,18 +226,12 @@ const pluginReactQuery = definePlugin((options) => {
 		mutationGenerator,
 		hookOptionsGenerator,
 		customHookOptionsFileGenerator
-	].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: pluginReactQueryName,
 		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 ? {
 				...resolverReactQuery,
@@ -65,7 +239,6 @@ const pluginReactQuery = definePlugin((options) => {
 			} : resolverReactQuery;
 			ctx.setOptions({
 				output,
-				transformers,
 				client: {
 					bundle: client?.bundle,
 					baseURL: client?.baseURL,
@@ -95,16 +268,16 @@ const pluginReactQuery = 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,
 				suspense,
 				customOptions: customOptions ? {
 					name: "useCustomHookOptions",
 					...customOptions
-				} : void 0,
+				} : null,
 				parser,
 				paramsType,
 				pathParamsType,
@@ -122,10 +295,10 @@ const pluginReactQuery = 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/resolverReactQuery.ts","../src/plugin.ts"],"sourcesContent":["import { camelCase } from '@internals/utils'\nimport { defineResolver } from '@kubb/core'\nimport type { PluginReactQuery } from '../types.ts'\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>((ctx) => ({\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 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 {\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    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    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(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: pluginReactQueryName,\n    options,\n    dependencies: [pluginTsName, parser === 'zod' ? pluginZodName : undefined].filter(Boolean),\n    hooks: {\n      'kubb:plugin:setup'(ctx) {\n        const resolver = userResolver ? { ...resolverReactQuery, ...userResolver } : resolverReactQuery\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/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":["../../../internals/utils/src/fs.ts","../../../internals/shared/src/group.ts","../src/resolvers/resolverReactQuery.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 { 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 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  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 { 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, 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', barrel: { type: 'named' } },\n    group,\n    exclude = [],\n    include,\n    override = [],\n    parser = false,\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 = createGroupConfig(group)\n\n  return {\n    name: pluginReactQueryName,\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 ? { ...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: '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 pluginReactQuery\n"],"mappings":"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"}