@hey-api/openapi-ts 0.92.3 → 0.93.0

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { n as UserConfig } from "./types-Ba27ofyy.mjs";
 import * as _hey_api_codegen_core0 from "@hey-api/codegen-core";
 import { AnalysisContext, BindingKind, ExportModule, File, FromRef, ImportModule, Language, Logger, Logger as Logger$1, Node, NodeName, NodeNameSanitizer, NodeRelationship, NodeScope, Ref, Refs, RenderContext, Renderer, Symbol, SymbolMeta } from "@hey-api/codegen-core";
-import { Casing, Context, DefinePlugin, DefinePlugin as DefinePlugin$1, FeatureToggle, IR, IR as IR$1, LinguistLanguages, NameTransformer, NamingConfig, NamingOptions, NamingRule, OpenApi, OpenApiMetaObject, OpenApiOperationObject, OpenApiParameterObject, OpenApiRequestBodyObject, OpenApiResponseObject, OpenApiSchemaObject, OpenApiV2_0_XTypes, OpenApiV3_0_XTypes, OpenApiV3_1_XTypes, OperationPath, OperationPathStrategy, OperationStrategy, OperationsStrategy, Plugin, Plugin as Plugin$1, SchemaWithType, defaultPaginationKeywords, definePluginConfig, utils } from "@hey-api/shared";
+import { Casing, Context, DefinePlugin, DefinePlugin as DefinePlugin$1, FeatureToggle, IR, IR as IR$1, LinguistLanguages, NameTransformer, NamingConfig, NamingOptions, NamingRule, OpenApi, OpenApiMetaObject, OpenApiOperationObject, OpenApiParameterObject, OpenApiRequestBodyObject, OpenApiResponseObject, OpenApiSchemaObject, OpenApiV2_0_XTypes, OpenApiV3_0_XTypes, OpenApiV3_1_XTypes, OperationPath, OperationPathStrategy, OperationStrategy, OperationsStrategy, Plugin, Plugin as Plugin$1, SchemaExtractor, SchemaVisitorContext, SchemaWithType, Walker, defaultPaginationKeywords, definePluginConfig, utils } from "@hey-api/shared";
 import ts from "typescript";
 import { AnyString, LazyOrAsync, MaybeArray, MaybeFunc } from "@hey-api/types";
 import { HttpClient, HttpErrorResponse, HttpHeaders, HttpRequest, HttpResponse } from "@angular/common/http";
@@ -807,14 +807,14 @@ interface ExprMethods extends Node {
 }
 //#endregion
 //#region src/ts-dsl/expr/call.d.ts
-type CallArgs = ReadonlyArray<CallExpr | undefined>;
-type CallExpr = NodeName | MaybeTsDsl<ts.Expression>;
-type CallCtor = (expr: CallExpr, ...args: CallArgs) => CallTsDsl;
+type CallArgs = ReadonlyArray<CallCallee | undefined>;
+type CallCallee = NodeName | MaybeTsDsl<ts.Expression>;
+type CallCtor = (callee: CallCallee, ...args: CallArgs) => CallTsDsl;
 declare const Mixed$40: MixinCtor<MixinCtor<MixinCtor<MixinCtor<abstract new () => TsDsl<ts.CallExpression>, TypeArgsMethods>, ExprMethods>, AsMethods>, ArgsMethods>;
 declare class CallTsDsl extends Mixed$40 {
   readonly '~dsl' = "CallTsDsl";
-  protected _callExpr: Ref<CallExpr>;
-  constructor(expr: CallExpr, ...args: CallArgs);
+  protected _callee: Ref<CallCallee>;
+  constructor(callee: CallCallee, ...args: CallArgs);
   analyze(ctx: AnalysisContext): void;
   toAst(): ts.CallExpression;
 }
@@ -2075,7 +2075,7 @@ declare const $: ((id: ts.Expression | TsDsl<ts.Expression> | _hey_api_codegen_c
   /** Creates a statement block (`{ ... }`). */
   block: (...args: ConstructorParameters<typeof BlockTsDsl>) => BlockTsDsl;
   /** Creates a function or method call expression (e.g. `fn(arg)`). */
-  call: (expr: CallExpr, ...args: (CallExpr | undefined)[]) => CallTsDsl;
+  call: (callee: CallCallee, ...args: (CallCallee | undefined)[]) => CallTsDsl;
   /** Creates a class declaration or expression. */
   class: (name: _hey_api_codegen_core0.NodeName) => ClassTsDsl;
   /** Creates a constant variable declaration (`const`). */
@@ -2573,7 +2573,7 @@ interface Config$18<T extends ClientOptions$5 = ClientOptions$5> extends Omit<Re
 interface RequestOptions$5<TData = unknown, TResponseStyle extends ResponseStyle$2 = 'fields', ThrowOnError extends boolean = boolean, Url extends string = string> extends Config$18<{
   responseStyle: TResponseStyle;
   throwOnError: ThrowOnError;
-}>, Pick<ServerSentEventsOptions<TData>, 'onSseError' | 'onSseEvent' | 'sseDefaultRetryDelay' | 'sseMaxRetryAttempts' | 'sseMaxRetryDelay'> {
+}>, Pick<ServerSentEventsOptions<TData>, 'onRequest' | 'onSseError' | 'onSseEvent' | 'sseDefaultRetryDelay' | 'sseMaxRetryAttempts' | 'sseMaxRetryDelay'> {
   /**
    * Any body that you want to add to your request.
    *
@@ -2620,7 +2620,7 @@ interface ClientOptions$5 {
 type MethodFn$5 = <TData = unknown, TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle$2 = 'fields'>(options: Omit<RequestOptions$5<TData, TResponseStyle, ThrowOnError>, 'method'>) => RequestResult$5<TData, TError, ThrowOnError, TResponseStyle>;
 type SseFn$5 = <TData = unknown, TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle$2 = 'fields'>(options: Omit<RequestOptions$5<TData, TResponseStyle, ThrowOnError>, 'method'>) => Promise<ServerSentEventsResult<TData, TError>>;
 type RequestFn$5 = <TData = unknown, TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle$2 = 'fields'>(options: Omit<RequestOptions$5<TData, TResponseStyle, ThrowOnError>, 'method'> & Pick<Required<RequestOptions$5<TData, TResponseStyle, ThrowOnError>>, 'method'>) => RequestResult$5<TData, TError, ThrowOnError, TResponseStyle>;
-type RequestOptionsFn = <ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle$2 = 'fields'>(options: RequestOptions$5<unknown, TResponseStyle, ThrowOnError>) => HttpRequest<unknown>;
+type RequestOptionsFn = <T, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle$2 = 'fields'>(options: RequestOptions$5<T, TResponseStyle, ThrowOnError>) => HttpRequest<T>;
 type BuildUrlFn$5 = <TData extends {
   body?: unknown;
   path?: Record<string, unknown>;
@@ -2670,7 +2670,7 @@ interface Config$17<T extends ClientOptions$4 = ClientOptions$4> extends Omit<Cr
 }
 interface RequestOptions$4<TData = unknown, ThrowOnError extends boolean = boolean, Url extends string = string> extends Config$17<{
   throwOnError: ThrowOnError;
-}>, Pick<ServerSentEventsOptions<TData>, 'onSseError' | 'onSseEvent' | 'sseDefaultRetryDelay' | 'sseMaxRetryAttempts' | 'sseMaxRetryDelay'> {
+}>, Pick<ServerSentEventsOptions<TData>, 'onRequest' | 'onSseError' | 'onSseEvent' | 'sseDefaultRetryDelay' | 'sseMaxRetryAttempts' | 'sseMaxRetryDelay'> {
   /**
    * Any body that you want to add to your request.
    *
@@ -2793,7 +2793,7 @@ interface Config$16<T extends ClientOptions$3 = ClientOptions$3> extends Omit<Re
 interface RequestOptions$3<TData = unknown, TResponseStyle extends ResponseStyle$1 = 'fields', ThrowOnError extends boolean = boolean, Url extends string = string> extends Config$16<{
   responseStyle: TResponseStyle;
   throwOnError: ThrowOnError;
-}>, Pick<ServerSentEventsOptions<TData>, 'onSseError' | 'onSseEvent' | 'sseDefaultRetryDelay' | 'sseMaxRetryAttempts' | 'sseMaxRetryDelay'> {
+}>, Pick<ServerSentEventsOptions<TData>, 'onRequest' | 'onSseError' | 'onSseEvent' | 'sseDefaultRetryDelay' | 'sseMaxRetryAttempts' | 'sseMaxRetryDelay'> {
   /**
    * Any body that you want to add to your request.
    *
@@ -2913,7 +2913,7 @@ interface Config$15<T extends ClientOptions$2 = ClientOptions$2> extends Omit<Re
 }
 interface RequestOptions$2<TData = unknown, ThrowOnError extends boolean = boolean, Url extends string = string> extends Config$15<{
   throwOnError: ThrowOnError;
-}>, Pick<ServerSentEventsOptions<TData>, 'onSseError' | 'onSseEvent' | 'sseDefaultRetryDelay' | 'sseMaxRetryAttempts' | 'sseMaxRetryDelay'> {
+}>, Pick<ServerSentEventsOptions<TData>, 'onRequest' | 'onSseError' | 'onSseEvent' | 'sseDefaultRetryDelay' | 'sseMaxRetryAttempts' | 'sseMaxRetryDelay'> {
   /**
    * Any body that you want to add to your request.
    *
@@ -3919,20 +3919,25 @@ type Config$11 = Plugin$1.Name<'@hey-api/transformers'> & Plugin$1.Hooks & Plugi
 type HeyApiTransformersPlugin = DefinePlugin$1<UserConfig$13, Config$11>;
 //#endregion
 //#region src/plugins/@hey-api/typescript/shared/types.d.ts
-type IrSchemaToAstOptions = {
+type IrSchemaToAstOptions$1 = {
+  /** The plugin instance. */
   plugin: HeyApiTypeScriptPlugin['Instance'];
-  state: Refs<PluginState$2>;
+  /** Optional schema extractor function. */
+  schemaExtractor?: SchemaExtractor;
+  /** The plugin state references. */
+  state: Refs<PluginState$1>;
 };
-type PluginState$2 = Pick<Required<SymbolMeta>, 'path'> & Pick<Partial<SymbolMeta>, 'tags'>;
+type PluginState$1 = Pick<Required<SymbolMeta>, 'path'> & Pick<Partial<SymbolMeta>, 'tags'>;
 //#endregion
 //#region src/plugins/@hey-api/typescript/v1/plugin.d.ts
-declare const irSchemaToAst: ({
+declare function irSchemaToAst({
   plugin,
   schema,
+  schemaExtractor,
   state
-}: IrSchemaToAstOptions & {
+}: IrSchemaToAstOptions$1 & {
   schema: IR$1.SchemaObject;
-}) => MaybeTsDsl<TypeTsDsl>;
+}): MaybeTsDsl<TypeTsDsl>;
 //#endregion
 //#region src/plugins/@hey-api/typescript/api.d.ts
 type IApi$3 = {
@@ -7379,33 +7384,56 @@ type SwrPlugin = DefinePlugin$1<UserConfig$3, Config$2>;
 //#region src/plugins/valibot/shared/pipes.d.ts
 type Pipe = ReturnType<typeof $.call | typeof $.expr>;
 type Pipes = Array<Pipe>;
-type PipeResult = Pipes | Pipe;
-type PushPipes = (target: Pipes, pipes: PipeResult) => Pipes;
-type PipesToNode = (pipes: PipeResult, plugin: ValibotPlugin['Instance']) => Pipe;
+type PipeResult = Pipes | Pipe | undefined;
 interface PipesUtils {
   /**
-   * Push pipes into target array.
+   * Pushes a pipe result onto a pipes array.
+   *
+   * Handles single pipes, arrays of pipes, and undefined.
    */
-  push: PushPipes;
+  push: (target: Pipes, result: PipeResult) => Pipes;
   /**
-   * Convert pipes to a single node.
+   * Converts a pipes array to a single node expression.
    */
-  toNode: PipesToNode;
+  toNode: (pipes: Pipes | Pipe, plugin: ValibotPlugin['Instance']) => Pipe;
 }
 //#endregion
 //#region src/plugins/valibot/shared/types.d.ts
-type Ast$1 = {
-  hasLazyExpression?: boolean;
-  pipes: Pipes;
-  typeName?: string | ts.Identifier;
-};
-type PluginState$1 = Pick<Required<SymbolMeta>, 'path'> & Pick<Partial<SymbolMeta>, 'tags'> & {
-  hasLazyExpression: boolean;
-};
 type ValidatorArgs$1 = {
   operation: IR$1.OperationObject;
+  /** The plugin instance. */
   plugin: ValibotPlugin['Instance'];
 };
+/**
+ * Metadata that flows through schema walking.
+ */
+interface ValibotMeta {
+  /** Default value from schema. */
+  default?: unknown;
+  /** Original format (for BigInt coercion). */
+  format?: string;
+  /** Whether this or any child contains a lazy reference. */
+  hasLazy: boolean;
+  /** Does this schema explicitly allow null? */
+  nullable: boolean;
+  /** Is this schema read-only? */
+  readonly: boolean;
+}
+/**
+ * Result from walking a schema node.
+ */
+interface ValibotResult {
+  meta: ValibotMeta;
+  pipes: Pipes;
+}
+/**
+ * Finalized result after applyModifiers.
+ */
+interface ValibotFinal {
+  pipes: Pipes;
+  /** Type annotation for schemas requiring explicit typing (e.g., lazy). */
+  typeName?: string | ts.Identifier;
+}
 //#endregion
 //#region src/plugins/valibot/api.d.ts
 type IApi$1 = {
@@ -7427,7 +7455,7 @@ interface IntegerLimit {
 }
 type GetIntegerLimit = (format: string | undefined) => IntegerLimit | undefined;
 //#endregion
-//#region src/plugins/valibot/resolvers/types.d.ts
+//#region src/plugins/valibot/resolvers.d.ts
 type Resolvers$1 = Plugin$1.Resolvers<{
   /**
    * Resolver for enum schemas.
@@ -7436,7 +7464,7 @@ type Resolvers$1 = Plugin$1.Resolvers<{
    *
    * Returning `undefined` will execute the default resolver logic.
    */
-  enum?: (ctx: EnumResolverContext$1) => PipeResult | undefined;
+  enum?: (ctx: EnumResolverContext$1) => PipeResult;
   /**
    * Resolver for number schemas.
    *
@@ -7444,7 +7472,7 @@ type Resolvers$1 = Plugin$1.Resolvers<{
    *
    * Returning `undefined` will execute the default resolver logic.
    */
-  number?: (ctx: NumberResolverContext$1) => PipeResult | undefined;
+  number?: (ctx: NumberResolverContext$1) => PipeResult;
   /**
    * Resolver for object schemas.
    *
@@ -7452,7 +7480,7 @@ type Resolvers$1 = Plugin$1.Resolvers<{
    *
    * Returning `undefined` will execute the default resolver logic.
    */
-  object?: (ctx: ObjectResolverContext$1) => PipeResult | undefined;
+  object?: (ctx: ObjectResolverContext$1) => PipeResult;
   /**
    * Resolver for string schemas.
    *
@@ -7460,7 +7488,7 @@ type Resolvers$1 = Plugin$1.Resolvers<{
    *
    * Returning `undefined` will execute the default resolver logic.
    */
-  string?: (ctx: StringResolverContext$1) => PipeResult | undefined;
+  string?: (ctx: StringResolverContext$1) => PipeResult;
   /**
    * Resolvers for request and response validators.
    *
@@ -7502,9 +7530,7 @@ interface BaseContext$1 extends DollarTsDsl {
      */
     current: Pipes;
   };
-  /**
-   * The plugin instance.
-   */
+  /** The plugin instance. */
   plugin: ValibotPlugin['Instance'];
   /**
    * Provides access to commonly used symbols within the plugin.
@@ -7515,7 +7541,7 @@ interface BaseContext$1 extends DollarTsDsl {
 }
 interface EnumResolverContext$1 extends BaseContext$1 {
   /**
-   * Nodes used to build different parts of the enum schema.
+   * Nodes used to build different parts of the schema.
    */
   nodes: {
     /**
@@ -7535,28 +7561,18 @@ interface EnumResolverContext$1 extends BaseContext$1 {
        */
       isNullable: boolean;
     };
-    /**
-     * Returns a nullable wrapper if the enum includes null, undefined otherwise.
-     */
-    nullable: (ctx: EnumResolverContext$1) => PipeResult | undefined;
   };
   schema: SchemaWithType<'enum'>;
-  /**
-   * Utility functions for enum schema processing.
-   */
-  utils: {
-    state: Refs<PluginState$1>;
-  };
 }
 interface NumberResolverContext$1 extends BaseContext$1 {
   /**
-   * Nodes used to build different parts of the number schema.
+   * Nodes used to build different parts of the schema.
    */
   nodes: {
     base: (ctx: NumberResolverContext$1) => PipeResult;
-    const: (ctx: NumberResolverContext$1) => PipeResult | undefined;
-    max: (ctx: NumberResolverContext$1) => PipeResult | undefined;
-    min: (ctx: NumberResolverContext$1) => PipeResult | undefined;
+    const: (ctx: NumberResolverContext$1) => PipeResult;
+    max: (ctx: NumberResolverContext$1) => PipeResult;
+    min: (ctx: NumberResolverContext$1) => PipeResult;
   };
   schema: SchemaWithType<'integer' | 'number'>;
   /**
@@ -7569,16 +7585,16 @@ interface NumberResolverContext$1 extends BaseContext$1 {
   };
 }
 interface ObjectResolverContext$1 extends BaseContext$1 {
+  _childResults: Array<ValibotResult>;
+  applyModifiers: (result: ValibotResult, opts: {
+    optional?: boolean;
+  }) => ValibotFinal;
   /**
-   * Nodes used to build different parts of the object schema.
+   * Nodes used to build different parts of the schema.
    */
   nodes: {
-    /**
-     * If `additionalProperties` is `false` or `{ type: 'never' }`, returns `null`
-     * to indicate no additional properties are allowed.
-     */
     additionalProperties: (ctx: ObjectResolverContext$1) => Pipe | null | undefined;
-    base: (ctx: ObjectResolverContext$1) => PipeResult;
+    base: (ctx: ObjectResolverContext$1) => Pipes | Pipe;
     shape: (ctx: ObjectResolverContext$1) => ReturnType<typeof $.object>;
   };
   schema: SchemaWithType<'object'>;
@@ -7586,22 +7602,25 @@ interface ObjectResolverContext$1 extends BaseContext$1 {
    * Utility functions for object schema processing.
    */
   utils: {
-    ast: Partial<Omit<Ast$1, 'typeName'>>;
-    state: Refs<PluginState$1>;
+    ast: Partial<{
+      hasLazy: boolean;
+    }>;
   };
+  walk: Walker<ValibotResult, ValibotPlugin['Instance']>;
+  walkerCtx: SchemaVisitorContext<ValibotPlugin['Instance']>;
 }
 interface StringResolverContext$1 extends BaseContext$1 {
   /**
-   * Nodes used to build different parts of the string schema.
+   * Nodes used to build different parts of the schema.
    */
   nodes: {
     base: (ctx: StringResolverContext$1) => PipeResult;
-    const: (ctx: StringResolverContext$1) => PipeResult | undefined;
-    format: (ctx: StringResolverContext$1) => PipeResult | undefined;
-    length: (ctx: StringResolverContext$1) => PipeResult | undefined;
-    maxLength: (ctx: StringResolverContext$1) => PipeResult | undefined;
-    minLength: (ctx: StringResolverContext$1) => PipeResult | undefined;
-    pattern: (ctx: StringResolverContext$1) => PipeResult | undefined;
+    const: (ctx: StringResolverContext$1) => PipeResult;
+    format: (ctx: StringResolverContext$1) => PipeResult;
+    length: (ctx: StringResolverContext$1) => PipeResult;
+    maxLength: (ctx: StringResolverContext$1) => PipeResult;
+    minLength: (ctx: StringResolverContext$1) => PipeResult;
+    pattern: (ctx: StringResolverContext$1) => PipeResult;
   };
   schema: SchemaWithType<'string'>;
 }
@@ -7633,6 +7652,8 @@ type UserConfig$2 = Plugin$1.Name<'valibot'> & Plugin$1.Hooks & Plugin$1.UserCom
    * - `boolean`: Shorthand for `{ enabled: boolean }`
    * - `string` or `function`: Shorthand for `{ name: string | function }`
    * - `object`: Full configuration object
+   *
+   * @default true
    */
   definitions?: boolean | NameTransformer | {
     /**
@@ -7672,6 +7693,8 @@ type UserConfig$2 = Plugin$1.Name<'valibot'> & Plugin$1.Hooks & Plugin$1.UserCom
    * - `boolean`: Shorthand for `{ enabled: boolean }`
    * - `string` or `function`: Shorthand for `{ name: string | function }`
    * - `object`: Full configuration object
+   *
+   * @default true
    */
   requests?: boolean | NameTransformer | {
     /**
@@ -7703,6 +7726,8 @@ type UserConfig$2 = Plugin$1.Name<'valibot'> & Plugin$1.Hooks & Plugin$1.UserCom
    * - `boolean`: Shorthand for `{ enabled: boolean }`
    * - `string` or `function`: Shorthand for `{ name: string | function }`
    * - `object`: Full configuration object
+   *
+   * @default true
    */
   responses?: boolean | NameTransformer | {
     /**
@@ -7758,61 +7783,71 @@ type UserConfig$2 = Plugin$1.Name<'valibot'> & Plugin$1.Hooks & Plugin$1.UserCom
   };
 };
 type Config$1 = Plugin$1.Name<'valibot'> & Plugin$1.Hooks & Plugin$1.Comments & Plugin$1.Exports & Resolvers$1 & {
-  /**
-   * Casing convention for generated names.
-   */
+  /** Casing convention for generated names. */
   case: Casing;
-  /**
-   * Configuration for reusable schema definitions.
-   *
-   * Controls generation of shared Valibot schemas that can be referenced
-   * across requests and responses.
-   */
+  /** Configuration for reusable schema definitions. */
   definitions: NamingOptions & FeatureToggle;
-  /**
-   * Enable Valibot metadata support? It's often useful to associate a schema
-   * with some additional metadata for documentation, code generation, AI
-   * structured outputs, form validation, and other purposes.
-   *
-   * @default false
-   */
+  /** Enable Valibot metadata support? */
   metadata: boolean;
-  /**
-   * Configuration for request-specific Valibot schemas.
-   *
-   * Controls generation of Valibot schemas for request bodies, query
-   * parameters, path parameters, and headers.
-   */
+  /** Configuration for request-specific Valibot schemas. */
   requests: NamingOptions & FeatureToggle;
-  /**
-   * Configuration for response-specific Valibot schemas.
-   *
-   * Controls generation of Valibot schemas for response bodies, error
-   * responses, and status codes.
-   */
+  /** Configuration for response-specific Valibot schemas. */
   responses: NamingOptions & FeatureToggle;
-  /**
-   * Configuration for webhook-specific Valibot schemas.
-   *
-   * Controls generation of Valibot schemas for webhook payloads.
-   */
+  /** Configuration for webhook-specific Valibot schemas. */
   webhooks: NamingOptions & FeatureToggle;
 };
 type ValibotPlugin = DefinePlugin$1<UserConfig$2, Config$1, IApi$1>;
 //#endregion
 //#region src/plugins/zod/shared/types.d.ts
 type Ast = {
+  anyType?: string;
   expression: ReturnType<typeof $.expr | typeof $.call>;
   hasLazyExpression?: boolean;
   typeName?: string | ts.Identifier;
 };
+type IrSchemaToAstOptions = {
+  /** The plugin instance. */
+  plugin: ZodPlugin['Instance'];
+  /** The plugin state references. */
+  state: Refs<PluginState>;
+  walk: Walker<ZodSchemaResult, ZodPlugin['Instance']>;
+};
 type PluginState = Pick<Required<SymbolMeta>, 'path'> & Pick<Partial<SymbolMeta>, 'tags'> & {
+  anyType?: string;
   hasLazyExpression: boolean;
 };
+type TypeOptions = {
+  /** Configuration for TypeScript type generation from Zod schemas. */
+  types: {
+    /** Configuration for `infer` types. */
+    infer: NamingOptions & FeatureToggle;
+  };
+};
 type ValidatorArgs = {
   operation: IR$1.OperationObject;
   plugin: ZodPlugin['Instance'];
 };
+/**
+ * The result from schema walking.
+ */
+interface ZodSchemaResult {
+  /** Default value from schema, if any. */
+  default?: unknown;
+  /** The Zod expression AST. */
+  expression: {
+    expression: ReturnType<typeof $.expr | typeof $.call>;
+  };
+  /** The original schema format (for BigInt coercion). */
+  format?: string;
+  /** Whether any child contains a lazy expression. */
+  hasLazyExpression?: boolean;
+  /** Whether THIS result is itself lazy (not just inherited). */
+  isLazy?: boolean;
+  /** Does this schema explicitly allow null? */
+  nullable: boolean;
+  /** Is this schema read-only? */
+  readonly: boolean;
+}
 //#endregion
 //#region src/plugins/zod/api.d.ts
 type IApi = {
@@ -7882,7 +7917,7 @@ type Resolvers = Plugin$1.Resolvers<{
   };
 }>;
 type ValidatorResolver = (ctx: ValidatorResolverContext) => MaybeArray<TsDsl<ts.Statement>> | null | undefined;
-interface BaseContext extends DollarTsDsl {
+type BaseContext = DollarTsDsl & Pick<IrSchemaToAstOptions, 'plugin'> & {
   /**
    * Functions for working with chains.
    */
@@ -7898,17 +7933,13 @@ interface BaseContext extends DollarTsDsl {
      */
     current: Chain;
   };
-  /**
-   * The plugin instance.
-   */
-  plugin: ZodPlugin['Instance'];
   /**
    * Provides access to commonly used symbols within the plugin.
    */
   symbols: {
     z: Symbol;
   };
-}
+};
 interface EnumResolverContext extends BaseContext {
   /**
    * Nodes used to build different parts of the enum schema.
@@ -7939,10 +7970,6 @@ interface EnumResolverContext extends BaseContext {
        */
       literalMembers: Array<Chain>;
     };
-    /**
-     * Returns a nullable wrapper if the enum includes null, undefined otherwise.
-     */
-    nullable: (ctx: EnumResolverContext) => Chain | undefined;
   };
   schema: SchemaWithType<'enum'>;
   /**
@@ -7976,6 +8003,9 @@ interface NumberResolverContext extends BaseContext {
   };
 }
 interface ObjectResolverContext extends BaseContext {
+  applyModifiers: (result: ZodSchemaResult, opts: {
+    optional?: boolean;
+  }) => Ast;
   /**
    * Nodes used to build different parts of the object schema.
    */
@@ -7996,6 +8026,8 @@ interface ObjectResolverContext extends BaseContext {
     ast: Partial<Omit<Ast, 'typeName'>>;
     state: Refs<PluginState>;
   };
+  walk: Walker<ZodSchemaResult, ZodPlugin['Instance']>;
+  walkerCtx: SchemaVisitorContext<ZodPlugin['Instance']>;
 }
 interface StringResolverContext extends BaseContext {
   /**
@@ -8387,146 +8419,35 @@ type UserConfig$1 = Plugin$1.Name<'zod'> & Plugin$1.Hooks & Plugin$1.UserComment
   };
 };
 type Config = Plugin$1.Name<'zod'> & Plugin$1.Hooks & Plugin$1.Comments & Plugin$1.Exports & Resolvers & {
-  /**
-   * Casing convention for generated names.
-   */
+  /** Casing convention for generated names. */
   case: Casing;
-  /**
-   * The compatibility version to target for generated output.
-   *
-   * Can be:
-   * - `4`: [Zod 4](https://zod.dev/packages/zod) (default).
-   * - `3`: [Zod 3](https://v3.zod.dev/).
-   * - `'mini'`: [Zod Mini](https://zod.dev/packages/mini).
-   *
-   * @default 4
-   */
+  /** The compatibility version to target for generated output. */
   compatibilityVersion: 3 | 4 | 'mini';
-  /**
-   * Configuration for date handling in generated Zod schemas.
-   *
-   * Controls how date values are processed and validated using Zod's
-   * date validation features.
-   */
+  /** Configuration for date handling in generated Zod schemas. */
   dates: {
-    /**
-     * Whether to allow unqualified (timezone-less) datetimes:
-     *
-     * When enabled, Zod will accept datetime strings without timezone information.
-     * When disabled, Zod will require timezone information in datetime strings.
-     *
-     * @default false
-     */
+    /** Whether to allow unqualified (timezone-less) datetimes. */
     local: boolean;
-    /**
-     * Whether to include timezone offset information when handling dates.
-     *
-     * When enabled, date strings will preserve timezone information.
-     * When disabled, dates will be treated as local time.
-     *
-     * @default false
-     */
+    /** Whether to include timezone offset information when handling dates. */
     offset: boolean;
   };
-  /**
-   * Configuration for reusable schema definitions.
-   *
-   * Controls generation of shared Zod schemas that can be referenced across
-   * requests and responses.
-   */
-  definitions: NamingOptions & FeatureToggle & {
-    /**
-     * Configuration for TypeScript type generation from Zod schemas.
-     *
-     * Controls generation of TypeScript types based on the generated Zod schemas.
-     */
-    types: {
-      /**
-       * Configuration for `infer` types.
-       */
-      infer: NamingOptions & FeatureToggle;
-    };
-  };
-  /**
-   * Enable Zod metadata support? It's often useful to associate a schema with
-   * some additional metadata for documentation, code generation, AI
-   * structured outputs, form validation, and other purposes.
-   *
-   * @default false
-   */
+  /** Configuration for reusable schema definitions. */
+  definitions: NamingOptions & FeatureToggle & TypeOptions;
+  /** Enable Zod metadata support? */
   metadata: boolean;
-  /**
-   * Configuration for request-specific Zod schemas.
-   *
-   * Controls generation of Zod schemas for request bodies, query parameters, path
-   * parameters, and headers.
-   */
-  requests: NamingOptions & FeatureToggle & {
-    /**
-     * Configuration for TypeScript type generation from Zod schemas.
-     *
-     * Controls generation of TypeScript types based on the generated Zod schemas.
-     */
-    types: {
-      /**
-       * Configuration for `infer` types.
-       */
-      infer: NamingOptions & FeatureToggle;
-    };
-  };
-  /**
-   * Configuration for response-specific Zod schemas.
-   *
-   * Controls generation of Zod schemas for response bodies, error responses,
-   * and status codes.
-   */
-  responses: NamingOptions & FeatureToggle & {
-    /**
-     * Configuration for TypeScript type generation from Zod schemas.
-     *
-     * Controls generation of TypeScript types based on the generated Zod schemas.
-     */
-    types: {
-      /**
-       * Configuration for `infer` types.
-       */
-      infer: NamingOptions & FeatureToggle;
-    };
-  };
-  /**
-   * Configuration for TypeScript type generation from Zod schemas.
-   *
-   * Controls generation of TypeScript types based on the generated Zod schemas.
-   */
+  /** Configuration for request-specific Zod schemas. */
+  requests: NamingOptions & FeatureToggle & TypeOptions;
+  /** Configuration for response-specific Zod schemas. */
+  responses: NamingOptions & FeatureToggle & TypeOptions;
+  /** Configuration for TypeScript type generation from Zod schemas. */
   types: {
-    /**
-     * Configuration for `infer` types.
-     */
+    /** Configuration for `infer` types. */
     infer: FeatureToggle & {
-      /**
-       * Casing convention for generated names.
-       */
+      /** Casing convention for generated names. */
       case: Casing;
     };
   };
-  /**
-   * Configuration for webhook-specific Zod schemas.
-   *
-   * Controls generation of Zod schemas for webhook payloads.
-   */
-  webhooks: NamingOptions & FeatureToggle & {
-    /**
-     * Configuration for TypeScript type generation from Zod schemas.
-     *
-     * Controls generation of TypeScript types based on the generated Zod schemas.
-     */
-    types: {
-      /**
-       * Configuration for `infer` types.
-       */
-      infer: NamingOptions & FeatureToggle;
-    };
-  };
+  /** Configuration for webhook-specific Zod schemas. */
+  webhooks: NamingOptions & FeatureToggle & TypeOptions;
 };
 type ZodPlugin = DefinePlugin$1<UserConfig$1, Config, IApi>;
 //#endregion