@hey-api/openapi-ts 0.86.2 → 0.86.3

package/dist/{types-BT1ededZ.d.cts → types-CBGf9bNY.d.cts}

@@ -1,7 +1,7 @@
-import { IProject, Project, Selector, Symbol, SymbolIn } from "@hey-api/codegen-core";
 import fs from "node:fs";
 import * as typescript0 from "typescript";
 import ts from "typescript";
+import { IProject, Project, Selector, Symbol, SymbolIn } from "@hey-api/codegen-core";
 import { RangeOptions, SemVer } from "semver";
 
 //#region rolldown:runtime
@@ -2946,52 +2946,7 @@ type Package = {
   satisfies: (nameOrVersion: string | SemVer, range: string, optionsOrLoose?: boolean | RangeOptions) => boolean;
 };
 //#endregion
-//#region src/utils/logger.d.ts
-declare class Logger {
-  private events;
-  private end;
-  report(print?: boolean): PerformanceMeasure | undefined;
-  private reportEvent;
-  private start;
-  private storeEvent;
-  timeEvent(name: string): {
-    mark: PerformanceMark;
-    timeEnd: () => void;
-  };
-}
-//#endregion
-//#region src/openApi/shared/utils/graph.d.ts
-/**
- * Represents the possible access scopes for OpenAPI nodes.
- * - 'normal': Default scope for regular nodes.
- * - 'read': Node is read-only (e.g., readOnly: true).
- * - 'write': Node is write-only (e.g., writeOnly: true).
- */
-type Scope = 'normal' | 'read' | 'write';
-/**
- * Information about a node in the OpenAPI graph.
- *
- * @property deprecated - Whether the node is deprecated. Optional.
- * @property key - The property name or array index in the parent, or null for root.
- * @property node - The actual object at this pointer in the spec.
- * @property parentPointer - The JSON Pointer of the parent node, or null for root.
- * @property scopes - The set of access scopes for this node, if any. Optional.
- * @property tags - The set of tags for this node, if any. Optional.
- */
-type NodeInfo = {
-  /** Whether the node is deprecated. Optional. */
-  deprecated?: boolean;
-  /** The property name or array index in the parent, or null for root. */
-  key: string | number | null;
-  /** The actual object at this pointer in the spec.  */
-  node: unknown;
-  /** The JSON Pointer of the parent node, or null for root. */
-  parentPointer: string | null;
-  /** The set of access scopes for this node, if any. Optional. */
-  scopes?: Set<Scope>;
-  /** The set of tags for this node, if any. Optional. */
-  tags?: Set<string>;
-};
+//#region src/graph/types/graph.d.ts
 /**
  * The main graph structure for OpenAPI node analysis.
  *
@@ -3027,6 +2982,79 @@ type Graph = {
    */
   transitiveDependencies: Map<string, Set<string>>;
 };
+/**
+ * Information about a node in the OpenAPI graph.
+ *
+ * @property deprecated - Whether the node is deprecated. Optional.
+ * @property key - The property name or array index in the parent, or null for root.
+ * @property node - The actual object at this pointer in the spec.
+ * @property parentPointer - The JSON Pointer of the parent node, or null for root.
+ * @property scopes - The set of access scopes for this node, if any. Optional.
+ * @property tags - The set of tags for this node, if any. Optional.
+ */
+type NodeInfo = {
+  /** Whether the node is deprecated. Optional. */
+  deprecated?: boolean;
+  /** The property name or array index in the parent, or null for root. */
+  key: string | number | null;
+  /** The actual object at this pointer in the spec.  */
+  node: unknown;
+  /** The JSON Pointer of the parent node, or null for root. */
+  parentPointer: string | null;
+  /** The set of access scopes for this node, if any. Optional. */
+  scopes?: Set<Scope>;
+  /** The set of tags for this node, if any. Optional. */
+  tags?: Set<string>;
+};
+//#endregion
+//#region src/graph/types/walk.d.ts
+type GetPointerPriorityFn = (pointer: string) => number;
+type MatchPointerToGroupFn<T$1 extends string = string> = (pointer: string, kind?: T$1) => PointerGroupMatch<T$1>;
+type PointerGroupMatch<T$1 extends string = string> = {
+  kind: T$1;
+  matched: true;
+} | {
+  kind?: undefined;
+  matched: false;
+};
+type WalkOptions<T$1 extends string = string> = {
+  /**
+   * Optional priority function used to compute a numeric priority for each
+   * pointer. Lower values are emitted earlier. Useful to customize ordering
+   * beyond the built-in group preferences.
+   */
+  getPointerPriority?: GetPointerPriorityFn;
+  /**
+   * Optional function to match a pointer to a group name.
+   *
+   * @param pointer The pointer string
+   * @returns The group name, or undefined if no match
+   */
+  matchPointerToGroup?: MatchPointerToGroupFn<T$1>;
+  /**
+   * Order of walking schemas.
+   *
+   * The "declarations" option ensures that schemas are walked in the order
+   * they are declared in the input document. This is useful for scenarios where
+   * the order of declaration matters, such as when generating code that relies
+   * on the sequence of schema definitions.
+   *
+   * The "topological" option ensures that schemas are walked in an order
+   * where dependencies are visited before the schemas that depend on them.
+   * This is useful for scenarios where you need to process or generate
+   * schemas in a way that respects their interdependencies.
+   *
+   * @default 'topological'
+   */
+  order?: 'declarations' | 'topological';
+  /**
+   * Optional grouping preference for walking. When provided, walk function
+   * will prefer emitting kinds listed earlier in this array when it is safe
+   * to do so (it will only apply the preference when doing so does not
+   * violate dependency ordering).
+   */
+  preferGroups?: ReadonlyArray<T$1>;
+};
 //#endregion
 //#region src/config/utils/config.d.ts
 type ObjectType<T$1> = Extract<T$1, Record<string, any>> extends never ? Record<string, any> : Extract<T$1, Record<string, any>>;
@@ -6557,7 +6585,7 @@ interface OpenApiV3_1_XTypes {
 }
 //#endregion
 //#region src/openApi/types.d.ts
-declare namespace OpenApi$1 {
+declare namespace OpenApi$3 {
   export type V2_0_X = OpenApiV2_0_X;
   export type V3_0_X = OpenApiV3_0_X;
   export type V3_1_X = OpenApiV3_1_X;
@@ -6590,6 +6618,322 @@ declare namespace OpenApiSchemaObject {
   export type V3_1_X = OpenApiV3_1_XTypes['SchemaObject'];
 }
 //#endregion
+//#region src/ir/graph.d.ts
+declare const irTopLevelKinds: readonly ["operation", "parameter", "requestBody", "schema", "server", "webhook"];
+type IrTopLevelKind = (typeof irTopLevelKinds)[number];
+//#endregion
+//#region src/plugins/shared/types/instance.d.ts
+type WalkEvents = {
+  _path: ReadonlyArray<string | number>;
+  method: keyof IR$1.PathItemObject;
+  operation: IR$1.OperationObject;
+  path: string;
+  type: Extract<IrTopLevelKind, 'operation'>;
+} | {
+  $ref: string;
+  _path: ReadonlyArray<string | number>;
+  name: string;
+  parameter: IR$1.ParameterObject;
+  type: Extract<IrTopLevelKind, 'parameter'>;
+} | {
+  $ref: string;
+  _path: ReadonlyArray<string | number>;
+  name: string;
+  requestBody: IR$1.RequestBodyObject;
+  type: Extract<IrTopLevelKind, 'requestBody'>;
+} | {
+  $ref: string;
+  _path: ReadonlyArray<string | number>;
+  name: string;
+  schema: IR$1.SchemaObject;
+  type: Extract<IrTopLevelKind, 'schema'>;
+} | {
+  _path: ReadonlyArray<string | number>;
+  server: IR$1.ServerObject;
+  type: Extract<IrTopLevelKind, 'server'>;
+} | {
+  _path: ReadonlyArray<string | number>;
+  key: string;
+  method: keyof IR$1.PathItemObject;
+  operation: IR$1.OperationObject;
+  type: Extract<IrTopLevelKind, 'webhook'>;
+};
+type WalkEvent<T$1 extends IrTopLevelKind = IrTopLevelKind> = Extract<WalkEvents, {
+  type: T$1;
+}>;
+//#endregion
+//#region src/plugins/shared/utils/instance.d.ts
+declare class PluginInstance<T$1 extends Plugin.Types = Plugin.Types> {
+  api: T$1['api'];
+  config: Omit<T$1['resolvedConfig'], 'name' | 'output'>;
+  context: IR$1.Context;
+  dependencies: Required<Plugin.Config<T$1>>['dependencies'];
+  private eventHooks;
+  gen: IProject;
+  private handler;
+  name: T$1['resolvedConfig']['name'];
+  output: string;
+  /**
+   * The package metadata and utilities for the current context, constructed
+   * from the provided dependencies. Used for managing package-related
+   * information such as name, version, and dependency resolution during
+   * code generation.
+   */
+  package: IR$1.Context['package'];
+  constructor(props: Pick<Required<Plugin.Config<T$1>>, 'config' | 'dependencies' | 'handler'> & {
+    api?: T$1['api'];
+    context: IR$1.Context<OpenApi$3.V2_0_X | OpenApi$3.V3_0_X | OpenApi$3.V3_1_X>;
+    gen: IProject;
+    name: string;
+    output: string;
+  });
+  /**
+   * 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 IrTopLevelKind = IrTopLevelKind>(...args: [...events: ReadonlyArray<T$1>, callback: (event: WalkEvent<T$1>) => void]): void;
+  forEach<T extends IrTopLevelKind = IrTopLevelKind>(...args: [...events: ReadonlyArray<T$1>, callback: (event: WalkEvent<T$1>) => void, options: WalkOptions<T$1>]): void;
+  /**
+   * Retrieves a registered plugin instance by its name from the context. This
+   * allows plugins to access other plugins that have been registered in the
+   * same context, enabling cross-plugin communication and dependencies.
+   *
+   * @param name Plugin name as defined in the configuration.
+   * @returns The plugin instance if found, undefined otherwise.
+   */
+  getPlugin<T extends keyof PluginConfigMap>(name: T$1): T$1 extends any ? PluginInstance<PluginConfigMap[T$1]> | undefined : never;
+  /**
+   * Retrieves a registered plugin instance by its name from the context. This
+   * allows plugins to access other plugins that have been registered in the
+   * same context, enabling cross-plugin communication and dependencies.
+   *
+   * @param name Plugin name as defined in the configuration.
+   * @returns The plugin instance if found, throw otherwise.
+   */
+  getPluginOrThrow<T extends keyof PluginConfigMap>(name: T$1): T$1 extends any ? PluginInstance<PluginConfigMap[T$1]> : never;
+  getSymbol(symbolIdOrSelector: number | Selector): Symbol | undefined;
+  hooks: {
+    operation: {
+      isMutation: (operation: IR$1.OperationObject) => boolean;
+      isQuery: (operation: IR$1.OperationObject) => boolean;
+    };
+  };
+  isSymbolRegistered(symbolIdOrSelector: number | Selector): boolean;
+  referenceSymbol(symbolIdOrSelector: number | Selector): Symbol;
+  registerSymbol(symbol: SymbolIn): Symbol;
+  /**
+   * Executes plugin's handler function.
+   */
+  run(): Promise<void>;
+  setSymbolValue(symbol: Symbol, value: unknown): void;
+  private buildEventHooks;
+  private forEachError;
+  private getSymbolFilePath;
+  private isOperationKind;
+}
+//#endregion
+//#region src/parser/types/hooks.d.ts
+type Hooks = {
+  /**
+   * Event hooks.
+   */
+  events?: {
+    /**
+     * Triggered after executing a plugin handler.
+     *
+     * @param args Arguments object.
+     * @returns void
+     */
+    'plugin:handler:after'?: (args: {
+      /** Plugin that just executed. */
+      plugin: PluginInstance;
+    }) => void;
+    /**
+     * Triggered before executing a plugin handler.
+     *
+     * @param args Arguments object.
+     * @returns void
+     */
+    'plugin:handler:before'?: (args: {
+      /** Plugin about to execute. */
+      plugin: PluginInstance;
+    }) => void;
+    /**
+     * Triggered after registering a symbol.
+     *
+     * You can use this to perform actions after a symbol is registered.
+     *
+     * @param args Arguments object.
+     * @returns void
+     */
+    'symbol:register:after'?: (args: {
+      /** Plugin that registered the symbol. */
+      plugin: PluginInstance;
+      /** The registered symbol. */
+      symbol: Symbol;
+    }) => void;
+    /**
+     * Triggered before registering a symbol.
+     *
+     * You can use this to modify the symbol before it's registered.
+     *
+     * @param args Arguments object.
+     * @returns void
+     */
+    'symbol:register:before'?: (args: {
+      /** Plugin registering the symbol. */
+      plugin: PluginInstance;
+      /** Symbol to register. */
+      symbol: SymbolIn;
+    }) => void;
+    /**
+     * Triggered after setting a symbol value.
+     *
+     * You can use this to perform actions after a symbol's value is set.
+     *
+     * @param args Arguments object.
+     * @returns void
+     */
+    'symbol:setValue:after'?: (args: {
+      /** Plugin that set the symbol value. */
+      plugin: PluginInstance;
+      /** The symbol. */
+      symbol: Symbol;
+      /** The value that was set. */
+      value: unknown;
+    }) => void;
+    /**
+     * Triggered before setting a symbol value.
+     *
+     *  You can use this to modify the value before it's set.
+     *
+     * @param args Arguments object.
+     * @returns void
+     */
+    'symbol:setValue:before'?: (args: {
+      /** Plugin setting the symbol value. */
+      plugin: PluginInstance;
+      /** The symbol. */
+      symbol: Symbol;
+      /** The value to set. */
+      value: unknown;
+    }) => void;
+  };
+  /**
+   * Hooks specifically for overriding operations behavior.
+   *
+   * Use these to classify operations, decide which outputs to generate,
+   * or apply custom behavior to individual operations.
+   */
+  operations?: {
+    /**
+     * Classify the given operation into one or more kinds.
+     *
+     * Each kind determines how we treat the operation (e.g., generating queries or mutations).
+     *
+     * **Default behavior:**
+     * - GET → 'query'
+     * - DELETE, PATCH, POST, PUT → 'mutation'
+     *
+     * **Resolution order:**
+     * 1. If `isQuery` or `isMutation` returns `true` or `false`, that overrides `getKind`.
+     * 2. If `isQuery` or `isMutation` returns `undefined`, the result of `getKind` is used.
+     *
+     * @param operation - The operation object to classify.
+     * @returns An array containing one or more of 'query' or 'mutation', or undefined to fallback to default behavior.
+     * @example
+     * ```ts
+     * getKind: (operation) => {
+     *   if (operation.method === 'get' && operation.path === '/search') {
+     *     return ['query', 'mutation'];
+     *   }
+     *   return; // fallback to default behavior
+     * }
+     * ```
+     */
+    getKind?: (operation: IROperationObject) => ReadonlyArray<'mutation' | 'query'> | undefined;
+    /**
+     * Check if the given operation should be treated as a mutation.
+     *
+     * This affects which outputs are generated for the operation.
+     *
+     * **Default behavior:** DELETE, PATCH, POST, and PUT operations are treated as mutations.
+     *
+     * **Resolution order:** If this returns `true` or `false`, it overrides `getKind`.
+     * If it returns `undefined`, `getKind` is used instead.
+     *
+     * @param operation - The operation object to check.
+     * @returns true if the operation is a mutation, false otherwise, or undefined to fallback to `getKind`.
+     * @example
+     * ```ts
+     * isMutation: (operation) => {
+     *   if (operation.method === 'post' && operation.path === '/search') {
+     *     return true;
+     *   }
+     *   return; // fallback to default behavior
+     * }
+     * ```
+     */
+    isMutation?: (operation: IROperationObject) => boolean | undefined;
+    /**
+     * Check if the given operation should be treated as a query.
+     *
+     * This affects which outputs are generated for the operation.
+     *
+     * **Default behavior:** GET operations are treated as queries.
+     *
+     * **Resolution order:** If this returns `true` or `false`, it overrides `getKind`.
+     * If it returns `undefined`, `getKind` is used instead.
+     *
+     * @param operation - The operation object to check.
+     * @returns true if the operation is a query, false otherwise, or undefined to fallback to `getKind`.
+     * @example
+     * ```ts
+     * isQuery: (operation) => {
+     *   if (operation.method === 'post' && operation.path === '/search') {
+     *     return true;
+     *   }
+     *   return; // fallback to default behavior
+     * }
+     * ```
+     */
+    isQuery?: (operation: IROperationObject) => boolean | undefined;
+  };
+  /**
+   * Hooks specifically for overriding symbols behavior.
+   *
+   * Use these to customize file placement.
+   */
+  symbols?: {
+    /**
+     * Optional output strategy to override default plugin behavior.
+     *
+     * Use this to route generated symbols to specific files.
+     *
+     * @returns The file path to output the symbol to, or undefined to fallback to default behavior.
+     */
+    getFilePath?: (symbol: Symbol) => string | undefined;
+  };
+};
+//#endregion
 //#region src/types/parser.d.ts
 type EnumsMode = 'inline' | 'root';
 type UserParser = {
@@ -6604,7 +6948,7 @@ type UserParser = {
    * Use these to classify resources, control which outputs are generated,
    * or provide custom behavior for specific resources.
    */
-  hooks?: IR$1.Hooks;
+  hooks?: Hooks;
   /**
    * Pagination configuration.
    */
@@ -6776,7 +7120,7 @@ type Parser = {
    * Use these to classify resources, control which outputs are generated,
    * or provide custom behavior for specific resources.
    */
-  hooks: IR$1.Hooks;
+  hooks: Hooks;
   /**
    * Pagination configuration.
    */
@@ -7401,6 +7745,20 @@ interface Client$2 {
   version: string;
 }
 //#endregion
+//#region src/utils/logger.d.ts
+declare class Logger {
+  private events;
+  private end;
+  report(print?: boolean): PerformanceMeasure | undefined;
+  private reportEvent;
+  private start;
+  private storeEvent;
+  timeEvent(name: string): {
+    mark: PerformanceMark;
+    timeEnd: () => void;
+  };
+}
+//#endregion
 //#region src/openApi/v2/interfaces/OpenApiExternalDocs.d.ts
 /**
  * {@link} https://github.com/OAI/OpenAPI-Specification/blob/main/versions/2.0.md#external-documentation-object
@@ -7685,7 +8043,7 @@ interface OpenApiTag$1 {
 /**
  * {@link} https://github.com/OAI/OpenAPI-Specification/blob/main/versions/2.0.md
  */
-interface OpenApi$2 {
+interface OpenApi$1 {
   basePath?: string;
   consumes?: string[];
   definitions?: Dictionary<OpenApiSchema>;
@@ -7973,7 +8331,7 @@ interface OpenApiTag {
 /**
  * {@link} https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md
  */
-interface OpenApi$3 {
+interface OpenApi$2 {
   components?: OpenApiComponents;
   externalDocs?: OpenApiExternalDocs;
   info: OpenApiInfo;
@@ -7985,7 +8343,7 @@ interface OpenApi$3 {
 }
 //#endregion
 //#region src/openApi/common/interfaces/OpenApi.d.ts
-type OpenApi = OpenApi$2 | OpenApi$3;
+type OpenApi = OpenApi$1 | OpenApi$2;
 //#endregion
 //#region src/openApi/index.d.ts
 /**
@@ -8005,160 +8363,6 @@ declare const parseOpenApiSpec: ({
   spec: unknown;
 }) => IR$1.Context | undefined;
 //#endregion
-//#region src/ir/graph.d.ts
-declare const irTopLevelKinds: readonly ["operation", "parameter", "requestBody", "schema", "server", "webhook"];
-type IrTopLevelKind = (typeof irTopLevelKinds)[number];
-//#endregion
-//#region src/plugins/shared/types/instance.d.ts
-type WalkEvents = {
-  _path: ReadonlyArray<string | number>;
-  method: keyof IR$1.PathItemObject;
-  operation: IR$1.OperationObject;
-  path: string;
-  type: Extract<IrTopLevelKind, 'operation'>;
-} | {
-  $ref: string;
-  _path: ReadonlyArray<string | number>;
-  name: string;
-  parameter: IR$1.ParameterObject;
-  type: Extract<IrTopLevelKind, 'parameter'>;
-} | {
-  $ref: string;
-  _path: ReadonlyArray<string | number>;
-  name: string;
-  requestBody: IR$1.RequestBodyObject;
-  type: Extract<IrTopLevelKind, 'requestBody'>;
-} | {
-  $ref: string;
-  _path: ReadonlyArray<string | number>;
-  name: string;
-  schema: IR$1.SchemaObject;
-  type: Extract<IrTopLevelKind, 'schema'>;
-} | {
-  _path: ReadonlyArray<string | number>;
-  server: IR$1.ServerObject;
-  type: Extract<IrTopLevelKind, 'server'>;
-} | {
-  _path: ReadonlyArray<string | number>;
-  key: string;
-  method: keyof IR$1.PathItemObject;
-  operation: IR$1.OperationObject;
-  type: Extract<IrTopLevelKind, 'webhook'>;
-};
-type WalkEvent<T$1 extends IrTopLevelKind = IrTopLevelKind> = Extract<WalkEvents, {
-  type: T$1;
-}>;
-type WalkOptions = {
-  /**
-   * Order of walking schemas.
-   *
-   * The "declarations" option ensures that schemas are walked in the order
-   * they are declared in the input document. This is useful for scenarios where
-   * the order of declaration matters, such as when generating code that relies
-   * on the sequence of schema definitions.
-   *
-   * The "topological" option ensures that schemas are walked in an order
-   * where dependencies are visited before the schemas that depend on them.
-   * This is useful for scenarios where you need to process or generate
-   * schemas in a way that respects their interdependencies.
-   *
-   * @default 'topological'
-   */
-  order?: 'declarations' | 'topological';
-};
-//#endregion
-//#region src/plugins/shared/utils/instance.d.ts
-declare class PluginInstance<T$1 extends Plugin.Types = Plugin.Types> {
-  api: T$1['api'];
-  config: Omit<T$1['resolvedConfig'], 'name' | 'output'>;
-  context: IR$1.Context;
-  dependencies: Required<Plugin.Config<T$1>>['dependencies'];
-  gen: IProject;
-  private handler;
-  name: T$1['resolvedConfig']['name'];
-  output: string;
-  /**
-   * The package metadata and utilities for the current context, constructed
-   * from the provided dependencies. Used for managing package-related
-   * information such as name, version, and dependency resolution during
-   * code generation.
-   */
-  package: IR$1.Context['package'];
-  constructor(props: Pick<Required<Plugin.Config<T$1>>, 'config' | 'dependencies' | 'handler'> & {
-    api?: T$1['api'];
-    context: IR$1.Context<OpenApi$1.V2_0_X | OpenApi$1.V3_0_X | OpenApi$1.V3_1_X>;
-    gen: IProject;
-    name: string;
-    output: string;
-  });
-  /**
-   * 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 IrTopLevelKind = IrTopLevelKind>(...args: [...events: ReadonlyArray<T$1>, callback: (event: WalkEvent<T$1>) => void]): void;
-  forEach<T extends IrTopLevelKind = IrTopLevelKind>(...args: [...events: ReadonlyArray<T$1>, callback: (event: WalkEvent<T$1>) => void, options: WalkOptions]): 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
-   * same context, enabling cross-plugin communication and dependencies.
-   *
-   * @param name Plugin name as defined in the configuration.
-   * @returns The plugin instance if found, undefined otherwise.
-   */
-  getPlugin<T extends keyof PluginConfigMap>(name: T$1): T$1 extends any ? PluginInstance<PluginConfigMap[T$1]> | undefined : never;
-  /**
-   * Retrieves a registered plugin instance by its name from the context. This
-   * allows plugins to access other plugins that have been registered in the
-   * same context, enabling cross-plugin communication and dependencies.
-   *
-   * @param name Plugin name as defined in the configuration.
-   * @returns The plugin instance if found, throw otherwise.
-   */
-  getPluginOrThrow<T extends keyof PluginConfigMap>(name: T$1): T$1 extends any ? PluginInstance<PluginConfigMap[T$1]> : never;
-  getSymbol(symbolIdOrSelector: number | Selector): Symbol | undefined;
-  private getSymbolFilePath;
-  getSymbolValue(idOrSymbol: number | Symbol): unknown;
-  hasSymbolValue(idOrSymbol: number | Symbol): boolean;
-  hooks: {
-    operation: {
-      isMutation: (operation: IR$1.OperationObject) => boolean;
-      isQuery: (operation: IR$1.OperationObject) => boolean;
-    };
-    symbol: {
-      getFilePath: (symbol: Symbol) => string | undefined;
-    };
-  };
-  private isOperationKind;
-  isSymbolRegistered(symbolIdOrSelector: number | Selector): boolean;
-  referenceSymbol(symbolIdOrSelector: number | Selector): Symbol;
-  registerSymbol(symbol: SymbolIn): Symbol;
-  /**
-   * Executes plugin's handler function.
-   */
-  run(): Promise<void>;
-  setSymbolValue(idOrSymbol: number | Symbol, value: unknown): Map<number, unknown>;
-  private symbolToId;
-}
-//#endregion
 //#region src/types/client.d.ts
 interface Operation extends Omit<Operation$1, 'tags'> {
   service: string;
@@ -8198,7 +8402,7 @@ type BaseConfig = {
    * Use these to classify resources, control which outputs are generated,
    * or provide custom behavior for specific resources.
    */
-  '~hooks'?: IR$1.Hooks;
+  '~hooks'?: Hooks;
 };
 
 /**
@@ -15848,97 +16052,6 @@ interface IRComponentsObject {
   requestBodies?: Record<string, IRRequestBodyObject>;
   schemas?: Record<string, IRSchemaObject>;
 }
-interface IRHooks {
-  /**
-   * Hooks specifically for overriding operations behavior.
-   *
-   * Use these to classify operations, decide which outputs to generate,
-   * or apply custom behavior to individual operations.
-   */
-  operations?: {
-    /**
-     * Classify the given operation into one or more kinds.
-     *
-     * Each kind determines how we treat the operation (e.g., generating queries or mutations).
-     *
-     * **Default behavior:**
-     * - GET → 'query'
-     * - DELETE, PATCH, POST, PUT → 'mutation'
-     *
-     * **Resolution order:**
-     * 1. If `isQuery` or `isMutation` returns `true` or `false`, that overrides `getKind`.
-     * 2. If `isQuery` or `isMutation` returns `undefined`, the result of `getKind` is used.
-     *
-     * @param operation - The operation object to classify.
-     * @returns An array containing one or more of 'query' or 'mutation', or undefined to fallback to default behavior.
-     * @example
-     * getKind: (operation) => {
-     *   if (operation.method === 'get' && operation.path === '/search') {
-     *     return ['query', 'mutation'];
-     *   }
-     *   return; // fallback to default behavior
-     * }
-     */
-    getKind?: (operation: IROperationObject) => ReadonlyArray<'mutation' | 'query'> | undefined;
-    /**
-     * Check if the given operation should be treated as a mutation.
-     *
-     * This affects which outputs are generated for the operation.
-     *
-     * **Default behavior:** DELETE, PATCH, POST, and PUT operations are treated as mutations.
-     *
-     * **Resolution order:** If this returns `true` or `false`, it overrides `getKind`.
-     * If it returns `undefined`, `getKind` is used instead.
-     *
-     * @param operation - The operation object to check.
-     * @returns true if the operation is a mutation, false otherwise, or undefined to fallback to `getKind`.
-     * @example
-     * isMutation: (operation) => {
-     *   if (operation.method === 'post' && operation.path === '/search') {
-     *     return true;
-     *   }
-     *   return; // fallback to default behavior
-     }
-     */
-    isMutation?: (operation: IROperationObject) => boolean | undefined;
-    /**
-     * Check if the given operation should be treated as a query.
-     *
-     * This affects which outputs are generated for the operation.
-     *
-     * **Default behavior:** GET operations are treated as queries.
-     *
-     * **Resolution order:** If this returns `true` or `false`, it overrides `getKind`.
-     * If it returns `undefined`, `getKind` is used instead.
-     *
-     * @param operation - The operation object to check.
-     * @returns true if the operation is a query, false otherwise, or undefined to fallback to `getKind`.
-     * @example
-     * isQuery: (operation) => {
-     *   if (operation.method === 'post' && operation.path === '/search') {
-     *     return true;
-     *   }
-     *   return; // fallback to default behavior
-     }
-     */
-    isQuery?: (operation: IROperationObject) => boolean | undefined;
-  };
-  /**
-   * Hooks specifically for overriding symbols behavior.
-   *
-   * Use these to customize file placement.
-   */
-  symbols?: {
-    /**
-     * Optional output strategy to override default plugin behavior.
-     *
-     * Use this to route generated symbols to specific files.
-     *
-     * @returns The file path to output the symbol to, or undefined to fallback to default behavior.
-     */
-    getFilePath?: (symbol: Symbol) => string | undefined;
-  };
-}
 interface IROperationObject {
   body?: IRBodyObject;
   deprecated?: boolean;
@@ -16081,7 +16194,6 @@ declare namespace IR$1 {
   export type BodyObject = IRBodyObject;
   export type ComponentsObject = IRComponentsObject;
   export type Context<Spec extends Record<string, any> = any> = IRContext<Spec>;
-  export type Hooks = IRHooks;
   export type Model = IRModel;
   export type OperationObject = IROperationObject;
   export type ParameterObject = IRParameterObject;
@@ -16120,5 +16232,5 @@ interface WatchValues {
   lastValue?: string;
 }
 //#endregion
-export { StringCase as C, MaybeArray as D, LazyOrAsync as E, OpenApiSchemaObject as S, Logger as T, OpenApiMetaObject as _, ExpressionTransformer as a, OpenApiRequestBodyObject as b, Client as c, Plugin as d, Client$1 as f, OpenApi$1 as g, UserConfig$27 as h, TypeTransformer as i, PluginHandler as l, Config$1 as m, WatchValues as n, compiler as o, parseOpenApiSpec as p, IR$1 as r, tsc as s, LegacyIR as t, DefinePlugin as u, OpenApiOperationObject as v, Input as w, OpenApiResponseObject as x, OpenApiParameterObject as y };
-//# sourceMappingURL=types-BT1ededZ.d.cts.map
+export { OpenApiSchemaObject as C, MaybeArray as D, LazyOrAsync as E, OpenApiResponseObject as S, Input as T, OpenApi$3 as _, ExpressionTransformer as a, OpenApiParameterObject as b, Client as c, Plugin as d, Client$1 as f, UserConfig$27 as g, Config$1 as h, TypeTransformer as i, PluginHandler as l, Logger as m, WatchValues as n, compiler as o, parseOpenApiSpec as p, IR$1 as r, tsc as s, LegacyIR as t, DefinePlugin as u, OpenApiMetaObject as v, StringCase as w, OpenApiRequestBodyObject as x, OpenApiOperationObject as y };
+//# sourceMappingURL=types-CBGf9bNY.d.cts.map