# Valibot generator Generate Valibot schemas from OpenAPI # @skmtc/gen-valibot OpenAPI to [Valibot](https://valibot.dev/) schema generator for [Skmtc](https://skm.tc/). Generate type-safe Valibot validation schemas from your OpenAPI specifications. Valibot is a modular, lightweight schema library with excellent TypeScript support and tree-shaking capabilities. ## Installation Install Deno ```bash # On MacOS/Linux curl -fsSL https://deno.land/install.sh | sh # On Windows irm https://deno.land/install.ps1 | iex ``` Install Skmtc ```bash deno install -g -A --unstable-worker-options jsr:@skmtc/cli@0.0.388 -n skmtc -f ``` ## Create project and generate artifacts using TUI (recommended) ```bash # Create project then Generate artifacts skmtc ``` ## Create project and generate artifacts using CLI ```bash # Create project skmtc init # Install Valibot generator skmtc install @skmtc/gen-valibot # Bundle generator code skmtc bundle # Generate artifacts from OpenAPI schema skmtc generate ``` ## Usage Examples ### Basic Types | Input (OpenAPI Schema) | Valibot Schema | | --- | --- | | ```json
{
"components": {
"schemas": {
"User": {
"type": "object",
"properties": {
"id": { "type": "string" },
"age": { "type": "number" },
"isActive": { "type": "boolean" }
},
"required": ["id", "age"]
}
}
}
}
``` | ```typescript
import * as v from "valibot"
export const User = v.object({
id: v.string(),
age: v.number(),
isActive: v.optional(v.boolean())
})
``` | ### Enums and Literals | Input (OpenAPI Schema) | Valibot Schema | | --- | --- | | ```json
{
"Status": {
"type": "string",
"enum": ["active", "inactive", "pending"]
},
"Role": {
"type": "string",
"enum": ["admin"]
}
}
``` | ```typescript
export const Status = v.picklist(["active", "inactive", "pending"])
export const Role = v.literal("admin")
``` | ### Arrays and Nested Objects | Input (OpenAPI Schema) | Valibot Schema | | --- | --- | | ```json
{
"Team": {
"type": "object",
"properties": {
"name": { "type": "string" },
"members": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": { "type": "string" },
"role": { "type": "string" }
},
"required": ["id", "role"]
}
}
},
"required": ["name", "members"]
}
}
``` | ```typescript
export const Team = v.object({
name: v.string(),
members: v.array(v.object({
id: v.string(),
role: v.string()
}))
})
``` | ### Nullable and Optional Fields | Input (OpenAPI Schema) | Valibot Schema | | --- | --- | | ```json
{
"Profile": {
"type": "object",
"properties": {
"bio": {
"type": "string",
"nullable": true
},
"website": { "type": "string" }
},
"required": ["bio"]
}
}
``` | ```typescript
export const Profile = v.object({
bio: v.nullable(v.string()),
website: v.optional(v.string())
})
``` | ### Union Types | Input (OpenAPI Schema) | Valibot Schema | | --- | --- | | ```json
{
"Pet": {
"oneOf": [
{
"type": "object",
"properties": {
"type": { "type": "string", "enum": ["cat"] },
"meow": { "type": "boolean" }
},
"required": ["type", "meow"]
},
{
"type": "object",
"properties": {
"type": { "type": "string", "enum": ["dog"] },
"bark": { "type": "boolean" }
},
"required": ["type", "bark"]
}
]
}
}
``` | ```typescript
export const Pet = v.union([
v.object({
type: v.literal("cat"),
meow: v.boolean()
}),
v.object({
type: v.literal("dog"),
bark: v.boolean()
})
])
``` | ### String Formats | Input (OpenAPI Schema) | Valibot Schema | | --- | --- | | ```json
{
"Event": {
"type": "object",
"properties": {
"createdAt": {
"type": "string",
"format": "date-time"
}
},
"required": ["createdAt"]
}
}
``` | ```typescript
export const Event = v.object({
createdAt: v.pipe(v.string(), v.isoDateTime())
})
``` | ### Additional Properties | Input (OpenAPI Schema) | Valibot Schema | | --- | --- | | ```json
{
"Metadata": {
"type": "object",
"additionalProperties": { "type": "string" }
}
}
``` | ```typescript
export const Metadata = v.record(v.string(), v.string())
``` | With both properties and additionalProperties: | Input (OpenAPI Schema) | Valibot Schema | | --- | --- | | ```json
{
"Config": {
"type": "object",
"properties": {
"id": { "type": "string" }
},
"required": ["id"],
"additionalProperties": { "type": "number" }
}
}
``` | ```typescript
export const Config = v.intersect([
v.object({ id: v.string() }),
v.record(v.string(), v.number())
])
``` | ## Supported Features - **Primitive types**: string, number, integer, boolean - **Complex types**: object, array, union (oneOf/anyOf) - **Modifiers**: nullable, optional - **Enums**: Single values (literal) and multiple values (picklist) - **String formats**: date-time (isoDateTime) - **Integer validation**: Uses `v.pipe(v.number(), v.integer())` - **References**: Schema references via `$ref` - **Additional properties**: Record types and intersections - **Nested structures**: Deeply nested objects and arrays ## Testing Run tests for this generator: ```bash cd gen-valibot && deno task test ``` Or with coverage: ```bash deno task test:coverage ``` ## License MIT. ### @skmtc/gen-valibot - [GitHubskmtc/skmtc-generators](https://github.com/skmtc/skmtc-generators/tree/main/gen-valibot) - [@skmtc/gen-valibot](https://jsr.io/@skmtc/gen-valibot) - MIT License - Last updated: Nov 13, 2025