@kubb/plugin-zod 5.4.7 → 5.4.8

package/dist/index.cjs

@@ -2236,7 +2236,7 @@ var compatibility = {
 };
 //#endregion
 //#region package.json
-var version = "5.4.7";
+var version = "5.4.8";
 //#endregion
 //#region src/resolvers/resolverZod.ts
 /**

package/dist/index.js

@@ -2226,7 +2226,7 @@ var compatibility = {
 };
 //#endregion
 //#region package.json
-var version = "5.4.7";
+var version = "5.4.8";
 //#endregion
 //#region src/resolvers/resolverZod.ts
 /**

package/docs/overview.md

@@ -1,26 +1,31 @@
 # Zod
 
-Generates Zod v4 schemas from your OpenAPI spec. Use them to validate API responses, form input, and query params at runtime.
+The Zod plugin generates a Zod v4 schema for every schema in your OpenAPI spec.
 
-The schemas need no other plugin. With `inferred: true`, the plugin also exports a `z.infer` type next to each schema, so you can skip `@kubb/plugin-ts`. Client plugins such as `@kubb/plugin-fetch` and `@kubb/plugin-axios` use these schemas when you set their `validator` option.
+The client plugins `@kubb/plugin-fetch`, `@kubb/plugin-axios`, and `@kubb/plugin-client` use these schemas when you set their `validator` option.
 
 ## Setup
 
-Install Zod v4 or higher in the app that uses the generated code. No other plugins are needed.
+- No other plugins are needed.
+- Install `zod` v4 in the app that uses the generated code. `compile` needs 4.5 or later, and `typeGuards` needs 4.6 or later.
 
 ## Options worth knowing
 
-- `mini` generates Zod Mini schemas for smaller bundles, and switches `importPath` to `zod/mini`.
-- `importPath` sets the module the files import `z` from. The default is `zod`.
-- `inferred` exports a `z.infer` type alias next to each schema.
+- `mini` (beta) generates Zod Mini schemas for smaller bundles, and switches `importPath` to `zod/mini`.
+- `importPath` sets the module the generated files import `z` from. The default is `zod`.
+- `inferred` adds a `z.infer` type next to each schema, so you can skip `@kubb/plugin-ts`.
 - `coercion` wraps schemas in `z.coerce`, so input is converted before validation. Pass an object to coerce only dates, strings, or numbers.
 - `guidType` picks `z.uuid()` (default) or `z.guid()` for `format: uuid`.
 - `regexType` writes a `pattern` as a regex literal (default) or a `RegExp` constructor.
 - `typeGuards` adds `is*` type guards and `assert*` assertions.
-- `compile` wraps schemas in `z.compile` for faster validation.
+- `compile` wraps schemas in `z.compile` for faster validation. Circular schemas are left as they are.
+
+See [Options](https://kubb.dev/extensions/kubb-labs/plugin-zod/options) for every option and its default.
 
 ## Example
 
+The config below generates the schemas with a `z.infer` type next to each one.
+
 ```typescript [kubb.config.ts]
 import { defineConfig } from 'kubb/config'
 import { pluginZod } from '@kubb/plugin-zod'
@@ -33,8 +38,3 @@ export default defineConfig({
   ],
 })
 ```
-
-## See also
-
-- [Zod](https://zod.dev/)
-- [Zod Mini](https://zod.dev/packages/mini)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-zod",
-  "version": "5.4.7",
+  "version": "5.4.8",
   "description": "Generate Zod validation schemas with Kubb for runtime data parsing and type safety. Pairs with @kubb/plugin-ts for end-to-end type coverage.",
   "keywords": [
     "code-generation",