Import a JSON Schema in a .schema.jsonc or .schema.json5 file as its TypeScript type and a validator compiled with ajv. A TypeScript 7.1 content mapper, a preload, and plugins for esbuild, Vite, webpack, Next.js and Jest.
You can import it directly from a TypeScript file, and get its type and a validator:
// main.tsimport user from "./user.schema.jsonc";const data = await request.json();if (user.is(data)) { data; // { name: string; role?: "admin" | "member" }}
It's powered by TypeScript's content mappers (introduced in TypeScript 7.1), which let a package give tsc the types of a file it imports. The validator is compiled by ajv when the module is built, so a bundle carries the validator and no validator library.
Setup
You'll need TypeScript 7.1 (currently in beta) and Node 24 or later:
npm install -D dotschema typescript@beta
An app that runs under the preload, not as a bundle, builds each schema's module at run time, so it installs dotschema as a dependency: npm install dotschema.
Add dotschema to tsconfig.json as a content mapper:
preload = ["dotschema/register"] in bunfig.toml (setup)
nub
"preload": ["dotschema/register"] in nub.jsonc (setup)
Your editor types schema imports through the TypeScript 7.1 language server, with content mappers on: in VS Code and Cursor, the TypeScript 7 extension pointed at your project's TypeScript, and in Zed, the TypeScript Language Server extension. The settings for each are in Editors.
Usage: .validate(), with defaults, transforms and unlisted keys, .is(), the types .output and .input, .pick(), .omit(), .partial(), .required() and .keyof(), definitions, and Standard Schema
Inference: the type each shape of schema gives, a to another file, and every the validator checks