feat: wasm, js and standalone vscode extension

Author: tamasfe

Cargo.toml

@@ -1,5 +1,6 @@
 [workspace]
 members = ["crates/*", "fuzz"]
+exclude = ["crates/rhai-wasm"]
 
 [profile.release]
 lto = true

README.md

@@ -10,9 +10,10 @@
   - [Profiling](#profiling)
   - [Contributing](#contributing)
     - [Development Process](#development-process)
-      - [Build and Install VSCode Extension](#build-and-install-vscode-extension)
-      - [Build the Language Server](#build-the-language-server)
+      - [Building and Installing the VSCode Extension](#building-and-installing-the-vscode-extension)
+      - [Building the Rhai CLI](#building-the-rhai-cli)
       - [Debugging the Language Server](#debugging-the-language-server)
+      - [Building the VSCode Extension](#building-the-vscode-extension)
 
 # Rhai LSP
 
@@ -23,7 +24,7 @@ It's incomplete and not recommended for general use yet, everything can be subje
 ## Requirements
 
 - Stable Rust toolchain (e.g. via [rustup](https://rustup.rs/))
-- yarn (for VS Code)
+- yarn 2 (for VS Code)
 - [vsce](https://www.npmjs.com/package/vsce) for VS Code extensions
 
 ## Project Structure
@@ -82,7 +83,7 @@ The documentation is still pretty much WIP (as everything else). All contributio
 
 Currently the following steps are used to develop the project via vscode:
 
-#### Build and Install VSCode Extension
+#### Building and Installing the VSCode Extension
 
 Install the extension with the following:
 ```sh
@@ -91,10 +92,10 @@ Install the extension with the following:
 
 You only have to do this at the beginning or whenever you update the extension.
 
-#### Build the Language Server
+#### Building the Rhai CLI
 
 ```sh
-cargo install --path crates/lsp --debug
+cargo install --path crates/rhai-cli --debug
 ```
 
 This will build and install the `rhai` executable globally that the vscode extension looks for.
@@ -104,3 +105,17 @@ After this step right now you have to manually kill the old running `rhai` execu
 #### Debugging the Language Server
 
 The debugging process can consist of either strategically placed `tracing::info` statements that are visible in the VSCode debug console under `Rhai LSP`, or attaching a debugger to the running `rhai` process via [LLDB VSCode](https://marketplace.visualstudio.com/items?itemName=lanza.lldb-vscode). Both approaches deemed sufficient so far.
+
+#### Building the VSCode Extension
+
+The vscode extension relies on rhai-lsp compiled to WebAssembly via [`rhai-wasm`](./crates/rhai-wasm). There are several related [js libraries](./js) that are built on top of it.
+
+Generally all you should need is `yarn` (2), and `vsce`, and the following single command:
+
+```sh
+(cd editors/vscode && yarn && vsce package --no-yarn && code --install-extension *.vsix --force)
+```
+
+If this fails, you will need to build each js package with `yarn build` individually.
+
+If all that fails, make sure to perform your favourite JavaScript exorcism ritual or file an issue.

crates/rhai-common/Cargo.toml

@@ -29,3 +29,6 @@ tokio = { version = "1.19.2", features = [
 ] }
 glob = "0.3.0"
 atty = "0.2.14"
+
+[target.'cfg(target_arch = "wasm32")'.dependencies]
+tokio = { version = "1.19.2" }

crates/rhai-common/src/environment.rs

@@ -7,6 +7,7 @@ use std::{
 use tokio::io::{AsyncRead, AsyncWrite};
 use url::Url;
 
+#[cfg(not(target_family = "wasm"))]
 pub mod native;
 
 #[async_trait(?Send)]

crates/rhai-lsp/Cargo.toml

@@ -13,7 +13,6 @@ rhai-rowan = { version = "0.1.0", path = "../rhai-rowan" }
 ahash = "0.7.6"
 anyhow = "1.0.58"
 arc-swap = "1.5.0"
-async-ctrlc = { version = "1.2.0", features = ["stream"] }
 async-trait = "0.1.56"
 az = "1.2.0"
 clap = { version = "3.2.6", features = ["derive"] }

crates/rhai-lsp/src/lib.rs

@@ -15,8 +15,7 @@ use std::sync::Arc;
 use rhai_common::environment::Environment;
 use lsp_async_stub::Server;
 use lsp_types::{notification, request};
-use world::{World, WorldState};
-
+pub use world::{World, WorldState};
 
 pub(crate) mod config;
 pub(crate) mod diagnostics;

crates/rhai-wasm/.gitignore

@@ -0,0 +1 @@
+/target

crates/rhai-wasm/Cargo.toml

@@ -0,0 +1,32 @@
+[package]
+name = "rhai-wasm"
+version = "0.1.0"
+edition = "2021"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[lib]
+crate-type = ["cdylib"]
+
+[dependencies]
+rhai-lsp = { version = "0.1.0", path = "../rhai-lsp" }
+rhai-common = { version = "0.1.0", path = "../rhai-common" }
+
+anyhow = "1.0.57"
+async-trait = "0.1.56"
+clap = { version = "3.1.18", features = ["derive"] }
+console_error_panic_hook = "0.1.7"
+futures = "0.3.21"
+js-sys = "0.3.57"
+serde = { version = "1.0.137", features = ["derive"] }
+serde_json = "1.0.81"
+tokio = "1.19.2"
+tracing = "0.1.35"
+url = "2.2.2"
+wasm-bindgen = { version = "0.2.80", features = ["serde-serialize"] }
+wasm-bindgen-futures = "0.4.30"
+lsp-async-stub = "0.6.0"
+
+[profile.release]
+opt-level = 's'
+lto = true