@kubb/plugin-zod 5.0.0-beta.84 → 5.0.0-beta.85

package/dist/index.d.ts

@@ -1,54 +1,7 @@
 import { t as __name } from "./rolldown-runtime-C0LytTxp.js";
-import { Exclude, Group, Include, Output, OutputOptions, Override, PluginFactoryOptions, Resolver, ast } from "kubb/kit";
+import { Exclude, Group, Include, Output, OutputOptions, Override, PluginFactoryOptions, Resolver, ResolverPatch, ast } from "kubb/kit";
 import { AdapterOas } from "@kubb/adapter-oas";
 
-//#region ../../internals/shared/src/operation.d.ts
-/**
- * Resolver interface for building operation parameters.
- *
- * `ResolverTs` from `@kubb/plugin-ts` satisfies this interface and can be passed directly.
- */
-type OperationParamsResolver = {
-  /**
-   * Resolves the type name for an individual parameter.
-   *
-   * @example Individual path parameter name
-   * `resolver.resolveParamName(node, param) // → 'DeletePetPathPetId'`
-   */
-  resolveParamName(node: ast.OperationNode, param: ast.ParameterNode): string;
-  /**
-   * Resolves the request body type name.
-   *
-   * @example Request body type name
-   * `resolver.resolveDataName(node) // → 'CreatePetData'`
-   */
-  resolveDataName(node: ast.OperationNode): string;
-  /**
-   * Resolves the grouped path parameters type name.
-   * When the return value equals `resolveParamName`, no indexed access is emitted.
-   *
-   * @example Grouped path params type name
-   * `resolver.resolvePathParamsName(node, param) // → 'DeletePetPathParams'`
-   */
-  resolvePathParamsName(node: ast.OperationNode, param: ast.ParameterNode): string;
-  /**
-   * Resolves the grouped query parameters type name.
-   * When the return value equals `resolveParamName`, an inline struct type is emitted instead.
-   *
-   * @example Grouped query params type name
-   * `resolver.resolveQueryParamsName(node, param) // → 'FindPetsByStatusQueryParams'`
-   */
-  resolveQueryParamsName(node: ast.OperationNode, param: ast.ParameterNode): string;
-  /**
-   * Resolves the grouped header parameters type name.
-   * When the return value equals `resolveParamName`, an inline struct type is emitted instead.
-   *
-   * @example Grouped header params type name
-   * `resolver.resolveHeaderParamsName(node, param) // → 'DeletePetHeaderParams'`
-   */
-  resolveHeaderParamsName(node: ast.OperationNode, param: ast.ParameterNode): string;
-};
-//#endregion
 //#region src/printers/printerZod.d.ts
 /**
  * Partial map of node-type overrides for the Zod printer.
@@ -241,95 +194,123 @@ declare const printerZodMini: (options?: PrinterZodMiniOptions | undefined) => a
 //#region src/types.d.ts
 /**
  * Resolver for Zod that provides naming methods for schema types.
+ *
+ * The top-level `name` resolves a camelCase schema function name with a `Schema` suffix
+ * (`listPetsSchema`), and `file` casts generated file names the same way. Composite naming lives in
+ * the `schema`, `param`, and `response` namespaces.
  */
-type ResolverZod = Resolver & OperationParamsResolver & {
-  /**
-   * Resolves a camelCase schema function name with a `Schema` suffix.
-   */
-  resolveSchemaName(this: ResolverZod, name: string): string;
-  /**
-   * Resolves the schema type name (inferred type from schema).
-   *
-   * @example Schema type names
-   * `resolver.resolveSchemaTypeName('pet') // → 'PetSchemaType'`
-   */
-  resolveSchemaTypeName(this: ResolverZod, name: string): string;
-  /**
-   * Resolves the schema function name for the request (input) direction of a
-   * date-bearing component, where `Date` is encoded back to a wire `string`.
-   *
-   * @example Input schema names
-   * `resolver.resolveInputSchemaName('order') // → 'orderInputSchema'`
-   */
-  resolveInputSchemaName(this: ResolverZod, name: string): string;
-  /**
-   * Resolves the inferred type name for the request (input) direction variant.
-   *
-   * @example Input schema type names
-   * `resolver.resolveInputSchemaTypeName('order') // → 'OrderInputSchemaType'`
-   */
-  resolveInputSchemaTypeName(this: ResolverZod, name: string): string;
-  /**
-   * Resolves the generated type name from the schema.
-   *
-   * @example Type names
-   * `resolver.resolveTypeName('petSchema') // → 'PetSchemaType'`
-   */
-  resolveTypeName(this: ResolverZod, name: string): string;
-  /**
-   * Resolves the output file name for a schema.
-   */
-  resolvePathName(this: ResolverZod, name: string, type?: 'file' | 'function' | 'type' | 'const'): string;
-  /**
-   * Resolves the name for an operation response by status code.
-   *
-   * @example Response status names
-   * `resolver.resolveResponseStatusName(node, 200) // → 'listPetsStatus200Schema'`
-   */
-  resolveResponseStatusName(this: ResolverZod, node: ast.OperationNode, statusCode: ast.StatusCode): string;
-  /**
-   * Resolves the name for the collection of all operation responses.
-   *
-   * @example Responses collection names
-   * `resolver.resolveResponsesName(node) // → 'listPetsResponsesSchema'`
-   */
-  resolveResponsesName(this: ResolverZod, node: ast.OperationNode): string;
-  /**
-   * Resolves the name for the union of all operation responses.
-   *
-   * @example Response union names
-   * `resolver.resolveResponseName(node) // → 'listPetsResponseSchema'`
-   */
-  resolveResponseName(this: ResolverZod, node: ast.OperationNode): string;
-  /**
-   * Resolves the name for the union of an operation's error (non-2xx) responses. Generated clients
-   * validate the error body against this on the non-throw path.
-   *
-   * @example Error union names
-   * `resolver.resolveErrorName(node) // → 'listPetsErrorSchema'`
-   */
-  resolveErrorName(this: ResolverZod, node: ast.OperationNode): string;
-  /**
-   * Resolves the name for an operation's grouped path parameters type.
-   *
-   * @example Path parameters names
-   * `resolver.resolvePathParamsName(node, param) // → 'deletePetPathPetIdSchema'`
-   */
-  resolvePathParamsName(this: ResolverZod, node: ast.OperationNode, param: ast.ParameterNode): string;
+type ResolverZod = Resolver & {
+  /**
+   * Names derived from a component schema: its inferred types and the request (input) direction
+   * variant, where a date-bearing component encodes `Date` back to a wire `string`.
+   */
+  schema: {
+    /**
+     * Resolves the schema type name (inferred type from schema).
+     *
+     * @example Schema type names
+     * `resolver.schema.typeName('pet') // → 'PetSchemaType'`
+     */
+    typeName(name: string): string;
+    /**
+     * Resolves the generated type name from the schema.
+     *
+     * @example Type names
+     * `resolver.schema.type('petSchema') // → 'PetSchemaType'`
+     */
+    type(name: string): string;
+    /**
+     * Resolves the schema function name for the request (input) direction of a
+     * date-bearing component, where `Date` is encoded back to a wire `string`.
+     *
+     * @example Input schema names
+     * `resolver.schema.inputName('order') // → 'orderInputSchema'`
+     */
+    inputName(name: string): string;
+    /**
+     * Resolves the inferred type name for the request (input) direction variant.
+     *
+     * @example Input schema type names
+     * `resolver.schema.inputTypeName('order') // → 'OrderInputSchemaType'`
+     */
+    inputTypeName(name: string): string;
+  };
   /**
-   * Resolves the name for an operation's grouped query parameters type.
-   *
-   * @example Query parameters names
-   * `resolver.resolveQueryParamsName(node, param) // → 'findPetsByStatusQueryStatusSchema'`
-   */
-  resolveQueryParamsName(this: ResolverZod, node: ast.OperationNode, param: ast.ParameterNode): string;
+   * Names for an operation's parameters: an individual parameter and the grouped path, query, and
+   * header schemas.
+   */
+  param: {
+    /**
+     * Resolves the schema name for an individual parameter.
+     *
+     * @example Individual parameter name
+     * `resolver.param.name(node, param) // → 'deletePetPathPetIdSchema'`
+     */
+    name(node: ast.OperationNode, param: ast.ParameterNode): string;
+    /**
+     * Resolves the name for an operation's grouped path parameters schema.
+     *
+     * @example Path parameters names
+     * `resolver.param.path(node, param) // → 'deletePetPathPetIdSchema'`
+     */
+    path(node: ast.OperationNode, param: ast.ParameterNode): string;
+    /**
+     * Resolves the name for an operation's grouped query parameters schema.
+     *
+     * @example Query parameters names
+     * `resolver.param.query(node, param) // → 'findPetsByStatusQueryStatusSchema'`
+     */
+    query(node: ast.OperationNode, param: ast.ParameterNode): string;
+    /**
+     * Resolves the name for an operation's grouped header parameters schema.
+     *
+     * @example Header parameters names
+     * `resolver.param.headers(node, param) // → 'deletePetHeaderApiKeySchema'`
+     */
+    headers(node: ast.OperationNode, param: ast.ParameterNode): string;
+  };
   /**
-   * Resolves the name for an operation's grouped header parameters type.
-   *
-   * @example Header parameters names
-   * `resolver.resolveHeaderParamsName(node, param) // → 'deletePetHeaderApiKeySchema'`
-   */
-  resolveHeaderParamsName(this: ResolverZod, node: ast.OperationNode, param: ast.ParameterNode): string;
+   * Names for an operation's responses: per-status schemas, the request body, and the combined,
+   * union, and error names.
+   */
+  response: {
+    /**
+     * Resolves the name for an operation response by status code.
+     *
+     * @example Response status names
+     * `resolver.response.status(node, 200) // → 'listPetsStatus200Schema'`
+     */
+    status(node: ast.OperationNode, statusCode: ast.StatusCode): string;
+    /**
+     * Resolves the request body schema name.
+     *
+     * @example Request body names
+     * `resolver.response.body(node) // → 'createPetBodySchema'`
+     */
+    body(node: ast.OperationNode): string;
+    /**
+     * Resolves the name for the collection of all operation responses.
+     *
+     * @example Responses collection names
+     * `resolver.response.responses(node) // → 'listPetsResponsesSchema'`
+     */
+    responses(node: ast.OperationNode): string;
+    /**
+     * Resolves the name for the union of all operation responses.
+     *
+     * @example Response union names
+     * `resolver.response.response(node) // → 'listPetsResponseSchema'`
+     */
+    response(node: ast.OperationNode): string;
+    /**
+     * Resolves the name for the union of an operation's error (non-2xx) responses. Generated clients
+     * validate the error body against this on the non-throw path.
+     *
+     * @example Error union names
+     * `resolver.response.error(node) // → 'listPetsErrorSchema'`
+     */
+    error(node: ast.OperationNode): string;
+  };
 };
 /**
  * Where the generated Zod schemas are written and how they are exported, plus the optional
@@ -408,7 +389,7 @@ type Options = OutputOptions & {
    * Override how schema and operation names are built. Methods you omit fall back
    * to the default `resolverZod`.
    */
-  resolver?: Partial<ResolverZod> & ThisType<ResolverZod>;
+  resolver?: ResolverPatch<ResolverZod>;
   /**
    * Replace the Zod handler for a specific schema type (`'integer'`, `'date'`, ...).
    * When `mini: true`, overrides target the Zod Mini printer instead.
@@ -499,8 +480,8 @@ declare const pluginZod: (options?: Options | undefined) => import("kubb/kit").P
  * ```ts
  * import { resolverZod } from '@kubb/plugin-zod'
  *
- * resolverZod.default('list pets', 'function') // 'listPetsSchema'
- * resolverZod.resolveSchemaTypeName('pet')     // 'PetSchemaType'
+ * resolverZod.name('list pets')          // 'listPetsSchema'
+ * resolverZod.schema.typeName('pet')     // 'PetSchemaType'
  * ```
  */
 declare const resolverZod: ResolverZod;