@wasm-gaming/jgenesis-wasm

jgenesis (Rust, wasm-bindgen web frontend) packaged as a wasm-gaming engine SDK.

This subproject follows the same engine-package approach used by rsdkv3 and rsdkv4:

• typed manifest
• typed options
• load(config) engine SDK surface
• Makefile-driven build (build-sdk, build-wasm, preview)

Contract surface

import { manifest, load } from '@wasm-gaming/jgenesis-wasm';

const engine = await load({
  canvas,
  assets: { rom: romBytes },
  options: { romFileName: 'sonic-1.bin' },
  onEvent: (e) => { /* ready | error */ },
});

engine.reset();
engine.setInput('jgenesis');
engine.destroy();

Build

make build        # WASM + SDK
make build-sdk    # TS only
make build-wasm   # builds jgenesis-web in Docker (local scripts)
make preview      # serves dist/ with COOP/COEP

dist/original and dist/index.html

make build-wasm clones jsgroth/jgenesis, builds frontend/jgenesis-web, and writes:

• runtime package files to dist/jgenesis/
• upstream web snapshot to dist/original/:
  • dist/original/index.html
  • dist/original/pkg/
  • dist/original/js/

Then build-demo compiles this package demo shell and writes it to:

• dist/index.html

build-demo will not overwrite an existing upstream dist/original/index.html.

If build-demo runs before build-wasm, and dist/index.html already exists, it may still be preserved at:

• dist/original/index.html

Notes

• WASM build orchestration is local to this repo via scripts/build-docker.sh and scripts/build-jgenesis.sh.
• ROM files are user-provided and never committed.