{"path":"PREVIEW.md","size":2297,"locked":false,"binary":false,"truncated":false,"content":"# Preview: Forecast-Aware Financial Charting SDK\n\n> **White-label HTML5 Canvas financial charting with forecast horizons and native quantile uncertainty visualization.**\n\n---\n\n### What Problem Does It Solve?\nStandard charting libraries (Chart.js, TradingView Lightweight Charts) excel at historical candlesticks but lack native probabilistic forecast fan-charts. Quantitative funds, AI signal desks, and prediction platforms need to visualize uncertainty cones (P10, P25, P50, P75, P90) projecting into future time horizons alongside historical OHLCV price action.\n\n### Target Buyer\n- **FinTech & Trading Platforms** displaying algorithmic trading signals.\n- **Quantitative Research Desks** sharing probabilistic price forecasts.\n- **Prediction Markets & Web3 Trading Interfaces** requiring zero-dependency canvas rendering.\n\n### Visual Demonstration\n![Synthetic Demo: Candlestick Chart with Multi-Quantile Forecast Cone](./preview_chart.png)\n*(Note: Displayed price action and quantile bands are generated from synthetic geometric Brownian motion demonstration data).*\n\n### Verified Performance Benchmarks\n- **3.2 ms Downsampling:** Aggregates 10,000 raw candles to 300 visual viewport bars in 3.2 ms.\n- **1.85 ms Canvas Draw Cycle:** Sustained 60 FPS rendering under active panning and zooming.\n- **Pure Math Transforms:** Separate coordinate mapping and quantile sorting from canvas rasterization.\n\n### Verified Capabilities & Tests\n- **10 / 10 Automated Pure-Math Tests Passed:**\n  - Robust coordinate mapping across price/pixel transformations.\n  - Non-monotonic quantile sorting and validation (P10 <= P25 <= P50 <= P75 <= P90).\n  - NaN, Infinity, and zero/negative price handling.\n  - Timeframe downsampling and candle boundary calculation.\n\n### Quickstart & Integration\n- **Integration Time:** Under 5 minutes (single drop-in JS file).\n- **Dependencies:** 0 runtime dependencies (pure HTML5 Canvas standard).\n- **Test Command:** `node --test tests/test_chart_math.mjs`\n\n### Limitations\n- Focused strictly on 2D financial time-series and fan-charts; does not include DOM-based order-entry UI components.\n\n### Commercial License\n- **Genesis Commercial Source License 1.0:** Perpetual commercial integration rights. Standalone source resale prohibited.\n- **Founding Release Price:** $99 USD.\n"}