acttrader-charts 1.0.12 → 1.0.14

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 |
@@ -218,7 +222,7 @@ When `enableTrading` is on and live BID/ASK data is streaming, hovering / activa
 | `theme` | | `"dark"` | `"dark"` or `"light"` |
 | `series` | | `"candlestick"` | Initial chart type |
 | `showVolume` | | `true` | Show volume overlay |
-| `showUI` | | `true` | Render top / bottom / left bars |
+| `showUI` | | `true` | Render top / bottom / left bars. When `false`, the loading overlay is also suppressed (mobile wrappers provide their own) |
 | `showDrawingTools` | | `true` | Show drawing toolbar and pencil button |
 | `timeframe` | | `"1D"` | Initial timeframe |
 | `duration` | | — | Initial active duration button |
@@ -229,6 +233,7 @@ 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`) |
 | `targetCandleWidth` | | `10` | Target px width per candle for auto-calculating initial bar count |
 | `durationTimeframeMap` | | *(see below)* | Override duration → timeframe pairings |
@@ -245,6 +250,11 @@ 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 |
 | `tradesThresholdForHorizontalLine` | | `2` | Level count above which render auto-switches to `"dot"` mode |
 | `canvasColors` | | — | Per-theme canvas background color overrides (persisted from Settings dialog) |
@@ -295,12 +305,15 @@ import { DEFAULT_UI_CONFIG } from 'acttrader-charts';
 | Component key | Configurable properties |
 |---|---|
 | `drawingToolbar` | `iconBtnSize`, `iconFontSize`, `iconFontFamily`, `flyoutLabelFontSize`, `flyoutLabelFontFamily`, `shortcutFontSize`, `soonBadgeFontSize`, `flyoutHeadingFontSize`, `flyoutHeadingLetterSpacing`, `scrollBtnHeight`, `scrollBtnFontSize`, `barPadding`, `btnGap` |
-| `topBar` | `height`, `dropBtnFontSize`, `dropBtnFontFamily`, `drawBtnSize`, `drawBtnIconFontSize`, `flyoutRowFontSize`, `flyoutRowFontFamily`, `flyoutCategoryFontSize`, `flyoutCategoryLetterSpacing`, `flyoutCheckFontSize`, `streamDotSize` |
+| `topBar` | `height`, `dropBtnFontSize`, `dropBtnFontFamily`, `drawBtnSize`, `drawBtnIconFontSize`, `iconBtnSize`, `mobileIconBtnSize`, `mobileDrawBtnIconSize`, `flyoutRowFontSize`, `flyoutRowFontFamily`, `flyoutCategoryFontSize`, `flyoutCategoryLetterSpacing`, `flyoutCheckFontSize`, `streamDotSize` |
 | `bottomBar` | `height`, `btnFontSize`, `btnFontFamily` |
 | `priceAxis` | `fontSize`, `fontFamily` |
 | `timeAxis` | `fontSize`, `fontFamily` |
 | `crosshair` | `labelHeight`, `labelPaddingX`, `fontSize`, `fontFamily` |
 | `indicatorOverlay` | `pillFontSize`, `pillFontFamily`, `dotFontSize`, `pillIconFontSize`, `collapseBtnFontSize`, `collapseBtnFontFamily`, `dropdownRowFontSize`, `dropdownRowFontFamily`, `dropdownIconFontSize` |
+| `tradeButton` | `size`, `mobileSize`, `iconSize`, `mobileIconSize` |
+
+**Mobile icon sizing:** When the chart container is narrower than `drawingToolbar.mobileBreakpoint` (default `480`), the top-bar icon buttons (settings, fullscreen, drawing toggle) and the floating trade ⊕ button use their mobile sizes automatically. Defaults: top-bar icon buttons grow `26px → 28px` (icon SVG +2px), trade button grows `22px → 24px` (icon `14px → 16px`). Override any of these values via `uiConfig.topBar.mobileIconBtnSize`, `uiConfig.topBar.mobileDrawBtnIconSize`, or `uiConfig.tradeButton.mobileSize` / `mobileIconSize`.
 
 **Example:**
 
@@ -324,6 +337,7 @@ import {
     DEFAULT_TOP_BAR_CONFIG,
     DEFAULT_PRICE_AXIS_CONFIG,
     DEFAULT_CROSSHAIR_CONFIG,
+    DEFAULT_TRADE_BUTTON_CONFIG,
     // ...
 } from 'acttrader-charts';
 ```
@@ -472,6 +486,8 @@ chart.setLoading(loading: boolean): this
 ```ts
 chart.setSeries(series: SeriesType): this
 chart.setTheme('dark' | 'light'): this
+chart.setTimeframe(tf: Timeframe): this                         // change timeframe and reload data
+chart.setThemeOverrides(overrides: ThemeOverrides): this               // update per-theme color overrides at runtime
 chart.setVolume(show: boolean): this
 ```
 
@@ -498,6 +514,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
@@ -674,6 +691,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-DoO45b_C.d.cts → MACD-CxJLGBBd.d.cts}

@@ -49,6 +49,12 @@ interface TopBarUiConfig {
     drawBtnSize: string;
     /** Font size for the icon inside the drawing toggle button */
     drawBtnIconFontSize: string;
+    /** Size (width = height) of icon-only buttons (settings, fullscreen) — desktop */
+    iconBtnSize: string;
+    /** Size (width = height) of icon-only buttons — mobile override */
+    mobileIconBtnSize: string;
+    /** SVG icon dimension inside the drawing toggle button — mobile override */
+    mobileDrawBtnIconSize: string;
     /** Font size for flyout list rows */
     flyoutRowFontSize: string;
     /** Font family for flyout list rows */
@@ -112,6 +118,16 @@ interface IndicatorOverlayUiConfig {
     /** Font size for gear ⚙ and remove ✕ icons inside dropdown rows */
     dropdownIconFontSize: string;
 }
+interface TradeButtonUiConfig {
+    /** Button diameter (px) — desktop */
+    size: number;
+    /** Button diameter (px) — mobile override */
+    mobileSize: number;
+    /** SVG icon dimension (px) — desktop */
+    iconSize: number;
+    /** SVG icon dimension (px) — mobile override */
+    mobileIconSize: number;
+}
 interface UiConfig {
     drawingToolbar: DrawingToolbarUiConfig;
     topBar: TopBarUiConfig;
@@ -120,6 +136,7 @@ interface UiConfig {
     timeAxis: TimeAxisUiConfig;
     crosshair: CrosshairUiConfig;
     indicatorOverlay: IndicatorOverlayUiConfig;
+    tradeButton: TradeButtonUiConfig;
 }
 declare const DEFAULT_DRAWING_TOOLBAR_CONFIG: DrawingToolbarUiConfig;
 declare const DEFAULT_TOP_BAR_CONFIG: TopBarUiConfig;
@@ -128,6 +145,7 @@ declare const DEFAULT_PRICE_AXIS_CONFIG: PriceAxisUiConfig;
 declare const DEFAULT_TIME_AXIS_CONFIG: TimeAxisUiConfig;
 declare const DEFAULT_CROSSHAIR_CONFIG: CrosshairUiConfig;
 declare const DEFAULT_INDICATOR_OVERLAY_CONFIG: IndicatorOverlayUiConfig;
+declare const DEFAULT_TRADE_BUTTON_CONFIG: TradeButtonUiConfig;
 declare const DEFAULT_UI_CONFIG: UiConfig;
 type DeepPartial$1<T> = {
     [K in keyof T]?: T[K] extends object ? DeepPartial$1<T[K]> : T[K];
@@ -171,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. */
@@ -510,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;
@@ -592,10 +620,7 @@ interface ChartConfig {
      *   light: { background: 'var(--sidebar-bg-light)' },
      * }
      */
-    themeOverrides?: {
-        dark?: DeepPartialChartTheme;
-        light?: DeepPartialChartTheme;
-    };
+    themeOverrides?: ThemeOverrides;
     /**
      * Optional per-component UI configuration overrides (font sizes, icon
      * sizes, spacing).  Only the keys you provide are overridden; all others
@@ -627,6 +652,12 @@ 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.
@@ -743,6 +774,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.
@@ -754,11 +800,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;
@@ -878,6 +943,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;
@@ -1014,6 +1081,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;
@@ -1222,4 +1293,4 @@ declare class MACD implements IIndicator {
     render(ctx: CanvasRenderingContext2D, results: IndicatorResult[], scale: ScaleManager, viewport: Viewport, paneHeight: number, rangeOverride?: PriceRange): void;
 }
 
-export { type IndicatorResult as $, type AnyLevel as A, BollingerBands as B, type ChartConfig as C, type DrawingToolType as D, DEFAULT_LABELS as E, DEFAULT_PRICE_AXIS_CONFIG as F, DEFAULT_TIME_AXIS_CONFIG as G, DEFAULT_TOP_BAR_CONFIG as H, type IIndicator as I, DEFAULT_UI_CONFIG as J, type DataLoaderParams as K, type DeepPartial$1 as L, type DeepPartialChartTheme as M, type DialogLabels as N, type OHLCVBar as O, type PriceRange as P, type DrawingToolbarColors as Q, type DrawingToolbarLabels as R, type SeriesType as S, type TradeLevelType as T, type DrawingToolbarUiConfig as U, type Viewport as V, type Duration as W, EMA as X, type IndicatorOverlayColors as Y, type IndicatorOverlayUiConfig as Z, type IndicatorParams as _, type ChartEventMap as a, type IndicatorStateEntry as a0, LIGHT_THEME as a1, MACD as a2, type OhlcLabels as a3, type OrderSubmit as a4, type Padding as a5, type PendingOrderLevel as a6, type PositionLevel as a7, type PositionRenderStyle as a8, type PriceAxisUiConfig as a9, RSI as aa, SMA as ab, type Theme as ac, type TimeAxisUiConfig as ad, type Timeframe as ae, type TopBarColors as af, type TopBarLabels as ag, type TopBarUiConfig as ah, type TradeDisplayFilter as ai, type TradeLabels as aj, type TradeLevel as ak, type TradeLevelColors as al, type TradePanelColors as am, type UiConfig as an, deepMergeTheme as ao, resolveCssVarsInTheme as ap, resolveLabels as aq, resolveUiConfig as ar, type PriceSource as as, type ChartState as b, type IDrawing as c, type IWebSocketAdapter as d, type DrawingPoint as e, ScaleManager as f, type DrawingHandle as g, type SerializedDrawing as h, type Tick as i, type StreamStatus as j, type ActiveIndicatorState as k, type BottomBarColors as l, type BottomBarLabels as m, type BottomBarUiConfig as n, type CanvasColorSettings as o, type ChartLabels as p, type ChartMiscLabels as q, type ChartTheme as r, type ChartThemeUi as s, type CrosshairPosition as t, type CrosshairUiConfig as u, DARK_THEME as v, DEFAULT_BOTTOM_BAR_CONFIG as w, DEFAULT_CROSSHAIR_CONFIG as x, DEFAULT_DRAWING_TOOLBAR_CONFIG as y, DEFAULT_INDICATOR_OVERLAY_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-DoO45b_C.d.ts → MACD-CxJLGBBd.d.ts}

@@ -49,6 +49,12 @@ interface TopBarUiConfig {
     drawBtnSize: string;
     /** Font size for the icon inside the drawing toggle button */
     drawBtnIconFontSize: string;
+    /** Size (width = height) of icon-only buttons (settings, fullscreen) — desktop */
+    iconBtnSize: string;
+    /** Size (width = height) of icon-only buttons — mobile override */
+    mobileIconBtnSize: string;
+    /** SVG icon dimension inside the drawing toggle button — mobile override */
+    mobileDrawBtnIconSize: string;
     /** Font size for flyout list rows */
     flyoutRowFontSize: string;
     /** Font family for flyout list rows */
@@ -112,6 +118,16 @@ interface IndicatorOverlayUiConfig {
     /** Font size for gear ⚙ and remove ✕ icons inside dropdown rows */
     dropdownIconFontSize: string;
 }
+interface TradeButtonUiConfig {
+    /** Button diameter (px) — desktop */
+    size: number;
+    /** Button diameter (px) — mobile override */
+    mobileSize: number;
+    /** SVG icon dimension (px) — desktop */
+    iconSize: number;
+    /** SVG icon dimension (px) — mobile override */
+    mobileIconSize: number;
+}
 interface UiConfig {
     drawingToolbar: DrawingToolbarUiConfig;
     topBar: TopBarUiConfig;
@@ -120,6 +136,7 @@ interface UiConfig {
     timeAxis: TimeAxisUiConfig;
     crosshair: CrosshairUiConfig;
     indicatorOverlay: IndicatorOverlayUiConfig;
+    tradeButton: TradeButtonUiConfig;
 }
 declare const DEFAULT_DRAWING_TOOLBAR_CONFIG: DrawingToolbarUiConfig;
 declare const DEFAULT_TOP_BAR_CONFIG: TopBarUiConfig;
@@ -128,6 +145,7 @@ declare const DEFAULT_PRICE_AXIS_CONFIG: PriceAxisUiConfig;
 declare const DEFAULT_TIME_AXIS_CONFIG: TimeAxisUiConfig;
 declare const DEFAULT_CROSSHAIR_CONFIG: CrosshairUiConfig;
 declare const DEFAULT_INDICATOR_OVERLAY_CONFIG: IndicatorOverlayUiConfig;
+declare const DEFAULT_TRADE_BUTTON_CONFIG: TradeButtonUiConfig;
 declare const DEFAULT_UI_CONFIG: UiConfig;
 type DeepPartial$1<T> = {
     [K in keyof T]?: T[K] extends object ? DeepPartial$1<T[K]> : T[K];
@@ -171,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. */
@@ -510,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;
@@ -592,10 +620,7 @@ interface ChartConfig {
      *   light: { background: 'var(--sidebar-bg-light)' },
      * }
      */
-    themeOverrides?: {
-        dark?: DeepPartialChartTheme;
-        light?: DeepPartialChartTheme;
-    };
+    themeOverrides?: ThemeOverrides;
     /**
      * Optional per-component UI configuration overrides (font sizes, icon
      * sizes, spacing).  Only the keys you provide are overridden; all others
@@ -627,6 +652,12 @@ 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.
@@ -743,6 +774,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.
@@ -754,11 +800,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;
@@ -878,6 +943,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;
@@ -1014,6 +1081,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;
@@ -1222,4 +1293,4 @@ declare class MACD implements IIndicator {
     render(ctx: CanvasRenderingContext2D, results: IndicatorResult[], scale: ScaleManager, viewport: Viewport, paneHeight: number, rangeOverride?: PriceRange): void;
 }
 
-export { type IndicatorResult as $, type AnyLevel as A, BollingerBands as B, type ChartConfig as C, type DrawingToolType as D, DEFAULT_LABELS as E, DEFAULT_PRICE_AXIS_CONFIG as F, DEFAULT_TIME_AXIS_CONFIG as G, DEFAULT_TOP_BAR_CONFIG as H, type IIndicator as I, DEFAULT_UI_CONFIG as J, type DataLoaderParams as K, type DeepPartial$1 as L, type DeepPartialChartTheme as M, type DialogLabels as N, type OHLCVBar as O, type PriceRange as P, type DrawingToolbarColors as Q, type DrawingToolbarLabels as R, type SeriesType as S, type TradeLevelType as T, type DrawingToolbarUiConfig as U, type Viewport as V, type Duration as W, EMA as X, type IndicatorOverlayColors as Y, type IndicatorOverlayUiConfig as Z, type IndicatorParams as _, type ChartEventMap as a, type IndicatorStateEntry as a0, LIGHT_THEME as a1, MACD as a2, type OhlcLabels as a3, type OrderSubmit as a4, type Padding as a5, type PendingOrderLevel as a6, type PositionLevel as a7, type PositionRenderStyle as a8, type PriceAxisUiConfig as a9, RSI as aa, SMA as ab, type Theme as ac, type TimeAxisUiConfig as ad, type Timeframe as ae, type TopBarColors as af, type TopBarLabels as ag, type TopBarUiConfig as ah, type TradeDisplayFilter as ai, type TradeLabels as aj, type TradeLevel as ak, type TradeLevelColors as al, type TradePanelColors as am, type UiConfig as an, deepMergeTheme as ao, resolveCssVarsInTheme as ap, resolveLabels as aq, resolveUiConfig as ar, type PriceSource as as, type ChartState as b, type IDrawing as c, type IWebSocketAdapter as d, type DrawingPoint as e, ScaleManager as f, type DrawingHandle as g, type SerializedDrawing as h, type Tick as i, type StreamStatus as j, type ActiveIndicatorState as k, type BottomBarColors as l, type BottomBarLabels as m, type BottomBarUiConfig as n, type CanvasColorSettings as o, type ChartLabels as p, type ChartMiscLabels as q, type ChartTheme as r, type ChartThemeUi as s, type CrosshairPosition as t, type CrosshairUiConfig as u, DARK_THEME as v, DEFAULT_BOTTOM_BAR_CONFIG as w, DEFAULT_CROSSHAIR_CONFIG as x, DEFAULT_DRAWING_TOOLBAR_CONFIG as y, DEFAULT_INDICATOR_OVERLAY_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 };