migrate-to-rslib

Rslib への移行

目標

tsc および tsup のプロジェクトを、動作の変更を最小限に抑え、明確に検証しながら Rslib に移行します。

対応しているソースフレームワーク

• tsc
• tsup

移行の原則（必ず守ってください）

1. 公式ガイドを優先する：Rslib の移行ドキュメントを信頼できる情報源として扱います。
2. 変更は最小限から始める：まず基本的な移行を完了し、その後で高度な機能やカスタム動作を移行します。
3. ビジネスロジックを変更しない：ユーザーから明示的な依頼がない限り、ソースコードやビジネスロジックには手を加えないでください。
4. クリーンアップの前に検証する：必要に応じて古いツールの依存関係や設定を一時的に残し、Rslib で問題なくビルドできることを確認してから削除します。

ワークフロー

1. ソースツールを特定する

   • tsup
     • 設定：tsup.config.*
     • 依存関係：tsup
     • ビルドスクリプト：tsup を使用してプロジェクトをビルドします
   • tsc
     • 設定：tsconfig.json または tsconfig.*.json
     • 依存関係：typescript
     • ビルドスクリプト：tsc を使用してプロジェクトをビルドします。ただし、型チェックのみに使用する tsc（例：tsc --noEmit）は、tsc によるビルドプロジェクトには該当しないことに注意してください。

2. ツールごとの移行差分を適用する

   • tsc：references/tsc.md
   • tsup：references/tsup.md

3. 動作を検証する

   • ビルドコマンドを実行して、プロジェクトが正常にビルドできることを確認します。
   • 問題が残る場合は、旧プロジェクトの設定と移行ガイドを比較し、マッピングされていない項目があれば対応します。

4. クリーンアップして要約する

   • 検証に合格した後でのみ、不要になった依存関係や設定を削除します。
   • 変更したファイル、対応するオプション、手動での追加対応が必要な項目を要約します。