宣言ファイルのセクションでは、高品質な TypeScript 宣言ファイルの書き方を学ぶことができます。始めるにあたって、TypeScript 言語の基本的な知識が必要です。
まだ読んでいない場合は、TypeScript ハンドブックを読んで、基本的な概念、特に型とモジュールについて理解してください。
.d.ts ファイルの仕組みを学ぶ必要がある最も一般的なケースは、型のない npm パッケージに型を付ける場合です。その場合は、モジュール .d.tsに直接進んでください。
宣言ファイルのセクションは、以下のセクションに分かれています。
宣言リファレンス
多くの場合、基底となるライブラリの例のみを参考に宣言ファイルを作成しなければなりません。宣言リファレンスセクションでは、多くの一般的な API パターンと、それぞれに宣言を作成する方法を示します。このガイドは、TypeScript のすべての言語構造に精通していない TypeScript 初心者を対象としています。
ライブラリ構造
ライブラリ構造ガイドは、一般的なライブラリ形式と、各形式に適切な宣言ファイルを作成する方法を理解するのに役立ちます。既存のファイルを編集している場合は、このセクションを読む必要はおそらくありません。新しい宣言ファイルの作成者は、ライブラリの形式が宣言ファイルの作成にどのように影響するかを正しく理解するために、このセクションを読むことを強くお勧めします。
テンプレートセクションには、新しいファイルを作成する際の出発点として役立つ宣言ファイルが多数あります。構造がすでにわかっている場合は、サイドバーの d.ts テンプレートセクションを参照してください。
推奨事項と非推奨事項
宣言ファイルの多くのよくある間違いは、簡単に回避できます。推奨事項と非推奨事項セクションでは、よくあるエラーを特定し、それらを検出する方法と修正方法について説明します。よくある間違いを避けるために、全員がこのセクションを読む必要があります。
詳細解説
宣言ファイルの仕組みに興味のある経験豊富な作成者のために、詳細解説セクションでは、宣言の作成における多くの高度な概念を説明し、これらの概念を活用して、よりクリーンで直感的な宣言ファイルを作成する方法を示します。
npm に公開する
公開セクションでは、宣言ファイルを npm パッケージに公開する方法と、依存パッケージを管理する方法について説明します。
宣言ファイルを見つけてインストールする
JavaScriptライブラリのユーザー向けに、「消費」セクションでは、対応する宣言ファイルを見つけてインストールするための簡単な手順をいくつか紹介しています。
