acttrader-charts 1.0.16 → 1.0.18

package/README.md

@@ -13,6 +13,17 @@ Dual ESM/CJS output, TypeScript-first.
 npm install acttrader-charts
 ```
 
+### Beta releases
+
+Pre-release builds are published under the `beta` dist-tag and use prerelease semver (`X.Y.Z-beta.N`). They never move the default `latest` tag, so existing consumers are unaffected.
+
+```bash
+npm install acttrader-charts@beta          # opt in to the latest beta
+npm install acttrader-charts@1.1.0-beta.1  # pin a specific beta
+```
+
+`npm install acttrader-charts` and existing semver ranges (`^1.0.0`, `~1.0.0`) continue to resolve only to stable releases — by spec, semver ranges exclude prerelease versions.
+
 ---
 
 ## Basic Usage
@@ -55,6 +66,8 @@ const chart = new ChartEngine({
 // No manual loadData() needed — the engine calls dataLoader on start and on timeframe/duration changes.
 ```
 
+If the first fetch returns fewer than `minInitialBars` (default `10`), the engine automatically widens the lookback window and calls `dataLoader` again — up to the `maxLookbackMs` ceiling (default 365 days). This keeps the chart useful on weekends, holidays, or for instruments that just listed. If retries still yield zero bars, the engine shows a **"No data available"** overlay (customise the text via `labels.chart.noData`).
+
 ---
 
 ## Advanced Usage
@@ -160,6 +173,10 @@ chart.removeLevelByLabel('ORD-1');
 chart.setLevels([], 'label', 'price', 'pending'); // clear all of one type
 ```
 
+**Visual differentiation:** pending orders and ES/EL entry working orders render as **dashed** lines tinted by side (`pendingBuyLine` green / `pendingSellLine` red). True open positions render as **solid** lines: green/red when `pnl` is set (sign-colored), otherwise `positionLine` (purple/indigo). The info-box border matches the line color. Each true open position also gets a small colored price tag on the right-side price axis showing the entry price — same visual language as the Bid/Ask tag — so you can read the entry price without hunting for the info box.
+
+**Brackets follow entry on drag:** when the entry line of a pending order, draft order, or an open position with `entryPriceEditable: true` is dragged, any existing `stopLossPrice` / `takeProfitPrice` brackets translate along with it by the same price delta. The distance between entry and each bracket is whatever the user currently sees — if they manually drag SL or TP to a new price, that new distance becomes the anchor for the next entry drag. Missing brackets aren't auto-created. On confirm, `tradeLevelEdit` carries all translated fields together in one `changes[]` array; on mobile (`hideLevelConfirmCancel`) the three changes are applied as one atomic event.
+
 **TFC events:**
 
 ```ts
@@ -236,6 +253,8 @@ 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 |
+| `minInitialBars` | | `10` | If `dataLoader` returns fewer bars, the fetch window auto-widens and retries (handles weekends, market closures, and sparse symbols) |
+| `maxLookbackMs` | | `31_536_000_000` | Hard ceiling on auto-widening lookback (ms). Retries stop once the window reaches this. Default: 365 days |
 | `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 |
@@ -257,6 +276,7 @@ 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 |
+| `tradeLevelButtonScale` | | `1` | Multiplier for trade-level Confirm/Cancel/Edit/Close button radii and gaps. Scales visuals **and** hit/drag areas together — raise it on touch devices for larger tap targets. Clamped to `[1, 3]`. Also settable at runtime via `chart.setTradeLevelButtonScale(scale)` |
 | `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`) |
@@ -598,6 +618,53 @@ if (saved) chart.setState(JSON.parse(saved) as ChartState);
 chart.destroy(): void
 ```
 
+### Dismissing open UI
+
+Closes any open flyout/modal/dropdown/popover (quantity edit, symbol picker,
+indicator settings, chart settings, trade popover, topbar dropdowns, mobile
+drawing flyout) in a single call. Designed for wiring to the system back
+button / gesture in PWAs, installed web apps, and native wrapper hosts.
+
+```ts
+chart.dismissAllUI(): boolean  // true if anything was dismissed, false if nothing was open
+```
+
+Paired with the `uiStateChange` event so you can track whether a back action
+should dismiss chart UI or fall through to your own navigation:
+
+```ts
+chart.on('uiStateChange', ({ hasOpenUI }) => {
+    // hasOpenUI === true when at least one flyout/modal/dropdown is open
+});
+```
+
+**PWA — proper History API wiring** (back press dismisses flyout without
+navigating away from the page):
+
+```ts
+let pushedStateForUI = false;
+
+chart.on('uiStateChange', ({ hasOpenUI }) => {
+    if (hasOpenUI && !pushedStateForUI) {
+        history.pushState({ chartUI: true }, '');
+        pushedStateForUI = true;
+    } else if (!hasOpenUI) {
+        pushedStateForUI = false;
+    }
+});
+
+window.addEventListener('popstate', () => {
+    if (chart.dismissAllUI()) pushedStateForUI = false;
+});
+```
+
+**Minimum wiring** (back press closes flyout AND advances browser history —
+fine for single-screen apps without client routing):
+
+```ts
+window.addEventListener('popstate', () => chart.dismissAllUI());
+```
+
 ---
 
 ## Built-in Indicators

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

@@ -300,6 +300,8 @@ interface DialogLabels {
 interface ChartMiscLabels {
     /** Overlay text shown while data is being fetched. */
     loading: string;
+    /** Overlay text shown when a completed fetch returned zero bars. */
+    noData: string;
     /** Tooltip on the "jump to live edge" button. */
     scrollToLatest: string;
     /** Collapse button text in the indicator overlay when more than 2 indicators
@@ -679,6 +681,20 @@ interface ChartConfig {
      * of bars. Default: 200.
      */
     maxCandles?: number;
+    /**
+     * Minimum bars expected from the initial fetch before giving up. If the
+     * `dataLoader` returns fewer bars than this, ChartEngine automatically
+     * widens the lookback window and retries — this keeps charts useful after
+     * weekends, holidays, or for instruments with sparse recent history.
+     * Default: 10.
+     */
+    minInitialBars?: number;
+    /**
+     * Hard ceiling (in milliseconds) on how far back auto-widening retries
+     * can reach when chasing enough bars. Retries stop once the window meets
+     * or exceeds this value. Default: 365 days.
+     */
+    maxLookbackMs?: 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.
@@ -849,6 +865,14 @@ interface ChartConfig {
      * Default: `false`.
      */
     hideLevelConfirmCancel?: boolean;
+    /**
+     * Multiplier applied to the Confirm (✓), Cancel (✗), Edit (✎), and Close (×)
+     * buttons on trade-level overlays (both main-level and SL/TP bracket boxes).
+     * Scales button radii and inter-button gaps so visual size AND hit/drag areas
+     * grow together — useful for touch targets.
+     * Clamped to `[1, 3]`. Default: `1`.
+     */
+    tradeLevelButtonScale?: number;
     /**
      * When `true`, a theme toggle (Dark / Light) is shown in the Settings dialog.
      * Default: `false` — the toggle is hidden.
@@ -1077,12 +1101,16 @@ type ChartEventMap = {
         isFullscreen: boolean;
     };
     /** Emitted on every mouse-move while dragging a trade level line (before confirm).
-     *  `bracketType` is present when dragging an SL/TP bracket line; absent for main entry drag. */
+     *  `bracketType` is present when dragging an SL/TP bracket line; absent for main entry drag.
+     *  `derivedSLPrice` / `derivedTPPrice` are present during a main-entry drag in follow-brackets mode
+     *  so external panels can mirror the SL/TP translation live (keeps validation from flickering). */
     tradeLevelDrag: {
         label: string;
         newPrice: number;
         data: unknown;
         bracketType?: 'stopLoss' | 'takeProfit';
+        derivedSLPrice?: number;
+        derivedTPPrice?: number;
         isFullscreen: boolean;
     };
     /** Emitted at the instant a bracket (SL/TP) drag begins — before any movement.
@@ -1139,6 +1167,12 @@ type ChartEventMap = {
     tfcToggle: {
         enabled: boolean;
     };
+    /** Emitted whenever any dismissible UI (flyout, modal, dropdown, popover) opens or closes.
+     *  Hosts (native wrappers, PWAs) listen to track whether a back button / gesture should
+     *  dismiss chart UI vs. navigate. Pair with `dismissAllUI()` to wire platform back events. */
+    uiStateChange: {
+        hasOpenUI: boolean;
+    };
     /** Emitted when the user confirms all edits to a level — replaces separate tradeLevelDragEnd / tradeLevelBracketDrag events. */
     tradeLevelEdit: {
         label: string;

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

@@ -300,6 +300,8 @@ interface DialogLabels {
 interface ChartMiscLabels {
     /** Overlay text shown while data is being fetched. */
     loading: string;
+    /** Overlay text shown when a completed fetch returned zero bars. */
+    noData: string;
     /** Tooltip on the "jump to live edge" button. */
     scrollToLatest: string;
     /** Collapse button text in the indicator overlay when more than 2 indicators
@@ -679,6 +681,20 @@ interface ChartConfig {
      * of bars. Default: 200.
      */
     maxCandles?: number;
+    /**
+     * Minimum bars expected from the initial fetch before giving up. If the
+     * `dataLoader` returns fewer bars than this, ChartEngine automatically
+     * widens the lookback window and retries — this keeps charts useful after
+     * weekends, holidays, or for instruments with sparse recent history.
+     * Default: 10.
+     */
+    minInitialBars?: number;
+    /**
+     * Hard ceiling (in milliseconds) on how far back auto-widening retries
+     * can reach when chasing enough bars. Retries stop once the window meets
+     * or exceeds this value. Default: 365 days.
+     */
+    maxLookbackMs?: 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.
@@ -849,6 +865,14 @@ interface ChartConfig {
      * Default: `false`.
      */
     hideLevelConfirmCancel?: boolean;
+    /**
+     * Multiplier applied to the Confirm (✓), Cancel (✗), Edit (✎), and Close (×)
+     * buttons on trade-level overlays (both main-level and SL/TP bracket boxes).
+     * Scales button radii and inter-button gaps so visual size AND hit/drag areas
+     * grow together — useful for touch targets.
+     * Clamped to `[1, 3]`. Default: `1`.
+     */
+    tradeLevelButtonScale?: number;
     /**
      * When `true`, a theme toggle (Dark / Light) is shown in the Settings dialog.
      * Default: `false` — the toggle is hidden.
@@ -1077,12 +1101,16 @@ type ChartEventMap = {
         isFullscreen: boolean;
     };
     /** Emitted on every mouse-move while dragging a trade level line (before confirm).
-     *  `bracketType` is present when dragging an SL/TP bracket line; absent for main entry drag. */
+     *  `bracketType` is present when dragging an SL/TP bracket line; absent for main entry drag.
+     *  `derivedSLPrice` / `derivedTPPrice` are present during a main-entry drag in follow-brackets mode
+     *  so external panels can mirror the SL/TP translation live (keeps validation from flickering). */
     tradeLevelDrag: {
         label: string;
         newPrice: number;
         data: unknown;
         bracketType?: 'stopLoss' | 'takeProfit';
+        derivedSLPrice?: number;
+        derivedTPPrice?: number;
         isFullscreen: boolean;
     };
     /** Emitted at the instant a bracket (SL/TP) drag begins — before any movement.
@@ -1139,6 +1167,12 @@ type ChartEventMap = {
     tfcToggle: {
         enabled: boolean;
     };
+    /** Emitted whenever any dismissible UI (flyout, modal, dropdown, popover) opens or closes.
+     *  Hosts (native wrappers, PWAs) listen to track whether a back button / gesture should
+     *  dismiss chart UI vs. navigate. Pair with `dismissAllUI()` to wire platform back events. */
+    uiStateChange: {
+        hasOpenUI: boolean;
+    };
     /** Emitted when the user confirms all edits to a level — replaces separate tradeLevelDragEnd / tradeLevelBracketDrag events. */
     tradeLevelEdit: {
         label: string;