@christtrade/depth 0.18.0 → 0.20.0

package/types/hooks/useChartInteraction.d.ts

@@ -5,11 +5,12 @@ import { type Crosshair } from '../lib/renderers/renderer';
 import { type PluginToolActiveContext } from '../core/DrawingRegistry';
 import type { ChartTypePlugin, ChartTypeActiveContext } from '../core/PluginRegistry';
 import { type RenderEngine } from '../core/RenderEngine';
+import { type BarStore } from '../core/BarStore';
 import { type TypedEventBus } from '../core/TypedEventBus';
 import { type SessionMapper } from '../core/SessionMapper';
 import { type TradingSession, type DataLevel, type SymbolInfo } from '../interfaces/IDataAdapter';
 import { type LiveTransformer } from '../interfaces/ICoordinateTransformer';
-import { type ViewBounds, type PriceHistory, type TradePoint, type OhlcvBarMs } from '../lib/types';
+import { type ViewBounds, type PriceHistory, type TradePoint } from '../lib/types';
 import { type FootprintBar } from '../lib/types/footprint';
 import { type ChartSettings } from '../lib/types/chart-settings';
 import { type Timeframe } from '../lib/timeframes';
@@ -102,10 +103,10 @@ export interface UseChartInteractionParams {
     allPriceHistoryRef: MutableRefObject<PriceHistory[]>;
     ohlcvBarsRef: MutableRefObject<{
         barNs: bigint;
-        bars: OhlcvBarMs[];
-        display: OhlcvBarMs[];
+        bars: BarStore;
+        display: BarStore;
     }>;
-    previewBarsRef: MutableRefObject<OhlcvBarMs[]>;
+    previewBarsRef: MutableRefObject<BarStore>;
     dataLevelRef: MutableRefObject<DataLevel | null>;
     openBarRef: MutableRefObject<FootprintBar | null>;
     candleCacheRef: MutableRefObject<Map<bigint, any> | null>;

package/types/hooks/useChartSettings.d.ts

@@ -1,9 +1,10 @@
 import { type MutableRefObject } from 'react';
-import { type ViewBounds, type TradePoint, type PriceHistory, type OhlcvBarMs } from '../lib/types';
+import { type ViewBounds, type TradePoint, type PriceHistory } from '../lib/types';
 import { type FootprintBar } from '../lib/types/footprint';
 import { type ChartSettings } from '../lib/types/chart-settings';
 import { type DataLevel } from '../interfaces/IDataAdapter';
 import { type RenderEngine } from '../core/RenderEngine';
+import { type BarStore } from '../core/BarStore';
 import { type CompactBuffer } from '../lib/compact-buffer';
 export interface UseChartSettingsParams {
     chartSettingsRef: MutableRefObject<ChartSettings>;
@@ -14,10 +15,10 @@ export interface UseChartSettingsParams {
     dataLevelRef: MutableRefObject<DataLevel | null>;
     ohlcvBarsRef: MutableRefObject<{
         barNs: bigint;
-        bars: OhlcvBarMs[];
-        display: OhlcvBarMs[];
+        bars: BarStore;
+        display: BarStore;
     }>;
-    previewBarsRef: MutableRefObject<OhlcvBarMs[]>;
+    previewBarsRef: MutableRefObject<BarStore>;
     openBarRef: MutableRefObject<FootprintBar | null>;
     horizonRef: MutableRefObject<bigint>;
     compactBufRef: MutableRefObject<CompactBuffer>;

package/types/hooks/useChartSubscriptions.d.ts

@@ -2,10 +2,11 @@ import { type MutableRefObject } from 'react';
 import { type ChartTypePlugin, type ChartTypeActiveContext } from '../core/PluginRegistry';
 import { type AccountManager } from '../core/AccountManager';
 import { type RenderEngine } from '../core/RenderEngine';
+import { type BarStore } from '../core/BarStore';
 import { type TypedEventBus } from '../core/TypedEventBus';
 import { type ChartPane, type Indicator } from '../lib/types/indicator-types';
 import { type ChartSettings } from '../lib/types/chart-settings';
-import { type TradePoint, type OhlcvBarMs, type ViewBounds } from '../lib/types';
+import { type TradePoint, type ViewBounds } from '../lib/types';
 import { type DataLevel } from '../interfaces/IDataAdapter';
 import { type FootprintBar } from '../lib/types/footprint';
 import { type SerialTrade } from '../lib/types';
@@ -27,12 +28,12 @@ export interface UseChartSubscriptionsParams {
     chartSettingsRef: MutableRefObject<ChartSettings>;
     pluginChartTypeComputedRef: MutableRefObject<Map<string, unknown>>;
     dataLevelRef: MutableRefObject<DataLevel | null>;
-    previewBarsRef: MutableRefObject<OhlcvBarMs[]>;
+    previewBarsRef: MutableRefObject<BarStore>;
     candleCacheRef: MutableRefObject<Map<bigint, any> | null>;
     ohlcvBarsRef: MutableRefObject<{
         barNs: bigint;
-        bars: OhlcvBarMs[];
-        display: OhlcvBarMs[];
+        bars: BarStore;
+        display: BarStore;
     }>;
     openBarRef: MutableRefObject<FootprintBar | null>;
     viewRef: MutableRefObject<ViewBounds | null>;
@@ -54,6 +55,7 @@ export interface UseChartSubscriptionsParams {
     autofitIndicatorPanes: () => void;
     handleAddIndicator: (id: string) => void;
     handleRemoveIndicator: (id: string) => void;
+    userRemoveIndicator: (id: string) => void;
     onSymbolChange: (symbol: string) => void;
     /** This layout's live sync switches (a ref: the handlers outlive a render). */
     syncInLayoutRef: MutableRefObject<SyncInLayout>;

package/types/hooks/useChartView.d.ts

@@ -1,8 +1,9 @@
 import { type MutableRefObject } from 'react';
-import { type ViewBounds, type TradePoint, type PriceHistory, type OhlcvBarMs } from '../lib/types';
+import { type ViewBounds, type TradePoint, type PriceHistory } from '../lib/types';
 import { type ChartSettings } from '../lib/types/chart-settings';
 import { type DataLevel } from '../interfaces/IDataAdapter';
 import { type RenderEngine } from '../core/RenderEngine';
+import { BarStore } from '../core/BarStore';
 import { type ChartPane, type Indicator } from '../lib/types/indicator-types';
 import { FootprintBar } from '../core';
 export interface UseChartViewParams {
@@ -12,11 +13,11 @@ export interface UseChartViewParams {
     setChartSettings: (updater: ChartSettings | ((prev: ChartSettings) => ChartSettings)) => void;
     priceHistoryRef: MutableRefObject<PriceHistory[]>;
     tradesRef: MutableRefObject<TradePoint[]>;
-    previewBarsRef: MutableRefObject<OhlcvBarMs[]>;
+    previewBarsRef: MutableRefObject<BarStore>;
     ohlcvBarsRef: MutableRefObject<{
         barNs: bigint;
-        bars: OhlcvBarMs[];
-        display: OhlcvBarMs[];
+        bars: BarStore;
+        display: BarStore;
     }>;
     openBarRef: MutableRefObject<FootprintBar>;
     chartSettingsRef: MutableRefObject<ChartSettings>;

package/types/hooks/useRenderEngine.d.ts

@@ -1,24 +1,7 @@
 import { type MutableRefObject, type RefObject } from 'react';
 import { RenderEngine } from '../core/RenderEngine';
 import { type TypedEventBus } from '../core/TypedEventBus';
-import { type ViewBounds, type TradePoint, type PriceHistory, type OhlcvBarMs } from '../lib/types';
-import { type ChartPane, type Indicator, type Rect } from '../lib/types/indicator-types';
-import { type FootprintBar } from '../lib/types/footprint';
-import { type ChartSettings } from '../lib/types/chart-settings';
-import { type DataLevel } from '../interfaces/IDataAdapter';
-import { type LiveTransformer } from '../interfaces/ICoordinateTransformer';
-type HeatmapBitmapOffsets = {
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-};
-type CacheBounds = {
-    tMin: bigint;
-    tMax: bigint;
-    pMin: number;
-    pMax: number;
-};
+import { type ViewBounds } from '../lib/types';
 export interface UseRenderEngineParams {
     renderEngineRef: MutableRefObject<RenderEngine | null>;
     baseCanvasRef: RefObject<HTMLCanvasElement>;
@@ -29,36 +12,5 @@ export interface UseRenderEngineParams {
      *  other cells can tell our repaints from theirs. */
     chartId: number;
     viewRef: MutableRefObject<ViewBounds | null>;
-    /** Auto-computed right price-axis width (css px). */
-    priceScaleWidthRef: MutableRefObject<number>;
-    tradesRef: MutableRefObject<TradePoint[]>;
-    getLayouts: () => Record<string, Rect>;
-    heatmapBitmapRef: MutableRefObject<ImageBitmap | null>;
-    cacheBoundsRef: MutableRefObject<CacheBounds | null>;
-    heatmapBitmapOffsetsRef: MutableRefObject<HeatmapBitmapOffsets>;
-    panesRef: MutableRefObject<ChartPane[]>;
-    indicatorsRef: MutableRefObject<Indicator[]>;
-    priceHistoryRef: MutableRefObject<PriceHistory[]>;
-    footprintBarsRef: MutableRefObject<FootprintBar[]>;
-    activeTimeframeRef: MutableRefObject<{
-        barNs: bigint;
-    }>;
-    chartSettingsRef: MutableRefObject<ChartSettings>;
-    horizonRef: MutableRefObject<bigint>;
-    candleCacheRef: MutableRefObject<Map<bigint, any> | null>;
-    openBarRef: MutableRefObject<FootprintBar | null>;
-    dataLevelRef: MutableRefObject<DataLevel | null>;
-    ohlcvBarsRef: MutableRefObject<{
-        barNs: bigint;
-        bars: OhlcvBarMs[];
-        display: OhlcvBarMs[];
-    }>;
-    previewBarsRef: MutableRefObject<OhlcvBarMs[]>;
-    transformer: LiveTransformer;
-    hideTimeScale: boolean;
 }
-export interface UseRenderEngineResult {
-    doBaseRedraw: () => void;
-}
-export declare function useRenderEngine(p: UseRenderEngineParams): UseRenderEngineResult;
-export {};
+export declare function useRenderEngine(p: UseRenderEngineParams): void;

package/types/interfaces/ICoordinateTransformer.d.ts

@@ -102,4 +102,3 @@ export declare class LiveTransformer {
     private _pctPriceToY;
     private _pctYToPrice;
 }
-export type TransformedDrawHook = (ctx: CanvasRenderingContext2D, transformer: LiveTransformer) => void;

package/types/interfaces/plugins/IChartPlugin.d.ts

@@ -4,13 +4,15 @@
  * ChartPlugin and is installed through PluginContext.
  */
 import type { TypedEventBus, InterceptableEvent, Interceptor } from '../../core/TypedEventBus';
-import type { RenderEngine, DrawHook } from '../../core/RenderEngine';
+import type { RenderEngine, DrawHook, DrawPhase } from '../../core/RenderEngine';
 import type { ExecutionEngine } from '../../core/ExecutionEngine';
 import type { GlobalChartBus } from '../../core/GlobalChartBus';
 import type { LiveTransformer } from '../ICoordinateTransformer';
+import type { ChartColors } from '../../lib/types/chart-settings';
 import type { DataLevel, OhlcvBar, SymbolInfo, TickEvent } from '../IDataAdapter';
 import type { SerialTrade, PriceHistory } from '../../lib/types';
 import type { FootprintBar } from '../../lib/types/footprint';
+import type { BarStore } from '../../core/BarStore';
 import type { BracketAmendment } from '../../lib/types/trading-types';
 import type { PlaceOrderRequest } from '../../lib/matchingEngine';
 import type { CommandDef, CvarDef } from '../../console/Console';
@@ -54,8 +56,16 @@ export interface ContextMenuItem {
 export interface ThemeDef {
     id: string;
     name: string;
+    /** Dark surfaces or light ones - what `onThemeChange` reports. Defaults to dark. */
+    dark?: boolean;
     /** CSS variables to inject - keys are var names without the leading '--'. */
     vars: Record<string, string>;
+    /**
+     * Canvas colors: candles, grid, background, crosshair and the rest. Each one
+     * only applies where the user hasn't picked their own; leave a key out to keep
+     * the default.
+     */
+    chart?: Partial<ChartColors>;
 }
 export type SettingSchemaType = 'number' | 'string' | 'boolean' | 'color' | 'select';
 export interface SettingSchema {
@@ -94,6 +104,13 @@ export interface PluginSchedule {
     timeout(ms: number, fn: () => void): () => void;
     /** Managed animation-frame callback - auto-cancelled on plugin teardown. */
     raf(fn: () => void): () => void;
+    /**
+     * Repeating animation loop, at most `fps` a second, 0 = every frame. Skips frames
+     * while the chart is off screen; the first frame back gets one interval as `dt`.
+     * `time` is the raf timestamp, `dt` the ms since the last call. Auto-cancelled on
+     * plugin teardown.
+     */
+    frames(fps: number, fn: (time: number, dt: number) => void): () => void;
 }
 export type NotifyLevel = 'info' | 'success' | 'warn' | 'error';
 export interface NotifyOptions {
@@ -124,7 +141,7 @@ export interface PluginExecutionSurface {
 export interface PluginLifecycle {
     onSymbolChange(cb: (symbol: string) => void): () => void;
     onTimeframeChange(cb: (tf: string) => void): () => void;
-    onThemeChange(cb: (theme: 'light' | 'dark') => void): () => void;
+    onThemeChange(cb: (mode: 'light' | 'dark', theme: ThemeDef) => void): () => void;
     onFocus(cb: (id: number) => void): () => void;
     onBlur(cb: () => void): () => void;
 }
@@ -136,7 +153,17 @@ export interface PluginDataSnapshot {
     trades: SerialTrade[];
     footprintBars: FootprintBar[];
     priceHistory: PriceHistory[];
-    /** Always present - synthesised from footprintBars when dataLevel is l3/tick. */
+    /**
+     * Every loaded bar, as columns: `bars.close[i]`. Always present - synthesised
+     * from footprintBars when dataLevel is l3/tick. Read the columns off it each
+     * time; they're swapped as bars load. It's the store the chart draws from so
+     * read it, don't change it. `clone()` it for a copy of your own.
+     */
+    bars: BarStore;
+    /**
+     * `bars` as objects, built on first read and kept until the bars change.
+     * @deprecated ~176 bytes a bar and a full copy - use `bars`.
+     */
     ohlcvBars: OhlcvBar[];
     /** Populated when dataLevel is tick or l3. */
     ticks: TickEvent[];
@@ -181,7 +208,7 @@ export interface PluginContext {
      * data has arrived.
      *
      * This is the one you want for "what is the price right now". The last entry
-     * of `getData().ohlcvBars` is the last bar that was *loaded*, which during
+     * of `getData().bars` is the last bar that was *loaded*, which during
      * replay is somewhere in the future and at the fetch resolution rather than
      * the charted timeframe.
      *
@@ -193,7 +220,7 @@ export interface PluginContext {
     registerPanel(id: string, element: React.ReactNode, title?: string, visible?: boolean): () => void;
     getSettings<T>(defaults: T): T;
     saveSettings<T>(patch: Partial<T>): void;
-    addOverlay(phase: 'before-base' | 'after-base' | 'after-ui', hook: DrawHook): () => void;
+    addOverlay(phase: DrawPhase, hook: DrawHook): () => void;
     registerToolbarItem(item: ToolbarItem): () => void;
     registerBottomBarItem(id: string, render: () => React.ReactNode): BottomBarHandle;
     registerContextMenuItem(item: ContextMenuItem): () => void;

package/types/interfaces/plugins/IDrawingPlugin.d.ts

@@ -11,7 +11,7 @@
 import type { ChartPlugin } from './IChartPlugin';
 import type { Anchor } from '../../lib/types/drawing-types';
 import type { PluginDrawingRenderContext, PluginDrawingHitContext } from '../../core/DrawingRegistry';
-import type { OhlcvBar } from '../IDataAdapter';
+import type { BarStore } from '../../core/BarStore';
 export interface Point {
     x: number;
     y: number;
@@ -54,7 +54,7 @@ export interface DrawingPlugin extends ChartPlugin {
     /**
      * Optionally snap an anchor to the nearest bar OHLC value during placement.
      */
-    snap?(anchor: Anchor, bars: OhlcvBar[]): Anchor;
+    snap?(anchor: Anchor, bars: BarStore): Anchor;
     /** Serialise anchor positions to a JSON-safe value for persistence. */
     serialize(anchors: Anchor[]): unknown;
     /** Restore anchors from a previously serialised value. */

package/types/lib/matchingEngine.d.ts

@@ -3,6 +3,7 @@ import type { Order, Fill, Position, BracketLevel, BracketAmendment, PriceTick,
 import type { MboEvent, PriceHistory } from './types';
 import type { OhlcvBar, SymbolInfo } from '../interfaces/IDataAdapter';
 import type { SerialTrade } from './types';
+import { BarStore } from '../core/BarStore';
 import { TypedEventBus } from '../core';
 export declare function sanitizeMetadata(meta: Record<string, unknown> | undefined, symbol: string, quantity: number, symbolInfo?: SymbolInfo | null): Record<string, unknown>;
 export interface FeeSchedule {
@@ -78,12 +79,12 @@ export interface L3MatchingEngine {
     /** L3 path: ingest a compact buffer and then use seekTo to replay. */
     ingestCompactBuf: (buf: ArrayBuffer) => void;
     /** OHLCV path: ingest bars; seekTo advances bar by bar. Resets the replay cursor. */
-    ingestOhlcvBars: (bars: OhlcvBar[], barNs?: bigint) => void;
+    ingestOhlcvBars: (bars: OhlcvBar[] | BarStore, barNs?: bigint) => void;
     /**
      * OHLCV path: extend the buffer forward without rewinding the replay.
      * What a stream-append must use - see appendOhlcvBars for why.
      */
-    appendOhlcvBars: (bars: OhlcvBar[], barNs?: bigint) => void;
+    appendOhlcvBars: (bars: OhlcvBar[] | BarStore, barNs?: bigint) => void;
     /** OHLCV path: ingest finer-resolution bars so seekTo uses accurate mark prices within the open bar. */
     ingestSupplementalBars?: (bars: Array<{
         time: number;

package/types/lib/renderers/renderer.d.ts

@@ -6,6 +6,7 @@ import { ChartSettings } from '../types/chart-settings';
 import { ActiveDrawingTool, DraftDrawing, Drawing, DrawingAnchorId } from '../types/drawing-types';
 import { AccountSnapshot, DataLevel, LiveTransformer, OhlcvBar, SymbolInfo } from '../../core';
 import { SessionMapper } from '../../core/SessionMapper';
+import type { BarStore } from '../../core/BarStore';
 import { PriceTransition } from '../priceTransition';
 import { OrdinalModel } from '../series/japaneseCharts';
 import type { CrosshairSync } from '../types/layout-sync';
@@ -22,17 +23,6 @@ export type Crosshair = {
 export declare const Y_AXIS_WIDTH = 65;
 export declare const X_AXIS_HEIGHT = 30;
 export declare const TRADE_SNAP_RADIUS = 12;
-export declare const COLORS: {
-    background: string;
-    buyLine: string;
-    sellLine: string;
-    grid: string;
-    label: string;
-    axisBg: string;
-    crosshair: string;
-    crosshairBg: string;
-    crosshairText: string;
-};
 export declare function computeRightScaleWidth(bounds: ViewBounds, symbolInfo: SymbolInfo | undefined, chartSettings: ChartSettings, hidePriceScale?: boolean, ctx?: CanvasRenderingContext2D | null): number;
 export declare function drawBaseLayer(canvas: HTMLCanvasElement, panes: ChartPane[], layouts: Record<string, Rect>, indicators: Indicator[], trades: TradePoint[], priceHistory: PriceHistory[], snapshots: BookSnapshot[], bounds: ViewBounds, footprintBars: FootprintBar[], heatmapBitmap: ImageBitmap | null, bitmapOffsetX: number, bitmapOffsetY: number, bitmapOffsetW: number, bitmapOffsetH: number, barNs: bigint, chartSettings: ChartSettings, horizon: bigint, candleCache: CandleCache | null, 
 /** Live incrementally-built open bar - overrides the cache for the current bucket. */
@@ -42,22 +32,8 @@ openBar: {
     high: number;
     low: number;
     close: number;
-} | null, ohlcvBars: {
-    time: number;
-    open: number;
-    high: number;
-    low: number;
-    close: number;
-    volume: number;
-}[], transformer: LiveTransformer, isPluginChartType?: boolean, sessionMapper?: SessionMapper, dataLevel?: DataLevel, hidePriceScale?: boolean, hideTimeScale?: boolean, symbolInfo?: SymbolInfo, rightScaleWidth?: number): void;
-export declare function drawUILayer(canvas: HTMLCanvasElement, priceHistory: PriceHistory[], trades: TradePoint[], bounds: ViewBounds, crosshair: Crosshair, showTooltip: boolean, selectedTrade: TradePoint | null, panes: ChartPane[], layouts: Record<string, Rect>, indicators: Indicator[], hoveredDividerIdx: number, hoveringLegend: boolean, barNs: bigint, chartSettings: ChartSettings, horizon: bigint, candleCache: CandleCache | null, ohlcvBars: {
-    time: number;
-    open: number;
-    high: number;
-    low: number;
-    close: number;
-    volume: number;
-}[], openBar: OhlcvBar, tradeLines: TradeLine[], tradeLineInteraction: any, hoveredLineId?: string | null, draggingLineId?: string | null, activeTool?: ActiveDrawingTool | null, draggingAnchor?: {
+} | null, ohlcvBars: BarStore, transformer: LiveTransformer, isPluginChartType?: boolean, sessionMapper?: SessionMapper, dataLevel?: DataLevel, hidePriceScale?: boolean, hideTimeScale?: boolean, symbolInfo?: SymbolInfo, rightScaleWidth?: number): void;
+export declare function drawUILayer(canvas: HTMLCanvasElement, priceHistory: PriceHistory[], trades: TradePoint[], bounds: ViewBounds, crosshair: Crosshair, showTooltip: boolean, selectedTrade: TradePoint | null, panes: ChartPane[], layouts: Record<string, Rect>, indicators: Indicator[], hoveredDividerIdx: number, hoveringLegend: boolean, barNs: bigint, chartSettings: ChartSettings, horizon: bigint, candleCache: CandleCache | null, ohlcvBars: BarStore, openBar: OhlcvBar, tradeLines: TradeLine[], tradeLineInteraction: any, hoveredLineId?: string | null, draggingLineId?: string | null, activeTool?: ActiveDrawingTool | null, draggingAnchor?: {
     drawingId: string;
     anchor: DrawingAnchorId;
 } | null, holdingCtrl?: boolean | null, holdingShift?: boolean | null, footprintBars?: FootprintBar[] | null, drawings?: Drawing[] | null, draft?: DraftDrawing | null, transformer?: LiveTransformer, showShiftInfo?: boolean, shiftInfoAnchor?: {
@@ -76,15 +52,9 @@ export declare function drawHeatmap(ctx: CanvasRenderingContext2D, snapshots: Bo
 export declare function nearestIndex(priceHistory: PriceHistory[], target: bigint): number;
 export declare function nearestTradeIndex(trades: TradePoint[], target: bigint): number;
 export declare function findNearestTrade(clickX: number, clickY: number, trades: TradePoint[], bounds: ViewBounds, chartW: number, chartH: number, chartSettings: ChartSettings, horizon: bigint, transformer: LiveTransformer): TradePoint | null;
+export declare function drawBackground(ctx: CanvasRenderingContext2D, cssW: number, cssH: number, chartSettings: ChartSettings): void;
 export declare const snapTs: (ts: bigint, tf: bigint, sessionMapper?: SessionMapper | null) => bigint;
-export declare const snapPrice: (snappedTs: bigint, rawPrice: number, chartSettings: ChartSettings, footprintBars: FootprintBar[], priceHistory: PriceHistory[], ohlcvBars: {
-    time: number;
-    open: number;
-    high: number;
-    low: number;
-    close: number;
-    volume: number;
-}[], dataLevel: DataLevel, horizon: bigint) => number;
+export declare const snapPrice: (snappedTs: bigint, rawPrice: number, chartSettings: ChartSettings, footprintBars: FootprintBar[], priceHistory: PriceHistory[], ohlcvBars: BarStore, dataLevel: DataLevel, horizon: bigint) => number;
 export declare function drawTooltip(ctx: CanvasRenderingContext2D, mouse: {
     x: number;
     y: number;
@@ -97,10 +67,7 @@ export declare function isOrdinalChartType(t: ChartType): boolean;
  * (column timestamps) and autoscale (visible price extent), so all three derive
  * from one build.
  */
-export declare function getOrdinalModel(chartType: ChartType, chartSettings: ChartSettings, ohlcvBars: {
-    time: number;
-    close: number;
-}[] | undefined, candleCache: CandleCache | null, trades: TradePoint[], barNs: bigint): OrdinalModel | null;
+export declare function getOrdinalModel(chartType: ChartType, chartSettings: ChartSettings, ohlcvBars: BarStore | undefined, candleCache: CandleCache | null, trades: TradePoint[], barNs: bigint): OrdinalModel | null;
 /**
  * Price extent of the columns currently visible under the transformer's view -
  * used to auto-scale the y-axis for ordinal charts (whose prices live in the

package/types/lib/types/chart-settings.d.ts

@@ -42,6 +42,9 @@ export type ChartSettings = {
     gridVerticalColor: string;
     crosshairMode: 'normal' | 'magnet' | 'hidden';
     crosshairColor: string;
+    /** The time and price boxes on the crosshair. */
+    crosshairLabelColor: string;
+    crosshairLabelTextColor: string;
     crosshairWidth: number;
     crosshairDash: number[];
     showBreaks: boolean;
@@ -56,8 +59,16 @@ export type ChartSettings = {
     statusLineFontSize: number;
     backgroundColor: string;
     axisBackgroundColor: string;
+    /** Tick labels on the price and time axis. */
+    axisTextColor: string;
+    /** The line between the plot and the axes. */
+    axisBorderColor: string;
+    /** Text on the colored price pills on the price axis. */
+    priceLabelTextColor: string;
     showBidLine: boolean;
     showAskLine: boolean;
+    bidLineColor: string;
+    askLineColor: string;
     showMidLine: boolean;
     showLastTradeLine: boolean;
     showFills: boolean;
@@ -89,3 +100,8 @@ export declare const DEFAULT_CHART_SETTINGS: ChartSettings;
 export declare function diffChartSettings(settings: ChartSettings): Partial<ChartSettings>;
 /** Re-expand a settings diff back onto the current defaults. */
 export declare function mergeChartSettings(diff?: Partial<ChartSettings>): ChartSettings;
+/** The settings a theme can color. */
+export declare const CHART_COLOR_KEYS: readonly ["upBodyColor", "downBodyColor", "upWickColor", "downWickColor", "upBorderColor", "downBorderColor", "gridHorizontalColor", "gridVerticalColor", "crosshairColor", "crosshairLabelColor", "crosshairLabelTextColor", "breaksColor", "backgroundColor", "axisBackgroundColor", "axisTextColor", "axisBorderColor", "priceLabelTextColor", "bidLineColor", "askLineColor", "heatmapColorBid", "heatmapColorAsk", "priceLineColor", "sessionHighlightColor"];
+export type ChartColorKey = (typeof CHART_COLOR_KEYS)[number];
+export type ChartColors = Pick<ChartSettings, ChartColorKey>;
+export declare function themedSettings(settings: ChartSettings, colors?: Partial<ChartColors>): ChartSettings;