JSON から TypeScript へ

コンバータは、string、number、boolean、null、undefined、Date（ISO 日付文字列）の正しい型を持つ、オブジェクトの TypeScript インターフェース宣言を生成します。ネストされたオブジェクトは個別のインターフェースを生成します。配列は T[] 型を生成します。混合配列はユニオン型（string | number）[] を生成します。サンプルで null であるプロパティは T | null を取得します。オプションプロパティ（?）は単一サンプルから推定されません — より良い推定のために複数のサンプルを使用してください。

各ネストされたオブジェクトは独自の名前付きインターフェースを取得します。たとえば、{\"user\": {\"name\": \"Alice\"}} は interface User { name: string; } と interface Root { user: User; } を生成します。インターフェースは、プロパティキーを PascalCase に変換することで命名されます。深くネストされたオブジェクトは、インターフェースの完全な階層を生成します。オブジェクトの配列は、アイテム型のインターフェースを生成し、ItemType[] として参照されます。

interface と type はオブジェクト形状に大きく相互交換可能です。インターフェースは宣言マージング（同じ名前の複数の宣言がマージされる）をサポートし、extends で拡張できます。型エイリアスは、インターフェースが表現できないユニオン型、タプル、マップされた型を表現できます。API レスポンス形状の場合、両方が機能します。慣例は、オブジェクト形状（インスタンス化または拡張するオブジェクト）に interface を使用し、エイリアス、ユニオン、計算された型に type を使用することです。

コンバータは 1 つのサンプルから型を推定します。フィールドが呼び出し間で時々 string で時々 number である場合、ユニオン型を手動で追加する必要があります：field：string | number。null 許容フィールドの場合、| null を追加します。欠落/オプションフィールドの場合、? 修飾子を追加します：field?：string。複数の API レスポンスでコンバータを実行し、本番環境品質の型のためにインターフェースを手動でマージします。

生成されたインターフェースを .ts または .d.ts ファイル（例：api-types.ts）にコピーします。必要な場所にインポートします：import type { Root } from \"./api-types\"；。フェッチ応答を型付けします：const data = await response.json() as Root；または zod を使用した実行時検証の場合：const schema = z.object({...})；const data = schema.parse(await response.json())。大規模なプロジェクトの場合、quicktype または openapi-typescript などのツールを検討して、スキーマから自動型生成を行います。