Add RubyVM.instantiateComponent and RubyVM.instantiateModule

To provide higher-level instantiation API for Ruby VM, this commit
introduces `RubyVM.instantiateComponent` and `RubyVM.instantiateModule`
methods.

Author: kateinoigakukun

bin/repl.mjs

@@ -0,0 +1,121 @@
+import * as preview2Shim from "@bytecodealliance/preview2-shim"
+import * as nodeWasi from "wasi";
+import fs from "fs/promises";
+import path from "path";
+import { RubyVM } from "@ruby/wasm-wasi";
+import * as readline from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+import { parseArgs } from "node:util"
+
+async function instantiateComponent(pkgPath) {
+  const componentJsPath = path.resolve(pkgPath, "dist/component/ruby.component.js");
+  const { instantiate } = await import(componentJsPath);
+  const getCoreModule = async (relativePath) => {
+    const coreModulePath = path.resolve(pkgPath, "dist/component", relativePath);
+    const buffer = await fs.readFile(coreModulePath);
+    return WebAssembly.compile(buffer);
+  }
+  const { cli, filesystem } = preview2Shim;
+  cli._setArgs(["ruby.wasm"].concat(process.argv.slice(2)));
+  cli._setCwd("/")
+  filesystem._setPreopens({})
+
+  const { vm } = await RubyVM.instantiateComponent({
+    instantiate, getCoreModule, wasip2: preview2Shim,
+  });
+  return vm;
+}
+
+async function instantiateModule(pkgPath) {
+  const binaryPath = path.resolve(pkgPath, "dist/ruby.debug+stdlib.wasm");
+  const binary = await fs.readFile(binaryPath);
+  const rubyModule = await WebAssembly.compile(binary);
+  const wasi = new nodeWasi.WASI({
+    stdio: "inherit",
+    args: ["ruby.wasm"].concat(process.argv.slice(2)),
+    env: process.env,
+    version: "preview1",
+  });
+
+  const { vm } = await RubyVM.instantiateModule({
+    module: rubyModule, wasip1: wasi
+  })
+  return vm;
+};
+
+function parseOptions(args) {
+  /** @type {import("util").ParseArgsConfig["options"]} */
+  const options = {
+    pkg: {
+      type: "string",
+      short: "p",
+      default: (() => {
+        const dirname = path.dirname(new URL(import.meta.url).pathname);
+        return path.resolve(dirname, "../packages/npm-packages/ruby-head-wasm-wasi");
+      })()
+    },
+    type: {
+      type: "string",
+      short: "t",
+      default: "component",
+    },
+    help: {
+      type: "boolean",
+      short: "h",
+    },
+  }
+  const { values } = parseArgs({ args, options });
+  return values;
+}
+
+function printUsage() {
+  console.log("Usage: repl.mjs [--pkg <npm-package-path>] [--type <component|module>]");
+}
+
+async function main() {
+  const args = parseOptions(process.argv.slice(2));
+  if (args["help"]) {
+    printUsage();
+    return;
+  }
+  const pkgPath = args["pkg"];
+  const vm = await (async () => {
+    switch (args["type"]) {
+      case "component": {
+        console.log(`Loading component from ${pkgPath}`);
+        return await instantiateComponent(pkgPath);
+      }
+      case "module": {
+        console.log(`Loading core module from ${pkgPath}`);
+        return await instantiateModule(pkgPath);
+      }
+      default:
+        throw new Error(`Unknown type: ${args["type"]}`);
+    }
+  })();
+  const rl = readline.createInterface({ input, output });
+
+  vm.eval(`puts RUBY_DESCRIPTION`);
+
+  const printer = vm.eval(`
+  class ReplPrinter
+    def puts(*args)
+      args.each do |arg|
+        Kernel.puts(arg)
+      end
+    end
+  end
+  ReplPrinter.new
+  `);
+  while (true) {
+    const line = await rl.question(`>> `);
+    try {
+      const result = vm.eval(line);
+      printer.call("puts", result);
+    } catch (e) {
+      console.error(e);
+    }
+  }
+}
+
+main().catch(console.error);

packages/npm-packages/ruby-wasm-wasi/src/browser.ts

@@ -25,22 +25,16 @@ export const DefaultRubyVM = async (
     new PreopenDirectory("/", new Map()),
   ];
   const wasi = new WASI(args, env, fds, { debug: false });
-  const vm = new RubyVM();
-
-  const imports = {
-    wasi_snapshot_preview1: wasi.wasiImport,
-  };
-  vm.addToImports(imports);
   const printer = options.consolePrint ?? true ? consolePrinter() : undefined;
-  printer?.addToImports(imports);
-
-  const instance = await WebAssembly.instantiate(rubyModule, imports);
-  await vm.setInstance(instance);
-
-  printer?.setMemory(instance.exports.memory as WebAssembly.Memory);
-
-  wasi.initialize(instance as any);
-  vm.initialize();
+  const { vm, instance } = await RubyVM.instantiateModule({
+    module: rubyModule, wasip1: wasi,
+    addToImports: (imports) => {
+      printer?.addToImports(imports);
+    },
+    setMemory: (memory) => {
+      printer?.setMemory(memory);
+    }
+  });
 
   return {
     vm,

packages/npm-packages/ruby-wasm-wasi/src/node.ts

@@ -6,19 +6,7 @@ export const DefaultRubyVM = async (
   options: { env?: Record<string, string> | undefined } = {},
 ) => {
   const wasi = new WASI({ env: options.env, version: "preview1", returnOnExit: true });
-  const vm = new RubyVM();
-  const imports = {
-    wasi_snapshot_preview1: wasi.wasiImport,
-  };
-
-  vm.addToImports(imports);
-
-  const instance = await WebAssembly.instantiate(rubyModule, imports);
-
-  await vm.setInstance(instance);
-
-  wasi.initialize(instance);
-  vm.initialize();
+  const { vm, instance } = await RubyVM.instantiateModule({ module: rubyModule, wasip1: wasi });
 
   return {
     vm,