egoist/tsup
6 articles
前提知識
- ›TypeScript と Node.js のモジュールシステムに関する基本的な知識
- ›バンドラーの役割（エントリーポイント、出力フォーマット、externals など）についての概要理解
01
tsup アーキテクチャ概観：コードベースを読み解く
tsup リポジトリのディレクトリ構成、エントリーポイント、build() オーケストレーター、二層構造のプラグインアーキテクチャを俯瞰するガイドです。
02
設定の読み込み：CLIフラグからNormalizedOptionsまで
tsupが設定ファイルを探索し、bundle-requireでTypeScript設定を実行し、レイヤー構造の解決パイプラインでオプションを正規化する仕組みを解説します。
03
esbuildビルドパイプライン：オーケストレーション、プラグイン、出力処理
runEsbuild() を徹底解剖 — 自動外部化、組み込みesbuildプラグイン群、write:falseパターン、そしてPluginContainerによる出力パイプライン。
04
tsupのプラグインシステム：ビルド後のトランスフォームと組み込みプラグイン
tsup Plugin APIのライフサイクルフック、そしてシバン処理からRollupのツリーシェイキング、Terserによるminificationまで、すべての組み込みプラグインを詳しく解説します。
05
TypeScript 型定義ファイル：DTS 生成の2つの戦略
tsup の --dts と --experimental-dts を徹底比較 — Worker スレッド、rollup-plugin-dts、TypeScript コンパイラ API、API Extractor の仕組みを解説します。
06
Watch モード、onSuccess フック、そして開発フィードバックループ
chokidar、esbuild メタファイル、デバウンスビルド、クロスプラットフォームなプロセス管理を活用して、tsup がどのように高速かつインテリジェントな差分ビルドを実現しているかを解説します。