JSON Schema ⇄ Zod 轉換器

從 OpenAPI 定義產生前端型別與驗證

OpenAPI 的 components.schemas 就是 JSON Schema，直接貼上即可同時取得 Zod 結構定義與 z.infer 型別，避免伺服器契約與前端驗證逐漸脫節。

把既有的 Zod 結構定義輸出成 API 契約

如果專案中是先寫 Zod 結構定義，可以用反向轉換產生 JSON Schema，貼進 OpenAPI 的 components 或文件中。

把手寫的驗證改為結構定義驅動

要取代大量 if 判斷時，只要有既有的 JSON Schema，就能一次產生完整的 Zod 起點，較不會漏掉必填欄位與 enum。

讓 AI 產生的 JSON Schema 真的能用

把 LLM 產出的 JSON Schema 直接貼上，轉換成能在 TypeScript 中運作的 Zod 結構定義，同時獲得靜態型別與執行期驗證。

$ref、allOf 與條件式不會展開

$ref 不會解析參照，會變成 z.any()；allOf 只轉換第一個子結構。if/then/else 與 not 不支援。以上都會在結果下方以警告顯示，請自行補上這些部分。

Zod → JSON Schema 是以文字方式剖析程式碼

為了讓一切在瀏覽器內完成，工具不會執行程式碼，而是當作文字剖析。支援 z.object / z.array / z.union / z.enum / z.literal / z.record 與常見的鏈式方法，但透過變數參照的結構定義，或 .refine() 這類任意函式無法用 JSON Schema 表達，因此會被忽略。

pattern 的正規表示式會原樣搬移

JSON Schema 的 pattern 會轉成 z.string().regex()，反向時其內容會回到 pattern。JSON Schema 也允許不相容於 ECMAScript 的正規表示式，直接搬移可能導致行為改變。

請務必檢查產生的結果

本工具用來產生移轉的起點。業務規則與欄位之間的一致性檢查，只要原始結構定義中沒有就不會被產生；用於正式環境驗證前請先確認內容。