Install

1$ npm install @sinclair/typebox-adapter --save

Example

TypeBox Adapter converts Valibot and Zod Types into TypeBox compatible schematics

TypeScript Example

1import { Box } from '@sinclair/typebox-adapter'
2
3import * as v from 'valibot'
4import * as z from 'zod'
5
6// Valibot to TypeBox (Runtime)
7
8const V = Box(v.object({                            // const V = {
9  x: v.number(),                                    //   type: 'object',
10  y: v.number(),                                    //   required: ['x', 'y', 'z'],
11  z: v.number()                                     //   properties: {
12}))                                                 //     x: { type: 'number' },
13                                                    //     y: { type: 'number' },
14                                                    //     z: { type: 'number' }
15                                                    //   }
16                                                    // }
17
18// Zod to TypeBox (Static)
19
20const Z = Box(z.object({                            // const Z: TObject<{
21  a: z.string(),                                    //   a: TString,
22  b: z.string(),                                    //   b: TString,
23  c: z.string()                                     //   c: TString
24}))                                                 // }>

Overview

TypeBox Adapter converts Zod and Valibot types into TypeBox schematics (Json Schema). It performs a deep structural remapping of the types provided by these libraries into TypeScript-aligned Json Schema, enabling integration with industry-standard validators like Ajv and OpenAPI-related technologies, while also facilitating interoperability and acceleration via the TypeBox validation infrastructure.

License MIT

Contents

• Install
• Overview
• Usage
  • Valibot
  • Zod
• Benchmark
• Contribute

Usage

TypeBox Adapter provides a singular Box function to transform Valibot and Zod types into TypeBox schematics. The top-level export is capable of transforming both Valibot and Zod, but you should use the appropriate submodule depending on which library you are using.

Valibot

Use the /valibot submodule if you only have Valibot installed. Refer to the Valibot documentation for more information on this type library.

1import { Box } from '@sinclair/typebox-adapter/valibot' // Transform Valibot Only
2
3import * as v from 'valibot'
4
5const T = Box(v.string())                               // const T = { type: 'string' }

Zod

Use the /zod submodule if you only have Zod installed. Refer to the Zod documentation for more information on this type library.

1import { Box } from '@sinclair/typebox-adapter/zod'     // Transform Zod Only
2
3import * as z from 'zod'
4
5const T = Box(z.string())                               // const T = { type: 'string' }

Benchmark

This project manages a benchmark that evaluates type-check performance using Zod, Valibot, and TypeBox validators. The benchmark is set up to run 10 million check operations per library-validator pairing and reports the elapsed time taken to complete.

Type

Benchmarks are run for the following type.

1type T = { x: number, y: string, z: boolean }

Results

Results show validate performance for the type.

1┌─────────┬────────────────┬────────────────────┬────────────┬────────────┐
2│ (index) │ library        │ using              │ iterations │ elapsed    │
3├─────────┼────────────────┼────────────────────┼────────────┼────────────┤
4│ 0       │ 'valibot     ' │ 'valibot         ' │ 10000000   │ '1534 ms ' │
5│ 1       │ 'valibot     ' │ 'typebox:value   ' │ 10000000   │ '1377 ms ' │
6│ 2       │ 'valibot     ' │ 'typebox:compile ' │ 10000000   │ '46 ms   ' │
7└─────────┴────────────────┴────────────────────┴────────────┴────────────┘
8┌─────────┬────────────────┬────────────────────┬────────────┬────────────┐
9│ (index) │ library        │ using              │ iterations │ elapsed    │
10├─────────┼────────────────┼────────────────────┼────────────┼────────────┤
11│ 0       │ 'zod         ' │ 'zod             ' │ 10000000   │ '4669 ms ' │
12│ 1       │ 'zod         ' │ 'typebox:value   ' │ 10000000   │ '1359 ms ' │
13│ 2       │ 'zod         ' │ 'typebox:compile ' │ 10000000   │ '47 ms   ' │
14└─────────┴────────────────┴────────────────────┴────────────┴────────────┘

For community benchmarks, refer to the runtime-type-benchmarks project.

Contribute

This project is open to community contributions. Please ensure you submit an open issue before creating a pull request. TypeBox and its associated projects encourage open community discussion before accepting new features.