@christtrade/depth 0.18.0 → 0.20.0

package/types/core/DataEngine.d.ts

@@ -1,4 +1,5 @@
 import { TypedEventBus } from './TypedEventBus';
+import { BarStore } from './BarStore';
 import type { IDataAdapter, SymbolInfo, DataLevel, OhlcvBar, TickEvent } from '../interfaces/IDataAdapter';
 import type { FootprintOptions } from '../lib/types/footprint';
 import type { SerialTrade } from '../lib/types';
@@ -32,7 +33,17 @@ export interface ChartDataSnapshot {
     readonly trades: SerialTrade[];
     readonly footprintBars: FootprintBar[];
     readonly priceHistory: PriceHistory[];
-    /** Populated for ohlcv; derived from footprintBars for l3/tick; empty for l2. */
+    /**
+     * Every loaded bar, at the fetch resolution. Populated for ohlcv, derived
+     * from footprintBars for l3/tick, empty for l2. Read the columns off it each
+     * time - see `BarStore`. It's the store the chart draws from, so read it and
+     * don't change it. `clone()` it for your own copy.
+     */
+    readonly 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`.
+     */
     readonly ohlcvBars: OhlcvBar[];
     /** Populated for tick and l3 (derived from trades). */
     readonly ticks: TickEvent[];
@@ -71,7 +82,7 @@ export declare class DataEngine {
         trades: SerialTrade[];
         priceHistory: PriceHistory[];
         footprintBars: FootprintBar[];
-        ohlcvBars: OhlcvBar[];
+        ohlcvBars: BarStore;
         barNs: bigint;
         dataStart: number;
         dataEnd: number;
@@ -128,6 +139,8 @@ export declare class DataEngine {
         hasMore: boolean;
         coveredTo: bigint | null;
     }>;
+    private readonly _arrays;
+    private readonly _barsAsArray;
     getSnapshot(): ChartDataSnapshot;
     destroy(): void;
     private _fetchForward;

package/types/core/DepthChart.d.ts

@@ -10,7 +10,7 @@ import { ExecutionEngine } from './ExecutionEngine';
 import type { FillSearchOptions } from '../lib/matchingEngine';
 import { LiveTransformer } from '../interfaces/ICoordinateTransformer';
 import { BottomBarItem, ChartPlugin, InstalledPlugin, PluginType, ToolbarItem } from './PluginRegistry';
-import { RenderEngine } from './RenderEngine';
+import { RenderEngine, type DrawHook, type DrawPhase } from './RenderEngine';
 import { ChartEvents, TypedEventBus } from './TypedEventBus';
 import { ChartState } from './ChartState';
 import type { SyncInLayout } from '../lib/types/layout-sync';
@@ -18,6 +18,8 @@ import { ChartModel, type ChartPaneState } from './ChartModel';
 import { DrawingStore } from './DrawingStore';
 import { ChartPane, Indicator } from '../lib/types/indicator-types';
 import { AccountManager, LedgerAdjustment, LedgerFill, LedgerOrder, LedgerPosition, type AccountSaveState } from './AccountManager';
+import type { ThemeDef } from '../interfaces/plugins/IChartPlugin';
+import type { StyleField } from '../components/drawings/drawing-settings-dialog';
 import { PlaybackMode, type PrefetchOptions } from '../hooks/usePlaybackEngine';
 import { type ChartPreferences } from '../lib/storage';
 import { type PluginCatalogEntry, type PluginStartupEntry, type PluginStartupRecord } from './plugin-startup';
@@ -101,6 +103,8 @@ export interface ChartOptions {
      */
     restore?: ChartSaveState;
     toolbar?: (chart: DepthChart) => React.ReactNode[];
+    /** Theme id to start on. Register custom ones with `chart.registerTheme()` first. */
+    theme?: string;
 }
 /** Bump when the save document shape changes incompatibly; handled in migrate(). */
 export declare const SAVE_VERSION = 1;
@@ -175,12 +179,15 @@ export declare class DepthChart {
     private readonly options;
     readonly id: string;
     readonly eventBus: TypedEventBus;
+    private readonly _themes;
+    private readonly _themeStyle;
     readonly executionEngine: ExecutionEngine;
     private readonly dataEngine;
     readonly transformer: LiveTransformer;
     private features;
     private readonly pluginRegistry;
-    private _renderEngine;
+    private readonly _engines;
+    private _pluginRenderEngine;
     private _panelRegistry;
     private _toolbarRegistry;
     private _bottomBarRegistry;
@@ -192,9 +199,11 @@ export declare class DepthChart {
     private registeredPlugins;
     private _pluginStateListeners;
     private _pluginCatalog;
+    private _panesRestored;
     private playbackController;
     private readonly playbackStateRegistry;
     private readonly pluginSchedules;
+    private readonly extensionParams;
     readonly state: ChartState;
     private readonly _panes;
     readonly drawingStore: DrawingStore;
@@ -218,14 +227,14 @@ export declare class DepthChart {
      * The bar still being built at the playback horizon, on the focused pane, or
      * `null` before any data has arrived.
      *
-     * Unlike the tail of `getData().ohlcvBars` - which is the last bar that was
+     * Unlike the last of `getData().bars` - which is the last bar that was
      * *loaded*, at the fetch resolution and possibly past the horizon - this is
      * the candle the chart is actually drawing on the right edge.
      */
     openBar(): OhlcvBar | null;
     /** What the chart holds for the active symbol - the same snapshot a plugin's `ctx.getData()` returns. */
     getData(): ChartDataSnapshot;
-    /** The paint loop, once a pane has mounted one. */
+    /** The focused cell's paint loop, once a cell has mounted one. Every cell's: `getRenderEngines()`. */
     get renderEngine(): RenderEngine | null;
     getMaxLookbackBars(): number;
     horizon(): number;
@@ -402,6 +411,7 @@ export declare class DepthChart {
      * document decide again.
      */
     setPluginStartup(id: string, entry: Partial<PluginStartupEntry> | null): this;
+    private _deactivateRemoved;
     /**
      * Install what this session should open with: every plugin a restored pane
      * references, plus every plugin marked autostart. Idempotent - already-loaded
@@ -438,6 +448,18 @@ export declare class DepthChart {
      * set of ids actually changes - pane models notify on unrelated churn (axis
      * drags rewrite settings every frame) that callers shouldn't re-render on.
      */
+    /**
+     * The settings a loaded extension declared with `params`, and their current
+     * values. Null when it declared none. A script holding several extensions
+     * gets one combined set.
+     */
+    getExtensionParams(id: string): {
+        schema: StyleField[];
+        defaults: Record<string, unknown>;
+        values: Record<string, unknown>;
+    } | null;
+    /** Save some of an extension's params, and hand the new values to the extension. */
+    setExtensionParams(id: string, patch: Record<string, unknown>): void;
     onPluginStateChange(cb: (state: {
         installed: Set<string>;
         active: Set<string>;
@@ -454,11 +476,33 @@ export declare class DepthChart {
         visible: boolean;
     }>;
     getToolbarRegistry(): ReadonlyMap<string, ToolbarItem>;
+    /** The theme the chart is on. */
+    getTheme(): ThemeDef;
+    /** Every theme it can switch to, built-in and registered. */
+    getThemes(): ThemeDef[];
+    /**
+     * Switch theme. Emits `theme:change`. False for an id that isn't registered,
+     * and the chart stays where it was.
+     */
+    setTheme(id: string): boolean;
+    /**
+     * Add a theme, or replace one with the same id. Returns the unregister - if
+     * the chart is on that theme, it falls back to the default.
+     */
+    registerTheme(theme: ThemeDef): () => void;
     getBottomBarRegistry(): ReadonlyMap<string, BottomBarItem>;
     attachRenderEngine(engine: RenderEngine): void;
+    /** Every cell's paint loop, by cell id. */
+    getRenderEngines(): ReadonlyMap<number, RenderEngine>;
+    /**
+     * Draw on every cell, including cells that mount later - a layout switch
+     * keeps the overlay on all of them. Returns the remove.
+     */
+    addOverlay(phase: DrawPhase, hook: DrawHook): () => void;
+    private get pluginRenderEngine();
     /**
-     * Snapshot of the chart with every layer composited (base, drawings, UI).
-     * Returns null until the render engine has attached.
+     * Snapshot of the focused cell with every layer composited (base, drawings, UI).
+     * Returns null until a render engine has attached.
      */
     screenshot(): HTMLCanvasElement | null;
     private _focusedCellId;

package/types/core/ExecutionEngine.d.ts

@@ -6,6 +6,7 @@ import type { BracketAmendment, Order, Position } from '../lib/types/trading-typ
 import type { MboEvent, PriceHistory } from '../lib/types';
 import type { OhlcvBar } from '../interfaces/IDataAdapter';
 import type { SerialTrade } from '../lib/types';
+import { BarStore } from './BarStore';
 /**
  * Vetoes an order before it reaches a book. Return a reason to refuse it, or
  * null to let it through. Pre-trade risk lives here rather than in the caller,
@@ -58,8 +59,8 @@ export declare class ExecutionEngine {
     private targetFor;
     private eachBuiltIn;
     ingestCompactBuf(buf: ArrayBuffer, symbol?: string): void;
-    ingestOhlcvBars(bars: OhlcvBar[], barNs?: bigint, symbol?: string): void;
-    appendOhlcvBars(bars: OhlcvBar[], barNs?: bigint, symbol?: string): void;
+    ingestOhlcvBars(bars: OhlcvBar[] | BarStore, barNs?: bigint, symbol?: string): void;
+    appendOhlcvBars(bars: OhlcvBar[] | BarStore, barNs?: bigint, symbol?: string): void;
     ingestSupplementalBars(bars: Array<{
         time: number;
         open: number;

package/types/core/PluginSchedule.d.ts

@@ -2,14 +2,25 @@ export interface PluginSchedule {
     interval(ms: number, fn: () => void): () => void;
     timeout(ms: number, fn: () => void): () => void;
     raf(fn: () => void): () => void;
+    frames(fps: number, fn: (time: number, dt: number) => void): () => void;
 }
 export declare class PluginScheduleImpl implements PluginSchedule {
+    private readonly getElements;
     private readonly intervals;
     private readonly timeouts;
     private readonly rafIds;
+    private readonly frameLoops;
     private destroyed;
+    private observer;
+    private readonly observed;
+    private readonly visible;
+    /** `getElements` - every cell the plugin draws on. Frames run while any is on screen */
+    constructor(getElements?: () => readonly Element[]);
+    private get onScreen();
     interval(ms: number, fn: () => void): () => void;
     timeout(ms: number, fn: () => void): () => void;
     raf(fn: () => void): () => void;
+    frames(fps: number, fn: (time: number, dt: number) => void): () => void;
+    private watchVisibility;
     destroy(): void;
 }

package/types/core/RenderEngine.d.ts

@@ -3,16 +3,36 @@ import type { ChartPane, Rect } from '../lib/types/indicator-types';
 import type { Indicator } from '../lib/types/indicator-types';
 import type { TradePoint, PriceHistory, ViewBounds } from '../lib/types';
 import type { FootprintBar } from '../lib/types/footprint';
-import type { ChartSettings } from '../lib/types/chart-settings';
+import { type ChartColors, type ChartSettings } from '../lib/types/chart-settings';
 import type { Crosshair } from '../lib/renderers/renderer';
 import type { Drawing, DraftDrawing, DrawingAnchorId, ActiveDrawingTool } from '../lib/types/drawing-types';
 import type { TradeLine } from '../lib/types';
 import { LiveTransformer } from '../interfaces/ICoordinateTransformer';
 import { ChartTypePlugin } from './PluginRegistry';
 import { SessionMapper } from './SessionMapper';
+import type { BarStore } from './BarStore';
 import { AccountSnapshot, DataLevel, SymbolInfo } from '.';
 import type { CrosshairSync } from '../lib/types/layout-sync';
-export type DrawHook = (ctx: CanvasRenderingContext2D, view: ViewBounds, transformer: LiveTransformer) => void;
+/** Layout of the frame a draw hook runs in. Everything in css px */
+export interface DrawInfo {
+    width: number;
+    height: number;
+    dpr: number;
+    /** The main plot - the canvas minus the price and time axis */
+    plot: Rect;
+    /** Every panes box by id, `main` included */
+    panes: Readonly<Record<string, Rect>>;
+    /** The resolved background color */
+    background: string;
+    /** `performance.now()` at the start of the frame */
+    time: number;
+    /** The layout cell being painted - a hook runs once per cell */
+    cell: number;
+    /** Whether that cell is the focused one */
+    focused: boolean;
+}
+export type DrawHook = (ctx: CanvasRenderingContext2D, view: ViewBounds, transformer: LiveTransformer, info: DrawInfo) => void;
+export type DrawPhase = 'before-base' | 'after-background' | 'after-base' | 'after-ui';
 export interface DrawParams {
     panes: ChartPane[];
     layouts: Record<string, Rect>;
@@ -32,15 +52,7 @@ export interface DrawParams {
     horizon: bigint;
     candleCache: Map<bigint, any> | null;
     openBar: FootprintBar | null;
-    /** Bars to render as candles - OHLCV adapter data or loading-preview bars. */
-    ohlcvBars: {
-        time: number;
-        open: number;
-        high: number;
-        low: number;
-        close: number;
-        volume: number;
-    }[];
+    ohlcvBars: BarStore;
     crosshair: Crosshair | null;
     drawings: Drawing[];
     draft: DraftDrawing | null;
@@ -95,11 +107,17 @@ export interface DrawParams {
     syncCrosshair: CrosshairSync | null;
 }
 export declare class RenderEngine {
+    private readonly backgroundCanvas;
     private readonly baseCanvas;
     private readonly drawingsCanvas;
     private readonly uiCanvas;
     private readonly eventBus;
     private readonly chartId;
+    /** The layout cell this engine paints */
+    get cellId(): number;
+    private focused;
+    /** Set by the chart. Repaints if there are hooks, they might draw differently on the focused cell */
+    setFocused(focused: boolean): void;
     private rafId;
     /** The element the canvases sit in, for overlays that want to draw over the chart without touching it */
     get container(): HTMLElement | null;
@@ -115,10 +133,14 @@ export declare class RenderEngine {
         maxMs: number;
     };
     private dirty;
+    private paintedBackgroundColor;
     private beforeBaseDraw;
+    private afterBackgroundDraw;
     private afterBaseDraw;
     private afterUIDraw;
     private drawParams;
+    private rawDrawParams;
+    private themeColors;
     private view;
     private readonly priceTransition;
     private resizeObserver;
@@ -129,11 +151,18 @@ export declare class RenderEngine {
     private readonly onDprChange;
     private watchDpr;
     private startLoop;
-    markDirty(layer: 'base' | 'drawings' | 'ui'): void;
+    markDirty(layer: 'background' | 'base' | 'drawings' | 'ui'): void;
     markAllDirty(): void;
     setDrawParams(params: DrawParams): void;
+    /** Set by the chart. Colors the user didn't pick come from here. */
+    setThemeColors(colors: Partial<ChartColors> | undefined): void;
     setView(v: ViewBounds): void;
     getView(): ViewBounds | null;
+    /** The transformer this cell paints with, once it has drawn */
+    get transformer(): LiveTransformer | null;
+    private doBackgroundRedraw;
+    private readonly failedHooks;
+    private runHooks;
     private doBaseRedraw;
     /**
      * Draws the ChristTrade banner into the base layer, in the same pass that
@@ -146,15 +175,16 @@ export declare class RenderEngine {
     private drawAttribution;
     private doDrawingsRedraw;
     private doUIRedraw;
-    addDrawHook(phase: 'before-base' | 'after-base' | 'after-ui', hook: DrawHook): () => void;
+    addDrawHook(phase: DrawPhase, hook: DrawHook): () => void;
     private handleResize;
     private flushSync;
     toDataURL(type?: string): string;
     /**
-     * All three layers flattened onto a fresh canvas, in paint order. Use this
+     * Every layer flattened onto a fresh canvas, in paint order. Use this
      * rather than `toDataURL` when the snapshot should include the drawings and
      * the crosshair/UI layer.
      */
     captureComposite(): HTMLCanvasElement;
+    private flatten;
     destroy(): void;
 }

package/types/core/ThemeRegistry.d.ts

@@ -0,0 +1,18 @@
+import type { ThemeDef } from '../interfaces/plugins/IChartPlugin';
+import type { TypedEventBus } from './TypedEventBus';
+import { BASE_DARK_VARS, BUILTIN_THEMES } from './builtin-themes';
+export { BASE_DARK_VARS, BUILTIN_THEMES };
+export declare const DEFAULT_THEME_ID = "dark";
+export declare class ThemeRegistry {
+    private readonly bus;
+    private readonly themes;
+    private currentId;
+    constructor(bus: TypedEventBus, builtins?: readonly ThemeDef[], initial?: string);
+    get current(): ThemeDef;
+    get(id: string): ThemeDef | undefined;
+    list(): ThemeDef[];
+    /** Same id replaces, so a hot-reloaded theme updates in place. Returns the unregister. */
+    register(theme: ThemeDef): () => void;
+    /** False for an unknown id. Setting the current theme again does nothing. */
+    set(id: string): boolean;
+}

package/types/core/TypedEventBus.d.ts

@@ -8,6 +8,8 @@ import { IExecutionAdapter } from '../interfaces/IExecutionAdapter';
 import { ActiveDrawingTool, Anchor, Drawing } from '../lib/types/drawing-types';
 import { TradeLineHitMap } from '../lib/renderers/drawTradeLines';
 import type { TradeLine } from '../lib/types';
+import type { StyleField } from '../components/drawings/drawing-settings-dialog';
+import type { ThemeDef } from '../interfaces/plugins/IChartPlugin';
 import { FootprintBar } from '../lib/types/footprint';
 import { ChartPane, Indicator } from '../lib/types/indicator-types';
 import { SerialTrade } from '../lib/types';
@@ -16,6 +18,7 @@ import { Fill, Order, Position, PositionClose, TradingEvent } from '../lib/types
 import { PriceHistory, TradePoint, type ViewBounds } from '../lib/types';
 import { BottomBarItem, ChartTypePlugin, ToolbarItem } from './PluginRegistry';
 import { RenderEngine } from './RenderEngine';
+import type { BarStore } from './BarStore';
 import { PlaybackMode } from '../hooks/usePlaybackEngine';
 import type { CrosshairSync, TimeRangeSync } from '../lib/types/layout-sync';
 import type { PlaceOrderRequest } from '../lib/matchingEngine';
@@ -69,7 +72,8 @@ export interface ChartEvents {
         old: string;
         new: string;
     };
-    'theme:change': 'light' | 'dark';
+    'theme:change': ThemeDef;
+    'theme:list': ThemeDef[];
     'chart:focused': {
         id: number;
     };
@@ -122,14 +126,7 @@ export interface ChartEvents {
             volume: number;
             delta: number;
         }> | null;
-        bars: {
-            time: number;
-            open: number;
-            high: number;
-            low: number;
-            close: number;
-            volume: number;
-        }[];
+        bars: BarStore;
         openBar: FootprintBar;
         horizon: bigint;
         dataLevel: DataLevel;
@@ -177,7 +174,8 @@ export interface ChartEvents {
         trades: SerialTrade[];
         priceHistory: PriceHistory[];
         footprintBars: FootprintBar[];
-        ohlcvBars: OhlcvBar[];
+        /** Every loaded bar. Derived from footprintBars at l3/tick, empty at l2. */
+        bars: BarStore;
         barNs: bigint;
         dataStart: number;
         dataEnd: number;
@@ -217,7 +215,10 @@ export interface ChartEvents {
         trades: SerialTrade[];
         priceHistory: PriceHistory[];
         footprintBars: FootprintBar[];
+        /** This chunk's new bars at ohlcv, empty at every other level. */
         ohlcvBars: OhlcvBar[];
+        /** Every loaded bar, this chunk included. */
+        bars: BarStore;
         barNs: bigint;
         dataStart: number;
         dataEnd: number;
@@ -262,7 +263,10 @@ export interface ChartEvents {
         trades: SerialTrade[];
         priceHistory: PriceHistory[];
         footprintBars: FootprintBar[];
+        /** This page's new bars at ohlcv, empty at every other level. */
         ohlcvBars: OhlcvBar[];
+        /** Every loaded bar, this page included. */
+        bars: BarStore;
         barNs: bigint;
         dataStart: number;
         viewMin: bigint;
@@ -373,6 +377,9 @@ export interface ChartEvents {
     'render-engine:ready': {
         engine: RenderEngine;
     };
+    'render-engine:destroyed': {
+        engine: RenderEngine;
+    };
     /**
      * A cell handing over its forming-bar getter. The bar mutates in place, so
      * this is a getter and not a value - read it, dont keep it. `get: null`
@@ -594,6 +601,16 @@ export interface ChartEvents {
         id: string;
         params: Record<string, unknown>;
     };
+    'plugin:extension-params': {
+        id: string;
+        entry: string;
+        schema: StyleField[] | null;
+        defaults: Record<string, unknown>;
+    };
+    'plugin:extension-params-change': {
+        id: string;
+        values: Record<string, unknown>;
+    };
     /** @console command */
     'plugin:strategy-range': {
         id: string;

package/types/core/builtin-themes.d.ts

@@ -0,0 +1,7 @@
+import type { ThemeDef } from '../interfaces/plugins/IChartPlugin';
+/**
+ * What every built-in dark theme starts from. Spread it and override what's
+ * different: `vars: { ...BASE_DARK_VARS, primary: '207 82% 66%' }`.
+ */
+export declare const BASE_DARK_VARS: Readonly<Record<string, string>>;
+export declare const BUILTIN_THEMES: readonly ThemeDef[];

package/types/core/index.d.ts

@@ -10,6 +10,7 @@ export type { DepthProps } from '../ChartOuter';
 export { ExecutionEngine } from './ExecutionEngine';
 export { DataEngine } from './DataEngine';
 export type { DataEngineConfig, ChartDataSnapshot } from './DataEngine';
+export { BarStore } from './BarStore';
 export { TypedEventBus } from './TypedEventBus';
 export type { ChartEvents } from './TypedEventBus';
 export type { AuditResult, AuditFnEntry } from './script-audit';
@@ -18,7 +19,7 @@ export type { DrawParams } from './RenderEngine';
 export type { IDataAdapter, DataLevel, TickEvent, OhlcvBar, L2Snapshot, MboEvent, } from '../interfaces/IDataAdapter';
 export type { IExecutionAdapter } from '../interfaces/IExecutionAdapter';
 export { LiveTransformer } from '../interfaces/ICoordinateTransformer';
-export type { ICoordinateTransformer, PriceScaleMode, TransformedDrawHook, } from '../interfaces/ICoordinateTransformer';
+export type { ICoordinateTransformer, PriceScaleMode, } from '../interfaces/ICoordinateTransformer';
 export { PluginRegistry } from './PluginRegistry';
 export type { PluginIcon, InstalledPlugin } from './PluginRegistry';
 export type { PluginCatalogEntry, PluginStartupEntry, PluginStartupRecord, } from './plugin-startup';
@@ -53,8 +54,8 @@ export type { TradePoint, PriceHistory, ViewBounds, OhlcvBarMs } from '../lib/ty
 export type { Timeframe } from '../lib/timeframes';
 export type { DrawingTool } from '../lib/types/drawing-types';
 export type { FootprintBar, FootprintOptions } from '../lib/types/footprint';
-export type { ChartSettings } from '../lib/types/chart-settings';
-export { DEFAULT_CHART_SETTINGS } from '../lib/types/chart-settings';
+export type { ChartColorKey, ChartColors, ChartSettings } from '../lib/types/chart-settings';
+export { CHART_COLOR_KEYS, DEFAULT_CHART_SETTINGS, themedSettings } from '../lib/types/chart-settings';
 export type { PlaceOrderRequest, L3EngineOptions, FeeSchedule, BookDepth, BookLevel } from '../lib/matchingEngine';
 export { createL3MatchingEngine, feeScheduleFor, MICRO_FEE_SCHEDULE, NQ_FEE_SCHEDULE, ZERO_FEE_SCHEDULE, } from '../lib/matchingEngine';
 export { SimulatedMarketAdapter, createSimulatedAdapter } from '../lib/createSimulatedAdapter';
@@ -93,6 +94,7 @@ export type { FootprintLevel, FootprintMode, PriceRange } from '../lib/types/foo
 export type { BarPreviewResponse, BarResponse, DataAdapterErrorCode, FetchRequest, PreProcessedPayload, SupplementalBarSet, SymbolIconSpec, TimeRange, } from '../interfaces/IDataAdapter';
 export { SymbolIcon } from '../components/chart/symbol-icon';
 export type { BottomBarHandle, BottomBarItem, ContextMenuItem, FloatingPanelOpts, NotifyLevel, NotifyOptions, PaneOptions, PluginExecutionSurface, PluginLifecycle, PluginServices, PluginStorage, ServiceApi, ServiceObserver, SettingSchema, SettingSchemaType, ThemeDef, ToolbarItem, } from '../interfaces/plugins/IChartPlugin';
+export { BASE_DARK_VARS, BUILTIN_THEMES, DEFAULT_THEME_ID } from './ThemeRegistry';
 export type { ChartTypeActiveContext, ChartTypeKeyEvent, ChartTypePointerEvent, } from '../interfaces/plugins/IChartTypePlugin';
 export type { AnchorConfig, Point } from '../interfaces/plugins/IDrawingPlugin';
 export type { IndicatorCrosshair } from '../interfaces/plugins/IIndicatorPlugin';
@@ -111,6 +113,6 @@ export type { ChartPane, Indicator, Rect } from '../lib/types/indicator-types';
 export type { CrosshairSync, TimeRangeSync } from '../lib/types/layout-sync';
 export type { TradeLineHitMap } from '../lib/renderers/drawTradeLines';
 export type { PlaybackMode } from '../hooks/usePlaybackEngine';
-export type { DrawHook } from './RenderEngine';
+export type { DrawHook, DrawInfo, DrawPhase } from './RenderEngine';
 export type { InterceptableEvent, Interceptor } from './TypedEventBus';
 export { ChartState } from './ChartState';

package/types/core/plugin-startup.d.ts

@@ -23,11 +23,13 @@ export interface PluginCatalogEntry {
 export interface PluginStartupEntry {
     /** Install the plugin when the chart opens. */
     autostart: boolean;
-    /** Indicators only: also put an instance on a pane. */
+    /**
+     * Indicators only: also put an instance on a pane. Ignored when the chart was
+     * restored with pane state - the save decides what's on its panes.
+     */
     activate?: boolean;
 }
 export type PluginStartupRecord = Record<string, PluginStartupEntry>;
-export declare function ptrace(...args: unknown[]): void;
 export declare function readPluginStartup(): PluginStartupRecord;
 /** Merge a patch into one plugin's entry. `null` forgets the plugin entirely. */
 export declare function writePluginStartup(id: string, patch: Partial<PluginStartupEntry> | null): PluginStartupRecord;

package/types/core/theme-style.d.ts

@@ -0,0 +1,9 @@
+import type { ThemeDef } from '../interfaces/plugins/IChartPlugin';
+export declare function themeCss(theme: ThemeDef): string | null;
+export declare class ThemeStyle {
+    private readonly id;
+    private el;
+    constructor(id: string);
+    apply(theme: ThemeDef): void;
+    remove(): void;
+}

package/types/hooks/useChartData.d.ts

@@ -14,17 +14,19 @@ import { type ChartSettings } from '../lib/types/chart-settings';
 import { type TypedEventBus } from '../core/TypedEventBus';
 import { type RenderEngine } from '../core/RenderEngine';
 import { type SessionMapper } from '../core/SessionMapper';
+import { BarStore } from '../core/BarStore';
 import { ohlcvBucketRange } from '../lib/bar-grid';
 import { type SessionStatus } from '../core/SessionUtils';
 export { ohlcvBucketRange };
-export declare function aggregateOhlcvBars(bars: OhlcvBarMs[], targetBarNs: bigint, sessionMapper?: SessionMapper | null): OhlcvBarMs[];
+export declare function aggregateOhlcvBars(bars: BarStore, targetBarNs: bigint, sessionMapper?: SessionMapper | null, from?: number): BarStore;
+export declare function isAggregated(bars: BarStore, targetBarNs: bigint, sessionMapper?: SessionMapper | null, from?: number, to?: number): boolean;
+export declare function displayFor(bars: BarStore, targetBarNs: bigint, sessionMapper?: SessionMapper | null): BarStore;
 /**
- * Incrementally prepend newly fetched bars to an existing aggregated display array.
- * O(new_bars) instead of O(total_bars) - only re-aggregates the new chunk.
- * Handles the boundary bucket that might straddle the old/new data boundary.
+ * Prepend fetched bars to an aggregated display store in place, merging the
+ * bucket that straddles the boundary. Costs the new bars only.
  */
-export declare function prependAggregatedOhlcvBars(newBars: OhlcvBarMs[], existingDisplay: OhlcvBarMs[], targetBarNs: bigint, sessionMapper?: SessionMapper | null): OhlcvBarMs[];
-export declare function autoFitPriceAxis(view: ViewBounds, priceHistory: PriceHistory[], trades: TradePoint[], bars: OhlcvBarMs[], openBar: FootprintBar | null, settings: ChartSettings, horizon: bigint, dataLevel?: DataLevel): void;
+export declare function prependAggregatedOhlcvBars(newBars: OhlcvBarMs[], display: BarStore, targetBarNs: bigint, sessionMapper?: SessionMapper | null): BarStore;
+export declare function autoFitPriceAxis(view: ViewBounds, priceHistory: PriceHistory[], trades: TradePoint[], bars: BarStore, openBar: FootprintBar | null, settings: ChartSettings, horizon: bigint, dataLevel?: DataLevel): void;
 export declare function applyHorizonScrollEasing(t: number, type: string): number;
 export interface UseChartDataParams {
     eventBus: TypedEventBus;
@@ -52,7 +54,6 @@ export interface UseChartDataParams {
     updateSettingsBarPosRef: MutableRefObject<(id: string | null) => void>;
     resetViewRef: MutableRefObject<() => void>;
     syncPixelLayoutsRef: MutableRefObject<(panes?: ChartPane[]) => void>;
-    doBaseRedrawRef: MutableRefObject<() => void>;
     setIndicators: (inds: Indicator[]) => void;
     setPanes: (updater: ((prev: ChartPane[]) => ChartPane[]) | ChartPane[]) => void;
     getPanel: () => DomPanelHandle | null;
@@ -77,10 +78,10 @@ export interface ChartDataResult {
     footprintBarsRef: MutableRefObject<FootprintBar[]>;
     ohlcvBarsRef: MutableRefObject<{
         barNs: bigint;
-        bars: OhlcvBarMs[];
-        display: OhlcvBarMs[];
+        bars: BarStore;
+        display: BarStore;
     }>;
-    previewBarsRef: MutableRefObject<OhlcvBarMs[]>;
+    previewBarsRef: MutableRefObject<BarStore>;
     openBarRef: MutableRefObject<FootprintBar | null>;
     openBarTsRef: MutableRefObject<bigint>;
     openBarTradeCountRef: MutableRefObject<number>;

package/types/hooks/useChartHandlers.d.ts

@@ -1,9 +1,10 @@
 import { type MutableRefObject, type RefObject } from 'react';
 import { type Drawing } from '../lib/types/drawing-types';
 import { type ChartPane, type Indicator, type Rect } from '../lib/types/indicator-types';
-import { type ViewBounds, type TradeLine, type TradePoint, type PriceHistory, type OhlcvBarMs } from '../lib/types';
+import { type ViewBounds, type TradeLine, type TradePoint, type PriceHistory } from '../lib/types';
 import { type Timeframe } from '../lib/timeframes';
 import { type RenderEngine } from '../core/RenderEngine';
+import { type BarStore } from '../core/BarStore';
 import { type LiveTransformer } from '../interfaces/ICoordinateTransformer';
 import { type DataLevel } from '../interfaces/IDataAdapter';
 import { type CompactBuffer } from '../lib/compact-buffer';
@@ -20,8 +21,8 @@ export interface UseChartHandlersParams {
     panesRef: MutableRefObject<ChartPane[]>;
     ohlcvBarsRef: MutableRefObject<{
         barNs: bigint;
-        bars: OhlcvBarMs[];
-        display: OhlcvBarMs[];
+        bars: BarStore;
+        display: BarStore;
     }>;
     sessionMapperRef: MutableRefObject<SessionMapper>;
     activeTimeframeRef: MutableRefObject<Timeframe>;
@@ -36,7 +37,7 @@ export interface UseChartHandlersParams {
     isYAxisAutoRef: MutableRefObject<boolean>;
     priceHistoryRef: MutableRefObject<PriceHistory[]>;
     dataLevelRef: MutableRefObject<DataLevel | null>;
-    previewBarsRef: MutableRefObject<OhlcvBarMs[]>;
+    previewBarsRef: MutableRefObject<BarStore>;
     chartSettingsRef: MutableRefObject<ChartSettings>;
     tradeLinesRef: MutableRefObject<TradeLine[]>;
     hoveringLegend: MutableRefObject<boolean>;