wifi-densepose-wasm

WebAssembly bindings for running WiFi-DensePose directly in the browser.

Overview

wifi-densepose-wasm compiles the WiFi-DensePose stack to wasm32-unknown-unknown and exposes a JavaScript API via wasm-bindgen. The primary export is MatDashboard -- a fully client-side disaster response dashboard that manages scan zones, tracks survivors, generates triage alerts, and renders to an HTML Canvas element.

The crate also provides utility functions (init, getVersion, isMatEnabled, getTimestamp) and a logging bridge that routes Rust log output to the browser console.

Features

• MatDashboard -- Create disaster events, add rectangular and circular scan zones, subscribe to survivor-detected and alert-generated callbacks, and render zone/survivor overlays on Canvas.
• Real-time callbacks -- Register JavaScript closures for onSurvivorDetected and onAlertGenerated events, called from the Rust event loop.
• Canvas rendering -- Draw zone boundaries, survivor markers (colour-coded by triage status), and alert indicators directly to a CanvasRenderingContext2d.
• WebSocket integration -- Connect to a sensing server for live CSI data via web-sys WebSocket bindings.
• Panic hook -- console_error_panic_hook provides human-readable stack traces in the browser console on panic.
• Optimised WASM -- Release profile uses -O4 wasm-opt with mutable globals for minimal binary size.

Feature flags

Quick Start

Build

# Build with wasm-pack (recommended)
wasm-pack build --target web --features mat

# Or with cargo directly
cargo build --target wasm32-unknown-unknown --features mat

JavaScript Usage

import init, {
  MatDashboard,
  initLogging,
  getVersion,
  isMatEnabled,
} from './wifi_densepose_wasm.js';

async function main() {
  await init();
  initLogging('info');

  console.log('Version:', getVersion());
  console.log('MAT enabled:', isMatEnabled());

  const dashboard = new MatDashboard();

  // Create a disaster event
  const eventId = dashboard.createEvent(
    'earthquake', 37.7749, -122.4194, 'Bay Area Earthquake'
  );

  // Add scan zones
  dashboard.addRectangleZone('Building A', 50, 50, 200, 150);
  dashboard.addCircleZone('Search Area B', 400, 200, 80);

  // Subscribe to real-time events
  dashboard.onSurvivorDetected((survivor) => {
    console.log('Survivor:', survivor);
  });

  dashboard.onAlertGenerated((alert) => {
    console.log('Alert:', alert);
  });

  // Render to canvas
  const canvas = document.getElementById('map');
  const ctx = canvas.getContext('2d');

  function render() {
    ctx.clearRect(0, 0, canvas.width, canvas.height);
    dashboard.renderZones(ctx);
    dashboard.renderSurvivors(ctx);
    requestAnimationFrame(render);
  }
  render();
}

main();

Exported API

Related Crates

License

MIT OR Apache-2.0