openalgo-charts 2.3.2 → 2.4.0

package/README.md

@@ -4,12 +4,12 @@
 
 **A from-scratch, dependency-free HTML5-canvas charting engine for OpenAlgo.**
 
-Professional interactive charts, 102 built-in indicators plus your own custom ones, 85 drawing tools, order flow, market replay, linked chart grids, on-chart trading, vector SVG export and an optional WebGL2 backend. Eight lazy-loaded tiers, zero runtime dependencies, 77.23 KB Brotli for the base engine, and a one-call widget tier that adds the toolbar, drawing rail, dialogs and shortcuts.
+Professional interactive charts, 102 built-in indicators plus your own custom ones, 85 drawing tools, order flow, market replay, linked chart grids, on-chart trading, vector SVG export and an optional WebGL2 backend. Eight lazy-loaded tiers, zero runtime dependencies, 78.07 KB Brotli for the base engine, and a one-call widget tier that adds the toolbar, drawing rail, dialogs and shortcuts.
 
 [![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-77.23%20KB%20base%20%C2%B7%20215.76%20KB%20all%20tiers-brightgreen.svg)](#size-budget)
-[![tests](https://img.shields.io/badge/tests-5182%20passing-brightgreen.svg)](#develop)
+[![bundle](https://img.shields.io/badge/brotli-78.07%20KB%20base%20%C2%B7%20217.54%20KB%20all%20tiers-brightgreen.svg)](#size-budget)
+[![tests](https://img.shields.io/badge/tests-5251%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)  ·  [**Migrating to 2.0**](./docs/migrating-to-2.md)  ·  [**Architecture**](./ARCHITECTURE.md)
@@ -20,6 +20,16 @@ Professional interactive charts, 102 built-in indicators plus your own custom on
 
 ---
 
+## Walkthrough video
+
+A tour of OpenAlgo Charts running inside OpenAlgo: chart types, the indicator library,
+drawing tools, order placement from the chart, market replay, combined option premium
+charts, and the historical data explorer.
+
+<p align="center">
+  <a href="https://www.youtube.com/watch?v=7Q_Twd6mNQ8"><img src="https://img.youtube.com/vi/7Q_Twd6mNQ8/maxresdefault.jpg" alt="OpenAlgo Charts walkthrough video" width="920" /></a>
+</p>
+
 ## Live OpenAlgo trading terminal
 
 Right-click the chart to place market / limit / stop orders, drag the order and TP/SL bracket lines to modify, and watch live P&amp;L on the position line - all on real OpenAlgo history + WebSocket tick data, with an analyzer (sandbox) mode so nothing goes live until you arm it.
@@ -43,13 +53,15 @@ Every chart in the [live gallery](https://marketcalls.github.io/openalgo-charts/
 
 ## Install
 
-Current version: **2.3.2**.
+Current version: **2.4.0**.
 
-This release makes history repair follow the stream: one refresh a moment after
-each bar closes, an immediate one when the stream skips a bucket, each fetching
-only the tail; and a forming bar the builder opened mid-bucket takes its true
-open from history instead of its first tick. See the
-[2.3.2 changelog](./CHANGELOG.md#232).
+This release closes the gaps five hundred ported studies hit: a fold from the
+chart's own bars to a higher timeframe (`securitySeries`), plots displaced by a
+number of bars, a candle's wick coloured apart from its body, markers pinned to
+the pane edge, tooltips on drawn zones, per-bar alert messages, a bars provider
+for other instruments, and a calculation that throws is reported on its study
+instead of thrown into the render loop. Every addition is optional. See the
+[2.4.0 changelog](./CHANGELOG.md#240).
 
 ```bash
 npm install openalgo-charts
@@ -78,7 +90,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@2.3.2/dist/openalgo-charts.mjs';
+  import { createChart } from 'https://unpkg.com/openalgo-charts@2.4.0/dist/openalgo-charts.mjs';
   const chart = createChart(document.getElementById('chart'), { timezone: 'Asia/Kolkata' });
   chart.addSeries('candlestick').setData(bars);
 </script>
@@ -118,16 +130,16 @@ Import only what you use. Each tier is a separate bundle that registers into the
 
 | Import | Contents | Brotli |
 |---|---|---|
-| `openalgo-charts` | Engine, 13 chart types, panes &amp; scales, primitives, registries, chart state, chart linking, bar cache, interval registry, trading overlay, SVG export, render backend port, OpenAlgo feeds | 77.23 KB |
-| `openalgo-charts/indicators` | 102 built-in indicators, the `registerIndicator` contract for your own, and the Tier-2 (external-data) contract | 28.19 KB |
+| `openalgo-charts` | Engine, 13 chart types, panes &amp; scales, primitives, registries, chart state, chart linking, bar cache, interval registry, trading overlay, SVG export, render backend port, OpenAlgo feeds | 78.07 KB |
+| `openalgo-charts/indicators` | 102 built-in indicators, the `registerIndicator` contract for your own, and the Tier-2 (external-data) contract | 29.05 KB |
 | `openalgo-charts/draw` | 85 drawing tools + a headless drawing controller, clipboard, settings schema, level palette, freehand geometry and SVG icons | 34.53 KB |
 | `openalgo-charts/transform` | Heikin Ashi, Renko, Range bars, Line Break, Point &amp; Figure, Kagi, and symbol arithmetic (`AAPL/MSFT`) | 4.44 KB |
 | `openalgo-charts/profile` | Volume Profile, Market Profile (TPO) with compact pixel letters, Footprint, order flow | 14.96 KB |
 | `openalgo-charts/trade` | Order / position / bracket tools + DOM ladder | 7.61 KB |
-| `openalgo-charts/webgl` | WebGL2 series backend: batched, analytically anti-aliased GPU rendering of the standard chart types behind `renderer: 'auto'`, with a session-long fallback to the 2D path | 6.38 KB |
-| `openalgo-charts/widget` | The chart with its chrome in one call: `createWidget` adds a top bar, the drawing rail, a status line, the settings and indicator dialogs, drawing properties, a right-click menu, a keymap with a `?` panel and optional layout persistence. The only tier that ships DOM | 42.41 KB |
+| `openalgo-charts/webgl` | WebGL2 series backend: batched, analytically anti-aliased GPU rendering of the standard chart types behind `renderer: 'auto'`, with a session-long fallback to the 2D path | 6.39 KB |
+| `openalgo-charts/widget` | The chart with its chrome in one call: `createWidget` adds a top bar, the drawing rail, a status line, the settings and indicator dialogs, drawing properties, a right-click menu, a keymap with a `?` panel and optional layout persistence. The only tier that ships DOM | 42.49 KB |
 
-Everything together is **215.76 KB Brotli**; a widget terminal (base + draw + indicators + widget, what one `createWidget` call loads) is 182.37 KB. Figures are measured from the 2.3.2 release build. The trade tier is listed as its delta over the base, so loading base + trade costs 84.84 KB.
+Everything together is **217.54 KB Brotli**; a widget terminal (base + draw + indicators + widget, what one `createWidget` call loads) is 184.14 KB. Figures are measured from the 2.4.0 release build. The trade tier is listed as its delta over the base, so loading base + trade costs 85.68 KB.
 
 ## What's built
 
@@ -146,6 +158,8 @@ macd.setSettings({ 'macd:width': 2, 'macd:lineStyle': 'dashed' });
 
 102 built-ins across Trend, Momentum, Volatility and Volume, from the everyday (SMA, EMA, WMA, VWAP, Bollinger Bands, RSI, MACD, Stochastic, ADX/DMI, ATR) through Supertrend, HalfTrend, Ichimoku, Keltner, Donchian, Chandelier Exit and CPR with floor pivots to Connors RSI, Fisher Transform, Woodies CCI, Klinger, Vortex, WaveTrend Pro, Chop Zone and Williams Fractals, with a least-squares family (Least Squares Moving Average, Linear Regression Slope, Standard Error, Standard Error Bands) and a Smoothed Moving Average alongside them, joined in 1.8.3 by the T3 average, the Hull Suite (Hma / Ehma / Thma with a displaced band) and Consolidation and Breakout, which tracks inside-bar ranges and marks the bar that leaves one. Twenty-eight of them draw shaded bands, six emit named buy/sell markers, two recolour the price candles, and Seasonality draws a monthly return heatmap as a table over the chart. The full catalogue with ids and defaults is in the docs.
 
+Since 2.4.0 a study can fold the chart's own bars up to a higher timeframe with `securitySeries` (as the bucket stood at each bar, or the last completed one, or with lookahead when reproducing a source that repaints), paint a plot displaced by a number of bars, colour a candle's wick and border apart from its body, pin a marker to the pane edge, put a tooltip on a drawn zone, compute an alert message from the bar that fired, and ask the host for another instrument's bars through `chart.setBarsProvider`. A calculation that throws once it is on the chart is reported on that study's data status rather than thrown into the render loop.
+
 Every built-in is measured against its standard definition bar by bar, at several parameter sets, and each one's warmup (the first bar it can honestly produce a value for) is part of that check rather than an afterthought. A study draws nothing until it has the history it needs.
 
 The chart owns the whole lifecycle: series, pane placement, reference levels, fixed ranges (RSI 0..100), recompute on data change, teardown. Every plot gets colour, opacity, thickness, and line style for free, generated from the descriptor. Write your own with `registerIndicator`, or use the **Tier-2 contract** for indicators whose data isn't derived from OHLCV (open interest, CVD, any external feed).
@@ -419,16 +433,16 @@ Enforced in CI by [`size-limit`](./.size-limit.json). Nothing is excluded, becau
 
 | Bundle | Limit | Actual |
 |---|---|---|
-| Base engine | 78 KB | 77.23 KB |
-| Base + trade | 86 KB | 84.84 KB |
-| Indicators tier | 30 KB | 28.19 KB |
+| Base engine | 79 KB | 78.07 KB |
+| Base + trade | 86 KB | 85.68 KB |
+| Indicators tier | 30 KB | 29.05 KB |
 | Draw tier | 36 KB | 34.53 KB |
 | Transform tier | 6 KB | 4.44 KB |
 | Profile tier | 15 KB | 14.96 KB |
-| WebGL2 tier | 7 KB | 6.38 KB |
-| Widget tier | 43 KB | 42.41 KB |
-| Widget terminal (base + draw + indicators + widget) | 183 KB | 182.37 KB |
-| **Everything** | 218 KB | 215.76 KB |
+| WebGL2 tier | 7 KB | 6.39 KB |
+| Widget tier | 43 KB | 42.49 KB |
+| Widget terminal (base + draw + indicators + widget) | 185 KB | 184.14 KB |
+| **Everything** | 218 KB | 217.54 KB |
 
 ## Documentation
 
@@ -490,7 +504,7 @@ npm run verify     # lint + typecheck + test + build + demo tests + dts + size +
 
 ## Status &amp; limitations
 
-Version **2.3.2**. All engine build phases are implemented. Upgrading a 1.9.x host: [Migrating to 2.0](./docs/migrating-to-2.md).
+Version **2.4.0**. All engine build phases are implemented. Upgrading a 1.9.x host: [Migrating to 2.0](./docs/migrating-to-2.md).
 
 Known gaps, stated plainly:
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /** Library version string. Matches package.json (including locally prepared releases). */
-declare const VERSION = "2.3.2";
+declare const VERSION = "2.4.0";
 /** Returns the current library version. */
 declare function version(): string;
 
@@ -441,6 +441,15 @@ interface Bar {
      * two. Neither is expressible with one colour for the whole series.
      */
     color?: string;
+    /**
+     * Wick colour for this bar alone, over `color`. A study that paints candles
+     * with a translucent body and a solid wick cannot say so with one colour,
+     * and without this a per-bar override always set the two together. Read by
+     * the candle renderers only; absent means the wick follows `color`.
+     */
+    wickColor?: string;
+    /** Border colour for this bar alone, on the same terms as `wickColor`. */
+    borderColor?: string;
 }
 /** A single value point (for line/area/baseline series). */
 interface LinePoint {
@@ -600,6 +609,14 @@ interface SeriesStyle {
      * so whoever builds those readings owns their formatting.
      */
     precision?: number;
+    /**
+     * Draw every point this many bars to the right of the bar it belongs to
+     * (negative: left). The data is untouched and keeps its own times; only the
+     * painted position moves, so the last `barOffset` points of a series land in
+     * the right margin, past the newest bar. Autoscale follows what is drawn in
+     * view. Default 0.
+     */
+    barOffset?: number;
     color?: string;
     lineWidth?: number;
     /** Line dash style for line/step/area/HLC series. Default 'solid'. */
@@ -824,8 +841,13 @@ declare function bestHit(hits: readonly (PrimitiveHit | null)[]): PrimitiveHit |
  * body sits clear of it: `labelUp`'s tail points up so its body hangs below the
  * anchor, `labelDown` is the mirror. Both require `text`.
  */
-type MarkerShape = 'arrowUp' | 'arrowDown' | 'circle' | 'square' | 'triangleUp' | 'triangleDown' | 'diamond' | 'flag' | 'text' | 'labelUp' | 'labelDown';
-type MarkerPosition = 'aboveBar' | 'belowBar' | 'inBar' | 'atPrice';
+type MarkerShape = 'arrowUp' | 'arrowDown' | 'circle' | 'square' | 'triangleUp' | 'triangleDown' | 'diamond' | 'flag' | 'text' | 'labelUp' | 'labelDown' | 'cross' | 'xcross';
+/**
+ * `paneTop` and `paneBottom` pin the glyph to the edge of the plot rather than
+ * to a price, so a squeeze dot or a session flag sits in a fixed row whatever
+ * the scale does. They need no bar under them and no `price`.
+ */
+type MarkerPosition = 'aboveBar' | 'belowBar' | 'inBar' | 'atPrice' | 'paneTop' | 'paneBottom';
 type MarkerSize = 'tiny' | 'small' | 'medium' | 'big';
 interface SeriesMarker {
     time: number;
@@ -1554,7 +1576,13 @@ interface ChartTableOptions {
     /** Column width in media px. A per-column array sizes each one separately. */
     cellWidth: number | readonly number[];
     cellHeight: number;
-    fontSize: number;
+    /**
+     * Type size in media px, or `'auto'` to fit each cell: as large as its row
+     * allows, shrunk until its text also fits its column. A stretched grid with
+     * one long label would otherwise either clip that cell or be sized down as a
+     * whole to suit it.
+     */
+    fontSize: number | 'auto';
     /** Grid line colour. Omit to draw no grid. */
     borderColor?: string;
     borderWidth: number;
@@ -1678,6 +1706,36 @@ type IndicatorInput = {
     default: IndicatorSource;
     group?: string;
     tooltip?: string;
+}
+/**
+ * A timeframe code (`'5m'`, `'1d'`), for a study that folds the chart's bars
+ * up to a coarser interval. A settings UI renders it as a select over the
+ * registered intervals, so the value is always one the engine can bucket by;
+ * a free text box would accept `'5min'` and leave the study computing on a
+ * code it cannot resolve. An empty default means "the chart's own interval".
+ */
+ | {
+    key: string;
+    type: 'interval';
+    label: string;
+    default: string;
+    group?: string;
+    tooltip?: string;
+}
+/**
+ * A wall-clock instant in the chart's zone, written `YYYY-MM-DD HH:MM` (the
+ * time part optional), for an anchor a user picks by date: the start of an
+ * anchored VWAP, an event to measure from. It is carried as that string, not
+ * as UTC seconds, so a layout saved in one zone restores to the same wall
+ * clock in another, and `zonedStringToUtcSeconds` turns it into a bar time.
+ */
+ | {
+    key: string;
+    type: 'time';
+    label: string;
+    default: string;
+    group?: string;
+    tooltip?: string;
 };
 /** Dash pattern for a level, a drawing, or a plot. */
 type IndicatorLineStyle = 'solid' | 'dashed' | 'dotted';
@@ -1734,7 +1792,26 @@ interface IndicatorFillSpec {
     colorDownKey?: string;
     /** 0..1. Defaults to 0.12. */
     opacity?: number;
+    /**
+     * Draw the band on the price pane even though the indicator owns a pane of
+     * its own. The pair with `IndicatorPlot.overlay`: a study can already send
+     * one plot to the candles, and a band between two such plots belongs beside
+     * them rather than in the study pane the fill would otherwise land in.
+     * Ignored for an `'onchart'` descriptor, which is on the price pane already.
+     */
+    overlay?: boolean;
 }
+/**
+ * What `colorParts` answers: a candle plot's colour split three ways, which is
+ * how a study paints a wick in full colour over a translucent body. `body` is
+ * the bar's colour (and the only part a line, histogram or column reads); a
+ * part left undefined falls back to `colorBy`, then to the plot's own colour.
+ */
+type PlotBarColor = {
+    body?: string;
+    wick?: string;
+    border?: string;
+};
 interface IndicatorPlot {
     /** Key into the `calc` result. */
     key: string;
@@ -1772,6 +1849,16 @@ interface IndicatorPlot {
      * Ignored for an `'onchart'` descriptor, which is already on the price pane.
      */
     overlay?: boolean;
+    /**
+     * Draw the column shifted this many bars to the right (negative: left). The
+     * column itself stays one value per bar and `calc` returns exactly what it
+     * always did; only where each value is painted moves. Positive is what a
+     * displaced cloud or a projected channel wants: the last `offset` values land
+     * in the right margin, past the newest candle, where no bar exists to hold
+     * them. It shifts the drawn series only. A fill between two plots with the
+     * same offset follows; the legend reads the value drawn under the cursor.
+     */
+    offset?: number;
     /**
      * Settings key holding this plot's color, so a settings change restyles the
      * series without a full rebuild.
@@ -1812,6 +1899,19 @@ interface IndicatorPlot {
         values: IndicatorValues;
         settings: IndicatorSettings;
     }): string | undefined;
+    /**
+     * Per-bar colour split three ways, for a candle plot whose wick or border
+     * should not follow its body: a solid wick over a translucent body, a
+     * border in the trend colour. Takes precedence over `colorBy` for the parts
+     * it names; a part it leaves undefined falls back to `colorBy`, then to the
+     * plot's own colour. A value plot (line, histogram, column) reads `body` only.
+     */
+    colorParts?(ctx: {
+        value: number;
+        index: number;
+        values: IndicatorValues;
+        settings: IndicatorSettings;
+    }): PlotBarColor | undefined;
 }
 /** A horizontal reference level (RSI 70/30, Stochastic 80/20, a zero line). */
 interface IndicatorLevel {
@@ -1861,6 +1961,17 @@ type IndicatorDrawing = {
     /** Caption drawn on a plate at the centre of the box; `\n` splits lines. */
     text?: string;
     textColor?: string;
+    /**
+     * Detail shown on a plate while the pointer rests on the box, and gone
+     * when it leaves; `\n` splits lines. A zone that carries its size, its
+     * age and what formed it cannot print all of that on the box without
+     * hiding the candles under it, so the caption names it and this explains
+     * it. The box becomes hit-testable, and `id` (or the tooltip text) is
+     * what `subscribeClick` reports for it.
+     */
+    tooltip?: string;
+    /** Hit id, for `subscribeClick`. Defaults to the tooltip text. */
+    id?: string;
 } | {
     kind: 'label';
     at: DrawAnchor;
@@ -1871,6 +1982,10 @@ type IndicatorDrawing = {
     textColor?: string;
     /** Which edge of the plate sits on the anchor. Defaults to 'center'. */
     align?: 'left' | 'center' | 'right';
+    /** Hover detail, as on a box. */
+    tooltip?: string;
+    /** Hit id, for `subscribeClick`. Defaults to the tooltip text. */
+    id?: string;
 } | {
     kind: 'polyline';
     points: readonly DrawAnchor[];
@@ -1952,10 +2067,48 @@ interface IndicatorAlertSpec {
     id: string;
     /** Short human label, e.g. `'MACD crossed up'`. */
     title: string;
-    /** Longer text for a notification; defaults to `title`. */
-    message?: string;
+    /**
+     * Longer text for a notification; defaults to `title`. A function is handed
+     * the same context `when` judged, so the message can carry the bar's own
+     * numbers: the price it crossed at, the histogram reading, a JSON body for a
+     * webhook. It runs only for a bar `when` accepted.
+     */
+    message?: string | ((ctx: IndicatorAlertContext) => string);
     when(ctx: IndicatorAlertContext): boolean;
 }
+/**
+ * Thrown by a `calc` (or any hook) to say its inputs cannot produce a study,
+ * the way a script language's runtime error does: a period at or below zero, a
+ * fast length above the slow one, a benchmark the provider cannot serve.
+ *
+ * Any error out of a recompute is caught by the runtime and published on the
+ * instance's data status as `{ state: 'error' }`, so the chart keeps drawing
+ * every other indicator and a host can show the reason beside this one. This
+ * class exists so a descriptor can throw a **named** condition and a host can
+ * tell a bad input, which the user can fix, from a bug, which they cannot.
+ */
+declare class IndicatorInputError extends Error {
+    constructor(message: string);
+}
+/**
+ * Bars of another instrument or interval, supplied by the host on request.
+ *
+ * The engine is handed one symbol's bars and owns no transport, so a study
+ * that compares against a benchmark, or a Tier-2 provider that needs a second
+ * series, asks the host through this and the host answers from wherever it
+ * keeps history. `from` and `to` are UTC seconds; `signal` is aborted when the
+ * instance is removed or its settings change, so a provider can drop the
+ * request rather than answer into the void.
+ */
+interface IndicatorBarsRequest {
+    symbol: string;
+    exchange?: string;
+    interval: string;
+    from: number;
+    to: number;
+    signal?: AbortSignal;
+}
+type IndicatorBarsProvider = (request: IndicatorBarsRequest) => Promise<readonly Bar[]>;
 /** Payload of the `'indicator:alert'` event on the chart's own bus. */
 interface IndicatorAlertPayload {
     /** Descriptor id, e.g. `'macd'`. */
@@ -2017,6 +2170,13 @@ interface IndicatorAttachContext {
     timezone?(): string;
     /** Chart wall clock in UTC seconds, the same clock the countdown row uses. */
     now?(): number;
+    /**
+     * Ask the host for another instrument's (or interval's) bars. Always present
+     * under `chart.addIndicator`; it rejects when the host has registered no
+     * provider (`chart.setBarsProvider`), so a study can treat the rejection as
+     * "unsupported here" and say so through `setDataStatus`.
+     */
+    requestBars?(request: IndicatorBarsRequest): Promise<readonly Bar[]>;
     /** The pane this instance drew into. Moves when panes are reordered. */
     paneIndex?(): number;
     /** Attach a primitive to this indicator's pane, and detach it again. */
@@ -2656,6 +2816,12 @@ interface IndicatorHost {
     setBarColors?(colors: readonly (string | null)[] | null, owner: string): void;
     /** Emit on the chart's event bus (indicator alerts, and `attach`'s own events). */
     emit?(event: string, payload: unknown): void;
+    /**
+     * Bars of another instrument or interval, from wherever the host keeps its
+     * history. Optional: without it the attach context's `requestBars` rejects,
+     * which a study reads as "not available on this chart".
+     */
+    requestBars?(request: IndicatorBarsRequest): Promise<readonly Bar[]>;
     /**
      * Tick size of the named pane's price scale, or undefined when none is set.
      * Optional so a host predating it still satisfies this interface.
@@ -3775,6 +3941,15 @@ interface ChartOptions {
      * Tune a single pane later via `chart.panes()[n].priceScale.setOptions(...)`.
      */
     priceScale?: Partial<PriceScaleOptions>;
+    /**
+     * Where an indicator gets another instrument's bars. The engine is handed
+     * one symbol's history and owns no transport, so a study that compares
+     * against a benchmark asks through this and the host answers from wherever
+     * it keeps candles. Change it later with `setBarsProvider`. Without one an
+     * indicator's `requestBars` rejects, and the study reports itself
+     * unsupported rather than drawing something invented.
+     */
+    barsProvider?: IndicatorBarsProvider;
     /**
      * Custom time-axis and crosshair label formatter (receives UTC seconds). When
      * omitted, labels use IST (Indian market default). e.g. for UTC:
@@ -4144,6 +4319,7 @@ declare class Chart {
     private _primary;
     private readonly _indicators;
     private _dataContext;
+    private _barsProvider;
     /** Guards indicator recompute against re-entry via its own `series.setData`. */
     private _recomputing;
     private _indicatorsDirty;
@@ -4362,6 +4538,14 @@ declare class Chart {
     getDataContext(): Readonly<ChartDataContext> | undefined;
     /** Clear the previous source bars before changing context, then load the new source. */
     setDataContext(context: ChartDataContext | undefined): void;
+    /**
+     * Register, replace or remove (`null`) the provider indicators reach through
+     * `requestBars`. Read at request time, so an indicator added before the
+     * provider was set is served once one exists.
+     */
+    setBarsProvider(provider: IndicatorBarsProvider | null): void;
+    /** Whether a bars provider is registered, so a host can grey what needs one. */
+    hasBarsProvider(): boolean;
     /** Replace chart-owned branding. Manually attached primitives are independent. */
     setBranding(options: boolean | LogoWatermarkOptions): void;
     /** Host branding options, excluded from saved chart state. */
@@ -6539,6 +6723,13 @@ declare class IndicatorDrawings implements IPrimitive {
     private _items;
     private _host;
     private _visible;
+    /**
+     * The labels and boxes that carry an id or a tooltip, where the last frame
+     * put them. Only those are hit-testable: a bare trendline stays under the
+     * pointer as pure ink, so hovering a busy study does not light up a cursor
+     * on every ray it drew.
+     */
+    private _hits;
     attached(host: PrimitiveHost): void;
     detached(): void;
     /** Over the series, under the crosshair: these are annotations on the data. */
@@ -6552,6 +6743,16 @@ declare class IndicatorDrawings implements IPrimitive {
     setItems(items: readonly IndicatorDrawing[]): void;
     setVisible(on: boolean): void;
     draw(ctx: CanvasRenderingContext2D, rc: PrimitiveRenderContext): void;
+    /** Keep a label's or box's rect when it has something to say on hover or click. */
+    private _recordHit;
+    /**
+     * The hovered shape's tooltip, as a plate clear of the shape: above it when
+     * there is room, below it otherwise. Drawn last so it sits over everything
+     * else in the layer, and only while the chart reports the pointer on it, so
+     * it costs nothing on a frame with nothing hovered.
+     */
+    private _drawTooltip;
+    hitTest(x: number, y: number): PrimitiveHit | null;
 }
 
 /**
@@ -8756,4 +8957,4 @@ declare function lerp(a: number, b: number, t: number): number;
  */
 declare function roundToTick(value: number, step: number): number;
 
-export { ALT_PRESET, type AddSeriesOptions, type AggTick, type AxisChromeOptions, type AxisStyle, BAR_CACHE_VERSION, BUILTIN_COMMANDS, type Bar, BarCache, type BarCacheOptions, type BarCacheStats, type BarCacheStore, type BarSubscriptionOptions, type BarUpdate, type BarsPage, type BarsPageRequest, type BarsRequest, type BrandingChangedEvent, type Bucketing, BuySellButtons, type BuySellButtonsOptions, CHART_STATE_VERSION, type CachedBars, type CachedBarsRequest, type CalendarBucketing, type CalendarUnit, CandleBuilder, type CandleBuilderOptions, type CandleGeometry, type CandleStyle, type CandleTier, type CandleUpdate, Canvas2dBackend, type CanvasLineStyle, type CanvasOptions, Chart, type ChartClickEvent, type ChartDataContext, type ChartDragEndEvent, type ChartDragEvent, type ChartEvent, type ChartEventOptions, type ChartNavigationOptions, type ChartObjectCapabilities, type ChartObjectDefinition, type ChartObjectDrawing, type ChartObjectDrawingSource, type ChartObjectKind, type ChartObjectProvider, type ChartObjectSnapshot, ChartObjects, type ChartObjectsOptions, type ChartOptions, type ChartSettingsColorPairInput, type ChartSettingsInput, type ChartSettingsState, type ChartSettingsTab, type ChartSettingsTabId, type ChartSettingsValue, type ChartSettingsValues, type ChartState, ChartTable, type ChartTableOptions, type ChartTheme, type ChartWatermarkOptions, type ComparisonAlignment, type ComparisonChartHost, ComparisonController, type ComparisonControllerOptions, type ComparisonHandle, type ComparisonMode, type ComparisonOptions, type ComparisonPane, type ContextMenuEvent, type ContextMenuTarget, type ContextMenuTargetKind, type CrosshairMoveEvent, type CrosshairOptions, type CrosshairStyle, type CustomShortcut, DEFAULT_CANDLE_BUILDER_OPTIONS, DEFAULT_CANDLE_STYLE, DEFAULT_CHART_TABLE_OPTIONS, DEFAULT_HISTOGRAM_STYLE, DEFAULT_KEYMAP, DEFAULT_PRICE_SCALE_OPTIONS, DEFAULT_THEME, DEFAULT_TIMEZONE, DEFAULT_TIME_NAVIGATOR_OPTIONS, DEFAULT_TIME_SCALE_OPTIONS, DEFAULT_TRADING_COLORS, DEFAULT_ZOOM_GLIDE_OPTIONS, type DataFeed, DataLayer, DataLoadingController, type DataLoadingOptions, type DataLoadingSnapshot, type DataLoadingStatus, type DataUpdateReason, type DecodedOrder, type DepthLevel, type DoubleClickAction, type DoubleClickEvent, type DrawAnchor, type DrawItem, EventMarkers, type ExportSvgOptions, FakeDataFeed, type FeedScheduler, type FillGradient, type FillPoint, type GridAxisStyle, type GridOptions, type GridStyle, type HistogramStyle, type HistoryLoadingStatus, HistoryRequestPool, type HistoryRequestPoolOptions, INDICATOR_LINE_STYLES, INDICATOR_PLOT_STYLES, INDICATOR_SOURCES, type IPrimitive, type IRenderBackend, IST_OFFSET_SECONDS, type IndexedBar, type IndicatorAlertContext, type IndicatorAlertPayload, type IndicatorAlertSpec, type IndicatorApi, type IndicatorAttachContext, IndicatorBackground, type IndicatorCalcContext, type IndicatorDataChange, type IndicatorDataStatus, type IndicatorDescriptor, type IndicatorDrawing, IndicatorDrawings, IndicatorFill, type IndicatorFillOptions, type IndicatorFillSpec, type IndicatorHost, type IndicatorInput, type IndicatorLevel, type IndicatorLevelContext, type IndicatorLineStyle, type IndicatorPlot, type IndicatorSettings, type IndicatorSource, type IndicatorState, type IndicatorStore, type IndicatorValues, type IntervalBucketing, type IntervalDescriptor, type IntervalParts, InvalidationLevel, type IstParts, type KeymapEntry, LINK_CROSSHAIR_ALPHA, type LateTickPolicy, type LegendField, type LegendStatusData, type LegendStatusLineOptions, type LegendStatusSource, type LegendTitleMode, type LegendValue, type LinePoint, type LinkChart, LinkCrosshair, type LinkDataLayer, LinkGroup, type LinkMemberOptions, type LinkMissingPolicy, type LinkOptions, type LiveBarMeta, type LogicalRange, LogoWatermark, type LogoWatermarkOptions, type LtpEvent, type MarkerPosition, type MarkerShape, type MarkerSize, type MarketDepth, type MarketPhase, type MarketPhaseFn, type MaybePromise, type ModeCheck, type OpenAlgoConfig, OpenAlgoDataFeed, type OpenAlgoLiveConfig, OpenAlgoLiveDataFeed, type OpenAlgoTradeConfig, OpenAlgoTradeFeed, type OpenAlgoWsConfig, OpenAlgoWsFeed, type OrderBookSnapshot, type OrderDecodeCode, type OrderDecodeIssue, type OrderDecodeResult, type OrderSide$1 as OrderSide, type OrderType$1 as OrderType, type OrderUpdateEvent, type OriginalTime, PRICE_LEVEL_KINDS, PRICE_SCALE_MODES, Pane, type PaneInvalidation, PaneLegend, type PaneLegendAction, type PaneLegendOptions, type PaneState, type PickHost, type PickKind, type PlaceOrder, type PlotMarginOptions, type PointerInfo, type PointerKind, type PointerModifiers, type PointerSample, type PositionSide, type PriceAxisState, type PriceFormat, type PriceLevelInput, type PriceLevelKind, type PriceLevelQuote, type PriceLevelStyle, type PriceLevelValues, PriceLevels, type PriceLevelsOptions, PriceLine, type PriceLineOptions, type PriceRange, PriceScale, type PriceScaleId, type PriceScaleMode, type PriceScaleOptions, type PriceScaleState, type PrimitiveAnchor, type PrimitiveHit, type PrimitiveHost, type PrimitivePlacement, type PrimitiveRenderContext, type QuarantinedRow, type RawOrder, type RenderBackendFactory, type RenderBackendKind, type RenderDevice, type RendererChoice, type RendererEntry, type RendererFallbackEvent, type RendererFallbackReason, type ReplayChartHost, ReplayController, type ReplayOptions, type ReplayScheduler, ReplayShade, type ReplayShadeOptions, type ReplayState, type ReplayViewport, type ResolvedLinkOptions, type RestoreReport, SCALE_FONT_MAX, SCALE_FONT_MIN, type ScaleCanvasOptions, type SeriesApi, type SeriesDataItem, type SeriesId, type SeriesMarker, SeriesMarkers, type SeriesRenderContext, type SeriesState, type SeriesStyle, type SeriesType, type SessionSpec, type ShortcutListItem, ShortcutManager, type ShortcutManagerOptions, type ShortcutPreset, type ShortcutScope, type ShortcutTriggerEvent, type Size, type SocketFactory, type SocketLike, type SupertrendPoint, SvgContext, type SvgContextOptions, SvgLinearGradient, type TableCell, type TablePosition, TextWatermark, type TextWatermarkOptions, type Tick, TickBarAggregator, type TickBarOptions, type TickCountBucketing, type TickMarkType, type TickTimeframe, TimeNavigator, type TimeNavigatorAction, type TimeNavigatorOptions, TimeScale, type TimeScaleOp, type TimeScaleOptions, type TradeFeed, type TradeMarkerVariant, TradeMarkersPrimitive, type TradingColors, TradingController, type TradingHost, type TradingLineStyle, type TradingLineVariant, type TradingOrder, type TradingOrderSide, type TradingOrderType, type TradingPosition, type TradingSettings, type TradingSyncPayload, type TradingTrade, type UTCSeconds, UnknownIntervalError, type UnsubscribeFn, VERSION, type VolumeBucketing, type VolumeMode, type WatermarkPosition, type Whitespace, type WsClientWarning, type WsControlMessage, type WsMode, type WsState, type ZOrder, type ZonedParts, type ZonedPeriod, type ZoomAnchor, ZoomGlide, type ZoomGlideOptions, addComparison, alignToPrimary, applyChartSettings, atr, autoscaleRange, backendDegradation, backoffDelayMs, barCacheKey, barCloseSec, beginPick, bestHit, bitmapSize, bucketStartOf, calendarPeriodFlags, candleGeometry, candleTier, chartSettingsSchema, clamp, classifyAuthAck, compactVolume, comparisonController, computePriceLevels, conflateBars, conflateItems, conflationGroupSize, createChart, createLinkGroup, createRenderBackend, darkTheme, dashPattern, decodeOrder, drawLabel, drawShape, effectiveMarkerPx, ema, emaSeries, epochMsToUtcSeconds, eventToCombo, followerIndex, followerRange, formatCombo, formatIstCrosshairLabel, formatIstDate, formatIstTime, formatIstTimeSeconds, formatSubscribe, formatUnsubscribe, formatZonedCrosshairLabel, formatZonedDate, formatZonedTime, formatZonedTimeSeconds, fromGradient, generateBars, getChartType, getIndicator, hasIndicator, inSessionAt, indicatorDefaults, indicatorStyleInputs, intervalParts, intervalToSeconds, isDailyInterval, isIntradayInterval, isKnownInterval, isNewIstDay, isNewZonedDay, isNewZonedMonth, isNewZonedPeriod, isNewZonedQuarter, isNewZonedWeek, isNewZonedYear, isRebasing, isReservedCombo, isSecondsInterval, isTickInterval, isTimeBucketed, isValidCombo, isValidTimezone, isWhitespace, istStringToUtcSeconds, lastPriceLevelFromSeriesStyle, lerp, lightTheme, mapHistoryResponse, mapOrder, mapOrderStatus, mapPosition, markerSizePx, mergeBars, nextBucketStart, niceTicks, normalizeCombo, optimalBarWidth, parseCombo, parseMessage, parseSessionSpec, parseTopic, plotStyleKeys, precisionForStep, readChartSettings, readSequence, registerChartType, registerIndicator, registerInterval, registerRenderBackend, registeredChartTypes, registeredIndicators, registeredIntervals, registeredRenderBackends, resolveCrosshairStyle, resolveGridStyle, resolveInterval, resolvePlotMargins, resolveRenderBackend, resolveScaleStyle, roundToTick, rowTimeToUtcSeconds, rsi, rsiSeries, seriesStyleForLastPriceLevel, sessionFlags, sessionStartFlags, sessionStartIndices, sharedHistoryRequests, snapToDevicePixel, sourceValue, sourceValues, startOfZonedDay, startOfZonedMonth, startOfZonedWeek, supertrend, supertrendSeries, tableOrigin, toBar, trueRange, tryResolveInterval, unregisterInterval, unregisterRenderBackend, utcSecondsToIstDateString, utcSecondsToIstParts, utcSecondsToZonedDateString, utcSecondsToZonedParts, version, verticalGradient, watermarkRect, withAlpha, withBarCache, zoneOffsetSeconds, zonedDayIndex, zonedStringToUtcSeconds, zonedWallClockToUtcSeconds, zonedWeekIndex };
+export { ALT_PRESET, type AddSeriesOptions, type AggTick, type AxisChromeOptions, type AxisStyle, BAR_CACHE_VERSION, BUILTIN_COMMANDS, type Bar, BarCache, type BarCacheOptions, type BarCacheStats, type BarCacheStore, type BarSubscriptionOptions, type BarUpdate, type BarsPage, type BarsPageRequest, type BarsRequest, type BrandingChangedEvent, type Bucketing, BuySellButtons, type BuySellButtonsOptions, CHART_STATE_VERSION, type CachedBars, type CachedBarsRequest, type CalendarBucketing, type CalendarUnit, CandleBuilder, type CandleBuilderOptions, type CandleGeometry, type CandleStyle, type CandleTier, type CandleUpdate, Canvas2dBackend, type CanvasLineStyle, type CanvasOptions, Chart, type ChartClickEvent, type ChartDataContext, type ChartDragEndEvent, type ChartDragEvent, type ChartEvent, type ChartEventOptions, type ChartNavigationOptions, type ChartObjectCapabilities, type ChartObjectDefinition, type ChartObjectDrawing, type ChartObjectDrawingSource, type ChartObjectKind, type ChartObjectProvider, type ChartObjectSnapshot, ChartObjects, type ChartObjectsOptions, type ChartOptions, type ChartSettingsColorPairInput, type ChartSettingsInput, type ChartSettingsState, type ChartSettingsTab, type ChartSettingsTabId, type ChartSettingsValue, type ChartSettingsValues, type ChartState, ChartTable, type ChartTableOptions, type ChartTheme, type ChartWatermarkOptions, type ComparisonAlignment, type ComparisonChartHost, ComparisonController, type ComparisonControllerOptions, type ComparisonHandle, type ComparisonMode, type ComparisonOptions, type ComparisonPane, type ContextMenuEvent, type ContextMenuTarget, type ContextMenuTargetKind, type CrosshairMoveEvent, type CrosshairOptions, type CrosshairStyle, type CustomShortcut, DEFAULT_CANDLE_BUILDER_OPTIONS, DEFAULT_CANDLE_STYLE, DEFAULT_CHART_TABLE_OPTIONS, DEFAULT_HISTOGRAM_STYLE, DEFAULT_KEYMAP, DEFAULT_PRICE_SCALE_OPTIONS, DEFAULT_THEME, DEFAULT_TIMEZONE, DEFAULT_TIME_NAVIGATOR_OPTIONS, DEFAULT_TIME_SCALE_OPTIONS, DEFAULT_TRADING_COLORS, DEFAULT_ZOOM_GLIDE_OPTIONS, type DataFeed, DataLayer, DataLoadingController, type DataLoadingOptions, type DataLoadingSnapshot, type DataLoadingStatus, type DataUpdateReason, type DecodedOrder, type DepthLevel, type DoubleClickAction, type DoubleClickEvent, type DrawAnchor, type DrawItem, EventMarkers, type ExportSvgOptions, FakeDataFeed, type FeedScheduler, type FillGradient, type FillPoint, type GridAxisStyle, type GridOptions, type GridStyle, type HistogramStyle, type HistoryLoadingStatus, HistoryRequestPool, type HistoryRequestPoolOptions, INDICATOR_LINE_STYLES, INDICATOR_PLOT_STYLES, INDICATOR_SOURCES, type IPrimitive, type IRenderBackend, IST_OFFSET_SECONDS, type IndexedBar, type IndicatorAlertContext, type IndicatorAlertPayload, type IndicatorAlertSpec, type IndicatorApi, type IndicatorAttachContext, IndicatorBackground, type IndicatorBarsProvider, type IndicatorBarsRequest, type IndicatorCalcContext, type IndicatorDataChange, type IndicatorDataStatus, type IndicatorDescriptor, type IndicatorDrawing, IndicatorDrawings, IndicatorFill, type IndicatorFillOptions, type IndicatorFillSpec, type IndicatorHost, type IndicatorInput, IndicatorInputError, type IndicatorLevel, type IndicatorLevelContext, type IndicatorLineStyle, type IndicatorPlot, type IndicatorSettings, type IndicatorSource, type IndicatorState, type IndicatorStore, type IndicatorValues, type IntervalBucketing, type IntervalDescriptor, type IntervalParts, InvalidationLevel, type IstParts, type KeymapEntry, LINK_CROSSHAIR_ALPHA, type LateTickPolicy, type LegendField, type LegendStatusData, type LegendStatusLineOptions, type LegendStatusSource, type LegendTitleMode, type LegendValue, type LinePoint, type LinkChart, LinkCrosshair, type LinkDataLayer, LinkGroup, type LinkMemberOptions, type LinkMissingPolicy, type LinkOptions, type LiveBarMeta, type LogicalRange, LogoWatermark, type LogoWatermarkOptions, type LtpEvent, type MarkerPosition, type MarkerShape, type MarkerSize, type MarketDepth, type MarketPhase, type MarketPhaseFn, type MaybePromise, type ModeCheck, type OpenAlgoConfig, OpenAlgoDataFeed, type OpenAlgoLiveConfig, OpenAlgoLiveDataFeed, type OpenAlgoTradeConfig, OpenAlgoTradeFeed, type OpenAlgoWsConfig, OpenAlgoWsFeed, type OrderBookSnapshot, type OrderDecodeCode, type OrderDecodeIssue, type OrderDecodeResult, type OrderSide$1 as OrderSide, type OrderType$1 as OrderType, type OrderUpdateEvent, type OriginalTime, PRICE_LEVEL_KINDS, PRICE_SCALE_MODES, Pane, type PaneInvalidation, PaneLegend, type PaneLegendAction, type PaneLegendOptions, type PaneState, type PickHost, type PickKind, type PlaceOrder, type PlotBarColor, type PlotMarginOptions, type PointerInfo, type PointerKind, type PointerModifiers, type PointerSample, type PositionSide, type PriceAxisState, type PriceFormat, type PriceLevelInput, type PriceLevelKind, type PriceLevelQuote, type PriceLevelStyle, type PriceLevelValues, PriceLevels, type PriceLevelsOptions, PriceLine, type PriceLineOptions, type PriceRange, PriceScale, type PriceScaleId, type PriceScaleMode, type PriceScaleOptions, type PriceScaleState, type PrimitiveAnchor, type PrimitiveHit, type PrimitiveHost, type PrimitivePlacement, type PrimitiveRenderContext, type QuarantinedRow, type RawOrder, type RenderBackendFactory, type RenderBackendKind, type RenderDevice, type RendererChoice, type RendererEntry, type RendererFallbackEvent, type RendererFallbackReason, type ReplayChartHost, ReplayController, type ReplayOptions, type ReplayScheduler, ReplayShade, type ReplayShadeOptions, type ReplayState, type ReplayViewport, type ResolvedLinkOptions, type RestoreReport, SCALE_FONT_MAX, SCALE_FONT_MIN, type ScaleCanvasOptions, type SeriesApi, type SeriesDataItem, type SeriesId, type SeriesMarker, SeriesMarkers, type SeriesRenderContext, type SeriesState, type SeriesStyle, type SeriesType, type SessionSpec, type ShortcutListItem, ShortcutManager, type ShortcutManagerOptions, type ShortcutPreset, type ShortcutScope, type ShortcutTriggerEvent, type Size, type SocketFactory, type SocketLike, type SupertrendPoint, SvgContext, type SvgContextOptions, SvgLinearGradient, type TableCell, type TablePosition, TextWatermark, type TextWatermarkOptions, type Tick, TickBarAggregator, type TickBarOptions, type TickCountBucketing, type TickMarkType, type TickTimeframe, TimeNavigator, type TimeNavigatorAction, type TimeNavigatorOptions, TimeScale, type TimeScaleOp, type TimeScaleOptions, type TradeFeed, type TradeMarkerVariant, TradeMarkersPrimitive, type TradingColors, TradingController, type TradingHost, type TradingLineStyle, type TradingLineVariant, type TradingOrder, type TradingOrderSide, type TradingOrderType, type TradingPosition, type TradingSettings, type TradingSyncPayload, type TradingTrade, type UTCSeconds, UnknownIntervalError, type UnsubscribeFn, VERSION, type VolumeBucketing, type VolumeMode, type WatermarkPosition, type Whitespace, type WsClientWarning, type WsControlMessage, type WsMode, type WsState, type ZOrder, type ZonedParts, type ZonedPeriod, type ZoomAnchor, ZoomGlide, type ZoomGlideOptions, addComparison, alignToPrimary, applyChartSettings, atr, autoscaleRange, backendDegradation, backoffDelayMs, barCacheKey, barCloseSec, beginPick, bestHit, bitmapSize, bucketStartOf, calendarPeriodFlags, candleGeometry, candleTier, chartSettingsSchema, clamp, classifyAuthAck, compactVolume, comparisonController, computePriceLevels, conflateBars, conflateItems, conflationGroupSize, createChart, createLinkGroup, createRenderBackend, darkTheme, dashPattern, decodeOrder, drawLabel, drawShape, effectiveMarkerPx, ema, emaSeries, epochMsToUtcSeconds, eventToCombo, followerIndex, followerRange, formatCombo, formatIstCrosshairLabel, formatIstDate, formatIstTime, formatIstTimeSeconds, formatSubscribe, formatUnsubscribe, formatZonedCrosshairLabel, formatZonedDate, formatZonedTime, formatZonedTimeSeconds, fromGradient, generateBars, getChartType, getIndicator, hasIndicator, inSessionAt, indicatorDefaults, indicatorStyleInputs, intervalParts, intervalToSeconds, isDailyInterval, isIntradayInterval, isKnownInterval, isNewIstDay, isNewZonedDay, isNewZonedMonth, isNewZonedPeriod, isNewZonedQuarter, isNewZonedWeek, isNewZonedYear, isRebasing, isReservedCombo, isSecondsInterval, isTickInterval, isTimeBucketed, isValidCombo, isValidTimezone, isWhitespace, istStringToUtcSeconds, lastPriceLevelFromSeriesStyle, lerp, lightTheme, mapHistoryResponse, mapOrder, mapOrderStatus, mapPosition, markerSizePx, mergeBars, nextBucketStart, niceTicks, normalizeCombo, optimalBarWidth, parseCombo, parseMessage, parseSessionSpec, parseTopic, plotStyleKeys, precisionForStep, readChartSettings, readSequence, registerChartType, registerIndicator, registerInterval, registerRenderBackend, registeredChartTypes, registeredIndicators, registeredIntervals, registeredRenderBackends, resolveCrosshairStyle, resolveGridStyle, resolveInterval, resolvePlotMargins, resolveRenderBackend, resolveScaleStyle, roundToTick, rowTimeToUtcSeconds, rsi, rsiSeries, seriesStyleForLastPriceLevel, sessionFlags, sessionStartFlags, sessionStartIndices, sharedHistoryRequests, snapToDevicePixel, sourceValue, sourceValues, startOfZonedDay, startOfZonedMonth, startOfZonedWeek, supertrend, supertrendSeries, tableOrigin, toBar, trueRange, tryResolveInterval, unregisterInterval, unregisterRenderBackend, utcSecondsToIstDateString, utcSecondsToIstParts, utcSecondsToZonedDateString, utcSecondsToZonedParts, version, verticalGradient, watermarkRect, withAlpha, withBarCache, zoneOffsetSeconds, zonedDayIndex, zonedStringToUtcSeconds, zonedWallClockToUtcSeconds, zonedWeekIndex };

package/dist/indicators/index.d.ts

@@ -1,4 +1,4 @@
-import { IndicatorDescriptor, ChartDataContext, IndicatorSettings, Bar, IndicatorInput, IndicatorPlot, IndicatorLevel } from 'openalgo-charts';
+import { IndicatorDescriptor, ChartDataContext, IndicatorSettings, Bar, IndicatorBarsRequest, IndicatorInput, IndicatorPlot, IndicatorValues, IndicatorStore, IndicatorCalcContext, IndicatorLevel } from 'openalgo-charts';
 
 declare const SMA: IndicatorDescriptor;
 declare const WMA: IndicatorDescriptor;
@@ -1106,6 +1106,12 @@ interface Tier2Context {
     /** UTC seconds of the first and last source bar (0 when there are none). */
     from: number;
     to: number;
+    /**
+     * The host's bar provider, when the runtime supplies one, so a `fetch` that
+     * needs another instrument's candles asks the host rather than carrying its
+     * own transport and credentials. Rejects when the host registered none.
+     */
+    requestBars?(request: IndicatorBarsRequest): Promise<readonly Bar[]>;
 }
 interface Tier2Descriptor {
     id: string;
@@ -1114,6 +1120,22 @@ interface Tier2Descriptor {
     placement: 'onchart' | 'pane';
     inputs: readonly IndicatorInput[];
     plots: readonly IndicatorPlot[];
+    /**
+     * External columns to align besides the plots, by key. A point may carry
+     * more than what is drawn: a benchmark close that `calc` divides by, an
+     * open-interest figure a ratio is built from. Anything not named here or in
+     * `plots` is dropped at alignment.
+     */
+    series?: readonly string[];
+    /**
+     * Combine the aligned external columns with the chart's own bars. Without
+     * it the aligned columns are the result, one per plot, exactly as before.
+     * With it, `external` holds every plot and `series` key aligned onto the
+     * bars (last-known-value, `null` before the first point), and the return is
+     * what the plots draw: a relative strength, a beta, a spread. Pure in its
+     * arguments, like any `calc`.
+     */
+    calc?(bars: readonly Bar[], external: IndicatorValues, settings: Readonly<IndicatorSettings>, store: IndicatorStore, ctx?: IndicatorCalcContext): IndicatorValues;
     /** A host/provider can explicitly decline data it cannot supply. */
     supports?(ctx: Tier2Context): boolean;
     /** Load the series for the current window. */
@@ -1150,6 +1172,61 @@ interface Tier2Descriptor {
  */
 declare function createTier2Indicator(d: Tier2Descriptor): IndicatorDescriptor;
 
+/**
+ * A higher-timeframe view of the chart's own bars, one value per source bar.
+ *
+ * A study written for a script language asks for the daily high on a 5-minute
+ * chart and gets a column the same length as the chart. The engine has no
+ * such call, and every port that needed one folded the bars by hand, each a
+ * little differently: some anchored an hourly bucket to midnight and some to
+ * the session open, some read the bucket as it stood and some read its final
+ * values. This is the one fold, with the three readings named:
+ *
+ * - `offset: 0` (the default) reads the bucket **as it stood at that bar**:
+ *   its open so far, high and low so far, the bar's own close, volume so far.
+ *   It is what the live bar sees and it never uses a later bar.
+ * - `offset: k` reads the bucket that completed `k` buckets before, held
+ *   constant across the current one. The classic non-repainting reference,
+ *   `close[1]` on the higher timeframe.
+ * - `lookahead: true` reads the current bucket's **final** values on every one
+ *   of its bars. It uses bars that had not happened yet, which is what the
+ *   source it is porting did; it is here so that can be reproduced, not
+ *   recommended.
+ *
+ * Buckets follow the chart's calendar: a day is a day in `timezone`, a week
+ * starts on Monday there, and a sub-day interval is anchored to the epoch, or
+ * to the session open when `session` is given, which is how an exchange cuts
+ * its hourly bars.
+ */
+
+interface SecurityOptions {
+    /** The calendar the buckets are cut in. Defaults to the shipped default zone. */
+    timezone?: string;
+    /** Read each bucket's final values on all of its bars. Default false. */
+    lookahead?: boolean;
+    /** Read the bucket completed this many buckets ago. Default 0, the current one. */
+    offset?: number;
+    /**
+     * A session window, `'0915-1530'`, that anchors sub-day buckets to the
+     * session open instead of the epoch. Without it a 30-minute bucket on a
+     * 09:15 open runs 09:00 to 09:30; with it, 09:15 to 09:45.
+     */
+    session?: string;
+}
+interface SecuritySeries {
+    open: (number | null)[];
+    high: (number | null)[];
+    low: (number | null)[];
+    close: (number | null)[];
+    /** Null on a bucket none of whose bars carried volume. */
+    volume: (number | null)[];
+    /** Time of the first source bar in the bucket being read, UTC seconds. */
+    bucketStart: (number | null)[];
+    /** True on the first source bar of each bucket. */
+    isNew: boolean[];
+}
+declare function securitySeries(bars: readonly Bar[], interval: string, options?: SecurityOptions): SecuritySeries;
+
 declare const INDICATORS_TIER: "indicators";
 /** Every built-in descriptor, in picker order. */
 declare const BUILTIN_INDICATORS: readonly IndicatorDescriptor[];
@@ -1160,4 +1237,4 @@ declare const BUILTIN_INDICATORS: readonly IndicatorDescriptor[];
  */
 declare function registerBuiltinIndicators(): void;
 
-export { ADAPTIVE_INDICATORS, ADL, ADX, ALLIGATOR, ALMA, ALPHATREND, AROON, AROON_OSCILLATOR, ATR, AVERAGE_DAILY_RANGE, AVERAGE_INDICATORS, AWESOME_OSCILLATOR, BALANCE_OF_POWER, BB_TREND, BOLLINGER, BOLLINGER_BANDWIDTH, BOLLINGER_PERCENT_B, BUILTIN_INDICATORS, CCI, CHAIKIN_MONEY_FLOW, CHAIKIN_OSCILLATOR, CHAIKIN_VOLATILITY, CHANDELIER_EXIT, CHANDE_KROLL_STOP, CHANDE_MOMENTUM, CHOPPINESS_INDEX, CHOP_ZONE, CONNORS_RSI, CONSOLIDATION_BREAKOUT, COPPOCK_CURVE, CPR, DEMA, DONCHIAN, DPO, EASE_OF_MOVEMENT, ELDER_FORCE_INDEX, EMA, ENVELOPE, FISHER_TRANSFORM, FLOW_INDICATORS, HALFTREND, HISTORICAL_VOLATILITY, HMA, HULL_SUITE, ICHIMOKU, INDEX_INDICATORS, INDICATORS_TIER, KAMA, KELTNER_CHANNEL, KLINGER_OSCILLATOR, KNOW_SURE_THING, LINREG_SLOPE, LSMA, MACD, MASS_INDEX, MA_CHANNEL, MA_CROSS, MA_RIBBON, MCGINLEY_DYNAMIC, MEDIAN, MFI, MOMENTUM, NET_VOLUME, NVI, OBV, OSCILLATOR_INDICATORS, OVERLAY_INDICATORS, PARABOLIC_SAR, PPO, PVI, PVO, PVT, RANGE_ANALYSIS, RANGE_INDICATORS, RELATIVE_VIGOR_INDEX, RELATIVE_VOLATILITY_INDEX, ROC, RSI, RSI_DIVERGENCE, SEASONALITY, SEASONALITY_INDICATORS, SIGNAL_INDICATORS, SMA, SMI, SMI_ERGODIC_INDICATOR, SMI_ERGODIC_OSCILLATOR, SMMA, SPECIAL_K, STANDARD_DEVIATION, STANDARD_ERROR, STANDARD_ERROR_BANDS, STOCHASTIC, STOCHASTIC_RSI, STRENGTH_INDICATORS, STUDY_INDICATORS, SUPERTREND, T3, TEMA, TREND_STRENGTH_INDEX, TRIX, TSI, TWAP, type Tier2Context, type Tier2Descriptor, type Tier2Point, ULCER_INDEX, ULTIMATE_OSCILLATOR, VOLATILITY_INDICATORS, VOLATILITY_STOP, VOLUME, VORTEX, VWAP, VWMA, WAVETREND, WAVETREND_INDICATORS, WILLIAMS_FRACTALS, WILLIAMS_PERCENT_R, WILLIAMS_VIX_FIX, WMA, WOODIES_CCI, alma, barsSince, cci, change, connorsStreak, correlation, createTier2Indicator, cumulative, dev, highest, highestBars, linreg, lowest, lowestBars, nulls, percentRank, percentileNearestRank, pivotHigh, pivotLow, registerBuiltinIndicators, rma, roc, rollingSum, sma, smaSeededEma, stdev, stoch, swma, valueWhen, vwma, wma };
+export { ADAPTIVE_INDICATORS, ADL, ADX, ALLIGATOR, ALMA, ALPHATREND, AROON, AROON_OSCILLATOR, ATR, AVERAGE_DAILY_RANGE, AVERAGE_INDICATORS, AWESOME_OSCILLATOR, BALANCE_OF_POWER, BB_TREND, BOLLINGER, BOLLINGER_BANDWIDTH, BOLLINGER_PERCENT_B, BUILTIN_INDICATORS, CCI, CHAIKIN_MONEY_FLOW, CHAIKIN_OSCILLATOR, CHAIKIN_VOLATILITY, CHANDELIER_EXIT, CHANDE_KROLL_STOP, CHANDE_MOMENTUM, CHOPPINESS_INDEX, CHOP_ZONE, CONNORS_RSI, CONSOLIDATION_BREAKOUT, COPPOCK_CURVE, CPR, DEMA, DONCHIAN, DPO, EASE_OF_MOVEMENT, ELDER_FORCE_INDEX, EMA, ENVELOPE, FISHER_TRANSFORM, FLOW_INDICATORS, HALFTREND, HISTORICAL_VOLATILITY, HMA, HULL_SUITE, ICHIMOKU, INDEX_INDICATORS, INDICATORS_TIER, KAMA, KELTNER_CHANNEL, KLINGER_OSCILLATOR, KNOW_SURE_THING, LINREG_SLOPE, LSMA, MACD, MASS_INDEX, MA_CHANNEL, MA_CROSS, MA_RIBBON, MCGINLEY_DYNAMIC, MEDIAN, MFI, MOMENTUM, NET_VOLUME, NVI, OBV, OSCILLATOR_INDICATORS, OVERLAY_INDICATORS, PARABOLIC_SAR, PPO, PVI, PVO, PVT, RANGE_ANALYSIS, RANGE_INDICATORS, RELATIVE_VIGOR_INDEX, RELATIVE_VOLATILITY_INDEX, ROC, RSI, RSI_DIVERGENCE, SEASONALITY, SEASONALITY_INDICATORS, SIGNAL_INDICATORS, SMA, SMI, SMI_ERGODIC_INDICATOR, SMI_ERGODIC_OSCILLATOR, SMMA, SPECIAL_K, STANDARD_DEVIATION, STANDARD_ERROR, STANDARD_ERROR_BANDS, STOCHASTIC, STOCHASTIC_RSI, STRENGTH_INDICATORS, STUDY_INDICATORS, SUPERTREND, type SecurityOptions, type SecuritySeries, T3, TEMA, TREND_STRENGTH_INDEX, TRIX, TSI, TWAP, type Tier2Context, type Tier2Descriptor, type Tier2Point, ULCER_INDEX, ULTIMATE_OSCILLATOR, VOLATILITY_INDICATORS, VOLATILITY_STOP, VOLUME, VORTEX, VWAP, VWMA, WAVETREND, WAVETREND_INDICATORS, WILLIAMS_FRACTALS, WILLIAMS_PERCENT_R, WILLIAMS_VIX_FIX, WMA, WOODIES_CCI, alma, barsSince, cci, change, connorsStreak, correlation, createTier2Indicator, cumulative, dev, highest, highestBars, linreg, lowest, lowestBars, nulls, percentRank, percentileNearestRank, pivotHigh, pivotLow, registerBuiltinIndicators, rma, roc, rollingSum, securitySeries, sma, smaSeededEma, stdev, stoch, swma, valueWhen, vwma, wma };