@kubb/plugin-zod 5.0.0-alpha.25 → 5.0.0-alpha.27

package/dist/index.d.ts

@@ -1,9 +1,118 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
+import * as _$_kubb_ast0 from "@kubb/ast";
 import { OperationParamsResolver } from "@kubb/ast";
 import * as _$_kubb_core0 from "@kubb/core";
-import { CompatibilityPreset, Exclude, Generator, Group, Include, Output, Override, PluginFactoryOptions, PrinterFactoryOptions, ResolvePathOptions, Resolver, UserGroup } from "@kubb/core";
+import { CompatibilityPreset, Exclude, Generator, Group, Include, Output, Override, PluginFactoryOptions, PrinterFactoryOptions, PrinterPartial, ResolvePathOptions, Resolver, UserGroup } from "@kubb/core";
 import { OperationNode, ParameterNode, SchemaNode, StatusCode, Visitor } from "@kubb/ast/types";
 
+//#region src/printers/printerZod.d.ts
+/**
+ * Partial map of node-type overrides for the Zod printer.
+ *
+ * Each key is a `SchemaType` string (e.g. `'date'`, `'string'`). The function
+ * replaces the built-in handler for that node type. Use `this.transform` to
+ * recurse into nested schema nodes, and `this.options` to read printer options.
+ *
+ * @example Override the `date` handler
+ * ```ts
+ * pluginZod({
+ *   printer: {
+ *     nodes: {
+ *       date(node) {
+ *         return 'z.string().date()'
+ *       },
+ *     },
+ *   },
+ * })
+ * ```
+ */
+type PrinterZodNodes = PrinterPartial<string, PrinterZodOptions>;
+type PrinterZodOptions = {
+  coercion?: PluginZod['resolvedOptions']['coercion'];
+  guidType?: PluginZod['resolvedOptions']['guidType'];
+  wrapOutput?: PluginZod['resolvedOptions']['wrapOutput'];
+  resolver?: ResolverZod;
+  schemaName?: string;
+  /**
+   * Property keys to exclude from the generated object schema via `.omit({ key: true })`.
+   */
+  keysToOmit?: Array<string>;
+  /**
+   * Partial map of node-type overrides. Each entry replaces the built-in handler for that node type.
+   */
+  nodes?: PrinterZodNodes;
+};
+type PrinterZodFactory = PrinterFactoryOptions<'zod', PrinterZodOptions, string, string>;
+/**
+ * Zod v4 printer built with `definePrinter`.
+ *
+ * Converts a `SchemaNode` AST into a **standard** Zod v4 code string
+ * using the chainable method API (`.optional()`, `.nullable()`, etc.).
+ *
+ * For the `zod/mini` functional API, see {@link printerZodMini}.
+ *
+ * @example
+ * ```ts
+ * const printer = printerZod({ coercion: false })
+ * const code = printer.print(stringSchemaNode) // "z.string()"
+ * ```
+ */
+declare const printerZod: (options?: PrinterZodOptions | undefined) => _$_kubb_ast0.Printer<PrinterZodFactory>;
+//#endregion
+//#region src/printers/printerZodMini.d.ts
+/**
+ * Partial map of node-type overrides for the Zod Mini printer.
+ *
+ * Each key is a `SchemaType` string (e.g. `'date'`, `'string'`). The function
+ * replaces the built-in handler for that node type. Use `this.transform` to
+ * recurse into nested schema nodes, and `this.options` to read printer options.
+ *
+ * @example Override the `date` handler
+ * ```ts
+ * pluginZod({
+ *   mini: true,
+ *   printer: {
+ *     nodes: {
+ *       date(node) {
+ *         return 'z.iso.date()'
+ *       },
+ *     },
+ *   },
+ * })
+ * ```
+ */
+type PrinterZodMiniNodes = PrinterPartial<string, PrinterZodMiniOptions>;
+type PrinterZodMiniOptions = {
+  guidType?: PluginZod['resolvedOptions']['guidType'];
+  wrapOutput?: PluginZod['resolvedOptions']['wrapOutput'];
+  resolver?: ResolverZod;
+  schemaName?: string;
+  /**
+   * Property keys to exclude from the generated object schema via `.omit({ key: true })`.
+   */
+  keysToOmit?: Array<string>;
+  /**
+   * Partial map of node-type overrides. Each entry replaces the built-in handler for that node type.
+   */
+  nodes?: PrinterZodMiniNodes;
+};
+type PrinterZodMiniFactory = PrinterFactoryOptions<'zod-mini', PrinterZodMiniOptions, string, string>;
+/**
+ * Zod v4 **Mini** printer built with `definePrinter`.
+ *
+ * Converts a `SchemaNode` AST into a Zod v4 Mini code string using the
+ * functional API (`z.optional(z.string())`) for better tree-shaking.
+ *
+ * For the standard chainable API, see {@link printerZod}.
+ *
+ * @example
+ * ```ts
+ * const printer = printerZodMini({})
+ * const code = printer.print(optionalStringNode) // "z.optional(z.string())"
+ * ```
+ */
+declare const printerZodMini: (options?: PrinterZodMiniOptions | undefined) => _$_kubb_ast0.Printer<PrinterZodMiniFactory>;
+//#endregion
 //#region src/types.d.ts
 /**
  * The concrete resolver type for `@kubb/plugin-zod`.
@@ -13,61 +122,73 @@ type ResolverZod = Resolver & OperationParamsResolver & {
   /**
    * Resolves a camelCase schema function name with a `Schema` suffix.
    */
-  resolveName(name: string): string;
+  resolveSchemaName(this: ResolverZod, name: string): string;
+  /**
+   * Resolves the name for a `z.infer<typeof ...>` type export.
+   * Strips the trailing `Schema` suffix (added by `resolveSchemaName`) before PascalCasing.
+   *
+   * @example
+   * resolver.resolveSchemaTypeName('pet) // → 'PetSchema'
+   * resolver.resolveSchemaTypeName('addPet200') // → 'AddPet200Schema'
+   * resolver.resolveSchemaTypeName('PetName') // → 'PetNameSchema'
+   */
+  resolveSchemaTypeName(this: ResolverZod, name: string): string;
   /**
-   * Resolves the name for a `z.infer<typeof ...>` type export from an already-resolved function name.
+   * Resolves the name for a `z.infer<typeof ...>` type export.
+   * Strips the trailing `Schema` suffix (added by `resolveSchemaName`) before PascalCasing.
    *
    * @example
-   * resolver.resolveInferName('petSchema') // → 'PetSchema'
-   * resolver.resolveInferName('addPet200Schema') // → 'AddPet200Schema'
+   * resolver.resolveTypeName('pet') // → 'Pet'
+   * resolver.resolveTypeName('addPet200') // → 'AddPet200'
+   * resolver.resolveTypeName('PetName') // → 'PetName'
    */
-  resolveInferName(name: string): string;
+  resolveTypeName(this: ResolverZod, name: string): string;
   /**
    * Resolves a PascalCase path/file name for the generated output.
    */
-  resolvePathName(name: string, type?: 'file' | 'function' | 'type' | 'const'): string;
+  resolvePathName(this: ResolverZod, name: string, type?: 'file' | 'function' | 'type' | 'const'): string;
   /**
    * Resolves the name for an operation response by status code.
    *
    * @example
    * resolver.resolveResponseStatusName(node, 200) // → 'listPetsStatus200Schema'
    */
-  resolveResponseStatusName(node: OperationNode, statusCode: StatusCode): string;
+  resolveResponseStatusName(this: ResolverZod, node: OperationNode, statusCode: StatusCode): string;
   /**
    * Resolves the name for the collection of all operation responses.
    *
    * @example
    * resolver.resolveResponsesName(node) // → 'listPetsResponsesSchema'
    */
-  resolveResponsesName(node: OperationNode): string;
+  resolveResponsesName(this: ResolverZod, node: OperationNode): string;
   /**
    * Resolves the name for the union of all operation responses.
    *
    * @example
    * resolver.resolveResponseName(node) // → 'listPetsResponseSchema'
    */
-  resolveResponseName(node: OperationNode): string;
+  resolveResponseName(this: ResolverZod, node: OperationNode): string;
   /**
    * Resolves the name for an operation's grouped path parameters type.
    *
    * @example
    * resolver.resolvePathParamsName(node, param) // → 'deletePetPathPetIdSchema'
    */
-  resolvePathParamsName(node: OperationNode, param: ParameterNode): string;
+  resolvePathParamsName(this: ResolverZod, node: OperationNode, param: ParameterNode): string;
   /**
    * Resolves the name for an operation's grouped query parameters type.
    *
    * @example
    * resolver.resolveQueryParamsName(node, param) // → 'findPetsByStatusQueryStatusSchema'
    */
-  resolveQueryParamsName(node: OperationNode, param: ParameterNode): string;
+  resolveQueryParamsName(this: ResolverZod, node: OperationNode, param: ParameterNode): string;
   /**
    * Resolves the name for an operation's grouped header parameters type.
    *
    * @example
    * resolver.resolveHeaderParamsName(node, param) // → 'deletePetHeaderApiKeySchema'
    */
-  resolveHeaderParamsName(node: OperationNode, param: ParameterNode): string;
+  resolveHeaderParamsName(this: ResolverZod, node: OperationNode, param: ParameterNode): string;
 };
 type Options = {
   /**
@@ -169,13 +290,38 @@ type Options = {
    */
   compatibilityPreset?: CompatibilityPreset;
   /**
-   * Custom resolver instances for zod-specific name resolution.
+   * A single resolver whose methods override the default resolver's naming conventions.
+   * When a method returns `null` or `undefined`, the default resolver's result is used instead.
    */
-  resolvers?: Array<ResolverZod>;
+  resolver?: Partial<ResolverZod> & ThisType<ResolverZod>;
   /**
-   * AST visitor transformers applied during code generation.
+   * Override individual printer node handlers to customise rendering of specific schema types.
+   *
+   * Each key is a `SchemaType` (e.g. `'date'`, `'string'`). The function replaces the
+   * built-in handler for that type. Use `this.transform` to recurse into nested schema nodes.
+   * When `mini: true`, the overrides apply to the Zod Mini printer.
+   *
+   * @example Override the `date` node to use `z.string().date()`
+   * ```ts
+   * pluginZod({
+   *   printer: {
+   *     nodes: {
+   *       date(node) {
+   *         return 'z.string().date()'
+   *       },
+   *     },
+   *   },
+   * })
+   * ```
+   */
+  printer?: {
+    nodes?: PrinterZodNodes | PrinterZodMiniNodes;
+  };
+  /**
+   * A single AST visitor applied to each SchemaNode/OperationNode before printing.
+   * When a visitor method returns `null` or `undefined`, the preset transformer's result is used instead.
    */
-  transformers?: Array<Visitor>;
+  transformer?: Visitor;
 };
 type ResolvedOptions = {
   output: Output;
@@ -190,7 +336,7 @@ type ResolvedOptions = {
   mini: NonNullable<Options['mini']>;
   wrapOutput: Options['wrapOutput'];
   paramsCasing: Options['paramsCasing'];
-  transformers: Array<Visitor>;
+  printer: Options['printer'];
 };
 type PluginZod = PluginFactoryOptions<'plugin-zod', Options, ResolvedOptions, never, ResolvePathOptions, ResolverZod>;
 //#endregion
@@ -223,63 +369,6 @@ declare const pluginZodName = "plugin-zod";
  */
 declare const pluginZod: (options?: Options | undefined) => _$_kubb_core0.UserPluginWithLifeCycle<PluginZod>;
 //#endregion
-//#region src/printers/printerZod.d.ts
-type ZodOptions = {
-  coercion?: PluginZod['resolvedOptions']['coercion'];
-  guidType?: PluginZod['resolvedOptions']['guidType'];
-  wrapOutput?: PluginZod['resolvedOptions']['wrapOutput'];
-  resolver?: ResolverZod;
-  schemaName?: string;
-  /**
-   * Property keys to exclude from the generated object schema via `.omit({ key: true })`.
-   */
-  keysToOmit?: Array<string>;
-};
-type ZodPrinterFactory = PrinterFactoryOptions<'zod', ZodOptions, string, string>;
-/**
- * Zod v4 printer built with `definePrinter`.
- *
- * Converts a `SchemaNode` AST into a **standard** Zod v4 code string
- * using the chainable method API (`.optional()`, `.nullable()`, etc.).
- *
- * For the `zod/mini` functional API, see {@link printerZodMini}.
- *
- * @example
- * ```ts
- * const printer = printerZod({ coercion: false })
- * const code = printer.print(stringSchemaNode) // "z.string()"
- * ```
- */
-declare const printerZod: (options?: ZodOptions | undefined) => _$_kubb_core0.Printer<ZodPrinterFactory>;
-//#endregion
-//#region src/printers/printerZodMini.d.ts
-type ZodMiniOptions = {
-  guidType?: PluginZod['resolvedOptions']['guidType'];
-  wrapOutput?: PluginZod['resolvedOptions']['wrapOutput'];
-  resolver?: ResolverZod;
-  schemaName?: string;
-  /**
-   * Property keys to exclude from the generated object schema via `.omit({ key: true })`.
-   */
-  keysToOmit?: Array<string>;
-};
-type ZodMiniPrinterFactory = PrinterFactoryOptions<'zod-mini', ZodMiniOptions, string, string>;
-/**
- * Zod v4 **Mini** printer built with `definePrinter`.
- *
- * Converts a `SchemaNode` AST into a Zod v4 Mini code string using the
- * functional API (`z.optional(z.string())`) for better tree-shaking.
- *
- * For the standard chainable API, see {@link printerZod}.
- *
- * @example
- * ```ts
- * const printer = printerZodMini({})
- * const code = printer.print(optionalStringNode) // "z.optional(z.string())"
- * ```
- */
-declare const printerZodMini: (options?: ZodMiniOptions | undefined) => _$_kubb_core0.Printer<ZodMiniPrinterFactory>;
-//#endregion
 //#region src/resolvers/resolverZod.d.ts
 /**
  * Default resolver for `@kubb/plugin-zod`.
@@ -321,5 +410,5 @@ declare const resolverZod: ResolverZod;
  */
 declare const resolverZodLegacy: ResolverZod;
 //#endregion
-export { type PluginZod, type ResolverZod, pluginZod, pluginZodName, printerZod, printerZodMini, resolverZod, resolverZodLegacy, zodGenerator, zodGeneratorLegacy };
+export { type PluginZod, type PrinterZodFactory, type PrinterZodMiniFactory, type PrinterZodMiniNodes, type PrinterZodMiniOptions, type PrinterZodNodes, type PrinterZodOptions, type ResolverZod, pluginZod, pluginZodName, printerZod, printerZodMini, resolverZod, resolverZodLegacy, zodGenerator, zodGeneratorLegacy };
 //# sourceMappingURL=index.d.ts.map