メインコンテンツへスキップ
見出し画像

TypeScript 7時代の開発環境。ネイティブバイナリで固めた爆速TSテンプレート

    TypeScript 7 が登場し、コンパイラが Go で全面的に再設計され、tsc がネイティブバイナリへと進化しました。

    この節目に開発環境を一から再構築してみたところ、型チェッカーから linter、formatter に至るまで、ほとんどがネイティブバイナリで動く圧倒的な高速環境へと生まれ変わりました。JavaScript で動いているのはテストランナーくらいという、まさに新時代の幕開けを感じるスタックです。

    手元で仕上がった構成の完成度が非常に高く、今後の新規プロジェクトでも即座に使い回したくなったため、GitHub でテンプレートリポジトリとして公開することにしました。

    TS7 を軸に据えるとツールチェーンの最適解は自然と定まる

    開発環境を組む上で最も大切にした結論は、「TypeScript 7 のネイティブ化という最大の恩恵を邪魔しない構成へ寄せること」です。

    新世代の高速性を活かしきるために、周辺ツールも同じ思想を持つネイティブ実装を優先して採用しました。結果として、互いの責務が整理された無駄のないスタックに収束したと考えています。

    最初は ChatGPT に全体像をスケッチしてもらい、それを Claude Code と対話しながら細部を削り出していきました。AI と壁打ちを重ねる過程で、より堅牢で無駄のないスタックへと磨き上げられていった印象です。

    TS7 の型情報を活かせる Lint は現在 oxlint 一択である

    Linterにoxlintを選定した理由は、「私が比較した主要な選択肢の中で、TypeScript 7本体のtypescript-goを直接使って型意味解析できたのがoxlintだったから」です。

    非同期処理におけるPromiseのawait忘れ(no-floating-promises)のように、型情報を前提とするLintルールをTS7で運用するための主要な候補は3つありました。

    1. typescript-eslint:TS 7.0時点ではプログラム向けAPIが未搭載(7.1で刷新予定)。TypeScript公式は暫定策として@typescript/typescript6の併用を案内していますが、Lint側ではTS6の型システムを利用する構成になります。

    2. Biome 2:TypeScriptに依存しない独自の型推論エンジンで動作します。ただし、noFloatingPromisesルールは現時点でまだnursery(実験的機能)の段階です。

    3. oxlint + oxlint-tsgolint:Oxcプロジェクトが2026年7月に型付きLintを安定化させました。TS7のGo実装であるtypescript-go上で直接動作し、主要な型付きルールのほとんどをネイティブ実装でカバーしています。

    typescript-eslintではTS6、Biomeでは独自の型推論エンジンを利用するため、いずれもtscとまったく同じTS7の型エンジンを共有する構成にはなりません。

    そこで、型解釈エンジンの差をできるだけなくしたかったので、tscと同じTypeScript 7のGo実装を利用するoxlint-tsgolintを選びました。本当に期待通りに役割分担できているのか、わざと型エラーとawait忘れを仕込んだテストコードで検証してみました。

    src/_probe.ts(5,9): error TS2322: Type 'string' is not assignable to type 'number'.
    src/_probe.ts:4:3: error typescript(no-floating-promises): Promises must be awaited, ...
    

    tsc は純粋な型エラーのみを咎め、oxlint は非同期処理の作法違反だけを検出しています。

    なお、oxlint には型検査そのものを行うオプション(typeCheck)も用意されていますが、あえて無効化しています。同じエラーを複数のツールから咎められると、開発者たる私が認知負荷で疲弊してしまうからです。

    • 型の整合性: tsc に任せる

    • コード品質・危険な構文: oxlint に任せる

    • 実行時の振る舞い: Vitest に任せる

    このように三者の境界線を明確にすることで、迷いのない開発体験が生まれることでしょう。

    フォーマッターの oxfmt に関しては、バージョンが 0.7 系統ということもあり、成熟度だけで見れば Biome に軍配が上がるかもしれません。ですが、今回は「最先端のネイティブツールチェーンで統一する達成感」を味わうためだけに、Oxc ブランドで揃える選択をしました。

    Nix・Node 26・pnpm を調和させる実践的なテクニック

    最新技術を詰め込むと、ツール同士の思わぬ衝突に悩まされるものです。

    1. mise と direnv の競合を防ぐ

    普段は mise を愛用している私ですが、このテンプレートでは再現性を高めるため Nix flake に一本化しました。

    ただ、mise と direnv を併用していると、ディレクトリ移動のたびに両者が PATH の奪い合いを演じてしまいます。そこで、リポジトリのルートに最小限の mise.toml を配置しました。

    [settings]
    disable_tools = ["node", "pnpm"]
    

    「このディレクトリ内では Node.js と pnpm の権限を放棄する」と mise 側に明示させるアプローチです。これなら、チーム内で mise を使っていないメンバーに何の影響も与えることなく、環境の平和を守れます。

    2. pnpm の自動ダウンロード暴走を devEngines で封じる

    pnpm 11 以降は、package.json の packageManager フィールドを参照して自動で指定バージョンを取得・実行しようとします。しかし、nixpkgs が提供する pnpm はごくわずかに最新版とズレることがあり、この自動取得が走ると Nix の隔離環境から外れてしまうリスクがありました。

    そこで packageManager は指定せず、devEngines による厳密なバージョンガードを採用しています。

    "devEngines": {
      "runtime": { "name": "node", "version": "^26", "onFail": "error" },
      "packageManager": { "name": "pnpm", "version": "^12.3.0", "onFail": "error" }
    }
    

    onFail: "error" を指定しておくことで、意図しない自動取得を防ぎつつ、バージョンが合致しない環境では即座にエラーとして安全に停止させています。

    3. ビルド工程の全廃:Node.js 26 の Type Stripping

    Node.js 26 では型注釈をそのまま読み飛ばす「Type Stripping」が安定して利用できるため、本テンプレートにはトランスパイル用のビルドステップ(.js の書き出し)が存在しません。

    import { greet } from "./greet.ts";
    
    console.log(greet(`TypeScript 7 on Node.js ${process.version}`));
    

    インポート文には堂々と .ts 拡張子を付与し、node src/index.ts でそのまま起動します。これに伴い、tsconfig.json では noEmit と allowImportingTsExtensions を有効化し、不要になった中間ファイルの管理から完全に解放されました。

    意思決定を記録し、変わり続けるエコシステムを身軽に歩く

    わずか 5 コマンドで、この環境を手元に呼び出すことができます。

    # テンプレートからリポジトリを生成
    gh repo create my-app --public --template sho7650/ts7-template --clone
    cd my-app
    
    # 環境の有効化とパッケージ導入
    direnv allow
    pnpm install
    
    # 統合チェックを実行
    pnpm run check
    

    pnpm run check を叩けば、型チェック、Lint、フォーマット検証、そしてカバレッジ 80% を課したテストが一瞬で走り抜けます。エディタを開けば VS Code が必要な拡張機能を案内し、内蔵の TS バージョンがプロジェクトのものへと自動で揃う仕掛けです。

    最後に少しだけ。このテンプレートを組むにあたり、設定ファイル以上に価値があるのは docs/decisions.md に残した設計決定記録(ADR) です。D1 から D21 に至るまで、「なぜ Biome ではなく oxlint なのか」「なぜビルド工程を省いたのか」といった文脈をすべて言語化してあります。

    何度でもいいますが、判断は重要な要素です。ADR を残せ、エンジニアよ。

    TypeScript 7 を取り巻く状況は今まさに猛スピードで進化しています。将来 typescript-eslint が TS7 に完全対応したとき、あるいは oxfmt が 1.0 に達したとき、立ち止まって「そもそも何が理由だったっけ?」と迷わずに済むようにするためです。

    判断の土台となった前提条件さえ明文化されていれば、エコシステムが変化したときも、該当する項目だけを軽やかにアップデートできます。

    今、このテンプレートを更に使いがっての良いものにしようと copier を使ったテンプレート展開も検討しています。

     
     
    元IBMのSalesforceITアーキテクト。 ITアーキテクチャの深淵から、日々の何気ない生き様まで、思考の軌跡を「毎日」綴っています。 座右の銘は「人生即是遊戯」。 家族とPerfume、オーディオを愛する私の遊び場が、あなたの日常のちょっとした刺激になれば幸いです。

    あなたへのおすすめ