こんにちは。TypeScriptの世界へようこそ！
TypeScriptを触り始めると、避けて通れないのが `tsconfig.json` という設定ファイルですよね。「オプションが多すぎて何が何だか……」と頭を抱えてしまうその気持ち、痛いほどわかります。
今日は、その中でも「これを知っておくと、ちょっとした通（つう）になれる」という便利な設定、`emitDeclarationOnly` についてお話しします。
—
そもそも、TypeScriptは何をしているの？
まず、TypeScriptが普段何をしているか、ちょっとだけ例え話をさせてください。
TypeScriptは、いわば「設計図（型定義）」をもとに「製品（JavaScript）」を組み立ててくれる優秀な職人さんです。普段は、設計図を読み込んで、JavaScriptという製品をせっせと作り出し、ついでに「ここが設計ミスだよ！」と指摘もしてくれます。
ところが、今回の主役である `emitDeclarationOnly` をオンにすると、この職人さんの仕事ぶりがガラッと変わります。
「製品（JavaScript）は作らなくていい。設計図（型定義ファイル）だけを届けてくれ！」
という指示を出すことになるんです。
なぜ「設計図だけ」が必要なの？
「えっ、JavaScriptを作らないなら、TypeScriptを使う意味がないのでは？」と思いますよね。
実は、現場では「JavaScriptの生成は別のツール（Viteやesbuildなど）に任せたい」ということがよくあります。最近のフロントエンド開発では、TypeScriptをJavaScriptに変換する速度を爆速にするため、TypeScriptコンパイラ自身には変換をさせないという構成がトレンドだからです。
そんな時、TypeScriptコンパイラには「変換はしなくていいから、君の得意な型定義ファイル（.d.ts）の作成だけ担当して！」とお願いする。これが `emitDeclarationOnly` の出番です。
設定はたったのこれだけ
`tsconfig.json` に、こんな風に書き加えるだけです。
{
“compilerOptions”: {
// 他の設定はここに…
// trueにすると、JSファイルを出力せず、型定義ファイル(.d.ts)だけを作る
“declaration”: true,
“emitDeclarationOnly”: true
}
}
※ 注意点として、`declaration: true` もセットで必要です。「型定義ファイルを作るぞ！」という宣言がないと、いくら「型定義ファイルだけ出力して！」と言っても動いてくれませんからね。
どんな時に嬉しいの？（実用的なメリット）
この設定が真価を発揮するのは、ライブラリを作っている時や、ビルド時間を短縮したい時です。
1. ビルドの分担: JavaScriptへの変換は「Vite」などの爆速ツールに任せて、TypeScriptは「型定義の生成」という重たい作業に集中してもらう。役割分担をすることで、全体のビルドがスムーズになります。
2. 配布物の整理: 他の人が使うためのライブラリを作っている時、配布フォルダに「余計なJavaScriptファイル」を混ぜずに、「型定義ファイルだけ」をきれいに納品できるんです。
—
最後に：つまずいても大丈夫
「設定ファイルなんて書き間違えたらどうしよう……」と不安になる必要はありません。
もし動かなくなったとしても、それはあなたが少しだけTypeScriptの深い領域に足を踏み入れた証拠です。最初は `emitDeclarationOnly` の動きがイメージできなくても、「型定義ファイルだけ欲しい時に使うんだな」と心の片隅に置いておくだけで十分です。
TypeScriptは、あなたの開発を楽にするための道具です。最初から完璧に使いこなす必要なんてありません。少しずつ、自分のペースで「あ、これってこういうことか！」とパズルのピースが埋まる感覚を楽しんでいってくださいね。
もし分からないことがあれば、いつでもまた聞きに来てください。あなたのエンジニアライフを、心から応援しています！
コメント