| name | personal-setup-typescript |
| description | プロジェクトに TypeScript 環境をセットアップします。typescript（ネイティブコンパイラ）のインストール、適切な @tsconfig/bases の選定と tsconfig.json への反映、package.json への typecheck スクリプト追加、CI への typecheck ジョブ追加を行います。TypeScript のセットアップを求められたときに使用してください。 |
TypeScript セットアップ
対象
npm/yarn/pnpm/bun のいずれかを使うプロジェクトを対象とする。
Deno は独自の TypeScript ツールチェイン（deno check）を持ち、jsr:/npm:/https:// などの Deno 固有のモジュール指定子を tsc が解決できないため、このスキルの対象外とする。
ワークフロー
- パッケージマネージャー（とモノレポ構成）の検出
typescript のインストール- tsconfig を分割するか判断し、該当するパターンに従う
- CI への
typecheck ジョブ追加
1. パッケージマネージャー（とモノレポ構成）の検出
プロジェクトの packageManager フィールドやロックファイルから npm/yarn/pnpm/bun を検出する。
以降のインストールはすべてこのパッケージマネージャーで行う。
package.json の workspaces フィールドや pnpm-workspace.yaml などがあればモノレポと判断し、パッケージ一覧を検出する。
モノレポの場合の追加の考慮事項は references/monorepo.md にまとめてあり、以降の手順とパターンは各パッケージに対して適用する。
2. typescript のインストール
typescript の最新バージョンを devDependencies としてインストールする。
typescript パッケージの tsc コマンドの実体は typescript-go 由来のネイティブコンパイラであり、コマンド名自体は従来と変わらず tsc のままである（tsgo/@typescript/native-preview は nightly 版向けのパッケージ名であり、通常導線では使わない）。
モノレポの場合はルートに1回だけインストールし、全パッケージで共有する（詳細は references/monorepo.md）。
3. tsconfig を分割するか判断
プロジェクト内に、アプリケーションのソースコード（例: src/）とは異なる実行環境で動く TypeScript ファイルがあるか確認する。
典型例は、ブラウザ向けにビルドされる src とは別に、Node.js 上で直接実行されるビルドツールの設定ファイル（vite.config.ts、vitest.config.ts など）が存在するケースである。
たとえば Vite の公式テンプレートは、この理由で tsconfig を分割している。
モノレポの場合は、検出した各パッケージについてこの判断を行う。
判断できたら、該当するパターンに従う。
4. CI への typecheck ジョブ追加
references/ci.md に従う。
