@sinclair/typebox 0.24.26 → 0.24.29

package/readme.md

@@ -19,16 +19,16 @@
 
 ## Install
 
-#### Node
+Node
 
 ```bash
 $ npm install @sinclair/typebox --save
 ```
 
-#### Deno
+Deno and ESM
 
 ```typescript
-import { Static, Type } from 'https://deno.land/x/typebox/src/typebox.ts'
+import { Static, Type } from 'https://esm.sh/@sinclair/typebox'
 ```
 
 ## Example
@@ -45,9 +45,9 @@ type T = Static<typeof T>   // type T = string
 
 ## Overview
 
-TypeBox is a type builder library that creates in-memory JSON Schema objects that can be statically inferred as TypeScript types. The schemas produced by this library are designed to match the static type checking rules of the TypeScript compiler. TypeBox enables one to create unified types that can be statically checked by TypeScript and runtime asserted using standard JSON Schema validation.
+TypeBox is a type builder library that creates in-memory JSON Schema objects that can be statically inferred as TypeScript types. The schemas produced by this library are designed to match the static type checking rules of the TypeScript compiler. TypeBox enables one to create a unified type that can be statically checked by TypeScript and runtime asserted using standard JSON Schema validation.
 
-TypeBox can be used as a simple tool to build up complex schemas or integrated into RPC or REST services to help validate JSON data received over the wire.
+TypeBox is designed to enable JSON schema to compose with the same flexibility as TypeScript's type system. It can be used either as a simple tool to build up complex schemas or integrated into REST and RPC services to help validate data received over the wire. 
 
 License MIT
 
@@ -69,6 +69,7 @@ License MIT
 - [Strict](#strict)
 - [Validation](#validation)
 - [Compiler](#compiler)
+- [Formats](#formats)
 - [Benchmark](#benchmark)
 - [Contribute](#contribute)
 
@@ -194,7 +195,7 @@ The following table outlines the TypeBox mappings between TypeScript and JSON sc
 │                                │                             │                                │
 ├────────────────────────────────┼─────────────────────────────┼────────────────────────────────┤
 │ const T = Type.Literal(42)     │ type T = 42                 │ const T = {                    │
-│                                │                             │    const: 42                   │
+│                                │                             │    const: 42,                  │
 │                                │                             │    type: 'number'              │
 │                                │                             │ }                              │
 │                                │                             │                                │
@@ -506,9 +507,8 @@ type Node = Static<typeof Node>                      // type Node = {
                                                      // }
 
 function test(node: Node) {
-  const id = node.nodes[0].nodes[0].nodes[0]         // id is string
-                 .nodes[0].nodes[0].nodes[0]
-                 .nodes[0].nodes[0].nodes[0]
+  const id = node.nodes[0].nodes[0]                  // id is string
+                 .nodes[0].nodes[0]
                  .id
 }
 ```
@@ -555,7 +555,7 @@ const T = Type.Unsafe<string>({ type: 'number' })    // const T = {
 type T = Static<typeof T>                            // type T = string
 ```
 
-The `Type.Unsafe(...)` function can be used to create schemas for validators that require specific schema representations. An example of this would be OpenAPI's `nullable` and `enum` schemas which are not provided by TypeBox. The following demonstrates using `Type.Unsafe(...)` to create these types.
+This function can be used to create custom schemas for validators that require specific schema representations. An example of this might be OpenAPI's `nullable` and `enum` schemas which are not provided by TypeBox. The following demonstrates using `Type.Unsafe(...)` to create these types.
 
 ```typescript
 import { Type, Static, TSchema } from '@sinclair/typebox'
@@ -577,6 +577,7 @@ const T = Nullable(Type.String())                    // const T = {
 
 type T = Static<typeof T>                            // type T = string | null
 
+
 //--------------------------------------------------------------------------------------------
 //
 // StringEnum<string[]>
@@ -596,7 +597,9 @@ type T = Static<typeof T>                            // type T = 'A' | 'B' | 'C'
 
 ## Conditional Types
 
-Use `Conditional.Extends(...)` to create conditional mapped types.
+Use the conditional module to create [Conditional Types](https://www.typescriptlang.org/docs/handbook/2/conditional-types.html). This module implements TypeScript's structural equivalence checks to enable TypeBox types to be conditionally inferred at runtime. This module also provides the [Extract](https://www.typescriptlang.org/docs/handbook/utility-types.html#extracttype-union) and [Exclude](https://www.typescriptlang.org/docs/handbook/utility-types.html#excludeuniontype-excludedmembers) utility types which are expressed as conditional types in TypeScript. 
+
+The conditional module is provided as an optional import.
 
 ```typescript
 import { Conditional } from '@sinclair/typebox/conditional'
@@ -645,46 +648,56 @@ The following table shows the TypeBox mappings between TypeScript and JSON schem
 
 ## Values
 
-Use `Value.Create(...)` to generate values from types.
+Use the value module to perform common type operations on values. This module provides functionality to create, check and cast values into a given type. Note that this module internally uses dynamic type checking to perform these operations. For faster type checking performance, consider using either Ajv or the TypeBox [TypeCompiler](#compiler).
+
+ The value module is provided as an optional import.
 
 ```typescript
 import { Value } from '@sinclair/typebox/value'
-import { Type } from '@sinclair/typebox'
-
-const T = Type.Object({
-  x: Type.Number({ default: 1 }),
-  y: Type.Number()
-})
-
-const V = Value.Create(T)                            // const V = {
-                                                     //   x: 1,
-                                                     //   y: 0
-                                                     // }
 ```
-Use `Value.Cast(...)` to cast a value into a given type.
+The following demonstrates its use.
 ```typescript
-import { Value } from '@sinclair/typebox/value'
-import { Type } from '@sinclair/typebox'
 
-const T = Type.Object({
-  x: Type.Number(),
-  y: Type.Number()
-})
 
-const A = Value.Cast(T, null)                          // const A = { x: 0, y: 0 }
+const T = Type.Object({ x: Type.Number(), y: Type.Number() }, { additionalProperties: false })
+
+//--------------------------------------------------------------------------------------------
+//
+// Use Value.Create(T) to create a value from T.
+//
+//--------------------------------------------------------------------------------------------
+
+const V = Value.Create(T)                            // const V = { x: 0, y: 0 }
+
+//--------------------------------------------------------------------------------------------
+//
+// Use Value.Check(T, ...) to check if a value is of type T.
+//
+//--------------------------------------------------------------------------------------------
+
+const R = Value.Check(T, { x: 1 })                   // const R = false
+
+//--------------------------------------------------------------------------------------------
+//
+// Use Value.Cast(T, ...) to immutably cast a value into T.
+//
+//--------------------------------------------------------------------------------------------
+
+const A = Value.Cast(T, null)                        // const A = { x: 0, y: 0 }
+
+const B = Value.Cast(T, { x: 1 })                    // const B = { x: 1, y: 0 }
+
+const C = Value.Cast(T, { x: 1, y: 2, z: 3 })        // const C = { x: 1, y: 2 }
 
-const B = Value.Cast(T, { x: 1 })                      // const B = { x: 1, y: 0 }
 
-const C = Value.Cast(T, { x: 1, y: 2, z: 3 })          // const C = { x: 1, y: 2 }
 ```
 
 ## Guards
 
-Use a `TypeGuard` to test if a value meets a TypeBox type specification. Guards can be helpful when reflecting types.
+Use the guard module to test if values are TypeBox types.
 
 ```typescript
 import { TypeGuard } from '@sinclair/typebox/guard'
-import { Type }  from '@sinclair/typebox'
 
 const T = Type.String()
 
@@ -692,7 +705,6 @@ if(TypeGuard.TString(T)) {
     
   // T is TString
 }
-
 ```
 
 ## Strict
@@ -789,14 +801,17 @@ Please refer to the official Ajv [documentation](https://ajv.js.org/guide/gettin
 
 ## Compiler
 
-TypeBox provides an optional high performance runtime type checker that can be used in applications that require extremely fast validation. This type checker is optimized for TypeBox types only whose schematics are known in advance. If defining custom schemas with `Type.Unsafe<T>` please consider Ajv.
+TypeBox provides an optional high performance just-in-time (JIT) compiler and type checker that can be used in applications that require extremely fast validation. Note that this compiler is optimized for TypeBox types only where the schematics are known in advance. If defining custom types with `Type.Unsafe<T>` please consider Ajv.
 
-The following demonstrates its use.
+The compiler module is provided as an optional import.
 
 ```typescript
 import { TypeCompiler } from '@sinclair/typebox/compiler'
-import { Type } from '@sinclair/typebox'
+```
+
+Use the `Compile(...)` function to compile a type.
 
+```typescript
 const C = TypeCompiler.Compile(Type.Object({         // const C: TypeCheck<TObject<{
   x: Type.Number(),                                  //     x: TNumber;
   y: Type.Number(),                                  //     y: TNumber;
@@ -818,19 +833,16 @@ const C = TypeCompiler.Compile(Type.Object({         // const C: TypeCheck<TObje
 const value = { }
 
 const errors = [...C.Errors(value)]                  // const errors = [{
-                                                     //   type: 14,
                                                      //   schema: { type: 'number' },
                                                      //   path: '/x',
                                                      //   value: undefined,
                                                      //   message: 'Expected number'
                                                      // }, {
-                                                     //   type: 14,
                                                      //   schema: { type: 'number' },
                                                      //   path: '/y',
                                                      //   value: undefined,
                                                      //   message: 'Expected number'
                                                      // }, {
-                                                     //   type: 14,
                                                      //   schema: { type: 'number' },
                                                      //   path: '/z',
                                                      //   value: undefined,
@@ -850,85 +862,130 @@ console.log(C.Code())                                // return function check(va
                                                      // }
 ```
 
+## Formats
+
+Use the `Format` module to define custom string formats.
+
+```typescript
+import { Format } from '@sinclair/typebox/format'
+```
+
+Formats are shared between `Value` and the `TypeCompiler` modules.
+
+```typescript
+//--------------------------------------------------------------------------------------------
+//
+// Use Format.Set(...) to define a format
+//
+//--------------------------------------------------------------------------------------------
+
+Format.Set('ObjectId', value => /^[0-9a-fA-F]{24}$/.test(value))
+
+//--------------------------------------------------------------------------------------------
+//
+// The format is now available to TypeCompiler and Value modules
+//
+//--------------------------------------------------------------------------------------------
+
+const T = Type.String({ format: 'ObjectId' })
+
+const R1 = TypeCompiler.Compile(T).Check('507f1f77bcf86cd799439011')
 
+const R2 = Value.Check(T, '507f1f77bcf86cd799439011')                
+```
 
 ## Benchmark
 
-This project maintains a set of benchmarks that measure Ajv and TypeCompiler compilation and validation performance. These benchmarks can be run locally by cloning this repository and running `npm run benchmark`. The results below show for Ajv version 8.11.0. 
+This project maintains a set of benchmarks that measure Ajv, Value and TypeCompiler compilation and validation performance. These benchmarks can be run locally by cloning this repository and running `npm run benchmark`. The results below show for Ajv version 8.11.0. 
 
 For additional comparative benchmarks, please refer to [typescript-runtime-type-benchmarks](https://moltar.github.io/typescript-runtime-type-benchmarks/).
 
 ### Compile
 
-This benchmark measures compilation performance for varying types. You can review this benchmark [here](https://github.com/sinclairzx81/typebox/blob/master/benchmark/compile.ts).
+This benchmark measures compilation performance for varying types. You can review this benchmark [here](https://github.com/sinclairzx81/typebox/blob/master/benchmark/measurement/module/compile.ts).
 
 ```typescript
 ┌──────────────────┬────────────┬──────────────┬──────────────┬──────────────┐
 │     (index)      │ Iterations │     Ajv      │ TypeCompiler │ Performance  │
 ├──────────────────┼────────────┼──────────────┼──────────────┼──────────────┤
-│           Number │    2000    │ '    382 ms' │ '      8 ms' │ '   47.75 x' │
-│           String │    2000    │ '    305 ms' │ '      7 ms' │ '   43.57 x' │
-│          Boolean │    2000    │ '    305 ms' │ '      5 ms' │ '   61.00 x' │
-│             Null │    2000    │ '    253 ms' │ '      5 ms' │ '   50.60 x' │
-│            RegEx │    2000    │ '    475 ms' │ '     10 ms' │ '   47.50 x' │
-│          ObjectA │    2000    │ '   2812 ms' │ '     44 ms' │ '   63.91 x' │
-│          ObjectB │    2000    │ '   3045 ms' │ '     34 ms' │ '   89.56 x' │
-│            Tuple │    2000    │ '   1324 ms' │ '     19 ms' │ '   69.68 x' │
-│            Union │    2000    │ '   1347 ms' │ '     26 ms' │ '   51.81 x' │
-│          Vector4 │    2000    │ '   1635 ms' │ '     18 ms' │ '   90.83 x' │
-│          Matrix4 │    2000    │ '    928 ms' │ '     10 ms' │ '   92.80 x' │
-│   Literal_String │    2000    │ '    349 ms' │ '      5 ms' │ '   69.80 x' │
-│   Literal_Number │    2000    │ '    379 ms' │ '      5 ms' │ '   75.80 x' │
-│  Literal_Boolean │    2000    │ '    376 ms' │ '      6 ms' │ '   62.67 x' │
-│     Array_Number │    2000    │ '    733 ms' │ '     10 ms' │ '   73.30 x' │
-│     Array_String │    2000    │ '    766 ms' │ '      8 ms' │ '   95.75 x' │
-│    Array_Boolean │    2000    │ '    860 ms' │ '     11 ms' │ '   78.18 x' │
-│    Array_ObjectA │    2000    │ '   3668 ms' │ '     42 ms' │ '   87.33 x' │
-│    Array_ObjectB │    2000    │ '   3809 ms' │ '     41 ms' │ '   92.90 x' │
-│      Array_Tuple │    2000    │ '   2219 ms' │ '     17 ms' │ '  130.53 x' │
-│      Array_Union │    2000    │ '   1709 ms' │ '     26 ms' │ '   65.73 x' │
-│    Array_Vector4 │    2000    │ '   2301 ms' │ '     18 ms' │ '  127.83 x' │
-│    Array_Matrix4 │    2000    │ '   1594 ms' │ '     12 ms' │ '  132.83 x' │
+│           Number │    2000    │ '    402 ms' │ '      8 ms' │ '   50.25 x' │
+│           String │    2000    │ '    316 ms' │ '      8 ms' │ '   39.50 x' │
+│          Boolean │    2000    │ '    308 ms' │ '      6 ms' │ '   51.33 x' │
+│             Null │    2000    │ '    259 ms' │ '      5 ms' │ '   51.80 x' │
+│            RegEx │    2000    │ '    479 ms' │ '     11 ms' │ '   43.55 x' │
+│          ObjectA │    2000    │ '   2766 ms' │ '     41 ms' │ '   67.46 x' │
+│          ObjectB │    2000    │ '   3062 ms' │ '     29 ms' │ '  105.59 x' │
+│            Tuple │    2000    │ '   1258 ms' │ '     21 ms' │ '   59.90 x' │
+│            Union │    2000    │ '   1449 ms' │ '     29 ms' │ '   49.97 x' │
+│          Vector4 │    2000    │ '   1616 ms' │ '     16 ms' │ '  101.00 x' │
+│          Matrix4 │    2000    │ '    975 ms' │ '      8 ms' │ '  121.88 x' │
+│   Literal_String │    2000    │ '    350 ms' │ '      6 ms' │ '   58.33 x' │
+│   Literal_Number │    2000    │ '    386 ms' │ '      5 ms' │ '   77.20 x' │
+│  Literal_Boolean │    2000    │ '    377 ms' │ '      4 ms' │ '   94.25 x' │
+│     Array_Number │    2000    │ '    737 ms' │ '      7 ms' │ '  105.29 x' │
+│     Array_String │    2000    │ '    765 ms' │ '      7 ms' │ '  109.29 x' │
+│    Array_Boolean │    2000    │ '    783 ms' │ '      8 ms' │ '   97.88 x' │
+│    Array_ObjectA │    2000    │ '   3578 ms' │ '     31 ms' │ '  115.42 x' │
+│    Array_ObjectB │    2000    │ '   3718 ms' │ '     33 ms' │ '  112.67 x' │
+│      Array_Tuple │    2000    │ '   2259 ms' │ '     14 ms' │ '  161.36 x' │
+│      Array_Union │    2000    │ '   1704 ms' │ '     20 ms' │ '   85.20 x' │
+│    Array_Vector4 │    2000    │ '   2293 ms' │ '     17 ms' │ '  134.88 x' │
+│    Array_Matrix4 │    2000    │ '   1575 ms' │ '     12 ms' │ '  131.25 x' │
 └──────────────────┴────────────┴──────────────┴──────────────┴──────────────┘
 ```
 
 ### Validate
 
-This benchmark measures validation performance for varying types. You can review this benchmark [here](https://github.com/sinclairzx81/typebox/blob/master/benchmark/check.ts).
+This benchmark measures validation performance for varying types. You can review this benchmark [here](https://github.com/sinclairzx81/typebox/blob/master/benchmark/measurement/module/check.ts).
 
 ```typescript
-┌──────────────────┬────────────┬──────────────┬──────────────┬──────────────┐
-│     (index)      │ Iterations │     Ajv      │ TypeCompiler │ Performance  │
-├──────────────────┼────────────┼──────────────┼──────────────┼──────────────┤
-│           Number │  4000000   │ '     18 ms' │ '     16 ms' │ '    1.13 x' │
-│           String │  4000000   │ '     74 ms' │ '     43 ms' │ '    1.72 x' │
-│          Boolean │  4000000   │ '     71 ms' │ '     37 ms' │ '    1.92 x' │
-│             Null │  4000000   │ '     70 ms' │ '     37 ms' │ '    1.89 x' │
-│            RegEx │  4000000   │ '    175 ms' │ '    153 ms' │ '    1.14 x' │
-│          ObjectA │  4000000   │ '    124 ms' │ '     87 ms' │ '    1.43 x' │
-│          ObjectB │  4000000   │ '    215 ms' │ '    143 ms' │ '    1.50 x' │
-│            Tuple │  4000000   │ '    101 ms' │ '     51 ms' │ '    1.98 x' │
-│            Union │  4000000   │ '    108 ms' │ '     51 ms' │ '    2.12 x' │
-│        Recursive │  4000000   │ '   1647 ms' │ '    626 ms' │ '    2.63 x' │
-│          Vector4 │  4000000   │ '     83 ms' │ '     41 ms' │ '    2.02 x' │
-│          Matrix4 │  4000000   │ '    154 ms' │ '    105 ms' │ '    1.47 x' │
-│   Literal_String │  4000000   │ '    101 ms' │ '     37 ms' │ '    2.73 x' │
-│   Literal_Number │  4000000   │ '     69 ms' │ '     35 ms' │ '    1.97 x' │
-│  Literal_Boolean │  4000000   │ '     71 ms' │ '     35 ms' │ '    2.03 x' │
-│     Array_Number │  4000000   │ '    117 ms' │ '     61 ms' │ '    1.92 x' │
-│     Array_String │  4000000   │ '    116 ms' │ '     73 ms' │ '    1.59 x' │
-│    Array_Boolean │  4000000   │ '    129 ms' │ '     89 ms' │ '    1.45 x' │
-│    Array_ObjectA │  4000000   │ '  10582 ms' │ '   6854 ms' │ '    1.54 x' │
-│    Array_ObjectB │  4000000   │ '  11539 ms' │ '   8224 ms' │ '    1.40 x' │
-│      Array_Tuple │  4000000   │ '    362 ms' │ '    282 ms' │ '    1.28 x' │
-│      Array_Union │  4000000   │ '    950 ms' │ '    355 ms' │ '    2.68 x' │
-│  Array_Recursive │  4000000   │ '  28047 ms' │ '   9567 ms' │ '    2.93 x' │
-│    Array_Vector4 │  4000000   │ '    372 ms' │ '    200 ms' │ '    1.86 x' │
-│    Array_Matrix4 │  4000000   │ '   1521 ms' │ '   1244 ms' │ '    1.22 x' │
-└──────────────────┴────────────┴──────────────┴──────────────┴──────────────┘
+┌──────────────────┬────────────┬──────────────┬──────────────┬──────────────┬──────────────┐
+│     (index)      │ Iterations │  ValueCheck  │     Ajv      │ TypeCompiler │ Performance  │
+├──────────────────┼────────────┼──────────────┼──────────────┼──────────────┼──────────────┤
+│           Number │  1000000   │ '     38 ms' │ '      6 ms' │ '      5 ms' │ '    1.20 x' │
+│           String │  1000000   │ '     26 ms' │ '     23 ms' │ '     12 ms' │ '    1.92 x' │
+│          Boolean │  1000000   │ '     26 ms' │ '     23 ms' │ '     11 ms' │ '    2.09 x' │
+│             Null │  1000000   │ '     29 ms' │ '     24 ms' │ '     12 ms' │ '    2.00 x' │
+│            RegEx │  1000000   │ '    169 ms' │ '     47 ms' │ '     37 ms' │ '    1.27 x' │
+│          ObjectA │  1000000   │ '    551 ms' │ '     45 ms' │ '     23 ms' │ '    1.96 x' │
+│          ObjectB │  1000000   │ '    995 ms' │ '     49 ms' │ '     39 ms' │ '    1.26 x' │
+│            Tuple │  1000000   │ '    115 ms' │ '     30 ms' │ '     14 ms' │ '    2.14 x' │
+│            Union │  1000000   │ '    294 ms' │ '     30 ms' │ '     14 ms' │ '    2.14 x' │
+│        Recursive │  1000000   │ '   3308 ms' │ '    429 ms' │ '    174 ms' │ '    2.47 x' │
+│          Vector4 │  1000000   │ '    145 ms' │ '     25 ms' │ '     13 ms' │ '    1.92 x' │
+│          Matrix4 │  1000000   │ '    663 ms' │ '     42 ms' │ '     34 ms' │ '    1.24 x' │
+│   Literal_String │  1000000   │ '     46 ms' │ '     21 ms' │ '     11 ms' │ '    1.91 x' │
+│   Literal_Number │  1000000   │ '     50 ms' │ '     26 ms' │ '     11 ms' │ '    2.36 x' │
+│  Literal_Boolean │  1000000   │ '     45 ms' │ '     24 ms' │ '     11 ms' │ '    2.18 x' │
+│     Array_Number │  1000000   │ '    411 ms' │ '     35 ms' │ '     19 ms' │ '    1.84 x' │
+│     Array_String │  1000000   │ '    438 ms' │ '     33 ms' │ '     20 ms' │ '    1.65 x' │
+│    Array_Boolean │  1000000   │ '    444 ms' │ '     38 ms' │ '     24 ms' │ '    1.58 x' │
+│    Array_ObjectA │  1000000   │ '  13714 ms' │ '   2819 ms' │ '   1791 ms' │ '    1.57 x' │
+│    Array_ObjectB │  1000000   │ '  15855 ms' │ '   2965 ms' │ '   2066 ms' │ '    1.44 x' │
+│      Array_Tuple │  1000000   │ '   1682 ms' │ '     94 ms' │ '     71 ms' │ '    1.32 x' │
+│      Array_Union │  1000000   │ '   4575 ms' │ '    239 ms' │ '     86 ms' │ '    2.78 x' │
+│  Array_Recursive │  1000000   │ '  51970 ms' │ '   7192 ms' │ '   2617 ms' │ '    2.75 x' │
+│    Array_Vector4 │  1000000   │ '   2097 ms' │ '    100 ms' │ '     54 ms' │ '    1.85 x' │
+│    Array_Matrix4 │  1000000   │ '  11596 ms' │ '    381 ms' │ '    327 ms' │ '    1.17 x' │
+└──────────────────┴────────────┴──────────────┴──────────────┴──────────────┴──────────────┘
 ```
 
+### Compression
+
+The following table lists esbuild compiled and minified sizes for each TypeBox module.
 
+```typescript
+┌──────────────────────┬────────────┬────────────┬─────────────┐
+│       (index)        │  Compiled  │  Minified  │ Compression │
+├──────────────────────┼────────────┼────────────┼─────────────┤
+│ typebox/compiler     │ '   48 kb' │ '   24 kb' │  '2.00 x'   │
+│ typebox/conditional  │ '   41 kb' │ '   16 kb' │  '2.47 x'   │
+│ typebox/format       │ '    0 kb' │ '    0 kb' │  '2.68 x'   │
+│ typebox/guard        │ '   20 kb' │ '    9 kb' │  '2.08 x'   │
+│ typebox/value        │ '   55 kb' │ '   25 kb' │  '2.15 x'   │
+│ typebox              │ '   11 kb' │ '    5 kb' │  '1.91 x'   │
+└──────────────────────┴────────────┴────────────┴─────────────┘
+```
 
 ## Contribute
 

package/value/cast.d.ts

@@ -1,5 +1,5 @@
 import * as Types from '../typebox';
-export declare class ValueCastInvalidTypeError extends Error {
+export declare class ValueCastUnknownTypeError extends Error {
     readonly schema: Types.TSchema;
     constructor(schema: Types.TSchema);
 }

package/value/cast.js

@@ -27,9 +27,8 @@ THE SOFTWARE.
 
 ---------------------------------------------------------------------------*/
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ValueCast = exports.ValueCastInvalidTypeError = void 0;
+exports.ValueCast = exports.ValueCastUnknownTypeError = void 0;
 const Types = require("../typebox");
-const index_1 = require("../guard/index");
 const create_1 = require("./create");
 const check_1 = require("./check");
 // --------------------------------------------------------------------------
@@ -72,13 +71,13 @@ var UnionValueCast;
     }
     UnionValueCast.Create = Create;
 })(UnionValueCast || (UnionValueCast = {}));
-class ValueCastInvalidTypeError extends Error {
+class ValueCastUnknownTypeError extends Error {
     constructor(schema) {
-        super('ValueCast: Invalid type');
+        super('ValueCast: Unknown type');
         this.schema = schema;
     }
 }
-exports.ValueCastInvalidTypeError = ValueCastInvalidTypeError;
+exports.ValueCastUnknownTypeError = ValueCastUnknownTypeError;
 var ValueCast;
 (function (ValueCast) {
     function Any(schema, references, value) {
@@ -197,72 +196,57 @@ var ValueCast;
         return check_1.ValueCheck.Check(schema, references, value) ? value : create_1.ValueCreate.Create(schema, references);
     }
     function Visit(schema, references, value) {
-        const refs = schema.$id === undefined ? references : [schema, ...references];
-        if (index_1.TypeGuard.TAny(schema)) {
-            return Any(schema, refs, value);
-        }
-        else if (index_1.TypeGuard.TArray(schema)) {
-            return Array(schema, refs, value);
-        }
-        else if (index_1.TypeGuard.TBoolean(schema)) {
-            return Boolean(schema, refs, value);
-        }
-        else if (index_1.TypeGuard.TConstructor(schema)) {
-            return Constructor(schema, refs, value);
-        }
-        else if (index_1.TypeGuard.TFunction(schema)) {
-            return Function(schema, refs, value);
-        }
-        else if (index_1.TypeGuard.TInteger(schema)) {
-            return Integer(schema, refs, value);
-        }
-        else if (index_1.TypeGuard.TLiteral(schema)) {
-            return Literal(schema, refs, value);
-        }
-        else if (index_1.TypeGuard.TNull(schema)) {
-            return Null(schema, refs, value);
-        }
-        else if (index_1.TypeGuard.TNumber(schema)) {
-            return Number(schema, refs, value);
-        }
-        else if (index_1.TypeGuard.TObject(schema)) {
-            return Object(schema, refs, value);
-        }
-        else if (index_1.TypeGuard.TPromise(schema)) {
-            return Promise(schema, refs, value);
-        }
-        else if (index_1.TypeGuard.TRecord(schema)) {
-            return Record(schema, refs, value);
-        }
-        else if (index_1.TypeGuard.TRef(schema)) {
-            return Ref(schema, refs, value);
-        }
-        else if (index_1.TypeGuard.TSelf(schema)) {
-            return Self(schema, refs, value);
-        }
-        else if (index_1.TypeGuard.TString(schema)) {
-            return String(schema, refs, value);
-        }
-        else if (index_1.TypeGuard.TTuple(schema)) {
-            return Tuple(schema, refs, value);
-        }
-        else if (index_1.TypeGuard.TUndefined(schema)) {
-            return Undefined(schema, refs, value);
-        }
-        else if (index_1.TypeGuard.TUnion(schema)) {
-            return Union(schema, refs, value);
-        }
-        else if (index_1.TypeGuard.TUint8Array(schema)) {
-            return Uint8Array(schema, refs, value);
-        }
-        else if (index_1.TypeGuard.TUnknown(schema)) {
-            return Unknown(schema, refs, value);
-        }
-        else if (index_1.TypeGuard.TVoid(schema)) {
-            return Void(schema, refs, value);
-        }
-        else {
-            throw new ValueCastInvalidTypeError(schema);
+        const anyReferences = schema.$id === undefined ? references : [schema, ...references];
+        const anySchema = schema;
+        switch (schema[Types.Kind]) {
+            case 'Any':
+                return Any(anySchema, anyReferences, value);
+            case 'Array':
+                return Array(anySchema, anyReferences, value);
+            case 'Boolean':
+                return Boolean(anySchema, anyReferences, value);
+            case 'Constructor':
+                return Constructor(anySchema, anyReferences, value);
+            case 'Enum':
+                return Enum(anySchema, anyReferences, value);
+            case 'Function':
+                return Function(anySchema, anyReferences, value);
+            case 'Integer':
+                return Integer(anySchema, anyReferences, value);
+            case 'Literal':
+                return Literal(anySchema, anyReferences, value);
+            case 'Null':
+                return Null(anySchema, anyReferences, value);
+            case 'Number':
+                return Number(anySchema, anyReferences, value);
+            case 'Object':
+                return Object(anySchema, anyReferences, value);
+            case 'Promise':
+                return Promise(anySchema, anyReferences, value);
+            case 'Record':
+                return Record(anySchema, anyReferences, value);
+            case 'Rec':
+                return Recursive(anySchema, anyReferences, value);
+            case 'Ref':
+                return Ref(anySchema, anyReferences, value);
+            case 'Self':
+                return Self(anySchema, anyReferences, value);
+            case 'String':
+                return String(anySchema, anyReferences, value);
+            case 'Tuple':
+                return Tuple(anySchema, anyReferences, value);
+            case 'Undefined':
+                return Undefined(anySchema, anyReferences, value);
+            case 'Union':
+                return Union(anySchema, anyReferences, value);
+            case 'Uint8Array':
+                return Uint8Array(anySchema, anyReferences, value);
+            case 'Unknown':
+                return Unknown(anySchema, anyReferences, value);
+            case 'Void':
+                return Void(anySchema, anyReferences, value);
+            default:
+                throw new ValueCastUnknownTypeError(anySchema);
         }
     }
     ValueCast.Visit = Visit;

package/value/check.d.ts

@@ -1,5 +1,5 @@
 import * as Types from '../typebox';
-export declare class ValueCheckInvalidTypeError extends Error {
+export declare class ValueCheckUnknownTypeError extends Error {
     readonly schema: Types.TSchema;
     constructor(schema: Types.TSchema);
 }