acttrader-charts 1.0.13 → 1.0.14

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-CxJLGBBd.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-CxJLGBBd.cjs';
 
 declare class ChartEngine {
     private wrapper;
@@ -52,6 +52,8 @@ declare class ChartEngine {
     private showBidAskLines;
     private showActLogo;
     private hideLevelConfirmCancel;
+    private levelClusteringEnabled;
+    private clusterThresholdDistance;
     private enableThemeToggle;
     private timeframe;
     private duration;
@@ -112,11 +114,16 @@ declare class ChartEngine {
     private tickClosePriceSource;
     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 +137,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 +148,9 @@ declare class ChartEngine {
     private dataLoader;
     private isFetching;
     private noMoreData;
+    private _loadGeneration;
     private maxCandles;
+    private prefetchThreshold;
     private defaultVisibleBars;
     private defaultMobileVisibleBars;
     private mobileBarDivisor;
@@ -183,6 +194,12 @@ declare class ChartEngine {
     /** Update per-theme deep-partial color overrides and rebuild the active theme. */
     setThemeOverrides(overrides: ChartConfig['themeOverrides']): 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;
@@ -364,6 +381,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 +460,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-CxJLGBBd.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-CxJLGBBd.js';
 
 declare class ChartEngine {
     private wrapper;
@@ -52,6 +52,8 @@ declare class ChartEngine {
     private showBidAskLines;
     private showActLogo;
     private hideLevelConfirmCancel;
+    private levelClusteringEnabled;
+    private clusterThresholdDistance;
     private enableThemeToggle;
     private timeframe;
     private duration;
@@ -112,11 +114,16 @@ declare class ChartEngine {
     private tickClosePriceSource;
     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 +137,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 +148,9 @@ declare class ChartEngine {
     private dataLoader;
     private isFetching;
     private noMoreData;
+    private _loadGeneration;
     private maxCandles;
+    private prefetchThreshold;
     private defaultVisibleBars;
     private defaultMobileVisibleBars;
     private mobileBarDivisor;
@@ -183,6 +194,12 @@ declare class ChartEngine {
     /** Update per-theme deep-partial color overrides and rebuild the active theme. */
     setThemeOverrides(overrides: ChartConfig['themeOverrides']): 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;
@@ -364,6 +381,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 +460,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. */