Compare commits

..

13 Commits

Author SHA1 Message Date
ca34609ec0 Clean up docs for publishing: add fork context, remove upstream references, fix nav links 2026-04-23 14:16:23 +00:00
f8b2cdd5a4 Decompose monolithic readme into docs/ directory structure 2026-04-23 13:57:56 +00:00
560bb00433 Remove @sinclair/hammer dependency and task runner
- Remove @sinclair/hammer from devDependencies
- Remove hammer.mjs entry point
- Remove task/ directory (build scripts, benchmarks)
- Add build.mjs: standalone build script replicating the
  CJS/ESM compilation, package.json generation, notice
  stripping, and ESM specifier rewrite logic
- Update npm scripts to use build.mjs and direct tsc/mocha
  instead of hammer task commands
2026-04-23 13:28:03 +00:00
bd758c2342 Fork from @sinclair/typebox 0.34.49 as @alkdev/typebox
- Rename package from @sinclair/typebox to @alkdev/typebox
- Update author, repository, and homepage to alkdev
- Remove GitHub workflows, .vscode config, and branding assets
- Update all source, test, example, changelog, and task imports
- Update tsconfig.json path mappings
- Clean up readme header (remove upstream badges/branding)
2026-04-23 13:22:31 +00:00
sinclairzx81
11f18ac6e9 Revision 0.34.48 (#6)
* Support Sparse Array Validation

* ChangeLog

* Version
2026-01-23 17:59:38 +09:00
sinclairzx81
3b0f4ea060 Revision 0.34.47 (#5)
* Annual License Update

* ChangeLog

* Version
2026-01-07 00:07:45 +09:00
sinclairzx81
72d13e1bc4 Revision 0.34.46 (#4)
* Functions Must Support TObject as Generic Constraint

* ChangeLog

* Version
2026-01-02 02:49:02 +09:00
sinclair
096e1f4a8b Nightly Builds 2025-12-25 14:49:56 +09:00
sinclairzx81
0a96228cc6 Revision 0.34.45 (#3)
* Documentation

* ChangeLog

* Version
2025-12-25 01:34:24 +09:00
sinclairzx81
0004b9bda8 Revision 0.34.44 (#2)
* Version

* ChangeLog
2025-12-25 00:47:24 +09:00
sinclair
03950060de Documentation 2025-12-25 00:40:37 +09:00
sinclair
af6fba10d2 Documentation 2025-12-24 22:25:55 +09:00
sinclairzx81
91a5661991 Revision 0.34.43 (#1)
* Configure Homepage

* ChangeLog

* Version
2025-12-24 17:01:20 +09:00
1036 changed files with 4418 additions and 6922 deletions

0
.github/.keep vendored
View File

View File

@@ -1,23 +0,0 @@
name: Build
on: [push, pull_request]
jobs:
TypeBox:
runs-on: ${{ matrix.os }}
strategy:
matrix:
node: [16.x, 18.x, 20.x]
os: [ubuntu-latest, windows-latest, macOS-latest]
steps:
- uses: actions/checkout@v3
- name: Install Node
uses: actions/setup-node@v3
with:
node-version: ${{ matrix.node }}
- name: Install Packages
run: npm install
- name: Build Library
run: npm run build
- name: Test Library
run: npm run test

View File

@@ -1,30 +0,0 @@
name: Build Nightly
on:
schedule:
- cron: '0 18 * * *' # 6pm Daily
jobs:
TypeBox:
runs-on: ${{ matrix.os }}
strategy:
matrix:
node: [20.x]
os: [ubuntu-latest]
steps:
- uses: actions/checkout@v3
- name: Install Node
uses: actions/setup-node@v3
with:
node-version: ${{ matrix.node }}
- name: Install Packages
run: npm install
- name: Install TypeScript Latest
run: npm install typescript@latest
- name: Build TypeBox
run: npm run build
- name: Install TypeScript Next
run: npm install typescript@next
- name: Build TypeBox
run: npm run build

View File

@@ -1,41 +0,0 @@
name: Publish
on:
push:
tags:
- '[0-9]+.[0-9]+.[0-9]+*' # Semver-Tag
permissions:
id-token: write # Required for OIDC
contents: read
jobs:
Publish:
runs-on: ubuntu-latest
steps:
# Checkout
- uses: actions/checkout@v4
# Node
- uses: actions/setup-node@v4
with:
node-version: '20'
registry-url: 'https://registry.npmjs.org'
# Update
- name: Update
run: npm install npm -g
# Install
- name: Build
run: npm install
# Build
- name: Build
run: npm run build
# Publish
- name: Publish
run: npm publish sinclair-typebox-*.tgz --provenance --access public
working-directory: target/build

View File

@@ -1,8 +0,0 @@
{
"files.exclude": {
"node_modules": true,
"package-lock.json": true
},
"editor.suggest.showStatusBar": false,
"typescript.tsdk": "node_modules\\typescript\\lib"
}

205
build.mjs Normal file
View File

@@ -0,0 +1,205 @@
import * as Fs from 'node:fs'
import * as Path from 'node:path'
import { execSync } from 'node:child_process'
const TARGET = 'target/build'
const SUBMODULES = ['compiler', 'errors', 'parser', 'syntax', 'system', 'type', 'value']
function shell(cmd) {
console.log(`> ${cmd}`)
execSync(cmd, { stdio: 'inherit' })
}
function rmrf(dir) {
Fs.rmSync(dir, { recursive: true, force: true })
}
function mkdirp(dir) {
Fs.mkdirSync(dir, { recursive: true })
}
function cp(src, dest) {
mkdirp(Path.dirname(dest))
Fs.copyFileSync(src, dest)
}
// --- Clean ---
function clean() {
rmrf('target')
}
// --- Remove MIT Notices from dist ---
function removeNotices(dir) {
function escape(content) {
return content.split('').map((c) => `\\${c}`).join('')
}
function removeNotice(content) {
const open = escape('/*--------------------------------------------------------------------------')
const close = escape('---------------------------------------------------------------------------*/')
const criteria = 'Permission is hereby granted, free of charge'
const pattern = new RegExp(`${open}[\\s\\S]*?${close}`, 'gm')
while (true) {
const match = pattern.exec(content)
if (match === null) return content.trimStart()
if (!match[0].includes(criteria)) continue
content = content.replace(match[0], '')
}
}
function processFile(sourcePath) {
const sourceContent = Fs.readFileSync(sourcePath, 'utf-8')
const targetContent = removeNotice(sourceContent)
Fs.writeFileSync(sourcePath, targetContent)
}
function walk(sourcePath) {
const stat = Fs.statSync(sourcePath)
if (stat.isDirectory()) {
for (const entry of Fs.readdirSync(sourcePath)) {
walk(Path.join(sourcePath, entry))
}
} else if (stat.isFile()) {
processFile(sourcePath)
}
}
walk(dir)
}
// --- ESM Specifier Rewrite ---
function convertToEsm(dir) {
function replaceInlineImportSpecifiers(content) {
const pattern = /import\((.*?)\)/g
while (true) {
const match = pattern.exec(content)
if (match === null) return content
const captured = match[1]
if (captured.includes('.mjs')) continue
const specifier = captured.slice(1, captured.length - 1)
content = content.replace(captured, `"${specifier}.mjs"`)
}
}
function replaceExportSpecifiers(content) {
const pattern = /(export|import)(.*) from ('(.*)');/g
while (true) {
const match = pattern.exec(content)
if (match === null) return content
const captured = match[3]
const specifier = captured.slice(1, captured.length - 1)
content = content.replace(captured, `'${specifier}.mjs'`)
}
}
function replaceSpecifiers(content) {
return replaceInlineImportSpecifiers(replaceExportSpecifiers(content))
}
function newExtension(ext) {
return ext === '.js' ? '.mjs' : ext === '.ts' ? '.mts' : ext
}
function processFile(sourcePath) {
const ext = Path.extname(sourcePath)
if (!['.js', '.ts'].includes(ext)) return
const dirname = Path.dirname(sourcePath)
const basename = Path.basename(sourcePath, ext)
const newExt = newExtension(ext)
const sourceContent = Fs.readFileSync(sourcePath, 'utf-8')
const targetContent = replaceSpecifiers(sourceContent)
const targetPath = Path.join(dirname, `${basename}${newExt}`)
Fs.writeFileSync(sourcePath, targetContent)
Fs.renameSync(sourcePath, targetPath)
}
function walk(sourcePath) {
const stat = Fs.statSync(sourcePath)
if (stat.isDirectory()) {
for (const entry of Fs.readdirSync(sourcePath)) {
walk(Path.join(sourcePath, entry))
}
} else if (stat.isFile()) {
processFile(sourcePath)
}
}
walk(dir)
}
// --- Build CJS ---
function buildCjs() {
console.log('building...cjs')
const target = `${TARGET}/build/cjs`
shell(`tsc -p ./src/tsconfig.json --outDir ${target} --target ES2020 --module Node16 --moduleResolution Node16 --declaration`)
removeNotices(target)
}
// --- Build ESM ---
function buildEsm() {
console.log('building...esm')
const target = `${TARGET}/build/esm`
shell(`tsc -p ./src/tsconfig.json --outDir ${target} --target ES2020 --module ESNext --moduleResolution Bundler --declaration`)
convertToEsm(target)
removeNotices(target)
}
// --- Build package.json ---
function buildPackageJson() {
console.log('building...package.json')
const rootPkg = JSON.parse(Fs.readFileSync('package.json', 'utf-8'))
const exports = {
'.': {
require: { types: './build/cjs/index.d.ts', default: './build/cjs/index.js' },
import: { types: './build/esm/index.d.mts', default: './build/esm/index.mjs' },
},
...SUBMODULES.reduce((acc, sub) => {
acc[`./${sub}`] = {
require: { types: `./build/cjs/${sub}/index.d.ts`, default: `./build/cjs/${sub}/index.js` },
import: { types: `./build/esm/${sub}/index.d.mts`, default: `./build/esm/${sub}/index.mjs` },
}
return acc
}, {}),
}
const pkg = {
name: rootPkg.name,
version: rootPkg.version,
description: rootPkg.description,
keywords: rootPkg.keywords,
author: rootPkg.author,
license: rootPkg.license,
repository: rootPkg.repository,
scripts: { test: 'echo test' },
types: './build/cjs/index.d.ts',
main: './build/cjs/index.js',
module: './build/esm/index.mjs',
'esm.sh': { bundle: false },
sideEffects: [
'./build/esm/type/registry/format.mjs',
'./build/esm/type/registry/type.mjs',
'./build/esm/type/system/policy.mjs',
'./build/cjs/type/registry/format.js',
'./build/cjs/type/registry/type.js',
'./build/cjs/type/system/policy.js',
],
exports,
}
Fs.writeFileSync(`${TARGET}/package.json`, JSON.stringify(pkg, null, 2))
// redirect package.json for older Node resolution
for (const sub of SUBMODULES) {
mkdirp(`${TARGET}/${sub}`)
Fs.writeFileSync(
`${TARGET}/${sub}/package.json`,
JSON.stringify({ main: `../build/cjs/${sub}/index.js`, types: `../build/cjs/${sub}/index.d.ts` }, null, 2)
)
}
}
// --- Main ---
const command = process.argv[2] || 'build'
if (command === 'clean') {
clean()
} else if (command === 'build') {
clean()
buildCjs()
buildEsm()
buildPackageJson()
cp('readme.md', `${TARGET}/readme.md`)
cp('license', `${TARGET}/license`)
shell(`cd ${TARGET} && npm pack`)
console.log('done!')
} else {
console.error(`unknown command: ${command}`)
process.exit(1)
}

View File

@@ -1,4 +1,4 @@
## [0.17.1](https://www.npmjs.com/package/@sinclair/typebox/v/0.17.1)
## [0.17.1](https://www.npmjs.com/package/@alkdev/typebox/v/0.17.1)
- Remove default `additionalProperties: false` constraint from all object schemas.

View File

@@ -1,4 +1,4 @@
## [0.17.4](https://www.npmjs.com/package/@sinclair/typebox/v/0.17.4)
## [0.17.4](https://www.npmjs.com/package/@alkdev/typebox/v/0.17.4)
Changes:

View File

@@ -1,4 +1,4 @@
## [0.17.6](https://www.npmjs.com/package/@sinclair/typebox/v/0.17.6)
## [0.17.6](https://www.npmjs.com/package/@alkdev/typebox/v/0.17.6)
Changes:

View File

@@ -1,4 +1,4 @@
## [0.18.0](https://www.npmjs.com/package/@sinclair/typebox/v/0.18.0)
## [0.18.0](https://www.npmjs.com/package/@alkdev/typebox/v/0.18.0)
Changes:
@@ -14,7 +14,7 @@ TypeBox now targets JSON schema draft `2019-09` for expressing `Type.Intersect(.
TypeBox has deprecated `Type.Dict(...)` in favor of the more generic `Type.Record(...)`. Where as `Type.Dict(...)` was previously expressed with `additionalProperties: { ... }`, `Type.Record(...)` is expressed with `patternProperties` and supports both `string` and `number` indexer keys. Additionally, `Type.Record(...)` supports string union arguments. This is analogous to TypeScript's utility record type `Record<'a' | 'b' | 'c', T>`.
## [0.17.7](https://www.npmjs.com/package/@sinclair/typebox/v/0.17.7)
## [0.17.7](https://www.npmjs.com/package/@alkdev/typebox/v/0.17.7)
Changes:

View File

@@ -1,4 +1,4 @@
## [0.18.1](https://www.npmjs.com/package/@sinclair/typebox/v/0.18.1)
## [0.18.1](https://www.npmjs.com/package/@alkdev/typebox/v/0.18.1)
- Function `Type.Enum(...)` now expressed with `anyOf`. This to remove the `allowUnionTypes` configuration required to use `enum` with in AJV strict.
- Function `Type.Rec(...)` now takes a required `$id` as the first parameter.

View File

@@ -1,4 +1,4 @@
## [0.19.0](https://www.npmjs.com/package/@sinclair/typebox/v/0.19.0)
## [0.19.0](https://www.npmjs.com/package/@alkdev/typebox/v/0.19.0)
Updates:

View File

@@ -1,4 +1,4 @@
## [0.20.0](https://www.npmjs.com/package/@sinclair/typebox/v/0.20.0)
## [0.20.0](https://www.npmjs.com/package/@alkdev/typebox/v/0.20.0)
Updates:

View File

@@ -1,4 +1,4 @@
## [0.20.1](https://www.npmjs.com/package/@sinclair/typebox/v/0.20.1)
## [0.20.1](https://www.npmjs.com/package/@alkdev/typebox/v/0.20.1)
Updates:

View File

@@ -1,4 +1,4 @@
## [0.21.0](https://www.npmjs.com/package/@sinclair/typebox/v/0.21.0)
## [0.21.0](https://www.npmjs.com/package/@alkdev/typebox/v/0.21.0)
Updates:

View File

@@ -1,4 +1,4 @@
## [0.21.2](https://www.npmjs.com/package/@sinclair/typebox/v/0.21.2)
## [0.21.2](https://www.npmjs.com/package/@alkdev/typebox/v/0.21.2)
Updates:

View File

@@ -1,4 +1,4 @@
## [0.22.0](https://www.npmjs.com/package/@sinclair/typebox/v/0.22.0)
## [0.22.0](https://www.npmjs.com/package/@alkdev/typebox/v/0.22.0)
Updates:

View File

@@ -1,4 +1,4 @@
## [0.23.0](https://www.npmjs.com/package/@sinclair/typebox/v/0.23.0)
## [0.23.0](https://www.npmjs.com/package/@alkdev/typebox/v/0.23.0)
Updates:

View File

@@ -1,4 +1,4 @@
## [0.23.1](https://www.npmjs.com/package/@sinclair/typebox/v/0.23.1)
## [0.23.1](https://www.npmjs.com/package/@alkdev/typebox/v/0.23.1)
Updates:

View File

@@ -1,4 +1,4 @@
## [0.23.3](https://www.npmjs.com/package/@sinclair/typebox/v/0.23.3)
## [0.23.3](https://www.npmjs.com/package/@alkdev/typebox/v/0.23.3)
Updates:

View File

@@ -1,4 +1,4 @@
## [0.24.0](https://www.npmjs.com/package/@sinclair/typebox/v/0.24.0)
## [0.24.0](https://www.npmjs.com/package/@alkdev/typebox/v/0.24.0)
Changes:

View File

@@ -1,4 +1,4 @@
## [0.24.15](https://www.npmjs.com/package/@sinclair/typebox/v/0.24.15)
## [0.24.15](https://www.npmjs.com/package/@alkdev/typebox/v/0.24.15)
Added:
- `Conditional.Extends(...)` This enables TypeBox to conditionally map types inline with TypeScripts structural equivalence checks. Tested against TypeScript 4.7.4.

View File

@@ -1,4 +1,4 @@
## [0.24.44](https://www.npmjs.com/package/@sinclair/typebox/v/0.24.44)
## [0.24.44](https://www.npmjs.com/package/@alkdev/typebox/v/0.24.44)
Updates:
- [189](https://github.com/sinclairzx81/typebox/pull/189) Both `Value.Error(T, value)` and `TypeCheck.Error(value)` now return an iterator for validation errors.

View File

@@ -1,4 +1,4 @@
## [0.24.49](https://www.npmjs.com/package/@sinclair/typebox/v/0.24.49)
## [0.24.49](https://www.npmjs.com/package/@alkdev/typebox/v/0.24.49)
Updates:

View File

@@ -1,13 +1,13 @@
## [0.24.6](https://www.npmjs.com/package/@sinclair/typebox/v/0.24.6)
## [0.24.6](https://www.npmjs.com/package/@alkdev/typebox/v/0.24.6)
Added:
- TypeBox now offers a `TypeGuard` module for structurally checking TypeBox schematics. This module can be used in runtime type reflection scenarios where it's helpful to test a schema is of a particular form. This module can be imported under the `@sinclair/typebox/guard` import path.
- TypeBox now offers a `TypeGuard` module for structurally checking TypeBox schematics. This module can be used in runtime type reflection scenarios where it's helpful to test a schema is of a particular form. This module can be imported under the `@alkdev/typebox/guard` import path.
Example:
```typescript
import { TypeGuard } from '@sinclair/typebox/guard'
import { TypeGuard } from '@alkdev/typebox/guard'
const T: any = {} // T is any

View File

@@ -1,4 +1,4 @@
## [0.24.8](https://www.npmjs.com/package/@sinclair/typebox/v/0.24.8)
## [0.24.8](https://www.npmjs.com/package/@alkdev/typebox/v/0.24.8)
Added:
- `Value.Cast(T, value)` structurally casts a value into another form while retaining information within the original value.

View File

@@ -1,4 +1,4 @@
## [0.25.0](https://www.npmjs.com/package/@sinclair/typebox/v/0.25.0)
## [0.25.0](https://www.npmjs.com/package/@alkdev/typebox/v/0.25.0)
Updates:

View File

@@ -1,4 +1,4 @@
## [0.25.10](https://www.npmjs.com/package/@sinclair/typebox/v/0.25.10)
## [0.25.10](https://www.npmjs.com/package/@alkdev/typebox/v/0.25.10)
Updates:

View File

@@ -1,4 +1,4 @@
## [0.25.11](https://www.npmjs.com/package/@sinclair/typebox/v/0.25.11)
## [0.25.11](https://www.npmjs.com/package/@alkdev/typebox/v/0.25.11)
Updates:

View File

@@ -1,4 +1,4 @@
## [0.25.18](https://www.npmjs.com/package/@sinclair/typebox/v/0.25.18)
## [0.25.18](https://www.npmjs.com/package/@alkdev/typebox/v/0.25.18)
Updates:

View File

@@ -1,4 +1,4 @@
## [0.25.22](https://www.npmjs.com/package/@sinclair/typebox/v/0.25.22)
## [0.25.22](https://www.npmjs.com/package/@alkdev/typebox/v/0.25.22)
Updates:

View File

@@ -1,4 +1,4 @@
## [0.25.23](https://www.npmjs.com/package/@sinclair/typebox/v/0.25.23)
## [0.25.23](https://www.npmjs.com/package/@alkdev/typebox/v/0.25.23)
Updates:

View File

@@ -1,4 +1,4 @@
## [0.25.24](https://www.npmjs.com/package/@sinclair/typebox/v/0.25.23)
## [0.25.24](https://www.npmjs.com/package/@alkdev/typebox/v/0.25.23)
Updates:

View File

@@ -1,4 +1,4 @@
## [0.25.9](https://www.npmjs.com/package/@sinclair/typebox/v/0.25.9)
## [0.25.9](https://www.npmjs.com/package/@alkdev/typebox/v/0.25.9)
Updates:

View File

@@ -1,4 +1,4 @@
## [0.26.0](https://www.npmjs.com/package/@sinclair/typebox/v/0.26.0)
## [0.26.0](https://www.npmjs.com/package/@alkdev/typebox/v/0.26.0)
## Overview
@@ -36,7 +36,7 @@ Revision 0.26.0 is a milestone release for the TypeBox project and requires a mi
Revision 0.26.0 exports a new type builder called `StandardType`. This builder only allows for the construction JSON Schema compliant types by omitting all Extended types.
```typescript
import { StandardType as Type, Static } from '@sinclair/typebox'
import { StandardType as Type, Static } from '@alkdev/typebox'
const T = Type.Date() // error: no such function
```
@@ -172,7 +172,7 @@ const All = [...Value.Errors(T, 'foo')] // const All = [{ path: '',
Revision 0.26.0 adds a `.Code()` function to the `TypeCompiler` to enable code generation without JIT evaluation.
```typescript
import { TypeCompiler } from '@sinclair/typebox/compiler'
import { TypeCompiler } from '@alkdev/typebox/compiler'
const T = Type.Object({
x: Type.Number(),
@@ -361,12 +361,12 @@ const V = Value.Cast(T, Value.Convert(T, '42')) // const V = 42 - 0.26.0
## Moved TypeGuard Module
The `TypeGuard` is now imported via the `@sinclair/typebox` module. This move is due to the TypeBox compositor internally using the guard when constructing types.
The `TypeGuard` is now imported via the `@alkdev/typebox` module. This move is due to the TypeBox compositor internally using the guard when constructing types.
```typescript
import { TypeGuard } from '@sinclair/typebox/guard' // 0.25.0
import { TypeGuard } from '@alkdev/typebox/guard' // 0.25.0
import { TypeGuard } from '@sinclair/typebox' // 0.26.0
import { TypeGuard } from '@alkdev/typebox' // 0.26.0
```
<a name="Format-Renamed-to-FormatRegistry"></a>
@@ -376,9 +376,9 @@ import { TypeGuard } from '@sinclair/typebox' // 0.26.0
The `Format` module has been renamed to `FormatRegistry` and moved to the `typebox.ts` module.
```typescript
import { Format } from '@sinclair/typebox/format' // 0.25.0
import { Format } from '@alkdev/typebox/format' // 0.25.0
import { FormatRegistry } from '@sinclair/typebox' // 0.26.0
import { FormatRegistry } from '@alkdev/typebox' // 0.26.0
```
<a name="Custom-Renamed-to-TypeRegistry"></a>
@@ -388,7 +388,7 @@ import { FormatRegistry } from '@sinclair/typebox' // 0.26.0
The `Format` module has been renamed to `FormatRegistry` and moved to the `typebox.ts` module.
```typescript
import { Custom } from '@sinclair/typebox/format' // 0.25.0
import { Custom } from '@alkdev/typebox/format' // 0.25.0
import { TypeRegistry } from '@sinclair/typebox' // 0.26.0
import { TypeRegistry } from '@alkdev/typebox' // 0.26.0
```

View File

@@ -1,4 +1,4 @@
## [0.26.2](https://www.npmjs.com/package/@sinclair/typebox/v/0.26.2)
## [0.26.2](https://www.npmjs.com/package/@alkdev/typebox/v/0.26.2)
Updates:

View File

@@ -1,4 +1,4 @@
## [0.27.0](https://www.npmjs.com/package/@sinclair/typebox/v/0.27.0)
## [0.27.0](https://www.npmjs.com/package/@alkdev/typebox/v/0.27.0)
## Overview
@@ -75,7 +75,7 @@ The following generates a 8-bit binary sequence for the given expression.
```typescript
import { TemplateLiteralParser, TemplateLiteralGenerator, TemplateLiteralFinite } from '@sinclair/typebox'
import { TemplateLiteralParser, TemplateLiteralGenerator, TemplateLiteralFinite } from '@alkdev/typebox'
const Bit = `(0|1)` // bit union
const Byte = `${Bit}${Bit}${Bit}${Bit}${Bit}${Bit}${Bit}${Bit}` // byte sequence

View File

@@ -1,4 +1,4 @@
## [0.27.1](https://www.npmjs.com/package/@sinclair/typebox/v/0.27.1)
## [0.27.1](https://www.npmjs.com/package/@alkdev/typebox/v/0.27.1)
## Updates

View File

@@ -1,4 +1,4 @@
## [0.28.0](https://www.npmjs.com/package/@sinclair/typebox/v/0.28.0)
## [0.28.0](https://www.npmjs.com/package/@alkdev/typebox/v/0.28.0)
## Overview

View File

@@ -1,4 +1,4 @@
## [0.28.3](https://www.npmjs.com/package/@sinclair/typebox/v/0.28.3)
## [0.28.3](https://www.npmjs.com/package/@alkdev/typebox/v/0.28.3)
## Overview

View File

@@ -1,4 +1,4 @@
## [0.29.0](https://www.npmjs.com/package/@sinclair/typebox/v/0.29.0)
## [0.29.0](https://www.npmjs.com/package/@alkdev/typebox/v/0.29.0)
## Overview

View File

@@ -1,4 +1,4 @@
## [0.29.2](https://www.npmjs.com/package/@sinclair/typebox/v/0.29.2)
## [0.29.2](https://www.npmjs.com/package/@alkdev/typebox/v/0.29.2)
## Overview

View File

@@ -1,4 +1,4 @@
## [0.30.0](https://www.npmjs.com/package/@sinclair/typebox/v/0.30.0)
## [0.30.0](https://www.npmjs.com/package/@alkdev/typebox/v/0.30.0)
## Overview
@@ -151,13 +151,13 @@ The top level `Value.*` namespace will remain on all subsequent versions of Type
```typescript
// Revision 0.29.0
//
import { Value } from '@sinclair/typebox/value' // Value.* namespace
import { Value } from '@alkdev/typebox/value' // Value.* namespace
const A = Value.Create(Type.String())
// Revision 0.30.0
//
import { Create } from '@sinclair/typebox/value/create' // Only Create()
import { Create } from '@alkdev/typebox/value/create' // Only Create()
const A = Create(Type.String())
```
@@ -246,7 +246,7 @@ Revision 0.30.0 offers an external code generation API tool which can be used to
[TypeBox-Code Project](https://github.com/sinclairzx81/typebox-codegen)
```typescript
import * as Codegen from '@sinclair/typebox-codegen'
import * as Codegen from '@alkdev/typebox-codegen'
const Code = Codegen.TypeScriptToTypeBox.Generate(`
type T = { x: number, y: number, z: number }
@@ -256,7 +256,7 @@ console.log(Code)
// Output:
//
// import { Type, Static } from '@sinclair/typebox'
// import { Type, Static } from '@alkdev/typebox'
//
// type T = Static<typeof T>
// const T = Type.Object({
@@ -272,7 +272,7 @@ console.log(Code)
Revision 0.30.0 includes a reference implementation for JSON Type Definition (RFC 8927). This specification is currently under consideration for inclusion in the TypeBox library as an alternative schema representation for nominal type systems. The implementation currently contains all types expressed in the JSON Type Definition spec, but omits constraints such and `minimum` and `maximum` values (which are not formally represented in the specification).
The implementation is offered as a single file which can be copied in to projects with TypeBox installed. This implementation may be enhanced over the next few revisions (with some potential to implement mapping types such as partial, required, omit, pick, keyof). This specification will be considered for inclusion under `@sinclair/typebox/typedef` if there is enough interest.
The implementation is offered as a single file which can be copied in to projects with TypeBox installed. This implementation may be enhanced over the next few revisions (with some potential to implement mapping types such as partial, required, omit, pick, keyof). This specification will be considered for inclusion under `@alkdev/typebox/typedef` if there is enough interest.
```typescript
import { Type } from './typedef' // from: examples/typedef/typedef.ts
@@ -408,7 +408,7 @@ const T = Type.String({ pattern: /abc/.source }) // Standard Type
For Unicode (UTF-16) support on 0.30.0, the recommendation is to continue using user defined formats.
```typescript
import { Type, FormatRegistry } from '@sinclair/typebox'
import { Type, FormatRegistry } from '@alkdev/typebox'
FormatRegistry.Set('emoji', value => /<a?:.+?:\d{18}>|\p{Extended_Pictographic}/gu.test(value))

View File

@@ -1,4 +1,4 @@
## [0.31.0](https://www.npmjs.com/package/@sinclair/typebox/v/0.31.0)
## [0.31.0](https://www.npmjs.com/package/@alkdev/typebox/v/0.31.0)
## Overview
@@ -30,7 +30,7 @@ Revision 0.31.0 includes a new codec system referred to as Transform types. A Tr
The following shows a Transform type which increments and decrements a number.
```typescript
import { Value } from '@sinclair/typebox/value'
import { Value } from '@alkdev/typebox/value'
const T = Type.Transform(Type.Number()) // const T = {
.Decode(value => value + 1) // type: 'number',
@@ -191,14 +191,14 @@ Revision 0.31.0 updates the inference strategy for Record types and generalizes
```typescript
// 0.30.0
//
import { RecordKey, TSchema } from '@sinclair/typebox'
import { RecordKey, TSchema } from '@alkdev/typebox'
function StrictRecord<K extends RecordKey, T extends TSchema>(K: K, T: T) {
return Type.Record(K, T, { additionalProperties: false }) // Error: RecordKey unresolvable to overload
}
// 0.31.0
//
import { TSchema } from '@sinclair/typebox'
import { TSchema } from '@alkdev/typebox'
function StrictRecord<K extends TSchema, T extends TSchema>(K: K, T: T) {
return Type.Record(K, T, { additionalProperties: false }) // Ok: dynamically mapped
@@ -218,8 +218,8 @@ const C = StrictRecord(Type.BigInt(), Type.Null()) // const C: TNeve
Revision 0.31.0 updates all errors thrown by TypeBox to extend the sub type `TypeBoxError`. This can be used to help narrow down the source of errors in `try/catch` blocks.
```typescript
import { Type, TypeBoxError } from '@sinclair/typebox'
import { Value } from '@sinclair/typebox/value'
import { Type, TypeBoxError } from '@alkdev/typebox'
import { Value } from '@alkdev/typebox/value'
try {
const A = Value.Decode(Type.Number(), 'hello')
@@ -237,7 +237,7 @@ try {
Revision 0.31.0 adds functionality to remap error messages with the TypeSystemErrorFunction. This function is invoked whenever a validation error is generated in TypeBox. The following is an example of a custom TypeSystemErrorFunction using some of the messages TypeBox generates by default. TypeBox also provides the DefaultErrorFunction which can be used for fallthrough cases.
```typescript
import { TypeSystemErrorFunction, DefaultErrorFunction } from '@sinclair/typebox/system'
import { TypeSystemErrorFunction, DefaultErrorFunction } from '@alkdev/typebox/system'
// Example CustomErrorFunction
export function CustomErrorFunction(schema: Types.TSchema, errorType: ValueErrorType) {
@@ -317,13 +317,13 @@ Revision 0.31.0 moves the `TypeSystem.Policy` configurations into a new type nam
```typescript
// Revision 0.30.0
//
import { TypeSystem } from '@sinclair/typebox/system'
import { TypeSystem } from '@alkdev/typebox/system'
TypeSystem.AllowNaN = true
// Revision 0.31.0
//
import { TypeSystemPolicy } from '@sinclair/typebox/system'
import { TypeSystemPolicy } from '@alkdev/typebox/system'
TypeSystemPolicy.AllowNaN = true

View File

@@ -39,7 +39,7 @@
- [Revision 0.32.1](https://github.com/sinclairzx81/typebox/pull/701) Specify default exports for Web Pack
## [0.32.0](https://www.npmjs.com/package/@sinclair/typebox/v/0.32.0)
## [0.32.0](https://www.npmjs.com/package/@alkdev/typebox/v/0.32.0)
## Overview
@@ -79,9 +79,9 @@ This revision is a milestone revision for the TypeBox project. It has several br
Revision 0.32.0 adds the ability to import types individually.
```typescript
import { Type, type Static } from '@sinclair/typebox' // classic - 37.0 kb minified
import { Type, type Static } from '@alkdev/typebox' // classic - 37.0 kb minified
import { Object, String, Number, type Static } from '@sinclair/typebox' // selective - 6.5 kb minified
import { Object, String, Number, type Static } from '@alkdev/typebox' // selective - 6.5 kb minified
```
<a name="Value-Function-Imports"></a>
@@ -91,9 +91,9 @@ import { Object, String, Number, type Static } from '@sinclair/typebox' // selec
Revision 0.32.0 adds the ability to import value functions from the `/value` module path.
```typescript
import { Value } from '@sinclair/typebox/value' // classic - 61.5 kb minified
import { Value } from '@alkdev/typebox/value' // classic - 61.5 kb minified
import { Check } from '@sinclair/typebox/value' // selective - 18.2 kb minified
import { Check } from '@alkdev/typebox/value' // selective - 18.2 kb minified
```
### CommonJS and ESM
@@ -383,7 +383,7 @@ The following shows the changes from 0.31.0 to 0.32.0.
```typescript
// Revision 0.31.0
import { TypeSystemErrorFunction } from '@sinclair/typebox/system'
import { TypeSystemErrorFunction } from '@alkdev/typebox/system'
TypeSystemErrorFunction.Set((schema, errorType) => {
@@ -392,7 +392,7 @@ TypeSystemErrorFunction.Set((schema, errorType) => {
// Revision 0.32.0
import { SetErrorFunction } from '@sinclair/typebox/errors'
import { SetErrorFunction } from '@alkdev/typebox/errors'
SetErrorFunction(({ schema, errorType, path, value }) => { // as destructured object
@@ -416,13 +416,13 @@ Revision 0.32.0 renames the `Optional`, `Required` and `Transform` symbols to `O
```typescript
// Revision 0.31.0
import { Kind, Hint, Optional, Required, Transform } from '@sinclair/typebox' // these are symbols
import { Kind, Hint, Optional, Required, Transform } from '@alkdev/typebox' // these are symbols
// Revision 0.32.0
import {
Kind, Hint, OptionalKind, RequiredKind, TransformKind, // these are symbols
Optional, Required, Transform // these are type imports
} from '@sinclair/typebox'
} from '@alkdev/typebox'
```
<a name="Breaking-TypeGuard-Interface-Change"></a>
@@ -434,13 +434,13 @@ Revision 0.32.0 has a breaking interface change on the TypeGuard utility where t
```typescript
// Revision 0.31.0
import { TypeGuard, Kind } from '@sinclair/typebox'
import { TypeGuard, Kind } from '@alkdev/typebox'
const R = TypeGuard.TString({ ... })
// Revision 0.32.0
import { TypeGuard } from '@sinclair/typebox'
import { TypeGuard } from '@alkdev/typebox'
const R = TypeGuard.IsString({ ... })
```
@@ -454,11 +454,11 @@ The value submodule function import paths are unfortunately no longer supported.
```typescript
// Revision 0.31.0
import { Check } from '@sinclair/typebox/value/check'
import { Check } from '@alkdev/typebox/value/check'
// Revision 0.32.0
import { Check } from '@sinclair/typebox/value'
import { Check } from '@alkdev/typebox/value'
```
<a name="Breaking-Error-Function"></a>
@@ -470,7 +470,7 @@ The TypeSystemErrorFunction has been replaced with SetErrorFunction which can be
```typescript
// Revision 0.31.0
import { TypeSystemErrorFunction, ValueErrorType, DefaultErrorFunction } from '@sinclair/typebox/system'
import { TypeSystemErrorFunction, ValueErrorType, DefaultErrorFunction } from '@alkdev/typebox/system'
TypeSystemErrorFunction.Set((schema, errorType) => { // i18n override
switch(errorType) {
@@ -483,7 +483,7 @@ TypeSystemErrorFunction.Set((schema, errorType) => { // i18n override
// Revision 0.32.0
import { SetErrorFunction, ValueErrorType, DefaultErrorFunction } from '@sinclair/typebox/errors'
import { SetErrorFunction, ValueErrorType, DefaultErrorFunction } from '@alkdev/typebox/errors'
SetErrorFunction((error) => { // i18n override
switch(error.errorType) {

View File

@@ -3,7 +3,21 @@
---
### Revision Updates
- [Revision 0.34.42](https://github.com/sinclairzx81/typebox/pull/1310)
- [Revision 0.34.49](https://github.com/sinclairzx81/sinclair-typebox/pull/11)
- Documentation Update - Link to 1.x. Updates in support of non-legacy 1.x compiler backport.
- [Revision 0.34.48](https://github.com/sinclairzx81/sinclair-typebox/pull/6)
- Support Sparse Array Validation
- [Revision 0.34.47](https://github.com/sinclairzx81/sinclair-typebox/pull/5)
- Annual License Update
- [Revision 0.34.46](https://github.com/sinclairzx81/sinclair-typebox/pull/4)
- Ensure TObject Instances remain Covariant with TObject Types.
- [Revision 0.34.45](https://github.com/sinclairzx81/sinclair-typebox/pull/2)
- Documentation Update - Resolve Readme Assets to Sinclair TypeBox Repository.
- [Revision 0.34.44](https://github.com/sinclairzx81/sinclair-typebox/pull/2)
- Documentation Update - Rename Project to TypeBox 0.34.x
- [Revision 0.34.43](https://github.com/sinclairzx81/sinclair-typebox/pull/1)
- Configure Package Homepage to refer to Sinclair TypeBox Repository.
- [Revision 0.34.42](https://github.com/sinclairzx81/sinclair-typebox)
- Enable Forward Type Inference Compatibility with TypeBox V1
- [Revision 0.34.41](https://github.com/sinclairzx81/typebox/pull/1310)
- Disable Node10 Module Resolution | TS7 Deprecation Warning.
@@ -93,7 +107,7 @@
- [Revision 0.34.1](https://github.com/sinclairzx81/typebox/pull/1080)
- Implement Computed Type Deref in Modules
## [0.34.0](https://www.npmjs.com/package/@sinclair/typebox/v/0.34.0)
## [0.34.0](https://www.npmjs.com/package/@alkdev/typebox/v/0.34.0)
## Overview
@@ -163,10 +177,10 @@ Revision 0.34.0 introduces a new submodule for parsing TypeScript syntax directl
As of 0.34.0, Syntax Types are available as an opt-in feature, with the parsing infrastructure adding approximately 10kb (minified) to the existing type builder. With further optimizations, this feature may be elevated to a top-level import in future updates to minimize bundling size.
To use Syntax Types, import them from the `@sinclair/typebox/syntax` path.
To use Syntax Types, import them from the `@alkdev/typebox/syntax` path.
```typescript
import { Parse } from '@sinclair/typebox/syntax'
import { Parse } from '@alkdev/typebox/syntax'
// All primitive types are supported

108
docs/benchmark.md Normal file
View File

@@ -0,0 +1,108 @@
[Home](./readme.md) | [Installation](./installation.md) | [Usage](./usage.md) | [Types](./types/) | [Values](./values/) | [Syntax](./syntax/) | [TypeRegistry](./type-registry.md) | [TypeCheck](./type-check.md)
# Benchmark
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.12.0 running on Node 20.10.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.
```typescript
(index) Iterations Ajv TypeCompiler Performance
Literal_String 1000 ' 211 ms' ' 8 ms' ' 26.38 x'
Literal_Number 1000 ' 185 ms' ' 5 ms' ' 37.00 x'
Literal_Boolean 1000 ' 195 ms' ' 4 ms' ' 48.75 x'
Primitive_Number 1000 ' 149 ms' ' 7 ms' ' 21.29 x'
Primitive_String 1000 ' 135 ms' ' 5 ms' ' 27.00 x'
Primitive_String_Pattern 1000 ' 193 ms' ' 10 ms' ' 19.30 x'
Primitive_Boolean 1000 ' 152 ms' ' 4 ms' ' 38.00 x'
Primitive_Null 1000 ' 147 ms' ' 4 ms' ' 36.75 x'
Object_Unconstrained 1000 ' 1065 ms' ' 26 ms' ' 40.96 x'
Object_Constrained 1000 ' 1183 ms' ' 26 ms' ' 45.50 x'
Object_Vector3 1000 ' 407 ms' ' 9 ms' ' 45.22 x'
Object_Box3D 1000 ' 1777 ms' ' 24 ms' ' 74.04 x'
Tuple_Primitive 1000 ' 485 ms' ' 11 ms' ' 44.09 x'
Tuple_Object 1000 ' 1344 ms' ' 17 ms' ' 79.06 x'
Composite_Intersect 1000 ' 606 ms' ' 14 ms' ' 43.29 x'
Composite_Union 1000 ' 522 ms' ' 17 ms' ' 30.71 x'
Math_Vector4 1000 ' 851 ms' ' 9 ms' ' 94.56 x'
Math_Matrix4 1000 ' 406 ms' ' 10 ms' ' 40.60 x'
Array_Primitive_Number 1000 ' 367 ms' ' 6 ms' ' 61.17 x'
Array_Primitive_String 1000 ' 339 ms' ' 7 ms' ' 48.43 x'
Array_Primitive_Boolean 1000 ' 325 ms' ' 5 ms' ' 65.00 x'
Array_Object_Unconstrained 1000 ' 1863 ms' ' 21 ms' ' 88.71 x'
Array_Object_Constrained 1000 ' 1535 ms' ' 18 ms' ' 85.28 x'
Array_Tuple_Primitive 1000 ' 829 ms' ' 14 ms' ' 59.21 x'
Array_Tuple_Object 1000 ' 1674 ms' ' 14 ms' ' 119.57 x'
Array_Composite_Intersect 1000 ' 789 ms' ' 13 ms' ' 60.69 x'
Array_Composite_Union 1000 ' 822 ms' ' 15 ms' ' 54.80 x'
Array_Math_Vector4 1000 ' 1129 ms' ' 14 ms' ' 80.64 x'
Array_Math_Matrix4 1000 ' 673 ms' ' 9 ms' ' 74.78 x'
```
## Validate
This benchmark measures validation performance for varying types.
```typescript
(index) Iterations ValueCheck Ajv TypeCompiler Performance
Literal_String 1000000 ' 17 ms' ' 5 ms' ' 5 ms' ' 1.00 x'
Literal_Number 1000000 ' 14 ms' ' 18 ms' ' 9 ms' ' 2.00 x'
Literal_Boolean 1000000 ' 14 ms' ' 20 ms' ' 9 ms' ' 2.22 x'
Primitive_Number 1000000 ' 17 ms' ' 19 ms' ' 9 ms' ' 2.11 x'
Primitive_String 1000000 ' 17 ms' ' 18 ms' ' 10 ms' ' 1.80 x'
Primitive_String_Pattern 1000000 ' 172 ms' ' 46 ms' ' 41 ms' ' 1.12 x'
Primitive_Boolean 1000000 ' 14 ms' ' 19 ms' ' 10 ms' ' 1.90 x'
Primitive_Null 1000000 ' 16 ms' ' 19 ms' ' 9 ms' ' 2.11 x'
Object_Unconstrained 1000000 ' 437 ms' ' 28 ms' ' 14 ms' ' 2.00 x'
Object_Constrained 1000000 ' 653 ms' ' 46 ms' ' 37 ms' ' 1.24 x'
Object_Vector3 1000000 ' 201 ms' ' 22 ms' ' 12 ms' ' 1.83 x'
Object_Box3D 1000000 ' 961 ms' ' 37 ms' ' 19 ms' ' 1.95 x'
Object_Recursive 1000000 ' 3715 ms' ' 363 ms' ' 174 ms' ' 2.09 x'
Tuple_Primitive 1000000 ' 107 ms' ' 23 ms' ' 11 ms' ' 2.09 x'
Tuple_Object 1000000 ' 375 ms' ' 28 ms' ' 15 ms' ' 1.87 x'
Composite_Intersect 1000000 ' 377 ms' ' 22 ms' ' 12 ms' ' 1.83 x'
Composite_Union 1000000 ' 337 ms' ' 30 ms' ' 17 ms' ' 1.76 x'
Math_Vector4 1000000 ' 137 ms' ' 23 ms' ' 11 ms' ' 2.09 x'
Math_Matrix4 1000000 ' 576 ms' ' 37 ms' ' 28 ms' ' 1.32 x'
Array_Primitive_Number 1000000 ' 145 ms' ' 23 ms' ' 12 ms' ' 1.92 x'
Array_Primitive_String 1000000 ' 152 ms' ' 22 ms' ' 13 ms' ' 1.69 x'
Array_Primitive_Boolean 1000000 ' 131 ms' ' 20 ms' ' 13 ms' ' 1.54 x'
Array_Object_Unconstrained 1000000 ' 2821 ms' ' 62 ms' ' 45 ms' ' 1.38 x'
Array_Object_Constrained 1000000 ' 2958 ms' ' 119 ms' ' 134 ms' ' 0.89 x'
Array_Object_Recursive 1000000 ' 14695 ms' ' 1621 ms' ' 635 ms' ' 2.55 x'
Array_Tuple_Primitive 1000000 ' 478 ms' ' 35 ms' ' 28 ms' ' 1.25 x'
Array_Tuple_Object 1000000 ' 1623 ms' ' 63 ms' ' 48 ms' ' 1.31 x'
Array_Composite_Intersect 1000000 ' 1582 ms' ' 43 ms' ' 30 ms' ' 1.43 x'
Array_Composite_Union 1000000 ' 1331 ms' ' 76 ms' ' 40 ms' ' 1.90 x'
Array_Math_Vector4 1000000 ' 564 ms' ' 38 ms' ' 24 ms' ' 1.58 x'
Array_Math_Matrix4 1000000 ' 2382 ms' ' 111 ms' ' 83 ms' ' 1.34 x'
```
## Compression
The following table lists esbuild compiled and minified sizes for each TypeBox module.
```typescript
(index) Compiled Minified Compression
typebox/compiler '122.4 kb' ' 53.4 kb' '2.29 x'
typebox/errors ' 67.6 kb' ' 29.6 kb' '2.28 x'
typebox/syntax '132.9 kb' ' 54.2 kb' '2.45 x'
typebox/system ' 7.4 kb' ' 3.2 kb' '2.33 x'
typebox/value '150.1 kb' ' 62.2 kb' '2.41 x'
typebox '106.8 kb' ' 43.2 kb' '2.47 x'
```
Back to [Home](../readme.md)

7
docs/contributing.md Normal file
View File

@@ -0,0 +1,7 @@
[Home](./readme.md) | [Installation](./installation.md) | [Usage](./usage.md) | [Types](./types/) | [Values](./values/) | [Syntax](./syntax) | [TypeRegistry](./type-registry.md) | [TypeCheck](./type-check.md)
# Contributing
TypeBox is open to community contribution. Please ensure you submit an open issue before submitting your pull request. The TypeBox project prefers open community discussion before accepting new features.
Back to [Home](../readme.md)

34
docs/ecosystem.md Normal file
View File

@@ -0,0 +1,34 @@
[Home](../readme.md) | [Installation](./installation.md) | [Usage](./usage.md) | [Types](./types/) | [Values](./values/) | [Syntax](./syntax/) | [TypeRegistry](./type-registry.md) | [TypeCheck](./type-check.md)
# Ecosystem
The following is a list of community packages that offer general tooling, extended functionality and framework integration support for TypeBox.
| Package | Description |
| -------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| [drizzle-typebox](https://www.npmjs.com/package/drizzle-typebox) | Generates TypeBox types from Drizzle ORM schemas |
| [elysia](https://github.com/elysiajs/elysia) | Fast and friendly Bun web framework |
| [fastify-type-provider-typebox](https://github.com/fastify/fastify-type-provider-typebox) | Fastify TypeBox integration with the Fastify Type Provider |
| [feathersjs](https://github.com/feathersjs/feathers) | The API and real-time application framework |
| [fetch-typebox](https://github.com/erfanium/fetch-typebox) | Drop-in replacement for fetch that brings easy integration with TypeBox |
| [@lonli-lokli/fetcher-typebox](https://github.com/Lonli-Lokli/fetcher-ts/tree/master/packages/fetcher-typebox) | A strongly-typed fetch wrapper for TypeScript applications with optional runtime validation using TypeBox |
| [h3-typebox](https://github.com/kevinmarrec/h3-typebox) | Schema validation utilities for h3 using TypeBox & Ajv |
| [http-wizard](https://github.com/flodlc/http-wizard) | Type safe http client library for Fastify |
| [json2typebox](https://github.com/hacxy/json2typebox) | Creating TypeBox code from Json Data |
| [nominal-typebox](https://github.com/Coder-Spirit/nominal/tree/main/%40coderspirit/nominal-typebox) | Allows devs to integrate nominal types into TypeBox schemas |
| [openapi-box](https://github.com/geut/openapi-box) | Generate TypeBox types from OpenApi IDL + Http client library |
| [prismabox](https://github.com/m1212e/prismabox) | Converts a prisma.schema to TypeBox schema matching the database models |
| [schema2typebox](https://github.com/xddq/schema2typebox) | Creating TypeBox code from Json Schemas |
| [sveltekit-superforms](https://github.com/ciscoheat/sveltekit-superforms) | A comprehensive SvelteKit form library for server and client validation |
| [ts2typebox](https://github.com/xddq/ts2typebox) | Creating TypeBox code from Typescript types |
| [typebox-cli](https://github.com/gsuess/typebox-cli) | Generate Schema with TypeBox from the CLI |
| [typebox-form-parser](https://github.com/jtlapp/typebox-form-parser) | Parses form and query data based on TypeBox schemas |
| [typebox-schema-faker](https://github.com/iam-medvedev/typebox-schema-faker) | Generate fake data from TypeBox schemas for testing, prototyping and development |
## TypeBox Codegen
TypeBox provides a code generation library that can be integrated into toolchains to automate type translation between TypeScript and TypeBox. This library also includes functionality to transform TypeScript types to other ecosystem libraries.
[@alkdev/typebox-codegen](https://git.alk.dev/alkdev/typebox-codegen)
Back to [Home](../readme.md)

60
docs/error-function.md Normal file
View File

@@ -0,0 +1,60 @@
[Home](./readme.md) | [Installation](./installation.md) | [Usage](./usage.md) | [Types](./types/) | [Values](./values/) | [Syntax](./syntax/) | [TypeRegistry](./type-registry.md) | [TypeCheck](./type-check.md)
# Error Function
Error messages in TypeBox can be customized by defining an ErrorFunction. This function allows for the localization of error messages as well as enabling custom error messages for custom types. By default, TypeBox will generate messages using the `en-US` locale. To support additional locales, you can replicate the function found in `src/errors/function.ts` and create a locale specific translation. The function can then be set via SetErrorFunction.
The following example shows an inline error function that intercepts errors for String, Number and Boolean only. The DefaultErrorFunction is used to return a default error message.
```typescript
import {
SetErrorFunction,
DefaultErrorFunction,
ValueErrorType,
} from "@alkdev/typebox/errors";
SetErrorFunction((error) => {
// i18n override
switch (error.errorType) {
/* en-US */ case ValueErrorType.String:
return "Expected string";
/* fr-FR */ case ValueErrorType.Number:
return "Nombre attendu";
/* ko-KR */ case ValueErrorType.Boolean:
return "예상 부울";
/* en-US */ default:
return DefaultErrorFunction(error);
}
});
const T = Type.Object({
// const T: TObject<{
x: Type.String(), // TString,
y: Type.Number(), // TNumber,
z: Type.Boolean(), // TBoolean
}); // }>
const E = [
...Value.Errors(T, {
// const E = [{
x: null, // type: 48,
y: null, // schema: { ... },
z: null, // path: '/x',
}),
]; // value: null,
// message: 'Expected string'
// }, {
// type: 34,
// schema: { ... },
// path: '/y',
// value: null,
// message: 'Nombre attendu'
// }, {
// type: 14,
// schema: { ... },
// path: '/z',
// value: null,
// message: '예상 부울'
// }]
```
Back to [Home](../readme.md)

9
docs/installation.md Normal file
View File

@@ -0,0 +1,9 @@
# Installation
```bash
$ npm install @alkdev/typebox
```
---
[Back to Home](../readme.md)

29
docs/syntax/create.md Normal file
View File

@@ -0,0 +1,29 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | [Values](../values/) | **Syntax** | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Create
TypeBox provides experimental support for parsing TypeScript annotation syntax into TypeBox types.
This feature is provided via optional import.
```typescript
import { Syntax } from "@alkdev/typebox/syntax";
```
## Create
Use the Syntax function to create TypeBox types from TypeScript syntax ([Example](https://www.typescriptlang.org/play/?moduleResolution=99&module=199&ts=5.8.0-beta#code/JYWwDg9gTgLgBAbzgZQJ4DsYEMAecC+cAZlBCHAOQACAzsOgMYA2WwUA9DKmAKYBGEHOxoZsOCgChQkWIhTYYwBgWKly1OoxZtO3foMkSGEdDXgAVOAF4Uo3AAoABkhwAuOOgCuIPjygAaOFR3Lx8-AkcASjgY2Jj2djhjUwt3cwB5PgArHgYYAB4ECTiS0rLyisrYhNi3OHMAOW9fAOKq9o7OuBqY4PqmsKg2rpHR+MT8AD4JCS5eeut5LEUGfLmeCCJ6ybHKmvWFmyLdk86euDrQlv9h07uy876rv1v7t-GCIA))
```typescript
const T = Syntax(`{ x: number, y: number }`); // const T: TObject<{
// x: TNumber,
// y: TNumber
// }>
type T = Static<typeof T>; // type T = {
// x: number,
// y: number
// }
```
Back to [Home](../../readme.md)

30
docs/syntax/generics.md Normal file
View File

@@ -0,0 +1,30 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | [Values](../values/) | **Syntax** | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Generics
Syntax types support generic parameters in the following way ([Example](https://www.typescriptlang.org/play/?moduleResolution=99&module=199&ts=5.8.0-beta#code/JYWwDg9gTgLgBAbzgZQJ4DsYEMAecC+cAZlBCHAOQACAzsOgMYA2WwUA9DKmAKYBGEHOxoZsOCgChQkWIhTYYwBgWKly1OoxZtO3foMkSGEdDXgA1HgxjQ4AXhSjcACgAGAHgAaAGjgBNXwAtAD45CTg4HAAuOB84cLhUGID4iIAvGMD4-FcASgkjEzM4ACEsOhpLa2gae0dMFyQqmygCX1cEBOi4Zuh3AEZfAAZh4O8EpJ6rFvcRuEG4IbGEjKnqqFnh337lnPyJLl5S8uBK6Zq65AUld0OeCCJjit6oGlCIiPZ2ODun05fag5Oh8QaCweCIZCoV8Pt0kN0FpM5qshm0ElCMZisSCYRFJvCYnNJgsUWjseSKeDcXBVgTFr4kb5Vv0COjKezsTD8EA))
```typescript
const Vector = Syntax(`<X, Y, Z> {
x: X,
y: Y,
z: Z
}`);
const BasisVectors = Syntax(
{ Vector },
`{
x: Vector<1, 0, 0>,
y: Vector<0, 1, 0>,
z: Vector<0, 0, 1>,
}`
);
type BasisVectors = Static<typeof BasisVectors>; // type BasisVectors = {
// x: { x: 1, y: 0, z: 0 },
// y: { x: 0, y: 1, z: 0 },
// z: { x: 0, y: 0, z: 1 }
// }
```
Back to [Home](../../readme.md)

18
docs/syntax/noinfer.md Normal file
View File

@@ -0,0 +1,18 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | [Values](../values/) | **Syntax** | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# NoInfer
Syntax parsing is an expensive type level operation and can impact on language service performance. Use the NoInfer function parse syntax at runtime only.
```typescript
import { NoInfer } from "@alkdev/typebox/syntax";
const T = NoInfer(`number | string`); // const T: TSchema = {
// anyOf: [
// { type: 'number' },
// { type: 'string' }
// ]
// }
```
Back to [Home](../../readme.md)

14
docs/syntax/options.md Normal file
View File

@@ -0,0 +1,14 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | [Values](../values/) | **Syntax** | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Options
Options can be passed via the last parameter.
```typescript
const T = Syntax(`number`, { minimum: 42 }); // const T = {
// type: 'number',
// minimum: 42
// }
```
Back to [Home](../../readme.md)

19
docs/syntax/parameters.md Normal file
View File

@@ -0,0 +1,19 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | [Values](../values/) | **Syntax** | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Parameters
Syntax types can be parameterized to receive exterior types ([Example](https://www.typescriptlang.org/play/?moduleResolution=99&module=199&ts=5.8.0-beta#code/JYWwDg9gTgLgBAbzgZQJ4DsYEMAecC+cAZlBCHAOQACAzsOgMYA2WwUA9DKmAKYBGEHOxoZsOCgCgJDCOhrwAKnAC8KUbgAUAAyQ4AXHHQBXEHx5QANHFQHjp8wS0BKOK7ev27ODLmKDCgHk+ACseBhgAHgQJd1i4+ITEpLdPN304BQA5EzNLGOSCwqK4VNcbDOz7KHzi2rqPL3wAPikfeRQVNUxNJCV8Ky0ABSxYYCwmCIUm52LUtvhkfyDQ8Kia+o2C0rh0wLAYYFlxycrcpot1zav47fK9g6OJrJzzFuv3m8amoA))
```typescript
const T = Syntax(`{ x: number, y: number }`); // const T: TObject<{
// x: TNumber,
// y: TNumber
// }>
const S = Syntax({ T }, `Partial<T>`); // const S: TObject<{
// x: TOptional<TNumber>,
// y: TOptional<TNumber>
// }>
```
Back to [Home](../../readme.md)

126
docs/type-check.md Normal file
View File

@@ -0,0 +1,126 @@
[Home](./readme.md) | [Installation](./installation.md) | [Usage](./usage.md) | [Types](./types/) | [Values](./values/) | [Syntax](./syntax/) | [TypeRegistry](./type-registry.md) | [TypeCheck](./type-check.md)
# TypeCheck
TypeBox types target Json Schema Draft 7 and are compatible with any validator that supports this specification. TypeBox also provides a built-in type checking compiler designed specifically for TypeBox types that offers high performance compilation and value checking.
The following sections detail using Ajv and the TypeBox compiler infrastructure.
## Ajv
The following shows the recommended setup for Ajv.
```bash
$ npm install ajv ajv-formats --save
```
```typescript
import { Type } from "@alkdev/typebox";
import addFormats from "ajv-formats";
import Ajv from "ajv";
const ajv = addFormats(new Ajv({}), [
"date-time",
"time",
"date",
"email",
"hostname",
"ipv4",
"ipv6",
"uri",
"uri-reference",
"uuid",
"uri-template",
"json-pointer",
"relative-json-pointer",
"regex",
]);
const validate = ajv.compile(
Type.Object({
x: Type.Number(),
y: Type.Number(),
z: Type.Number(),
})
);
const R = validate({ x: 1, y: 2, z: 3 }); // const R = true
```
## TypeCompiler
The TypeBox TypeCompiler is a high performance JIT validation compiler that transforms TypeBox types into optimized JavaScript validation routines. The compiler is tuned for fast compilation as well as fast value assertion. It is built to serve as a validation backend that can be integrated into larger applications. It can also be used for code generation.
The TypeCompiler is provided as an optional import.
```typescript
import { TypeCompiler } from "@alkdev/typebox/compiler";
```
Use the Compile function to JIT compile a type. Note that compilation is generally an expensive operation and should only be performed once per type during application start up. TypeBox does not cache previously compiled types, and applications are expected to hold references to each compiled type for the lifetime of the application.
```typescript
const C = TypeCompiler.Compile(
Type.Object({
// const C: TypeCheck<TObject<{
x: Type.Number(), // x: TNumber;
y: Type.Number(), // y: TNumber;
z: Type.Number(), // z: TNumber;
})
); // }>>
const R = C.Check({ x: 1, y: 2, z: 3 }); // const R = true
```
Use the Errors function to generate diagnostic errors for a value. The Errors function will return an iterator that when enumerated; will perform an exhaustive check across the entire value yielding any error found. For performance, this function should only be called after a failed Check. Applications may also choose to yield only the first value to avoid exhaustive error generation.
```typescript
const C = TypeCompiler.Compile(
Type.Object({
// const C: TypeCheck<TObject<{
x: Type.Number(), // x: TNumber;
y: Type.Number(), // y: TNumber;
z: Type.Number(), // z: TNumber;
})
); // }>>
const value = {};
const first = C.Errors(value).First(); // const first = {
// schema: { type: 'number' },
// path: '/x',
// value: undefined,
// message: 'Expected number'
// }
const all = [...C.Errors(value)]; // const all = [{
// schema: { type: 'number' },
// path: '/x',
// value: undefined,
// message: 'Expected number'
// }, {
// schema: { type: 'number' },
// path: '/y',
// value: undefined,
// message: 'Expected number'
// }, {
// schema: { type: 'number' },
// path: '/z',
// value: undefined,
// message: 'Expected number'
// }]
```
### Code
Use the Code function to generate assertion functions as strings. This function can be used to generate code that can be written to disk as importable modules. This technique is sometimes referred to as Ahead of Time (AOT) compilation. The following generates code to check a string.
```typescript
const C = TypeCompiler.Code(Type.String()); // const C = `return function check(value) {
// return (
// (typeof value === 'string')
// )
// }`
```
Back to [Home](../readme.md)

37
docs/type-map.md Normal file
View File

@@ -0,0 +1,37 @@
[Home](../readme.md) | [Installation](./installation.md) | [Usage](./usage.md) | [Types](./types/) | [Values](./values/) | [Syntax](./syntax/) | [TypeRegistry](./type-registry.md) | [TypeCheck](./type-check.md)
# TypeMap
TypeBox offers an external package for bidirectional mapping between TypeBox, Valibot, and Zod type libraries. It also includes syntax parsing support for Valibot and Zod and supports the Standard Schema specification. For more details on TypeMap, refer to the project repository.
[@alkdev/typemap](https://git.alk.dev/alkdev/typebox)
## Usage
TypeMap needs to be installed separately
```bash
$ npm install @alkdev/typemap
```
Once installed it offers advanced structural remapping between various runtime type libraries ([Example](https://www.typescriptlang.org/play/?moduleResolution=99&module=199&ts=5.8.0-beta#code/JYWwDg9gTgLgBAbzgFQJ5gKYCEIA8A0cAyqgHYwCGBcAWhACZwC+cAZlBCHAOQACAzsFIBjADYVgUAPQx0GEBTDcAUMuERS-eMjgBeFHJy4AFAAMkuAFxxSAVxAAjDFEKprdx88IAvd-adQzKYAlHBwUlJw6pra1sgA8g4AVhjCMAA8CMphObl5+QWFRcW5ETlWKABy-s4A3NkljU3NBWVhblU1UPUtvX3FbXC+nZ7dDf0TE2VMAHyq0VrEesRklCbIoS1lC-BE1twWfqOuRwE+p87MKmoaiwBKy3T0xkTBAHRgFFD8GMZ2oqJNnltrd4HdrFlJltImEKh4Aj0oU1Bh14XVxkiBjChhcxpjGtMwkA))
```typescript
import { TypeBox, Syntax, Zod } from "@alkdev/typemap";
const T = TypeBox(`{ x: number, y: number, z: number }`); // const T: TObject<{
// x: TNumber;
// y: TNumber;
// z: TNumber;
// }>
const S = Syntax(T); // const S: '{ x: number, y: number, z: number }'
const R = Zod(S).parse(null); // const R: {
// x: number;
// y: number;
// z: number;
// }
```
Back to [Home](../readme.md)

39
docs/type-registry.md Normal file
View File

@@ -0,0 +1,39 @@
[Home](./readme.md) | [Installation](./installation.md) | [Usage](./usage.md) | [Types](./types/) | [Values](./values/) | [Syntax](./syntax/) | [TypeRegistry](./type-registry.md) | [TypeCheck](./type-check.md)
# TypeRegistry
The TypeBox type system can be extended with additional types and formats using the TypeRegistry and FormatRegistry modules. These modules integrate deeply with TypeBox's internal type checking infrastructure and can be used to create application specific types, or register schematics for alternative specifications.
## TypeRegistry
Use the TypeRegistry to register a type. The Kind must match the registered type name.
```typescript
import { TSchema, Kind, TypeRegistry } from "@alkdev/typebox";
TypeRegistry.Set("Foo", (schema, value) => value === "foo");
const Foo = { [Kind]: "Foo" } as TSchema;
const A = Value.Check(Foo, "foo"); // const A = true
const B = Value.Check(Foo, "bar"); // const B = false
```
## FormatRegistry
Use the FormatRegistry to register a string format.
```typescript
import { FormatRegistry } from "@alkdev/typebox";
FormatRegistry.Set("foo", (value) => value === "foo");
const T = Type.String({ format: "foo" });
const A = Value.Check(T, "foo"); // const A = true
const B = Value.Check(T, "bar"); // const B = false
```
Back to [Home](../readme.md)

41
docs/type-system.md Normal file
View File

@@ -0,0 +1,41 @@
[Home](./readme.md) | [Installation](./installation.md) | [Usage](./usage.md) | [Types](./types/) | [Values](./values/) | [Syntax](./syntax/) | [TypeRegistry](./type-registry.md) | [TypeCheck](./type-check.md)
# TypeSystem
The TypeBox TypeSystem module provides configurations to use either Json Schema or TypeScript type checking semantics. Configurations made to the TypeSystem module are observed by the TypeCompiler, Value and Error modules.
## Policies
TypeBox validates using standard Json Schema assertion policies by default. The TypeSystemPolicy module can override some of these to have TypeBox assert values inline with TypeScript static checks. It also provides overrides for certain checking rules related to non-serializable values (such as void) which can be helpful in Json based protocols such as Json Rpc 2.0.
The following overrides are available.
```typescript
import { TypeSystemPolicy } from "@alkdev/typebox/system";
// Disallow undefined values for optional properties (default is false)
//
// const A: { x?: number } = { x: undefined } - disallowed when enabled
TypeSystemPolicy.ExactOptionalPropertyTypes = true;
// Allow arrays to validate as object types (default is false)
//
// const A: {} = [] - allowed in TS
TypeSystemPolicy.AllowArrayObject = true;
// Allow numeric values to be NaN or + or - Infinity (default is false)
//
// const A: number = NaN - allowed in TS
TypeSystemPolicy.AllowNaN = true;
// Allow void types to check with undefined and null (default is false)
//
// Used to signal void return on Json-Rpc 2.0 protocol
TypeSystemPolicy.AllowNullVoid = true;
```
Back to [Home](../readme.md)

42
docs/types/conditional.md Normal file
View File

@@ -0,0 +1,42 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | **Types** | [Values](../values/) | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Conditional Types
TypeBox supports runtime conditional types with the Extends function. This function performs a structural assignability check against the first (`left`) and second (`right`) arguments and will return either the third (`true`) or fourth (`false`) argument based on the result. The conditional types Exclude and Extract are also supported. The following shows both TypeScript and TypeBox examples of conditional types.
```typescript
// Extends
const A = Type.Extends(
// type A = string extends number ? 1 : 2
Type.String(), //
Type.Number(), // ... evaluated as
Type.Literal(1), //
Type.Literal(2) // const A: TLiteral<2>
);
// Extract
const B = Type.Extract(
// type B = Extract<1 | 2 | 3, 1>
Type.Union([
//
Type.Literal(1), // ... evaluated as
Type.Literal(2), //
Type.Literal(3), // const B: TLiteral<1>
]),
Type.Literal(1)
);
// Exclude
const C = Type.Exclude(
// type C = Exclude<1 | 2 | 3, 1>
Type.Union([
//
Type.Literal(1), // ... evaluated as
Type.Literal(2), //
Type.Literal(3), // const C: TUnion<[
]), // TLiteral<2>,
Type.Literal(1) // TLiteral<3>,
); // ]>
```
Back to [Home](../../readme.md)

16
docs/types/generics.md Normal file
View File

@@ -0,0 +1,16 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | **Types** | [Values](../values/) | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Generic Types
Generic types can be created with generic functions.
```typescript
const Nullable = <T extends TSchema>(T: T) => {
// type Nullable<T> = T | null
return Type.Union([T, Type.Null()]);
};
const T = Nullable(Type.String()); // type T = Nullable<string>
```
Back to [Home](../../readme.md)

41
docs/types/indexed.md Normal file
View File

@@ -0,0 +1,41 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | **Types** | [Values](../values/) | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Indexed Access Types
TypeBox supports indexed access types with the Index function. This function enables uniform access to interior property and element types without having to extract them from the underlying schema representation. Index types are supported for Object, Array, Tuple, Union and Intersect types.
```typescript
const T = Type.Object({
// type T = {
x: Type.Number(), // x: number,
y: Type.String(), // y: string,
z: Type.Boolean(), // z: boolean
}); // }
const A = Type.Index(T, ["x"]); // type A = T['x']
//
// ... evaluated as
//
// const A: TNumber
const B = Type.Index(T, ["x", "y"]); // type B = T['x' | 'y']
//
// ... evaluated as
//
// const B: TUnion<[
// TNumber,
// TString,
// ]>
const C = Type.Index(T, Type.KeyOf(T)); // type C = T[keyof T]
//
// ... evaluated as
//
// const C: TUnion<[
// TNumber,
// TString,
// TBoolean
// ]>
```
Back to [Home](../../readme.md)

101
docs/types/javascript.md Normal file
View File

@@ -0,0 +1,101 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | **Types** | [Values](../values/) | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# JavaScript Types
TypeBox provides an extended type set that can be used to create schematics for common JavaScript constructs. These types can not be used with any standard Json Schema validator; but can be used to frame schematics for interfaces that may receive Json validated data. JavaScript types are prefixed with the `[JavaScript]` JSDoc comment for convenience. The following table lists the supported types.
```typescript
TypeBox TypeScript Extended Schema
const T = Type.Constructor([ type T = new ( const T = {
Type.String(), arg0: string, type: 'Constructor',
Type.Number() arg0: number parameters: [{
], Type.Boolean()) ) => boolean type: 'string'
}, {
type: 'number'
}],
returns: {
type: 'boolean'
}
}
const T = Type.Function([ type T = ( const T = {
| Type.String(), arg0: string, type: 'Function',
Type.Number() arg1: number parameters: [{
], Type.Boolean()) ) => boolean type: 'string'
}, {
type: 'number'
}],
returns: {
type: 'boolean'
}
}
const T = Type.Promise( type T = Promise<string> const T = {
Type.String() type: 'Promise',
) item: {
type: 'string'
}
}
const T = type T = const T = {
Type.AsyncIterator( AsyncIterableIterator< type: 'AsyncIterator',
Type.String() string items: {
) > type: 'string'
}
}
const T = Type.Iterator( type T = const T = {
Type.String() IterableIterator<string> type: 'Iterator',
) items: {
type: 'string'
}
}
const T = Type.RegExp(/abc/i) type T = string const T = {
type: 'RegExp'
source: 'abc'
flags: 'i'
}
const T = Type.Uint8Array() type T = Uint8Array const T = {
type: 'Uint8Array'
}
const T = Type.Date() type T = Date const T = {
type: 'Date'
}
const T = Type.Undefined() type T = undefined const T = {
type: 'undefined'
}
const T = Type.Symbol() type T = symbol const T = {
type: 'symbol'
}
const T = Type.BigInt() type T = bigint const T = {
type: 'bigint'
}
const T = Type.Void() type T = void const T = {
type: 'void'
}
```
Back to [Home](../../readme.md)

342
docs/types/json.md Normal file
View File

@@ -0,0 +1,342 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | **Types** | [Values](../values/) | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Json Types
TypeBox types are Json Schema fragments that compose into more complex types. Each fragment is structured such that any Json Schema compliant validator can runtime assert a value the same way TypeScript will statically assert a type. TypeBox offers a set of Json Types which are used to create Json Schema compliant schematics as well as a JavaScript type set used to create schematics for constructs native to JavaScript.
The following table lists the supported Json types. These types are fully compatible with the Json Schema Draft 7 specification.
```typescript
TypeBox TypeScript Json Schema
const T = Type.Any() type T = any const T = { }
const T = Type.Unknown() type T = unknown const T = { }
const T = Type.String() type T = string const T = {
type: 'string'
}
const T = Type.Number() type T = number const T = {
type: 'number'
}
const T = Type.Integer() type T = number const T = {
type: 'integer'
}
const T = Type.Boolean() type T = boolean const T = {
type: 'boolean'
}
const T = Type.Null() type T = null const T = {
type: 'null'
}
const T = Type.Literal(42) type T = 42 const T = {
const: 42,
type: 'number'
}
const T = Type.Array( type T = number[] const T = {
Type.Number() type: 'array',
) items: {
type: 'number'
}
}
const T = Type.Object({ type T = { const T = {
x: Type.Number(), x: number, type: 'object',
y: Type.Number() y: number required: ['x', 'y'],
}) } properties: {
x: {
type: 'number'
},
y: {
type: 'number'
}
}
}
const T = Type.Tuple([ type T = [number, number] const T = {
Type.Number(), type: 'array',
Type.Number() items: [{
]) type: 'number'
}, {
type: 'number'
}],
additionalItems: false,
minItems: 2,
maxItems: 2
}
enum Foo { enum Foo { const T = {
A, A, anyOf: [{
B B type: 'number',
} } const: 0
}, {
const T = Type.Enum(Foo) type T = Foo type: 'number',
const: 1
}]
}
const T = Type.Const({ type T = { const T = {
x: 1, readonly x: 1, type: 'object',
y: 2, readonly y: 2 required: ['x', 'y'],
} as const) } properties: {
x: {
type: 'number',
const: 1
},
y: {
type: 'number',
const: 2
}
}
}
const T = Type.KeyOf( type T = keyof { const T = {
Type.Object({ x: number, anyOf: [{
x: Type.Number(), y: number type: 'string',
y: Type.Number() } const: 'x'
}) }, {
) type: 'string',
const: 'y'
}]
}
const T = Type.Union([ type T = string | number const T = {
Type.String(), anyOf: [{
Type.Number() type: 'string'
]) }, {
type: 'number'
}]
}
const T = Type.Intersect([ type T = { const T = {
Type.Object({ x: number allOf: [{
x: Type.Number() } & { type: 'object',
}), y: number required: ['x'],
Type.Object({ } properties: {
y: Type.Number() x: {
}) type: 'number'
]) }
}
}, {
type: 'object', |
required: ['y'],
properties: {
y: {
type: 'number'
}
}
}]
}
const T = Type.Composite([ type T = { const T = {
Type.Object({ x: number, type: 'object',
x: Type.Number() y: number required: ['x', 'y'],
}), } properties: {
Type.Object({ x: {
y: Type.Number() type: 'number'
}) },
]) y: {
type: 'number'
}
}
}
const T = Type.Never() type T = never const T = {
not: {}
}
const T = Type.Not( | type T = unknown const T = {
Type.String() not: {
) type: 'string'
}
}
const T = Type.Extends( type T = const T = {
Type.String(), string extends number const: false,
Type.Number(), ? true type: 'boolean'
Type.Literal(true), : false }
Type.Literal(false)
)
const T = Type.Extract( type T = Extract< const T = {
Type.Union([ string | number, type: 'string'
Type.String(), string }
Type.Number(), >
]),
Type.String()
)
const T = Type.Exclude( type T = Exclude< const T = {
Type.Union([ string | number, type: 'number'
Type.String(), string }
Type.Number(), >
]),
Type.String()
)
const T = Type.Mapped( type T = { const T = {
Type.Union([ [_ in 'x' | 'y'] : number type: 'object',
Type.Literal('x'), } required: ['x', 'y'],
Type.Literal('y') properties: {
]), x: {
() => Type.Number() type: 'number'
) },
y: {
type: 'number'
}
}
}
const U = Type.Union([ type U = 'open' | 'close' const T = {
Type.Literal('open'), type: 'string',
Type.Literal('close') type T = `on${U}` pattern: '^on(open|close)$'
]) }
const T = Type
.TemplateLiteral([
Type.Literal('on'),
U
])
const T = Type.Record( type T = Record< const T = {
Type.String(), string, type: 'object',
Type.Number() number patternProperties: {
) > '^.*$': {
type: 'number'
}
}
}
const T = Type.Partial( type T = Partial<{ const T = {
Type.Object({ x: number, type: 'object',
x: Type.Number(), y: number properties: {
y: Type.Number() | }> x: {
}) type: 'number'
) },
y: {
type: 'number'
}
}
}
const T = Type.Required( type T = Required<{ const T = {
Type.Object({ x?: number, type: 'object',
x: Type.Optional( y?: number required: ['x', 'y'],
Type.Number() | }> properties: {
), x: {
y: Type.Optional( type: 'number'
Type.Number() },
) y: {
}) type: 'number'
) }
}
}
const T = Type.Pick( type T = Pick<{ const T = {
Type.Object({ x: number, type: 'object',
x: Type.Number(), y: number required: ['x'],
y: Type.Number() }, 'x'> properties: {
}), ['x'] | x: {
) type: 'number'
}
}
}
const T = Type.Omit( type T = Omit<{ const T = {
Type.Object({ x: number, type: 'object',
x: Type.Number(), y: number required: ['y'],
y: Type.Number() }, 'x'> properties: {
}), ['x'] | y: {
) type: 'number'
}
}
}
const T = Type.Index( type T = { const T = {
Type.Object({ x: number, type: 'number'
x: Type.Number(), y: string }
y: Type.String() }['x']
}), ['x']
)
const A = Type.Tuple([ type A = [0, 1] const T = {
Type.Literal(0), type B = [2, 3] type: 'array',
Type.Literal(1) type T = [ items: [
]) ...A, { const: 0 },
const B = Type.Tuple([ ...B { const: 1 },
| Type.Literal(2), ] { const: 2 },
| Type.Literal(3) { const: 3 }
]) ],
const T = Type.Tuple([ additionalItems: false,
| ...Type.Rest(A), minItems: 4,
| ...Type.Rest(B) maxItems: 4
]) }
const T = Type.Uncapitalize( type T = Uncapitalize< const T = {
Type.Literal('Hello') 'Hello' type: 'string',
) > const: 'hello'
}
const T = Type.Capitalize( type T = Capitalize< const T = {
Type.Literal('hello') 'hello' type: 'string',
) > const: 'Hello'
}
const T = Type.Uppercase( type T = Uppercase< const T = {
Type.Literal('hello') 'hello' type: 'string',
) > const: 'HELLO'
}
const T = Type.Lowercase( type T = Lowercase< const T = {
Type.Literal('HELLO') 'HELLO' type: 'string',
) > const: 'hello'
}
const R = Type.Ref('T') type R = unknown const R = { $ref: 'T' }
```
Back to [Home](../../readme.md)

27
docs/types/mapped.md Normal file
View File

@@ -0,0 +1,27 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | **Types** | [Values](../values/) | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Mapped Types
TypeBox supports mapped types with the Mapped function. This function accepts two arguments, the first is a union type typically derived from KeyOf, the second is a mapping function that receives a mapping key `K` that can be used to index properties of a type. The following implements a mapped type that remaps each property to be `T | null`.
```typescript
const T = Type.Object({
// type T = {
x: Type.Number(), // x: number,
y: Type.String(), // y: string,
z: Type.Boolean(), // z: boolean
}); // }
const M = Type.Mapped(Type.KeyOf(T), (K) => {
// type M = { [K in keyof T]: T[K] | null }
return Type.Union([Type.Index(T, K), Type.Null()]); //
}); // ... evaluated as
//
// const M: TObject<{
// x: TUnion<[TNumber, TNull]>,
// y: TUnion<[TString, TNull]>,
// z: TUnion<[TBoolean, TNull]>
// }>
```
Back to [Home](../../readme.md)

35
docs/types/modules.md Normal file
View File

@@ -0,0 +1,35 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | **Types** | [Values](../values/) | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Module Types
Module types are containers for a set of referential types. Modules act as namespaces, enabling types to reference one another via string identifiers. Modules support both singular and mutually recursive references, as well as deferred dereferencing for computed types such as Partial. Types imported from a module are expressed using the Json Schema `$defs` keyword.
```typescript
const Module = Type.Module({
PartialUser: Type.Partial(Type.Ref("User")), // TComputed<'Partial', [TRef<'User'>]>
User: Type.Object({
// TObject<{
id: Type.String(), // user: TString,
name: Type.String(), // name: TString,
email: Type.String(), // email: TString
}), // }>
});
const User = Module.Import("User"); // const User: TImport<{...}, 'User'>
type User = Static<typeof User>; // type User = {
// id: string,
// name: string,
// email: string
// }
const PartialUser = Module.Import("PartialUser"); // const PartialUser: TImport<{...}, 'PartialUser'>
type PartialUser = Static<typeof PartialUser>; // type PartialUser = {
// id?: string,
// name?: string,
// email?: string
// }
```
Back to [Home](../../readme.md)

33
docs/types/options.md Normal file
View File

@@ -0,0 +1,33 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | **Types** | [Values](../values/) | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Options
You can pass Json Schema options on the last argument of any given type. Option hints specific to each type are provided for convenience.
```typescript
// String must be an email
const T = Type.String({
// const T = {
format: "email", // type: 'string',
}); // format: 'email'
// }
// Number must be a multiple of 2
const T = Type.Number({
// const T = {
multipleOf: 2, // type: 'number',
}); // multipleOf: 2
// }
// Array must have at least 5 integer values
const T = Type.Array(Type.Integer(), {
// const T = {
minItems: 5, // type: 'array',
}); // minItems: 5,
// items: {
// type: 'integer'
// }
// }
```
Back to [Home](../../readme.md)

45
docs/types/properties.md Normal file
View File

@@ -0,0 +1,45 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | **Types** | [Values](../values/) | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Properties
Object properties can be modified with Readonly and Optional. The following table shows how these modifiers map between TypeScript and Json Schema.
```typescript
TypeBox TypeScript Json Schema
const T = Type.Object({ type T = { const T = {
name: Type.ReadonlyOptional( readonly name?: string type: 'object',
Type.String() } properties: {
) name: {
}) type: 'string'
}
}
}
const T = Type.Object({ type T = { const T = {
name: Type.Readonly( readonly name: string type: 'object',
Type.String() } properties: {
) name: {
}) type: 'string'
}
},
required: ['name']
}
const T = Type.Object({ type T = { const T = {
name: Type.Optional( name?: string type: 'object',
Type.String() } properties: {
) name: {
}) type: 'string'
}
}
}
```
Back to [Home](../../readme.md)

43
docs/types/recursive.md Normal file
View File

@@ -0,0 +1,43 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | **Types** | [Values](../values/) | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Recursive Types
Use the Recursive function to create recursive types.
```typescript
const Node = Type.Recursive(
(This) =>
Type.Object({
// const Node = {
id: Type.String(), // $id: 'Node',
nodes: Type.Array(This), // type: 'object',
}),
{ $id: "Node" }
); // properties: {
// id: {
// type: 'string'
// },
// nodes: {
// type: 'array',
// items: {
// $ref: 'Node'
// }
// }
// },
// required: [
// 'id',
// 'nodes'
// ]
// }
type Node = Static<typeof Node>; // type Node = {
// id: string
// nodes: Node[]
// }
function test(node: Node) {
const id = node.nodes[0].nodes[0].id; // id is string
}
```
Back to [Home](../../readme.md)

View File

@@ -0,0 +1,36 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | **Types** | [Values](../values/) | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Template Literal Types
TypeBox supports template literal types with the TemplateLiteral function. This type can be created using a syntax similar to the TypeScript template literal syntax or composed from exterior types. TypeBox encodes template literals as regular expressions which enables the template to be checked by Json Schema validators. This type also supports regular expression parsing that enables template patterns to be used for generative types. The following shows both TypeScript and TypeBox usage.
```typescript
// TypeScript
type K = `prop${"A" | "B" | "C"}`; // type T = 'propA' | 'propB' | 'propC'
type R = Record<K, string>; // type R = {
// propA: string
// propB: string
// propC: string
// }
// TypeBox
const K = Type.TemplateLiteral("prop${A|B|C}"); // const K: TTemplateLiteral<[
// TLiteral<'prop'>,
// TUnion<[
// TLiteral<'A'>,
// TLiteral<'B'>,
// TLiteral<'C'>,
// ]>
// ]>
const R = Type.Record(K, Type.String()); // const R: TObject<{
// propA: TString,
// propB: TString,
// propC: TString,
// }>
```
Back to [Home](../../readme.md)

32
docs/types/transform.md Normal file
View File

@@ -0,0 +1,32 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | **Types** | [Values](../values/) | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Transform Types
TypeBox supports value decoding and encoding with Transform types. These types work in tandem with the Encode and Decode functions available on the Value and TypeCompiler submodules. Transform types can be used to convert Json encoded values into constructs more natural to JavaScript. The following creates a Transform type to decode numbers into Dates using the Value submodule.
```typescript
import { Value } from "@alkdev/typebox/value";
const T = Type.Transform(Type.Number())
.Decode((value) => new Date(value)) // decode: number to Date
.Encode((value) => value.getTime()); // encode: Date to number
const D = Value.Decode(T, 0); // const D = Date(1970-01-01T00:00:00.000Z)
const E = Value.Encode(T, D); // const E = 0
```
Use the StaticEncode or StaticDecode types to infer a Transform type.
```typescript
import { Static, StaticDecode, StaticEncode } from "@alkdev/typebox";
const T = Type.Transform(Type.Array(Type.Number(), { uniqueItems: true }))
.Decode((value) => new Set(value))
.Encode((value) => [...value]);
type D = StaticDecode<typeof T>; // type D = Set<number>
type E = StaticEncode<typeof T>; // type E = Array<number>
type T = Static<typeof T>; // type T = Array<number>
```
Back to [Home](../../readme.md)

17
docs/types/typeguard.md Normal file
View File

@@ -0,0 +1,17 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | **Types** | [Values](../values/) | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# TypeGuard
TypeBox can check its own types with the TypeGuard module. This module is written for type introspection and provides structural tests for every built-in TypeBox type. Functions of this module return `is` guards which can be used with control flow assertions to obtain schema inference for unknown values. The following guards that the value `T` is TString.
```typescript
import { TypeGuard, Kind } from "@alkdev/typebox";
const T = { [Kind]: "String", type: "string" };
if (TypeGuard.IsString(T)) {
// T is TString
}
```
Back to [Home](../../readme.md)

41
docs/types/unsafe.md Normal file
View File

@@ -0,0 +1,41 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | **Types** | [Values](../values/) | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Unsafe Types
TypeBox supports user defined types with Unsafe. This type allows you to specify both schema representation and inference type. The following creates an Unsafe type with a number schema that infers as string.
```typescript
const T = Type.Unsafe<string>({ type: "number" }); // const T = { type: 'number' }
type T = Static<typeof T>; // type T = string - ?
```
The Unsafe type is often used to create schematics for extended specifications like OpenAPI.
```typescript
const Nullable = <T extends TSchema>(schema: T) =>
Type.Unsafe<Static<T> | null>({
...schema,
nullable: true,
});
const T = Nullable(Type.String()); // const T = {
// type: 'string',
// nullable: true
// }
type T = Static<typeof T>; // type T = string | null
const StringEnum = <T extends string[]>(values: [...T]) =>
Type.Unsafe<T[number]>({
type: "string",
enum: values,
});
const S = StringEnum(["A", "B", "C"]); // const S = {
// enum: ['A', 'B', 'C']
// }
type S = Static<typeof T>; // type S = 'A' | 'B' | 'C'
```
Back to [Home](../../readme.md)

76
docs/usage.md Normal file
View File

@@ -0,0 +1,76 @@
# Usage
The following shows general usage.
```typescript
import { Type, type Static } from "@alkdev/typebox";
//--------------------------------------------------------------------------------------------
//
// Let's say you have the following type ...
//
//--------------------------------------------------------------------------------------------
type T = {
id: string;
name: string;
timestamp: number;
};
//--------------------------------------------------------------------------------------------
//
// ... you can express this type in the following way.
//
//--------------------------------------------------------------------------------------------
const T = Type.Object({
// const T = {
id: Type.String(), // type: 'object',
name: Type.String(), // properties: {
timestamp: Type.Integer(), // id: {
}); // type: 'string'
// },
// name: {
// type: 'string'
// },
// timestamp: {
// type: 'integer'
// }
// },
// required: [
// 'id',
// 'name',
// 'timestamp'
// ]
// }
//--------------------------------------------------------------------------------------------
//
// ... then infer back to the original static type this way.
//
//--------------------------------------------------------------------------------------------
type T = Static<typeof T>; // type T = {
// id: string,
// name: string,
// timestamp: number
// }
//--------------------------------------------------------------------------------------------
//
// ... or use the type to parse JavaScript values.
//
//--------------------------------------------------------------------------------------------
import { Value } from "@alkdev/typebox/value";
const R = Value.Parse(T, value); // const R: {
// id: string,
// name: string,
// timestamp: number
// }
```
---
[Back to Home](../readme.md)

13
docs/values/assert.md Normal file
View File

@@ -0,0 +1,13 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | **Values** | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Assert
Use the Assert function to assert a value is valid.
```typescript
let value: unknown = 1;
Value.Assert(Type.Number(), value); // throws AssertError if invalid
```
Back to [Home](../../readme.md)

20
docs/values/cast.md Normal file
View File

@@ -0,0 +1,20 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | **Values** | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Cast
Use the Cast function to upcast a value into a target type. This function will retain as much information as possible from the original value. The Cast function is intended to be used in data migration scenarios where existing values need to be upgraded to match a modified type.
```typescript
const T = Type.Object(
{ x: Type.Number(), y: Type.Number() },
{ additionalProperties: false }
);
const X = Value.Cast(T, null); // const X = { x: 0, y: 0 }
const Y = Value.Cast(T, { x: 1 }); // const Y = { x: 1, y: 0 }
const Z = Value.Cast(T, { x: 1, y: 2, z: 3 }); // const Z = { x: 1, y: 2 }
```
Back to [Home](../../readme.md)

13
docs/values/check.md Normal file
View File

@@ -0,0 +1,13 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | **Values** | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Check
Use the Check function to type check a value.
```typescript
const T = Type.Object({ x: Type.Number() });
const R = Value.Check(T, { x: 1 }); // const R = true
```
Back to [Home](../../readme.md)

20
docs/values/clean.md Normal file
View File

@@ -0,0 +1,20 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | **Values** | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Clean
Use Clean to remove excess properties from a value. This function does not check the value and returns an unknown type. You should Check the result before use. Clean is a mutable operation. To avoid mutation, Clone the value first.
```typescript
const T = Type.Object({
x: Type.Number(),
y: Type.Number(),
});
const X = Value.Clean(T, null); // const 'X = null
const Y = Value.Clean(T, { x: 1 }); // const 'Y = { x: 1 }
const Z = Value.Clean(T, { x: 1, y: 2, z: 3 }); // const 'Z = { x: 1, y: 2 }
```
Back to [Home](../../readme.md)

11
docs/values/clone.md Normal file
View File

@@ -0,0 +1,11 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | **Values** | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Clone
Use the Clone function to deeply clone a value.
```typescript
const A = Value.Clone({ x: 1, y: 2, z: 3 }); // const A = { x: 1, y: 2, z: 3 }
```
Back to [Home](../../readme.md)

15
docs/values/convert.md Normal file
View File

@@ -0,0 +1,15 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | **Values** | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Convert
Use the Convert function to convert a value into its target type if a reasonable conversion is possible. This function may return an invalid value and should be checked before use. Its return type is `unknown`.
```typescript
const T = Type.Object({ x: Type.Number() });
const R1 = Value.Convert(T, { x: "3.14" }); // const R1 = { x: 3.14 }
const R2 = Value.Convert(T, { x: "not a number" }); // const R2 = { x: 'not a number' }
```
Back to [Home](../../readme.md)

13
docs/values/create.md Normal file
View File

@@ -0,0 +1,13 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | **Values** | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Create
Use the Create function to create a value from a type. TypeBox will use default values if specified.
```typescript
const T = Type.Object({ x: Type.Number(), y: Type.Number({ default: 42 }) });
const A = Value.Create(T); // const A = { x: 0, y: 42 }
```
Back to [Home](../../readme.md)

View File

@@ -0,0 +1,25 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | **Values** | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Decode / Encode
## Decode
Use the Decode function to decode a value from a type or throw if the value is invalid. The return value will infer as the decoded type. This function will run Transform codecs if available.
```typescript
const A = Value.Decode(Type.String(), "hello"); // const A = 'hello'
const B = Value.Decode(Type.String(), 42); // throw
```
## Encode
Use the Encode function to encode a value to a type or throw if the value is invalid. The return value will infer as the encoded type. This function will run Transform codecs if available.
```typescript
const A = Value.Encode(Type.String(), "hello"); // const A = 'hello'
const B = Value.Encode(Type.String(), 42); // throw
```
Back to [Home](../../readme.md)

20
docs/values/default.md Normal file
View File

@@ -0,0 +1,20 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | **Values** | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Default
Use Default to generate missing properties on a value using default schema annotations if available. This function does not check the value and returns an unknown type. You should Check the result before use. Default is a mutable operation. To avoid mutation, Clone the value first.
```typescript
const T = Type.Object({
x: Type.Number({ default: 0 }),
y: Type.Number({ default: 0 }),
});
const X = Value.Default(T, null); // const 'X = null - non-enumerable
const Y = Value.Default(T, {}); // const 'Y = { x: 0, y: 0 }
const Z = Value.Default(T, { x: 1 }); // const 'Z = { x: 1, y: 0 }
```
Back to [Home](../../readme.md)

36
docs/values/diff-patch.md Normal file
View File

@@ -0,0 +1,36 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | **Values** | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Diff / Patch
## Diff
Use the Diff function to generate a sequence of edits that will transform one value into another.
```typescript
const E = Value.Diff(
// const E = [
{ x: 1, y: 2, z: 3 }, // { type: 'update', path: '/y', value: 4 },
{ y: 4, z: 5, w: 6 } // { type: 'update', path: '/z', value: 5 },
); // { type: 'insert', path: '/w', value: 6 },
// { type: 'delete', path: '/x' }
// ]
```
## Patch
Use the Patch function to apply a sequence of edits.
```typescript
const A = { x: 1, y: 2 };
const B = { x: 3 };
const E = Value.Diff(A, B); // const E = [
// { type: 'update', path: '/x', value: 3 },
// { type: 'delete', path: '/y' }
// ]
const C = Value.Patch<typeof B>(A, E); // const C = { x: 3 }
```
Back to [Home](../../readme.md)

15
docs/values/equal.md Normal file
View File

@@ -0,0 +1,15 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | **Values** | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Equal
Use the Equal function to deeply check for value equality.
```typescript
const R = Value.Equal(
// const R = true
{ x: 1, y: 2, z: 3 },
{ x: 1, y: 2, z: 3 }
);
```
Back to [Home](../../readme.md)

23
docs/values/errors.md Normal file
View File

@@ -0,0 +1,23 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | **Values** | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Errors
Use the Errors function to enumerate validation errors.
```typescript
const T = Type.Object({ x: Type.Number(), y: Type.Number() });
const R = [...Value.Errors(T, { x: "42" })]; // const R = [{
// schema: { type: 'number' },
// path: '/x',
// value: '42',
// message: 'Expected number'
// }, {
// schema: { type: 'number' },
// path: '/y',
// value: undefined,
// message: 'Expected number'
// }]
```
Back to [Home](../../readme.md)

13
docs/values/hash.md Normal file
View File

@@ -0,0 +1,13 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | **Values** | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Hash
Use the Hash function to create a [FNV1A-64](https://en.wikipedia.org/wiki/Fowler%E2%80%93Noll%E2%80%93Vo_hash_function) non-cryptographic hash of a value.
```typescript
const A = Value.Hash({ x: 1, y: 2, z: 3 }); // const A = 2910466848807138541n
const B = Value.Hash({ x: 1, y: 4, z: 3 }); // const B = 1418369778807423581n
```
Back to [Home](../../readme.md)

19
docs/values/mutate.md Normal file
View File

@@ -0,0 +1,19 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | **Values** | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Mutate
Use the Mutate function to perform a deep mutable value assignment while retaining internal references.
```typescript
const Y = { z: 1 }; // const Y = { z: 1 }
const X = { y: Y }; // const X = { y: { z: 1 } }
const A = { x: X }; // const A = { x: { y: { z: 1 } } }
Value.Mutate(A, { x: { y: { z: 2 } } }); // A' = { x: { y: { z: 2 } } }
const R0 = A.x.y.z === 2; // const R0 = true
const R1 = A.x.y === Y; // const R1 = true
const R2 = A.x === X; // const R2 = true
```
Back to [Home](../../readme.md)

29
docs/values/parse.md Normal file
View File

@@ -0,0 +1,29 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | **Values** | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Parse
Use the Parse function to parse a value. This function calls the `Clone` `Clean`, `Default`, `Convert`, `Assert` and `Decode` Value functions in this exact order to process a value.
```typescript
const R = Value.Parse(Type.String(), "hello"); // const R: string = "hello"
const E = Value.Parse(Type.String(), undefined); // throws AssertError
```
You can override the order in which functions are run, or omit functions entirely using the following.
```typescript
// Runs no functions.
const R = Value.Parse([], Type.String(), 12345);
// Runs the Assert() function.
const E = Value.Parse(["Assert"], Type.String(), 12345);
// Runs the Convert() function followed by the Assert() function.
const S = Value.Parse(["Convert", "Assert"], Type.String(), 12345);
```
Back to [Home](../../readme.md)

17
docs/values/pointer.md Normal file
View File

@@ -0,0 +1,17 @@
[Home](../../readme.md) | [Installation](../installation.md) | [Usage](../usage.md) | [Types](../types/) | **Values** | [Syntax](../syntax/) | [TypeRegistry](../type-registry.md) | [TypeCheck](../type-check.md)
# Pointer
Use ValuePointer to perform mutable updates on existing values using [RFC6901](https://www.rfc-editor.org/rfc/rfc6901) Json Pointers.
```typescript
import { ValuePointer } from "@alkdev/typebox/value";
const A = { x: 0, y: 0, z: 0 };
ValuePointer.Set(A, "/x", 1); // A' = { x: 1, y: 0, z: 0 }
ValuePointer.Set(A, "/y", 1); // A' = { x: 1, y: 1, z: 0 }
ValuePointer.Set(A, "/z", 1); // A' = { x: 1, y: 1, z: 1 }
```
Back to [Home](../../readme.md)

View File

@@ -1,10 +1,10 @@
/*--------------------------------------------------------------------------
@sinclair/typebox
@alkdev/typebox
The MIT License (MIT)
Copyright (c) 2017-2025 Haydn Paterson (sinclair) <haydn.developer@gmail.com>
Copyright (c) 2017-2026 Haydn Paterson
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
@@ -26,7 +26,7 @@ THE SOFTWARE.
---------------------------------------------------------------------------*/
import * as Types from '@sinclair/typebox'
import * as Types from '@alkdev/typebox'
// -------------------------------------------------------------------
// Annotation

View File

@@ -1,10 +1,10 @@
/*--------------------------------------------------------------------------
@sinclair/typebox/collections
@alkdev/typebox/collections
The MIT License (MIT)
Copyright (c) 2017-2025 Haydn Paterson (sinclair) <haydn.developer@gmail.com>
Copyright (c) 2017-2026 Haydn Paterson
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
@@ -26,9 +26,9 @@ THE SOFTWARE.
---------------------------------------------------------------------------*/
import { TypeCheck, TypeCompiler, ValueError } from '@sinclair/typebox/compiler'
import { TSchema, Static, TypeBoxError } from '@sinclair/typebox'
import { Value } from '@sinclair/typebox/value'
import { TypeCheck, TypeCompiler, ValueError } from '@alkdev/typebox/compiler'
import { TSchema, Static, TypeBoxError } from '@alkdev/typebox'
import { Value } from '@alkdev/typebox/value'
// ----------------------------------------------------------------
// TypeArrayError

View File

@@ -1,10 +1,10 @@
/*--------------------------------------------------------------------------
@sinclair/typebox/collections
@alkdev/typebox/collections
The MIT License (MIT)
Copyright (c) 2017-2025 Haydn Paterson (sinclair) <haydn.developer@gmail.com>
Copyright (c) 2017-2026 Haydn Paterson
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal

View File

@@ -1,10 +1,10 @@
/*--------------------------------------------------------------------------
@sinclair/typebox/collections
@alkdev/typebox/collections
The MIT License (MIT)
Copyright (c) 2017-2025 Haydn Paterson (sinclair) <haydn.developer@gmail.com>
Copyright (c) 2017-2026 Haydn Paterson
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
@@ -26,9 +26,9 @@ THE SOFTWARE.
---------------------------------------------------------------------------*/
import { TypeCheck, TypeCompiler, ValueError } from '@sinclair/typebox/compiler'
import { TSchema, Static, TypeBoxError } from '@sinclair/typebox'
import { Value } from '@sinclair/typebox/value'
import { TypeCheck, TypeCompiler, ValueError } from '@alkdev/typebox/compiler'
import { TSchema, Static, TypeBoxError } from '@alkdev/typebox'
import { Value } from '@alkdev/typebox/value'
// ----------------------------------------------------------------
// TypeMapKeyError

View File

@@ -1,10 +1,10 @@
/*--------------------------------------------------------------------------
@sinclair/typebox/collections
@alkdev/typebox/collections
The MIT License (MIT)
Copyright (c) 2017-2025 Haydn Paterson (sinclair) <haydn.developer@gmail.com>
Copyright (c) 2017-2026 Haydn Paterson
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
@@ -26,9 +26,9 @@ THE SOFTWARE.
---------------------------------------------------------------------------*/
import { TypeCheck, TypeCompiler, ValueError } from '@sinclair/typebox/compiler'
import { TSchema, Static, TypeBoxError } from '@sinclair/typebox'
import { Value } from '@sinclair/typebox/value'
import { TypeCheck, TypeCompiler, ValueError } from '@alkdev/typebox/compiler'
import { TSchema, Static, TypeBoxError } from '@alkdev/typebox'
import { Value } from '@alkdev/typebox/value'
// ----------------------------------------------------------------
// Errors

View File

@@ -1,6 +1,6 @@
/*--------------------------------------------------------------------------
@sinclair/typebox/format
@alkdev/typebox/format
The MIT License (MIT)

View File

@@ -1,6 +1,6 @@
/*--------------------------------------------------------------------------
@sinclair/typebox/format
@alkdev/typebox/format
The MIT License (MIT)

View File

@@ -1,6 +1,6 @@
/*--------------------------------------------------------------------------
@sinclair/typebox/format
@alkdev/typebox/format
The MIT License (MIT)

View File

@@ -1,10 +1,10 @@
/*--------------------------------------------------------------------------
@sinclair/typebox/format
@alkdev/typebox/format
The MIT License (MIT)
Copyright (c) 2017-2025 Haydn Paterson (sinclair) <haydn.developer@gmail.com>
Copyright (c) 2017-2026 Haydn Paterson
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal

Some files were not shown because too many files have changed in this diff Show More