TypeScript 7.1 Betaが新しいAPIとコンテンツマッパーを追加

Microsoftは2026年10月20日、TypeScript 7.1 Betaをリリースしました。主な役割は、プログラムから使えるAPIを復活させることです。これは、エディターのプラグインやリンターがコンパイラーとやり取りするための仕組みです。TypeScript 7.0にはこのAPIがなかったため、多くの人気ツールがTypeScript 6.0にとどまっていました。

APIが重要な理由

2026年7月8日にリリースされたTypeScript 7.0は、コンパイラーをプログラミング言語Goで書き直したものでした。Microsoftによると、TypeScript 6より「およそ10倍」高速です。しかし、他のツールが土台にしているAPIがないままリリースされました。

NT Compatibleによると、この欠落によって、Vueのエディター対応を支えるVolar、Svelteの言語サービス、typescript-eslint、Angularのテンプレートチェッカーといったツールが足止めされました。これらのツールの利用者は、TypeScript 6.0を使い続ける必要がありました。

Microsoftの発表によると、7.1のAPIはtypescript/sync、typescript/async、typescript/fs、typescript/astといったエントリーポイントに分かれています。変更の追跡にはスナップショットを使い、仮想ファイルシステムも使います。ツールが使い終わったプログラムは、明示的に閉じる必要があります。ただし、チームが6.0から離れるには、引き続き各ツールの個別のアップデートが必要です。

Vue、Svelte、Astro向けのコンテンツマッパー

多くのフレームワークは、独自のファイル形式にコードを保存しています。たとえば.vueファイルは、HTML、JavaScript、CSSを1つにまとめています。コンテンツマッパーは、そのようなファイルを仮想的なTypeScriptに変換するプラグインです。元の行に戻るためのマップも付きます。これにより、エディターはファイルの中で型をチェックし、定義へジャンプできます。

マッパーはtsconfig.jsonのcontentMappersに記載します。TypeScriptが実行するプログラムなので、--runExternalCodeフラグを付けたときだけ動きます。VS Codeでは、さらに信頼済みのワークスペースとjs/ts.contentMappers.enabled設定も必要です。発表の投稿には、Vue、Svelte、Astro、MDX、Ember、CSS Modules向けの初期のマッパーへのリンクがあります。

新しい言語機能

このベータ版では、新しいJavaScript標準の機能も追加されています。

機能	内容
アンビエントモジュールでのインポート属性	declare module "*" with { type: "css" }で、ファイル名ではなく属性によってインポートに型を付ける
ソースフェーズインポート	import sourceで、WebAssembly.Moduleなどのモジュールを実行せずに読み込む
es2026ターゲットとlib	Math.sumPrecise()、Error.isError()、Array.fromAsync()、Map.prototype.getOrInsert()と、Uint8Arrayのbase64およびhexメソッドを追加
新しいesnextメソッド	Promise.allKeyed、Iterator.zip、Iterator.prototype.chunksなど

既存のコードが動かなくなる可能性のある変更が2つあります。分配条件型（distributive conditional types）のチェックが厳しくなり、「Type 'B' does not satisfy the constraint 'A'.」のようなエラーが出ることがあります。更新されたDOMの型定義によって、結果が変わる可能性もあります。

7.0との速度とメモリの比較

Microsoftは、4つの型チェックスレッドを使い、出力ファイルなしで、実際の5つのコードベースを計測しました。どれもTypeScript 7.0より速く、使用メモリも少なくなりました。

コードベース	7.0の時間	7.1 Betaの時間	メモリ削減
mui-docs	22.2秒	11.9秒	49.6%
t3code-server	26.5秒	19.1秒	24.6%
sentry	19.6秒	15.1秒	20.8%
vscode	21.6秒	17.7秒	17.2%
bluesky	4.48秒	3.89秒	15.8%

npm install -D typescript@betaでインストールできます。GitHubのリリースには、npmのバージョンが7.1.0-betaと記載されています。Microsoftは「約1か月後」にリリース候補版を、その後まもなく正式版を出す予定です。NT Compatibleは、予定日を11月10日と11月24日としています。Bunは今月、別の道を選びました。1.4.3リリースで、独自のTypeScript型チェッカーであるbun checkを追加しました。

開発者にとっての意味

多くのチームにとって、7.1はTypeScript 6からの移行を可能にするリリースです。

• ツールの提供元を注視してください。 Volar、Svelteの言語サービス、typescript-eslint、Angularのせいで6.0にとどまっているなら、それぞれのissueトラッカーで7.1 APIへの対応状況を追ってください。あなたのアップグレードは、それらのツールのアップグレード次第です。
• 今すぐブランチでベータ版を試してください。 typescript@betaをインストールして、プロジェクトの型チェックを実行してください。正式リリースの前に、厳しくなった条件型のルールによる新しいエラーがないか確認してください。
• --runExternalCodeは、依存関係を決めるときと同じように扱ってください。 コンテンツマッパーは、型チェック中にコードを実行します。信頼できるマッパーパッケージだけで有効にし、CIではこのフラグを確認してください。
• 自分の環境での高速化を測ってください。 1.2倍から1.9倍という向上は、5つのコードベースから得られた数字です。自分のプロジェクトで、tsc --noEmitの時間を移行の前後で測ってください。