@ruby/wasm-wasi 2.6.2 → 2.7.0

package/dist/cjs/vm.js

@@ -7,24 +7,111 @@ const rb_js_abi_host_js_1 = require("./bindgen/legacy/rb-js-abi-host.js");
 const binding_js_1 = require("./binding.js");
 /**
  * A Ruby VM instance
- *
- * @example
- *
- * const wasi = new WASI();
- * 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();
- *
+ * @see {@link RubyVM.instantiateComponent} and {@link RubyVM.instantiateModule} to create a new instance
+ * @category Essentials
  */
 class RubyVM {
+    /**
+     * Instantiate a Ruby VM with the given WebAssembly Core module with WASI Preview 1 implementation.
+     *
+     * @param options The options to instantiate the Ruby VM
+     * @returns A promise that resolves to the Ruby VM instance and the WebAssembly instance
+     * @category Essentials
+     *
+     * @example
+     *
+     * import { WASI } from "@bjorn3/browser_wasi_shim";
+     * const wasip1 = new WASI([], [], []);
+     * const module = await WebAssembly.compile("./path/to/ruby.wasm");
+     * const { vm } = await RubyVM.instantiateModule({ module, wasip1 });
+     *
+     */
+    static async instantiateModule(options) {
+        var _a, _b;
+        const { module, wasip1 } = options;
+        const vm = new RubyVM();
+        const imports = {
+            wasi_snapshot_preview1: wasip1.wasiImport,
+        };
+        vm.addToImports(imports);
+        (_a = options.addToImports) === null || _a === void 0 ? void 0 : _a.call(options, imports);
+        const instance = await WebAssembly.instantiate(module, imports);
+        await vm.setInstance(instance);
+        (_b = options.setMemory) === null || _b === void 0 ? void 0 : _b.call(options, instance.exports.memory);
+        wasip1.initialize(instance);
+        vm.initialize(options.args);
+        return { vm, instance };
+    }
+    /**
+     * Instantiate a Ruby VM with the given WebAssembly component with WASI Preview 2 implementation.
+     *
+     * @param options The options to instantiate the Ruby VM
+     * @returns A promise that resolves to the Ruby VM instance
+     * @category Essentials
+     *
+     * @example
+     *
+     * // First, you need to transpile the Ruby component to a JavaScript module using jco.
+     * // $ jco transpile --no-wasi-shim --instantiation --valid-lifting-optimization ./ruby.component.wasm -o ./component
+     * // Then, you can instantiate the Ruby VM with the component:
+     *
+     * import * as wasip2 from "@bytecodealliance/preview2-shim"
+     * import fs from "fs/promises";
+     * import path from "path";
+     *
+     * const { instantiate } = await import("./component/ruby.component.js");
+     * const getCoreModule = async (relativePath) => {
+     *   const buffer = await fs.readFile(path.join("./component", relativePath));
+     *   return WebAssembly.compile(buffer);
+     * }
+     *
+     * const { vm } = await RubyVM.instantiateComponent({
+     *   instantiate, getCoreModule, wasip2,
+     * });
+     *
+     */
+    static async instantiateComponent(options) {
+        let initComponent;
+        if ("getCoreModule" in options) {
+            // A convenience overload to instantiate with "instantiate" function generated by jco
+            initComponent = async (jsRuntime) => {
+                const { instantiate, getCoreModule, wasip2 } = options;
+                const { cli, clocks, filesystem, io, random, sockets, http } = wasip2;
+                const importObject = {
+                    "ruby:js/js-runtime": jsRuntime,
+                    "wasi:cli/environment": cli.environment,
+                    "wasi:cli/exit": cli.exit,
+                    "wasi:cli/stderr": cli.stderr,
+                    "wasi:cli/stdin": cli.stdin,
+                    "wasi:cli/stdout": cli.stdout,
+                    "wasi:cli/terminal-input": cli.terminalInput,
+                    "wasi:cli/terminal-output": cli.terminalOutput,
+                    "wasi:cli/terminal-stderr": cli.terminalStderr,
+                    "wasi:cli/terminal-stdin": cli.terminalStdin,
+                    "wasi:cli/terminal-stdout": cli.terminalStdout,
+                    "wasi:clocks/monotonic-clock": clocks.monotonicClock,
+                    "wasi:clocks/wall-clock": clocks.wallClock,
+                    "wasi:filesystem/preopens": filesystem.preopens,
+                    "wasi:filesystem/types": filesystem.types,
+                    "wasi:io/error": io.error,
+                    "wasi:io/poll": io.poll,
+                    "wasi:io/streams": io.streams,
+                    "wasi:random/random": random.random,
+                    "wasi:sockets/tcp": sockets.tcp,
+                    "wasi:http/types": http.types,
+                    "wasi:http/incoming-handler": http.incomingHandler,
+                    "wasi:http/outgoing-handler": http.outgoingHandler,
+                };
+                const component = await instantiate(getCoreModule, importObject, options.instantiateCore);
+                return component.rubyRuntime;
+            };
+        }
+        else {
+            initComponent = options.instantiate;
+        }
+        const vm = await this._instantiate({}, initComponent);
+        return { vm };
+    }
     constructor(binding) {
         this.instance = null;
         this.interfaceState = {
@@ -73,7 +160,7 @@ class RubyVM {
         this.transport = new JsValueTransport();
         this.exceptionFormatter = new RbExceptionFormatter();
     }
-    static async _instantiate(initComponent, options) {
+    static async _instantiate(options, initComponent) {
         const binding = new binding_js_1.ComponentBinding();
         const vm = new RubyVM(binding);
         class JsAbiValue {
@@ -101,14 +188,21 @@ class RubyVM {
      * Initialize the Ruby VM with the given command line arguments
      * @param args The command line arguments to pass to Ruby. Must be
      * an array of strings starting with the Ruby program name.
+     * @category Low-level initialization
      */
     initialize(args = ["ruby.wasm", "-EUTF-8", "-e_=0"]) {
         const c_args = args.map((arg) => arg + "\0");
-        this.guest.rubyInit();
-        this.guest.rubySysinit(c_args);
-        this.guest.rubyOptions(c_args);
+        this.guest.rubyInit(c_args);
         try {
-            this.eval(`require "/bundle/setup"`);
+            this.eval(`
+        # Require Bundler standalone setup
+        if File.exist?("/bundle/bundler/setup.rb")
+          require "/bundle/bundler/setup.rb"
+        elsif File.exist?("/bundle/setup.rb")
+          # For non-CM builds, which doesn't use Bundler's standalone mode
+          require "/bundle/setup.rb"
+        end
+      `);
         }
         catch (e) {
             console.warn("Failed to load /bundle/setup", e);
@@ -122,6 +216,7 @@ class RubyVM {
      * @param instance The WebAssembly instance to interact with. Must
      * be instantiated from a Ruby built with JS extension, and built
      * with Reactor ABI instead of command line.
+     * @category Low-level initialization
      */
     async setInstance(instance) {
         this.instance = instance;
@@ -131,6 +226,7 @@ class RubyVM {
      * Add intrinsic import entries, which is necessary to interact JavaScript
      * and Ruby's WebAssembly instance.
      * @param imports The import object to add to the WebAssembly instance
+     * @category Low-level initialization
      */
     addToImports(imports) {
         this.guest.addToImports(imports);
@@ -336,6 +432,7 @@ class RubyVM {
      * Runs a string of Ruby code from JavaScript
      * @param code The Ruby code to run
      * @returns the result of the last expression
+     * @category Essentials
      *
      * @example
      * vm.eval("puts 'hello world'");
@@ -351,6 +448,7 @@ class RubyVM {
      * Returns a promise that resolves when execution completes.
      * @param code The Ruby code to run
      * @returns a promise that resolves to the result of the last expression
+     * @category Essentials
      *
      * @example
      * const text = await vm.evalAsync(`
@@ -434,6 +532,7 @@ class JsValueTransport {
 }
 /**
  * A RbValue is an object that represents a value in Ruby
+ * @category Essentials
  */
 class RbValue {
     /**

package/dist/esm/bindgen/interfaces/ruby-js-js-runtime.d.ts

@@ -16,7 +16,7 @@ export namespace RubyJsJsRuntime {
   export function jsValueTypeof(value: JsAbiValue): string;
   export function jsValueEqual(lhs: JsAbiValue, rhs: JsAbiValue): boolean;
   export function jsValueStrictlyEqual(lhs: JsAbiValue, rhs: JsAbiValue): boolean;
-  export function reflectApply(target: JsAbiValue, thisArgument: JsAbiValue, arguments: JsAbiValue[]): JsAbiResult;
+  export function reflectApply(target: JsAbiValue, thisArgument: JsAbiValue, arguments: Array<JsAbiValue>): JsAbiResult;
   export function reflectGet(target: JsAbiValue, propertyKey: string): JsAbiResult;
   export function reflectSet(target: JsAbiValue, propertyKey: string, value: JsAbiValue): JsAbiResult;
   export function throwProhibitRewindException(message: string): void;

package/dist/esm/bindgen/interfaces/ruby-js-ruby-runtime.d.ts

@@ -1,12 +1,9 @@
 export namespace RubyJsRubyRuntime {
   export function rubyShowVersion(): void;
-  export function rubyInit(): void;
-  export function rubySysinit(args: string[]): void;
-  export function rubyOptions(args: string[]): RbIseq;
-  export function rubyScript(name: string): void;
+  export function rubyInit(args: Array<string>): void;
   export function rubyInitLoadpath(): void;
   export function rbEvalStringProtect(str: string): [RbAbiValue, number];
-  export function rbFuncallvProtect(recv: RbAbiValue, mid: RbId, args: RbAbiValue[]): [RbAbiValue, number];
+  export function rbFuncallvProtect(recv: RbAbiValue, mid: RbId, args: Array<RbAbiValue>): [RbAbiValue, number];
   export function rbIntern(name: string): RbId;
   export function rbErrinfo(): RbAbiValue;
   export function rbClearErrinfo(): void;
@@ -27,7 +24,6 @@ export namespace RubyJsRubyRuntime {
    * 4. `export-rb-value-to-js()` returns the staged value
    */
   export function exportRbValueToJs(): RbAbiValue;
-  export { RbIseq };
   export { RbAbiValue };
 }
 import type { JsAbiValue } from './ruby-js-js-runtime.js';
@@ -37,6 +33,3 @@ export type RbId = number;
 
 export class RbAbiValue {
 }
-
-export class RbIseq {
-}

package/dist/esm/bindgen/legacy/rb-abi-guest.d.ts

@@ -68,10 +68,7 @@ export class RbAbiGuest {
   imports?: any,
   ): Promise<void>;
   rubyShowVersion(): void;
-  rubyInit(): void;
-  rubySysinit(args: string[]): void;
-  rubyOptions(args: string[]): RbIseq;
-  rubyScript(name: string): void;
+  rubyInit(args: string[]): void;
   rubyInitLoadpath(): void;
   rbEvalStringProtect(str: string): [RbAbiValue, number];
   rbFuncallvProtect(recv: RbAbiValue, mid: RbId, args: RbAbiValue[]): [RbAbiValue, number];
@@ -85,33 +82,6 @@ export class RbAbiGuest {
   rbSetShouldProhibitRewind(newValue: boolean): boolean;
 }
 
-export class RbIseq {
-  // Creates a new strong reference count as a new
-  // object.  This is only required if you're also
-  // calling `drop` below and want to manually manage
-  // the reference count from JS.
-  //
-  // If you don't call `drop`, you don't need to call
-  // this and can simply use the object from JS.
-  clone(): RbIseq;
-  
-  // Explicitly indicate that this JS object will no
-  // longer be used. If the internal reference count
-  // reaches zero then this will deterministically
-  // destroy the underlying wasm object.
-  //
-  // This is not required to be called from JS. Wasm
-  // destructors will be automatically called for you
-  // if this is not called using the JS
-  // `FinalizationRegistry`.
-  //
-  // Calling this method does not guarantee that the
-  // underlying wasm object is deallocated. Something
-  // else (including wasm) may be holding onto a
-  // strong reference count.
-  drop(): void;
-}
-
 export class RbAbiValue {
   // Creates a new strong reference count as a new
   // object.  This is only required if you're also

package/dist/esm/bindgen/legacy/rb-abi-guest.js

@@ -2,38 +2,23 @@ import { data_view, to_uint32, UTF8_DECODER, utf8_encode, UTF8_ENCODED_LEN, Slab
 export class RbAbiGuest {
     constructor() {
         this._resource0_slab = new Slab();
-        this._resource1_slab = new Slab();
     }
     addToImports(imports) {
         if (!("canonical_abi" in imports))
             imports["canonical_abi"] = {};
-        imports.canonical_abi['resource_drop_rb-iseq'] = i => {
+        imports.canonical_abi['resource_drop_rb-abi-value'] = i => {
             this._resource0_slab.remove(i).drop();
         };
-        imports.canonical_abi['resource_clone_rb-iseq'] = i => {
+        imports.canonical_abi['resource_clone_rb-abi-value'] = i => {
             const obj = this._resource0_slab.get(i);
             return this._resource0_slab.insert(obj.clone());
         };
-        imports.canonical_abi['resource_get_rb-iseq'] = i => {
-            return this._resource0_slab.get(i)._wasm_val;
-        };
-        imports.canonical_abi['resource_new_rb-iseq'] = i => {
-            const registry = this._registry0;
-            return this._resource0_slab.insert(new RbIseq(i, this));
-        };
-        imports.canonical_abi['resource_drop_rb-abi-value'] = i => {
-            this._resource1_slab.remove(i).drop();
-        };
-        imports.canonical_abi['resource_clone_rb-abi-value'] = i => {
-            const obj = this._resource1_slab.get(i);
-            return this._resource1_slab.insert(obj.clone());
-        };
         imports.canonical_abi['resource_get_rb-abi-value'] = i => {
-            return this._resource1_slab.get(i)._wasm_val;
+            return this._resource0_slab.get(i)._wasm_val;
         };
         imports.canonical_abi['resource_new_rb-abi-value'] = i => {
-            const registry = this._registry1;
-            return this._resource1_slab.insert(new RbAbiValue(i, this));
+            const registry = this._registry0;
+            return this._resource0_slab.insert(new RbAbiValue(i, this));
         };
     }
     async instantiate(module, imports) {
@@ -54,32 +39,12 @@ export class RbAbiGuest {
             this.instance = instance;
         }
         this._exports = this.instance.exports;
-        this._registry0 = new FinalizationRegistry(this._exports['canonical_abi_drop_rb-iseq']);
-        this._registry1 = new FinalizationRegistry(this._exports['canonical_abi_drop_rb-abi-value']);
+        this._registry0 = new FinalizationRegistry(this._exports['canonical_abi_drop_rb-abi-value']);
     }
     rubyShowVersion() {
         this._exports['ruby-show-version: func() -> ()']();
     }
-    rubyInit() {
-        this._exports['ruby-init: func() -> ()']();
-    }
-    rubySysinit(arg0) {
-        const memory = this._exports.memory;
-        const realloc = this._exports["cabi_realloc"];
-        const vec1 = arg0;
-        const len1 = vec1.length;
-        const result1 = realloc(0, 0, 4, len1 * 8);
-        for (let i = 0; i < vec1.length; i++) {
-            const e = vec1[i];
-            const base = result1 + i * 8;
-            const ptr0 = utf8_encode(e, realloc, memory);
-            const len0 = UTF8_ENCODED_LEN;
-            data_view(memory).setInt32(base + 4, len0, true);
-            data_view(memory).setInt32(base + 0, ptr0, true);
-        }
-        this._exports['ruby-sysinit: func(args: list<string>) -> ()'](result1, len1);
-    }
-    rubyOptions(arg0) {
+    rubyInit(arg0) {
         const memory = this._exports.memory;
         const realloc = this._exports["cabi_realloc"];
         const vec1 = arg0;
@@ -93,15 +58,7 @@ export class RbAbiGuest {
             data_view(memory).setInt32(base + 4, len0, true);
             data_view(memory).setInt32(base + 0, ptr0, true);
         }
-        const ret = this._exports['ruby-options: func(args: list<string>) -> handle<rb-iseq>'](result1, len1);
-        return this._resource0_slab.remove(ret);
-    }
-    rubyScript(arg0) {
-        const memory = this._exports.memory;
-        const realloc = this._exports["cabi_realloc"];
-        const ptr0 = utf8_encode(arg0, realloc, memory);
-        const len0 = UTF8_ENCODED_LEN;
-        this._exports['ruby-script: func(name: string) -> ()'](ptr0, len0);
+        this._exports['ruby-init: func(args: list<string>) -> ()'](result1, len1);
     }
     rubyInitLoadpath() {
         this._exports['ruby-init-loadpath: func() -> ()']();
@@ -112,7 +69,7 @@ export class RbAbiGuest {
         const ptr0 = utf8_encode(arg0, realloc, memory);
         const len0 = UTF8_ENCODED_LEN;
         const ret = this._exports['rb-eval-string-protect: func(str: string) -> tuple<handle<rb-abi-value>, s32>'](ptr0, len0);
-        return [this._resource1_slab.remove(data_view(memory).getInt32(ret + 0, true)), data_view(memory).getInt32(ret + 4, true)];
+        return [this._resource0_slab.remove(data_view(memory).getInt32(ret + 0, true)), data_view(memory).getInt32(ret + 4, true)];
     }
     rbFuncallvProtect(arg0, arg1, arg2) {
         const memory = this._exports.memory;
@@ -129,10 +86,10 @@ export class RbAbiGuest {
             const obj1 = e;
             if (!(obj1 instanceof RbAbiValue))
                 throw new TypeError('expected instance of RbAbiValue');
-            data_view(memory).setInt32(base + 0, this._resource1_slab.insert(obj1.clone()), true);
+            data_view(memory).setInt32(base + 0, this._resource0_slab.insert(obj1.clone()), true);
         }
-        const ret = this._exports['rb-funcallv-protect: func(recv: handle<rb-abi-value>, mid: u32, args: list<handle<rb-abi-value>>) -> tuple<handle<rb-abi-value>, s32>'](this._resource1_slab.insert(obj0.clone()), to_uint32(arg1), result2, len2);
-        return [this._resource1_slab.remove(data_view(memory).getInt32(ret + 0, true)), data_view(memory).getInt32(ret + 4, true)];
+        const ret = this._exports['rb-funcallv-protect: func(recv: handle<rb-abi-value>, mid: u32, args: list<handle<rb-abi-value>>) -> tuple<handle<rb-abi-value>, s32>'](this._resource0_slab.insert(obj0.clone()), to_uint32(arg1), result2, len2);
+        return [this._resource0_slab.remove(data_view(memory).getInt32(ret + 0, true)), data_view(memory).getInt32(ret + 4, true)];
     }
     rbIntern(arg0) {
         const memory = this._exports.memory;
@@ -144,7 +101,7 @@ export class RbAbiGuest {
     }
     rbErrinfo() {
         const ret = this._exports['rb-errinfo: func() -> handle<rb-abi-value>']();
-        return this._resource1_slab.remove(ret);
+        return this._resource0_slab.remove(ret);
     }
     rbClearErrinfo() {
         this._exports['rb-clear-errinfo: func() -> ()']();
@@ -154,7 +111,7 @@ export class RbAbiGuest {
         const obj0 = arg0;
         if (!(obj0 instanceof RbAbiValue))
             throw new TypeError('expected instance of RbAbiValue');
-        const ret = this._exports['rstring-ptr: func(value: handle<rb-abi-value>) -> string'](this._resource1_slab.insert(obj0.clone()));
+        const ret = this._exports['rstring-ptr: func(value: handle<rb-abi-value>) -> string'](this._resource0_slab.insert(obj0.clone()));
         const ptr1 = data_view(memory).getInt32(ret + 0, true);
         const len1 = data_view(memory).getInt32(ret + 4, true);
         const result1 = UTF8_DECODER.decode(new Uint8Array(memory.buffer, ptr1, len1));
@@ -180,7 +137,7 @@ export class RbAbiGuest {
         return bool0 == 0 ? false : (bool0 == 1 ? true : throw_invalid_bool());
     }
 }
-export class RbIseq {
+export class RbAbiValue {
     constructor(wasm_val, obj) {
         this._wasm_val = wasm_val;
         this._obj = obj;
@@ -196,30 +153,6 @@ export class RbIseq {
         if (this._refcnt !== 0)
             return;
         this._obj._registry0.unregister(this);
-        const dtor = this._obj._exports['canonical_abi_drop_rb-iseq'];
-        const wasm_val = this._wasm_val;
-        delete this._obj;
-        delete this._refcnt;
-        delete this._wasm_val;
-        dtor(wasm_val);
-    }
-}
-export class RbAbiValue {
-    constructor(wasm_val, obj) {
-        this._wasm_val = wasm_val;
-        this._obj = obj;
-        this._refcnt = 1;
-        obj._registry1.register(this, wasm_val, this);
-    }
-    clone() {
-        this._refcnt += 1;
-        return this;
-    }
-    drop() {
-        this._refcnt -= 1;
-        if (this._refcnt !== 0)
-            return;
-        this._obj._registry1.unregister(this);
         const dtor = this._obj._exports['canonical_abi_drop_rb-abi-value'];
         const wasm_val = this._wasm_val;
         delete this._obj;

package/dist/esm/binding.d.ts

@@ -6,10 +6,7 @@ import * as RbAbi from "./bindgen/legacy/rb-abi-guest.js";
  */
 export interface Binding {
     rubyShowVersion(): void;
-    rubyInit(): void;
-    rubySysinit(args: string[]): void;
-    rubyOptions(args: string[]): void;
-    rubyScript(name: string): void;
+    rubyInit(args: string[]): void;
     rubyInitLoadpath(): void;
     rbEvalStringProtect(str: string): [RbAbiValue, number];
     rbFuncallvProtect(recv: RbAbiValue, mid: RbAbi.RbId, args: RbAbiValue[]): [RbAbiValue, number];
@@ -34,10 +31,7 @@ export declare class ComponentBinding implements Binding {
     constructor();
     setUnderlying(underlying: typeof RubyJsRubyRuntime): void;
     rubyShowVersion(): void;
-    rubyInit(): void;
-    rubySysinit(args: string[]): void;
-    rubyOptions(args: string[]): void;
-    rubyScript(name: string): void;
+    rubyInit(args: string[]): void;
     rubyInitLoadpath(): void;
     rbEvalStringProtect(str: string): [RbAbiValue, number];
     rbFuncallvProtect(recv: RbAbiValue, mid: number, args: RbAbiValue[]): [RbAbiValue, number];

package/dist/esm/binding.js

@@ -12,17 +12,8 @@ export class ComponentBinding {
     rubyShowVersion() {
         this.underlying.rubyShowVersion();
     }
-    rubyInit() {
-        this.underlying.rubyInit();
-    }
-    rubySysinit(args) {
-        this.underlying.rubySysinit(args);
-    }
-    rubyOptions(args) {
-        this.underlying.rubyOptions(args);
-    }
-    rubyScript(name) {
-        this.underlying.rubyScript(name);
+    rubyInit(args) {
+        this.underlying.rubyInit(args);
     }
     rubyInitLoadpath() {
         this.underlying.rubyInitLoadpath();

package/dist/esm/browser.js

@@ -12,18 +12,16 @@ export const DefaultRubyVM = async (rubyModule, options = {}) => {
         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 = ((_b = options.consolePrint) !== null && _b !== void 0 ? _b : true) ? consolePrinter() : undefined;
-    printer === null || printer === void 0 ? void 0 : printer.addToImports(imports);
-    const instance = await WebAssembly.instantiate(rubyModule, imports);
-    await vm.setInstance(instance);
-    printer === null || printer === void 0 ? void 0 : printer.setMemory(instance.exports.memory);
-    wasi.initialize(instance);
-    vm.initialize();
+    const { vm, instance } = await RubyVM.instantiateModule({
+        module: rubyModule, wasip1: wasi,
+        addToImports: (imports) => {
+            printer === null || printer === void 0 ? void 0 : printer.addToImports(imports);
+        },
+        setMemory: (memory) => {
+            printer === null || printer === void 0 ? void 0 : printer.setMemory(memory);
+        }
+    });
     return {
         vm,
         wasi,

package/dist/esm/browser.script.d.ts

@@ -1,5 +1,19 @@
 import { DefaultRubyVM } from "./browser.js";
+import { RubyComponentInstantiator } from "./vm.js";
+/**
+ * The main entry point of `<script type="text/ruby">`-based scripting with WebAssembly Core Module.
+ */
 export declare const main: (pkg: {
     name: string;
     version: string;
 }, options?: Parameters<typeof DefaultRubyVM>[1]) => Promise<void>;
+/**
+ * The main entry point of `<script type="text/ruby">`-based scripting with WebAssembly Component.
+ */
+export declare const componentMain: (pkg: {
+    name: string;
+    version: string;
+}, options: {
+    instantiate: RubyComponentInstantiator;
+    wasip2: any;
+}) => Promise<void>;

package/dist/esm/browser.script.js

@@ -1,9 +1,28 @@
 import { __asyncValues } from "tslib";
 import { DefaultRubyVM } from "./browser.js";
+import { RubyVM } from "./vm.js";
+/**
+ * The main entry point of `<script type="text/ruby">`-based scripting with WebAssembly Core Module.
+ */
 export const main = async (pkg, options) => {
     const response = fetch(`https://cdn.jsdelivr.net/npm/${pkg.name}@${pkg.version}/dist/ruby+stdlib.wasm`);
     const module = await compileWebAssemblyModule(response);
     const { vm } = await DefaultRubyVM(module, options);
+    await mainWithRubyVM(vm);
+};
+/**
+ * The main entry point of `<script type="text/ruby">`-based scripting with WebAssembly Component.
+ */
+export const componentMain = async (pkg, options) => {
+    const componentUrl = `https://cdn.jsdelivr.net/npm/${pkg.name}@${pkg.version}/dist/component`;
+    const fetchComponentFile = (relativePath) => fetch(`${componentUrl}/${relativePath}`);
+    const { vm } = await RubyVM.instantiateComponent(Object.assign(Object.assign({}, options), { getCoreModule: (relativePath) => {
+            const response = fetchComponentFile(relativePath);
+            return compileWebAssemblyModule(response);
+        } }));
+    await mainWithRubyVM(vm);
+};
+const mainWithRubyVM = async (vm) => {
     vm.printVersion();
     globalThis.rubyVM = vm;
     // Wait for the text/ruby script tag to be read.

package/dist/esm/node.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import { WASI } from "wasi";
 import { RubyVM } from "./vm.js";
 export declare const DefaultRubyVM: (rubyModule: WebAssembly.Module, options?: {

package/dist/esm/node.js

@@ -2,15 +2,7 @@ import { WASI } from "wasi";
 import { RubyVM } from "./vm.js";
 export const DefaultRubyVM = async (rubyModule, options = {}) => {
     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,
         wasi,