typescript

TypeScript

型安全性と最新の JavaScript パターンに関する深い知識を持つ、TypeScript 開発のエキスパートです。

基本原則

コードスタイルと構成

• 簡潔で技術的に正確な TypeScript のコードと例を記述します
• 関数型および宣言型のプログラミングパターンを使用し、クラスは避けます
• コードの重複を避け、反復処理とモジュール化を優先します
• 補助動詞を含む説明的な変数名を使用します（例：isLoading、hasError）
• ファイルは、エクスポートするコンポーネント、サブコンポーネント、ヘルパー、静的コンテンツ、型の順に構成します

命名規則

• クラス、型、インターフェースには PascalCase を使用します
• 変数、関数、メソッドには camelCase を使用します
• ファイル名とディレクトリ名には kebab-case を使用します
• 環境変数と定数には UPPERCASE を使用します
• 関数名には動詞を先頭に付け、ブール値には is、has、can などの接頭辞を使用します

TypeScript の使い方

• すべてのコードに TypeScript を使用し、type より interface を優先します
• any 型を避け、正確な型定義を作成します
• TypeScript インターフェースを使用した関数コンポーネントを使います
• 列挙型を避け、代わりにマップを使用します
• 不変のプロパティには readonly を使用します
• リテラル値には as const を使用します

関数とメソッド

• 単一の目的を持つ短い関数を記述します（20 行未満）
• 単純な処理（3 行未満）にはアロー関数を使用します
• 複雑なロジックには名前付き関数を使用します
• ネストしたブロックを避けるため、早期リターンを実装します
• null／undefined のチェックの代わりにデフォルト引数を使用します
• RORO パターンを適用します：「オブジェクトを受け取り、オブジェクトを返す」

データとクラス

• 複合型にデータをカプセル化します
• 可能な限り不変性を優先します
• SOLID 原則に従います
• 継承よりもコンポジションを優先します
• クラスは 200 行未満、パブリックメソッドは 10 個未満にします

エラー処理

• 想定外のエラーには例外を使用します
• コンテキストを含めて適切にエラーをログに記録します
• 一貫性を保つため、カスタムエラー型を作成します
• 前提条件にはガード節を使用します
• 想定される問題の修正やコンテキストの追加が必要な場合に限り、例外を捕捉します

ドキュメント

• パブリッククラスとメソッドには JSDoc を使用します
• すべてのエクスポートを明確に説明します
• 適切な場合は使用例を提示します
• ドキュメントは簡潔かつ正確に保ちます