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

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

Usage

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

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

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


$3


`js
// 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;
`

$3


`js
// 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:
`json
{
"compilerOptions": {
"types": ["vite/client", "vite-plugin-zig-wasm/client"]
}
}
``

tsdown

See examples/tsdown-demo