TypeScript → Zod 스키마

사용 방법

1. TypeScript interface 또는 type 선언을 왼쪽 패널에 붙여넣습니다.
2. 입력이 멈추면 300ms 후 자동으로 유효성 검사 및 변환이 실행됩니다.
3. Zod 스키마 생성 버튼을 클릭해 강제로 변환할 수 있습니다.
4. 복사 버튼을 클릭해 Zod 출력을 클립보드에 복사합니다.
5. 결과를 프로젝트에 붙여넣으세요. 출력에는 이미 import 문과 export type 타입 추론 줄이 포함되어 있습니다.

지원하는 TypeScript 기능

• 기본 타입: string, number, boolean, null, undefined, any, unknown, void, never, bigint, symbol
• 선택적 속성: prop?: type → .optional()
• 유니언 타입: A | B → z.union([A, B])
• 문자열 열거형: “a” | “b” | “c” → z.enum([“a”, “b”, “c”])
• 배열: T[] / Array<T> → z.array(T)
• 중첩 객체: 인라인 객체 타입 → z.object({})
• 상호 참조: 선언된 타입 간의 참조 → Schema 상수
• readonly: readonly 수식어를 허용하며, 변환 시 무시(Zod 스키마는 기본적으로 불변)
• 유틸리티 타입: Partial<T>, Record<K, V>, Promise<T>
• 교차 타입: A & B → z.intersection(A, B)
• 튜플: [A, B] → z.tuple([A, B])
• 리터럴 타입: “value”, 42, true → z.literal()

예시

다음 TypeScript를 입력하면:

interface Address {
street: string;
city: string;
zipCode?: string;
}

export interface User {
id: number;
name: string;
role: "admin" | "user" | "guest";
age?: number;
isActive: boolean;
tags: string[];
address: Address;
}

export type Status = "active" | "inactive" | "pending";

다음과 같이 생성됩니다:

import { z } from "zod";

export const AddressSchema = z.object({
street: z.string(),
city: z.string(),
zipCode: z.string().optional(),
});
export type Address = z.infer<typeof AddressSchema>;

export const UserSchema = z.object({
id: z.number(),
name: z.string(),
role: z.enum(["admin", "user", "guest"]),
age: z.number().optional(),
isActive: z.boolean(),
tags: z.array(z.string()),
address: AddressSchema,
});
export type User = z.infer<typeof UserSchema>;

export const StatusSchema = z.enum(["active", "inactive", "pending"]);
export type Status = z.infer<typeof StatusSchema>;