feat: add zod/mini library to the contest

Author: Shuunen

README.md

@@ -32,36 +32,42 @@ Here are the library used in this comparison :
 - [arktype](https://github.com/arktypeio/arktype) from David Blass
 - [valibot](https://github.com/fabian-hiller/valibot) from Fabian Hiller
 - [zod](https://github.com/colinhacks/zod) from Colin McDonnell
+- [zod/mini](https://github.com/colinhacks/zod) from Colin McDonnell
 
-| Date       | Score | Library | Deps  |  Size  | Light | Input | Throw | Safe  | Script exec |  Lib exec   | Fast  | Readability |
-| ---------- | :---: | :-----: | :---: | :----: | :---: | :---: | :---: | :---: | :---------: | :---------: | :---: | :---------: |
-| 2025-04-11 |   1   | arktype |   2   | 140 KB |  _0_  | **1** |  _0_  | **1** | 406 ms _-1_ | 338 ms _-1_ |  _0_  |    **1**    |
-| 2025-04-11 |   7   | valibot | **0** |  5 KB  | **1** | **1** | **1** | **1** | 14 ms **1** |  4 ms **1** | **1** |     _0_     |
-| 2025-04-11 |   6   |   zod3  | **0** | 60 KB  |  _0_  | **1** | **1** | **1** | 25 ms **1** |  14 ms _0_  | **1** |    **1**    |
-| 2025-04-11 |   6   |   zod4  |   1   | 49 KB  |  _0_  | **1** | **1** | **1** | 79 ms **1** |  60 ms _0_  | **1** |    **1**    |
-
-Test have been updated on 04-11 and it now run in a M3 pro that's why the numbers are smaller now
+| Date       | Score |  Library  | Deps  |  Size  | Light | Input | Throw | Safe  | Script exec  |  Lib exec   | Fast  | Readability |
+| ---------- | :---: | :-------: | :---: | :----: | :---: | :---: | :---: | :---: | :----------: | :---------: | :---: | :---------: |
+| 2025-04-13 |   0   |  arktype  |   2   | 147 KB |  _0_  | **1** |  _0_  | **1** | 873 ms _-1_  | 691 ms _-1_ |  _0_  |    **1**    |
+| 2025-04-13 |   7   |  valibot  | **0** |  5 KB  | **1** | **1** | **1** | **1** | 68 ms **1**  | 11 ms **1** | **1** |     _0_     |
+| 2025-04-13 |   7   |  zod v3   | **0** | 60 KB  |  _0_  | **1** | **1** | **1** | 101 ms **1** | 35 ms **1** | **1** |    **1**    |
+| 2025-04-13 |   4   |  zod v4   |   1   | 49 KB  |  _0_  | **1** | **1** | **1** |  222 ms _0_  | 144 ms _0_  |  _0_  |    **1**    |
+| 2025-04-13 |   4   | @zod/mini |   1   | 21 KB  | **1** | **1** | **1** | **1** |  243 ms _0_  | 168 ms _0_  |  _0_  |    **1**    |
 
 Legend :
 
 - Deps : the number of dependencies of the library
 - Size : the minified build size in bytes of the related file in `src`, run  `bun run build` to see by yourself
-- Light : 1 point if the build is less than 10 KB
+- Light : 1 point if the build is `<= 20 KB`
 - Input : 1 point if the library can see that `age` is optional in the input but not optional in `type User` the output type
 - Throw : 1 point if the library have a parse or throw method, useful when we don't want to handle the error cases
 - Safe : 1 point if the library have a safe parse method that will not throw and usually return a `Result` type
-- Script exec : 1 point if the average time in milliseconds to execute the test file with bun is under `100ms`, check the `bun run bench` command output
-- Lib exec : 1 point if the average time in milliseconds to execute the library is under `30ms`, check the `bun run check:once` command output
+- Script exec : 1 point if the average time in ms to execute the test file with bun is `<= 100ms`, check the `bun run bench` command output
+- Lib exec : 1 point if the average time in ms to execute the library is `<= 35ms`, check the `bun run check:once` command output
 - Fast : 1 point if the library execution time is less than 100 ms
 - Readability : 1 point if the library is easy to write & read, the syntax need to be intuitive
 
+Test have been run on :
+
+- Windows 11 x64
+- AMD Ryzen 7 7800X3D, 64GB of RAM
+- Bun v1.2.4
+
 ## My favorite pick
 
 Zod is my favorite pick because it's fast and provide a better readability.
 
 Ok the build size is bigger but it does not impact the performance that much.
 
-The 34ms vs 10ms seems like a 3x difference but it's the time to run 1000 iterations. So in the end it's not that much of a difference in a real world scenario.
+The 35ms vs 11ms seems like a 3x difference but it's the time to run 1000 iterations. So in the end it's not that much of a difference in a real world scenario.
 
 For some weird reason zod4 seems to be slower than zod3
 
@@ -71,7 +77,7 @@ For some weird reason zod4 seems to be slower than zod3
 - [ ] check error messages
 - [ ] check custom error messages
 - [ ] check custom validation rules
-- [X] check the perf without using `console`
+- [ ] check the perf without using `console`
 
 ## How to contribute
 

package.json

@@ -12,6 +12,7 @@
     }
   ],
   "dependencies": {
+    "@zod/mini": "4.0.0-beta.20250412T085909",
     "arktype": "^2.1",
     "valibot": "latest",
     "zod3": "npm:zod@^3.24.2",
@@ -44,12 +45,12 @@
   },
   "scripts": {
     "bench": "bun bench:bun --warmup 5 --runs 10",
-    "bench:bun": "hyperfine 'bun src/arktype.ts' 'bun src/valibot.ts' 'bun src/zod3.ts' 'bun src/zod4.ts'",
-    "bench:node": "hyperfine --runs 10 'node dist/arktype.js' 'node dist/valibot.js' 'node dist/zod3.js' 'node dist/zod4.js'",
-    "bench:node:strip": "hyperfine --runs 10 'node --experimental-strip-types src/arktype.ts' 'node --experimental-strip-types src/valibot.ts' 'node --experimental-strip-types src/zod3.ts' 'node --experimental-strip-types src/zod4.ts'",
+    "bench:bun": "hyperfine 'bun src/arktype.ts' 'bun src/valibot.ts' 'bun src/zod3.ts' 'bun src/zod4.ts' 'bun src/zod-mini.ts'",
+    "bench:node": "hyperfine --runs 10 'node dist/arktype.js' 'node dist/valibot.js' 'node dist/zod3.js' 'node dist/zod4.js' 'node dist/zod-mini.js'",
+    "bench:node:strip": "hyperfine --runs 10 'node --experimental-strip-types src/arktype.ts' 'node --experimental-strip-types src/valibot.ts' 'node --experimental-strip-types src/zod3.ts' 'node --experimental-strip-types src/zod4.ts' 'node --experimental-strip-types src/zod-mini.ts'",
     "build": "bun scripts/build.ts && echo build success",
     "check": "pnpm i && bun check:tsc && bun run build && bun check:once && echo check success",
-    "check:once": "bun src/arktype.ts && bun src/valibot.ts && bun src/zod3.ts && bun src/zod4.ts && echo check:once success",
+    "check:once": "bun src/arktype.ts && bun src/valibot.ts && bun src/zod3.ts && bun src/zod4.ts && bun src/zod-mini.ts && echo check:once success",
     "check:repo": "repo-check && echo check:repo success",
     "check:tsc": "tsc --noEmit && echo check:tsc success"
   },

pnpm-lock.yaml

@@ -0,0 +1,55 @@
+import {
+  string,
+  number,
+  object,
+  type infer as InferOutput,
+  type input as InferInput,
+  refine,
+  optional,
+  _default,
+} from "@zod/mini";
+import { checkUserA, checkUserB, checkUserC, nbIterations } from "./utils.ts";
+
+const startTime = performance.now();
+
+for (let i = 0; i < nbIterations; i++) {
+  const userSchema = object({
+    name: string(),
+    age: _default(optional(number()), 42),
+    phone: _default(
+      optional(
+        string().check(
+          refine((phone) => (typeof phone === "number" ? String(phone) : phone))
+        )
+      ),
+      "123-456-7890"
+    ),
+  });
+
+  // @ts-expect-error not exported, it's ok :p
+  type User = InferOutput<typeof userSchema>;
+
+  type UserInput = InferInput<typeof userSchema>;
+
+  const userA = userSchema.parse({ name: "Jordan", age: 42 });
+  checkUserA(userA);
+
+  function createUser(input: UserInput) {
+    const result = userSchema.safeParse(input);
+    if (!result.success) return userA;
+    return result.data;
+  }
+
+  const userB = createUser({ name: "Romain", age: 35, phone: "1234567890" });
+  checkUserB(userB);
+
+  // @ts-expect-error age should be a number
+  const userC = createUser({ name: "Romain", age: "35" });
+  checkUserC(userC);
+}
+
+console.log(
+  `Zod 4 mini exec time for ${nbIterations} iterations :`,
+  performance.now() - startTime,
+  "ms"
+);