kingchenc
d87005577e
Finish the per-language `examples/<lang>/` restructure by relocating the WASM browser demo from bindings/wasm/examples/ to examples/wasm/. * `examples/wasm/index.html` is the moved file; its WASM module import becomes `../../bindings/wasm/pkg/wickra_wasm.js` so the demo still loads the wasm-pack output without copying it. * bindings/wasm/README.md, Quickstart-WASM.md, examples/README.md and the root README "Languages" + project-layout block all point at the new path. The serve command in the docs now says "serve the repository root and open examples/wasm/index.html". `bindings/wasm/examples/` is empty after the move; the now-empty directory is removed.
50 lines
1.3 KiB
Markdown
50 lines
1.3 KiB
Markdown
# wickra-wasm
|
|
|
|
WebAssembly bindings for the Wickra streaming-first technical indicators library.
|
|
|
|
## Build
|
|
|
|
You need [`wasm-pack`](https://rustwasm.github.io/wasm-pack/) and the
|
|
`wasm32-unknown-unknown` Rust target:
|
|
|
|
```bash
|
|
rustup target add wasm32-unknown-unknown
|
|
cargo install wasm-pack
|
|
```
|
|
|
|
Then from the repository root:
|
|
|
|
```bash
|
|
wasm-pack build bindings/wasm --target web --release --features panic-hook
|
|
```
|
|
|
|
The compiled package lands in `bindings/wasm/pkg/`. Targets:
|
|
|
|
- `--target web` for native ES modules in browsers
|
|
- `--target bundler` for webpack/Vite/Rollup
|
|
- `--target nodejs` for Node.js
|
|
|
|
## Example
|
|
|
|
```js
|
|
import init, { SMA, RSI, MACD, version } from "./pkg/wickra_wasm.js";
|
|
|
|
await init();
|
|
console.log("wickra:", version());
|
|
|
|
// Streaming
|
|
const rsi = new RSI(14);
|
|
for (const price of livePrices) {
|
|
const v = rsi.update(price);
|
|
if (v !== undefined && v > 70) console.log("overbought");
|
|
}
|
|
|
|
// Batch (returns a Float64Array; NaN for warmup positions)
|
|
const sma = new SMA(20).batch(new Float64Array(historicalPrices));
|
|
```
|
|
|
|
An interactive demo lives in [`examples/wasm/index.html`](../../examples/wasm/index.html)
|
|
(top-level alongside the other language examples). After building the package
|
|
with `wasm-pack build`, serve the repository root and open
|
|
`examples/wasm/index.html` in a browser.
|