{"path":"README.md","size":2557,"locked":false,"binary":false,"truncated":false,"content":"# Forecast-Aware Financial Charting SDK\n\n> **White-label HTML5 Canvas financial charts with native quantile uncertainty visualization.**\n\n[![Tests](https://img.shields.io/badge/tests-10%20passed-brightgreen.svg)](tests/test_chart_math.mjs)\n[![License](https://img.shields.io/badge/license-Commercial%20Source-blue.svg)](LICENSE.md)\n[![Zero Runtime Deps](https://img.shields.io/badge/dependencies-0%20runtime-green.svg)](DEPENDENCIES.md)\n\n---\n\n## 1. WHAT IS THIS?\nThe **Forecast-Aware Financial Charting SDK** is a zero-dependency HTML5 Canvas charting library engineered specifically for quantitative finance, trading desks, algorithmic model portals, and AI prediction services.\n\n## 2. WHO IS IT FOR?\n- Quantitative developers building proprietary trading dashboards.\n- FinTech founders requiring 100% white-label financial charts without third-party vendor watermarks.\n- AI signal providers needing to visualize model forecast uncertainty distributions directly alongside historical candlesticks.\n\n## 3. WHAT PROBLEM DOES IT SOLVE?\nMainstream charting libraries either mandate conspicuous third-party logo branding (such as TradingView Lightweight Charts) or lack built-in probabilistic uncertainty visualization (such as Chart.js or Highcharts). Building dual-space coordinate rendering with P10–P90 quantile fans from scratch on HTML5 Canvas requires weeks of bespoke math and Retina DPI scaling.\n\n## 4. WHY PAY FOR IT INSTEAD OF BUILDING IT?\n- **Native Dual-Space Layout:** Seamlessly divides the viewport into 74% historical candlesticks and 26% future forecast corridor ($t_0$ boundary line).\n- **Mathematical Quantile Fans:** Renders P10..P90 outer uncertainty bounds and P25..P75 core confidence bands without clipping or hourglass distortion.\n- **100% White-Label:** Zero forced vendor branding or external stylesheet imports.\n- **Zero Runtime Dependencies:** Pure ES2022 and native HTML5 Canvas 2D.\n\n## 5. WHAT IS VERIFIED?\n- **10 / 10 Automated Math & Bounds Tests Passed:** Candlestick geometry, non-monotonic quantile sorting, missing quantile fallbacks, single candle rendering, negative prices, NaN filtering, and 10,000-candle downsampling.\n- **Microsecond Benchmarks:** 10,000 candle downsampling completes in < 5 ms on Apple Silicon.\n- **Retina Auto-Scaling:** Automatically binds `window.devicePixelRatio` for razor-sharp rendering on 4K and Retina displays.\n\n## 6. HOW DO I RUN IT?\n```bash\n# 1. Run the test suite\nnode --test tests/test_chart_math.mjs\n\n# 2. View the interactive browser verification demo\nopen examples/index.html\n```\n"}