openalgo-charts 2.1.5 → 2.1.6

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, 51 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, 67.08 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, 51 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, 71.57 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-67.08%20KB%20base%20%C2%B7%20187.90%20KB%20all%20tiers-brightgreen.svg)](#size-budget)
-[![tests](https://img.shields.io/badge/tests-4215%20passing-brightgreen.svg)](#develop)
+[![bundle](https://img.shields.io/badge/brotli-71.57%20KB%20base%20%C2%B7%20193.96%20KB%20all%20tiers-brightgreen.svg)](#size-budget)
+[![tests](https://img.shields.io/badge/tests-4303%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)
@@ -43,11 +43,12 @@ Every chart in the [live gallery](https://marketcalls.github.io/openalgo-charts/
 
 ## Install
 
-Current version: **2.1.5**.
+Current version: **2.1.6**.
 
-This patch keeps drawing previews and freehand strokes visible beyond the latest
-candle and before the first loaded bar. Future drawing anchors remain editable
-and retain their saved positions. See the [2.1.5 changelog](./CHANGELOG.md#215) and
+This release adds a shared data-loading controller, resilient warm history,
+cancellation, paging and visible retry states for widgets and custom terminals.
+Drawings remain visible beyond the latest candle and are clipped at the price axes.
+See the [2.1.6 changelog](./CHANGELOG.md#216) and
 [OpenAlgo compatibility guide](https://marketcalls.github.io/openalgo-charts/docs/openalgo-compatibility/).
 
 ```bash
@@ -69,7 +70,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.1.5/dist/openalgo-charts.mjs';
+  import { createChart } from 'https://unpkg.com/openalgo-charts@2.1.6/dist/openalgo-charts.mjs';
   const chart = createChart(document.getElementById('chart'), { timezone: 'Asia/Kolkata' });
   chart.addSeries('candlestick').setData(bars);
 </script>
@@ -108,16 +109,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 | 67.08 KB |
-| `openalgo-charts/indicators` | 102 built-in indicators, the `registerIndicator` contract for your own, and the Tier-2 (external-data) contract | 27.36 KB |
-| `openalgo-charts/draw` | 51 drawing tools + a headless drawing controller, clipboard, settings schema, level palette, freehand geometry and SVG icons | 25.84 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 | 71.57 KB |
+| `openalgo-charts/indicators` | 102 built-in indicators, the `registerIndicator` contract for your own, and the Tier-2 (external-data) contract | 28.05 KB |
+| `openalgo-charts/draw` | 51 drawing tools + a headless drawing controller, clipboard, settings schema, level palette, freehand geometry and SVG icons | 25.90 KB |
 | `openalgo-charts/transform` | Heikin Ashi, Renko, Range bars, Line Break, Point &amp; Figure, Kagi | 2.66 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 | 36.01 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 | 36.83 KB |
 
-Everything together is **187.90 KB Brotli**; a widget terminal (base + draw + indicators + widget, what one `createWidget` call loads) is 156.29 KB. Figures are the measured `size-limit` output. The trade tier is listed as its delta over the base, so loading base + trade costs 74.69 KB.
+Everything together is **193.96 KB Brotli**; a widget terminal (base + draw + indicators + widget, what one `createWidget` call loads) is 162.35 KB. Figures are the measured `size-limit` output. The trade tier is listed as its delta over the base, so loading base + trade costs 79.18 KB.
 
 ## What's built
 
@@ -409,16 +410,16 @@ Enforced in CI by [`size-limit`](./.size-limit.json). Nothing is excluded, becau
 
 | Bundle | Limit | Actual |
 |---|---|---|
-| Base engine | 68 KB | 67.08 KB |
-| Base + trade | 75 KB | 74.69 KB |
-| Indicators tier | 30 KB | 27.36 KB |
-| Draw tier | 26 KB | 25.84 KB |
+| Base engine | 73 KB | 71.57 KB |
+| Base + trade | 81 KB | 79.18 KB |
+| Indicators tier | 30 KB | 28.05 KB |
+| Draw tier | 26 KB | 25.90 KB |
 | Transform tier | 5 KB | 2.66 KB |
 | Profile tier | 15 KB | 14.96 KB |
 | WebGL2 tier | 7 KB | 6.38 KB |
-| Widget tier | 37 KB | 36.01 KB |
-| Widget terminal (base + draw + indicators + widget) | 157 KB | 156.29 KB |
-| **Everything** | **188 KB** | **187.90 KB** |
+| Widget tier | 37 KB | 36.83 KB |
+| Widget terminal (base + draw + indicators + widget) | 165 KB | 162.35 KB |
+| **Everything** | **197 KB** | **193.96 KB** |
 
 ## Documentation
 
@@ -463,7 +464,7 @@ See [Contributing](./CONTRIBUTING.md) for setup, targeted checks, documentation
 ```bash
 npm install        # install dev toolchain
 npm run typecheck  # strict TypeScript check
-npm test           # unit tests (vitest) - 4215 across 182 files
+npm test           # unit tests (vitest) - 4303 across 190 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
@@ -480,7 +481,7 @@ npm run verify     # lint + typecheck + test + build + demo tests + dts + size +
 
 ## Status &amp; limitations
 
-Version **2.1.5**. All engine build phases are implemented. Upgrading a 1.9.x host: [Migrating to 2.0](./docs/migrating-to-2.md).
+Version **2.1.6**. 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/draw/index.d.ts

@@ -1019,6 +1019,8 @@ declare class DrawingLayer implements IPrimitive {
      */
     private _hoverHandled;
     draw(ctx: CanvasRenderingContext2D, rc: PrimitiveRenderContext): void;
+    private _drawingContext;
+    private _drawContent;
     /**
      * Anchor handles. A hover shows them light (thin, translucent) as a hint
      * that the shape can be grabbed; a selection shows them at full weight.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /** Library version string. Matches package.json (including locally prepared releases). */
-declare const VERSION = "2.1.5";
+declare const VERSION = "2.1.6";
 /** Returns the current library version. */
 declare function version(): string;
 
@@ -736,6 +736,8 @@ type ZOrder = 'bottom' | 'normal' | 'top';
 interface PrimitiveRenderContext {
     timeScale: TimeScale;
     priceScale: PriceScale;
+    /** The pane's primary visible price series scale, including a moved left axis. */
+    readoutPriceScale?: PriceScale;
     dataLayer: DataLayer;
     plotWidth: number;
     plotHeight: number;
@@ -1906,8 +1908,32 @@ interface IndicatorAlertPayload {
     time: number;
     index: number;
 }
+/** Optional instrument identity supplied by the host. */
+interface ChartDataContext {
+    symbol?: string;
+    exchange?: string;
+    interval?: string;
+}
+/** Source identity changed, or the available source-bar range changed. */
+type IndicatorDataChange = 'context' | 'range';
+/** Observable state of an indicator's external data lifecycle. */
+type IndicatorDataStatus = {
+    state: 'loading' | 'ready' | 'empty' | 'unsupported';
+} | {
+    state: 'error';
+    error: unknown;
+};
 /** What an indicator's `attach` lifecycle can reach. */
 interface IndicatorAttachContext {
+    /** Optional host identity, independent of the indicator's own settings. */
+    dataContext?(): Readonly<ChartDataContext> | undefined;
+    /** Read bars and identity again when the host publishes a change. */
+    subscribeDataChanges?(listener: (change: IndicatorDataChange) => void): () => void;
+    /** Publish status and an explicit retry action for this instance. */
+    setDataStatus?(status: IndicatorDataStatus): void;
+    setDataRetry?(retry: (() => void) | null): void;
+    /** Instance lifetime. Aborted on removal, preserved across style changes. */
+    signal?: AbortSignal;
     /** Current settings (live — read at call time, not captured). */
     settings(): Readonly<IndicatorSettings>;
     /** The chart's current source bars. */
@@ -1919,11 +1945,9 @@ interface IndicatorAttachContext {
     /**
      * The instrument the chart is showing, when the host knows it.
      *
-     * The engine core has no instrument concept: it is handed bars, never a
-     * symbol, so `chart.addIndicator` leaves this undefined rather than inventing
-     * a name. A host that wraps the chart (a terminal that owns the symbol
-     * picker) supplies it through its own `IndicatorHost`, which is how a Tier-2
-     * indicator fetches the series matching what is on screen.
+     * Hosts can supply this through `IndicatorHost` or Chart's explicit data
+     * context. Without a configured identity it stays undefined. External
+     * studies read `dataContext` to include the exchange as well.
      */
     symbol?(): string | undefined;
     /** The chart's timeframe (`'5m'`, `'1d'`), on the same terms as `symbol`. */
@@ -2471,6 +2495,9 @@ declare class IndicatorFill implements IPrimitive {
 
 /** The slice of the chart the runtime needs. Keeps this module testable alone. */
 interface IndicatorHost {
+    /** Optional instrument identity and source-range notifications. */
+    dataContext?(): Readonly<ChartDataContext> | undefined;
+    subscribeDataChanges?(listener: (change: IndicatorDataChange) => void): () => void;
     /** Add the pane-legend row (name + inline up/down/hide/maximize/close). */
     addIndicatorLegend(opts: {
         id: string;
@@ -2544,9 +2571,8 @@ interface IndicatorHost {
     timezone?(): string;
     /**
      * The instrument and timeframe on screen, when the host knows them. The
-     * engine core does not: it is handed bars and never a symbol, so `Chart`
-     * leaves both out and a descriptor sees `undefined` rather than a guess. A
-     * terminal that owns the symbol picker implements them here.
+     * host can supply an explicit `dataContext` instead. Without either hook,
+     * a descriptor sees `undefined` rather than a guessed identity.
      */
     symbol?(): string | undefined;
     interval?(): string | undefined;
@@ -2596,6 +2622,12 @@ interface IndicatorHost {
 }
 /** Public handle returned by `chart.addIndicator(...)`. */
 interface IndicatorApi {
+    /** External data state, or null for a study without a managed lifecycle. */
+    dataStatus(): Readonly<IndicatorDataStatus> | null;
+    /** Observe changes; immediately receives the current managed status, if any. */
+    subscribeDataStatus(listener: (status: Readonly<IndicatorDataStatus>) => void): () => void;
+    /** Retry external history when the descriptor supplies a retry action. */
+    retryData(): void;
     /** Unique instance id (several instances of one indicator can coexist). */
     readonly id: string;
     /** The descriptor id, e.g. `'macd'`. */
@@ -3842,6 +3874,7 @@ declare class Chart {
     /** Handle + record of the primary price series (see `primarySeries`). */
     private _primary;
     private readonly _indicators;
+    private _dataContext;
     /** Guards indicator recompute against re-entry via its own `series.setData`. */
     private _recomputing;
     private _indicatorsDirty;
@@ -4050,6 +4083,10 @@ declare class Chart {
     indicators(): readonly IndicatorApi[];
     /** Remove one indicator instance by its handle id. Returns true if it existed. */
     removeIndicator(instanceId: string): boolean;
+    /** Optional instrument identity supplied by the host, never inferred from bars. */
+    getDataContext(): Readonly<ChartDataContext> | undefined;
+    /** Clear the previous source bars before changing context, then load the new source. */
+    setDataContext(context: ChartDataContext | undefined): void;
     private _indicatorHost;
     /**
      * Take (or withdraw) the price bars' colour overlay on behalf of one
@@ -6681,6 +6718,24 @@ interface BarsRequest {
     to?: UTCSeconds;
     /** Fetch authoritative history instead of a cached snapshot, when supported. */
     noCache?: boolean;
+    /** Cancel this consumer's request. Existing feeds may ignore cancellation. */
+    signal?: AbortSignal;
+    /** Deadline in milliseconds, including response-body reading. */
+    timeoutMs?: number;
+    /** Preferred number of bars; a date-range feed may return a different count. */
+    countBack?: number;
+}
+/** An optional provider page before an exclusive UTC-second anchor. */
+interface BarsPageRequest extends BarsRequest {
+    before: UTCSeconds;
+    countBack: number;
+}
+/** Providers can distinguish an empty date window from exhausted history. */
+interface BarsPage {
+    bars: Bar[];
+    hasMore?: boolean;
+    /** Exclusive anchor for the next page, including pages without observations. */
+    nextBefore?: UTCSeconds;
 }
 /** Optional context for continuing history and recovering an interrupted stream. */
 interface BarSubscriptionOptions {
@@ -6702,6 +6757,9 @@ interface BarSubscriptionOptions {
  */
 interface DataFeed {
     getBars(req: BarsRequest): Promise<Bar[]>;
+    getBarsPage?(req: BarsPageRequest): Promise<BarsPage>;
+    /** Read a closed-bar snapshot without initiating a network request. */
+    getCachedBars?(req: BarsRequest): Promise<Bar[] | undefined>;
     subscribeBars?(req: BarsRequest, onBar: (bar: Bar) => void, opts?: BarSubscriptionOptions): UnsubscribeFn;
     /**
      * `opts.depthLevel` requests a book depth (broker-dependent: 5/20/30/50).
@@ -6719,6 +6777,8 @@ interface DepthLevel {
 }
 /** Variable-depth book; `bids`/`asks` length = whatever the broker streams (5..200). */
 interface MarketDepth {
+    /** Exchange event timestamp in UTC seconds, when supplied by the feed. */
+    timeSec?: UTCSeconds;
     bids: DepthLevel[];
     asks: DepthLevel[];
     ltp: number;
@@ -6754,14 +6814,120 @@ interface TradeFeed {
     subscribePositions(cb: (positions: unknown[]) => void): UnsubscribeFn;
 }
 
+/** Limits apply to each pool, whose identity belongs to one data feed. */
+interface HistoryRequestPoolOptions {
+    maxConcurrent?: number;
+    timeoutMs?: number;
+}
+/**
+ * Shares in-flight historical requests while each consumer owns its lifetime.
+ * Higher priorities run first among queued work; active work is not preempted.
+ */
+declare class HistoryRequestPool {
+    private readonly _feed;
+    private readonly _max;
+    private readonly _timeout;
+    private readonly _jobs;
+    private _active;
+    private _draining;
+    constructor(feed: DataFeed, options?: HistoryRequestPoolOptions);
+    getBars(req: BarsRequest, priority?: number): Promise<Bar[]>;
+    getBarsPage(req: BarsPageRequest, priority?: number): Promise<BarsPage>;
+    private _request;
+    private _remove;
+    private _finish;
+    private _drain;
+}
+/** Reuse one pool only for consumers of this exact feed instance. */
+declare function sharedHistoryRequests(feed: DataFeed): HistoryRequestPool;
+
+type DataLoadingStatus = 'idle' | 'loading' | 'ready' | 'empty' | 'refreshing' | 'stale' | 'error';
+type HistoryLoadingStatus = 'idle' | 'loading' | 'error' | 'exhausted' | 'limited';
+type DataUpdateReason = 'load' | 'cache' | 'live' | 'refresh' | 'prepend' | 'resume' | 'state';
+/** Display bars are held still while paused; bars() retains the live store. */
+interface DataLoadingSnapshot {
+    readonly request: Readonly<BarsRequest> | null;
+    readonly bars: readonly Bar[];
+    readonly status: DataLoadingStatus;
+    readonly historyStatus: HistoryLoadingStatus;
+    readonly hasMore: boolean | null;
+    readonly error?: Error;
+    readonly historyError?: Error;
+    readonly reason: DataUpdateReason;
+    readonly paused: boolean;
+}
+interface DataLoadingOptions {
+    requestPool?: HistoryRequestPool;
+    timeoutMs?: number;
+    pageSize?: number;
+    /** Date-window fallback for feeds without getBarsPage. Defaults to the load window. */
+    pageWindowSec?: number;
+    /** Empty windows inspected per gesture, without claiming permanent exhaustion. */
+    maxEmptyPages?: number;
+    maxBars?: number;
+    /** Optional history repair cadence. Zero disables polling. */
+    pollIntervalMs?: number;
+    /** UTC seconds. */
+    now?: () => number;
+}
+/**
+ * Owns history, paging and live updates for one current instrument. Consumers
+ * decide how to paint snapshots; no canvas, DOM or broker execution is owned here.
+ */
+declare class DataLoadingController {
+    private readonly _feed;
+    private readonly _pool;
+    private readonly _options;
+    private readonly _listeners;
+    private _state;
+    private _bars;
+    private _scope;
+    private _refreshAbort;
+    private _pageAbort;
+    private _loadWork;
+    private _pageWork;
+    private _unsubscribe;
+    private _stream;
+    private _generation;
+    private _refreshId;
+    private _before;
+    private _buffer;
+    private _poll;
+    private _visible;
+    private _destroyed;
+    constructor(feed: DataFeed, options?: DataLoadingOptions);
+    getState(): DataLoadingSnapshot;
+    bars(): readonly Bar[];
+    subscribe(listener: (snapshot: DataLoadingSnapshot) => void): UnsubscribeFn;
+    load(req: BarsRequest): Promise<readonly Bar[]>;
+    private _load;
+    refresh(): Promise<readonly Bar[]>;
+    /** Supply bars from an existing host subscription instead of subscribing twice. */
+    pushBar(value: Bar): void;
+    loadMore(): Promise<readonly Bar[]>;
+    private _loadMore;
+    setPaused(paused: boolean): void;
+    setVisible(visible: boolean): void;
+    destroy(): void;
+    private _current;
+    private _replaceWindow;
+    private _limit;
+    private _publish;
+    private _startStream;
+    private _release;
+    private _clearPoll;
+    private _schedulePoll;
+    private _cancel;
+}
+
 /**
  * OpenAlgo REST adapter (ARCHITECTURE.md §10.0). The chart depends only on the
  * `DataFeed` interface; this is the only file that knows OpenAlgo's REST shape.
  *
  * History endpoint: POST `${baseUrl}/api/v1/history`.
- * NOTE: the exact request/response field names must be verified against the
- * running OpenAlgo build and pinned here; the mapper below is tolerant of
- * epoch-seconds, epoch-ms, and IST date/time string timestamps.
+ * The request fields and interval mapping are pinned by offline adapter
+ * fixtures. Response timestamps accept epoch seconds, epoch milliseconds,
+ * offset-qualified timestamps and unqualified IST date/time strings.
  */
 
 interface OpenAlgoConfig {
@@ -7925,12 +8091,12 @@ declare class TickBarAggregator {
  * measured without serialising. Byte counting would mean stringifying every
  * entry on every write, which costs more than the cache saves.
  *
- * **Storage.** In-memory by default. A host may inject `storage` to persist
- * (localStorage, IndexedDB) but the engine will not reach for either itself:
- * choosing a persistence layer is the host's business, localStorage is
- * synchronous and small, and IndexedDB is asynchronous. Store methods may
- * therefore return a promise. `CachedBars` is plain JSON so it round-trips
- * through `JSON.stringify` unchanged.
+ * **Storage.** A bounded in-memory copy is always available. A host may inject
+ * `storage` to persist through localStorage, IndexedDB, or another store, but
+ * the engine will not choose one itself. Durable reads, writes, and deletes are
+ * best effort so storage denial or quota exhaustion cannot block market data.
+ * Store methods may return a promise. `CachedBars` is plain JSON so it
+ * round-trips through `JSON.stringify` unchanged.
  *
  * **Opt-out.** `getBars({ ..., noCache: true })` always hits the network (and
  * refreshes the entry); `invalidate()` and `clear()` drop entries by hand.
@@ -7939,6 +8105,8 @@ declare class TickBarAggregator {
 type MaybePromise<T> = T | Promise<T>;
 /** One cached series. Plain JSON: safe to persist as-is. */
 interface CachedBars {
+    /** Persisted schema version. Missing means the compatible legacy schema. */
+    version?: number;
     /** Closed bars only, ascending by time. */
     bars: Bar[];
     /** Coverage start: the `from` of the request that filled this entry. */
@@ -7955,8 +8123,8 @@ interface CachedBars {
     nextClose: UTCSeconds;
 }
 /**
- * Pluggable backing store. Sync or async: everything is awaited. Implement it
- * over localStorage, IndexedDB, or anything else; the default is a Map.
+ * Pluggable durable store. Sync or async operations are awaited and isolated
+ * from the network result. The cache always keeps its own bounded memory copy.
  */
 interface BarCacheStore {
     get(key: string): MaybePromise<CachedBars | undefined>;
@@ -7970,7 +8138,7 @@ interface BarCacheOptions {
     max?: number;
     /** Maximum total cached bars before LRU eviction. Default 250_000. */
     maxBars?: number;
-    /** Backing store. Default: in-memory Map. */
+    /** Optional durable store. Bounded in-memory retention is always enabled. */
     storage?: BarCacheStore;
     /** Injectable clock (ms), for tests and for hosts with a server clock. */
     now?: () => number;
@@ -8000,6 +8168,8 @@ interface BarCacheStats {
     misses: number;
     evictions: number;
 }
+/** Current persisted entry schema. Legacy entries without this field remain readable. */
+declare const BAR_CACHE_VERSION = 1;
 /**
  * Interval token to seconds. Case matters where it disambiguates: lowercase
  * The instant a bar starting at `barStartSec` closes, or null when that cannot
@@ -8030,6 +8200,10 @@ declare class BarCache implements DataFeed {
     /** The wrapped feed, for callers that need something this wrapper does not forward. */
     readonly source: DataFeed;
     private readonly _backing;
+    private readonly _memory;
+    /** Keys whose durable value may still exist after a failed write or delete. */
+    private readonly _tombstones;
+    private readonly _writes;
     private readonly _ttlMs;
     private readonly _max;
     private readonly _maxBars;
@@ -8043,7 +8217,10 @@ declare class BarCache implements DataFeed {
     constructor(feed: DataFeed, options?: BarCacheOptions);
     subscribeBars?: (req: BarsRequest, onBar: (bar: Bar) => void, ...rest: unknown[]) => UnsubscribeFn;
     subscribeDepth?: (req: BarsRequest, onDepth: (depth: MarketDepth) => void, ...rest: unknown[]) => UnsubscribeFn;
+    getBarsPage?: (req: BarsPageRequest) => Promise<BarsPage>;
     getBars(req: CachedBarsRequest): Promise<Bar[]>;
+    /** Read any valid, TTL-retained closed overlap without initiating a source request. */
+    getCachedBars(req: BarsRequest): Promise<Bar[] | undefined>;
     /**
      * Drop one series, or (with no argument) everything this cache knows of.
      * "Knows of" is literal with an injected persistent store: recency and size
@@ -8055,9 +8232,18 @@ declare class BarCache implements DataFeed {
     clear(): Promise<void>;
     stats(): BarCacheStats;
     private _lookup;
+    private _slice;
     private _put;
     private _drop;
     private _evict;
+    private _remember;
+    private _readEntry;
+    private _validEntry;
+    private _validBar;
+    private _cloneEntry;
+    private _writeBacking;
+    private _deleteBacking;
+    private _restoreLatestBacking;
 }
 /**
  * Wrap any `DataFeed` in a warm-load bar cache.
@@ -8263,4 +8449,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, BUILTIN_COMMANDS, type Bar, BarCache, type BarCacheOptions, type BarCacheStats, type BarCacheStore, type BarSubscriptionOptions, type BarUpdate, type BarsRequest, 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 ChartDragEndEvent, type ChartDragEvent, type ChartEvent, type ChartEventOptions, type ChartNavigationOptions, type ChartOptions, type ChartSettingsColorPairInput, type ChartSettingsInput, type ChartSettingsState, type ChartSettingsTab, type ChartSettingsTabId, type ChartSettingsValue, type ChartSettingsValues, type ChartState, ChartTable, type ChartTableOptions, type ChartTheme, 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, 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, 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 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 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 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, 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 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 ChartOptions, type ChartSettingsColorPairInput, type ChartSettingsInput, type ChartSettingsState, type ChartSettingsTab, type ChartSettingsTabId, type ChartSettingsValue, type ChartSettingsValues, type ChartState, ChartTable, type ChartTableOptions, type ChartTheme, 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 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 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, IndicatorSettings, Bar, IndicatorInput, IndicatorPlot, IndicatorLevel } from 'openalgo-charts';
+import { IndicatorDescriptor, ChartDataContext, IndicatorSettings, Bar, IndicatorInput, IndicatorPlot, IndicatorLevel } from 'openalgo-charts';
 
 declare const SMA: IndicatorDescriptor;
 declare const WMA: IndicatorDescriptor;
@@ -1096,6 +1096,10 @@ interface Tier2Point {
     values: Readonly<Record<string, number | null>>;
 }
 interface Tier2Context {
+    /** Host identity when supplied. Indicator settings remain independent. */
+    dataContext?: Readonly<ChartDataContext>;
+    /** Cancelled when this request is obsolete or the instance is removed. */
+    signal?: AbortSignal;
     settings: Readonly<IndicatorSettings>;
     /** The chart's current source bars — use for the requested time window. */
     bars: readonly Bar[];
@@ -1110,6 +1114,8 @@ interface Tier2Descriptor {
     placement: 'onchart' | 'pane';
     inputs: readonly IndicatorInput[];
     plots: readonly IndicatorPlot[];
+    /** A host/provider can explicitly decline data it cannot supply. */
+    supports?(ctx: Tier2Context): boolean;
     /** Load the series for the current window. */
     fetch(ctx: Tier2Context): Promise<readonly Tier2Point[]>;
     /**