@esmj/schema 0.1.0 → 0.2.0

package/README.md

@@ -18,6 +18,55 @@ npm install @esmj/schema
 4. **Lightweight**: None dependencies and a small footprint make it ideal for projects where performance and simplicity are key.
 5. **Customizable**: Offers fine-grained control over validation and error handling.
 
+## Comparison with Similar Libraries
+
+When choosing a schema validation library, bundle size can be an important factor, especially for frontend applications where minimizing JavaScript size is critical. Here's how `@esmj/schema` compares to other popular libraries:
+
+| Library         | Bundle Size (minified + gzipped) |
+|------------------|---------------------------------|
+| `@esmj/schema`   | ~1 KB                           |
+| Superstruct      | ~3.2 KB                         |
+| Yup              | ~12.2 KB                        |
+| Zod@3            | ~13 KB                          |
+| @zod/mini        | ~20,5 KB                        |
+| Joi              | ~40,4 KB                        |
+| Zod@4            | ~40,8 KB                        |
+
+### Performance Comparison
+
+#### Schema Creation Performance
+
+| Library         | 1 Iteration | 1,000 Iterations | 1,000,000 Iterations |
+|-----------------|-------------|------------------|----------------------|
+| `@esmj/schema`  | 0.02 ms     | 4.93 ms          | 399.62 ms            |
+| zod@3           | 0.08 ms     | 9.68 ms          | 8.53 s               |
+| @zod/mini       | 0.22 ms     | 39.77 ms         | 34.51 s              |
+| Yup             | 0.54 ms     | 14.03 ms         | 12.34 s              |
+| Superstruct     | 0.13 ms     | 1.04 ms          | 487.94 ms            |
+| Joi             | 0.62 ms     | 31.60 ms         | 23.06 s              |
+
+#### Parsing Performance
+
+| Library         | 1 Iteration | 1,000 Iterations | 1,000,000 Iterations |
+|-----------------|-------------|------------------|----------------------|
+| `@esmj/schema`  | 0.05 ms     | 0.46 ms          | 267.93 ms            |
+| zod@3           | 0.14 ms     | 1.44 ms          | 897.89 ms            |
+| @zod/mini       | 0.23 ms     | 0.42 ms          | 199.08 ms            |
+| Yup             | 0.30 ms     | 9.49 ms          | 8.69 s               |
+| Superstruct     | 0.08 ms     | 4.18 ms          | 3.71 s               |
+| Joi             | 0.33 ms     | 3.35 ms          | 2.69 s               |
+
+#### Error Handling Performance
+
+| Library         | 1 Iteration | 1,000 Iterations | 1,000,000 Iterations |
+|-----------------|-------------|------------------|----------------------|
+| `@esmj/schema`  | 0.03 ms     | 0.59 ms          | 365.32 ms            |
+| zod3            | 0.05 ms     | 2.09 ms          | 1.26 s               |
+| @zod/mini       | 0.07 ms     | 0.99 ms          | 545.12 ms            |
+| Yup             | 0.27 ms     | 19.28 ms         | 18.87 s              |
+| Superstruct     | 0.04 ms     | 8.62 ms          | 6.24 s               |
+| Joi             | 0.15 ms     | 4.13 ms          | 2.57 s               |
+
 ## Usage
 
 ### Basic Usage
@@ -125,6 +174,26 @@ Creates a schema that accepts any value.
 const anySchema = s.any();
 ```
 
+#### `s.enum(values)`
+
+Creates an enum schema that validates against a predefined set of string values.
+
+- **`values`**: An array of strings representing the allowed values for the enum. Each value must be a string.
+
+```typescript
+const enumSchema = s.enum(['admin', 'user', 'guest']);
+
+const validResult = enumSchema.parse('admin');
+console.log(validResult);
+// 'admin'
+
+const invalidResult = enumSchema.safeParse('invalidRole');
+console.log(invalidResult.success);
+// false
+console.log(invalidResult.error.message);
+// Error: Invalid enum value. Expected "admin" | "user" | "guest", received "invalidRole".
+```
+
 #### `s.preprocess(callback, schema)`
 
 Creates a schema that preprocesses the input value using the provided callback before validating it with the given schema.
@@ -148,9 +217,26 @@ const result = stringSchema.parse('hello');
 Safely parses the given value according to the schema, returning a success or error result.
 
 ```typescript
-const result = stringSchema.safeParse('hello'); // { success: true, data: 'hello' }
+const result = stringSchema.safeParse('hello'); 
+// { success: true, data: 'hello' }
+
+const errorResult = stringSchema.safeParse(123); 
+// { success: false, error: { message: 'The value "123" must be type of string but is type of "number".' } }
+```
+
+**Note:** The `error` returned by `safeParse` is not a native `Error` instance. Instead, it is a plain object with the following structure:
+
+```typescript
+type ErrorStructure = {
+  message: string;
+  cause?: {
+    key?: string;
+  };
+};
 ```
 
+This allows for easier serialization and debugging but may require additional handling if you expect a native `Error` instance.
+
 #### `optional()`
 
 Makes the schema optional.

package/benchmark/benchmark.ts

@@ -0,0 +1,585 @@
+import { performance } from 'node:perf_hooks';
+import { z as zodMini } from '@zod/mini'; // Import Zod Mini
+import Joi from 'joi'; // Import Joi
+import superStruct from 'superstruct'; // Import Superstruct
+import * as yup from 'yup'; // Import Yup
+import { z } from 'zod'; // Import Zod
+import { s } from '../src/index.ts'; // Import @esmj/schema
+
+function formatTime(time: number) {
+  // Convert time to milliseconds
+  if (time < 1000) {
+    return `${time.toFixed(2)} ms`;
+  }
+  // Convert to seconds
+  const seconds = time / 1000;
+  return `${seconds.toFixed(2)} s`;
+}
+
+function benchmark(label: string, fn: () => void) {
+  const REPEAT = 10;
+  let sum = 0;
+  let min = Number.POSITIVE_INFINITY;
+  let max = Number.NEGATIVE_INFINITY;
+  for (let i = 0; i < REPEAT; i++) {
+    const start = performance.now();
+    fn();
+    const end = performance.now();
+
+    const time = end - start;
+
+    min = Math.min(min, time);
+    max = Math.max(max, time);
+    sum += time;
+  }
+
+  const average = sum / REPEAT;
+
+  console.log(
+    `${label} took an average of ${formatTime(average)} over ${REPEAT} iterations. Min: ${formatTime(min)}, Max: ${formatTime(max)}`,
+  );
+
+  return formatTime(average);
+}
+
+function scenarioParseSchema(testData) {
+  // Define a schema using @esmj/schema
+  const esmjSchema = s.object({
+    username: s.string(),
+    password: s.string(),
+    age: s.number().optional(),
+    address: s.object({
+      street: s.string().nullish(),
+      city: s.string().nullable(),
+      date: s.date().optional(), // Optional date field
+    }),
+    tags: s.array(s.string()),
+  });
+
+  // Define a schema using Zod
+  const zodSchema = z.object({
+    username: z.string(),
+    password: z.string(),
+    age: z.number().optional(),
+    address: z.object({
+      street: z.string().nullish(),
+      city: z.string().nullable(),
+      date: z.date().optional(), // Optional date field
+    }),
+    tags: z.array(z.string()),
+  });
+
+  // Define a schema using Zod Mini
+  const zodMiniSchema = zodMini.object({
+    username: zodMini.string(),
+    password: zodMini.string(),
+    age: zodMini.optional(zodMini.number()),
+    address: zodMini.object({
+      street: zodMini.nullish(zodMini.string()),
+      city: zodMini.nullable(zodMini.string()),
+      date: zodMini.optional(zodMini.date()), // Optional date field
+    }),
+    tags: zodMini.array(zodMini.string()),
+  });
+
+  // Define a schema using Yup
+  const yupSchema = yup.object({
+    username: yup.string().required(),
+    password: yup.string().required(),
+    age: yup.number().optional(),
+    address: yup.object({
+      street: yup.string().nullable(),
+      city: yup.string().nullable(),
+      date: yup.date().optional(), // Optional date field
+    }),
+    tags: yup.array().of(yup.string().required()).required(),
+  });
+
+  // Define a schema using Superstruct
+  const superStructSchema = superStruct.object({
+    username: superStruct.string(),
+    password: superStruct.string(),
+    age: superStruct.number(),
+    address: superStruct.object({
+      street: superStruct.optional(superStruct.string()),
+      city: superStruct.optional(superStruct.string()),
+      date: superStruct.optional(superStruct.date()), // Optional date field
+    }),
+    tags: superStruct.array(superStruct.string()),
+  });
+
+  // Define a schema using Joi
+  const joiSchema = Joi.object({
+    username: Joi.string().required(),
+    password: Joi.string().required(),
+    age: Joi.number().required(),
+    address: Joi.object({
+      street: Joi.string().optional(), // Allow null for street
+      city: Joi.string().optional(),
+      date: Joi.date().optional(), // Optional date field
+    }),
+    tags: Joi.array().items(Joi.string().required()).required(),
+  });
+
+  const result = {} as Record<string, object>;
+
+  const esmjSchemaResult = {};
+  esmjSchemaResult['1'] = benchmark('@esmj/schema 1', () => {
+    for (let i = 0; i < 1; i++) {
+      esmjSchema.safeParse(testData);
+    }
+  });
+
+  esmjSchemaResult['1_000'] = benchmark('@esmj/schema 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      esmjSchema.safeParse(testData);
+    }
+  });
+
+  esmjSchemaResult['1_000_000'] = benchmark('@esmj/schema 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      esmjSchema.safeParse(testData);
+    }
+  });
+  result.esmjSchema = esmjSchemaResult;
+
+  const zod = {};
+  zod['1'] = benchmark('zod 1', () => {
+    for (let i = 0; i < 1; i++) {
+      zodSchema.safeParse(testData);
+    }
+  });
+
+  zod['1_000'] = benchmark('zod 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      zodSchema.safeParse(testData);
+    }
+  });
+
+  zod['1_000_000'] = benchmark('zod 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      zodSchema.safeParse(testData);
+    }
+  });
+  result.zod = zod;
+
+  const zodMiniResult = {};
+  zodMiniResult['1'] = benchmark('@zod/mini 1', () => {
+    for (let i = 0; i < 1; i++) {
+      zodMiniSchema.safeParse(testData);
+    }
+  });
+
+  zodMiniResult['1_000'] = benchmark('@zod/mini 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      zodMiniSchema.safeParse(testData);
+    }
+  });
+
+  zodMiniResult['1_000_000'] = benchmark('@zod/mini 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      zodMiniSchema.safeParse(testData);
+    }
+  });
+  result.zodMini = zodMiniResult;
+
+  const yupResult = {};
+  yupResult['1'] = benchmark('yup 1', () => {
+    for (let i = 0; i < 1; i++) {
+      yupSchema.isValidSync(testData);
+    }
+  });
+
+  yupResult['1_000'] = benchmark('yup 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      yupSchema.isValidSync(testData);
+    }
+  });
+
+  yupResult['1_000_000'] = benchmark('yup 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      yupSchema.isValidSync(testData);
+    }
+  });
+  result.yup = yupResult;
+
+  const superStructResult = {};
+  superStructResult['1'] = benchmark('superStruct 1', () => {
+    for (let i = 0; i < 1; i++) {
+      superStruct.is(testData, superStructSchema);
+    }
+  });
+
+  superStructResult['1_000'] = benchmark('superStruct 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      superStruct.is(testData, superStructSchema);
+    }
+  });
+
+  superStructResult['1_000_000'] = benchmark('superStruct 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      superStruct.is(testData, superStructSchema);
+    }
+  });
+  result.superStruct = superStructResult;
+
+  const joiResult = {};
+  joiResult['1'] = benchmark('joi 1', () => {
+    for (let i = 0; i < 1; i++) {
+      try {
+        joiSchema.validate(testData);
+      } catch (e) {}
+    }
+  });
+
+  joiResult['1_000'] = benchmark('joi 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      try {
+        joiSchema.validate(testData);
+      } catch (e) {}
+    }
+  });
+
+  joiResult['1_000_000'] = benchmark('joi 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      try {
+        joiSchema.validate(testData);
+      } catch (e) {}
+    }
+  });
+  result.joi = joiResult;
+
+  return result;
+}
+
+function scenarioCreatingSchema() {
+  const result = {} as Record<string, object>;
+  const esmjSchemaResult = {};
+  esmjSchemaResult['1'] = benchmark('@esmj/schema 1', () => {
+    for (let i = 0; i < 1; i++) {
+      const esmjSchema = s.object({
+        username: s.string(),
+        password: s.string(),
+        age: s.number().optional(),
+        address: s.object({
+          street: s.string().nullish(),
+          city: s.string().nullable(),
+          date: s.date().optional(), // Optional date field
+        }),
+        tags: s.array(s.string()),
+      });
+    }
+  });
+
+  esmjSchemaResult['1_000'] = benchmark('@esmj/schema 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      const esmjSchema = s.object({
+        username: s.string(),
+        password: s.string(),
+        age: s.number().optional(),
+        address: s.object({
+          street: s.string().nullish(),
+          city: s.string().nullable(),
+          date: s.date().optional(), // Optional date field
+        }),
+        tags: s.array(s.string()),
+      });
+    }
+  });
+
+  esmjSchemaResult['1_000_000'] = benchmark('@esmj/schema 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      const esmjSchema = s.object({
+        username: s.string(),
+        password: s.string(),
+        age: s.number().optional(),
+        address: s.object({
+          street: s.string().nullish(),
+          city: s.string().nullable(),
+          date: s.date().optional(), // Optional date field
+        }),
+        tags: s.array(s.string()),
+      });
+    }
+  });
+  result.esmjSchema = esmjSchemaResult;
+
+  const zod = {};
+  zod['1'] = benchmark('zod 1', () => {
+    for (let i = 0; i < 1; i++) {
+      const zodSchema = z.object({
+        username: z.string(),
+        password: z.string(),
+        age: z.number().optional(),
+        address: z.object({
+          street: z.string().nullish(),
+          city: z.string().nullable(),
+          date: z.date().optional(), // Optional date field
+        }),
+        tags: z.array(z.string()),
+      });
+    }
+  });
+
+  zod['1_000'] = benchmark('zod 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      const zodSchema = z.object({
+        username: z.string(),
+        password: z.string(),
+        age: z.number().optional(),
+        address: z.object({
+          street: z.string().nullish(),
+          city: z.string().nullable(),
+          date: z.date().optional(), // Optional date field
+        }),
+        tags: z.array(z.string()),
+      });
+    }
+  });
+
+  zod['1_000_000'] = benchmark('zod 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      const zodSchema = z.object({
+        username: z.string(),
+        password: z.string(),
+        age: z.number().optional(),
+        address: z.object({
+          street: z.string().nullish(),
+          city: z.string().nullable(),
+          date: z.date().optional(), // Optional date field
+        }),
+        tags: z.array(z.string()),
+      });
+    }
+  });
+  result.zod = zod;
+
+  const zodMiniResult = {};
+  zodMiniResult['1'] = benchmark('@zod/mini 1', () => {
+    for (let i = 0; i < 1; i++) {
+      const zodMiniSchema = zodMini.object({
+        username: zodMini.string(),
+        password: zodMini.string(),
+        age: zodMini.optional(zodMini.number()),
+        address: zodMini.object({
+          street: zodMini.nullish(zodMini.string()),
+          city: zodMini.nullable(zodMini.string()),
+          date: zodMini.optional(zodMini.date()), // Optional date field
+        }),
+        tags: zodMini.array(zodMini.string()),
+      });
+    }
+  });
+
+  zodMiniResult['1_000'] = benchmark('@zod/mini 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      const zodMiniSchema = zodMini.object({
+        username: zodMini.string(),
+        password: zodMini.string(),
+        age: zodMini.optional(zodMini.number()),
+        address: zodMini.object({
+          street: zodMini.nullish(zodMini.string()),
+          city: zodMini.nullable(zodMini.string()),
+          date: zodMini.optional(zodMini.date()), // Optional date field
+        }),
+        tags: zodMini.array(zodMini.string()),
+      });
+    }
+  });
+
+  zodMiniResult['1_000_000'] = benchmark('@zod/mini 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      const zodMiniSchema = zodMini.object({
+        username: zodMini.string(),
+        password: zodMini.string(),
+        age: zodMini.optional(zodMini.number()),
+        address: zodMini.object({
+          street: zodMini.nullish(zodMini.string()),
+          city: zodMini.nullable(zodMini.string()),
+          date: zodMini.optional(zodMini.date()), // Optional date field
+        }),
+        tags: zodMini.array(zodMini.string()),
+      });
+    }
+  });
+  result.zodMini = zodMiniResult;
+
+  const yupResult = {};
+  yupResult['1'] = benchmark('yup 1', () => {
+    for (let i = 0; i < 1; i++) {
+      const yupSchema = yup.object({
+        username: yup.string().required(),
+        password: yup.string().required(),
+        age: yup.number().optional(),
+        address: yup.object({
+          street: yup.string().nullable(),
+          city: yup.string().nullable(),
+          date: yup.date().optional(), // Optional date field
+        }),
+        tags: yup.array().of(yup.string().required()).required(),
+      });
+    }
+  });
+
+  yupResult['1_000'] = benchmark('yup 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      const yupSchema = yup.object({
+        username: yup.string().required(),
+        password: yup.string().required(),
+        age: yup.number().optional(),
+        address: yup.object({
+          street: yup.string().nullable(),
+          city: yup.string().nullable(),
+          date: yup.date().optional(), // Optional date field
+        }),
+        tags: yup.array().of(yup.string().required()).required(),
+      });
+    }
+  });
+
+  yupResult['1_000_000'] = benchmark('yup 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      const yupSchema = yup.object({
+        username: yup.string().required(),
+        password: yup.string().required(),
+        age: yup.number().optional(),
+        address: yup.object({
+          street: yup.string().nullable(),
+          city: yup.string().nullable(),
+          date: yup.date().optional(), // Optional date field
+        }),
+        tags: yup.array().of(yup.string().required()).required(),
+      });
+    }
+  });
+  result.yup = yupResult;
+
+  const superStructResult = {};
+  superStructResult['1'] = benchmark('superStruct 1', () => {
+    for (let i = 0; i < 1; i++) {
+      const superStructSchema = superStruct.object({
+        username: superStruct.string(),
+        password: superStruct.string(),
+        age: superStruct.number(),
+        address: superStruct.object({
+          street: superStruct.optional(superStruct.string()),
+          city: superStruct.optional(superStruct.string()),
+          date: superStruct.optional(superStruct.date()), // Optional date field
+        }),
+        tags: superStruct.array(superStruct.string()),
+      });
+    }
+  });
+
+  superStructResult['1_000'] = benchmark('superStruct 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      const superStructSchema = superStruct.object({
+        username: superStruct.string(),
+        password: superStruct.string(),
+        age: superStruct.number(),
+        address: superStruct.object({
+          street: superStruct.optional(superStruct.string()),
+          city: superStruct.optional(superStruct.string()),
+          date: superStruct.optional(superStruct.date()), // Optional date field
+        }),
+        tags: superStruct.array(superStruct.string()),
+      });
+    }
+  });
+
+  superStructResult['1_000_000'] = benchmark('superStruct 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      const superStructSchema = superStruct.object({
+        username: superStruct.string(),
+        password: superStruct.string(),
+        age: superStruct.number(),
+        address: superStruct.object({
+          street: superStruct.optional(superStruct.string()),
+          city: superStruct.optional(superStruct.string()),
+          date: superStruct.optional(superStruct.date()), // Optional date field
+        }),
+        tags: superStruct.array(superStruct.string()),
+      });
+    }
+  });
+  result.superStruct = superStructResult;
+
+  const joiResult = {};
+  joiResult['1'] = benchmark('joi 1', () => {
+    for (let i = 0; i < 1; i++) {
+      const joiSchema = Joi.object({
+        username: Joi.string().required(),
+        password: Joi.string().required(),
+        age: Joi.number().required(),
+        address: Joi.object({
+          street: Joi.string().optional(), // Allow null for street
+          city: Joi.string().optional(),
+          date: Joi.date().optional(), // Optional date field
+        }),
+        tags: Joi.array().items(Joi.string().required()).required(),
+      });
+    }
+  });
+
+  joiResult['1_000'] = benchmark('joi 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      const joiSchema = Joi.object({
+        username: Joi.string().required(),
+        password: Joi.string().required(),
+        age: Joi.number().required(),
+        address: Joi.object({
+          street: Joi.string().optional(), // Allow null for street
+          city: Joi.string().optional(),
+          date: Joi.date().optional(), // Optional date field
+        }),
+        tags: Joi.array().items(Joi.string().required()).required(),
+      });
+    }
+  });
+
+  joiResult['1_000_000'] = benchmark('joi 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      const joiSchema = Joi.object({
+        username: Joi.string().required(),
+        password: Joi.string().required(),
+        age: Joi.number().required(),
+        address: Joi.object({
+          street: Joi.string().optional(), // Allow null for street
+          city: Joi.string().optional(),
+          date: Joi.date().optional(), // Optional date field
+        }),
+        tags: Joi.array().items(Joi.string().required()).required(),
+      });
+    }
+  });
+  result.joi = joiResult;
+
+  return result;
+}
+
+const testDataGood = {
+  username: 'john_doe',
+  password: 'securepassword',
+  age: 30,
+  address: {
+    street: '123 Main St',
+    city: 'New York',
+    date: new Date(),
+  },
+  tags: ['developer', 'typescript'],
+};
+
+const testDataBad = {
+  username: 'john_doe',
+  password: 'securepassword',
+  age: 30,
+  address: {
+    street: '123 Main St',
+    city: 'New York',
+    date: new Date(),
+  },
+};
+
+console.table(scenarioCreatingSchema());
+console.table(scenarioParseSchema(testDataGood));
+console.table(scenarioParseSchema(testDataBad));

package/dist/index.d.mts

@@ -1,12 +1,22 @@
+type ErrorStructure = {
+    message: string;
+    cause?: {
+        key?: string;
+    };
+};
+type Valid<Output> = {
+    success: true;
+    data: Output;
+};
+type Invalid = {
+    success: false;
+    error: ErrorStructure;
+};
+type InternalParseOutput<Output> = Valid<Output> | Invalid;
 interface SchemaInterface<Input, Output> {
+    _parse(value: Input | Partial<Input> | unknown): InternalParseOutput<Output>;
     parse(value: Input | Partial<Input> | unknown): Output;
-    safeParse(value: Input | Partial<Input> | unknown): {
-        success: true;
-        data: Output;
-    } | {
-        success: false;
-        error: Error;
-    };
+    safeParse(value: Input | Partial<Input> | unknown): InternalParseOutput<Output>;
     optional(): SchemaInterface<Input, Partial<Output> | undefined>;
     transform<NewOutput>(callback: (value: Input) => NewOutput): SchemaInterface<Input, NewOutput>;
     nullable(): SchemaInterface<Input, Output | null>;
@@ -17,6 +27,8 @@ interface SchemaInterface<Input, Output> {
         message: string;
     }): SchemaInterface<Input, Output>;
 }
+interface EnumSchemaInterface<T extends string> extends SchemaInterface<string, T> {
+}
 interface StringSchemaInterface extends SchemaInterface<string, string> {
 }
 interface NumberSchemaInterface extends SchemaInterface<number, number> {
@@ -33,7 +45,7 @@ interface ObjectSchemaInterface<T extends Record<string, SchemaType>> extends Sc
     [Property in keyof T]: ReturnType<T[Property]['parse']>;
 }> {
 }
-type SchemaType = StringSchemaInterface | SchemaInterface<string, string> | SchemaInterface<string, string | undefined> | SchemaInterface<string, string | null> | SchemaInterface<string, string | undefined | null> | ObjectSchemaInterface<Record<string, SchemaType>> | SchemaInterface<object, object> | SchemaInterface<object, object | undefined> | SchemaInterface<object, object | null> | SchemaInterface<object, object | undefined | null> | NumberSchemaInterface | SchemaInterface<number, number> | SchemaInterface<number, number | undefined> | SchemaInterface<number, number | null> | SchemaInterface<number, number | undefined | null> | BooleanSchemaInterface | SchemaInterface<boolean, boolean> | SchemaInterface<boolean, boolean | undefined> | SchemaInterface<boolean, boolean | null> | SchemaInterface<boolean, boolean | undefined | null> | DateSchemaInterface | SchemaInterface<Date, Date> | SchemaInterface<Date, Date | undefined> | SchemaInterface<Date, Date | null> | SchemaInterface<Date, Date | undefined | null> | ArraySchemaInterface<StringSchemaInterface | ObjectSchemaInterface<Record<string, SchemaType>> | NumberSchemaInterface | BooleanSchemaInterface> | SchemaInterface<Array<unknown>, Array<unknown>> | SchemaInterface<Array<unknown>, Array<unknown> | undefined> | SchemaInterface<Array<unknown>, Array<unknown> | null> | SchemaInterface<Array<unknown>, Array<unknown> | undefined | null>;
+type SchemaType = StringSchemaInterface | SchemaInterface<string, string> | SchemaInterface<string, string | undefined> | SchemaInterface<string, string | null> | SchemaInterface<string, string | undefined | null> | ObjectSchemaInterface<Record<string, SchemaType>> | SchemaInterface<object, object> | SchemaInterface<object, object | undefined> | SchemaInterface<object, object | null> | SchemaInterface<object, object | undefined | null> | NumberSchemaInterface | SchemaInterface<number, number> | SchemaInterface<number, number | undefined> | SchemaInterface<number, number | null> | SchemaInterface<number, number | undefined | null> | BooleanSchemaInterface | SchemaInterface<boolean, boolean> | SchemaInterface<boolean, boolean | undefined> | SchemaInterface<boolean, boolean | null> | SchemaInterface<boolean, boolean | undefined | null> | DateSchemaInterface | SchemaInterface<Date, Date> | SchemaInterface<Date, Date | undefined> | SchemaInterface<Date, Date | null> | SchemaInterface<Date, Date | undefined | null> | EnumSchemaInterface<string> | ArraySchemaInterface<StringSchemaInterface | ObjectSchemaInterface<Record<string, SchemaType>> | NumberSchemaInterface | BooleanSchemaInterface | DateSchemaInterface | EnumSchemaInterface<string>> | SchemaInterface<Array<unknown>, Array<unknown>> | SchemaInterface<Array<unknown>, Array<unknown> | undefined> | SchemaInterface<Array<unknown>, Array<unknown> | null> | SchemaInterface<Array<unknown>, Array<unknown> | undefined | null>;
 type ExtenderType = (inter: SchemaType, validation: Function, options: {
     message: string;
     type: string;
@@ -44,6 +56,7 @@ declare const s: {
     number(): NumberSchemaInterface;
     boolean(): BooleanSchemaInterface;
     date(): DateSchemaInterface;
+    enum(definition: Readonly<Array<string>>): EnumSchemaInterface<(typeof definition)[number]>;
     array<T extends SchemaType>(definition: T): ArraySchemaInterface<T>;
     any(): any;
     preprocess<T extends SchemaType>(callback: Function, schema: T): T;
@@ -51,4 +64,4 @@ declare const s: {
 declare function extend(callback: ExtenderType): void;
 type Infer<T> = T extends SchemaType ? ReturnType<T['parse']> : unknown;
 
-export { type ArraySchemaInterface, type BooleanSchemaInterface, type DateSchemaInterface, type ExtenderType, type Infer, type NumberSchemaInterface, type ObjectSchemaInterface, type SchemaInterface, type SchemaType, type StringSchemaInterface, extend, s };
+export { type ArraySchemaInterface, type BooleanSchemaInterface, type DateSchemaInterface, type EnumSchemaInterface, type ExtenderType, type Infer, type NumberSchemaInterface, type ObjectSchemaInterface, type SchemaInterface, type SchemaType, type StringSchemaInterface, extend, s };

package/dist/index.d.ts

@@ -1,12 +1,22 @@
+type ErrorStructure = {
+    message: string;
+    cause?: {
+        key?: string;
+    };
+};
+type Valid<Output> = {
+    success: true;
+    data: Output;
+};
+type Invalid = {
+    success: false;
+    error: ErrorStructure;
+};
+type InternalParseOutput<Output> = Valid<Output> | Invalid;
 interface SchemaInterface<Input, Output> {
+    _parse(value: Input | Partial<Input> | unknown): InternalParseOutput<Output>;
     parse(value: Input | Partial<Input> | unknown): Output;
-    safeParse(value: Input | Partial<Input> | unknown): {
-        success: true;
-        data: Output;
-    } | {
-        success: false;
-        error: Error;
-    };
+    safeParse(value: Input | Partial<Input> | unknown): InternalParseOutput<Output>;
     optional(): SchemaInterface<Input, Partial<Output> | undefined>;
     transform<NewOutput>(callback: (value: Input) => NewOutput): SchemaInterface<Input, NewOutput>;
     nullable(): SchemaInterface<Input, Output | null>;
@@ -17,6 +27,8 @@ interface SchemaInterface<Input, Output> {
         message: string;
     }): SchemaInterface<Input, Output>;
 }
+interface EnumSchemaInterface<T extends string> extends SchemaInterface<string, T> {
+}
 interface StringSchemaInterface extends SchemaInterface<string, string> {
 }
 interface NumberSchemaInterface extends SchemaInterface<number, number> {
@@ -33,7 +45,7 @@ interface ObjectSchemaInterface<T extends Record<string, SchemaType>> extends Sc
     [Property in keyof T]: ReturnType<T[Property]['parse']>;
 }> {
 }
-type SchemaType = StringSchemaInterface | SchemaInterface<string, string> | SchemaInterface<string, string | undefined> | SchemaInterface<string, string | null> | SchemaInterface<string, string | undefined | null> | ObjectSchemaInterface<Record<string, SchemaType>> | SchemaInterface<object, object> | SchemaInterface<object, object | undefined> | SchemaInterface<object, object | null> | SchemaInterface<object, object | undefined | null> | NumberSchemaInterface | SchemaInterface<number, number> | SchemaInterface<number, number | undefined> | SchemaInterface<number, number | null> | SchemaInterface<number, number | undefined | null> | BooleanSchemaInterface | SchemaInterface<boolean, boolean> | SchemaInterface<boolean, boolean | undefined> | SchemaInterface<boolean, boolean | null> | SchemaInterface<boolean, boolean | undefined | null> | DateSchemaInterface | SchemaInterface<Date, Date> | SchemaInterface<Date, Date | undefined> | SchemaInterface<Date, Date | null> | SchemaInterface<Date, Date | undefined | null> | ArraySchemaInterface<StringSchemaInterface | ObjectSchemaInterface<Record<string, SchemaType>> | NumberSchemaInterface | BooleanSchemaInterface> | SchemaInterface<Array<unknown>, Array<unknown>> | SchemaInterface<Array<unknown>, Array<unknown> | undefined> | SchemaInterface<Array<unknown>, Array<unknown> | null> | SchemaInterface<Array<unknown>, Array<unknown> | undefined | null>;
+type SchemaType = StringSchemaInterface | SchemaInterface<string, string> | SchemaInterface<string, string | undefined> | SchemaInterface<string, string | null> | SchemaInterface<string, string | undefined | null> | ObjectSchemaInterface<Record<string, SchemaType>> | SchemaInterface<object, object> | SchemaInterface<object, object | undefined> | SchemaInterface<object, object | null> | SchemaInterface<object, object | undefined | null> | NumberSchemaInterface | SchemaInterface<number, number> | SchemaInterface<number, number | undefined> | SchemaInterface<number, number | null> | SchemaInterface<number, number | undefined | null> | BooleanSchemaInterface | SchemaInterface<boolean, boolean> | SchemaInterface<boolean, boolean | undefined> | SchemaInterface<boolean, boolean | null> | SchemaInterface<boolean, boolean | undefined | null> | DateSchemaInterface | SchemaInterface<Date, Date> | SchemaInterface<Date, Date | undefined> | SchemaInterface<Date, Date | null> | SchemaInterface<Date, Date | undefined | null> | EnumSchemaInterface<string> | ArraySchemaInterface<StringSchemaInterface | ObjectSchemaInterface<Record<string, SchemaType>> | NumberSchemaInterface | BooleanSchemaInterface | DateSchemaInterface | EnumSchemaInterface<string>> | SchemaInterface<Array<unknown>, Array<unknown>> | SchemaInterface<Array<unknown>, Array<unknown> | undefined> | SchemaInterface<Array<unknown>, Array<unknown> | null> | SchemaInterface<Array<unknown>, Array<unknown> | undefined | null>;
 type ExtenderType = (inter: SchemaType, validation: Function, options: {
     message: string;
     type: string;
@@ -44,6 +56,7 @@ declare const s: {
     number(): NumberSchemaInterface;
     boolean(): BooleanSchemaInterface;
     date(): DateSchemaInterface;
+    enum(definition: Readonly<Array<string>>): EnumSchemaInterface<(typeof definition)[number]>;
     array<T extends SchemaType>(definition: T): ArraySchemaInterface<T>;
     any(): any;
     preprocess<T extends SchemaType>(callback: Function, schema: T): T;
@@ -51,4 +64,4 @@ declare const s: {
 declare function extend(callback: ExtenderType): void;
 type Infer<T> = T extends SchemaType ? ReturnType<T['parse']> : unknown;
 
-export { type ArraySchemaInterface, type BooleanSchemaInterface, type DateSchemaInterface, type ExtenderType, type Infer, type NumberSchemaInterface, type ObjectSchemaInterface, type SchemaInterface, type SchemaType, type StringSchemaInterface, extend, s };
+export { type ArraySchemaInterface, type BooleanSchemaInterface, type DateSchemaInterface, type EnumSchemaInterface, type ExtenderType, type Infer, type NumberSchemaInterface, type ObjectSchemaInterface, type SchemaInterface, type SchemaType, type StringSchemaInterface, extend, s };

package/dist/index.js

@@ -1 +1 @@
-'use strict';var y={object(n){let u=i(c=>typeof c=="object"&&c!==null&&!Array.isArray(c),{type:"object"});return s(u,"parse",(c,...o)=>{let e=c(...o);return n&&typeof e=="object"?Object.keys(n).reduce((t,r)=>{if(typeof n[r]?.parse=="function")try{t[r]=n[r].parse(e[r]);}catch(p){throw r=p.cause?.key?`${r}.${p.cause.key}`:r,new Error(`Error parsing key "${r}": ${p.message}`,{cause:{key:r}})}return t},{}):e}),u},string(){return i(a=>typeof a=="string",{type:"string"})},number(){return i(a=>typeof a=="number",{type:"number"})},boolean(){return i(a=>a===true||a===false,{type:"boolean"})},date(){return i(a=>a instanceof Date&&!Number.isNaN(a.getTime()),{type:"date"})},array(n){let u=i(c=>Array.isArray(c),{type:"array"});return s(u,"parse",(c,o)=>(o=c(o),n&&Array.isArray(o)?o.map((e,t)=>{try{return n.parse(e)}catch(r){let p=r.cause?.key?`${t}.${r.cause.key}`:t;throw new Error(`Error parsing index "${t}": ${r.message}`,{cause:{key:p}})}}):o)),u},any(){return i(()=>true)},preprocess(n,a){return s(a,"parse",(u,c)=>(c=n(c),u(c))),a}};function h(n){return a=>`The value "${a}" must be type of ${n} but is type of "${typeof a}".`}function s(n,a,u){let c=n[a];n[a]=(...o)=>u(c,...o);}function i(n,{type:a="any"}={}){let u=h(a),c={message:u,type:a},o={parse(e){if(!n(e))throw new Error(u(e));return e},safeParse(e){try{return {success:!0,data:this.parse(e)}}catch(t){return {success:false,error:t}}},transform(e){return s(this,"parse",(t,r)=>e(t(r))),this},optional(){return s(this,"parse",(e,t)=>{try{return e(t)}catch{return}}),this},nullable(){return s(this,"parse",(e,t)=>{try{return e(t)}catch{return null}}),this},nullish(){return s(this,"parse",(e,t)=>{try{return e(t)}catch{return t==null?t:null}}),this},default(e){return s(this,"parse",(t,r)=>(r===void 0&&(r=e,r=typeof e=="function"?e():e),r=t(r),r)),this},pipe(e){return s(this,"parse",(t,r)=>e.parse(t(r))),this},refine(e,{message:t}){return s(this,"parse",(r,p)=>{let f=r(p);if(!e(f))throw new Error(t);return f}),this}};return m.reduce((e,t)=>t(e,n,c)??e,o)}var m=[];function I(n){m.push(n);}exports.extend=I;exports.s=y;
+'use strict';var h=r=>typeof r=="string"||r instanceof String,I=r=>typeof r=="number"||r instanceof Number,l=r=>r===true||r===false,y=r=>r instanceof Date&&!Number.isNaN(r.getTime()),d=r=>Array.isArray(r),S=r=>typeof r=="object"&&r!==null&&!Array.isArray(r),g={object(r){let a=p(S,{type:"object"});return i(a,"_parse",(u,...o)=>{let c=u(...o);if(c.success===false)return c;let n={};for(let t in r){let e=r[t]._parse(c.data[t]);if(e.success)n[t]=e.data;else {e=e;let s=e?.error?.cause?.key?`${t}.${e?.error?.cause?.key}`:t;return e.error.message=`Error parsing key "${s}": ${e.error.message}`,e.error.cause={key:s},e}}return {success:true,data:n}}),a},string(){return p(h,{type:"string"})},number(){return p(I,{type:"number"})},boolean(){return p(l,{type:"boolean"})},date(){return p(y,{type:"date"})},enum(r){let a=n=>r.includes(n),u=n=>`Invalid ${o} value. Expected ${r.map(t=>`"${t}"`).join(" | ")}, received "${n}".`,o="enum";return p(a,{type:o,message:u})},array(r){let a=p(d,{type:"array"});return i(a,"_parse",(u,...o)=>{let c=u(...o);if(c.success===false)return c;let n=[];for(let t=0;t<c.data.length;t++){let e=r._parse(c.data[t]);if(e.success)n.push(e.data);else {e=e;let s=e.error?.cause?.key?`${t}.${e.error.cause.key}`:`${t}`;return e.error.message=`Error parsing index "${t}": ${e.error.message}`,e.error.cause={key:s},e}}return {success:true,data:n}}),a},any(){return p(()=>true)},preprocess(r,a){return i(a,"_parse",(u,o)=>(o=r(o),u(o))),a}};function b(r){return a=>`The value "${a}" must be type of ${r} but is type of "${typeof a}".`}function i(r,a,u){let o=r[a];r[a]=(...c)=>u(o,...c);}function p(r,{type:a="any",message:u}={}){u=u||b(a);let o={message:u,type:a},c={_parse(n){return r(n)?{success:true,data:n}:{success:false,error:{message:u(n)}}},parse(n){let t=c._parse(n);if(!t.success)throw t=t,new Error(t.error.message,{cause:t.error.cause});return t.data},safeParse(n){return c._parse(n)},transform(n){return i(this,"_parse",(t,e)=>{let s=t(e);return s.success&&(s.data=n(s.data)),s}),this},optional(){return i(this,"_parse",(n,t)=>{let e=n(t);return e.success||(e.data=void 0,e.success=true),e}),this},nullable(){return i(this,"_parse",(n,t)=>{let e=n(t);return e.success||(e.data=null,e.success=true),e}),this},nullish(){return i(this,"_parse",(n,t)=>{let e=n(t);return !e.success&&t==null&&(e.success=true,e.data=t),e}),this},default(n){return i(this,"_parse",(t,e)=>(e===void 0&&(e=n,e=typeof n=="function"?n():n),t(e))),this},pipe(n){return i(this,"_parse",(t,e)=>{let s=t(e);return s.success?n._parse(s.data):s}),this},refine(n,{message:t}){return i(this,"_parse",(e,s)=>{let m=e(s);return n(m.data)?m:{success:false,error:{message:t}}}),this}};return f.length>0?f.reduce((n,t)=>t(n,r,o)??n,c):c}var f=[];function T(r){f.push(r);}exports.extend=T;exports.s=g;

package/dist/index.mjs

@@ -1 +1 @@
-var y={object(n){let u=i(c=>typeof c=="object"&&c!==null&&!Array.isArray(c),{type:"object"});return s(u,"parse",(c,...o)=>{let e=c(...o);return n&&typeof e=="object"?Object.keys(n).reduce((t,r)=>{if(typeof n[r]?.parse=="function")try{t[r]=n[r].parse(e[r]);}catch(p){throw r=p.cause?.key?`${r}.${p.cause.key}`:r,new Error(`Error parsing key "${r}": ${p.message}`,{cause:{key:r}})}return t},{}):e}),u},string(){return i(a=>typeof a=="string",{type:"string"})},number(){return i(a=>typeof a=="number",{type:"number"})},boolean(){return i(a=>a===true||a===false,{type:"boolean"})},date(){return i(a=>a instanceof Date&&!Number.isNaN(a.getTime()),{type:"date"})},array(n){let u=i(c=>Array.isArray(c),{type:"array"});return s(u,"parse",(c,o)=>(o=c(o),n&&Array.isArray(o)?o.map((e,t)=>{try{return n.parse(e)}catch(r){let p=r.cause?.key?`${t}.${r.cause.key}`:t;throw new Error(`Error parsing index "${t}": ${r.message}`,{cause:{key:p}})}}):o)),u},any(){return i(()=>true)},preprocess(n,a){return s(a,"parse",(u,c)=>(c=n(c),u(c))),a}};function h(n){return a=>`The value "${a}" must be type of ${n} but is type of "${typeof a}".`}function s(n,a,u){let c=n[a];n[a]=(...o)=>u(c,...o);}function i(n,{type:a="any"}={}){let u=h(a),c={message:u,type:a},o={parse(e){if(!n(e))throw new Error(u(e));return e},safeParse(e){try{return {success:!0,data:this.parse(e)}}catch(t){return {success:false,error:t}}},transform(e){return s(this,"parse",(t,r)=>e(t(r))),this},optional(){return s(this,"parse",(e,t)=>{try{return e(t)}catch{return}}),this},nullable(){return s(this,"parse",(e,t)=>{try{return e(t)}catch{return null}}),this},nullish(){return s(this,"parse",(e,t)=>{try{return e(t)}catch{return t==null?t:null}}),this},default(e){return s(this,"parse",(t,r)=>(r===void 0&&(r=e,r=typeof e=="function"?e():e),r=t(r),r)),this},pipe(e){return s(this,"parse",(t,r)=>e.parse(t(r))),this},refine(e,{message:t}){return s(this,"parse",(r,p)=>{let f=r(p);if(!e(f))throw new Error(t);return f}),this}};return m.reduce((e,t)=>t(e,n,c)??e,o)}var m=[];function I(n){m.push(n);}export{I as extend,y as s};
+var h=r=>typeof r=="string"||r instanceof String,I=r=>typeof r=="number"||r instanceof Number,l=r=>r===true||r===false,y=r=>r instanceof Date&&!Number.isNaN(r.getTime()),d=r=>Array.isArray(r),S=r=>typeof r=="object"&&r!==null&&!Array.isArray(r),g={object(r){let a=p(S,{type:"object"});return i(a,"_parse",(u,...o)=>{let c=u(...o);if(c.success===false)return c;let n={};for(let t in r){let e=r[t]._parse(c.data[t]);if(e.success)n[t]=e.data;else {e=e;let s=e?.error?.cause?.key?`${t}.${e?.error?.cause?.key}`:t;return e.error.message=`Error parsing key "${s}": ${e.error.message}`,e.error.cause={key:s},e}}return {success:true,data:n}}),a},string(){return p(h,{type:"string"})},number(){return p(I,{type:"number"})},boolean(){return p(l,{type:"boolean"})},date(){return p(y,{type:"date"})},enum(r){let a=n=>r.includes(n),u=n=>`Invalid ${o} value. Expected ${r.map(t=>`"${t}"`).join(" | ")}, received "${n}".`,o="enum";return p(a,{type:o,message:u})},array(r){let a=p(d,{type:"array"});return i(a,"_parse",(u,...o)=>{let c=u(...o);if(c.success===false)return c;let n=[];for(let t=0;t<c.data.length;t++){let e=r._parse(c.data[t]);if(e.success)n.push(e.data);else {e=e;let s=e.error?.cause?.key?`${t}.${e.error.cause.key}`:`${t}`;return e.error.message=`Error parsing index "${t}": ${e.error.message}`,e.error.cause={key:s},e}}return {success:true,data:n}}),a},any(){return p(()=>true)},preprocess(r,a){return i(a,"_parse",(u,o)=>(o=r(o),u(o))),a}};function b(r){return a=>`The value "${a}" must be type of ${r} but is type of "${typeof a}".`}function i(r,a,u){let o=r[a];r[a]=(...c)=>u(o,...c);}function p(r,{type:a="any",message:u}={}){u=u||b(a);let o={message:u,type:a},c={_parse(n){return r(n)?{success:true,data:n}:{success:false,error:{message:u(n)}}},parse(n){let t=c._parse(n);if(!t.success)throw t=t,new Error(t.error.message,{cause:t.error.cause});return t.data},safeParse(n){return c._parse(n)},transform(n){return i(this,"_parse",(t,e)=>{let s=t(e);return s.success&&(s.data=n(s.data)),s}),this},optional(){return i(this,"_parse",(n,t)=>{let e=n(t);return e.success||(e.data=void 0,e.success=true),e}),this},nullable(){return i(this,"_parse",(n,t)=>{let e=n(t);return e.success||(e.data=null,e.success=true),e}),this},nullish(){return i(this,"_parse",(n,t)=>{let e=n(t);return !e.success&&t==null&&(e.success=true,e.data=t),e}),this},default(n){return i(this,"_parse",(t,e)=>(e===void 0&&(e=n,e=typeof n=="function"?n():n),t(e))),this},pipe(n){return i(this,"_parse",(t,e)=>{let s=t(e);return s.success?n._parse(s.data):s}),this},refine(n,{message:t}){return i(this,"_parse",(e,s)=>{let m=e(s);return n(m.data)?m:{success:false,error:{message:t}}}),this}};return f.length>0?f.reduce((n,t)=>t(n,r,o)??n,c):c}var f=[];function T(r){f.push(r);}export{T as extend,g as s};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esmj/schema",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Tiny extendable package for schema validation.",
   "keywords": [
     "schema",
@@ -22,6 +22,7 @@
   "scripts": {
     "lint": "biome check --no-errors-on-unmatched",
     "lint:fix": "npm run lint -- --fix --unsafe",
+    "benchmark": "node benchmark/index.ts",
     "dev": "node_modules/.bin/tsup --dts --watch --onSuccess 'node ./dist/index.mjs'",
     "test": "node --test --experimental-strip-types",
     "test:watch": "npm run test -- --watch",
@@ -62,17 +63,22 @@
   "homepage": "https://github.com/mjancarik/esmj-schema#readme",
   "devDependencies": {
     "@biomejs/biome": "1.9.4",
-    "@commitlint/cli": "^19.7.1",
-    "@commitlint/config-conventional": "^19.7.1",
-    "@typescript-eslint/eslint-plugin": "^8.24.0",
-    "@typescript-eslint/parser": "^8.24.0",
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@typescript-eslint/eslint-plugin": "^8.33.0",
+    "@typescript-eslint/parser": "^8.33.0",
+    "@zod/mini": "^4.0.0-beta.0",
     "commitizen": "^4.3.1",
     "conventional-changelog-cli": "^5.0.0",
     "cz-conventional-changelog": "^3.3.0",
     "git-cz": "^4.9.0",
     "husky": "^9.1.7",
-    "lint-staged": "^15.4.3",
-    "prettier": "^3.5.0",
-    "tsup": "^8.3.6"
+    "joi": "^17.13.3",
+    "lint-staged": "^16.1.0",
+    "prettier": "^3.5.3",
+    "superstruct": "^2.0.2",
+    "tsup": "^8.5.0",
+    "yup": "^1.6.1",
+    "zod": "^3.25.42"
   }
 }

package/biome.json

@@ -1,50 +0,0 @@
-{
-  "files": {
-    "include": ["src/**/*.mjs", "src/**/*.ts", "utils/**/*.mjs"],
-    "ignore": [".history/**/*"]
-  },
-  "formatter": {
-    "enabled": true,
-    "formatWithErrors": true,
-    "indentStyle": "space",
-    "indentWidth": 2,
-    "lineEnding": "lf",
-    "lineWidth": 80,
-    "attributePosition": "auto"
-  },
-  "organizeImports": { "enabled": true },
-  "linter": {
-    "enabled": true,
-    "rules": {
-      "recommended": true,
-      "complexity": {
-        "noForEach": "off",
-        "noBannedTypes": "off"
-      },
-      "style": {
-        "noParameterAssign": "off"
-      }
-    }
-  },
-  "javascript": {
-    "formatter": {
-      "jsxQuoteStyle": "double",
-      "quoteProperties": "asNeeded",
-      "trailingCommas": "all",
-      "semicolons": "always",
-      "arrowParentheses": "always",
-      "bracketSpacing": true,
-      "bracketSameLine": false,
-      "quoteStyle": "single",
-      "attributePosition": "auto"
-    }
-  },
-  "overrides": [
-    {
-      "include": ["*.json"],
-      "formatter": {
-        "indentWidth": 2
-      }
-    }
-  ]
-}