@kubb/plugin-react-query 5.0.0-beta.84 → 5.0.0-beta.86

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./rolldown-runtime-C0LytTxp.js";
-import { Exclude, Group, Include, Output, OutputOptions, Override, PluginFactoryOptions, Resolver, ast } from "kubb/kit";
+import { Exclude, Group, Include, Output, OutputOptions, Override, PluginFactoryOptions, Resolver, ResolverPatch, ast } from "kubb/kit";
 //#region ../../internals/client/src/resolveClient.d.ts
 /**
  * Resolves which client plugin a consumer (react-query, vue-query, swr, mcp) should call for an
@@ -31,124 +31,177 @@ type Transformer = (props: {
 //#endregion
 //#region src/types.d.ts
 /**
- * Resolver for React Query that provides naming methods for hook functions.
+ * The concrete resolver type for `@kubb/plugin-react-query`.
+ * Extends the base `Resolver` (which provides `default` naming and option helpers, the top-level
+ * `name` casing, and the `file` builder) with plugin-specific naming namespaces for the generated
+ * `useQuery`, `useSuspenseQuery`, `useInfiniteQuery`, `useSuspenseInfiniteQuery`, and `useMutation`
+ * hooks and their companion helpers.
  */
 type ResolverReactQuery = Resolver & {
   /**
-   * Resolves the base function name for an operation.
-   *
-   * @example Resolving base operation names
-   * `resolver.resolveName('show pet by id') // -> 'showPetById'`
-   */
-  resolveName(this: ResolverReactQuery, name: string): string;
-  /**
-   * Resolves the output file name for a hook module.
-   */
-  resolvePathName(this: ResolverReactQuery, name: string, type?: 'file' | 'function' | 'type' | 'const'): string;
-  /**
-   * Resolves a query hook function name.
-   */
-  resolveQueryName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves a suspense query hook function name.
-   */
-  resolveSuspenseQueryName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves an infinite query hook function name.
-   */
-  resolveInfiniteQueryName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves a suspense infinite query hook function name.
-   */
-  resolveSuspenseInfiniteQueryName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves a mutation hook function name.
-   */
-  resolveMutationName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves the query options helper name.
-   */
-  resolveQueryOptionsName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves the suspense query options helper name.
-   */
-  resolveSuspenseQueryOptionsName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves the infinite query options helper name.
-   */
-  resolveInfiniteQueryOptionsName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves the suspense infinite query options helper name.
-   */
-  resolveSuspenseInfiniteQueryOptionsName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves the mutation options helper name.
-   */
-  resolveMutationOptionsName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves the query key helper name.
-   */
-  resolveQueryKeyName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves the suspense query key helper name.
-   */
-  resolveSuspenseQueryKeyName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves the infinite query key helper name.
-   */
-  resolveInfiniteQueryKeyName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves the suspense infinite query key helper name.
-   */
-  resolveSuspenseInfiniteQueryKeyName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves the mutation key helper name.
-   */
-  resolveMutationKeyName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves the query key type name.
-   */
-  resolveQueryKeyTypeName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves the suspense query key type name.
-   */
-  resolveSuspenseQueryKeyTypeName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves the infinite query key type name.
-   */
-  resolveInfiniteQueryKeyTypeName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves the suspense infinite query key type name.
-   */
-  resolveSuspenseInfiniteQueryKeyTypeName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves the mutation type name.
-   */
-  resolveMutationTypeName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves the client function name generated inline by query hooks.
-   */
-  resolveClientName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves the client function name generated inline by suspense query hooks.
-   */
-  resolveSuspenseClientName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves the client function name generated inline by infinite query hooks.
-   */
-  resolveInfiniteClientName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves the client function name generated inline by suspense infinite query hooks.
-   */
-  resolveSuspenseInfiniteClientName(this: ResolverReactQuery, node: ast.OperationNode): string;
-  /**
-   * Resolves the generated custom hook options map type name.
-   */
-  resolveHookOptionsName(this: ResolverReactQuery): string;
-  /**
-   * Resolves the helper function name used inside the custom hook options file.
-   */
-  resolveCustomHookOptionsName(this: ResolverReactQuery): string;
+   * Naming for the generated `useQuery` hook and its companion helpers.
+   */
+  query: {
+    /**
+     * Resolves a query hook function name.
+     *
+     * @example Query hook names
+     * `resolver.query.name(node) // → 'useGetPetById'`
+     */
+    name(node: ast.OperationNode): string;
+    /**
+     * Resolves the query options helper name.
+     *
+     * @example Query options helper names
+     * `resolver.query.optionsName(node) // → 'getPetByIdQueryOptions'`
+     */
+    optionsName(node: ast.OperationNode): string;
+    /**
+     * Resolves the query key helper name.
+     *
+     * @example Query key helper names
+     * `resolver.query.keyName(node) // → 'getPetByIdQueryKey'`
+     */
+    keyName(node: ast.OperationNode): string;
+    /**
+     * Resolves the query key type name.
+     *
+     * @example Query key type names
+     * `resolver.query.keyTypeName(node) // → 'GetPetByIdQueryKey'`
+     */
+    keyTypeName(node: ast.OperationNode): string;
+    /**
+     * Resolves the client function name generated inline by query hooks.
+     *
+     * @example Client function names
+     * `resolver.query.clientName(node) // → 'getPetById'`
+     */
+    clientName(node: ast.OperationNode): string;
+  };
+  /**
+   * Naming for the generated `useSuspenseQuery` hook and its companion helpers.
+   */
+  suspenseQuery: {
+    /**
+     * Resolves a suspense query hook function name.
+     *
+     * @example Suspense query hook names
+     * `resolver.suspenseQuery.name(node) // → 'useGetPetByIdSuspense'`
+     */
+    name(node: ast.OperationNode): string;
+    /**
+     * Resolves the suspense query options helper name.
+     */
+    optionsName(node: ast.OperationNode): string;
+    /**
+     * Resolves the suspense query key helper name.
+     */
+    keyName(node: ast.OperationNode): string;
+    /**
+     * Resolves the suspense query key type name.
+     */
+    keyTypeName(node: ast.OperationNode): string;
+    /**
+     * Resolves the client function name generated inline by suspense query hooks.
+     */
+    clientName(node: ast.OperationNode): string;
+  };
+  /**
+   * Naming for the generated `useInfiniteQuery` hook and its companion helpers.
+   */
+  infiniteQuery: {
+    /**
+     * Resolves an infinite query hook function name.
+     *
+     * @example Infinite query hook names
+     * `resolver.infiniteQuery.name(node) // → 'useGetPetByIdInfinite'`
+     */
+    name(node: ast.OperationNode): string;
+    /**
+     * Resolves the infinite query options helper name.
+     */
+    optionsName(node: ast.OperationNode): string;
+    /**
+     * Resolves the infinite query key helper name.
+     */
+    keyName(node: ast.OperationNode): string;
+    /**
+     * Resolves the infinite query key type name.
+     */
+    keyTypeName(node: ast.OperationNode): string;
+    /**
+     * Resolves the client function name generated inline by infinite query hooks.
+     */
+    clientName(node: ast.OperationNode): string;
+  };
+  /**
+   * Naming for the generated `useSuspenseInfiniteQuery` hook and its companion helpers.
+   */
+  suspenseInfiniteQuery: {
+    /**
+     * Resolves a suspense infinite query hook function name.
+     *
+     * @example Suspense infinite query hook names
+     * `resolver.suspenseInfiniteQuery.name(node) // → 'useGetPetByIdSuspenseInfinite'`
+     */
+    name(node: ast.OperationNode): string;
+    /**
+     * Resolves the suspense infinite query options helper name.
+     */
+    optionsName(node: ast.OperationNode): string;
+    /**
+     * Resolves the suspense infinite query key helper name.
+     */
+    keyName(node: ast.OperationNode): string;
+    /**
+     * Resolves the suspense infinite query key type name.
+     */
+    keyTypeName(node: ast.OperationNode): string;
+    /**
+     * Resolves the client function name generated inline by suspense infinite query hooks.
+     */
+    clientName(node: ast.OperationNode): string;
+  };
+  /**
+   * Naming for the generated `useMutation` hook and its companion helpers.
+   */
+  mutation: {
+    /**
+     * Resolves a mutation hook function name.
+     *
+     * @example Mutation hook names
+     * `resolver.mutation.name(node) // → 'useUpdatePet'`
+     */
+    name(node: ast.OperationNode): string;
+    /**
+     * Resolves the mutation options helper name.
+     */
+    optionsName(node: ast.OperationNode): string;
+    /**
+     * Resolves the mutation key helper name.
+     */
+    keyName(node: ast.OperationNode): string;
+    /**
+     * Resolves the mutation type name.
+     *
+     * @example Mutation type names
+     * `resolver.mutation.typeName(node) // → 'UpdatePet'`
+     */
+    typeName(node: ast.OperationNode): string;
+  };
+  /**
+   * Naming for the generated custom hook options file.
+   */
+  hook: {
+    /**
+     * Resolves the generated custom hook options map type name.
+     */
+    optionsName(): string;
+    /**
+     * Resolves the helper function name used inside the custom hook options file.
+     */
+    customOptionsName(): string;
+  };
 };
 type Suspense = object;
 /**
@@ -313,7 +366,7 @@ type Options = OutputOptions & {
    * Override how hook names and file paths are built. Methods you omit fall
    * back to the default `resolverReactQuery`.
    */
-  resolver?: Partial<ResolverReactQuery> & ThisType<ResolverReactQuery>;
+  resolver?: ResolverPatch<ResolverReactQuery>;
   /**
    * Set to `false` to skip generating `use*` hook functions. `queryOptions`,
    * `mutationOptions`, `queryKey`, and `mutationKey` helpers are still emitted.