acttrader-charts 1.0.14 → 1.0.16

package/README.md

@@ -164,9 +164,11 @@ chart.setLevels([], 'label', 'price', 'pending'); // clear all of one type
 
 ```ts
 // Confirmed drag of a pending order entry
-chart.on('tradeLevelEdit', ({ label, type, changes, isFullscreen }) => {
+chart.on('tradeLevelEdit', ({ label, type, data, changes, newLots, isFullscreen }) => {
     for (const c of changes) {
-        if (c.field === 'MAIN') myApi.modifyOrder(label, { price: c.newPrice });
+        // `c.newLots` is present on the MAIN change when qty was edited this session.
+        // `data.lots` is also overridden with the new qty for convenience.
+        if (c.field === 'MAIN') myApi.modifyOrder(label, { price: c.newPrice, qty: c.newLots ?? (data as any).lots });
         if (c.field === 'SL')   myApi.modifyOrder(label, { stopLoss: c.newPrice });
         if (c.field === 'TP')   myApi.modifyOrder(label, { takeProfit: c.newPrice });
     }
@@ -224,6 +226,7 @@ When `enableTrading` is on and live BID/ASK data is streaming, hovering / activa
 | `showVolume` | | `true` | Show volume overlay |
 | `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 |
+| `showFullscreenButton` | | `true` | Show the fullscreen toggle button in the top bar. Set to `false` to hide it entirely. Mobile wrappers (Android / iOS) default this to `false` |
 | `timeframe` | | `"1D"` | Initial timeframe |
 | `duration` | | — | Initial active duration button |
 | `symbol` | | — | Symbol name shown in the top bar |
@@ -235,6 +238,10 @@ When `enableTrading` is on and live BID/ASK data is streaming, hovering / activa
 | `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 |
@@ -256,7 +263,10 @@ When `enableTrading` is on and live BID/ASK data is streaming, hovering / activa
 | `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 |
@@ -479,6 +489,20 @@ 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, any in-flight fetch,
+// all user drawings, and all trade/position levels (including pending drafts).
+// Call before switching to a new symbol so no previous symbol state bleeds in.
+// If you only want to clear bars (e.g. refreshing the same symbol), call
+// chart.loadData([]) directly to preserve drawings.
+chart.resetData(): this
+```
+
+**Symbol switch pattern:**
+```ts
+chart.setSymbol('GBPUSD').resetData();
+// … fetch new bars …
+chart.loadData(newBars);
 ```
 
 ### Series & Appearance
@@ -488,6 +512,7 @@ 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.setTimezone(tz: string): this                                // change display timezone at runtime
 chart.setVolume(show: boolean): this
 ```
 
@@ -511,12 +536,17 @@ chart.setDrawingTool(tool: DrawingToolType | null): this
 ```ts
 chart.setLevels(levels, labelField, priceField, type): this
 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.updateLevelMainPrice(label: string, price: number): this   // move an existing level's entry price; stages the edit so it survives subsequent setLevels refreshes until the server echoes the new price or cancelLevelEdit/cancelCurrentEdit is called
+chart.updateLevelBracket(label: string, bracketType: 'sl' | 'tp', price: number | null): this   // update or remove a SL/TP bracket on an existing level; same staging semantics as updateLevelMainPrice — pass null to remove
+chart.cancelLevelEdit(label: string): this   // drop any staged edit for this level and revert to last confirmed server state
+chart.cancelCurrentEdit(): this   // cancel the active draft order or any 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.setDraftBracketPnl(bracketType: 'sl' | 'tp', pnlText: string | null): this   // set estimated P&L text on the active bracket host — the draft order while drafting, or the currently selected existing pending order / position while modifying; 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
 ```
 
+> **Staging semantics for `updateLevelMainPrice` / `updateLevelBracket`.** Calls to these methods register the change in the chart's pending-edit buffer (the same buffer chart-initiated drags use), so the edit stays visible even when the host app keeps pushing fresh server state via `setLevels` (e.g. per-tick PnL refreshes). When the server echoes back the new price in a later `setLevels` call, the staged edit is auto-released (mobile, i.e. `hideLevelConfirmCancel: true`). If a panel closes without submitting, call `cancelLevelEdit(label)` or `cancelCurrentEdit()` to drop the staged edit — otherwise it will keep overriding server state on the chart.
+
 ### Trade Button
 
 ```ts

package/dist/{MACD-CxJLGBBd.d.cts → MACD-ucey7UAq.d.cts}

@@ -548,6 +548,8 @@ interface ChartConfig {
     showDrawingTools?: boolean;
     /** If false, the settings gear button in the top bar is hidden entirely. Default: true */
     showSettings?: boolean;
+    /** If false, the fullscreen toggle button in the top bar is hidden entirely. Default: true */
+    showFullscreenButton?: boolean;
     timeframe?: Timeframe;
     duration?: Duration;
     symbol?: string;
@@ -568,6 +570,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;
     /**
@@ -588,10 +606,12 @@ interface ChartConfig {
         label: string;
         type: TradeLevelType;
         data: unknown;
+        newLots?: number;
         changes: Array<{
             field: 'MAIN' | 'SL' | 'TP' | 'ADD_SL' | 'ADD_TP' | 'REMOVE_SL' | 'REMOVE_TP';
             newPrice: number;
             data: unknown;
+            newLots?: number;
             bracketOrderLabel?: string;
         }>;
     }) => void;
@@ -621,6 +641,13 @@ interface ChartConfig {
      * }
      */
     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
@@ -664,6 +691,33 @@ interface ChartConfig {
      * 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
@@ -1089,16 +1143,29 @@ type ChartEventMap = {
     tradeLevelEdit: {
         label: string;
         type: TradeLevelType;
-        /** Parent level's data. */
+        /**
+         * Parent level's data. When the user edited the lot size during this session,
+         * the `lots` field of this object is overridden with the new value for convenience
+         * (so `data.lots` always reflects the effective qty being submitted). The original
+         * server fields (e.g. `Quantity`) are left untouched — use `newLots` when you need
+         * to distinguish "edited" from "unchanged".
+         */
         data: unknown;
         /** True when the chart is in fullscreen mode (native or CSS) at the time of the action. */
         isFullscreen: boolean;
+        /** Present when the user changed the lot size via the QTY pill flyout during this edit session. */
+        newLots?: number;
         changes: Array<{
             /** MAIN = entry price edit; SL/TP = bracket edit; ADD_SL/ADD_TP = new bracket placed; REMOVE_SL/REMOVE_TP = bracket removed. */
             field: 'MAIN' | 'SL' | 'TP' | 'ADD_SL' | 'ADD_TP' | 'REMOVE_SL' | 'REMOVE_TP';
             newPrice: number;
-            /** Bracket order's data when the bracket is a ToClose order; parent's data for inline brackets. */
+            /**
+             * Bracket order's data when the bracket is a ToClose order; parent's data for inline brackets.
+             * On the MAIN change, `lots` is overridden with the new qty when the user edited it (same rule as the top-level `data`).
+             */
             data: unknown;
+            /** Present on the MAIN change when the user edited the lot size during this session. */
+            newLots?: number;
             bracketOrderLabel?: string;
         }>;
     };

package/dist/{MACD-CxJLGBBd.d.ts → MACD-ucey7UAq.d.ts}

@@ -548,6 +548,8 @@ interface ChartConfig {
     showDrawingTools?: boolean;
     /** If false, the settings gear button in the top bar is hidden entirely. Default: true */
     showSettings?: boolean;
+    /** If false, the fullscreen toggle button in the top bar is hidden entirely. Default: true */
+    showFullscreenButton?: boolean;
     timeframe?: Timeframe;
     duration?: Duration;
     symbol?: string;
@@ -568,6 +570,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;
     /**
@@ -588,10 +606,12 @@ interface ChartConfig {
         label: string;
         type: TradeLevelType;
         data: unknown;
+        newLots?: number;
         changes: Array<{
             field: 'MAIN' | 'SL' | 'TP' | 'ADD_SL' | 'ADD_TP' | 'REMOVE_SL' | 'REMOVE_TP';
             newPrice: number;
             data: unknown;
+            newLots?: number;
             bracketOrderLabel?: string;
         }>;
     }) => void;
@@ -621,6 +641,13 @@ interface ChartConfig {
      * }
      */
     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
@@ -664,6 +691,33 @@ interface ChartConfig {
      * 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
@@ -1089,16 +1143,29 @@ type ChartEventMap = {
     tradeLevelEdit: {
         label: string;
         type: TradeLevelType;
-        /** Parent level's data. */
+        /**
+         * Parent level's data. When the user edited the lot size during this session,
+         * the `lots` field of this object is overridden with the new value for convenience
+         * (so `data.lots` always reflects the effective qty being submitted). The original
+         * server fields (e.g. `Quantity`) are left untouched — use `newLots` when you need
+         * to distinguish "edited" from "unchanged".
+         */
         data: unknown;
         /** True when the chart is in fullscreen mode (native or CSS) at the time of the action. */
         isFullscreen: boolean;
+        /** Present when the user changed the lot size via the QTY pill flyout during this edit session. */
+        newLots?: number;
         changes: Array<{
             /** MAIN = entry price edit; SL/TP = bracket edit; ADD_SL/ADD_TP = new bracket placed; REMOVE_SL/REMOVE_TP = bracket removed. */
             field: 'MAIN' | 'SL' | 'TP' | 'ADD_SL' | 'ADD_TP' | 'REMOVE_SL' | 'REMOVE_TP';
             newPrice: number;
-            /** Bracket order's data when the bracket is a ToClose order; parent's data for inline brackets. */
+            /**
+             * Bracket order's data when the bracket is a ToClose order; parent's data for inline brackets.
+             * On the MAIN change, `lots` is overridden with the new qty when the user edited it (same rule as the top-level `data`).
+             */
             data: unknown;
+            /** Present on the MAIN change when the user edited the lot size during this session. */
+            newLots?: number;
             bracketOrderLabel?: string;
         }>;
     };