> ## Documentation Index
> Fetch the complete documentation index at: https://songbird.studiocollective.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# songbird-wasm

# songbird-wasm

WebAssembly bridge that exposes the Rust audio engine to the browser via `wasm-bindgen` and `cpal`'s AudioWorklet backend.

## What it owns

* The `WasmEngine` entry point exposed to JavaScript.
* Real-time audio output on a dedicated AudioWorklet thread.
* Command/event ring-buffer marshalling between the JS main thread and the audio thread.

## Public API

* `WasmEngine` — main struct, constructed from JS; methods for playback control, position queries, and command/event ring-buffer I/O.

## How it fits

Standalone WASM target. No workspace crates depend on it; it is the browser-side counterpart to `songbird-app` (Tauri) and `songbird-headless` (WebSocket).

Depends on `songbird-engine`, `songbird-plugins`, `songbird-clips`, `cpal` (audioworklet feature), `wasm-bindgen`.

## Tests

`cargo test -p songbird-wasm` (note: WASM-target tests require a wasm runner; most logic is exercised through `songbird-engine`).