openalgo-charts 1.8.9 → 1.9.1

package/README.md

@@ -9,7 +9,7 @@ Professional interactive charts, 102 built-in indicators plus your own custom on
 [![npm version](https://img.shields.io/npm/v/openalgo-charts.svg?color=cb3837&label=npm)](https://www.npmjs.com/package/openalgo-charts)
 [![license](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](./LICENSE)
 [![bundle](https://img.shields.io/badge/brotli-61%20KB%20base%20%C2%B7%20122%20KB%20all%20tiers-brightgreen.svg)](#size-budget)
-[![tests](https://img.shields.io/badge/tests-2586%20passing-brightgreen.svg)](#develop)
+[![tests](https://img.shields.io/badge/tests-2590%20passing-brightgreen.svg)](#develop)
 [![dependencies](https://img.shields.io/badge/runtime%20deps-0-brightgreen.svg)](#principles)
 
 [**Documentation**](https://marketcalls.github.io/openalgo-charts/)  ·  [**Live examples**](https://marketcalls.github.io/openalgo-charts/examples)  ·  [**Getting started**](./docs/getting-started.md)  ·  [**Architecture**](./ARCHITECTURE.md)
@@ -62,7 +62,7 @@ in front of npm rather than being places you upload to. A chart is one HTML file
 ```html
 <div id="chart" style="width:100vw;height:100vh"></div>
 <script type="module">
-  import { createChart } from 'https://unpkg.com/openalgo-charts@1.8.9/dist/openalgo-charts.mjs';
+  import { createChart } from 'https://unpkg.com/openalgo-charts@1.9.1/dist/openalgo-charts.mjs';
   const chart = createChart(document.getElementById('chart'), { timezone: 'Asia/Kolkata' });
   chart.addSeries('candlestick').setData(bars);
 </script>
@@ -86,7 +86,7 @@ Import only what you use. Each tier is a separate bundle that registers into the
 | `openalgo-charts/profile` | Volume Profile, Market Profile (TPO), Footprint, order flow | 10.7 KB |
 | `openalgo-charts/trade` | Order / position / bracket tools + DOM ladder | 7.6 KB |
 
-Everything together is **122.15 KB Brotli**. Figures are the measured `size-limit` output. The trade tier is listed as its delta over the base, so loading base + trade costs 68.43 KB.
+Everything together is **122.16 KB Brotli**. Figures are the measured `size-limit` output. The trade tier is listed as its delta over the base, so loading base + trade costs 68.45 KB.
 
 ## What's built
 
@@ -227,13 +227,13 @@ Enforced in CI by [`size-limit`](./.size-limit.json). Nothing is excluded, becau
 
 | Bundle | Limit | Actual |
 |---|---|---|
-| Base engine | 62 KB | 60.83 KB |
-| Base + trade | 70 KB | 68.43 KB |
+| Base engine | 62 KB | 60.84 KB |
+| Base + trade | 70 KB | 68.45 KB |
 | Indicators tier | 30 KB | 27.27 KB |
 | Draw tier | 14 KB | 13.13 KB |
 | Transform tier | 5 KB | 2.66 KB |
 | Profile tier | 11 KB | 10.66 KB |
-| **Everything** | **124 KB** | **122.15 KB** |
+| **Everything** | **124 KB** | **122.16 KB** |
 
 ## Documentation
 
@@ -273,7 +273,7 @@ cd examples/yfinance && pip install -r requirements.txt && python server.py
 ```bash
 npm install        # install dev toolchain
 npm run typecheck  # strict TypeScript check
-npm test           # unit tests (vitest) - 2586 across 140 files
+npm test           # unit tests (vitest) - 2590 across 141 files
 npm run build      # Rollup -> dist/ (minified ESM per tier + types)
 npm run size       # size-limit (Brotli) against the budget
 npm run e2e        # Playwright Chromium smoke tests
@@ -290,7 +290,7 @@ npm run verify     # typecheck + test + build + size
 
 ## Status &amp; limitations
 
-Version **1.8.9**. All engine build phases are implemented with 2586 unit tests across 140 files.
+Version **1.9.1**. All engine build phases are implemented with 2590 unit tests across 141 files.
 
 Known gaps, stated plainly:
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /** Library version string. Matches package.json (published npm release). */
-declare const VERSION = "1.8.9";
+declare const VERSION = "1.9.1";
 /** Returns the current library version. */
 declare function version(): string;
 
@@ -2387,6 +2387,20 @@ interface IndicatorHost {
      * one to ask for the instrument's own step.
      */
     tickSize?(paneIndex: number): number | undefined;
+    /**
+     * Write a number the way the price axis of that pane writes it.
+     *
+     * The legend sits inches from the axis and names the same quantity, so the
+     * two disagreeing is the reading a user has to reconcile themselves. Deriving
+     * the format here from a tick got that wrong twice over: a study pane carries
+     * no tick at all, so a percentage read `0.618` beside an axis saying `0.62`,
+     * and a price pane's tick alone misses the precision floor and the host's own
+     * formatter, so a volume study read seven digits where its axis said `1.20M`.
+     *
+     * Asking the scale removes the second opinion. Optional so a host driving
+     * this module alone still works, falling back to the magnitude ladder.
+     */
+    formatPrice?(paneIndex: number, value: number): string | undefined;
     /** Pin a pane's price scale to a fixed range, or release it with `null`. */
     setPaneRange(paneIndex: number, range: {
         min: number;