Ruby WASM WASI

Author: WebReflection

README.md

@@ -69,13 +69,15 @@ integration
           ├ interpreter
           │           ├ micropython
           │           ├ pyodide
+          │           ├ ruby-wasm-wasi
           │           ├ wasmoon
           │           ├ xxx.yy
           │           ├ xxx.toml
           │           └ utils.js
           ├ _shared.js
           ├ micropython.js
           ├ pyodide.js
+          ├ ruby-wasm-wasi.js
           └ wasmoon.js
 ```
 

docs/README.md

@@ -33,6 +33,7 @@ We also explicitly use that "_piece of software_" as the interpreter name it ref
 
  * [pyodide](https://pyodide.org/en/stable/index.html) is the name of the interpreter that runs likely the most complete version of latest *Python*, enabling dozen official modules at run time, also offering a great *JS* integration in its core
  * [micropython](https://micropython.org/) is the name of the interpreter that runs a small subset of the *Python* standard library and is optimized to run in constrained environments such as *Mobile* phones, or even *Desktop*, thanks to its tiny size and an extremely fast bootstrap
+ * [ruby-wasm-wasi](https://github.com/ruby/ruby.wasm) is the name of the (currently *experimental*) interpreter that adds *Ruby* to the list of programming languages currently supported
  * [wasmoon](https://github.com/ceifa/wasmoon) is the name of the interpreter that runs *Lua* on the browser and that, among the previous two interpreters, is fully compatible with all core features
 
 `<script>` tags specify which *interpreter* to use via the `type` attribute. This is typically the full name of the interpreter:
@@ -48,6 +49,10 @@ We also explicitly use that "_piece of software_" as the interpreter name it ref
     print(sys.version)
 </script>
 
+<script type="ruby-wasm-wasi">
+    print "ruby #{ RUBY_VERSION }"
+</script>
+
 <script type="wasmoon">
     print(_VERSION)
 </script>
@@ -765,6 +770,7 @@ Please note that if a worker is created explicitly, there won't be any element,
 | :------------- | :---: | :--------: | :--------: | :----------------: | :---------: | :---------: |
 | pyodide        | •     | •          | •          | •                  | •           | •           |
 | micropython    | •     | •          | •          | •                  | •           | •           |
+| ruby-wasm-wasi | •     | •          | •          | !                  |             |             |
 | wasmoon        | •     | •          | •          | !                  | •           |             |
 
   * **run** allows code to run synchronously and optionally return value

docs/index.js

@@ -166,7 +166,7 @@ const registry = new Map();
 
 /**
  * @typedef {Object} CustomOptions custom configuration
- * @prop {'pyodide' | 'micropython' | 'wasmoon'} interpreter the interpreter to use
+ * @prop {'pyodide' | 'micropython' | 'ruby-wasm-wasi' | 'wasmoon'} interpreter the interpreter to use
  * @prop {string} [version] the optional interpreter version to use
  * @prop {string} [config] the optional config to use within such interpreter
  */

docs/index.js.map

@@ -0,0 +1,63 @@
+import fetch from '@webreflection/fetch';
+
+import { dedent } from '../utils.js';
+import { fetchFiles, fetchJSModules, fetchPaths } from './_utils.js';
+
+const type = 'ruby-wasm-wasi';
+const jsType = type.replace(/\W+/g, '_');
+
+// MISSING:
+//  * there is no VFS apparently or I couldn't reach any
+//  * I've no idea how to override the stderr and stdout
+//  * I've no idea how to import packages
+
+// REQUIRES INTEGRATION TEST
+/* c8 ignore start */
+export default {
+    type,
+    experimental: true,
+    module: (version = '2.5.0') =>
+        `https://cdn.jsdelivr.net/npm/@ruby/3.2-wasm-wasi@${version}/dist/browser/+esm`,
+    async engine({ DefaultRubyVM }, config, url) {
+        url = url.replace(/\/browser\/\+esm$/, '/ruby.wasm');
+        const buffer = await fetch(url).arrayBuffer();
+        const module = await WebAssembly.compile(buffer);
+        const { vm: interpreter } = await DefaultRubyVM(module);
+        if (config.files) await fetchFiles(this, interpreter, config.files);
+        if (config.fetch) await fetchPaths(this, interpreter, config.fetch);
+        if (config.js_modules) await fetchJSModules(config.js_modules);
+        return interpreter;
+    },
+    // Fallback to globally defined module fields (i.e. $xworker)
+    registerJSModule(interpreter, name, value) {
+        name = name.replace(/\W+/g, '__');
+        const id = `__module_${jsType}_${name}`;
+        globalThis[id] = value;
+        this.run(interpreter, `require "js";$${name}=JS.global[:${id}]`);
+        delete globalThis[id];
+    },
+    run: (interpreter, code, ...args) => interpreter.eval(dedent(code), ...args),
+    runAsync: (interpreter, code, ...args) => interpreter.evalAsync(dedent(code), ...args),
+    async runEvent(interpreter, code, event) {
+        // patch common xworker.onmessage/onerror cases
+        if (/^xworker\.(on\w+)$/.test(code)) {
+            const { $1: name } = RegExp;
+            const id = `__module_${jsType}_event`;
+            globalThis[id] = event;
+            this.run(
+                interpreter,
+                `require "js";$xworker.call("${name}",JS.global[:${id}])`,
+            );
+            delete globalThis[id];
+        } else {
+            // Experimental: allows only events by fully qualified method name
+            const method = this.run(interpreter, `method(:${code})`);
+            await method.call(code, interpreter.wrap(event));
+        }
+    },
+    transform: (_, value) => value,
+    writeFile: () => {
+        throw new Error(`writeFile is not supported in ${type}`);
+    },
+};
+/* c8 ignore stop */

esm/custom.js

@@ -60,6 +60,7 @@ const register = (interpreter) => {
 //:RUNTIMES
 import micropython from './interpreter/micropython.js';
 import pyodide from './interpreter/pyodide.js';
+import ruby_wasm_wasi from './interpreter/ruby-wasm-wasi.js';
 import wasmoon from './interpreter/wasmoon.js';
-for (const interpreter of [micropython, pyodide, wasmoon])
+for (const interpreter of [micropython, pyodide, ruby_wasm_wasi, wasmoon])
     register(interpreter);