@hey-api/openapi-ts 0.74.0 → 0.75.0

package/dist/{types.d-jQzOw4mx.d.cts → types.d-CjrgVCUn.d.cts}

@@ -5093,6 +5093,7 @@ interface XMLObject$1 {
 }
 
 interface OpenApiV2_0_XTypes {
+    InfoObject: InfoObject$1;
     SchemaObject: SchemaObject$1;
 }
 
@@ -6378,6 +6379,7 @@ type OpenApiSchemaFormats =
 type Format = JsonSchemaFormats | OpenApiSchemaFormats | (string & {});
 
 interface OpenApiV3_0_XTypes {
+    InfoObject: InfoObject;
     ParameterObject: ParameterObject;
     ReferenceObject: ReferenceObject;
     RequestBodyObject: RequestBodyObject;
@@ -6386,6 +6388,7 @@ interface OpenApiV3_0_XTypes {
 }
 
 interface OpenApiV3_1_XTypes {
+    InfoObject: InfoObject$2;
     ParameterObject: ParameterObject$2;
     ReferenceObject: ReferenceObject$2;
     RequestBodyObject: RequestBodyObject$1;
@@ -6401,6 +6404,14 @@ declare namespace OpenApi {
   export type V3_1_X = OpenApiV3_1_X;
 }
 
+declare namespace OpenApiMetaObject {
+  export type V2_0_X = OpenApiV2_0_XTypes['InfoObject'];
+
+  export type V3_0_X = OpenApiV3_0_XTypes['InfoObject'];
+
+  export type V3_1_X = OpenApiV3_1_XTypes['InfoObject'];
+}
+
 declare namespace OpenApiParameterObject {
   export type V3_0_X =
     | OpenApiV3_0_XTypes['ParameterObject']
@@ -6439,6 +6450,42 @@ declare namespace OpenApiSchemaObject {
   export type V3_1_X = OpenApiV3_1_XTypes['SchemaObject'];
 }
 
+type WalkEvents =
+  | {
+      method: keyof IR.PathItemObject;
+      operation: IR.OperationObject;
+      path: string;
+      type: 'operation';
+    }
+  | {
+      $ref: string;
+      name: string;
+      parameter: IR.ParameterObject;
+      type: 'parameter';
+    }
+  | {
+      $ref: string;
+      name: string;
+      requestBody: IR.RequestBodyObject;
+      type: 'requestBody';
+    }
+  | {
+      $ref: string;
+      name: string;
+      schema: IR.SchemaObject;
+      type: 'schema';
+    }
+  | {
+      server: IR.ServerObject;
+      type: 'server';
+    };
+
+type WalkEventType = WalkEvents['type'];
+type WalkEvent<T extends WalkEventType = WalkEventType> = Extract<
+  WalkEvents,
+  { type: T }
+>;
+
 declare class PluginInstance<PluginConfig extends BaseConfig = BaseConfig> {
     config: Plugin.Config<PluginConfig>['config'];
     context: IR.Context;
@@ -6451,6 +6498,33 @@ declare class PluginInstance<PluginConfig extends BaseConfig = BaseConfig> {
         name: string;
     });
     createFile(file: IR.ContextFile): TypeScriptFile;
+    /**
+     * Iterates over various input elements as specified by the event types, in
+     * a specific order: servers, schemas, parameters, request bodies, then
+     * operations.
+     *
+     * This ensures, for example, that schemas are always processed before
+     * operations, which may reference them.
+     *
+     * @template T - The event type(s) to yield. Defaults to all event types.
+     * @param events - The event types to walk over. If none are provided, all event types are included.
+     * @param callback - Function to execute for each event.
+     *
+     * @example
+     * // Iterate over all operations and schemas
+     * plugin.forEach('operation', 'schema', (event) => {
+     *   if (event.type === 'operation') {
+     *     // handle operation
+     *   } else if (event.type === 'schema') {
+     *     // handle schema
+     *   }
+     * });
+     */
+    forEach<T extends WalkEventType = WalkEventType>(...args: [
+        ...events: ReadonlyArray<T>,
+        callback: (event: WalkEvent<T>) => void
+    ]): void;
+    private forEachError;
     /**
      * Retrieves a registered plugin instance by its name from the context. This
      * allows plugins to access other plugins that have been registered in the
@@ -6464,14 +6538,6 @@ declare class PluginInstance<PluginConfig extends BaseConfig = BaseConfig> {
      * Executes plugin's handler function.
      */
     run(): Promise<void>;
-    /**
-     * Subscribe to an input parser event.
-     *
-     * @param event Event type from the parser.
-     * @param callbackFn Function to execute on event.
-     * @returns void
-     */
-    subscribe<T extends keyof IR.ContextEvents>(event: T, callbackFn: IR.ContextEvents[T]): void;
 }
 
 type PluginClientNames =
@@ -7098,213 +7164,579 @@ interface Config$9 extends Plugin.Name<'@hey-api/typescript'> {
 }
 
 interface Config$8
-  extends Plugin.Name<'@tanstack/react-query'>,
-    TanStackQuery.Config {
+  extends Plugin.Name<'@tanstack/angular-query-experimental'> {
   /**
-   * Generate {@link https://tanstack.com/query/v5/docs/framework/react/reference/infiniteQueryOptions `infiniteQueryOptions()`} helpers? These will be generated from GET and POST requests where a pagination parameter is detected.
+   * The casing convention to use for generated names.
    *
-   * @default true
+   * @default 'camelCase'
    */
-  infiniteQueryOptions?: boolean;
+  case?: StringCase;
   /**
-   * Generate {@link https://tanstack.com/query/v5/docs/framework/react/reference/useMutation `useMutation()`} helpers? These will be generated from DELETE, PATCH, POST, and PUT requests.
+   * Add comments from SDK functions to the generated TanStack Query code?
    *
    * @default true
    */
-  mutationOptions?: boolean;
+  comments?: boolean;
+  /**
+   * Should the exports from the generated files be re-exported in the index barrel file?
+   *
+   * @default false
+   */
+  exportFromIndex?: boolean;
+  /**
+   * Configuration for generated infinite query key helpers.
+   *
+   * See {@link https://tanstack.com/query/v5/docs/framework/angular/reference/infiniteQueryOptions}
+   */
+  infiniteQueryKeys?:
+    | boolean
+    | string
+    | {
+        case?: StringCase;
+        enabled?: boolean;
+        name?: string | ((name: string) => string);
+      };
+  /**
+   * Configuration for generated infinite query options helpers.
+   *
+   * See {@link https://tanstack.com/query/v5/docs/framework/angular/reference/infiniteQueryOptions}
+   */
+  infiniteQueryOptions?:
+    | boolean
+    | string
+    | {
+        case?: StringCase;
+        enabled?: boolean;
+        name?: string | ((name: string) => string);
+      };
+  /**
+   * Configuration for generated mutation options helpers.
+   *
+   * See {@link https://tanstack.com/query/v5/docs/framework/angular/reference/useMutation}
+   */
+  mutationOptions?:
+    | boolean
+    | string
+    | {
+        case?: StringCase;
+        enabled?: boolean;
+        name?: string | ((name: string) => string);
+      };
   /**
    * Name of the generated file.
    *
-   * @default '@tanstack/react-query'
+   * @default '@tanstack/angular-query-experimental'
    */
   output?: string;
   /**
-   * Generate {@link https://tanstack.com/query/v5/docs/framework/react/reference/queryOptions `queryOptions()`} helpers?
-   * These will be generated from all requests.
+   * Configuration for generated query keys.
    *
-   * @default true
+   * See {@link https://tanstack.com/query/v5/docs/framework/angular/reference/queryKey}
    */
-  queryOptions?: boolean;
+  queryKeys?:
+    | boolean
+    | string
+    | {
+        case?: StringCase;
+        enabled?: boolean;
+        name?: string | ((name: string) => string);
+      };
+  /**
+   * Configuration for generated query options helpers.
+   *
+   * See {@link https://tanstack.com/query/v5/docs/framework/angular/reference/queryOptions}
+   */
+  queryOptions?:
+    | boolean
+    | string
+    | {
+        case?: StringCase;
+        enabled?: boolean;
+        name?: string | ((name: string) => string);
+      };
 }
 
-interface Config$7
-  extends Plugin.Name<'@tanstack/solid-query'>,
-    TanStackQuery.Config {
+interface Config$7 extends Plugin.Name<'@tanstack/react-query'> {
   /**
-   * Generate `createInfiniteQuery()` helpers? These will be generated from GET and POST requests where a pagination parameter is detected.
+   * The casing convention to use for generated names.
    *
-   * @default true
+   * @default 'camelCase'
    */
-  infiniteQueryOptions?: boolean;
+  case?: StringCase;
   /**
-   * Generate `createMutation()` helpers? These will be generated from DELETE, PATCH, POST, and PUT requests.
+   * Add comments from SDK functions to the generated TanStack Query code?
+   * Duplicating comments this way is useful so you don't need to drill into
+   * the underlying SDK function to learn what it does or whether it's
+   * deprecated. You can set this option to `false` if you prefer less
+   * comment duplication.
    *
    * @default true
    */
-  mutationOptions?: boolean;
+  comments?: boolean;
+  /**
+   * Should the exports from the generated files be re-exported in the index
+   * barrel file?
+   *
+   * @default false
+   */
+  exportFromIndex?: boolean;
+  /**
+   * Configuration for generated infinite query key helpers.
+   *
+   * See {@link https://tanstack.com/query/v5/docs/framework/react/reference/infiniteQueryOptions TanStack Query: infiniteQueryOptions}
+   *
+   * Can be:
+   * - `boolean`: Shorthand for `{ enabled: boolean }`
+   * - `string`: Shorthand for `{ enabled: true; name: string }`
+   * - `object`: Full configuration object
+   */
+  infiniteQueryKeys?:
+    | boolean
+    | string
+    | {
+        /**
+         * The casing convention to use for generated names.
+         *
+         * @default 'camelCase'
+         */
+        case?: StringCase;
+        /**
+         * Whether to generate infinite query key helpers.
+         *
+         * @default true
+         */
+        enabled?: boolean;
+        /**
+         * Custom naming pattern for generated infinite query key names. The name variable is
+         * obtained from the SDK function name.
+         *
+         * @default '{{name}}InfiniteQueryKey'
+         * @see https://tanstack.com/query/v5/docs/framework/react/reference/infiniteQueryOptions
+         */
+        name?: string | ((name: string) => string);
+      };
+  /**
+   * Configuration for generated infinite query options helpers.
+   *
+   * See {@link https://tanstack.com/query/v5/docs/framework/react/reference/infiniteQueryOptions TanStack Query: infiniteQueryOptions}
+   *
+   * Can be:
+   * - `boolean`: Shorthand for `{ enabled: boolean }`
+   * - `string`: Shorthand for `{ enabled: true; name: string }`
+   * - `object`: Full configuration object
+   */
+  infiniteQueryOptions?:
+    | boolean
+    | string
+    | {
+        /**
+         * The casing convention to use for generated names.
+         *
+         * @default 'camelCase'
+         */
+        case?: StringCase;
+        /**
+         * Whether to generate infinite query options helpers.
+         *
+         * @default true
+         */
+        enabled?: boolean;
+        /**
+         * Custom naming pattern for generated infinite query options names. The name variable is
+         * obtained from the SDK function name.
+         *
+         * @default '{{name}}InfiniteOptions'
+         * @see https://tanstack.com/query/v5/docs/framework/react/reference/infiniteQueryOptions
+         */
+        name?: string | ((name: string) => string);
+      };
+  /**
+   * Configuration for generated mutation options helpers.
+   *
+   * See {@link https://tanstack.com/query/v5/docs/framework/react/reference/useMutation TanStack Query: useMutation}
+   *
+   * Can be:
+   * - `boolean`: Shorthand for `{ enabled: boolean }`
+   * - `string`: Shorthand for `{ enabled: true; name: string }`
+   * - `object`: Full configuration object
+   */
+  mutationOptions?:
+    | boolean
+    | string
+    | {
+        /**
+         * The casing convention to use for generated names.
+         *
+         * @default 'camelCase'
+         */
+        case?: StringCase;
+        /**
+         * Whether to generate mutation options helpers.
+         *
+         * @default true
+         */
+        enabled?: boolean;
+        /**
+         * Custom naming pattern for generated mutation options names. The name variable is
+         * obtained from the SDK function name.
+         *
+         * @default '{{name}}Mutation'
+         * @see https://tanstack.com/query/v5/docs/framework/react/reference/useMutation
+         */
+        name?: string | ((name: string) => string);
+      };
   /**
    * Name of the generated file.
    *
-   * @default '@tanstack/solid-query'
+   * @default '@tanstack/react-query'
    */
   output?: string;
   /**
-   * Generate {@link https://tanstack.com/query/v5/docs/framework/solid/reference/createQuery `createQuery()`} helpers?
-   * These will be generated from all requests.
+   * Configuration for generated query keys.
    *
-   * @default true
+   * See {@link https://tanstack.com/query/v5/docs/framework/react/reference/queryKey TanStack Query: queryKey}
+   *
+   * Can be:
+   * - `boolean`: Shorthand for `{ enabled: boolean }`
+   * - `string`: Shorthand for `{ enabled: true; name: string }`
+   * - `object`: Full configuration object
+   */
+  queryKeys?:
+    | boolean
+    | string
+    | {
+        /**
+         * The casing convention to use for generated names.
+         *
+         * @default 'camelCase'
+         */
+        case?: StringCase;
+        /**
+         * Whether to generate query keys.
+         *
+         * @default true
+         */
+        enabled?: boolean;
+        /**
+         * Custom naming pattern for generated query key names. The name variable is
+         * obtained from the SDK function name.
+         *
+         * @default '{{name}}QueryKey'
+         * @see https://tanstack.com/query/v5/docs/framework/react/reference/queryKey
+         */
+        name?: string | ((name: string) => string);
+      };
+  /**
+   * Configuration for generated query options helpers.
+   *
+   * See {@link https://tanstack.com/query/v5/docs/framework/react/reference/queryOptions TanStack Query: queryOptions}
+   *
+   * Can be:
+   * - `boolean`: Shorthand for `{ enabled: boolean }`
+   * - `string`: Shorthand for `{ enabled: true; name: string }`
+   * - `object`: Full configuration object
    */
-  queryOptions?: boolean;
+  queryOptions?:
+    | boolean
+    | string
+    | {
+        /**
+         * The casing convention to use for generated names.
+         *
+         * @default 'camelCase'
+         */
+        case?: StringCase;
+        /**
+         * Whether to generate query options helpers.
+         *
+         * @default true
+         */
+        enabled?: boolean;
+        /**
+         * Custom naming pattern for generated query options names. The name variable is
+         * obtained from the SDK function name.
+         *
+         * @default '{{name}}Options'
+         * @see https://tanstack.com/query/v5/docs/framework/react/reference/queryOptions
+         */
+        name?: string | ((name: string) => string);
+      };
 }
 
-interface Config$6
-  extends Plugin.Name<'@tanstack/svelte-query'>,
-    TanStackQuery.Config {
+interface Config$6 extends Plugin.Name<'@tanstack/solid-query'> {
   /**
-   * Generate `createInfiniteQuery()` helpers? These will be generated from GET and POST requests where a pagination parameter is detected.
+   * The casing convention to use for generated names.
    *
-   * @default true
+   * @default 'camelCase'
    */
-  infiniteQueryOptions?: boolean;
+  case?: StringCase;
   /**
-   * Generate {@link https://tanstack.com/query/v5/docs/framework/svelte/reference/functions/createmutation `createMutation()`} helpers? These will be generated from DELETE, PATCH, POST, and PUT requests.
+   * Add comments from SDK functions to the generated TanStack Query code?
    *
    * @default true
    */
-  mutationOptions?: boolean;
+  comments?: boolean;
+  /**
+   * Should the exports from the generated files be re-exported in the index barrel file?
+   *
+   * @default false
+   */
+  exportFromIndex?: boolean;
+  /**
+   * Configuration for generated infinite query key helpers.
+   *
+   * See {@link https://tanstack.com/query/v5/docs/framework/solid/reference/createInfiniteQuery}
+   */
+  infiniteQueryKeys?:
+    | boolean
+    | string
+    | {
+        case?: StringCase;
+        enabled?: boolean;
+        name?: string | ((name: string) => string);
+      };
+  /**
+   * Configuration for generated infinite query options helpers.
+   *
+   * See {@link https://tanstack.com/query/v5/docs/framework/solid/reference/createInfiniteQuery}
+   */
+  infiniteQueryOptions?:
+    | boolean
+    | string
+    | {
+        case?: StringCase;
+        enabled?: boolean;
+        name?: string | ((name: string) => string);
+      };
+  /**
+   * Configuration for generated mutation options helpers.
+   *
+   * See {@link https://tanstack.com/query/v5/docs/framework/solid/reference/createMutation}
+   */
+  mutationOptions?:
+    | boolean
+    | string
+    | {
+        case?: StringCase;
+        enabled?: boolean;
+        name?: string | ((name: string) => string);
+      };
   /**
    * Name of the generated file.
    *
-   * @default '@tanstack/svelte-query'
+   * @default '@tanstack/solid-query'
    */
   output?: string;
   /**
-   * Generate {@link https://tanstack.com/query/v5/docs/framework/svelte/reference/functions/createquery `createQuery()`} helpers?
-   * These will be generated from all requests.
+   * Configuration for generated query keys.
    *
-   * @default true
+   * See {@link https://tanstack.com/query/v5/docs/framework/solid/reference/queryKey}
+   */
+  queryKeys?:
+    | boolean
+    | string
+    | {
+        case?: StringCase;
+        enabled?: boolean;
+        name?: string | ((name: string) => string);
+      };
+  /**
+   * Configuration for generated query options helpers.
+   *
+   * See {@link https://tanstack.com/query/v5/docs/framework/solid/reference/createQuery}
    */
-  queryOptions?: boolean;
+  queryOptions?:
+    | boolean
+    | string
+    | {
+        case?: StringCase;
+        enabled?: boolean;
+        name?: string | ((name: string) => string);
+      };
 }
 
-interface Config$5
-  extends Plugin.Name<'@tanstack/vue-query'>,
-    TanStackQuery.Config {
+interface Config$5 extends Plugin.Name<'@tanstack/svelte-query'> {
   /**
-   * Generate {@link https://tanstack.com/query/v5/docs/framework/vue/reference/infiniteQueryOptions `infiniteQueryOptions()`} helpers? These will be generated from GET and POST requests where a pagination parameter is detected.
+   * The casing convention to use for generated names.
    *
-   * @default true
+   * @default 'camelCase'
    */
-  infiniteQueryOptions?: boolean;
+  case?: StringCase;
   /**
-   * Generate {@link https://tanstack.com/query/v5/docs/framework/vue/reference/useMutation `useMutation()`} helpers? These will be generated from DELETE, PATCH, POST, and PUT requests.
+   * Add comments from SDK functions to the generated TanStack Query code?
    *
    * @default true
    */
-  mutationOptions?: boolean;
+  comments?: boolean;
+  /**
+   * Should the exports from the generated files be re-exported in the index barrel file?
+   *
+   * @default false
+   */
+  exportFromIndex?: boolean;
+  /**
+   * Configuration for generated infinite query key helpers.
+   *
+   * See {@link https://tanstack.com/query/v5/docs/framework/svelte/reference/createInfiniteQuery}
+   */
+  infiniteQueryKeys?:
+    | boolean
+    | string
+    | {
+        case?: StringCase;
+        enabled?: boolean;
+        name?: string | ((name: string) => string);
+      };
+  /**
+   * Configuration for generated infinite query options helpers.
+   *
+   * See {@link https://tanstack.com/query/v5/docs/framework/svelte/reference/createInfiniteQuery}
+   */
+  infiniteQueryOptions?:
+    | boolean
+    | string
+    | {
+        case?: StringCase;
+        enabled?: boolean;
+        name?: string | ((name: string) => string);
+      };
+  /**
+   * Configuration for generated mutation options helpers.
+   *
+   * See {@link https://tanstack.com/query/v5/docs/framework/svelte/reference/createMutation}
+   */
+  mutationOptions?:
+    | boolean
+    | string
+    | {
+        case?: StringCase;
+        enabled?: boolean;
+        name?: string | ((name: string) => string);
+      };
   /**
    * Name of the generated file.
    *
-   * @default '@tanstack/vue-query'
+   * @default '@tanstack/svelte-query'
    */
   output?: string;
   /**
-   * Generate {@link https://tanstack.com/query/v5/docs/framework/vue/guides/query-options `queryOptions()`} helpers?
-   * These will be generated from all requests.
+   * Configuration for generated query keys.
    *
-   * @default true
+   * See {@link https://tanstack.com/query/v5/docs/framework/svelte/reference/queryKey}
    */
-  queryOptions?: boolean;
-}
-
-/**
- * Public TanStack Query API.
- */
-declare namespace TanStackQuery {
-  export type Config = {
-    /**
-     * Add comments from SDK functions to the generated TanStack Query code?
-     * Duplicating comments this way is useful so you don't need to drill into
-     * the underlying SDK function to learn what it does or whether it's
-     * deprecated. You can set this option to `false` if you prefer less
-     * comment duplication.
-     *
-     * @default true
-     */
-    comments?: boolean;
-    /**
-     * Should the exports from the generated files be re-exported in the index
-     * barrel file?
-     *
-     * @default false
-     */
-    exportFromIndex?: boolean;
-    /**
-     * Customize the generated infinite query key names. The name variable is
-     * obtained from the SDK function name.
-     *
-     * @default '{{name}}InfiniteQueryKey'
-     */
-    infiniteQueryKeyNameBuilder?: string | ((name: string) => string);
-    /**
-     * Customize the generated infinite query options names. The name variable
-     * is obtained from the SDK function name.
-     *
-     * @default '{{name}}InfiniteOptions'
-     */
-    infiniteQueryOptionsNameBuilder?: string | ((name: string) => string);
-    /**
-     * Customize the generated mutation options names. The name variable is
-     * obtained from the SDK function name.
-     *
-     * @default '{{name}}Mutation'
-     */
-    mutationOptionsNameBuilder?: string | ((name: string) => string);
-    /**
-     * Customize the generated query key names. The name variable is obtained
-     * from the SDK function name.
-     *
-     * @default '{{name}}QueryKey'
-     */
-    queryKeyNameBuilder?: string | ((name: string) => string);
-    /**
-     * Customize the generated query options names. The name variable is
-     * obtained from the SDK function name.
-     *
-     * @default '{{name}}Options'
-     */
-    queryOptionsNameBuilder?: string | ((name: string) => string);
-  };
+  queryKeys?:
+    | boolean
+    | string
+    | {
+        case?: StringCase;
+        enabled?: boolean;
+        name?: string | ((name: string) => string);
+      };
+  /**
+   * Configuration for generated query options helpers.
+   *
+   * See {@link https://tanstack.com/query/v5/docs/framework/svelte/reference/createQuery}
+   */
+  queryOptions?:
+    | boolean
+    | string
+    | {
+        case?: StringCase;
+        enabled?: boolean;
+        name?: string | ((name: string) => string);
+      };
 }
 
-interface Config$4
-  extends Plugin.Name<'@tanstack/angular-query-experimental'>,
-    TanStackQuery.Config {
+interface Config$4 extends Plugin.Name<'@tanstack/vue-query'> {
   /**
-   * Generate {@link https://tanstack.com/query/v5/docs/framework/angular/reference/infiniteQueryOptions `infiniteQueryOptions()`} helpers? These will be generated from GET and POST requests where a pagination parameter is detected.
+   * The casing convention to use for generated names.
    *
-   * @default true
+   * @default 'camelCase'
    */
-  infiniteQueryOptions?: boolean;
+  case?: StringCase;
   /**
-   * Generate {@link https://tanstack.com/query/v5/docs/framework/angular/reference/useMutation `useMutation()`} helpers? These will be generated from DELETE, PATCH, POST, and PUT requests.
+   * Add comments from SDK functions to the generated TanStack Query code?
    *
    * @default true
    */
-  mutationOptions?: boolean;
+  comments?: boolean;
+  /**
+   * Should the exports from the generated files be re-exported in the index barrel file?
+   *
+   * @default false
+   */
+  exportFromIndex?: boolean;
+  /**
+   * Configuration for generated infinite query key helpers.
+   *
+   * See {@link https://tanstack.com/query/v5/docs/framework/vue/reference/infiniteQueryOptions}
+   */
+  infiniteQueryKeys?:
+    | boolean
+    | string
+    | {
+        case?: StringCase;
+        enabled?: boolean;
+        name?: string | ((name: string) => string);
+      };
+  /**
+   * Configuration for generated infinite query options helpers.
+   *
+   * See {@link https://tanstack.com/query/v5/docs/framework/vue/reference/infiniteQueryOptions}
+   */
+  infiniteQueryOptions?:
+    | boolean
+    | string
+    | {
+        case?: StringCase;
+        enabled?: boolean;
+        name?: string | ((name: string) => string);
+      };
+  /**
+   * Configuration for generated mutation options helpers.
+   *
+   * See {@link https://tanstack.com/query/v5/docs/framework/vue/reference/useMutation}
+   */
+  mutationOptions?:
+    | boolean
+    | string
+    | {
+        case?: StringCase;
+        enabled?: boolean;
+        name?: string | ((name: string) => string);
+      };
   /**
    * Name of the generated file.
    *
-   * @default '@tanstack/angular-query-experimental'
+   * @default '@tanstack/vue-query'
    */
   output?: string;
   /**
-   * Generate {@link https://tanstack.com/query/v5/docs/framework/angular/reference/queryOptions `queryOptions()`} helpers?
-   * These will be generated from all requests.
+   * Configuration for generated query keys.
    *
-   * @default true
+   * See {@link https://tanstack.com/query/v5/docs/framework/vue/reference/queryKey}
    */
-  queryOptions?: boolean;
+  queryKeys?:
+    | boolean
+    | string
+    | {
+        case?: StringCase;
+        enabled?: boolean;
+        name?: string | ((name: string) => string);
+      };
+  /**
+   * Configuration for generated query options helpers.
+   *
+   * See {@link https://tanstack.com/query/v5/docs/framework/vue/reference/queryOptions}
+   */
+  queryOptions?:
+    | boolean
+    | string
+    | {
+        case?: StringCase;
+        enabled?: boolean;
+        name?: string | ((name: string) => string);
+      };
 }
 
 interface Config$3 extends Plugin.Name<'fastify'> {
@@ -7491,11 +7923,11 @@ interface Config$1 extends Plugin.Name<'zod'> {
 /**
  * User-facing plugin types.
  */
-type UserPlugins = Plugin.UserConfig<Config$i> | Plugin.UserConfig<Config$l> | Plugin.UserConfig<Config$k> | Plugin.UserConfig<Config$j> | Plugin.UserConfig<Config$h> | Plugin.UserConfig<Config$g> | Plugin.UserConfig<Config$f> | Plugin.UserConfig<Config$e> | Plugin.UserConfig<Config$d> | Plugin.UserConfig<Config$c> | Plugin.UserConfig<Config$b> | Plugin.UserConfig<Config$a> | Plugin.UserConfig<Config$9> | Plugin.UserConfig<Config$4> | Plugin.UserConfig<Config$8> | Plugin.UserConfig<Config$7> | Plugin.UserConfig<Config$6> | Plugin.UserConfig<Config$5> | Plugin.UserConfig<Config$3> | Plugin.UserConfig<Config$2> | Plugin.UserConfig<Config$1>;
+type UserPlugins = Plugin.UserConfig<Config$i> | Plugin.UserConfig<Config$l> | Plugin.UserConfig<Config$k> | Plugin.UserConfig<Config$j> | Plugin.UserConfig<Config$h> | Plugin.UserConfig<Config$g> | Plugin.UserConfig<Config$f> | Plugin.UserConfig<Config$e> | Plugin.UserConfig<Config$d> | Plugin.UserConfig<Config$c> | Plugin.UserConfig<Config$b> | Plugin.UserConfig<Config$a> | Plugin.UserConfig<Config$9> | Plugin.UserConfig<Config$8> | Plugin.UserConfig<Config$7> | Plugin.UserConfig<Config$6> | Plugin.UserConfig<Config$5> | Plugin.UserConfig<Config$4> | Plugin.UserConfig<Config$3> | Plugin.UserConfig<Config$2> | Plugin.UserConfig<Config$1>;
 /**
  * Internal plugin types.
  */
-type ClientPlugins = Plugin.Config<Config$i> | Plugin.Config<Config$l> | Plugin.Config<Config$k> | Plugin.Config<Config$j> | Plugin.Config<Config$h> | Plugin.Config<Config$g> | Plugin.Config<Config$f> | Plugin.Config<Config$e> | Plugin.Config<Config$d> | Plugin.Config<Config$c> | Plugin.Config<Config$b> | Plugin.Config<Config$a> | Plugin.Config<Config$9> | Plugin.Config<Config$4> | Plugin.Config<Config$8> | Plugin.Config<Config$7> | Plugin.Config<Config$6> | Plugin.Config<Config$5> | Plugin.Config<Config$3> | Plugin.Config<Config$2> | Plugin.Config<Config$1>;
+type ClientPlugins = Plugin.Config<Config$i> | Plugin.Config<Config$l> | Plugin.Config<Config$k> | Plugin.Config<Config$j> | Plugin.Config<Config$h> | Plugin.Config<Config$g> | Plugin.Config<Config$f> | Plugin.Config<Config$e> | Plugin.Config<Config$d> | Plugin.Config<Config$c> | Plugin.Config<Config$b> | Plugin.Config<Config$a> | Plugin.Config<Config$9> | Plugin.Config<Config$8> | Plugin.Config<Config$7> | Plugin.Config<Config$6> | Plugin.Config<Config$5> | Plugin.Config<Config$4> | Plugin.Config<Config$3> | Plugin.Config<Config$2> | Plugin.Config<Config$1>;
 
 interface Input {
   /**
@@ -7738,12 +8170,43 @@ interface Filters {
 }
 
 interface Patch {
+  /**
+   * Patch the OpenAPI meta object in place. Useful for modifying general metadata such as title, description, version, or custom fields before further processing.
+   *
+   * @param meta The OpenAPI meta object for the current version.
+   */
+  meta?: (
+    meta:
+      | OpenApiMetaObject.V2_0_X
+      | OpenApiMetaObject.V3_0_X
+      | OpenApiMetaObject.V3_1_X,
+  ) => void;
+  /**
+   * Patch OpenAPI parameters in place. The key is the parameter name, and the function receives the parameter object to modify directly.
+   *
+   * @example
+   * parameters: {
+   *   limit: (parameter) => {
+   *     parameter.schema.type = 'integer';
+   *   }
+   * }
+   */
   parameters?: Record<
     string,
     (
       parameter: OpenApiParameterObject.V3_0_X | OpenApiParameterObject.V3_1_X,
     ) => void
   >;
+  /**
+   * Patch OpenAPI request bodies in place. The key is the request body name, and the function receives the request body object to modify directly.
+   *
+   * @example
+   * requestBodies: {
+   *   CreateUserRequest: (requestBody) => {
+   *     requestBody.required = true;
+   *   }
+   * }
+   */
   requestBodies?: Record<
     string,
     (
@@ -7752,6 +8215,16 @@ interface Patch {
         | OpenApiRequestBodyObject.V3_1_X,
     ) => void
   >;
+  /**
+   * Patch OpenAPI responses in place. The key is the response name, and the function receives the response object to modify directly.
+   *
+   * @example
+   * responses: {
+   *   NotFound: (response) => {
+   *     response.description = 'Resource not found.';
+   *   }
+   * }
+   */
   responses?: Record<
     string,
     (
@@ -7795,6 +8268,17 @@ interface Patch {
         | OpenApiSchemaObject.V3_1_X,
     ) => void
   >;
+  /**
+   * Patch the OpenAPI version string. The function receives the current version and should return the new version string.
+   * Useful for normalizing or overriding the version value before further processing.
+   *
+   * @param version The current OpenAPI version string.
+   * @returns The new version string to use.
+   *
+   * @example
+   * version: (version) => version.replace(/^v/, '')
+   */
+  version?: (version: string) => string;
 }
 
 interface Watch {
@@ -8203,39 +8687,6 @@ interface ContextFile {
      */
     path: string;
 }
-interface Events {
-    /**
-     * Called after parsing.
-     */
-    after: () => void;
-    /**
-     * Called before parsing.
-     */
-    before: () => void;
-    operation: (args: {
-        method: keyof IR.PathItemObject;
-        operation: IR.OperationObject;
-        path: string;
-    }) => void;
-    parameter: (args: {
-        $ref: string;
-        name: string;
-        parameter: IR.ParameterObject;
-    }) => void;
-    requestBody: (args: {
-        $ref: string;
-        name: string;
-        requestBody: IR.RequestBodyObject;
-    }) => void;
-    schema: (args: {
-        $ref: string;
-        name: string;
-        schema: IR.SchemaObject;
-    }) => void;
-    server: (args: {
-        server: IR.ServerObject;
-    }) => void;
-}
 declare class IRContext<Spec extends Record<string, any> = any> {
     /**
      * Configuration for parsing and generating the output. This
@@ -8260,18 +8711,10 @@ declare class IRContext<Spec extends Record<string, any> = any> {
      * Resolved specification from `input`.
      */
     spec: Spec;
-    /**
-     * A map of event listeners.
-     */
-    private listeners;
     constructor({ config, spec }: {
         config: Config;
         spec: Spec;
     });
-    /**
-     * Notify all event listeners about `event`.
-     */
-    broadcast<T extends keyof Events>(event: T, ...args: Parameters<Events[T]>): Promise<void>;
     /**
      * Create and return a new TypeScript file. Also set the current file context
      * to the newly created file.
@@ -8295,19 +8738,18 @@ declare class IRContext<Spec extends Record<string, any> = any> {
      */
     private registerPlugin;
     /**
-     * Generator that iterates through plugin order and registers each plugin.
-     * Yields the registered plugin instance for each plugin name.
+     * Registers all plugins in the order specified by the configuration and returns
+     * an array of the registered PluginInstance objects. Each plugin is instantiated
+     * and added to the context's plugins map.
+     *
+     * @returns {ReadonlyArray<PluginInstance>} An array of registered plugin instances in order.
      */
-    registerPlugins(): Generator<PluginInstance>;
+    registerPlugins(): ReadonlyArray<PluginInstance>;
     resolveIrRef<T>($ref: string): T;
     /**
      * Returns a resolved reference from `spec`.
      */
     resolveRef<T>($ref: string): T;
-    /**
-     * Register a new `event` listener.
-     */
-    subscribe<T extends keyof Events>(event: T, callbackFn: Events[T], pluginName: string): void;
 }
 
 type IRMediaType = 'form-data' | 'json' | 'text' | 'url-search-params' | 'octet-stream';
@@ -8523,7 +8965,6 @@ declare namespace IR {
   export type BodyObject = IRBodyObject;
   export type ComponentsObject = IRComponentsObject;
   export type Context<Spec extends Record<string, any> = any> = IRContext<Spec>;
-  export type ContextEvents = Events;
   export type ContextFile = ContextFile;
   export type Model = IRModel;
   export type OperationObject = IROperationObject;