frameworks_runtimes_typescript_ts2wasm:基于 WasmGC 的 TypeScript 到 WebAssembly 编译工具项目

可将 TypeScript 源码编译为 WebAssembly 字节码,支持动态类型。通过 WasmGC 实现垃圾回收,借助 binaryen 优化,减小内存占用,采用静态编译避免动态类型检查开销,需在 WasmGC 运行环境执行。【此简介由AI生成】

Branch5Tags4
FilesLast commitLast update
10 months ago
10 months ago
5 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago

Wasmnizer-ts

Toolchain for compiling TypeScript to WasmGC

Overview

Wasmnizer-ts utilizes WasmGC to compile TypeScript source code into WebAssembly bytecode, and support dynamic type (such as any) through host APIs. The Wasmnizer-ts now supports a strict subset of TypeScript and continuously strives to accommodate more semantics.

There are three components in Wasmnizer-ts:

  • ts2wasm-compiler: a compiler for compiling TypeScript source code into WasmGC bytecode.
  • ts2wasm-stdlib: standard library implemented in ts source code, will be compiled with application together. See standard library.
  • ts2wasm-runtime-library: runtime libraries for exposing host APIs required for running the generated wasm module, including:
    1. libdyntype: support dynamic objects, see API spec here. We have proposed a WASI proposal.
    2. libstruct-indirect: access WasmGC struct fields through index calculated during runtime, see API spec here. These APIs are used to emulate the behaviour of the proposed struct.get/set_indirect opcode.
    3. libstd: standard library implemented in native, such as console.log, see standard library.

Note: This project is highly experimental and under active development, DO NOT use in production

Features

  • garbage collection. ts2wasm-compiler leverage WebAssembly GC proposal, which can benefit from runtime's GC capability.
  • optimization. ts2wasm-compiler uses binaryen as backend, which can benefit from binaryen's powerful optimization capabilities.
  • small footprint. Data structures in source code is represented as WasmGC types, which avoids the requirement for memory allocator and garbage collector inside wasm module.
  • static compilation. Type information in TypeScript source code is used to create static WasmGC types, which avoids the overhead of dynamic type checking.
  • dynamic typing. any and other dynamic types in TypeScript source code are supported by host APIs.

Execution environment

The wasm module generated by ts2wasm-compiler is designed to be executed in a WasmGC runtime environment. The runtime should provide the following capabilities:

  • WebAssembly proposals:
    • WasmGC (mandatory): WasmGC proposal, which is a garbage collection mechanism for WebAssembly.

      Note: the GC opcode generated by binaryen is slightly different than GC MVP, please see here for details.

    • Exception handling (required by try-catch statements): exception handling proposal, which adds exception handling mechanism to WebAssembly.
    • stringref (required by stringref feature): reference-typed strings proposal, provide a language independent string representation.
  • APIs:
    • libdyntype API (required by dynamic typing): APIs for supporting dynamic objects.
    • libstruct-indirect API (required by interface type): APIs for accessing WasmGC struct fields through index calculated during runtime.
    • libstd API (required by standard libraries): APIs for providing standard libraries from host environment.

Wasmnizer-ts currently implemented host APIs on multiple environments:

  • WebAssembly Micro Runtime (WAMR): libdyntype API, libstruct-indirect API and libstd API
  • chrome browser and nodejs (20.6.1+): part of libdyntype API implemented with JavaScript

Please see feature list for supporting status of each feature.

Please goto Getting Started for how to use the project and Introduction for more details.

Contributing

We welcome contributions to Wasmnizer-ts. You can find more details in CONTRIBUTING.md .

License

Wasmnizer-ts uses the same license as LLVM: the Apache 2.0 license with the LLVM exception. See the LICENSE file for details. Any contributions you make will be under the same license.

Introduction

可将 TypeScript 源码编译为 WebAssembly 字节码,支持动态类型。通过 WasmGC 实现垃圾回收,借助 binaryen 优化,减小内存占用,采用静态编译避免动态类型检查开销,需在 WasmGC 运行环境执行。【此简介由AI生成】

Customize your domain