acttrader-charts 1.0.13 → 1.0.15

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-CEmdbwGz.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 TimeAxisUiConfig, ag as TopBarColors, ah as TopBarLabels, ai as TopBarUiConfig, aj as TradeButtonUiConfig, ak as TradeDisplayFilter, al as TradeLabels, am as TradeLevel, an as TradeLevelColors, ao as TradePanelColors, ap as UiConfig, aq as deepMergeTheme, ar as resolveCssVarsInTheme, as as resolveLabels, at as resolveUiConfig } from './MACD-CEmdbwGz.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-DVxcNurb.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-DVxcNurb.cjs';
 
 declare class ChartEngine {
     private wrapper;
@@ -35,6 +35,11 @@ declare class ChartEngine {
     private _hoverBuyType;
     private _hoverSellType;
     private _minLots;
+    private _showQuantityField;
+    private _qtyFieldMin;
+    private _qtyFieldMax;
+    private _draftQtyFlyout;
+    private _draftQtyPillArea;
     private _onOrderSubmit;
     private scrollToEndBtn;
     private scrollToEndVisible;
@@ -52,6 +57,8 @@ declare class ChartEngine {
     private showBidAskLines;
     private showActLogo;
     private hideLevelConfirmCancel;
+    private levelClusteringEnabled;
+    private clusterThresholdDistance;
     private enableThemeToggle;
     private timeframe;
     private duration;
@@ -104,19 +111,28 @@ declare class ChartEngine {
     private get _isTradingActive();
     private uiConfig;
     private themeOverrides;
+    private timezone;
     private settingsCanvasColors;
     private aggregateFrom;
     private labels;
     private streamAdapter;
     private liveBidAsk;
     private tickClosePriceSource;
+    /** True while an async data fetch is in-flight; suppresses tick processing to
+     *  prevent stale ticks from corrupting newly-loaded bars. */
+    private _suppressTicks;
     private levels;
     private tradeLevelHitAreas;
+    private offViewportHitAreas;
     private tradeLevelEditAreas;
     private tradeHoverAreas;
     private tradeLevelDragAreas;
     private tradeLevelConfirmAreas;
     private tradeAddBracketAreas;
+    private clusterBadgeAreas;
+    private lastClusters;
+    /** Set of cluster IDs that are currently expanded (fanned out). */
+    private expandedClusters;
     private hoveredTradeLabel;
     private selectedTradeLabel;
     private tradeCanvas;
@@ -130,6 +146,8 @@ declare class ChartEngine {
     /** True when the current bracket drag is adding a NEW bracket (via +SL/+TP button). */
     private _isBracketNew;
     private pendingLevelDrags;
+    private tfcEnabled;
+    private tfcActive;
     private tradeDisplayFilter;
     private positionRenderStyle;
     private tradesThresholdForHorizontalLine;
@@ -139,7 +157,9 @@ declare class ChartEngine {
     private dataLoader;
     private isFetching;
     private noMoreData;
+    private _loadGeneration;
     private maxCandles;
+    private prefetchThreshold;
     private defaultVisibleBars;
     private defaultMobileVisibleBars;
     private mobileBarDivisor;
@@ -152,6 +172,22 @@ declare class ChartEngine {
     private loadingOverlayEl;
     private logoImage;
     constructor(config: ChartConfig);
+    /**
+     * Completely resets the chart to a clean, empty state.
+     *
+     * Cancels any in-flight data fetch, clears all bars, resets the price/time
+     * axes, and discards the live bid/ask price line. The chart will render as
+     * blank until the next `loadData()` call.
+     *
+     * Call this before switching to a new symbol so that no previous symbol's
+     * data, price lines, or stale ticks can bleed into the new chart:
+     * ```
+     * chart.setSymbol('GBPUSD').resetData();
+     * // … fetch new bars, then:
+     * chart.loadData(newBars);
+     * ```
+     */
+    resetData(): this;
     loadData(bars: OHLCVBar[], fitAll?: boolean): this;
     /** Prepends historical bars before the current dataset without a visual jump. */
     prependData(bars: OHLCVBar[]): this;
@@ -182,7 +218,18 @@ declare class ChartEngine {
     setTimeframe(tf: Timeframe): this;
     /** Update per-theme deep-partial color overrides and rebuild the active theme. */
     setThemeOverrides(overrides: ChartConfig['themeOverrides']): this;
+    /**
+     * Changes the display timezone for all time-axis and crosshair labels.
+     * Accepts any IANA string (e.g. `"America/New_York"`), `"UTC"`, or `"local"`.
+     */
+    setTimezone(tz: string): this;
     setSeries(series: SeriesType): this;
+    /**
+     * Toggle TFC (Trade from Charts) on or off at runtime.
+     * When disabled, all trade levels, the trade button, and trade popover are hidden.
+     * Only functional when `tfcEnabled` config option is `true` (default).
+     */
+    setTfcActive(enabled: boolean): this;
     private clearDuration;
     setVolume(show: boolean): this;
     private isRestoringState;
@@ -221,6 +268,13 @@ declare class ChartEngine {
      * Updates the trade popover lot display and the submitted lot size. Will be removed in a future version.
      */
     setMinLots(lots: number): this;
+    /**
+     * Updates the quantity (lots) shown in the draft order QTY pill and
+     * submitted when the order is confirmed.
+     * @param qty  Lot size to display and submit.
+     */
+    setDraftQty(qty: number): this;
+    private openDraftQtyFlyout;
     /**
      * @deprecated DraftOrderQtyInput has been removed. This method is a no-op
      * kept for backward compatibility. It will be removed in a future version.
@@ -364,6 +418,10 @@ declare class ChartEngine {
      * and the chart should highlight the corresponding level.
      */
     selectLevel(label: string | null): this;
+    /** Enable or disable trade-level fan-out clustering at runtime. */
+    setLevelClusteringEnabled(enabled: boolean): this;
+    /** Update the cluster proximity threshold (in pixels) at runtime. Only effective when levelClusteringEnabled is true. */
+    setClusterThresholdDistance(px: number): this;
     destroy(): void;
     private createMobileDrawingFlyout;
     private showMobileDrawingFlyout;
@@ -439,6 +497,12 @@ declare class ChartEngine {
      *  Use this when you receive a corrected candle from an external source. */
     correctBar(barTime: number, bar: OHLCVBar): void;
     private scrollToEnd;
+    /**
+     * Smooth-scroll the Y axis so `price` lands at the vertical center of the
+     * chart. Animates `pricePanOffset` only — horizontal viewport is preserved.
+     * Used by off-viewport level indicator clicks.
+     */
+    private scrollToCenterPrice;
     private resetPriceAxis;
     private resetTimeAxis;
     /** Reset both price and time axes to their default state. */

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-CEmdbwGz.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 TimeAxisUiConfig, ag as TopBarColors, ah as TopBarLabels, ai as TopBarUiConfig, aj as TradeButtonUiConfig, ak as TradeDisplayFilter, al as TradeLabels, am as TradeLevel, an as TradeLevelColors, ao as TradePanelColors, ap as UiConfig, aq as deepMergeTheme, ar as resolveCssVarsInTheme, as as resolveLabels, at as resolveUiConfig } from './MACD-CEmdbwGz.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-DVxcNurb.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-DVxcNurb.js';
 
 declare class ChartEngine {
     private wrapper;
@@ -35,6 +35,11 @@ declare class ChartEngine {
     private _hoverBuyType;
     private _hoverSellType;
     private _minLots;
+    private _showQuantityField;
+    private _qtyFieldMin;
+    private _qtyFieldMax;
+    private _draftQtyFlyout;
+    private _draftQtyPillArea;
     private _onOrderSubmit;
     private scrollToEndBtn;
     private scrollToEndVisible;
@@ -52,6 +57,8 @@ declare class ChartEngine {
     private showBidAskLines;
     private showActLogo;
     private hideLevelConfirmCancel;
+    private levelClusteringEnabled;
+    private clusterThresholdDistance;
     private enableThemeToggle;
     private timeframe;
     private duration;
@@ -104,19 +111,28 @@ declare class ChartEngine {
     private get _isTradingActive();
     private uiConfig;
     private themeOverrides;
+    private timezone;
     private settingsCanvasColors;
     private aggregateFrom;
     private labels;
     private streamAdapter;
     private liveBidAsk;
     private tickClosePriceSource;
+    /** True while an async data fetch is in-flight; suppresses tick processing to
+     *  prevent stale ticks from corrupting newly-loaded bars. */
+    private _suppressTicks;
     private levels;
     private tradeLevelHitAreas;
+    private offViewportHitAreas;
     private tradeLevelEditAreas;
     private tradeHoverAreas;
     private tradeLevelDragAreas;
     private tradeLevelConfirmAreas;
     private tradeAddBracketAreas;
+    private clusterBadgeAreas;
+    private lastClusters;
+    /** Set of cluster IDs that are currently expanded (fanned out). */
+    private expandedClusters;
     private hoveredTradeLabel;
     private selectedTradeLabel;
     private tradeCanvas;
@@ -130,6 +146,8 @@ declare class ChartEngine {
     /** True when the current bracket drag is adding a NEW bracket (via +SL/+TP button). */
     private _isBracketNew;
     private pendingLevelDrags;
+    private tfcEnabled;
+    private tfcActive;
     private tradeDisplayFilter;
     private positionRenderStyle;
     private tradesThresholdForHorizontalLine;
@@ -139,7 +157,9 @@ declare class ChartEngine {
     private dataLoader;
     private isFetching;
     private noMoreData;
+    private _loadGeneration;
     private maxCandles;
+    private prefetchThreshold;
     private defaultVisibleBars;
     private defaultMobileVisibleBars;
     private mobileBarDivisor;
@@ -152,6 +172,22 @@ declare class ChartEngine {
     private loadingOverlayEl;
     private logoImage;
     constructor(config: ChartConfig);
+    /**
+     * Completely resets the chart to a clean, empty state.
+     *
+     * Cancels any in-flight data fetch, clears all bars, resets the price/time
+     * axes, and discards the live bid/ask price line. The chart will render as
+     * blank until the next `loadData()` call.
+     *
+     * Call this before switching to a new symbol so that no previous symbol's
+     * data, price lines, or stale ticks can bleed into the new chart:
+     * ```
+     * chart.setSymbol('GBPUSD').resetData();
+     * // … fetch new bars, then:
+     * chart.loadData(newBars);
+     * ```
+     */
+    resetData(): this;
     loadData(bars: OHLCVBar[], fitAll?: boolean): this;
     /** Prepends historical bars before the current dataset without a visual jump. */
     prependData(bars: OHLCVBar[]): this;
@@ -182,7 +218,18 @@ declare class ChartEngine {
     setTimeframe(tf: Timeframe): this;
     /** Update per-theme deep-partial color overrides and rebuild the active theme. */
     setThemeOverrides(overrides: ChartConfig['themeOverrides']): this;
+    /**
+     * Changes the display timezone for all time-axis and crosshair labels.
+     * Accepts any IANA string (e.g. `"America/New_York"`), `"UTC"`, or `"local"`.
+     */
+    setTimezone(tz: string): this;
     setSeries(series: SeriesType): this;
+    /**
+     * Toggle TFC (Trade from Charts) on or off at runtime.
+     * When disabled, all trade levels, the trade button, and trade popover are hidden.
+     * Only functional when `tfcEnabled` config option is `true` (default).
+     */
+    setTfcActive(enabled: boolean): this;
     private clearDuration;
     setVolume(show: boolean): this;
     private isRestoringState;
@@ -221,6 +268,13 @@ declare class ChartEngine {
      * Updates the trade popover lot display and the submitted lot size. Will be removed in a future version.
      */
     setMinLots(lots: number): this;
+    /**
+     * Updates the quantity (lots) shown in the draft order QTY pill and
+     * submitted when the order is confirmed.
+     * @param qty  Lot size to display and submit.
+     */
+    setDraftQty(qty: number): this;
+    private openDraftQtyFlyout;
     /**
      * @deprecated DraftOrderQtyInput has been removed. This method is a no-op
      * kept for backward compatibility. It will be removed in a future version.
@@ -364,6 +418,10 @@ declare class ChartEngine {
      * and the chart should highlight the corresponding level.
      */
     selectLevel(label: string | null): this;
+    /** Enable or disable trade-level fan-out clustering at runtime. */
+    setLevelClusteringEnabled(enabled: boolean): this;
+    /** Update the cluster proximity threshold (in pixels) at runtime. Only effective when levelClusteringEnabled is true. */
+    setClusterThresholdDistance(px: number): this;
     destroy(): void;
     private createMobileDrawingFlyout;
     private showMobileDrawingFlyout;
@@ -439,6 +497,12 @@ declare class ChartEngine {
      *  Use this when you receive a corrected candle from an external source. */
     correctBar(barTime: number, bar: OHLCVBar): void;
     private scrollToEnd;
+    /**
+     * Smooth-scroll the Y axis so `price` lands at the vertical center of the
+     * chart. Animates `pricePanOffset` only — horizontal viewport is preserved.
+     * Used by off-viewport level indicator clicks.
+     */
+    private scrollToCenterPrice;
     private resetPriceAxis;
     private resetTimeAxis;
     /** Reset both price and time axes to their default state. */