feat: re-implement schemas as codecs

BREAKING CHANGE: this requires zod 4.1.0 or higher.

Author: DASPRiD

.github/workflows/pull-request.yml

@@ -33,6 +33,3 @@ jobs:
 
       - name: Type Check
         run: pnpm tsc --noEmit
-
-      - name: Validate commit messages
-        run: pnpm commitlint --from ${{ github.event.pull_request.base.sha }} --to ${{ github.event.pull_request.head.sha }} --verbose

LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2025, Ben Scholzen 'DASPRiD'
+Copyright (c) 2025-present, Ben Scholzen 'DASPRiD'
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

README.md

@@ -20,17 +20,17 @@ yarn add zod-temporal
 
 ## Quick Start
 
-Import the schema types from this package. You can either import individual types or import all types via convenience
+Import the schema types from this package. You can either import individual types or import all types via a convenience
 method:
 
-```typescript
-import {zt} from 'zod-temporal';
+```ts
+import { zt } from 'zod-temporal';
 ```
 
 For `zod/v4/mini`, import from the mini sub-path:
 
-```typescript
-import {zt} from 'zod-temporal/mini';
+```ts
+import { zt } from 'zod-temporal/mini';
 ```
 
 This library supplies the following types:
@@ -44,3 +44,13 @@ This library supplies the following types:
 
 In contrast to zod-joda, `zt.zonedDateTime()` represents date times with timezone information, while
 `zt.offsetDateTime()` also parses to a `Temporal.ZonedDateTime` but cast to UTC.
+
+## Encoding
+
+The temporal schemas are implemented as [codecs](https://zod.dev/codecs). This allows you to not only parse temporal
+values from their ISO string representation but also to encode them back:
+
+```ts
+const schema = zt.plainTime();
+const value = schema.encode(Temporal.PlainTime.from('12:34:56.789'));
+```

biome.json

@@ -2,14 +2,7 @@
     "$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
     "assist": { "actions": { "source": { "organizeImports": "on" } } },
     "files": {
-        "includes": [
-            "**/biome.json",
-            "**/commitlint.config.cjs",
-            "**/vite.config.ts",
-            "**/src/**/*",
-            "**/demo/**/*",
-            "**/test/**/*"
-        ]
+        "includes": ["biome.json", "commitlint.config.cjs", "src/**/*", "test/**/*"]
     },
     "linter": {
         "enabled": true,
@@ -47,10 +40,7 @@
             "suspicious": {
                 "noApproximativeNumericConstant": "warn",
                 "noEmptyBlockStatements": "error",
-                "noConsole": {
-                    "level": "error",
-                    "options": { "allow": ["assert", "error", "info", "warn", "debug"] }
-                }
+                "noConsole": "error"
             }
         }
     },

package.json

@@ -35,13 +35,13 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
-    "test": "c8 tsx --test --experimental-test-module-mocks --no-warnings=ExperimentalWarning",
-    "test:ci": "c8 --reporter=lcov tsx --test --experimental-test-module-mocks --no-warnings=ExperimentalWarning",
+    "test": "c8 tsx --import temporal-polyfill/global --test",
+    "test:ci": "c8 --reporter=lcov pnpm test",
     "format": "biome format . --write",
     "check": "biome check . --write"
   },
   "peerDependencies": {
-    "zod": "^3.25.56 || ^4.0.0"
+    "zod": "^4.1.0"
   },
   "peerDependenciesMeta": {
     "@zod/mini": {
@@ -52,18 +52,18 @@
     }
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.1.3",
+    "@biomejs/biome": "^2.2.2",
     "@commitlint/cli": "^19.8.1",
     "@commitlint/config-conventional": "^19.8.1",
     "@tsconfig/node22": "^22.0.2",
-    "@types/node": "^24.1.0",
+    "@types/node": "^24.3.0",
     "c8": "^10.1.3",
-    "lefthook": "^1.12.2",
+    "lefthook": "^1.12.3",
     "temporal-polyfill": "^0.3.0",
     "temporal-spec": "^0.3.0",
-    "tsx": "^4.20.3",
-    "typescript": "^5.8.3",
-    "zod": "^4.0.14"
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2",
+    "zod": "^4.1.5"
   },
   "packageManager": "pnpm@10.12.1+sha512.f0dda8580f0ee9481c5c79a1d927b9164f2c478e90992ad268bbb2465a736984391d6333d2c327913578b2804af33474ca554ba29c04a8b13060a717675ae3ac"
 }