zod

Commits:

• 291c1ca9864570e68a6c104d869de467f665da86 Add should-build script
• e32d99b54fff920c4b0b451e9099b472d20a3c4b Move should-build script
• d4faf71b8cc156a49bae23fc09c4d54b88f22bd5 Add v3 docs (#4972)
• dfae37195bed15dce84af0b17ef04cdc3704ef5e Update Jazz img on v3 docs
• d6cd30d3898aaf592c6077464c1a45fd0f6f66d3 fix #4973 (#4974)
• 18504960cdce29529e37415b87fed1732facf1ef Fix typo in valype (#4960)
• 4ec2f8776193642d91814521d8a4c22bbb766cb1 Add Zod Playground to zod 4 ecosystem (#4975)
• 2b571a21875e9e3299de261e512dad300878c3a1 Update docs z.enum with object literal example (#4967)
• 813451db7fcf64c5322835984eded9bfe95be1da v4.0.10 (#4978)

Commits:

• 4e7a3ef180f6a5525d9021638e9df20b3ca50456 v4.0.9 (#4970)

Commits:

• 3048d14bc7b803507302b8ee3cd1eeeffbd27396 Fix #4961

Commits:

• 7ab1b3cd2e272a74c0f7c5cde70ee23c2ef288d6 Do not continue parsing in ZodPipe if issues exists. Closes #4926.
• 34b400a5422bc30b48395cdd44007ff4e811fb71 4.0.7

Commits:

• a3e43911abb980f1830b68a440c231ae52eacec0 Unwiden catch input type (#4870)
• 499df780b10dfcce29afba3e811757f7eade9570 Add RFC 9562 mentions. Closes #4872
• d0493f3dceb117972464f01cb0765262a5ffed70 Doc tweak - spread vs destructuring (#4919)
• 8dad394b805fd18cee8e44a37dab983916e0d92c feat: Icelandic translation (#4920)
• 2ffdae1faafcc34639a7a846a55776c2a886a644 Bulgarian (bg) translation (#4928)
• 09731358f69bb1238f6e00e0ca82e28c095b800f docs: add valype to xToZodConverts (#4930)
• d2573409ab02e5d0c2a644315798999d619e4c89 Remove moduleResolution callout (#4932)
• 075970d2aeb50c840840cc44559b31b16d7b6504 docs: add coercion note to fix compile errors (#4940)
• b9e8a60ff44aa5fffc39617eec894117132fbbac Add @hey-api/openapi-ts to Zod 3 ecosystem (#4949)
• ad7b0ffd91da4f0466c97b7b5e6b60f376ae4f33 Add @hey-api/openapi-ts to Zod 3 ecosystem (#4942)
• 4619109e7927019837a3a13d4ab8bba5c72989de feat(locales): add Danish translations (#4953)
• cb84a5711b83d25c7dcf218c4c01097cf036c1f5 Point to zod-v3-to-v4 codemod in Zod 4 migration guide (#4954)
• 28a5091092b22146a26f8a4e7c18e2943f53a86a Update api.mdx (#4955)
• 7f3cf946ca9aa90031cb954d6f683cb09de4d894 Fix URL sup example (#4959)
• 17e7f3b4e1c2c97b3c9487c97ac6703a16ed1cfb Add @hey-api/openapi-ts to Zod 4 ecosystem (#4950)
• f75d85294df2ff4ccea056e8eeb7c14750fa929f fix: escapes decimal place in z.literal (#4895)
• 7dd7484802b1351c8b81d3d523aadd876fcdf73e v4.0.6 (#4941)

Commits:

• f91a73ec23f9ec28d908af2caa643a54088516c5 Support pipes in discriminated unions. Closes #4856 (#4861)
• 45afab0f846dffd591362b6f770017507eb185b5 4.0.5

Commits:

• 9335f0543d6359f9236e3e33b78cc5b2788dbe0f Adds ZodFirstPartyTypeKind stub to fix module resolution failure inside zod-to-json-schema

Commits:

• 5905a8d810eff6f4677e6aa9e557f92a676805cf Improve check-versions script
• f3e749b1b057a2cf0a0bce7e07abec4e0520e0f8 Remove global File interface
• 44a936cb77961e57a0988d8a3c63d9c71fce69ac 4.0.2
• 74006edd49e3fe8d74010090462859593c2bd1e2 Fix JSR provenance
• ff4af5e889d4ad7136a9cde7202b16261db5c83c 4.0.3
• ce573e8799f86e2f68307eba95c2d40fc92617b7 Update test badge
• 9a7161a976d6349f738c00cb6d6528c0407a65e8 Fix versions

With this release, zod@4.0.0 has been published to npm. There were no code changes between 3.25.76 and 4.0.0!

Zod 4 has been stable for the past 6 weeks, but it was published inside zod@3.25.x on npm. this transitionary window gave the ecosystem time to incrementally support for Zod 4 (without dropping support for Zod 3). As there is now near-universal support for Zod 4 in the ecosystem, ths time feels right to finally put a bow on things 🎀

To upgrade to Zod 4:

npm upgrade zod@^4.0.0

If you’ve already migrated to Zod 4 using the subpaths, there are no changes required. however you can optionally simplify your imports (recommended)

// after upgrading to zod@4.0.0:
import * as z from "zod"; // Zod 4 (regular)
import * as z from "zod/mini" // Zod 4 Mini

// these still work, but are no longer needed 
import * as z from "zod/v4"; 
import * as z from "zod/v4-mini":

// if you still need Zod 3
import * as z from "zod/v3"; // Zod 3

Library authors — if you've already implemented Zod 4 support according to the best practices outlined in the Library authors guide, bump your peer dependency to include zod@^4.0.0:

// package.json
{
  "peerDependencies": {
    "zod": "^3.25.0 || ^4.0.0"
  }
}

There should be no other code changes necessary. No code changes were made between the latest 3.25.x release and 4.0.0. This does not require a major version bump.