Vercel製Scriptc: JavaScriptエンジンをバイナリに含めないTypeScript-to-Nativeコンパイラ
Scriptc by Vercel: TypeScript-to-Native compiler, no JavaScript engine in binary (github.com)
要約
Scriptcは、TypeScriptコードをJavaScriptエンジンなしで高速なネイティブ実行ファイルにコンパイルするツールです。既存のTypeScriptコードを変更することなく、Node.jsと同様の動作をするバイナリを生成できます。静的コンパイルを基本としつつ、動的実行やネイティブFFIなどの機能も提供し、パフォーマンスと正確性を重視しています。
全文翻訳
scriptc
[画像: Vercel Labs Experiment] [画像: npm version: scriptc] [画像: License: Apache-2.0] [画像: npm downloads per month: scriptc]
scriptcは、TypeScriptとJavaScriptをネイティブ実行可能ファイルおよびWebAssemblyにコンパイルします。TypeScriptコンパイラによって型チェックされた型情報を使用してマシンコードを生成し、生成された出力はNode.jsがインストールされていなくても実行できます。プログラムがインポートするnpmパッケージも、それと一緒にコンパイルされます。scriptcがコンパイルできないコードは、ビルド時に診断情報とともに報告され、可能な場合は書き換えのヒントも提供されます。
scriptcは実験的なプロジェクトであり、JavaScript、TypeScript、およびNode.js APIのサブセットをサポートしています。既存のプログラムに対してscriptc coverageを実行すると、どの程度コンパイルできるかを確認できます。詳細は制限事項およびNode.js互換性リファレンスを参照してください。
インストール
Node.js 24以降とnpmを使用してインストールします。
$ npm install -g scriptc
インストールされたコンパイラは、macOS、Linux、およびWindowsでネイティブに実行されます。Node.jsは、インストール時とscriptc runでWASIモジュールを実行する場合にのみ必要です。スタンドアロンのコンパイラアーカイブもGitHub Releasesから入手できます。
実行可能ファイルをビルドするには、リンカとプラットフォームSDKまたはsysrootが必要です。前提条件についてはクイックスタートを、ホスト要件、クロスコンパイル、およびWebAssemblyについてはプラットフォームサポートを参照してください。
プログラムのビルド
hello.tsを作成します。
const who = process.argv.length > 2 ? process.argv[2] : "world";
console.log(`hello, ${who}`);
scriptc runはファイルをコンパイルし、その結果を実行します。
$ scriptc run hello.ts
hello, world
scriptc buildは実行可能ファイルを書き出します。
$ scriptc build hello.ts -o hello >/dev/null
$ ./hello scriptc
hello, scriptc
これらの例ではPOSIXシェル構文を使用しています。Windowsでは、hello.exeをビルドして. hello.exeで実行します。
ビルド前にコンパイルされるかを確認するには、scriptc coverage hello.tsを使用します。詳細はカバレッジレポートを参照してください。
Node APIの使用
サポートされているNode APIはネイティブランタイムにコンパイルされます。例としてserver.tsを示します。
import { createServer } from "node:http";
const server = createServer((req, res) => {
res.setHeader("content-type", "application/json");
res.end(JSON.stringify({ path: req.url }));
});
server.listen(8080, () => {
console.log("listening on http://localhost:8080");
});
$ scriptc build server.ts -o server >/dev/null
$ ./server
listening on http://localhost:8080
npmパッケージの使用
npmパッケージはコードと一緒に実行可能ファイルにコンパイルされるため、実行時にnode_modulesを読み込みません。
cli.tsを作成します。
import pc from "picocolors";
console.log(pc.green("hello from scriptc"));
$ npm install picocolors
$ scriptc build cli.ts -o cli >/dev/null
$ ./cli
hello from scriptc
パッケージのサポートは部分的です。どのパッケージがコンパイルされるか、およびそれらをチェックする方法については、npm依存関係を参照してください。
ドキュメント
- はじめに: scriptcとは何か、そして何が構築できるか。
- クイックスタート: インストールと最初の実行可能ファイルの作成。
- カバレッジレポート: 既存のプログラムがコンパイルされるかどうかを確認します。
- プラットフォームサポート: クロスコンパイルとWebAssembly。
- CLIリファレンス: コマンド、オプション、および出力フォーマット。
- ネイティブプログラムオブジェクト: コンパイラ出力を外部ビルドで使用します。
- ネイティブFFI: コンパイル済みプログラムからC ABI関数を呼び出します。
- WebAssemblyモジュール: WASIモジュールをビルドおよび埋め込みます。
- 例: このリポジトリ内のプログラムと統合例。
貢献
ソースセットアップ、テスト、ネイティブアーティファクトのビルド、およびドキュメント開発については、CONTRIBUTING.mdを参照してください。