TS7.0移行: tsconfig.json / ソースコード移行

[9c5s]

概要

TypeScript 6.0 → 7.0 移行に向けた tsconfig.json の設定変更とソースコード互換性対応。

影響度: 小 — TS5.x モダナイゼーション済みのため大半は対応不要。

tsconfig.json 変更項目

項目	現在の値	必要な変更	理由
rootDir	未設定	"." を明示追加	TS6.0 で rootDir 推論ロジックが変更されるため、現在の暗黙の動作を明示して固定する
esModuleInterop	未設定	true を明示追加	TS6.0 で強制化
compileOnSave	true	削除を検討	非標準オプション、TS6.0/7.0 での扱い要確認
lib	["es2022", "DOM", "DOM.Iterable"]	"DOM.Iterable" 削除可	TS6.0 でデフォルト含有
module	"NodeNext"	変更不要	明示指定済み
target	"ES2022"	変更不要	明示指定済み
strict	true	変更不要	TS6.0 デフォルトと一致
types	["node"]	変更不要	明示指定済み
forceConsistentCasingInFileNames	true	変更不要	TS6.0 で strict に含有
noFallthroughCasesInSwitch	true	変更不要	削除・変更予定なし
noImplicitReturns	true	変更不要	削除・変更予定なし
skipLibCheck	true	変更不要	削除・変更予定なし

ソースコード影響

影響なし。以下は全て互換:

• strict: true — 既設定
• types: ["node"] — 既に明示指定
• target: ES2022 — ES3/ES5 非使用
• module: NodeNext — AMD/UMD 非使用
• JSDoc タグ — @enum, @constructor 未使用
• as const satisfies パターン (network.ts L904, L918) — 完全サポート
• enum / namespace — 未使用
• import assertions (assert) — 未使用

注: tsconfig.json の include は ["src/**/*", "examples/**/*"] のため、型チェック対象は src/ (6ファイル) + examples/ を含む。

検証手順

• ts5to6 ツールによる自動検証
• npm run build で dist 再生成
• npm run test で全テスト実行

チェックリスト

• tsconfig.json に rootDir 追加
• tsconfig.json に esModuleInterop 追加
• compileOnSave の扱い判断 (削除 or 維持)
• lib から DOM.Iterable 削除 (任意)
• ts5to6 ツール実行
• ビルド・テスト検証

[coderabbitai]

Coding Plan

Summary

• tsconfig.json への設定追加（rootDir、esModuleInterop）のみで対応完了
• ソースコードは既に TS6.0/7.0 互換であるため変更不要
• 非標準オプション compileOnSave を削除してコンフィグをクリーンアップ
• ビルド・テストで互換性を検証

Design Choices

Design Choice 1: `compileOnSave` オプションの扱いについて

Options Considered:

1. 削除する — 非標準オプションであり、実際のビルドは tsup で行われるため不要
2. 維持する — 既存の IDE 統合を壊さないよう保守的に対応

Chosen Option: 1

Rationale: 本プロジェクトのビルドは tsup で行われており、compileOnSave は実質的に使用されていない。非標準オプションを残すリスクを避けるため削除する。

💡 User Tips

Regenerate the plan with different choices with @coderabbitai <feedback>.

Implementation Steps

Phase 1: tsconfig.json 設定更新

TypeScript 6.0/7.0 互換性のために必要な設定変更を tsconfig.json に適用する。

Task 1: 必須設定の追加

TS6.0 で必須となる設定を明示的に追加する。

• tsconfig.json の compilerOptions に rootDir: "." を追加
  • TS6.0 で rootDir の推論ロジックが変更されるため、現在の暗黙の動作を明示して固定
• tsconfig.json の compilerOptions に esModuleInterop: true を追加
  • TS6.0 で強制化されるオプションを明示指定

Task 2: 非推奨/冗長設定の整理

不要な設定を削除してコンフィグをクリーンアップする。

• tsconfig.json のトップレベルから compileOnSave: true を削除
  • 非標準オプションであり、実際のビルドは tsup で行われるため不要
• lib 配列から "DOM.Iterable" を削除（任意）
  • TS6.0 で DOM に含有されるようになるため冗長

🤖 Prompt for AI agents

`tsconfig.json` に対して TypeScript 6.0/7.0 互換性のための設定変更を行うフェーズです。ソースコードの変更は不要です。

- `compilerOptions` に以下の設定を追加する:
  - `rootDir: "."` を追加（TS6.0 で rootDir の推論ロジックが変更されるため、現在の暗黙の動作を明示して固定する）
  - `esModuleInterop: true` を追加（TS6.0 で強制化されるオプションを明示指定する）
- `tsconfig.json` のトップレベルから `compileOnSave: true` を削除する（非標準オプションであり、実際のビルドは tsup
で行われるため不要）
- `lib` 配列から `"DOM.Iterable"` を削除する（任意。TS6.0 で `DOM` に含有されるようになるため冗長）

Phase 2: 検証

設定変更後のビルドとテストを実行し、互換性を確認する。

Task 1: ビルド検証

変更後の設定でビルドが正常に完了することを確認する。

• npm run build を実行して dist/ の再生成を確認
• TypeScript コンパイルエラーが発生しないことを確認
• 生成された成果物が既存と同等であることを確認

Task 2: テスト実行

ユニットテストと E2E テストが全てパスすることを確認する。

• npm run test でユニットテストを実行
• npm run test:e2e で E2E テストを実行（存在する場合）
• 全テストがパスすることを確認

🤖 Prompt for AI agents

設定変更後の互換性を検証するフェーズです。以下のコマンドを順番に実行し、エラーがないことを確認します。

- `npm run build` を実行して `dist/` が正常に再生成されることを確認する（TypeScript
コンパイルエラーが発生しないこと、生成された成果物が既存と同等であること）
- `npm run test` でユニットテストを実行し、全テストがパスすることを確認する
- `npm run test:e2e` で E2E テストを実行し（存在する場合）、全テストがパスすることを確認する

Research

本プロジェクトは TypeScript 5.9.3 で構築された Node.js ライブラリで、tsup を使用してビルドを行っている。tsconfig.json は既に strict: true、module: NodeNext、target: ES2022 などモダンな設定を採用済み。ソースコードは src/ 配下の6ファイルで構成され、enum や namespace、import assertions は未使用。as const satisfies パターンが network.ts で使用されているが、これは TS6.0/7.0 で完全サポートされている。

---

🚀 Next Steps

🤖 All AI agent prompts combined

Task: 1

`tsconfig.json` に対して TypeScript 6.0/7.0 互換性のための設定変更を行うフェーズです。ソースコードの変更は不要です。

- `compilerOptions` に以下の設定を追加する:
  - `rootDir: "."` を追加（TS6.0 で rootDir の推論ロジックが変更されるため、現在の暗黙の動作を明示して固定する）
  - `esModuleInterop: true` を追加（TS6.0 で強制化されるオプションを明示指定する）
- `tsconfig.json` のトップレベルから `compileOnSave: true` を削除する（非標準オプションであり、実際のビルドは tsup
で行われるため不要）
- `lib` 配列から `"DOM.Iterable"` を削除する（任意。TS6.0 で `DOM` に含有されるようになるため冗長）
===============================================================================

Task: 2

設定変更後の互換性を検証するフェーズです。以下のコマンドを順番に実行し、エラーがないことを確認します。

- `npm run build` を実行して `dist/` が正常に再生成されることを確認する（TypeScript
コンパイルエラーが発生しないこと、生成された成果物が既存と同等であること）
- `npm run test` でユニットテストを実行し、全テストがパスすることを確認する
- `npm run test:e2e` で E2E テストを実行し（存在する場合）、全テストがパスすることを確認する

💡 Iterate on the plan with: @coderabbitai <feedback>

Example Feedback
- `@coderabbitai` You can skip phase 3. Add a simple unit test case for phase 2.
- `@coderabbitai` For design choice 1 go ahead with option 3 and replan.

---

💬 Have feedback or questions? Drop into our discord!

[coderabbitai]

🔗 Related PRs

#8 - docs: GitHub Wikiの作成とMarkdown品質管理の導入 [merged]
#16 - feat(ci): changeset ファイルの検証フックを追加 [merged]
#37 - feat: JSDocカバレッジをリンターで自動検証する [merged]
#39 - feat: TypeDocによるAPIドキュメント自動生成 (#6) [merged]
#41 - refactor: TypeScript 5.xモダナイゼーション (#35) [merged]

---

📝 Issue Planner

_{Check the box below or use the @coderabbitai plan command to generate an implementation plan and prompts that you can use with your favorite coding assistant.}

• Create Plan

---

🧪 Issue enrichment is currently in open beta.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!