wasm-lsp-server

A language server implementation for WebAssembly

Status

The server is still in an early state. It is usable but many advanced features have not yet been implemented.

Usage

The server has not yet had a stable release. You can build and install it locally if you would like to experiment with it in the meantime.

Installing the Server

Prebuilt Binaries

The easiest way to install the server is to grab one of the prebuilt binaries under releases.

Building from Source

First ensure you have the rust toolchain installed, then proceed as follows:

git clone https://github.com/wasm-lsp/wasm-lsp-server
cd wasm-lsp-server
cargo xtask init
cargo xtask install

Selecting the Async Runtime

The server is runtime agnostic and can be configured to run on async-std, futures, smol, or tokio.

The table below describes how to select a runtime. The tokio runtime is selected by default.

runtime	command
async-std	cargo xtask install --runtime=async-std
futures	cargo xtask install --runtime=futures
smol	cargo xtask install --runtime=smol
tokio	cargo xtask install --runtime=tokio

Installing the Client Extension

Once the server is installed you can install the Visual Studio Code client extension.

Supported Document Types

extension	supported	kind
.wat	☑	WebAssembly module definition
.wast	☑	WebAssembly script

Supported WebAssembly Proposals

The server also supports parsing WebAssembly modules that use the following features:

Phase 4 (Standardization)

• ☑ bulk-memory-operations
• ☑ reference-types

Phase 3 (Implementation)

• ☑ annotations
• ☑ multi-memory
• ☑ simd

Phase 2 (Specification)

• ☑ exception-handling
• ☑ function-references
• ☑ threads

Phase 1 (Proposal)

Nothing planned.

Phase 0 (Pre-Proposal)

Nothing planned.

Language Server Feature Support

• ☑ document parsing via wasm tree-sitter grammars
• ☑ document symbol provider
• ☑ syntax error diagnostics provider
• ☑ incremental document synchronization

Language Server Feature Roadmap

• ☐ code action provider
• ☐ code lens provider
• ☐ completion provider
• ☐ definition provider
• ☐ document formatting (full and ranged) provider
• ☐ document highlight provider
• ☐ hover provider
• ☐ references provider
• ☐ workspace symbol provider
• ☐ semantic tokens provider
• ☐ signature help provider
• ☐ document validation
• ☐ integration with existing wasm toolchains
• ☐ implementation of the Debug Adapter Protocol