wasm-bindgen/wasm-pack
Wasm Pack
wasm-pack is a build tool and workflow orchestrator for compiling Rust code to WebAssembly. It coordinates the compilation process and generates the JavaScript glue code required to execute Rust logic within web browsers and server-side runtimes.
The tool manages binary optimization to reduce file sizes and improve execution speed. It also functions as a package manager, bundling compiled WebAssembly modules into archives compatible with JavaScript registries and bundlers.
The project covers language interoperability through the automatic generation of TypeScript type definitions. It further provides a test runner for executing module tests across multiple environments, including Node.js and headless browsers.
Features
- WebAssembly Compilation - Transforms Rust source code into WebAssembly binaries and generates the required glue code for execution in web and server environments.
- Language-Specific Toolchain Orchestrators - Coordinates the Rust compiler and binary optimizers by managing flags and environment configurations during the build process.
- WebAssembly Workflow Orchestrators - Coordinates the entire Rust-to-Wasm workflow, including compilation, binary optimization, and multi-environment testing.
- Rust-JavaScript Bridges - Generates the necessary glue code and type definitions to bridge Rust logic with JavaScript runtimes.
- WebAssembly Glue Code Generators - Generates JavaScript and TypeScript glue code to handle memory layout and type conversion between Rust and WebAssembly.
- Build Profiles - Manages different compilation modes to balance build speed against the level of final code optimization.
- Package Registry Integrations - Bundles compiled binaries and glue code into archives compatible with JavaScript package registries and managers.
- Registry Publishing Tools - Packages modules into compressed archives and uploads them to distribution registries with support for version tags.
- WebAssembly Module Packages - Packages compiled WebAssembly modules into archives compatible with JavaScript registries and bundlers.
- Environment-Specific Module Resolution - Emits different module formats and loading patterns tailored to the target execution environment, such as browsers or Node.js.
- JavaScript Library Packagers - Bundles compiled modules into distribution formats compatible with JavaScript package registries and bundlers.
- Module Packaging - Bundles compiled binaries and glue code into packages suitable for JavaScript package managers.
- Multi-Target Compilers - Compiles code for multiple target environments, including web browsers, Node.js, and other system interfaces.
- Type Definition Generators - Automatically produces TypeScript declaration files to enable static type checking and autocomplete in code editors.
- TypeScript Type Synthesis - Automatically synthesizes TypeScript definition files from compiled WebAssembly module signatures to enable static type checking.
- Test Runners - Provides a command-line interface to execute Rust module tests in Node.js and headless browsers.
- CLI Test Runners - Provides a command-line tool to execute WebAssembly module tests by wrapping standard test runners.
- Cross-Runtime Execution - Provides a test runner capable of executing WebAssembly modules across both headless browser and Node.js server environments.
- Binary Optimizers - Integrates external binary optimizers to reduce the file size and improve the execution performance of compiled WebAssembly modules.
- Foreign Function Interface - Builds and publishes Wasm packages to npm.
