@elliots/typical 0.3.0 → 0.3.1

package/README.md

@@ -1,6 +1,6 @@
 # Typical
 
-Typical makes TypeScript type-safe at runtime _with no changes to your code_.
+Typical makes TypeScript type safe at runtime _with no changes to your code_.
 
 It transforms your code to inject runtime validation based on your existing type annotations. With source maps, so errors point to the right lines in your original code.
 
@@ -38,13 +38,14 @@ const user = JSON.parse('{"name":"Alice","email":"not-an-email"}') as User;
 
 Choose the integration that fits your workflow:
 
-| Method                                                    | Best For                        | Package                       |
-| --------------------------------------------------------- | ------------------------------- | ----------------------------- |
-| [ESM Loader](#nodejs-esm-loader)                          | Node.js scripts, development    | `@elliots/typical`            |
-| [ttsx](#ttsx-tsx-wrapper)                                 | Quick scripts with tsx          | `@elliots/typical` + `tsx`    |
-| [Bun Plugin](#bun)                                        | Bun projects                    | `@elliots/bun-plugin-typical` |
-| [Vite/Webpack/etc](#bundlers-vite-webpack-rollup-esbuild) | Frontend apps, bundled projects | `@elliots/unplugin-typical`   |
-| [tsc Plugin](#typescript-compiler-tsc)                    | Pure TypeScript compilation     | `@elliots/typical-tsc-plugin` |
+| Method                                                    | Best For                        | Package                              |
+| --------------------------------------------------------- | ------------------------------- | ------------------------------------ |
+| [ESM Loader](#nodejs-esm-loader)                          | Node.js scripts, development    | `@elliots/typical`                   |
+| [ttsx](#ttsx-tsx-wrapper)                                 | Quick scripts with tsx          | `@elliots/typical` + `tsx`           |
+| [Bun Plugin](#bun)                                        | Bun projects                    | `@elliots/bun-plugin-typical`        |
+| [React Native / Expo](#react-native--expo)                | React Native apps               | `@elliots/metro-transformer-typical` |
+| [Vite/Webpack/etc](#bundlers-vite-webpack-rollup-esbuild) | Frontend apps, bundled projects | `@elliots/unplugin-typical`          |
+| [tsc Plugin](#typescript-compiler-tsc)                    | Pure TypeScript compilation     | `@elliots/typical-tsc-plugin`        |
 
 ---
 
@@ -123,6 +124,44 @@ bun run src/index.ts
 
 ---
 
+## React Native / Expo
+
+```bash
+npm add @elliots/metro-transformer-typical
+```
+
+Update your `metro.config.js`:
+
+```js
+// metro.config.js
+const { getDefaultConfig } = require("expo/metro-config");
+const { withTypical } = require("@elliots/metro-transformer-typical");
+
+module.exports = withTypical(getDefaultConfig(__dirname));
+```
+
+For vanilla React Native (without Expo):
+
+```js
+// metro.config.js
+const { getDefaultConfig } = require("@react-native/metro-config");
+const { withTypical } = require("@elliots/metro-transformer-typical");
+
+module.exports = withTypical(getDefaultConfig(__dirname));
+```
+
+With options:
+
+```js
+module.exports = withTypical(getDefaultConfig(__dirname), {
+  typical: {
+    validateCasts: true,
+  },
+});
+```
+
+---
+
 ## Bundlers (Vite, Webpack, Rollup, esbuild)
 
 ```bash
@@ -489,6 +528,10 @@ Runtime validation performance comparing Typical vs Zod vs no validation:
 
 <!-- CHANGELOG_START -->
 
+### v0.3.1 (2026-02-23)
+
+Add metro transformer (React Native/Expo)
+
 ### v0.3.0 (2026-01-14)
 
 - Build call graph across whole project to avoid validating already-validated data

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elliots/typical",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Runtime safe TypeScript transformer using typia",
   "keywords": [
     "runtime",
@@ -40,7 +40,7 @@
   },
   "dependencies": {
     "commander": "14.0.2",
-    "@elliots/typical-compiler": "0.3.0"
+    "@elliots/typical-compiler": "0.3.1"
   },
   "devDependencies": {
     "@types/node": "22",
@@ -75,7 +75,7 @@
     "build:ts": "pnpm --filter './packages/*' run build && tsc",
     "build:website": "pnpm --filter typical-website run build",
     "dev": "tsc --watch",
-    "test": "rm -f test/test.temp.ts && tsc && node --import ./dist/src/esm-loader-register.js --test dist/test/*.test.js",
+    "test": "rm -f test/test.temp.ts && rm -rf test/project-fixtures && tsc && node --import ./dist/src/esm-loader-register.js --test dist/test/*.test.js",
     "test:coverage": "rm -f test/test.temp.ts && tsc && node --import ./dist/src/esm-loader-register.js --test --experimental-test-coverage dist/test/*.test.js",
     "test:coverage:html": "rm -f test/test.temp.ts && tsc && c8 --reporter=html --reporter=text --include='dist/src/**' node --import ./dist/src/esm-loader-register.js --test dist/test/*.test.js",
     "bench": "pnpm run build && cd bench && pnpm install && npm run bench",
@@ -86,6 +86,7 @@
     "sample:ttsc": "cd samples/ttsc && pnpm install && npm run build && npm run start",
     "sample:vite-react": "cd samples/vite-react && pnpm install && pnpm run test",
     "sample:bun": "cd samples/bun && pnpm install && bun run start",
+    "sample:react-native": "cd samples/react-native && pnpm install && npm run web",
     "samples": "npm run sample:esm && npm run sample:ttsx && npm run sample:vite-react && npm run sample:bun",
     "publish:all": "npm run lint && npm run format:check && node scripts/publish.js"
   }