@maxtrader/backtest-browser-runtime

Browser-oriented async runtime around core engine using a Web Worker.

Purpose

• Keeps heavy replay/analytics logic off the main thread.
• Exposes AsyncBacktestEngine for UI integration.
• Provides sync orchestration, screenshot, zip export, and live bridge helpers.

Key Exports

• createBrowserBacktestEngine
• bindReplayToVisualChart, bindReplayToVisualCharts
• createReplaySyncOrchestrator
• ScreenshotCaptureService
• exportScreenshotsToZipStream
• createLiveTradingBridge
• BrowserBacktestEngine#linkVisualEngine (two-way SL/TP sync with visual drawings)

Minimal Usage

import { createBrowserBacktestEngine } from "@maxtrader/backtest-browser-runtime";

const engine = createBrowserBacktestEngine({
  symbol: "EURUSD",
  timeframe: "M1",
  initialBalance: 10_000,
  seed: 0
});

await engine.loadDataset(dataset);
await engine.step(1);
console.log(await engine.getState());

Live Bridge Notes

Live bridge is guard-first and requires explicit enable flow:

import { createLiveTradingBridge } from "@maxtrader/backtest-browser-runtime";

const bridge = createLiveTradingBridge(engine, {
  riskGuards: { enableLiveMode: true }
});

See docs/build-trading-app.md and docs/security-and-risk.md.