vite-plugin-zig-wasm

Fork of utherpally/vite-wasm-zig.

Also works with rolldown/tsdown. See below.

Why use this instead of one of the other solutions?

• More compiler options
• Compatible with latest Zig version
• Uses SIMD128 instruction set by default
• Also exposes a WebAssembly.Module instead of WebAssembly.Instance, so it's easier to create multiple instances and have more control over when an instance is created

Install

npm i -D vite-plugin-zig-wasm
npm i -D @ziglang/cli # add a zig compiler for CI environments

Usage

// vite.config.{js, ts}
import zig from 'vite-plugin-zig-wasm';

export default defineConfig(({ mode }) => {
    return {
        plugins: {
            zig({
                zig: {
                  strip: mode === 'production',
                },
            })
        }
    }
}

// main.zig
export fn add(a: i32, b: i32) i32 {
    return a + b;
}

Compiled WebAsembly.Module

// index.{js,ts}
import compileModule from "./main.zig?compile";

const module = await compileModule();

const importObject = {
  /* ... */
};

const instance = await WebAssembly.instantiate(module, importObject);

console.log(instance.exports.add(1, 10));
export default instance.exports;

Compiled WebAssembly.Instance

// index.{js,ts}
import createInstance from "./main.zig?init";

const importObject = {
  /* ... */
};

const instance = await createInstance(importObject);

console.log(instance.exports.add(1, 10));
export default instance.exports;

With Typescript

Add to tsconfig.json:

{
  "compilerOptions": {
    "types": ["vite/client", "vite-plugin-zig-wasm/client"]
  }
}

tsdown

See examples/tsdown-demo