HN 日本語サマリー

← 一覧へ戻る
プログラミング

Vercel製Scriptc: JavaScriptエンジンをバイナリに含めないTypeScript-to-Nativeコンパイラ

Scriptc by Vercel: TypeScript-to-Native compiler, no JavaScript engine in binary (github.com)

249 pointsby maxloh140 コメント

要約

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依存関係を参照してください。

ドキュメント

貢献

ソースセットアップ、テスト、ネイティブアーティファクトのビルド、およびドキュメント開発については、CONTRIBUTING.mdを参照してください。