OpenAPI → TypeScript ジェネレーター

使い方

1. OpenAPI 3.0.x または 3.1.x のドキュメント（YAML / JSON）を左側パネルに貼り付けます。
2. 入力中は 300 ms デバウンスでリアルタイム生成されます。
3. 必要に応じて ルート名前空間 の変更、全プロパティを optional 化、path 型の追加、Zod スキーマの同時出力を切り替えられます。
4. コピー ボタンで TypeScript 出力全文をコピーします。

生成される内容

• components/schemas：各スキーマが export interface または export type になります。オブジェクトは interface、プリミティブ / union / enum / intersection は type alias として出力されます。
• $ref：#/components/schemas/... への参照は型名で解決され、仕様の宣言順を維持します。
• oneOf / anyOf：union 型 A | B | C。allOf は intersection A & B になります。
• enum：文字列または数値のリテラル union。
• nullable：3.0 の nullable: true も 3.1 の type: ['X', 'null'] も X | null に変換。
• format ヒント：format: date-time には ISO 8601 の JSDoc を付与し、format: binary は Blob になります。
• additionalProperties：インデックスシグネチャまたは Record<string, T>。

Path 型（任意）

path 型を含める を有効にすると、各オペレーションに型エンベロープが生成されます：

export namespace Components {
export namespace GetPetById {
  export interface PathParameters {
    id: number;
  }
  export type Response200 = Pet;
}
}

operationId がない場合は method と path から合成します（例：GetPetsId）。

Zod スキーマ（任意）

Zod スキーマを含める を有効にすると、各コンポーネントに対して XSchema を並行して出力します：

import { z } from 'zod';

export const PetSchema = z.object({
id: z.number().int(),
name: z.string(),
status: z.enum(["available", "pending", "sold"]),
});

OpenAPI 仕様ではなく既存の手書き TS 型から Zod を作りたい場合は TypeScript → Zod を使ってください。

関連ツール

• OpenAPI バリデーター — 型生成前に仕様を検証。
• JSON → TypeScript — 仕様はなく JSON レスポンス例だけがある場合に。
• JSON → Zod スキーマ — 単一の JSON サンプルから Zod を生成。