acttrader-charts 1.0.14 → 1.0.15

package/README.md

@@ -235,6 +235,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 +260,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 +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
@@ -488,6 +506,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
 ```
 

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

@@ -568,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;
     /**
@@ -621,6 +637,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 +687,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

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

@@ -568,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;
     /**
@@ -621,6 +637,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 +687,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