Desktop-class tools,
built for the browser.

Today - manual boilerplate

// 1. Hand-type the Wasm interface
interface WasmExports {
  engine_init: (w: number, h: number) => void;
  set_params: (g: number, d: number, /* ... */) => void;
  tick:        (dt: number) => number;
  memory:     WebAssembly.Memory;
  // ...4 more
}

// 2. Manually instantiate Wasm
const buf = await fetch('/engine.wasm')
  .then(r => r.arrayBuffer());
const wasm = (await WebAssembly.instantiate(
  buf, { env: { memory: new WebAssembly.Memory({
    initial: 32
  }) } }
)).instance.exports;

// 3. Dummy canvas, no-op bridge
const bridge = new HostBridge(schema, {}, {});
const dummy = document.createElement('canvas');
await bridge.init(dummy, () => 0);

// 4. Manual render loop
const loop = () => {
  wasm.set_params(gravity, damping, ...);
  bridge.drainCommandsForWasm((cmd, pl) => {
    switch(cmd) {
      case CMD.SPAWN_BURST: {
        const x = pl.getFloat32(2,true);
        wasm.push_command(1,x,0,0,0);
      }
      // ...5 more cases
    }
  });
  const ptr = wasm.get_particle_buffer_ptr();
  const data = new Float32Array(
    wasm.memory.buffer, ptr, count * 6
  );
  requestAnimationFrame(loop);
};

New API - one await, one object

import { Alloyhead } from '@alloyhead/core';

const sim = await Alloyhead.create({
  canvas,
  schema: physicsSchema,
  engine: { wasm: '/engine.wasm' },
  renderer: 'particles',
});

sim.setParams({
  gravity, damping, restitution,
});

sim.onFrame(({ fps, outputCount }) => {
  setFps(fps);
  setCount(outputCount);
});

sim.start();


// Commands - no byte offsets, no DataView
sim.send('SPAWN_BURST', {
  count: 100, x: mouseX, y: mouseY
});
sim.send('TOGGLE_PAUSE');


// Full control when you need it
import { HostBridge } from
  '@alloyhead/core/advanced';
const bridge = sim.getRawBridge();