acttrader-charts 1.0.19 → 1.0.21

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { C as ChartConfig, O as OHLCVBar, I as IIndicator, a as ChartEventMap, T as Timeframe, S as SeriesType, b as ChartState, D as DrawingToolType, c as IDrawing, d as IWebSocketAdapter, e as TradeLevelType, A as AnyLevel, f as DrawingPoint, g as ScaleManager, V as Viewport, P as PriceRange$1, h as DrawingHandle, i as SerializedDrawing, j as Tick, k as StreamStatus } from './MACD-DZxpf0eQ.cjs';
-export { l as ActiveIndicatorState, B as BollingerBands, m as BottomBarColors, n as BottomBarLabels, o as BottomBarUiConfig, p as CanvasColorSettings, q as ChartLabels, r as ChartMiscLabels, s as ChartTheme, t as ChartThemeUi, u as CrosshairPosition, v as CrosshairUiConfig, w as DARK_THEME, x as DEFAULT_BOTTOM_BAR_CONFIG, y as DEFAULT_CROSSHAIR_CONFIG, z as DEFAULT_DRAWING_TOOLBAR_CONFIG, E as DEFAULT_INDICATOR_OVERLAY_CONFIG, F as DEFAULT_LABELS, G as DEFAULT_PRICE_AXIS_CONFIG, H as DEFAULT_TIME_AXIS_CONFIG, J as DEFAULT_TOP_BAR_CONFIG, K as DEFAULT_TRADE_BUTTON_CONFIG, L as DEFAULT_UI_CONFIG, M as DataLoaderParams, N as DeepPartial, Q as DeepPartialChartTheme, R as DialogLabels, U as DrawingToolbarColors, W as DrawingToolbarLabels, X as DrawingToolbarUiConfig, Y as Duration, Z as EMA, _ as IndicatorOverlayColors, $ as IndicatorOverlayUiConfig, a0 as IndicatorParams, a1 as IndicatorResult, a2 as IndicatorStateEntry, a3 as LIGHT_THEME, a4 as MACD, a5 as OhlcLabels, a6 as OrderSubmit, a7 as Padding, a8 as PendingOrderLevel, a9 as PositionLevel, aa as PositionRenderStyle, ab as PriceAxisUiConfig, ac as RSI, ad as SMA, ae as Theme, af as ThemeOverrides, ag as TimeAxisUiConfig, ah as TopBarColors, ai as TopBarLabels, aj as TopBarUiConfig, ak as TradeButtonUiConfig, al as TradeDisplayFilter, am as TradeLabels, an as TradeLevel, ao as TradeLevelColors, ap as TradePanelColors, aq as UiConfig, ar as deepMergeTheme, as as resolveCssVarsInTheme, at as resolveLabels, au as resolveUiConfig } from './MACD-DZxpf0eQ.cjs';
+import { C as ChartConfig, O as OHLCVBar, I as IIndicator, a as ChartEventMap, T as Timeframe, S as SeriesType, b as ChartState, D as DrawingToolType, c as IDrawing, d as IWebSocketAdapter, e as TradeLevelType, A as AnyLevel, f as DrawingPoint, g as ScaleManager, V as Viewport, P as PriceRange$1, h as DrawingHandle, i as SerializedDrawing, j as Tick, k as StreamStatus } from './MACD-DGFPNwy9.cjs';
+export { l as ActiveIndicatorState, B as BollingerBands, m as BottomBarColors, n as BottomBarLabels, o as BottomBarUiConfig, p as CanvasColorSettings, q as ChartLabels, r as ChartMiscLabels, s as ChartTheme, t as ChartThemeUi, u as CrosshairPosition, v as CrosshairUiConfig, w as DARK_THEME, x as DEFAULT_BOTTOM_BAR_CONFIG, y as DEFAULT_CROSSHAIR_CONFIG, z as DEFAULT_DRAWING_TOOLBAR_CONFIG, E as DEFAULT_INDICATOR_OVERLAY_CONFIG, F as DEFAULT_LABELS, G as DEFAULT_PRICE_AXIS_CONFIG, H as DEFAULT_TIME_AXIS_CONFIG, J as DEFAULT_TOP_BAR_CONFIG, K as DEFAULT_TRADE_BUTTON_CONFIG, L as DEFAULT_UI_CONFIG, M as DataLoaderParams, N as DeepPartial, Q as DeepPartialChartTheme, R as DialogLabels, U as DrawingToolbarColors, W as DrawingToolbarLabels, X as DrawingToolbarUiConfig, Y as Duration, Z as EMA, _ as IndicatorOverlayColors, $ as IndicatorOverlayUiConfig, a0 as IndicatorParams, a1 as IndicatorResult, a2 as IndicatorStateEntry, a3 as LIGHT_THEME, a4 as MACD, a5 as OhlcLabels, a6 as OrderSubmit, a7 as Padding, a8 as PendingOrderLevel, a9 as PositionLevel, aa as PositionRenderStyle, ab as PriceAxisUiConfig, ac as RSI, ad as SMA, ae as Theme, af as ThemeOverrides, ag as TimeAxisUiConfig, ah as TopBarColors, ai as TopBarLabels, aj as TopBarUiConfig, ak as TradeButtonUiConfig, al as TradeDisplayFilter, am as TradeLabels, an as TradeLevel, ao as TradeLevelColors, ap as TradePanelColors, aq as UiConfig, ar as deepMergeTheme, as as resolveCssVarsInTheme, at as resolveLabels, au as resolveUiConfig } from './MACD-DGFPNwy9.cjs';
 
 declare class ChartEngine {
     private wrapper;
@@ -82,6 +82,13 @@ declare class ChartEngine {
     /** Pending resize — committed only after mouse moves past DRAW_GESTURE_THRESHOLD. */
     private _pendingDrawResize;
     private static readonly DRAW_GESTURE_THRESHOLD;
+    /**
+     * Pending trade-level drag — committed only after mouse moves past TRADE_DRAG_PIXEL_THRESHOLD.
+     * A mouseup before the threshold means it was a click: route to _openTradeLevelEditForm instead
+     * of finishing a zero-delta drag (which would otherwise stage a spurious pending change).
+     */
+    private _pendingTradeDrag;
+    private static readonly TRADE_DRAG_PIXEL_THRESHOLD;
     private paneHeightOverrides;
     private separatorDrag;
     private readonly priceAxisWidth;
@@ -90,6 +97,24 @@ declare class ChartEngine {
     private pricePanOffset;
     private _displayedPriceRange;
     private _lockedAutoFitBase;
+    /**
+     * When setState() restores a persisted viewport but data isn't loaded yet,
+     * we stash the desired time window here and apply it from loadData() once
+     * bars are available. Cleared after one application.
+     */
+    private _pendingViewportRestore;
+    /**
+     * Debounces viewport/priceScale stateChange emissions during continuous
+     * gestures (pan, wheel-zoom, price-scale drag). Pan/zoom don't emit
+     * stateChange directly because doing so per-frame would be wasteful; this
+     * timer coalesces bursts so the persisted viewport catches up a few ms
+     * after the user stops interacting. Paired with the consumer's own
+     * debounce (e.g. CRM's 800ms save) for minimal traffic.
+     */
+    private _viewportPersistTimer;
+    /** Schedules a stateChange emission so viewport/priceScale changes made by
+     *  pan/zoom/price-scale drag reach persistence. Coalesces rapid calls. */
+    private scheduleViewportPersist;
     private axisDrag;
     private subPaneScaleFactors;
     private _mobileCrosshairActive;
@@ -288,17 +313,63 @@ declare class ChartEngine {
      * Includes timeframe, chart type, active indicators (with params), and drawings.
      */
     getState(): ChartState;
+    /**
+     * Captures the current viewport as a {startTime, endTime} timestamp pair,
+     * preserving sub-bar fractional position. Returns undefined only when no
+     * bars are loaded (viewport has no meaningful time anchor).
+     */
+    private getViewportTimestamps;
+    /**
+     * Restores the viewport from a timestamp pair, converting each edge back
+     * into a fractional bar index relative to the current dataStore. Callers
+     * must ensure bars are loaded before invoking.
+     */
+    private applyViewportFromTimestamps;
     /**
      * Restores chart configuration from a previously captured `ChartState`.
      * Call this after construction to hydrate a chart from persisted state.
      */
     setState(state: ChartState): this;
     /**
-     * Re-anchors all loaded drawings to the current dataset using their stored timestamps.
-     * Called after loadData() to fix drawings restored via setState() before data was
-     * available (bars.length === 0 at restore time causes the raw barIndex fallback).
+     * Converts a fractional barIndex into an absolute unix-ms timestamp by
+     * interpolating across the containing bar. Extrapolates linearly for indexes
+     * outside [0, bars.length-1] using the adjacent bar's width.
+     *
+     * This is the inverse of `timestampToBarIndex` and the authoritative way to
+     * capture "where in time" a drawing point sits at placement, drag, or resize.
+     * Returns undefined only when no bars are loaded.
+     */
+    private barIndexToTimestamp;
+    /**
+     * Converts a unix-ms timestamp into a fractional barIndex using floor-bar
+     * containment: the result is `floorBar + (ts - floorBar.time) / (nextBar.time - floorBar.time)`.
+     * Extrapolates linearly for timestamps outside the loaded range using the edge
+     * bar width, so drawings outside the visible data still render at the correct
+     * relative offset rather than snapping to an edge.
+     *
+     * Matches TradingView's floor-bar semantics and preserves sub-bar time
+     * precision across timeframe changes.
+     */
+    private timestampToBarIndex;
+    /**
+     * Re-anchors all loaded drawings to the current dataset. For points with a
+     * stored timestamp, barIndex is recomputed via `timestampToBarIndex`; for
+     * points missing a timestamp (legacy saves or freshly placed points whose
+     * timestamp capture was skipped), the timestamp is backfilled from the
+     * current barIndex so subsequent data reloads remain accurate.
+     *
+     * Called after loadData(), prependData(), and whenever the underlying bars
+     * change such that cached barIndex values would otherwise drift.
      */
     private reanchorDrawingsByTimestamp;
+    /**
+     * Captures a timestamp on any drawing point that is missing one, using the
+     * current bars. Call this BEFORE mutating `dataStore.all` (insert/splice)
+     * so that points still pointing at a stale barIndex get frozen to the
+     * correct time before the mutation invalidates the index. Safe no-op for
+     * points that already have a timestamp.
+     */
+    private backfillDrawingTimestamps;
     /**
      * Resets all chart settings that are captured by `getState()` back to their
      * defaults (candlestick / dark / 1D / 1Y / volume on / no indicators / no drawings)
@@ -543,10 +614,29 @@ declare class ChartEngine {
     private onMouseLeave;
     private onMouseUp;
     private touchToDrawingPoint;
+    /**
+     * Builds a fully-populated DrawingPoint from raw float coordinates. Captures
+     * the absolute timestamp at this fractional barIndex so the anchor survives
+     * timeframe changes, data reloads, and serialization round-trips.
+     */
+    private makeDrawingPoint;
     /** Shared close-button handler used by both mouse click and touch tap. */
     private _handleTradeLevelClose;
     /** Activates the mobile crosshair at canvas coords (x, y). */
     private _activateMobileCrosshair;
+    /**
+     * Closes the edit form, clears selection, and emits `tradeLevelEditCancelled` when
+     * the edit form was actually open for this label. Shared between click-outside,
+     * repeat-click toggle, and the ✗ button so all exit paths produce the same payload.
+     */
+    private _cancelEditAndDeselect;
+    /**
+     * Opens the external edit form for a trade level by emitting `tradeLevelEditOpen`.
+     * Shared between pencil click, bare box click, and drag start so every entry
+     * point fires the same payload. No-op when the form is already open for this
+     * label, so repeat opens (e.g. pencil click followed by drag) don't spam the event.
+     */
+    private _openTradeLevelEditForm;
     /** Shared helper: initiate a trade level main-line drag from a hit area. */
     private _startTradeDragFromHit;
     /** Shared helper: initiate a +SL/+TP add-bracket drag from a hit area. */
@@ -665,6 +755,14 @@ declare class DrawingManager {
     onDrawingsChange: (() => void) | null;
     /** Called when a text-type drawing is first completed — ChartEngine shows the text input. */
     onStartTextEdit: ((drawing: IDrawing) => void) | null;
+    /**
+     * Called after drag/resize mutates a drawing's points so ChartEngine can
+     * refresh each point's `timestamp` from the current dataStore. Required
+     * because DrawingManager has no access to the data layer, and drag
+     * reconstructs points from raw (barIndex, price) deltas that strip the
+     * original point's timestamp.
+     */
+    onPointsMutated: ((drawing: IDrawing) => void) | null;
     /** Set to true by ChartEngine while the text input is focused — prevents Delete/Backspace from deleting the drawing. */
     private editingText;
     private dragDrawing;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as ChartConfig, O as OHLCVBar, I as IIndicator, a as ChartEventMap, T as Timeframe, S as SeriesType, b as ChartState, D as DrawingToolType, c as IDrawing, d as IWebSocketAdapter, e as TradeLevelType, A as AnyLevel, f as DrawingPoint, g as ScaleManager, V as Viewport, P as PriceRange$1, h as DrawingHandle, i as SerializedDrawing, j as Tick, k as StreamStatus } from './MACD-DZxpf0eQ.js';
-export { l as ActiveIndicatorState, B as BollingerBands, m as BottomBarColors, n as BottomBarLabels, o as BottomBarUiConfig, p as CanvasColorSettings, q as ChartLabels, r as ChartMiscLabels, s as ChartTheme, t as ChartThemeUi, u as CrosshairPosition, v as CrosshairUiConfig, w as DARK_THEME, x as DEFAULT_BOTTOM_BAR_CONFIG, y as DEFAULT_CROSSHAIR_CONFIG, z as DEFAULT_DRAWING_TOOLBAR_CONFIG, E as DEFAULT_INDICATOR_OVERLAY_CONFIG, F as DEFAULT_LABELS, G as DEFAULT_PRICE_AXIS_CONFIG, H as DEFAULT_TIME_AXIS_CONFIG, J as DEFAULT_TOP_BAR_CONFIG, K as DEFAULT_TRADE_BUTTON_CONFIG, L as DEFAULT_UI_CONFIG, M as DataLoaderParams, N as DeepPartial, Q as DeepPartialChartTheme, R as DialogLabels, U as DrawingToolbarColors, W as DrawingToolbarLabels, X as DrawingToolbarUiConfig, Y as Duration, Z as EMA, _ as IndicatorOverlayColors, $ as IndicatorOverlayUiConfig, a0 as IndicatorParams, a1 as IndicatorResult, a2 as IndicatorStateEntry, a3 as LIGHT_THEME, a4 as MACD, a5 as OhlcLabels, a6 as OrderSubmit, a7 as Padding, a8 as PendingOrderLevel, a9 as PositionLevel, aa as PositionRenderStyle, ab as PriceAxisUiConfig, ac as RSI, ad as SMA, ae as Theme, af as ThemeOverrides, ag as TimeAxisUiConfig, ah as TopBarColors, ai as TopBarLabels, aj as TopBarUiConfig, ak as TradeButtonUiConfig, al as TradeDisplayFilter, am as TradeLabels, an as TradeLevel, ao as TradeLevelColors, ap as TradePanelColors, aq as UiConfig, ar as deepMergeTheme, as as resolveCssVarsInTheme, at as resolveLabels, au as resolveUiConfig } from './MACD-DZxpf0eQ.js';
+import { C as ChartConfig, O as OHLCVBar, I as IIndicator, a as ChartEventMap, T as Timeframe, S as SeriesType, b as ChartState, D as DrawingToolType, c as IDrawing, d as IWebSocketAdapter, e as TradeLevelType, A as AnyLevel, f as DrawingPoint, g as ScaleManager, V as Viewport, P as PriceRange$1, h as DrawingHandle, i as SerializedDrawing, j as Tick, k as StreamStatus } from './MACD-DGFPNwy9.js';
+export { l as ActiveIndicatorState, B as BollingerBands, m as BottomBarColors, n as BottomBarLabels, o as BottomBarUiConfig, p as CanvasColorSettings, q as ChartLabels, r as ChartMiscLabels, s as ChartTheme, t as ChartThemeUi, u as CrosshairPosition, v as CrosshairUiConfig, w as DARK_THEME, x as DEFAULT_BOTTOM_BAR_CONFIG, y as DEFAULT_CROSSHAIR_CONFIG, z as DEFAULT_DRAWING_TOOLBAR_CONFIG, E as DEFAULT_INDICATOR_OVERLAY_CONFIG, F as DEFAULT_LABELS, G as DEFAULT_PRICE_AXIS_CONFIG, H as DEFAULT_TIME_AXIS_CONFIG, J as DEFAULT_TOP_BAR_CONFIG, K as DEFAULT_TRADE_BUTTON_CONFIG, L as DEFAULT_UI_CONFIG, M as DataLoaderParams, N as DeepPartial, Q as DeepPartialChartTheme, R as DialogLabels, U as DrawingToolbarColors, W as DrawingToolbarLabels, X as DrawingToolbarUiConfig, Y as Duration, Z as EMA, _ as IndicatorOverlayColors, $ as IndicatorOverlayUiConfig, a0 as IndicatorParams, a1 as IndicatorResult, a2 as IndicatorStateEntry, a3 as LIGHT_THEME, a4 as MACD, a5 as OhlcLabels, a6 as OrderSubmit, a7 as Padding, a8 as PendingOrderLevel, a9 as PositionLevel, aa as PositionRenderStyle, ab as PriceAxisUiConfig, ac as RSI, ad as SMA, ae as Theme, af as ThemeOverrides, ag as TimeAxisUiConfig, ah as TopBarColors, ai as TopBarLabels, aj as TopBarUiConfig, ak as TradeButtonUiConfig, al as TradeDisplayFilter, am as TradeLabels, an as TradeLevel, ao as TradeLevelColors, ap as TradePanelColors, aq as UiConfig, ar as deepMergeTheme, as as resolveCssVarsInTheme, at as resolveLabels, au as resolveUiConfig } from './MACD-DGFPNwy9.js';
 
 declare class ChartEngine {
     private wrapper;
@@ -82,6 +82,13 @@ declare class ChartEngine {
     /** Pending resize — committed only after mouse moves past DRAW_GESTURE_THRESHOLD. */
     private _pendingDrawResize;
     private static readonly DRAW_GESTURE_THRESHOLD;
+    /**
+     * Pending trade-level drag — committed only after mouse moves past TRADE_DRAG_PIXEL_THRESHOLD.
+     * A mouseup before the threshold means it was a click: route to _openTradeLevelEditForm instead
+     * of finishing a zero-delta drag (which would otherwise stage a spurious pending change).
+     */
+    private _pendingTradeDrag;
+    private static readonly TRADE_DRAG_PIXEL_THRESHOLD;
     private paneHeightOverrides;
     private separatorDrag;
     private readonly priceAxisWidth;
@@ -90,6 +97,24 @@ declare class ChartEngine {
     private pricePanOffset;
     private _displayedPriceRange;
     private _lockedAutoFitBase;
+    /**
+     * When setState() restores a persisted viewport but data isn't loaded yet,
+     * we stash the desired time window here and apply it from loadData() once
+     * bars are available. Cleared after one application.
+     */
+    private _pendingViewportRestore;
+    /**
+     * Debounces viewport/priceScale stateChange emissions during continuous
+     * gestures (pan, wheel-zoom, price-scale drag). Pan/zoom don't emit
+     * stateChange directly because doing so per-frame would be wasteful; this
+     * timer coalesces bursts so the persisted viewport catches up a few ms
+     * after the user stops interacting. Paired with the consumer's own
+     * debounce (e.g. CRM's 800ms save) for minimal traffic.
+     */
+    private _viewportPersistTimer;
+    /** Schedules a stateChange emission so viewport/priceScale changes made by
+     *  pan/zoom/price-scale drag reach persistence. Coalesces rapid calls. */
+    private scheduleViewportPersist;
     private axisDrag;
     private subPaneScaleFactors;
     private _mobileCrosshairActive;
@@ -288,17 +313,63 @@ declare class ChartEngine {
      * Includes timeframe, chart type, active indicators (with params), and drawings.
      */
     getState(): ChartState;
+    /**
+     * Captures the current viewport as a {startTime, endTime} timestamp pair,
+     * preserving sub-bar fractional position. Returns undefined only when no
+     * bars are loaded (viewport has no meaningful time anchor).
+     */
+    private getViewportTimestamps;
+    /**
+     * Restores the viewport from a timestamp pair, converting each edge back
+     * into a fractional bar index relative to the current dataStore. Callers
+     * must ensure bars are loaded before invoking.
+     */
+    private applyViewportFromTimestamps;
     /**
      * Restores chart configuration from a previously captured `ChartState`.
      * Call this after construction to hydrate a chart from persisted state.
      */
     setState(state: ChartState): this;
     /**
-     * Re-anchors all loaded drawings to the current dataset using their stored timestamps.
-     * Called after loadData() to fix drawings restored via setState() before data was
-     * available (bars.length === 0 at restore time causes the raw barIndex fallback).
+     * Converts a fractional barIndex into an absolute unix-ms timestamp by
+     * interpolating across the containing bar. Extrapolates linearly for indexes
+     * outside [0, bars.length-1] using the adjacent bar's width.
+     *
+     * This is the inverse of `timestampToBarIndex` and the authoritative way to
+     * capture "where in time" a drawing point sits at placement, drag, or resize.
+     * Returns undefined only when no bars are loaded.
+     */
+    private barIndexToTimestamp;
+    /**
+     * Converts a unix-ms timestamp into a fractional barIndex using floor-bar
+     * containment: the result is `floorBar + (ts - floorBar.time) / (nextBar.time - floorBar.time)`.
+     * Extrapolates linearly for timestamps outside the loaded range using the edge
+     * bar width, so drawings outside the visible data still render at the correct
+     * relative offset rather than snapping to an edge.
+     *
+     * Matches TradingView's floor-bar semantics and preserves sub-bar time
+     * precision across timeframe changes.
+     */
+    private timestampToBarIndex;
+    /**
+     * Re-anchors all loaded drawings to the current dataset. For points with a
+     * stored timestamp, barIndex is recomputed via `timestampToBarIndex`; for
+     * points missing a timestamp (legacy saves or freshly placed points whose
+     * timestamp capture was skipped), the timestamp is backfilled from the
+     * current barIndex so subsequent data reloads remain accurate.
+     *
+     * Called after loadData(), prependData(), and whenever the underlying bars
+     * change such that cached barIndex values would otherwise drift.
      */
     private reanchorDrawingsByTimestamp;
+    /**
+     * Captures a timestamp on any drawing point that is missing one, using the
+     * current bars. Call this BEFORE mutating `dataStore.all` (insert/splice)
+     * so that points still pointing at a stale barIndex get frozen to the
+     * correct time before the mutation invalidates the index. Safe no-op for
+     * points that already have a timestamp.
+     */
+    private backfillDrawingTimestamps;
     /**
      * Resets all chart settings that are captured by `getState()` back to their
      * defaults (candlestick / dark / 1D / 1Y / volume on / no indicators / no drawings)
@@ -543,10 +614,29 @@ declare class ChartEngine {
     private onMouseLeave;
     private onMouseUp;
     private touchToDrawingPoint;
+    /**
+     * Builds a fully-populated DrawingPoint from raw float coordinates. Captures
+     * the absolute timestamp at this fractional barIndex so the anchor survives
+     * timeframe changes, data reloads, and serialization round-trips.
+     */
+    private makeDrawingPoint;
     /** Shared close-button handler used by both mouse click and touch tap. */
     private _handleTradeLevelClose;
     /** Activates the mobile crosshair at canvas coords (x, y). */
     private _activateMobileCrosshair;
+    /**
+     * Closes the edit form, clears selection, and emits `tradeLevelEditCancelled` when
+     * the edit form was actually open for this label. Shared between click-outside,
+     * repeat-click toggle, and the ✗ button so all exit paths produce the same payload.
+     */
+    private _cancelEditAndDeselect;
+    /**
+     * Opens the external edit form for a trade level by emitting `tradeLevelEditOpen`.
+     * Shared between pencil click, bare box click, and drag start so every entry
+     * point fires the same payload. No-op when the form is already open for this
+     * label, so repeat opens (e.g. pencil click followed by drag) don't spam the event.
+     */
+    private _openTradeLevelEditForm;
     /** Shared helper: initiate a trade level main-line drag from a hit area. */
     private _startTradeDragFromHit;
     /** Shared helper: initiate a +SL/+TP add-bracket drag from a hit area. */
@@ -665,6 +755,14 @@ declare class DrawingManager {
     onDrawingsChange: (() => void) | null;
     /** Called when a text-type drawing is first completed — ChartEngine shows the text input. */
     onStartTextEdit: ((drawing: IDrawing) => void) | null;
+    /**
+     * Called after drag/resize mutates a drawing's points so ChartEngine can
+     * refresh each point's `timestamp` from the current dataStore. Required
+     * because DrawingManager has no access to the data layer, and drag
+     * reconstructs points from raw (barIndex, price) deltas that strip the
+     * original point's timestamp.
+     */
+    onPointsMutated: ((drawing: IDrawing) => void) | null;
     /** Set to true by ChartEngine while the text input is focused — prevents Delete/Backspace from deleting the drawing. */
     private editingText;
     private dragDrawing;