@ruby/wasm-wasi 2.9.4-2026-07-20-a → 2.9.4-2026-07-23-a

package/dist/browser.script.umd.js

@@ -820,9 +820,16 @@
                 initComponent = async (jsRuntime) => {
                     const { instantiate, getCoreModule, wasip2 } = options;
                     const { cli, clocks, filesystem, io, random, sockets, http } = wasip2;
+                    const environment = options.env ? Object.assign(Object.assign({}, cli.environment), { getEnvironment: () => {
+                            var _a;
+                            return Array.from(new Map([
+                                ...cli.environment.getEnvironment(),
+                                ...Object.entries((_a = options.env) !== null && _a !== void 0 ? _a : {}),
+                            ]).entries());
+                        } }) : cli.environment;
                     const importObject = {
                         "ruby:js/js-runtime": jsRuntime,
-                        "wasi:cli/environment": cli.environment,
+                        "wasi:cli/environment": environment,
                         "wasi:cli/exit": cli.exit,
                         "wasi:cli/stderr": cli.stderr,
                         "wasi:cli/stdin": cli.stdin,
@@ -1602,18 +1609,20 @@
      * The main entry point of `<script type="text/ruby">`-based scripting with WebAssembly Core Module.
      */
     const main = async (pkg, options) => {
+        const scriptEnv = parseDataEnv(document.currentScript);
         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);
+        const { vm } = await DefaultRubyVM(module, Object.assign(Object.assign({}, options), { env: Object.assign(Object.assign({}, scriptEnv), options === null || options === void 0 ? void 0 : options.env) }));
         await mainWithRubyVM(vm);
     };
     /**
      * The main entry point of `<script type="text/ruby">`-based scripting with WebAssembly Component.
      */
     const componentMain = async (pkg, options) => {
+        const scriptEnv = parseDataEnv(document.currentScript);
         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 { vm } = await RubyVM.instantiateComponent(Object.assign(Object.assign({}, options), { env: Object.assign(Object.assign({}, scriptEnv), options.env), getCoreModule: (relativePath) => {
                 const response = fetchComponentFile(relativePath);
                 return compileWebAssemblyModule(response);
             } }));
@@ -1672,6 +1681,53 @@
         }
         return rawEvalStyle;
     };
+    /**
+     * Parses the data-env attribute as a JSON object string, for example:
+     * data-env='{"RUBY_BOX":"1","MSG":"hello world"}'
+     *
+     * The parsed value must be a non-null object, not an array. Each key must not
+     * contain "=" or NUL, and each value must be a string.
+     *
+     * JSON is used instead of a shell-like KEY=value list so keys and values can
+     * contain spaces and values can contain "=" without custom escaping rules.
+     */
+    const parseDataEnv = (tag) => {
+        const rawEnv = tag === null || tag === void 0 ? void 0 : tag.getAttribute("data-env");
+        if (!rawEnv) {
+            return {};
+        }
+        const trimmedEnv = rawEnv.trim();
+        if (!trimmedEnv) {
+            return {};
+        }
+        let parsedEnv;
+        try {
+            parsedEnv = JSON.parse(trimmedEnv);
+        }
+        catch (error) {
+            console.warn(`data-env must be a JSON object string. ${rawEnv} is ignored.`);
+            return {};
+        }
+        if (typeof parsedEnv !== "object" ||
+            parsedEnv === null ||
+            Array.isArray(parsedEnv)) {
+            console.warn(`data-env must be a JSON object string. ${rawEnv} is ignored.`);
+            return {};
+        }
+        return Object.entries(parsedEnv).reduce((env, [key, value]) => {
+            if (key.includes("=") || key.includes("\0")) {
+                console.warn(`data-env key must not contain "=" or NUL. ${key} is ignored.`);
+                return env;
+            }
+            // POSIX environment values may contain arbitrary bytes, but data-env only accepts strings.
+            if (typeof value !== "string") {
+                console.warn(`data-env value for ${key} must be a string. It is ignored.`);
+                return env;
+            }
+            env[key] = value;
+            return env;
+        }, {});
+    };
     const loadScriptAsync = async (tag) => {
         const evalStyle = deriveEvalStyle(tag);
         // Inline comments can be written with the src attribute of the script tag.

package/dist/browser.umd.js

@@ -778,9 +778,16 @@
                 initComponent = async (jsRuntime) => {
                     const { instantiate, getCoreModule, wasip2 } = options;
                     const { cli, clocks, filesystem, io, random, sockets, http } = wasip2;
+                    const environment = options.env ? Object.assign(Object.assign({}, cli.environment), { getEnvironment: () => {
+                            var _a;
+                            return Array.from(new Map([
+                                ...cli.environment.getEnvironment(),
+                                ...Object.entries((_a = options.env) !== null && _a !== void 0 ? _a : {}),
+                            ]).entries());
+                        } }) : cli.environment;
                     const importObject = {
                         "ruby:js/js-runtime": jsRuntime,
-                        "wasi:cli/environment": cli.environment,
+                        "wasi:cli/environment": environment,
                         "wasi:cli/exit": cli.exit,
                         "wasi:cli/stderr": cli.stderr,
                         "wasi:cli/stdin": cli.stdin,

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

@@ -16,4 +16,5 @@ export declare const componentMain: (pkg: {
 }, options: {
     instantiate: RubyComponentInstantiator;
     wasip2: any;
+    env?: Record<string, string> | undefined;
 }) => Promise<void>;

package/dist/cjs/browser.script.js

@@ -8,9 +8,10 @@ const vm_js_1 = require("./vm.js");
  * The main entry point of `<script type="text/ruby">`-based scripting with WebAssembly Core Module.
  */
 const main = async (pkg, options) => {
+    const scriptEnv = parseDataEnv(document.currentScript);
     const response = fetch(`https://cdn.jsdelivr.net/npm/${pkg.name}@${pkg.version}/dist/ruby+stdlib.wasm`);
     const module = await compileWebAssemblyModule(response);
-    const { vm } = await (0, browser_js_1.DefaultRubyVM)(module, options);
+    const { vm } = await (0, browser_js_1.DefaultRubyVM)(module, Object.assign(Object.assign({}, options), { env: Object.assign(Object.assign({}, scriptEnv), options === null || options === void 0 ? void 0 : options.env) }));
     await mainWithRubyVM(vm);
 };
 exports.main = main;
@@ -18,9 +19,10 @@ exports.main = main;
  * The main entry point of `<script type="text/ruby">`-based scripting with WebAssembly Component.
  */
 const componentMain = async (pkg, options) => {
+    const scriptEnv = parseDataEnv(document.currentScript);
     const componentUrl = `https://cdn.jsdelivr.net/npm/${pkg.name}@${pkg.version}/dist/component`;
     const fetchComponentFile = (relativePath) => fetch(`${componentUrl}/${relativePath}`);
-    const { vm } = await vm_js_1.RubyVM.instantiateComponent(Object.assign(Object.assign({}, options), { getCoreModule: (relativePath) => {
+    const { vm } = await vm_js_1.RubyVM.instantiateComponent(Object.assign(Object.assign({}, options), { env: Object.assign(Object.assign({}, scriptEnv), options.env), getCoreModule: (relativePath) => {
             const response = fetchComponentFile(relativePath);
             return compileWebAssemblyModule(response);
         } }));
@@ -80,6 +82,53 @@ const deriveEvalStyle = (tag) => {
     }
     return rawEvalStyle;
 };
+/**
+ * Parses the data-env attribute as a JSON object string, for example:
+ * data-env='{"RUBY_BOX":"1","MSG":"hello world"}'
+ *
+ * The parsed value must be a non-null object, not an array. Each key must not
+ * contain "=" or NUL, and each value must be a string.
+ *
+ * JSON is used instead of a shell-like KEY=value list so keys and values can
+ * contain spaces and values can contain "=" without custom escaping rules.
+ */
+const parseDataEnv = (tag) => {
+    const rawEnv = tag === null || tag === void 0 ? void 0 : tag.getAttribute("data-env");
+    if (!rawEnv) {
+        return {};
+    }
+    const trimmedEnv = rawEnv.trim();
+    if (!trimmedEnv) {
+        return {};
+    }
+    let parsedEnv;
+    try {
+        parsedEnv = JSON.parse(trimmedEnv);
+    }
+    catch (error) {
+        console.warn(`data-env must be a JSON object string. ${rawEnv} is ignored.`);
+        return {};
+    }
+    if (typeof parsedEnv !== "object" ||
+        parsedEnv === null ||
+        Array.isArray(parsedEnv)) {
+        console.warn(`data-env must be a JSON object string. ${rawEnv} is ignored.`);
+        return {};
+    }
+    return Object.entries(parsedEnv).reduce((env, [key, value]) => {
+        if (key.includes("=") || key.includes("\0")) {
+            console.warn(`data-env key must not contain "=" or NUL. ${key} is ignored.`);
+            return env;
+        }
+        // POSIX environment values may contain arbitrary bytes, but data-env only accepts strings.
+        if (typeof value !== "string") {
+            console.warn(`data-env value for ${key} must be a string. It is ignored.`);
+            return env;
+        }
+        env[key] = value;
+        return env;
+    }, {});
+};
 const loadScriptAsync = async (tag) => {
     const evalStyle = deriveEvalStyle(tag);
     // Inline comments can be written with the src attribute of the script tag.

package/dist/cjs/vm.d.ts

@@ -37,6 +37,10 @@ export type RubyInitComponentOptions = {
      * WASI Preview 2 implementation, typically imported from `import * as wasip2 from "@bytecodealliance/preview2-shim"`
      */
     wasip2: any;
+    /**
+     * Environment variables to pass to the Ruby VM.
+     */
+    env?: Record<string, string> | undefined;
     /**
      * The arguments to pass to the Ruby VM. Note that the first argument must be the Ruby program name.
      *

package/dist/cjs/vm.js

@@ -83,9 +83,16 @@ class RubyVM {
             initComponent = async (jsRuntime) => {
                 const { instantiate, getCoreModule, wasip2 } = options;
                 const { cli, clocks, filesystem, io, random, sockets, http } = wasip2;
+                const environment = options.env ? Object.assign(Object.assign({}, cli.environment), { getEnvironment: () => {
+                        var _a;
+                        return Array.from(new Map([
+                            ...cli.environment.getEnvironment(),
+                            ...Object.entries((_a = options.env) !== null && _a !== void 0 ? _a : {}),
+                        ]).entries());
+                    } }) : cli.environment;
                 const importObject = {
                     "ruby:js/js-runtime": jsRuntime,
-                    "wasi:cli/environment": cli.environment,
+                    "wasi:cli/environment": environment,
                     "wasi:cli/exit": cli.exit,
                     "wasi:cli/stderr": cli.stderr,
                     "wasi:cli/stdin": cli.stdin,

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

@@ -16,4 +16,5 @@ export declare const componentMain: (pkg: {
 }, options: {
     instantiate: RubyComponentInstantiator;
     wasip2: any;
+    env?: Record<string, string> | undefined;
 }) => Promise<void>;

package/dist/esm/browser.script.js

@@ -5,18 +5,20 @@ 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 scriptEnv = parseDataEnv(document.currentScript);
     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);
+    const { vm } = await DefaultRubyVM(module, Object.assign(Object.assign({}, options), { env: Object.assign(Object.assign({}, scriptEnv), options === null || options === void 0 ? void 0 : options.env) }));
     await mainWithRubyVM(vm);
 };
 /**
  * The main entry point of `<script type="text/ruby">`-based scripting with WebAssembly Component.
  */
 export const componentMain = async (pkg, options) => {
+    const scriptEnv = parseDataEnv(document.currentScript);
     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 { vm } = await RubyVM.instantiateComponent(Object.assign(Object.assign({}, options), { env: Object.assign(Object.assign({}, scriptEnv), options.env), getCoreModule: (relativePath) => {
             const response = fetchComponentFile(relativePath);
             return compileWebAssemblyModule(response);
         } }));
@@ -75,6 +77,53 @@ const deriveEvalStyle = (tag) => {
     }
     return rawEvalStyle;
 };
+/**
+ * Parses the data-env attribute as a JSON object string, for example:
+ * data-env='{"RUBY_BOX":"1","MSG":"hello world"}'
+ *
+ * The parsed value must be a non-null object, not an array. Each key must not
+ * contain "=" or NUL, and each value must be a string.
+ *
+ * JSON is used instead of a shell-like KEY=value list so keys and values can
+ * contain spaces and values can contain "=" without custom escaping rules.
+ */
+const parseDataEnv = (tag) => {
+    const rawEnv = tag === null || tag === void 0 ? void 0 : tag.getAttribute("data-env");
+    if (!rawEnv) {
+        return {};
+    }
+    const trimmedEnv = rawEnv.trim();
+    if (!trimmedEnv) {
+        return {};
+    }
+    let parsedEnv;
+    try {
+        parsedEnv = JSON.parse(trimmedEnv);
+    }
+    catch (error) {
+        console.warn(`data-env must be a JSON object string. ${rawEnv} is ignored.`);
+        return {};
+    }
+    if (typeof parsedEnv !== "object" ||
+        parsedEnv === null ||
+        Array.isArray(parsedEnv)) {
+        console.warn(`data-env must be a JSON object string. ${rawEnv} is ignored.`);
+        return {};
+    }
+    return Object.entries(parsedEnv).reduce((env, [key, value]) => {
+        if (key.includes("=") || key.includes("\0")) {
+            console.warn(`data-env key must not contain "=" or NUL. ${key} is ignored.`);
+            return env;
+        }
+        // POSIX environment values may contain arbitrary bytes, but data-env only accepts strings.
+        if (typeof value !== "string") {
+            console.warn(`data-env value for ${key} must be a string. It is ignored.`);
+            return env;
+        }
+        env[key] = value;
+        return env;
+    }, {});
+};
 const loadScriptAsync = async (tag) => {
     const evalStyle = deriveEvalStyle(tag);
     // Inline comments can be written with the src attribute of the script tag.

package/dist/esm/vm.d.ts

@@ -37,6 +37,10 @@ export type RubyInitComponentOptions = {
      * WASI Preview 2 implementation, typically imported from `import * as wasip2 from "@bytecodealliance/preview2-shim"`
      */
     wasip2: any;
+    /**
+     * Environment variables to pass to the Ruby VM.
+     */
+    env?: Record<string, string> | undefined;
     /**
      * The arguments to pass to the Ruby VM. Note that the first argument must be the Ruby program name.
      *

package/dist/esm/vm.js

@@ -79,9 +79,16 @@ export class RubyVM {
             initComponent = async (jsRuntime) => {
                 const { instantiate, getCoreModule, wasip2 } = options;
                 const { cli, clocks, filesystem, io, random, sockets, http } = wasip2;
+                const environment = options.env ? Object.assign(Object.assign({}, cli.environment), { getEnvironment: () => {
+                        var _a;
+                        return Array.from(new Map([
+                            ...cli.environment.getEnvironment(),
+                            ...Object.entries((_a = options.env) !== null && _a !== void 0 ? _a : {}),
+                        ]).entries());
+                    } }) : cli.environment;
                 const importObject = {
                     "ruby:js/js-runtime": jsRuntime,
-                    "wasi:cli/environment": cli.environment,
+                    "wasi:cli/environment": environment,
                     "wasi:cli/exit": cli.exit,
                     "wasi:cli/stderr": cli.stderr,
                     "wasi:cli/stdin": cli.stdin,

package/dist/index.umd.js

@@ -768,9 +768,16 @@
                 initComponent = async (jsRuntime) => {
                     const { instantiate, getCoreModule, wasip2 } = options;
                     const { cli, clocks, filesystem, io, random, sockets, http } = wasip2;
+                    const environment = options.env ? Object.assign(Object.assign({}, cli.environment), { getEnvironment: () => {
+                            var _a;
+                            return Array.from(new Map([
+                                ...cli.environment.getEnvironment(),
+                                ...Object.entries((_a = options.env) !== null && _a !== void 0 ? _a : {}),
+                            ]).entries());
+                        } }) : cli.environment;
                     const importObject = {
                         "ruby:js/js-runtime": jsRuntime,
-                        "wasi:cli/environment": cli.environment,
+                        "wasi:cli/environment": environment,
                         "wasi:cli/exit": cli.exit,
                         "wasi:cli/stderr": cli.stderr,
                         "wasi:cli/stdin": cli.stdin,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ruby/wasm-wasi",
-  "version": "2.9.4-2026-07-20-a",
+  "version": "2.9.4-2026-07-23-a",
   "description": "WebAssembly port of CRuby with WASI",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",