@kubb/plugin-vue-query 5.0.0-alpha.9 → 5.0.0-beta.100

package/dist/index.d.ts

@@ -1,10 +1,362 @@
-import { t as __name } from "./chunk--u3MIqq1.js";
-import { n as Options, r as PluginVueQuery } from "./types-CgDFUvfZ.js";
-import * as _kubb_core0 from "@kubb/core";
-
+import { t as __name } from "./rolldown-runtime-C0LytTxp.js";
+import { Exclude, Group, Include, Output, OutputOptions, Override, PluginFactoryOptions, Resolver, ResolverPatch, ast } from "kubb/kit";
+import "@kubb/plugin-ts";
+import "kubb/jsx";
+import "@kubb/plugin-zod";
+//#region ../../internals/client/src/resolveClient.d.ts
+/**
+ * Resolves which client plugin a consumer (react-query, vue-query, swr, mcp) should call for an
+ * operation, shared so the selection rules and diagnostics stay in one place.
+ *
+ * Every client runtime lives in a dedicated client plugin, so a consumer always calls a registered
+ * contract client plugin (plugin-fetch or plugin-axios) and never emits its own inline client:
+ *
+ * - `contract` — a registered contract client plugin owns the `<op>` functions and the consumer
+ *   imports and calls them.
+ * - `error` — no client plugin is registered, several are registered without a selector, or the
+ *   requested one is missing.
+ *
+ * The `client` string selects explicitly (`'fetch'` / `'axios'`); when it is unset a lone registered
+ * contract client plugin is picked up automatically.
+ */
+/**
+ * The client selector accepted by a consumer's `client` option. Both call a registered contract
+ * client plugin.
+ */
+type ClientSelector = 'fetch' | 'axios';
+/**
+ * The resolved client strategy stored in a consumer plugin's options: the generated code always
+ * imports and calls a registered contract client plugin's `<op>`. The client runtime lives in
+ * plugin-axios / plugin-fetch, so nothing is bundled by the consumer.
+ */
+type ResolvedContractClient = {
+  kind: 'contract';
+  pluginName: string;
+};
+//#endregion
+//#region ../../internals/tanstack-query/src/types.d.ts
+type ParamsCasing = 'camelcase' | undefined;
+type Transformer = (props: {
+  node: ast.OperationNode;
+  casing: ParamsCasing;
+}) => Array<unknown>;
+/**
+ * Configures the query side of a TanStack-family plugin: which HTTP methods produce query
+ * hooks and where the query runtime is imported from.
+ */
+type Query = {
+  /**
+   * HTTP methods treated as queries. Operations using these methods produce
+   * `useQuery`-style hooks.
+   *
+   * @default ['GET']
+   */
+  methods?: Array<string>;
+  /**
+   * Module specifier used in the `import { useQuery } from '...'` statement at
+   * the top of every generated file. Each plugin defaults this to its own runtime
+   * package. Useful for routing through a wrapper that injects a default
+   * `queryClient`.
+   */
+  importPath?: string;
+};
+/**
+ * Configures the mutation side of a TanStack-family plugin: which HTTP methods produce
+ * mutation hooks and where the mutation runtime is imported from.
+ */
+type Mutation = {
+  /**
+   * HTTP methods treated as mutations. Operations using these methods produce
+   * `useMutation`-style hooks.
+   *
+   * @default ['POST', 'PUT', 'PATCH', 'DELETE']
+   */
+  methods?: Array<string>;
+  /**
+   * Module specifier used in the `import { useMutation } from '...'` statement
+   * at the top of every generated file. Each plugin defaults this to its own
+   * runtime package.
+   */
+  importPath?: string;
+};
+type Infinite = {
+  /**
+   * Name of the query parameter that holds the page cursor.
+   *
+   * @default 'id'
+   */
+  queryParam?: string;
+  /**
+   * Path to the cursor field on the response. Leave undefined when the cursor
+   * is not known.
+   *
+   * @deprecated Use `nextParam` and `previousParam` for richer pagination control.
+   */
+  cursorParam?: string | null;
+  /**
+   * Path to the next-page cursor on the response. Supports dot notation
+   * (`'pagination.next.id'`) or array form (`['pagination', 'next', 'id']`).
+   */
+  nextParam?: string | Array<string> | null;
+  /**
+   * Path to the previous-page cursor on the response. Supports dot notation
+   * or array form.
+   */
+  previousParam?: string | Array<string> | null;
+  /**
+   * Initial value for `pageParam` on the first fetch.
+   *
+   * @default 0
+   */
+  initialPageParam?: unknown;
+};
+//#endregion
+//#region src/types.d.ts
+/**
+ * Resolver for Vue Query that provides naming methods for hook functions.
+ */
+type ResolverVueQuery = Resolver & {
+  /**
+   * Names for a query operation: its `useQuery` composable, key helpers, options helper, and the
+   * inline client function it calls.
+   */
+  query: {
+    /**
+     * Resolves a query hook function name.
+     */
+    name(node: ast.OperationNode): string;
+    /**
+     * Resolves the query key helper name.
+     */
+    keyName(node: ast.OperationNode): string;
+    /**
+     * Resolves the query key type name.
+     */
+    keyTypeName(node: ast.OperationNode): string;
+    /**
+     * Resolves the query options helper name.
+     */
+    optionsName(node: ast.OperationNode): string;
+    /**
+     * Resolves the client function name generated inline by query hooks.
+     */
+    clientName(node: ast.OperationNode): string;
+  };
+  /**
+   * Names for an infinite query operation: its `useInfiniteQuery` composable, key helpers, options
+   * helper, and the inline client function it calls.
+   */
+  infiniteQuery: {
+    /**
+     * Resolves an infinite query hook function name.
+     */
+    name(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 infinite query options helper name.
+     */
+    optionsName(node: ast.OperationNode): string;
+    /**
+     * Resolves the client function name generated inline by infinite query hooks.
+     */
+    clientName(node: ast.OperationNode): string;
+  };
+  /**
+   * Names for a mutation operation: its `useMutation` composable, key helper, and type name.
+   */
+  mutation: {
+    /**
+     * Resolves a mutation hook function name.
+     */
+    name(node: ast.OperationNode): string;
+    /**
+     * Resolves the mutation key helper name.
+     */
+    keyName(node: ast.OperationNode): string;
+    /**
+     * Resolves the mutation type name.
+     */
+    typeName(node: ast.OperationNode): string;
+  };
+};
+/**
+ * Builds the `queryKey` used by each generated query composable.
+ *
+ * @note String values are inlined verbatim into generated code. Wrap literal
+ * strings in `JSON.stringify(...)`.
+ */
+type QueryKey = Transformer;
+/**
+ * Builds the `mutationKey` used by each generated mutation composable.
+ *
+ * @note String values are inlined verbatim into generated code. Wrap literal
+ * strings in `JSON.stringify(...)`.
+ */
+type MutationKey = Transformer;
+/**
+ * Where the generated composables are written and how they are exported, plus the optional
+ * `group` strategy. The `group` option organizes `output.mode: 'directory'` output into per-tag or per-path subdirectories.
+ *
+ * @default { path: 'hooks', barrel: { type: 'named' } }
+ */
+type Options = OutputOptions & {
+  /**
+   * Selects the HTTP client the generated composables call. Every client plugin speaks the `RequestResult`
+   * contract, so the composables call a contract `<op>` that takes one grouped `options` object.
+   *
+   * - `'fetch'` / `'axios'` calls the `@kubb/plugin-fetch` / `@kubb/plugin-axios` functions. When a
+   *   single client plugin (plugin-fetch or plugin-axios) is registered it is
+   *   auto-detected, so the string is only needed to disambiguate several client plugins.
+   *
+   * A client plugin must be registered. The composables always call its `<op>`.
+   */
+  client?: ClientSelector;
+  /**
+   * Skip operations matching at least one entry in the list.
+   */
+  exclude?: Array<Exclude>;
+  /**
+   * Restrict generation to operations matching at least one entry in the list.
+   */
+  include?: Array<Include>;
+  /**
+   * Apply a different options object to operations matching a pattern.
+   */
+  override?: Array<Override<ResolvedOptions>>;
+  /**
+   * Enables `useInfiniteQuery` composables for cursor- or page-based pagination.
+   * Pass an object to configure how the cursor is read, or pass `false` to skip.
+   *
+   * @default false
+   */
+  infinite?: Partial<Infinite> | false;
+  /**
+   * Custom `queryKey` builder.
+   */
+  queryKey?: QueryKey;
+  /**
+   * Configures query composables. Set to `false` to skip composable generation
+   * and emit only `queryOptions(...)` helpers.
+   */
+  query?: Partial<Query> | false;
+  /**
+   * Custom `mutationKey` builder.
+   */
+  mutationKey?: MutationKey;
+  /**
+   * Configures mutation composables. Set to `false` to skip mutation generation.
+   */
+  mutation?: Partial<Mutation> | false;
+  /**
+   * Override how composable names and file paths are built.
+   */
+  resolver?: ResolverPatch<ResolverVueQuery>;
+  /**
+   * Set to `false` to skip generating `use*` composable functions. `queryOptions`,
+   * `queryKey`, and `mutationKey` helpers are still emitted.
+   *
+   * @default false
+   */
+  hooks?: boolean;
+  /**
+   * Macros applied to each operation node before printing.
+   */
+  macros?: Array<ast.Macro>;
+};
+/**
+ * The resolved client strategy for the generated composables, computed once during setup. The
+ * composables always import and call a registered contract client plugin's `<op>`.
+ */
+type ResolvedClient = ResolvedContractClient;
+type ResolvedOptions = {
+  output: Output;
+  group: Group | null;
+  exclude: NonNullable<Options['exclude']>;
+  include: Options['include'];
+  override: NonNullable<Options['override']>;
+  /**
+   * The resolved contract client the generators import and call.
+   */
+  client: ResolvedClient;
+  /**
+   * Resolved infinite query configuration, or `false` when infinite queries are disabled.
+   */
+  infinite: NonNullable<Infinite> | false;
+  queryKey: QueryKey | null;
+  query: NonNullable<Required<Query>> | false;
+  mutationKey: MutationKey | null;
+  mutation: NonNullable<Required<Mutation>> | false;
+  hooks: boolean;
+  resolver: ResolverVueQuery;
+};
+type PluginVueQuery = PluginFactoryOptions<'plugin-vue-query', Options, ResolvedOptions, ResolverVueQuery>;
+declare global {
+  namespace Kubb {
+    interface PluginRegistry {
+      'plugin-vue-query': PluginVueQuery;
+    }
+  }
+}
+//#endregion
 //#region src/plugin.d.ts
+/**
+ * Canonical plugin name for `@kubb/plugin-vue-query`. Used for driver lookups
+ * and cross-plugin dependency references.
+ */
 declare const pluginVueQueryName = "plugin-vue-query";
-declare const pluginVueQuery: (options?: Options | undefined) => _kubb_core0.UserPluginWithLifeCycle<PluginVueQuery>;
+/**
+ * Generates one TanStack Query composable per OpenAPI operation for Vue's
+ * Composition API. Queries become `useFoo` (and optionally
+ * `useFooInfinite`). Mutations become `useFoo` as well. Each composable
+ * is fully typed end to end.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from 'kubb/config'
+ * import { pluginTs } from '@kubb/plugin-ts'
+ * import { pluginVueQuery } from '@kubb/plugin-vue-query'
+ *
+ * export default defineConfig({
+ *   input: './petStore.yaml',
+ *   output: { path: './src/gen' },
+ *   plugins: [
+ *     pluginTs(),
+ *     pluginVueQuery({
+ *       output: { path: './hooks' },
+ *     }),
+ *   ],
+ * })
+ * ```
+ */
+declare const pluginVueQuery: (options?: Options | undefined) => import("kubb/kit").Plugin<PluginVueQuery>;
+//#endregion
+//#region src/resolvers/resolverVueQuery.d.ts
+/**
+ * Default resolver used by `@kubb/plugin-vue-query`. Decides the names and
+ * file paths for every generated TanStack Query composable (`useFoo`,
+ * `useFooInfinite`) and its companion helpers.
+ *
+ * The `default` helpers are supplied by `createResolver`. Functions and files use camelCase;
+ * composables get the `use` prefix. Operation-specific naming is grouped under the `query`,
+ * `infiniteQuery`, and `mutation` namespaces.
+ *
+ * @example Resolve composable and helper names
+ * ```ts
+ * import { resolverVueQuery } from '@kubb/plugin-vue-query'
+ *
+ * resolverVueQuery.query.name(operationNode)        // 'useGetPetById'
+ * resolverVueQuery.query.keyName(operationNode)     // 'getPetByIdQueryKey'
+ * resolverVueQuery.query.optionsName(operationNode) // 'getPetByIdQueryOptions'
+ * ```
+ */
+declare const resolverVueQuery: ResolverVueQuery;
 //#endregion
-export { type PluginVueQuery, pluginVueQuery, pluginVueQueryName };
+export { type PluginVueQuery, type ResolverVueQuery, pluginVueQuery as default, pluginVueQuery, pluginVueQueryName, resolverVueQuery };
 //# sourceMappingURL=index.d.ts.map