chore: prepare v0.2.0 (#593)

- Synchronize published compiler, runtime, and native platform packages at 0.2.0. - Document the native CLI, LLVM migration, and compatibility and performance improvements. - Keep release version checks scoped to published packages.
2026-10-02 00:25:34 +08:00 · 2026-09-30 16:15:10 -05:00
parent 18c9a4233b
commit 51ca803c16
31 changed files with 63 additions and 32 deletions
@@ -297,6 +297,9 @@ jobs:
        run: |
          VERSION="${{ needs.check-release.outputs.version }}"
          for pkg in packages/runtime packages/runtime-* packages/llvm-* packages/compiler packages/cli packages/cli-*; do
+            if [ "$(node -p "require('./$pkg/package.json').private === true")" = "true" ]; then
+              continue
+            fi
            V=$(node -p "require('./$pkg/package.json').version")
            if [ "$V" != "$VERSION" ]; then
              echo "Version mismatch: $pkg is $V, expected $VERSION"
@@ -6,6 +6,36 @@ All notable changes to scriptc will be documented in this file.

 <!-- release:start -->

+## 0.2.0
+
+### Breaking changes
+
+- **LLVM is the only code generation backend.** C emission, the debugging C backend, and automatic C fallback have been removed. Replace `--backend=c` with the default backend, use `--emit=llvm` to inspect generated code, and change library profiles with `"emission": "c"` to `"emission": "llvm"`. `--emit=c` is no longer accepted.
+- **The installed CLI is a native executable.** npm installs the matching platform package on supported macOS, Linux, and Windows hosts. Native compilation, compile-time evaluation, and native execution no longer require Node. Node 24 or newer is still required for npm installation, the JavaScript compiler API, source development, and `scriptc run` of WASI modules. Executable linking still requires the target's linker and SDK or sysroot; Zig remains required for the targets that use it.
+
+### Features
+
+- **scriptc ships a self-hosted native compiler.** The CLI bundles the native TypeScript 7 parser and checker, LLVM helper, precompiled C runtime pack, declarations, and compile-time evaluator. Standalone compiler archives are available alongside npm packages.
+- **Published Effect generators compile statically.** With `--npm-static=effect`, the tested `Effect.gen`, `Effect.succeed`, `Effect.log`, and `Effect.runPromise` flow compiles from the unmodified package without an embedded JavaScript engine. Unsupported reachable Effect code still produces diagnostics.
+- **Three.js CPU workloads compile natively and to WASI.** Static package compilation supports math, scene graphs, cameras, geometry, meshes, materials, and tested raycasting and collision queries. WebGL rendering, DOM integration, and native graphics windows remain unsupported.
+- **WebAssembly libraries expose callable exports and host imports.** WASI Preview 1 reactors support library profiles, synchronous host callbacks, explicit memory ownership, and independent module instances. Browser hosts supply their own WASI adapter and rendering integration.
+- **Native FFI supports more library interfaces.** Static `node:ffi` bindings add exact 64-bit and pointer ABIs, native memory views, reusable callback pools, and Darwin framework linking.
+- **More ordinary JavaScript stays native.** Support expands across identity collections, numeric typed arrays, property descriptors, local class factories, callable properties, inherited fields and accessors, generator and async methods, and runtime-length argument spreads into supported signatures.
+
+### Performance
+
+- **Compilation does less repeated frontend work.** Syntax metadata, property lookups, library signatures, and recursive class analysis are reused, while optional-value analysis and lowering avoid redundant traversal and copying.
+- **LLVM output shares recursive value converters.** Deduplicated helpers reduce generated code and the work needed to produce native objects.
+- **Startup avoids unnecessary work, and release artifacts are smaller.** Host libc detection is cached, the JavaScript API loads TypeScript 5 only when needed, and release runtime packs omit development debug payloads.
+
+### Fixes
+
+- **Untyped JavaScript boundaries preserve more native values.** Class state, shared arrays, nullable fields, constructor results, collection identity, and typed-array backing storage retain their supported semantics across calls and storage.
+- **Static library builds honor explicit package selections.** Packages named in a library profile's `npm_static` list are attempted even when they do not ship declarations.
+- **Terminal and process integration handles more native behavior.** Stored process streams, terminal signals, and exception handlers that resume queued work are supported across the tested native paths.
+
+<!-- release:end -->
+
 ## 0.1.7

 ### Features
@@ -29,8 +59,6 @@ All notable changes to scriptc will be documented in this file.
 - **Optional chains and dynamic option records retain supported values.** Array callbacks inside optional chains, narrowed optional receivers, and records containing abort handles compile correctly.
 - **Compiler analysis handles more edge cases safely.** Deep or shared type graphs no longer overwhelm diagnostics, and property names spelled `arguments` are not treated as reads of the special binding.

-<!-- release:end -->
-
 ## 0.1.6

 ### Features
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/cli-darwin-arm64",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Native scriptc compiler for darwin-arm64",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/cli-darwin-x64",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Native scriptc compiler for darwin-x64",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/cli-linux-arm64-gnu",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Native scriptc compiler for linux-arm64-gnu",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/cli-linux-arm64-musl",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Native scriptc compiler for linux-arm64-musl",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/cli-linux-x64-gnu",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Native scriptc compiler for linux-x64-gnu",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/cli-linux-x64-musl",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Native scriptc compiler for linux-x64-musl",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/cli-win32-x64-msvc",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Native scriptc compiler for win32-x64-msvc",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "scriptc",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Compile ordinary TypeScript and JavaScript to small, fast native executables \u2014 no Node, no V8, no JavaScript engine in the binary",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",
@@ -1,7 +1,7 @@
 {
  "name": "@scriptc/compiler",
-  "version": "0.1.7",
-  "description": "The scriptc compiler \u2014 TypeScript/JavaScript frontend, typed IR, LLVM backend",
+  "version": "0.2.0",
+  "description": "The scriptc compiler — TypeScript/JavaScript frontend, typed IR, LLVM backend",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",
  "repository": {
@@ -1,6 +1,6 @@
 {
  "schemaVersion": 1,
-  "compilerVersion": "0.1.7",
+  "compilerVersion": "0.2.0",
  "coverage": [
    "Entries are projected mechanically from the compiler's own decision tables: the diagnostics registry, the unsupported-syntax dispatch tables, the stdlib and node-builtin lowering tables, and the supported-builtin-module list. Nothing is hand-maintained; the manifest regenerates byte-identically from the source tree at this version.",
    "Absence from this manifest means 'not projected', never 'unsupported'. Surfaces lowered through dedicated code paths rather than tables are not yet projected: console, JSON, Promise/async and the timer surface, the net/http/tls/https/dgram/dns/assert/test/stream/readline module member surfaces, template literals, the regex slice, global functions (parseInt, parseFloat, isNaN, isFinite), and the process surface outside its ambient slice.",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/llvm-darwin-arm64",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Pinned LLVM code-generation helper for scriptc on macOS arm64",
  "license": "Apache-2.0 WITH LLVM-exception",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/llvm-darwin-x64",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Pinned LLVM code-generation helper for scriptc on macOS x64",
  "license": "Apache-2.0 WITH LLVM-exception",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/llvm-linux-arm64-gnu",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Pinned LLVM code-generation helper for scriptc on Linux arm64",
  "license": "Apache-2.0 WITH LLVM-exception",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/llvm-linux-arm64-musl",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Statically linked LLVM code-generation helper for scriptc on Linux arm64 musl",
  "license": "Apache-2.0 WITH LLVM-exception",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/llvm-linux-x64-gnu",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Pinned LLVM code-generation helper for scriptc on Linux x64",
  "license": "Apache-2.0 WITH LLVM-exception",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/llvm-linux-x64-musl",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Statically linked LLVM code-generation helper for scriptc on Linux x64 musl",
  "license": "Apache-2.0 WITH LLVM-exception",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/llvm-win32-x64-msvc",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Pinned LLVM code-generation helper for scriptc on Windows x64",
  "license": "Apache-2.0 WITH LLVM-exception",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/runtime-android-arm64",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Precompiled scriptc library runtime pack for Android arm64",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/runtime-darwin-arm64",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Precompiled scriptc runtime pack for macOS arm64",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/runtime-darwin-x64",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Precompiled scriptc runtime pack for macOS x64",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/runtime-ios-arm64",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Precompiled scriptc library runtime pack for iOS arm64",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/runtime-ios-simulator-arm64",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Precompiled scriptc library runtime pack for iOS simulator arm64",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/runtime-linux-arm64-gnu",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Precompiled scriptc runtime pack for Linux arm64 glibc",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/runtime-linux-arm64-musl",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Precompiled scriptc runtime pack for Linux arm64 musl",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/runtime-linux-x64-gnu",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Precompiled scriptc runtime pack for Linux x64 glibc",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/runtime-linux-x64-musl",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Precompiled scriptc runtime pack for Linux x64 musl",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/runtime-wasm32-wasi",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Precompiled scriptc runtime pack for WASI Preview 1",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/runtime-win32-x64-msvc",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "Precompiled scriptc runtime pack for Windows x64 MSVC",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",
@@ -1,6 +1,6 @@
 {
  "name": "@scriptc/runtime",
-  "version": "0.1.7",
+  "version": "0.2.0",
  "description": "scriptc native runtime sources and vendored dependencies",
  "license": "Apache-2.0",
  "homepage": "https://scriptc.dev",