Node.jsのTypeScriptサポートについて

Created: 2024-07-28

Node.jsのTypeScriptサポートに関する議論を時系列でまとめたものです。

Start

Issue: Support typescript with --experimental-strip-types · Issue #208 · nodejs/loaders

SWCを使ってTypeScriptの型を削除することで、Node.jsのTypeScriptサポートを実現するという提案からスタートした。

最初の懸念としては、Node.jsのLTSは3年保守する必要があるので、依存によってNode.jsのLTSサポートが難しくなるという話。具体的には次のような懸念があった

SWCがSemverではないこと
TypeScriptがSemverではないこと

SWCについては、kdy1(SWC Author)からNode.jsが使うならそれ用のパイプラインを作るという話をした。

Node.js Loaders Team Meeting 2024-07-02

Node.js Loaders Team Meetingで、Node.jsにTypeScriptのサポートを入れたいという合意自体はある程度できた。実際にtype stripでそれが実現できるかは実験する必要があり、undiciの例にならって外部のパッケージとして進めることでコアのリリースサイクルの外で進めることが提案された。

@swc/wasm-typescript

SWCにTypeScriptの型を削除するWasmパッケージが追加された。

この時点では次のような変換をしていた。

- const foo: string = "foo";
+ const foo = "foo";

ts-blank-space

TypeScriptの型を取り除いてJavaScriptへ変換するブルームバーグ社内での実験についての知見が共有された。

次のような空白の位置を維持しながら型を削除することで、Source Mapを不要にしつつ行番号を維持できるという話が共有された。 Source Mapの対応をしないことで、TypeScript to JavaScriptの変換が単純になりパフォーマンスを良くできるという話があった。

- const foo: string = "foo";
+ const foo         = "foo";

これを受けて、 @swc/wasm-typescript の strip-only もこの対応をしている。

SWCのPlaygroundにも strip-only が追加された。

Playground: https://play.swc.rs/?version=1.7.3&code=H4sIAAAAAAAAA3VPywrCMBC85yuGnNqC9m6t4F8I4iHGrRbSXUhSpBb%2F3aQqnpzTDsxjxwqHiE5kgxB9z1e00InqRtVVhYvYcSCOJvbCMGcZIwysMyGgqtX7OEwPzE%2F11xBvhJ4j%2Bc5YyrYf2Z%2FtYrXpDXG0dnIt6iqpXc%2B0sjLkrGTRxBddNkp1I9sluitKzAoJnuLoGV%2Foz45cD6Y7cpSGCZ%e2BBjUp9jtLoNLUoN9h7b6ZtjnoL1A7tDketT80Lz%2BBB9h4BAAA%3D&config=H4sIAAAAAAAAA1WPSw7DIAwF9zkF8rrbdtE79BAWdSIifrKJVBTl7iUE0maH3xsz8jooBbNoeKq1PMsQkYX4nEsi2Sf8lARIOxTNJia49XaWvRrRCtVoOxpIyBOluiX3hoMNQajjLXPGmzH%2FC3VwkUnkCu4o%2BsnSVTc0JbjwXmrZDkk50qF%2FwA%2FqsvNjMPLqm4kXGrYvhlQioBQBAAA%3D&strip-types=

TypeScript Teamとの議論

問題として"TypeScriptのサポート"といったときに、型を取り除くだけで実現できない機能があるため、TypeScriptのサポートとは言えないという話がある。具体的には、enum、namespace、decoratorなど、TypeScriptが型だけではなくコードとして出力する例外的な機能もすでに存在している。これらのコードを出力する機能が今後増えると、Node.jsのLTSは守れなくなる問題が存在している。

またTypeScriptチームからも"TypeScriptサポート"といった場合のユーザーがどう思うかについての懸念があった。

nodejs/loaders#208 (comment)

これについてNode.jsのLoaders TeamとTypeScript Teamの間で議論が行われた。

Node.js Loaders team - YouTube

議論結果は次のコメントにまとめられている。

nodejs/loaders#208 (comment)

TypeScriptチームとしては、"TypeScriptサポート"といった場合には、enumやnamespaceも含めたものを想定している。一方で、このようなJavaScriptのコードを出力する機能(型を取り除くだけで実現できない機能)を増やす可能性はかなり低いという話もされた。

また、Node.jsがTypeSriptサポートをした場合に、.tsをnpmのregistryにpublishすることについての懸念と議論も行われた。課題は色々あるが、ひとまずはNode.jsがTypeScriptサポートについてのIterationを進めること自体のブロッカーはないという結論になった。

そのあともNode TSCで議論が行われて、Node.jsのユーザー体験に関わる部分なのでNode.js Loaders Teamだけではなくもっと広い範囲で話したほうが良いかもしれないという話がされた。また、node_modules/に対して現状の実装では適応するべきじゃないことやNode.jsとTypeScript Teamのコラボレーションをどうやってやるかなどについても議論された。

module: add --experimental-strip-types #53725

module: add --experimental-strip-types by marco-ippolito · Pull Request #53725 · nodejs/node

@swc/wasm-typescriptをラップしたAmaroというモジュールをNode.jsに追加するPRがマージされた。次のような実験的なフラグを使って、TypeScriptのコードから型を取り除いたJavaScriptとして実行できるようになった。

node --experimental-strip-types main.ts

Roadmap for experimental TypeScript support #217

Node.jsのTypeScriptサポートについてのロードマップは次のIssueで議論されている。

Roadmap for experimental TypeScript support · Issue #217 · nodejs/loaders

まだenumやnamespaceなどをどうするか、拡張子がないファイルのimportの対応、node_modules/以下のファイルの.tsは扱うべきなのか(npmにpublishされたものをどうするかという話)、@swc/wasm-typescriptを使って実現しているがパフォーマンスを考えるとネイティブに実装するかなどの論点が残っている。

nodejs/typescript: TypeScript support in Node.js core

Node.js CoreでのTypeScriptサポートについて議論するリポジトリが作られた

module: add --experimental-transform-types flag by marco-ippolito · Pull Request #54283 · nodejs/node

--experimental-transform-typesフラグを元にenumとnamespaceの変換をサポートした。

Tsconfig option to disallow features requiring transformations which are not supported by Node.js' --strip-types · Issue #59601 · microsoft/TypeScript

Node.jsのTypeScriptサポートは限定的で、tsconfig.jsonでそのNoe.jsのTypeScriptサポートに対応するオプションをまとめて有効化したいというIssue

azu/README.md