From 99ddbafc095695d278fba81d835e88ac23e9b990 Mon Sep 17 00:00:00 2001
From: astrale-sharp <ash4567@outlook.fr>
Date: Mon, 21 Aug 2023 15:17:16 +0200
Subject: [PATCH] Wasm plugin system (#1555)

---
 Cargo.lock                                    |  60 +++++
 assets/files/hello.wasm                       | Bin 0 -> 30249 bytes
 crates/typst-library/src/compute/construct.rs | 111 +++++++++-
 crates/typst-library/src/compute/mod.rs       |   1 +
 crates/typst/Cargo.toml                       |   1 +
 crates/typst/src/eval/methods.rs              |  10 +-
 crates/typst/src/eval/mod.rs                  |   2 +
 crates/typst/src/eval/plugin.rs               | 208 ++++++++++++++++++
 crates/typst/src/ide/complete.rs              |  14 +-
 tests/typ/compiler/plugin.typ                 |  35 +++
 10 files changed, 439 insertions(+), 3 deletions(-)
 create mode 100755 assets/files/hello.wasm
 create mode 100644 crates/typst/src/eval/plugin.rs
 create mode 100644 tests/typ/compiler/plugin.typ

diff --git a/Cargo.lock b/Cargo.lock
index 4a7f1fa43..21c076514 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -494,6 +494,12 @@ dependencies = [
  "syn 2.0.16",
 ]
 
+[[package]]
+name = "downcast-rs"
+version = "1.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ea835d29036a4087793836fa931b08837ad5e957da9e23886b29586fb9b6650"
+
 [[package]]
 name = "ecow"
 version = "0.1.1"
@@ -1014,6 +1020,12 @@ dependencies = [
  "hashbrown 0.14.0",
 ]
 
+[[package]]
+name = "indexmap-nostd"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8e04e2fd2b8188ea827b32ef11de88377086d690286ab35747ef7f9bf3ccb590"
+
 [[package]]
 name = "inferno"
 version = "0.11.15"
@@ -1066,6 +1078,12 @@ dependencies = [
  "cfg-if",
 ]
 
+[[package]]
+name = "intx"
+version = "0.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f6f38a50a899dc47a6d0ed5508e7f601a2e34c3a85303514b5d137f3c10a0c75"
+
 [[package]]
 name = "io-lifetimes"
 version = "1.0.10"
@@ -2590,6 +2608,7 @@ dependencies = [
  "unicode-segmentation",
  "unscanny",
  "usvg",
+ "wasmi",
  "xmlparser",
  "xmlwriter",
  "xmp-writer",
@@ -3037,6 +3056,47 @@ version = "0.2.86"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "ed9d5b4305409d1fc9482fee2d7f9bcbf24b3972bf59817ef757e23982242a93"
 
+[[package]]
+name = "wasmi"
+version = "0.30.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e51fb5c61993e71158abf5bb863df2674ca3ec39ed6471c64f07aeaf751d67b4"
+dependencies = [
+ "intx",
+ "smallvec",
+ "spin 0.9.8",
+ "wasmi_arena",
+ "wasmi_core",
+ "wasmparser-nostd",
+]
+
+[[package]]
+name = "wasmi_arena"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "401c1f35e413fac1846d4843745589d9ec678977ab35a384db8ae7830525d468"
+
+[[package]]
+name = "wasmi_core"
+version = "0.12.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "624e6333e861ef49095d2d678b76ebf30b06bf37effca845be7e5b87c90071b7"
+dependencies = [
+ "downcast-rs",
+ "libm",
+ "num-traits",
+ "paste",
+]
+
+[[package]]
+name = "wasmparser-nostd"
+version = "0.100.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9157cab83003221bfd385833ab587a039f5d6fa7304854042ba358a3b09e0724"
+dependencies = [
+ "indexmap-nostd",
+]
+
 [[package]]
 name = "web-sys"
 version = "0.3.63"
diff --git a/assets/files/hello.wasm b/assets/files/hello.wasm
new file mode 100755
index 0000000000000000000000000000000000000000..eddd738760ec237a64c81ac7be9dabe22b455b95
GIT binary patch
literal 30249
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
TF{q-pOCh#mwUou**<Ak@p|pd^

literal 0
HcmV?d00001

diff --git a/crates/typst-library/src/compute/construct.rs b/crates/typst-library/src/compute/construct.rs
index 0a6f24a56..d3dc45c3a 100644
--- a/crates/typst-library/src/compute/construct.rs
+++ b/crates/typst-library/src/compute/construct.rs
@@ -3,7 +3,7 @@ use std::str::FromStr;
 
 use time::{Month, PrimitiveDateTime};
 
-use typst::eval::{Bytes, Datetime, Module, Reflect, Regex};
+use typst::eval::{Bytes, Datetime, Module, Plugin, Reflect, Regex};
 
 use crate::prelude::*;
 
@@ -831,6 +831,115 @@ pub fn range(
     Ok(array)
 }
 
+/// Loads a WebAssembly plugin.
+///
+/// This is **advanced functionality** and not be confused with
+/// [Typst packages]($scripting/#packages).
+///
+/// Typst is capable of interfacing with plugins compiled to WebAssembly. Plugin
+/// functions may accept multiple [byte buffers]($type/bytes) as arguments and
+/// return a single byte buffer. They should typically be wrapped in idiomatic
+/// Typst functions that perform the necessary conversions between native Typst
+/// types and bytes.
+///
+/// Plugins run in isolation from your system, which means that printing,
+/// reading files, or anything like that will not be supported for security
+/// reasons. To run as a plugin, a program needs to be compiled to a 32-bit
+/// shared WebAssembly library. Many compilers will use the
+/// [WASI ABI](https://wasi.dev/) by default or as their only option (e.g.
+/// emscripten), which allows printing, reading files, etc. This ABI will not
+/// directly work with Typst. You will either need to compile to a different
+/// target or [stub all functions](https://github.com/astrale-sharp/wasm-minimal-protocol/blob/master/wasi-stub).
+///
+/// ## Example { #example }
+/// ```example
+/// #let myplugin = plugin("hello.wasm")
+/// #let concat(a, b) = str(
+///   myplugin.concatenate(
+///     bytes(a),
+///     bytes(b),
+///   )
+/// )
+///
+/// #concat("hello", "world")
+/// ```
+///
+/// ## Protocol { #protocol }
+/// To be used as a plugin, a WebAssembly module must conform to the following
+/// protocol
+///
+/// ### Exports { #exports }
+/// A plugin module can export functions to make them callable from Typst. To
+/// conform to the protocol, an exported function should:
+///
+/// - Take `n` 32-bit integer arguments `a_1`, `a_2`, ..., `a_n` (interpreted as
+///   lengths, so `usize/size_t` may be preferable), and return one 32-bit
+///   integer.
+///
+/// - The function should first allocate a buffer `buf` of length
+///   `a_1 + a_2 + ... + a_n`, and then call
+///   `wasm_minimal_protocol_write_args_to_buffer(buf.ptr)`.
+///
+/// - The `a_1` first bytes of the buffer now constitute the first argument, the
+///   `a_2` next bytes the second argument, and so on.
+///
+/// - The function can now do its job with the argument and produce an output
+///   buffer. Before returning, it should call
+///   `wasm_minimal_protocol_send_result_to_host` to send its result back to the
+///   host.
+///
+/// - To signal success, the function should return `0`.
+///
+/// - To signal an error, the function should return `1`. The written buffer is
+///   then interpreted as an UTF-8 encoded error message.
+///
+/// ### Imports { #imports }
+/// Plugin modules need to import two functions that are provided by the runtime.
+/// (Types and functions are described using WAT syntax.)
+///
+/// - `(import "typst_env" "wasm_minimal_protocol_write_args_to_buffer" (func (param i32)))`
+///
+///   Writes the arguments for the current function into a plugin-allocated
+///   buffer. When a plugin function is called, it
+///   [receives the lengths](#exported-functions) of its input buffers as
+///   arguments. It should then allocate a buffer whose capacity is at least the
+///   sum of these lengths. It should then call this function with a `ptr` to
+///   the buffer to fill it with the arguments, one after another.
+///
+/// - `(import "typst_env" "wasm_minimal_protocol_send_result_to_host" (func (param i32 i32)))`
+///
+///   Sends the output of the current function to the host (Typst). The first
+///   parameter shall be a pointer to a buffer (`ptr`), while the second is the
+///   length of that buffer (`len`). The memory pointed at by `ptr` can be freed
+///   immediately after this function returns. If the message should be
+///   interpreted as an error message, it should be encoded as UTF-8.
+///
+/// ## Resources { #resources }
+/// For more resources, check out the
+/// [wasm-minimal-protocol repository](https://github.com/astrale-sharp/wasm-minimal-protocol).
+/// It contains:
+///
+/// - A list of example plugin implementations and a test runner for these
+///   examples
+/// - Wrappers to help you write your plugin in Rust (Zig wrapper in
+///   development)
+/// - A stubber for WASI
+///
+/// Display: Plugin
+/// Category: construct
+#[func]
+pub fn plugin(
+    /// Path to a WebAssembly file.
+    path: Spanned<EcoString>,
+    /// The virtual machine.
+    vm: &mut Vm,
+) -> SourceResult<Plugin> {
+    let Spanned { v: path, span } = path;
+    let id = vm.location().join(&path).at(span)?;
+    let data = vm.world().file(id).at(span)?;
+    Plugin::new(data).at(span)
+}
+
 #[cfg(test)]
 mod tests {
     use super::*;
diff --git a/crates/typst-library/src/compute/mod.rs b/crates/typst-library/src/compute/mod.rs
index 757377f03..5e7e8d46b 100644
--- a/crates/typst-library/src/compute/mod.rs
+++ b/crates/typst-library/src/compute/mod.rs
@@ -39,4 +39,5 @@ pub(super) fn define(global: &mut Scope) {
     global.define("yaml", yaml_func());
     global.define("xml", xml_func());
     global.define("calc", calc::module());
+    global.define("plugin", plugin_func());
 }
diff --git a/crates/typst/Cargo.toml b/crates/typst/Cargo.toml
index dc1dcc773..8fdd51e01 100644
--- a/crates/typst/Cargo.toml
+++ b/crates/typst/Cargo.toml
@@ -55,6 +55,7 @@ usvg = { version = "0.32", default-features = false, features = ["text"] }
 xmlwriter = "0.1.0"
 xmp-writer = "0.1"
 time = { version = "0.3.20", features = ["std", "formatting"] }
+wasmi = "0.30.0"
 xmlparser = "0.13.5"
 
 [target.'cfg(not(target_arch = "wasm32"))'.dependencies]
diff --git a/crates/typst/src/eval/methods.rs b/crates/typst/src/eval/methods.rs
index 0247a4a73..a47d945b1 100644
--- a/crates/typst/src/eval/methods.rs
+++ b/crates/typst/src/eval/methods.rs
@@ -2,7 +2,7 @@
 
 use ecow::{eco_format, EcoString};
 
-use super::{Args, IntoValue, Str, Value, Vm};
+use super::{Args, Bytes, IntoValue, Plugin, Str, Value, Vm};
 use crate::diag::{At, Hint, SourceResult};
 use crate::eval::{bail, Datetime};
 use crate::geom::{Align, Axes, Color, Dir, Em, GenAlign};
@@ -280,6 +280,14 @@ pub fn call(
                     "inv" => align2d.map(GenAlign::inv).into_value(),
                     _ => return missing(),
                 }
+            } else if let Some(plugin) = dynamic.downcast::<Plugin>() {
+                if plugin.iter().any(|func_name| func_name == method) {
+                    let bytes = args.all::<Bytes>()?;
+                    args.take().finish()?;
+                    plugin.call(method, bytes).at(span)?.into_value()
+                } else {
+                    return missing();
+                }
             } else {
                 return (vm.items.library_method)(vm, &dynamic, method, args, span);
             }
diff --git a/crates/typst/src/eval/mod.rs b/crates/typst/src/eval/mod.rs
index 9141544e1..88302c4a5 100644
--- a/crates/typst/src/eval/mod.rs
+++ b/crates/typst/src/eval/mod.rs
@@ -23,6 +23,7 @@ mod methods;
 mod module;
 mod none;
 pub mod ops;
+mod plugin;
 mod scope;
 mod symbol;
 mod tracer;
@@ -53,6 +54,7 @@ pub use self::library::{set_lang_items, LangItems, Library};
 pub use self::methods::methods_on;
 pub use self::module::Module;
 pub use self::none::NoneValue;
+pub use self::plugin::Plugin;
 pub use self::scope::{Scope, Scopes};
 pub use self::str::{format_str, Regex, Str};
 pub use self::symbol::Symbol;
diff --git a/crates/typst/src/eval/plugin.rs b/crates/typst/src/eval/plugin.rs
new file mode 100644
index 000000000..82bb5b6ae
--- /dev/null
+++ b/crates/typst/src/eval/plugin.rs
@@ -0,0 +1,208 @@
+use std::fmt::{self, Debug, Formatter};
+use std::hash::{Hash, Hasher};
+
+use ecow::{eco_format, EcoString};
+use std::sync::{Arc, Mutex};
+use wasmi::{AsContext, AsContextMut, Caller, Engine, Linker, Module};
+
+use super::{cast, Bytes};
+use crate::diag::{bail, StrResult};
+
+/// A plugin loaded from WebAssembly code.
+///
+/// It can run external code conforming to its protocol.
+///
+/// This type is cheap to clone and hash.
+#[derive(Clone)]
+pub struct Plugin(Arc<Repr>);
+
+/// The internal representation of a plugin.
+struct Repr {
+    /// The raw WebAssembly bytes.
+    bytes: Bytes,
+    /// The function defined by the WebAssembly module.
+    functions: Vec<(EcoString, wasmi::Func)>,
+    /// Owns all data associated with the WebAssembly module.
+    store: Mutex<Store>,
+}
+
+/// Owns all data associated with the WebAssembly module.
+type Store = wasmi::Store<StoreData>;
+
+/// The persistent store data used for communication between store and host.
+#[derive(Default)]
+struct StoreData {
+    args: Vec<Bytes>,
+    output: Vec<u8>,
+}
+
+impl Plugin {
+    /// Create a new plugin from raw WebAssembly bytes.
+    #[comemo::memoize]
+    pub fn new(bytes: Bytes) -> StrResult<Self> {
+        let engine = Engine::default();
+        let module = Module::new(&engine, bytes.as_slice())
+            .map_err(|err| format!("failed to load WebAssembly module: {err}"))?;
+
+        let mut linker = Linker::new(&engine);
+        linker
+            .func_wrap(
+                "typst_env",
+                "wasm_minimal_protocol_send_result_to_host",
+                wasm_minimal_protocol_send_result_to_host,
+            )
+            .unwrap();
+        linker
+            .func_wrap(
+                "typst_env",
+                "wasm_minimal_protocol_write_args_to_buffer",
+                wasm_minimal_protocol_write_args_to_buffer,
+            )
+            .unwrap();
+
+        let mut store = Store::new(&engine, StoreData::default());
+        let instance = linker
+            .instantiate(&mut store, &module)
+            .and_then(|pre_instance| pre_instance.start(&mut store))
+            .map_err(|e| eco_format!("{e}"))?;
+
+        // Ensure that the plugin exports its memory.
+        if !matches!(
+            instance.get_export(&store, "memory"),
+            Some(wasmi::Extern::Memory(_))
+        ) {
+            bail!("plugin does not export its memory");
+        }
+
+        // Collect exported functions.
+        let functions = instance
+            .exports(&store)
+            .filter_map(|export| {
+                let name = export.name().into();
+                export.into_func().map(|func| (name, func))
+            })
+            .collect();
+
+        Ok(Plugin(Arc::new(Repr { bytes, functions, store: Mutex::new(store) })))
+    }
+
+    /// Call the plugin function with the given `name`.
+    pub fn call(&self, name: &str, args: Vec<Bytes>) -> StrResult<Bytes> {
+        // Find the function with the given name.
+        let func = self
+            .0
+            .functions
+            .iter()
+            .find(|(v, _)| v == name)
+            .map(|&(_, func)| func)
+            .ok_or_else(|| {
+                eco_format!("plugin does not contain a function called {name}")
+            })?;
+
+        let mut store = self.0.store.lock().unwrap();
+        let ty = func.ty(store.as_context());
+
+        // Check function signature.
+        if ty.params().iter().any(|&v| v != wasmi::core::ValueType::I32) {
+            bail!(
+                "plugin function `{name}` has a parameter that is not a 32-bit integer"
+            );
+        }
+        if ty.results() != [wasmi::core::ValueType::I32] {
+            bail!("plugin function `{name}` does not return exactly one 32-bit integer");
+        }
+
+        // Check inputs.
+        let expected = ty.params().len();
+        let given = args.len();
+        if expected != given {
+            bail!(
+                "plugin function takes {expected} argument{}, but {given} {} given",
+                if expected == 1 { "" } else { "s" },
+                if given == 1 { "was" } else { "were" },
+            );
+        }
+
+        // Collect the lengths of the argument buffers.
+        let lengths = args
+            .iter()
+            .map(|a| wasmi::Value::I32(a.len() as i32))
+            .collect::<Vec<_>>();
+
+        // Store the input data.
+        store.data_mut().args = args;
+
+        // Call the function.
+        let mut code = wasmi::Value::I32(-1);
+        func.call(store.as_context_mut(), &lengths, std::slice::from_mut(&mut code))
+            .map_err(|err| eco_format!("plugin panicked: {err}"))?;
+
+        // Extract the returned data.
+        let output = std::mem::take(&mut store.data_mut().output);
+
+        // Parse the functions return value.
+        match code {
+            wasmi::Value::I32(0) => {}
+            wasmi::Value::I32(1) => match std::str::from_utf8(&output) {
+                Ok(message) => bail!("plugin errored with: {message}"),
+                Err(_) => {
+                    bail!("plugin errored, but did not return a valid error message")
+                }
+            },
+            _ => bail!("plugin did not respect the protocol"),
+        };
+
+        Ok(output.into())
+    }
+
+    /// An iterator over all the function names defined by the plugin.
+    pub fn iter(&self) -> impl Iterator<Item = &EcoString> {
+        self.0.functions.as_slice().iter().map(|(func_name, _)| func_name)
+    }
+}
+
+impl Debug for Plugin {
+    fn fmt(&self, f: &mut Formatter) -> fmt::Result {
+        f.pad("plugin(..)")
+    }
+}
+
+impl PartialEq for Plugin {
+    fn eq(&self, other: &Self) -> bool {
+        self.0.bytes == other.0.bytes
+    }
+}
+
+impl Hash for Plugin {
+    fn hash<H: Hasher>(&self, state: &mut H) {
+        self.0.bytes.hash(state);
+    }
+}
+
+cast! {
+    type Plugin: "plugin",
+}
+
+/// Write the arguments to the plugin function into the plugin's memory.
+fn wasm_minimal_protocol_write_args_to_buffer(mut caller: Caller<StoreData>, ptr: u32) {
+    let memory = caller.get_export("memory").unwrap().into_memory().unwrap();
+    let arguments = std::mem::take(&mut caller.data_mut().args);
+    let mut offset = ptr as usize;
+    for arg in arguments {
+        memory.write(&mut caller, offset, arg.as_slice()).unwrap();
+        offset += arg.len();
+    }
+}
+
+/// Extracts the output of the plugin function from the plugin's memory.
+fn wasm_minimal_protocol_send_result_to_host(
+    mut caller: Caller<StoreData>,
+    ptr: u32,
+    len: u32,
+) {
+    let memory = caller.get_export("memory").unwrap().into_memory().unwrap();
+    let mut buffer = std::mem::take(&mut caller.data_mut().output);
+    buffer.resize(len as usize, 0);
+    memory.read(&caller, ptr as _, &mut buffer).unwrap();
+    caller.data_mut().output = buffer;
+}
diff --git a/crates/typst/src/ide/complete.rs b/crates/typst/src/ide/complete.rs
index 36d27654f..ded6205ea 100644
--- a/crates/typst/src/ide/complete.rs
+++ b/crates/typst/src/ide/complete.rs
@@ -10,7 +10,7 @@ use super::analyze::analyze_labels;
 use super::{analyze_expr, analyze_import, plain_docs_sentence, summarize_font_family};
 use crate::doc::Frame;
 use crate::eval::{
-    fields_on, format_str, methods_on, CastInfo, Func, Library, Scope, Value,
+    fields_on, format_str, methods_on, CastInfo, Func, Library, Plugin, Scope, Value,
 };
 use crate::syntax::{
     ast, is_id_continue, is_id_start, is_ident, LinkedNode, Source, SyntaxKind,
@@ -415,6 +415,18 @@ fn field_access_completions(ctx: &mut CompletionContext, value: &Value) {
                 }
             }
         }
+        Value::Dyn(val) => {
+            if let Some(plugin) = val.downcast::<Plugin>() {
+                for name in plugin.iter() {
+                    ctx.completions.push(Completion {
+                        kind: CompletionKind::Func,
+                        label: name.clone(),
+                        apply: None,
+                        detail: None,
+                    })
+                }
+            }
+        }
         _ => {}
     }
 }
diff --git a/tests/typ/compiler/plugin.typ b/tests/typ/compiler/plugin.typ
new file mode 100644
index 000000000..aafbdaa1c
--- /dev/null
+++ b/tests/typ/compiler/plugin.typ
@@ -0,0 +1,35 @@
+// Test WebAssembly plugins.
+// Ref: false
+
+---
+#let p = plugin("/files/hello.wasm")
+#test(p.hello(), bytes("Hello from wasm!!!"))
+#test(p.double_it(bytes("hey!")), bytes("hey!.hey!"))
+#test(
+  p.shuffle(bytes("value1"), bytes("value2"), bytes("value3")),
+  bytes("value3-value1-value2"),
+)
+
+---
+#let p = plugin("/files/hello.wasm")
+
+// Error: 2-20 plugin function takes 0 arguments, but 1 was given
+#p.hello(bytes(""))
+
+---
+#let p = plugin("/files/hello.wasm")
+
+// Error: 10-14 unexpected argument
+#p.hello(true)
+
+---
+#let p = plugin("/files/hello.wasm")
+
+// Error: 2-17 plugin errored with: This is an `Err`
+#p.returns_err()
+
+---
+#let p = plugin("/files/hello.wasm")
+
+// Error: 2-16 plugin panicked: wasm `unreachable` instruction executed
+#p.will_panic()