acttrader-charts 1.0.13 → 1.0.15

package/README.md

@@ -187,6 +187,10 @@ chart.on('tradeLevelDrag', ({ label, newPrice, bracketType, isFullscreen }) => {
 });
 ```
 
+**Off-viewport level indicators:**
+
+When a trade level's entry, SL, or TP price lies outside the visible price range, a small pill (`▲ N` / `▼ N`) appears near the right edge of the chart showing the count of off-screen markers per direction. Clicking the pill smooth-scrolls the nearest off-viewport marker to the vertical center of the chart. This requires no configuration — it activates automatically whenever levels are present.
+
 **Drag constraints (enforced live):**
 
 | Order side | Stop Loss | Take Profit |
@@ -229,7 +233,12 @@ When `enableTrading` is on and live BID/ASK data is streaming, hovering / activa
 | `minLots` | | `1` | Default lot size in the trade popover |
 | `tickActivityMs` | | `30000` | ms the stream dot stays green after last tick |
 | `maxCandles` | | `200` | Max bars fetched per data-load request |
+| `prefetchThreshold` | | `80` | Bars from start of data at which historical fetch triggers (min 20) |
 | `mobileBarDivisor` | | `2` | Divide desktop visible bar count on touch devices (`2`, `3`, or `4`) |
+| `momentumScrollEnabled` | | `true` | Enable momentum (kinetic) scrolling — chart coasts after a fast flick |
+| `momentumDecay` | | `0.95` | Per-frame velocity decay, normalised to 60 fps. Clamped `[0.80, 0.99]`. Lower = stops faster |
+| `momentumThreshold` | | `0.3` | Min release velocity (px/ms) to launch momentum. Raise to require a faster flick |
+| `momentumMaxVelocity` | | `6.0` | Max launch velocity (px/ms) — caps hard-flick speed |
 | `targetCandleWidth` | | `10` | Target px width per candle for auto-calculating initial bar count |
 | `durationTimeframeMap` | | *(see below)* | Override duration → timeframe pairings |
 | `dataLoader` | | — | `(params) => Promise<OHLCVBar[]>` auto-called on load / change |
@@ -245,8 +254,16 @@ When `enableTrading` is on and live BID/ASK data is streaming, hovering / activa
 | `tradeDisplayFilter` | | `"all"` | Which TFC levels are visible: `"all"` · `"positions"` · `"orders"` · `"none"` |
 | `positionRenderStyle` | | auto | Force position render style: `"line"` or `"dot"` |
 | `hideLevelConfirmCancel` | | `false` | Hide on-canvas ✓/✗ confirm-cancel buttons for TFC level edits |
+| `tfcEnabled` | | `true` | Enable the TFC toggle button in the top bar. When `false`, TFC is completely disabled — the toggle button is hidden and all trade levels, draft orders, and the floating trade button are suppressed |
+| `levelClusteringEnabled` | | `true` | Enable trade-level fan-out clustering; overlapping levels group into expandable badges |
+| `clusterThresholdDistance` | | `20` | Pixel proximity threshold for clustering (only when `levelClusteringEnabled` is `true`) |
+| `hideSymbolAndTick` | | `false` | Hide the symbol name, OHLC strip, and tick-activity dot overlay |
+| `showBottomBar` | | `false` | Show the bottom duration-selector bar |
 | `hideQtyButton` | | `false` | Hide the floating Qty input overlay on draft orders |
+| `showQuantityField` | | `false` | Render an editable QTY pill at the left of the draft order info box. Clicking the pill opens a flyout input to edit the quantity before submitting |
+| `quantityFieldConfig` | | — | Constraints for the draft order QTY field (only relevant when `showQuantityField` is `true`). Object: `{ minLots?: number, maxLots?: number }`. `minLots` also sets the initial quantity and the step value for the flyout input (default: `1`). `maxLots` caps the input (default: `100`) |
 | `tradesThresholdForHorizontalLine` | | `2` | Level count above which render auto-switches to `"dot"` mode |
+| `timezone` | | `"UTC"` | IANA timezone string for time-axis and crosshair labels. `"UTC"` (default), `"local"` (browser/device timezone), or any IANA string (`"America/New_York"`, `"Europe/London"`, etc.) |
 | `canvasColors` | | — | Per-theme canvas background color overrides (persisted from Settings dialog) |
 | `aggregateFrom` | | — | Fetch finer-grained data and aggregate client-side per timeframe |
 | `onOrderSubmit` | | — | Called when user submits a trade via the floating button |
@@ -469,6 +486,17 @@ chart.loadData(bars: OHLCVBar[]): this
 chart.prependData(bars: OHLCVBar[]): this   // prepend historical bars (infinite scroll back)
 chart.correctBar(barTime: number, bar: OHLCVBar): void  // replace a bar with authoritative data after close
 chart.setLoading(loading: boolean): this
+
+// Reset — clears all bars, the live price line, and any in-flight fetch.
+// Call before switching to a new symbol so no previous symbol data bleeds in.
+chart.resetData(): this
+```
+
+**Symbol switch pattern:**
+```ts
+chart.setSymbol('GBPUSD').resetData();
+// … fetch new bars …
+chart.loadData(newBars);
 ```
 
 ### Series & Appearance
@@ -477,7 +505,8 @@ chart.setLoading(loading: boolean): this
 chart.setSeries(series: SeriesType): this
 chart.setTheme('dark' | 'light'): this
 chart.setTimeframe(tf: Timeframe): this                         // change timeframe and reload data
-chart.setThemeOverrides(overrides: ChartConfig['themeOverrides']): this  // update per-theme color overrides at runtime
+chart.setThemeOverrides(overrides: ThemeOverrides): this               // update per-theme color overrides at runtime
+chart.setTimezone(tz: string): this                                // change display timezone at runtime
 chart.setVolume(show: boolean): this
 ```
 
@@ -504,6 +533,7 @@ chart.removeLevelByLabel(label: string): this
 chart.cancelCurrentEdit(): this   // cancel the active draft order or in-progress level edit; no-op when nothing is active
 chart.addLevelBracket(label: string, bracketType: 'sl' | 'tp'): this   // auto-place a SL or TP bracket at a default offset; emits tradeLevelBracketActivated with the computed price
 chart.setDraftBracketPnl(bracketType: 'sl' | 'tp', pnlText: string | null): this   // set estimated P&L text on a draft order bracket line; pass null to clear
+chart.setTfcActive(enabled: boolean): this   // toggle TFC on/off at runtime; hides/shows all trade levels, draft orders, and floating trade button; fires tfcToggle event
 ```
 
 ### Trade Button
@@ -680,6 +710,7 @@ chart.on('tradeLevelEditOpen', ({ label, type, price, side, stopLossPrice, takeP
 chart.on('tradeLevelConfirmed',({ label, type, isFullscreen }) => {});
 chart.on('draftInitiated',     ({ side, price, orderType, isFullscreen }) => {}); // new draft order shown — open buy/sell form
 chart.on('draftCancelled',     ({ label, isFullscreen }) => {}); // draft order dismissed without confirming
+chart.on('tfcToggle',         ({ enabled }) => {}); // TFC toggled on or off via top bar button or setTfcActive()
 chart.on('tradeLevelDragEnd',  ({ label, type, newPrice, data }) => {}); // deprecated — use tradeLevelEdit
 chart.on('tradeLevelBracketDrag', ({ label, bracketType, newPrice, data }) => {}); // deprecated
 

package/dist/{MACD-CEmdbwGz.d.cts → MACD-DVxcNurb.d.cts}

@@ -189,6 +189,8 @@ interface TopBarLabels {
     exitFullscreenTitle: string;
     /** Tooltip on the chart-settings button. */
     settingsTitle: string;
+    /** Tooltip on the TFC (Trade from Charts) toggle button. */
+    tfcToggleTitle: string;
 }
 interface BottomBarLabels {
     /** Duration selector button labels. */
@@ -528,6 +530,14 @@ interface DataLoaderParams {
     end: Date;
     interval: string;
 }
+/**
+ * Per-theme deep-partial color overrides applied on top of the built-in
+ * dark / light themes.  Only the keys you supply are replaced.
+ */
+type ThemeOverrides = {
+    dark?: DeepPartialChartTheme;
+    light?: DeepPartialChartTheme;
+};
 interface ChartConfig {
     container: HTMLElement;
     theme?: Theme;
@@ -558,6 +568,22 @@ interface ChartConfig {
      * Minimum (and default) lot size for draft order submission. Default: `1`.
      */
     minLots?: number;
+    /**
+     * When true, renders an editable QTY pill at the left of the draft order
+     * info box. Clicking the pill opens a flyout to edit the quantity. Default: `false`.
+     */
+    showQuantityField?: boolean;
+    /**
+     * Constraints for the draft order QTY field. Only relevant when
+     * `showQuantityField` is true. `minLots` also sets the initial quantity
+     * and the step value for the flyout input.
+     */
+    quantityFieldConfig?: {
+        /** Minimum lot size, step size, and initial quantity (e.g. `0.01`). Default: `1` */
+        minLots?: number;
+        /** Maximum lot size (e.g. `100`). Default: `100` */
+        maxLots?: number;
+    };
     /** Called when user submits an order via the floating trade button */
     onOrderSubmit?: (order: OrderSubmit) => void;
     /**
@@ -610,10 +636,14 @@ interface ChartConfig {
      *   light: { background: 'var(--sidebar-bg-light)' },
      * }
      */
-    themeOverrides?: {
-        dark?: DeepPartialChartTheme;
-        light?: DeepPartialChartTheme;
-    };
+    themeOverrides?: ThemeOverrides;
+    /**
+     * IANA timezone string for all time-axis and crosshair labels.
+     * `"UTC"` (default) preserves existing behavior.
+     * `"local"` uses the browser/device timezone automatically.
+     * Any IANA string is accepted: `"America/New_York"`, `"Europe/London"`, etc.
+     */
+    timezone?: string;
     /**
      * Optional per-component UI configuration overrides (font sizes, icon
      * sizes, spacing).  Only the keys you provide are overridden; all others
@@ -645,12 +675,45 @@ interface ChartConfig {
      * of bars. Default: 200.
      */
     maxCandles?: number;
+    /**
+     * How close (in bars) the viewport must be to the start of loaded data
+     * before a historical fetch is triggered. Higher values prefetch earlier.
+     * Clamped to a minimum of 20. Default: 80 (one screen-width of bars).
+     */
+    prefetchThreshold?: number;
     /**
      * On touch/mobile devices, the initial visible bar count is
      * `DEFAULT_VISIBLE_BARS / mobileBarDivisor`. Accepted values: 2, 3, 4.
      * Default: `2`.
      */
     mobileBarDivisor?: 2 | 3 | 4;
+    /**
+     * Enable momentum (kinetic) scrolling on drag release. When `true`, releasing
+     * a fast pan gesture lets the chart continue scrolling with gradually
+     * decelerating speed — matching the feel of native iOS/Android scroll views.
+     * Default: `true`.
+     */
+    momentumScrollEnabled?: boolean;
+    /**
+     * Per-frame velocity decay factor for momentum scrolling, normalised to 60 fps.
+     * A value of `0.95` means the viewport retains 95% of its speed each 16.67 ms
+     * frame. Lower values stop faster; higher values coast longer.
+     * Clamped to `[0.80, 0.99]`. Default: `0.95`.
+     */
+    momentumDecay?: number;
+    /**
+     * Minimum release velocity (px/ms) required to trigger a momentum scroll.
+     * Swipes slower than this threshold stop immediately on finger-up.
+     * Raising this value suppresses momentum for slow drags while still triggering
+     * on fast flicks. Default: `0.3`.
+     */
+    momentumThreshold?: number;
+    /**
+     * Maximum initial launch velocity (px/ms) for momentum scrolling.
+     * Caps runaway fast-flick launches that would scroll hundreds of bars in one
+     * gesture. Default: `6.0`.
+     */
+    momentumMaxVelocity?: number;
     /**
      * Initial number of candles visible when the chart first loads (desktop).
      * On mobile this value is further divided by `mobileBarDivisor` unless
@@ -761,6 +824,21 @@ interface ChartConfig {
      * }
      */
     aggregateFrom?: Partial<Record<Timeframe, Timeframe>>;
+    /**
+     * Enable trade-level fan-out clustering. When `true`, overlapping
+     * trade levels whose Y pixel positions are within `clusterThresholdDistance`
+     * pixels are grouped into a single expandable cluster badge.
+     * Default: `true`.
+     */
+    levelClusteringEnabled?: boolean;
+    /**
+     * Pixel proximity threshold for level clustering. Levels whose Y pixel
+     * positions are within this distance get grouped into a cluster.
+     * Only effective when `levelClusteringEnabled` is `true` (default). Set to
+     * a higher value for more aggressive grouping, lower for tighter grouping.
+     * Default: `20`.
+     */
+    clusterThresholdDistance?: number;
     /**
      * Hide the ✓ / ✗ confirm-cancel buttons on trade levels that have pending changes.
      * Use when the host app provides its own native confirm/cancel controls.
@@ -772,11 +850,30 @@ interface ChartConfig {
      * Default: `false` — the toggle is hidden.
      */
     enableThemeToggle?: boolean;
+    /**
+     * Hide the symbol name, OHLC strip, and tick-activity dot overlay
+     * shown in the top-left corner of the chart canvas.
+     * Default: `false` (overlay is visible).
+     */
+    hideSymbolAndTick?: boolean;
+    /**
+     * Show the bottom duration-selector bar.
+     * Default: `false` (bar is hidden).
+     */
+    showBottomBar?: boolean;
     /**
      * @deprecated DraftOrderQtyInput has been removed. This option is a no-op.
      * Accepted for backward compatibility only.
      */
     hideQtyButton?: boolean;
+    /**
+     * Enable TFC (Trade from Charts) functionality.
+     * When `false`, the TFC toggle button is never shown and all trade levels,
+     * trade button, and trade popover are completely disabled.
+     * When `true` (default), a TFC toggle button appears in the top bar
+     * allowing the user to enable/disable TFC at runtime.
+     */
+    tfcEnabled?: boolean;
 }
 interface IndicatorResult {
     index: number;
@@ -896,6 +993,8 @@ interface ChartState {
         dark?: Partial<CanvasColorSettings>;
         light?: Partial<CanvasColorSettings>;
     };
+    /** Whether TFC (Trade from Charts) is currently active (user toggle state). */
+    tfcEnabled?: boolean;
 }
 interface CrosshairPosition {
     x: number;
@@ -1032,6 +1131,10 @@ type ChartEventMap = {
         price: number;
         isFullscreen: boolean;
     };
+    /** Emitted when TFC (Trade from Charts) is toggled on or off via the top bar button or API. */
+    tfcToggle: {
+        enabled: boolean;
+    };
     /** Emitted when the user confirms all edits to a level — replaces separate tradeLevelDragEnd / tradeLevelBracketDrag events. */
     tradeLevelEdit: {
         label: string;
@@ -1240,4 +1343,4 @@ declare class MACD implements IIndicator {
     render(ctx: CanvasRenderingContext2D, results: IndicatorResult[], scale: ScaleManager, viewport: Viewport, paneHeight: number, rangeOverride?: PriceRange): void;
 }
 
-export { type IndicatorOverlayUiConfig as $, type AnyLevel as A, BollingerBands as B, type ChartConfig as C, type DrawingToolType as D, DEFAULT_INDICATOR_OVERLAY_CONFIG as E, DEFAULT_LABELS as F, DEFAULT_PRICE_AXIS_CONFIG as G, DEFAULT_TIME_AXIS_CONFIG as H, type IIndicator as I, DEFAULT_TOP_BAR_CONFIG as J, DEFAULT_TRADE_BUTTON_CONFIG as K, DEFAULT_UI_CONFIG as L, type DataLoaderParams as M, type DeepPartial$1 as N, type OHLCVBar as O, type PriceRange as P, type DeepPartialChartTheme as Q, type DialogLabels as R, type SeriesType as S, type Timeframe as T, type DrawingToolbarColors as U, type Viewport as V, type DrawingToolbarLabels as W, type DrawingToolbarUiConfig as X, type Duration as Y, EMA as Z, type IndicatorOverlayColors as _, type ChartEventMap as a, type IndicatorParams as a0, type IndicatorResult as a1, type IndicatorStateEntry as a2, LIGHT_THEME as a3, MACD as a4, type OhlcLabels as a5, type OrderSubmit as a6, type Padding as a7, type PendingOrderLevel as a8, type PositionLevel as a9, type PositionRenderStyle as aa, type PriceAxisUiConfig as ab, RSI as ac, SMA as ad, type Theme as ae, type TimeAxisUiConfig as af, type TopBarColors as ag, type TopBarLabels as ah, type TopBarUiConfig as ai, type TradeButtonUiConfig as aj, type TradeDisplayFilter as ak, type TradeLabels as al, type TradeLevel as am, type TradeLevelColors as an, type TradePanelColors as ao, type UiConfig as ap, deepMergeTheme as aq, resolveCssVarsInTheme as ar, resolveLabels as as, resolveUiConfig as at, type PriceSource as au, type ChartState as b, type IDrawing as c, type IWebSocketAdapter as d, type TradeLevelType as e, type DrawingPoint as f, ScaleManager as g, type DrawingHandle as h, type SerializedDrawing as i, type Tick as j, type StreamStatus as k, type ActiveIndicatorState as l, type BottomBarColors as m, type BottomBarLabels as n, type BottomBarUiConfig as o, type CanvasColorSettings as p, type ChartLabels as q, type ChartMiscLabels as r, type ChartTheme as s, type ChartThemeUi as t, type CrosshairPosition as u, type CrosshairUiConfig as v, DARK_THEME as w, DEFAULT_BOTTOM_BAR_CONFIG as x, DEFAULT_CROSSHAIR_CONFIG as y, DEFAULT_DRAWING_TOOLBAR_CONFIG as z };
+export { type IndicatorOverlayUiConfig as $, type AnyLevel as A, BollingerBands as B, type ChartConfig as C, type DrawingToolType as D, DEFAULT_INDICATOR_OVERLAY_CONFIG as E, DEFAULT_LABELS as F, DEFAULT_PRICE_AXIS_CONFIG as G, DEFAULT_TIME_AXIS_CONFIG as H, type IIndicator as I, DEFAULT_TOP_BAR_CONFIG as J, DEFAULT_TRADE_BUTTON_CONFIG as K, DEFAULT_UI_CONFIG as L, type DataLoaderParams as M, type DeepPartial$1 as N, type OHLCVBar as O, type PriceRange as P, type DeepPartialChartTheme as Q, type DialogLabels as R, type SeriesType as S, type Timeframe as T, type DrawingToolbarColors as U, type Viewport as V, type DrawingToolbarLabels as W, type DrawingToolbarUiConfig as X, type Duration as Y, EMA as Z, type IndicatorOverlayColors as _, type ChartEventMap as a, type IndicatorParams as a0, type IndicatorResult as a1, type IndicatorStateEntry as a2, LIGHT_THEME as a3, MACD as a4, type OhlcLabels as a5, type OrderSubmit as a6, type Padding as a7, type PendingOrderLevel as a8, type PositionLevel as a9, type PositionRenderStyle as aa, type PriceAxisUiConfig as ab, RSI as ac, SMA as ad, type Theme as ae, type ThemeOverrides as af, type TimeAxisUiConfig as ag, type TopBarColors as ah, type TopBarLabels as ai, type TopBarUiConfig as aj, type TradeButtonUiConfig as ak, type TradeDisplayFilter as al, type TradeLabels as am, type TradeLevel as an, type TradeLevelColors as ao, type TradePanelColors as ap, type UiConfig as aq, deepMergeTheme as ar, resolveCssVarsInTheme as as, resolveLabels as at, resolveUiConfig as au, type PriceSource as av, type ChartState as b, type IDrawing as c, type IWebSocketAdapter as d, type TradeLevelType as e, type DrawingPoint as f, ScaleManager as g, type DrawingHandle as h, type SerializedDrawing as i, type Tick as j, type StreamStatus as k, type ActiveIndicatorState as l, type BottomBarColors as m, type BottomBarLabels as n, type BottomBarUiConfig as o, type CanvasColorSettings as p, type ChartLabels as q, type ChartMiscLabels as r, type ChartTheme as s, type ChartThemeUi as t, type CrosshairPosition as u, type CrosshairUiConfig as v, DARK_THEME as w, DEFAULT_BOTTOM_BAR_CONFIG as x, DEFAULT_CROSSHAIR_CONFIG as y, DEFAULT_DRAWING_TOOLBAR_CONFIG as z };

package/dist/{MACD-CEmdbwGz.d.ts → MACD-DVxcNurb.d.ts}

@@ -189,6 +189,8 @@ interface TopBarLabels {
     exitFullscreenTitle: string;
     /** Tooltip on the chart-settings button. */
     settingsTitle: string;
+    /** Tooltip on the TFC (Trade from Charts) toggle button. */
+    tfcToggleTitle: string;
 }
 interface BottomBarLabels {
     /** Duration selector button labels. */
@@ -528,6 +530,14 @@ interface DataLoaderParams {
     end: Date;
     interval: string;
 }
+/**
+ * Per-theme deep-partial color overrides applied on top of the built-in
+ * dark / light themes.  Only the keys you supply are replaced.
+ */
+type ThemeOverrides = {
+    dark?: DeepPartialChartTheme;
+    light?: DeepPartialChartTheme;
+};
 interface ChartConfig {
     container: HTMLElement;
     theme?: Theme;
@@ -558,6 +568,22 @@ interface ChartConfig {
      * Minimum (and default) lot size for draft order submission. Default: `1`.
      */
     minLots?: number;
+    /**
+     * When true, renders an editable QTY pill at the left of the draft order
+     * info box. Clicking the pill opens a flyout to edit the quantity. Default: `false`.
+     */
+    showQuantityField?: boolean;
+    /**
+     * Constraints for the draft order QTY field. Only relevant when
+     * `showQuantityField` is true. `minLots` also sets the initial quantity
+     * and the step value for the flyout input.
+     */
+    quantityFieldConfig?: {
+        /** Minimum lot size, step size, and initial quantity (e.g. `0.01`). Default: `1` */
+        minLots?: number;
+        /** Maximum lot size (e.g. `100`). Default: `100` */
+        maxLots?: number;
+    };
     /** Called when user submits an order via the floating trade button */
     onOrderSubmit?: (order: OrderSubmit) => void;
     /**
@@ -610,10 +636,14 @@ interface ChartConfig {
      *   light: { background: 'var(--sidebar-bg-light)' },
      * }
      */
-    themeOverrides?: {
-        dark?: DeepPartialChartTheme;
-        light?: DeepPartialChartTheme;
-    };
+    themeOverrides?: ThemeOverrides;
+    /**
+     * IANA timezone string for all time-axis and crosshair labels.
+     * `"UTC"` (default) preserves existing behavior.
+     * `"local"` uses the browser/device timezone automatically.
+     * Any IANA string is accepted: `"America/New_York"`, `"Europe/London"`, etc.
+     */
+    timezone?: string;
     /**
      * Optional per-component UI configuration overrides (font sizes, icon
      * sizes, spacing).  Only the keys you provide are overridden; all others
@@ -645,12 +675,45 @@ interface ChartConfig {
      * of bars. Default: 200.
      */
     maxCandles?: number;
+    /**
+     * How close (in bars) the viewport must be to the start of loaded data
+     * before a historical fetch is triggered. Higher values prefetch earlier.
+     * Clamped to a minimum of 20. Default: 80 (one screen-width of bars).
+     */
+    prefetchThreshold?: number;
     /**
      * On touch/mobile devices, the initial visible bar count is
      * `DEFAULT_VISIBLE_BARS / mobileBarDivisor`. Accepted values: 2, 3, 4.
      * Default: `2`.
      */
     mobileBarDivisor?: 2 | 3 | 4;
+    /**
+     * Enable momentum (kinetic) scrolling on drag release. When `true`, releasing
+     * a fast pan gesture lets the chart continue scrolling with gradually
+     * decelerating speed — matching the feel of native iOS/Android scroll views.
+     * Default: `true`.
+     */
+    momentumScrollEnabled?: boolean;
+    /**
+     * Per-frame velocity decay factor for momentum scrolling, normalised to 60 fps.
+     * A value of `0.95` means the viewport retains 95% of its speed each 16.67 ms
+     * frame. Lower values stop faster; higher values coast longer.
+     * Clamped to `[0.80, 0.99]`. Default: `0.95`.
+     */
+    momentumDecay?: number;
+    /**
+     * Minimum release velocity (px/ms) required to trigger a momentum scroll.
+     * Swipes slower than this threshold stop immediately on finger-up.
+     * Raising this value suppresses momentum for slow drags while still triggering
+     * on fast flicks. Default: `0.3`.
+     */
+    momentumThreshold?: number;
+    /**
+     * Maximum initial launch velocity (px/ms) for momentum scrolling.
+     * Caps runaway fast-flick launches that would scroll hundreds of bars in one
+     * gesture. Default: `6.0`.
+     */
+    momentumMaxVelocity?: number;
     /**
      * Initial number of candles visible when the chart first loads (desktop).
      * On mobile this value is further divided by `mobileBarDivisor` unless
@@ -761,6 +824,21 @@ interface ChartConfig {
      * }
      */
     aggregateFrom?: Partial<Record<Timeframe, Timeframe>>;
+    /**
+     * Enable trade-level fan-out clustering. When `true`, overlapping
+     * trade levels whose Y pixel positions are within `clusterThresholdDistance`
+     * pixels are grouped into a single expandable cluster badge.
+     * Default: `true`.
+     */
+    levelClusteringEnabled?: boolean;
+    /**
+     * Pixel proximity threshold for level clustering. Levels whose Y pixel
+     * positions are within this distance get grouped into a cluster.
+     * Only effective when `levelClusteringEnabled` is `true` (default). Set to
+     * a higher value for more aggressive grouping, lower for tighter grouping.
+     * Default: `20`.
+     */
+    clusterThresholdDistance?: number;
     /**
      * Hide the ✓ / ✗ confirm-cancel buttons on trade levels that have pending changes.
      * Use when the host app provides its own native confirm/cancel controls.
@@ -772,11 +850,30 @@ interface ChartConfig {
      * Default: `false` — the toggle is hidden.
      */
     enableThemeToggle?: boolean;
+    /**
+     * Hide the symbol name, OHLC strip, and tick-activity dot overlay
+     * shown in the top-left corner of the chart canvas.
+     * Default: `false` (overlay is visible).
+     */
+    hideSymbolAndTick?: boolean;
+    /**
+     * Show the bottom duration-selector bar.
+     * Default: `false` (bar is hidden).
+     */
+    showBottomBar?: boolean;
     /**
      * @deprecated DraftOrderQtyInput has been removed. This option is a no-op.
      * Accepted for backward compatibility only.
      */
     hideQtyButton?: boolean;
+    /**
+     * Enable TFC (Trade from Charts) functionality.
+     * When `false`, the TFC toggle button is never shown and all trade levels,
+     * trade button, and trade popover are completely disabled.
+     * When `true` (default), a TFC toggle button appears in the top bar
+     * allowing the user to enable/disable TFC at runtime.
+     */
+    tfcEnabled?: boolean;
 }
 interface IndicatorResult {
     index: number;
@@ -896,6 +993,8 @@ interface ChartState {
         dark?: Partial<CanvasColorSettings>;
         light?: Partial<CanvasColorSettings>;
     };
+    /** Whether TFC (Trade from Charts) is currently active (user toggle state). */
+    tfcEnabled?: boolean;
 }
 interface CrosshairPosition {
     x: number;
@@ -1032,6 +1131,10 @@ type ChartEventMap = {
         price: number;
         isFullscreen: boolean;
     };
+    /** Emitted when TFC (Trade from Charts) is toggled on or off via the top bar button or API. */
+    tfcToggle: {
+        enabled: boolean;
+    };
     /** Emitted when the user confirms all edits to a level — replaces separate tradeLevelDragEnd / tradeLevelBracketDrag events. */
     tradeLevelEdit: {
         label: string;
@@ -1240,4 +1343,4 @@ declare class MACD implements IIndicator {
     render(ctx: CanvasRenderingContext2D, results: IndicatorResult[], scale: ScaleManager, viewport: Viewport, paneHeight: number, rangeOverride?: PriceRange): void;
 }
 
-export { type IndicatorOverlayUiConfig as $, type AnyLevel as A, BollingerBands as B, type ChartConfig as C, type DrawingToolType as D, DEFAULT_INDICATOR_OVERLAY_CONFIG as E, DEFAULT_LABELS as F, DEFAULT_PRICE_AXIS_CONFIG as G, DEFAULT_TIME_AXIS_CONFIG as H, type IIndicator as I, DEFAULT_TOP_BAR_CONFIG as J, DEFAULT_TRADE_BUTTON_CONFIG as K, DEFAULT_UI_CONFIG as L, type DataLoaderParams as M, type DeepPartial$1 as N, type OHLCVBar as O, type PriceRange as P, type DeepPartialChartTheme as Q, type DialogLabels as R, type SeriesType as S, type Timeframe as T, type DrawingToolbarColors as U, type Viewport as V, type DrawingToolbarLabels as W, type DrawingToolbarUiConfig as X, type Duration as Y, EMA as Z, type IndicatorOverlayColors as _, type ChartEventMap as a, type IndicatorParams as a0, type IndicatorResult as a1, type IndicatorStateEntry as a2, LIGHT_THEME as a3, MACD as a4, type OhlcLabels as a5, type OrderSubmit as a6, type Padding as a7, type PendingOrderLevel as a8, type PositionLevel as a9, type PositionRenderStyle as aa, type PriceAxisUiConfig as ab, RSI as ac, SMA as ad, type Theme as ae, type TimeAxisUiConfig as af, type TopBarColors as ag, type TopBarLabels as ah, type TopBarUiConfig as ai, type TradeButtonUiConfig as aj, type TradeDisplayFilter as ak, type TradeLabels as al, type TradeLevel as am, type TradeLevelColors as an, type TradePanelColors as ao, type UiConfig as ap, deepMergeTheme as aq, resolveCssVarsInTheme as ar, resolveLabels as as, resolveUiConfig as at, type PriceSource as au, type ChartState as b, type IDrawing as c, type IWebSocketAdapter as d, type TradeLevelType as e, type DrawingPoint as f, ScaleManager as g, type DrawingHandle as h, type SerializedDrawing as i, type Tick as j, type StreamStatus as k, type ActiveIndicatorState as l, type BottomBarColors as m, type BottomBarLabels as n, type BottomBarUiConfig as o, type CanvasColorSettings as p, type ChartLabels as q, type ChartMiscLabels as r, type ChartTheme as s, type ChartThemeUi as t, type CrosshairPosition as u, type CrosshairUiConfig as v, DARK_THEME as w, DEFAULT_BOTTOM_BAR_CONFIG as x, DEFAULT_CROSSHAIR_CONFIG as y, DEFAULT_DRAWING_TOOLBAR_CONFIG as z };
+export { type IndicatorOverlayUiConfig as $, type AnyLevel as A, BollingerBands as B, type ChartConfig as C, type DrawingToolType as D, DEFAULT_INDICATOR_OVERLAY_CONFIG as E, DEFAULT_LABELS as F, DEFAULT_PRICE_AXIS_CONFIG as G, DEFAULT_TIME_AXIS_CONFIG as H, type IIndicator as I, DEFAULT_TOP_BAR_CONFIG as J, DEFAULT_TRADE_BUTTON_CONFIG as K, DEFAULT_UI_CONFIG as L, type DataLoaderParams as M, type DeepPartial$1 as N, type OHLCVBar as O, type PriceRange as P, type DeepPartialChartTheme as Q, type DialogLabels as R, type SeriesType as S, type Timeframe as T, type DrawingToolbarColors as U, type Viewport as V, type DrawingToolbarLabels as W, type DrawingToolbarUiConfig as X, type Duration as Y, EMA as Z, type IndicatorOverlayColors as _, type ChartEventMap as a, type IndicatorParams as a0, type IndicatorResult as a1, type IndicatorStateEntry as a2, LIGHT_THEME as a3, MACD as a4, type OhlcLabels as a5, type OrderSubmit as a6, type Padding as a7, type PendingOrderLevel as a8, type PositionLevel as a9, type PositionRenderStyle as aa, type PriceAxisUiConfig as ab, RSI as ac, SMA as ad, type Theme as ae, type ThemeOverrides as af, type TimeAxisUiConfig as ag, type TopBarColors as ah, type TopBarLabels as ai, type TopBarUiConfig as aj, type TradeButtonUiConfig as ak, type TradeDisplayFilter as al, type TradeLabels as am, type TradeLevel as an, type TradeLevelColors as ao, type TradePanelColors as ap, type UiConfig as aq, deepMergeTheme as ar, resolveCssVarsInTheme as as, resolveLabels as at, resolveUiConfig as au, type PriceSource as av, type ChartState as b, type IDrawing as c, type IWebSocketAdapter as d, type TradeLevelType as e, type DrawingPoint as f, ScaleManager as g, type DrawingHandle as h, type SerializedDrawing as i, type Tick as j, type StreamStatus as k, type ActiveIndicatorState as l, type BottomBarColors as m, type BottomBarLabels as n, type BottomBarUiConfig as o, type CanvasColorSettings as p, type ChartLabels as q, type ChartMiscLabels as r, type ChartTheme as s, type ChartThemeUi as t, type CrosshairPosition as u, type CrosshairUiConfig as v, DARK_THEME as w, DEFAULT_BOTTOM_BAR_CONFIG as x, DEFAULT_CROSSHAIR_CONFIG as y, DEFAULT_DRAWING_TOOLBAR_CONFIG as z };