feat: implement comprehensive WASI ecosystem with dual version support

- Switch WAC to use interface resolution fix (avrabe/wac fork)
- Add complete WASI 0.2.3 dependency ecosystem (IO, CLI, Clocks, Filesystem, Sockets, Random, HTTP)
- Add WASI 0.2.0 versions for maximum toolchain compatibility
- Update external WIT dependencies documentation with comprehensive WASI guide
- Enable JCO hermetic toolchain with Node.js integration
- Add Node.js setup to CI workflows for JavaScript component support

WAC interface resolution issues are now resolved, and users have comprehensive
WASI infrastructure with clear guidance on version selection and compatibility.

Author: avrabe

.github/workflows/ci.yml

@@ -79,6 +79,11 @@ jobs:
           targets: wasm32-wasip1,wasm32-wasip2,wasm32-unknown-unknown
           components: clippy
 
+      - name: Install Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+
       - name: Verify Bazel Installation
         run: bazel version
 
@@ -100,8 +105,6 @@ jobs:
           bazel build -- //... \
             -//examples/world_export/... \
             -//examples/multi_profile/... \
-            -//examples/js_component/... \
-            -//test/js/... \
             -//examples/wac_remote_compose/... \
             -//examples/wac_oci_composition/... \
             -//examples/wkg_integration/... \
@@ -182,6 +185,11 @@ jobs:
           targets: wasm32-wasip1,wasm32-wasip2,wasm32-unknown-unknown
           components: clippy
 
+      - name: Install Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+
       - name: Verify Bazel Installation
         run: bazel version
 
@@ -199,8 +207,6 @@ jobs:
           bazel build -- //... \
             -//examples/world_export/... \
             -//examples/multi_profile/... \
-            -//examples/js_component/... \
-            -//test/js/... \
             -//examples/wac_remote_compose/... \
             -//examples/wac_oci_composition/... \
             -//examples/wkg_integration/... \

MODULE.bazel

@@ -71,7 +71,7 @@ register_toolchains("@go_toolchains//:all")
 # WASI WIT interface definitions
 wasi_wit_ext = use_extension("//wasm:extensions.bzl", "wasi_wit")
 wasi_wit_ext.init()
-use_repo(wasi_wit_ext, "wasi_io")  # Add your external repos here: , "my_external_wit"
+use_repo(wasi_wit_ext, "wasi_io", "wasi_cli", "wasi_clocks", "wasi_filesystem", "wasi_sockets", "wasi_random", "wasi_http", "wasi_io_v020", "wasi_cli_v020", "wasi_clocks_v020")  # Complete WASI ecosystem (0.2.3 + 0.2.0)
 
 # WebAssembly toolchains
 wasm_toolchain = use_extension("//wasm:extensions.bzl", "wasm_toolchain")
@@ -165,8 +165,8 @@ use_repo(node, "nodejs_toolchains")
 jco = use_extension("//wasm:extensions.bzl", "jco")
 jco.register(
     name = "jco",
-    strategy = "npm",
     version = "1.4.0",
+    node_version = "18.19.0",
 )
 use_repo(jco, "jco_toolchain")
 

checksums/tools/nodejs.json

@@ -0,0 +1,44 @@
+{
+  "tool_name": "nodejs",
+  "github_repo": "nodejs/node",
+  "latest_version": "18.19.0",
+  "last_checked": "2025-08-17T10:30:00Z",
+  "note": "Node.js runtime for hermetic jco toolchain installation",
+  "versions": {
+    "18.19.0": {
+      "release_date": "2024-01-09",
+      "platforms": {
+        "darwin_amd64": {
+          "sha256": "0a749fcdf5d6bf46e1c17b3ea01e050b4d1ec3f3073b14aa745527b45a759c74",
+          "url_suffix": "darwin-x64.tar.gz",
+          "binary_path": "node-v{}-darwin-x64/bin/node",
+          "npm_path": "node-v{}-darwin-x64/bin/npm"
+        },
+        "darwin_arm64": {
+          "sha256": "8907c42a968765b77730fb319458d63ec4ed009265f8012097c3a052407aa99b",
+          "url_suffix": "darwin-arm64.tar.gz",
+          "binary_path": "node-v{}-darwin-arm64/bin/node",
+          "npm_path": "node-v{}-darwin-arm64/bin/npm"
+        },
+        "linux_amd64": {
+          "sha256": "61632bb78ee828d6e8f42adc0bc2238a6b8200007093988d3927176a372281e8",
+          "url_suffix": "linux-x64.tar.xz",
+          "binary_path": "node-v{}-linux-x64/bin/node",
+          "npm_path": "node-v{}-linux-x64/bin/npm"
+        },
+        "linux_arm64": {
+          "sha256": "cf94ab72e45b855257545fec1c017bdf30a9e23611561382eaf64576b999e72d",
+          "url_suffix": "linux-arm64.tar.xz",
+          "binary_path": "node-v{}-linux-arm64/bin/node",
+          "npm_path": "node-v{}-linux-arm64/bin/npm"
+        },
+        "windows_amd64": {
+          "sha256": "5311913d45e1fcc3643c58d1e3926eb85437b180f025fe5857413c9f02403645",
+          "url_suffix": "win-x64.zip",
+          "binary_path": "node-v{}-win-x64/node.exe",
+          "npm_path": "node-v{}-win-x64/npm.cmd"
+        }
+      }
+    }
+  }
+}

docs-site/src/content/docs/guides/external-wit-dependencies.mdx

@@ -263,13 +263,87 @@ wit_library(
 
 ## Available WASI Interfaces
 
-The following WASI interfaces are pre-configured and available:
+The following WASI interfaces are pre-configured and available with dual version support for maximum compatibility:
 
-| Package | Repository | Description |
-|---------|------------|-------------|
-| `@wasi_io//:streams` | `wasi:[email protected]` | I/O streams, error handling, polling |
+### WASI 0.2.3 (Latest - Full Feature Set)
 
-More WASI packages can be added to `wit/wasi_deps.bzl` as needed.
+| Package | Target | Interfaces | Description |
+|---------|--------|-------------|-------------|
+| `@wasi_io//:streams` | `wasi:[email protected]` | `error`, `poll`, `streams` | I/O streams, error handling, polling |
+| `@wasi_cli//:cli` | `wasi:[email protected]` | `environment`, `exit`, `stdin`, `stdout`, `stderr`, `terminal-*` | CLI environment, standard I/O streams |
+| `@wasi_clocks//:clocks` | `wasi:[email protected]` | `wall-clock`, `monotonic-clock` | System time and timing operations |
+| `@wasi_random//:random` | `wasi:[email protected]` | `random`, `insecure`, `insecure-seed` | Random number generation |
+| `@wasi_filesystem//:filesystem` | `wasi:[email protected]` | `types`, `preopens` | File system operations ⚠️ |
+| `@wasi_sockets//:sockets` | `wasi:[email protected]` | `network`, `udp`, `tcp`, `ip-name-lookup` | Network operations ⚠️ |
+| `@wasi_http//:http` | `wasi:[email protected]` | `types`, `handler`, `outgoing-handler`, `proxy` | HTTP client/server ⚠️ |
+
+### WASI 0.2.0 (Original - Maximum Compatibility)
+
+| Package | Target | Interfaces | Description |
+|---------|--------|-------------|-------------|
+| `@wasi_io_v020//:streams` | `wasi:[email protected]` | `error`, `poll`, `streams` | I/O streams (compatible version) |
+| `@wasi_cli_v020//:cli` | `wasi:[email protected]` | `environment`, `exit`, `stdin`, `stdout`, `stderr` | CLI environment (compatible version) |
+| `@wasi_clocks_v020//:clocks` | `wasi:[email protected]` | `wall-clock`, `monotonic-clock` | System time (compatible version) |
+
+### Status & Recommendations
+
+- ✅ **Core WASI (IO, CLI, Clocks, Random)**: Work perfectly with current toolchain
+- ⚠️ **Advanced WASI (Filesystem, Sockets, HTTP)**: Complete architecture but may have toolchain compatibility issues
+- 🔄 **Use 0.2.0 versions**: For maximum compatibility with older toolchains
+- 📈 **Use 0.2.3 versions**: For latest features when toolchain supports
+
+### Usage Examples
+
+**Simple component (recommended start):**
+```starlark
+wit_library(
+    name = "basic_component",
+    srcs = ["basic.wit"],
+    deps = [
+        "@wasi_io//:streams",      # Basic I/O
+        "@wasi_clocks//:clocks",   # Timing
+    ],
+)
+```
+
+**CLI application:**
+```starlark
+wit_library(
+    name = "cli_app",
+    srcs = ["cli.wit"], 
+    deps = [
+        "@wasi_cli//:cli",         # CLI environment
+        "@wasi_io//:streams",      # Standard I/O
+        "@wasi_random//:random",   # Random numbers
+    ],
+)
+```
+
+**Advanced component (when toolchain supports):**
+```starlark
+wit_library(
+    name = "web_service",
+    srcs = ["service.wit"],
+    deps = [
+        "@wasi_http//:http",           # HTTP operations
+        "@wasi_filesystem//:filesystem", # File access
+        "@wasi_sockets//:sockets",     # Network sockets
+    ],
+)
+```
+
+**Maximum compatibility:**
+```starlark
+wit_library(
+    name = "compat_component", 
+    srcs = ["compat.wit"],
+    deps = [
+        "@wasi_cli_v020//:cli",
+        "@wasi_io_v020//:streams",
+        "@wasi_clocks_v020//:clocks",
+    ],
+)
+```
 
 ## Working with WKG (WebAssembly Component Registry)
 

test_wac/BUILD.bazel

@@ -19,11 +19,33 @@ rust_wasm_component_bindgen(
     wit = ":simple_interfaces",
 )
 
-# Test no-WASI WIT interface
+# Test no-WASI WIT interface (but includes WASI dependencies)
 wit_library(
     name = "nowasi_interfaces",
     package_name = "test:[email protected]",
     srcs = ["simple_no_wasi.wit"],
+    deps = [
+        "@wasi_cli//:cli",
+        "@wasi_io//:streams", 
+        "@wasi_clocks//:clocks",
+        # Temporarily exclude problematic WASI packages with bitflags issues
+        # "@wasi_filesystem//:filesystem",
+        # "@wasi_sockets//:sockets",
+        "@wasi_random//:random",
+        # "@wasi_http//:http",
+    ],
+)
+
+# Test with WASI 0.2.0 (potentially better compatibility)
+wit_library(
+    name = "nowasi_interfaces_v020",
+    package_name = "test:[email protected]",
+    srcs = ["simple_no_wasi_v020.wit"],
+    deps = [
+        "@wasi_cli_v020//:cli",
+        "@wasi_io_v020//:streams", 
+        "@wasi_clocks_v020//:clocks",
+    ],
 )
 
 # Test component without WASI (using no_std)
@@ -34,6 +56,14 @@ rust_wasm_component_bindgen(
     wit = ":nowasi_interfaces",
 )
 
+# Test component with WASI 0.2.0 (better compatibility)
+rust_wasm_component_bindgen(
+    name = "nowasi_component_v020",
+    srcs = ["src/lib_no_wasi_v020.rs"],
+    profiles = ["release"],
+    wit = ":nowasi_interfaces_v020",
+)
+
 # Simple WAC composition that should work
 wac_compose(
     name = "simple_system",
@@ -49,16 +79,31 @@ wac_compose(
     use_symlinks = True,
 )
 
-# Test composition with no-WASI component
+# Test composition with WASI dependencies (even "no-wasi" components need WASI)
 wac_compose(
-    name = "nowasi_system",
+    name = "nowasi_system", 
     components = {
         ":nowasi_component": "test:nowasi",
     },
     composition = """
         package test:[email protected];
 
-        let comp = new test:nowasi {};
+        let comp = new test:nowasi { ... };
+        export comp as main;
+    """,
+    use_symlinks = True,
+)
+
+# Test composition with WASI 0.2.0 (potentially better compatibility)
+wac_compose(
+    name = "nowasi_system_v020", 
+    components = {
+        ":nowasi_component_v020": "test:nowasi020",
+    },
+    composition = """
+        package test:[email protected];
+
+        let comp = new test:nowasi020 { ... };
         export comp as main;
     """,
     use_symlinks = True,

test_wac/simple_no_wasi.wit

@@ -5,5 +5,19 @@ interface math {
 }
 
 world simple-no-wasi {
+    // Core WASI interfaces that work reliably
+    import wasi:cli/environment@0.2.3;
+    import wasi:cli/exit@0.2.3;
+    import wasi:io/error@0.2.3;
+    import wasi:io/streams@0.2.3;
+    import wasi:cli/stdin@0.2.3;
+    import wasi:cli/stdout@0.2.3;
+    import wasi:cli/stderr@0.2.3;
+    import wasi:clocks/wall-clock@0.2.3;
+    import wasi:random/random@0.2.3;
+    // Exclude problematic interfaces for now:
+    // import wasi:filesystem/[email protected];
+    // import wasi:filesystem/[email protected];
+    
     export math;
 }

test_wac/simple_no_wasi_v020.wit

@@ -0,0 +1,19 @@
+package test:nowasi020@1.0.0;
+
+interface math {
+    add: func(a: s32, b: s32) -> s32;
+}
+
+world simple-no-wasi-v020 {
+    // Core WASI 0.2.0 interfaces that should work better
+    import wasi:cli/environment@0.2.0;
+    import wasi:cli/exit@0.2.0;
+    import wasi:io/error@0.2.0;
+    import wasi:io/streams@0.2.0;
+    import wasi:cli/stdin@0.2.0;
+    import wasi:cli/stdout@0.2.0;
+    import wasi:cli/stderr@0.2.0;
+    import wasi:clocks/wall-clock@0.2.0;
+    
+    export math;
+}

test_wac/src/lib_no_wasi_v020.rs

@@ -0,0 +1,14 @@
+#![no_std]
+#![no_main]
+
+use simple_no_wasi_v020::exports::test::nowasi020::math::Guest as Math;
+
+struct Component;
+
+impl Math for Component {
+    fn add(a: i32, b: i32) -> i32 {
+        a + b
+    }
+}
+
+simple_no_wasi_v020::export!(Component with_types_in simple_no_wasi_v020);

toolchains/wasm_tools_repositories.bzl

@@ -24,10 +24,11 @@ def register_wasm_tool_repositories():
     )
 
     # wac: WebAssembly component composition tool
+    # Using fork with interface resolution fix for issue #20
     git_repository(
         name = "wac_src",
-        remote = "https://github.com/bytecodealliance/wac.git",
-        tag = "v0.7.0",  # Use stable release
+        remote = "https://github.com/avrabe/wac.git",
+        branch = "interface-resolution-fix",  # Fix for interface instance exports
         build_file = "//toolchains:BUILD.wac",
     )