acttrader-charts 1.2.0-beta.6 → 1.2.0-beta.7

package/README.md

@@ -141,7 +141,26 @@ Auto-reconnects with exponential backoff (2 s → 30 s). Stream status is reflec
 To push ticks directly without an adapter (e.g. from your own WebSocket handler):
 
 ```ts
-chart.pushTick({ time: Date.now(), bid: 1.2055, ask: 1.2057, volume: 120 });
+chart.pushTick({ B: 1.2055, A: 1.2057, T: Date.now() });
+
+// Exchange/dealing feeds: include the last traded price/volume on trade ticks —
+// consumed when the chart is configured with `tickClosePriceSource: 'ltp'`.
+chart.pushTick({ B: 1.2055, A: 1.2057, T: Date.now(), LTP: 1.2056, LTPV: 120 });
+
+// Dealing-feed setup — candle-source toggle + independent line checks:
+const dealingChart = new ChartEngine({
+    container,
+    // "Show chart by" toggle: 'ltp' | 'ask' | 'bid' (candle close/high/low source)
+    tickClosePriceSource: 'ltp',
+    // Chart line checkboxes — each price line is independent:
+    showAskLine: true,   // Show AskLine
+    showBidLine: true,   // Show BidLine
+    showLtpPrice: true,  // Show LTP Line (dashed line + axis tag)
+});
+// ...and at runtime:
+dealingChart.setShowAskLine(false);   // hide the ask line
+dealingChart.setShowBidLine(true);    // show the bid line
+dealingChart.setShowLtpPrice(true);   // show the LTP line
 ```
 
 ### Compare symbols
@@ -382,8 +401,11 @@ chart.on('orderLineMoved', ({ label, fromTimestamp, toTimestamp, data }) => {
 | `themeOverrides` | | — | Deep-partial color overrides applied on top of the built-in dark/light themes |
 | `uiConfig` | | `DEFAULT_UI_CONFIG` | Deep-partial size / font overrides per component |
 | `labels` | | `DEFAULT_LABELS` | Deep-partial string overrides for i18n/translation |
-| `tickClosePriceSource` | | `"bid"` | Which quote side drives live tick close/high/low (`"bid"` or `"ask"`) |
-| `showBidAskLines` | | `false` | Show both bid and ask as dashed lines during a live stream |
+| `tickClosePriceSource` | | `"bid"` | Which price drives live tick close/high/low: `"bid"`, `"ask"`, or `"ltp"` (build candles from the last traded price — exchange/dealing feeds; ticks without a valid LTP fall back to the bid) |
+| `showLtpPrice` | | unset | Show the LTP marker (dashed price line + axis tag). Unset: shown only in `"ltp"` mode. `true`: always shown when the feed supplies an LTP. `false`: hidden even in `"ltp"` mode (candles still build from the LTP). Toggle at runtime with `chart.setShowLtpPrice(show)` |
+| `showBidAskLines` | | `false` | **Deprecated** — show both bid and ask as dashed lines during a live stream. Prefer the per-line checks `showAskLine` / `showBidLine`, which override it when set |
+| `showAskLine` | | unset | Show the Ask price line (dashed line + axis tag) independently. Unset: legacy `showBidAskLines` behavior. Toggle at runtime with `chart.setShowAskLine(show)` |
+| `showBidLine` | | unset | Show the Bid price line (dashed line + axis tag) independently. Unset: legacy `showBidAskLines` behavior. Toggle at runtime with `chart.setShowBidLine(show)` |
 | `showActLogo` | | `false` | Show the ACT watermark logo in the bottom-left corner |
 | `showCandleCountdown` | | `true` | Show countdown timer on the live candle (time axis) |
 | `candleCountdownTimeframes` | | intraday only | Timeframes where the countdown appears; `'all'` or `Timeframe[]` |
@@ -721,7 +743,7 @@ chart.isAtLiveEdge(): boolean
 ```ts
 chart.connectStream(adapter: IWebSocketAdapter): this
 chart.disconnectStream(): this
-chart.pushTick(tick: { time: number; bid: number; ask: number; volume?: number }): void  // push a tick directly without an adapter
+chart.pushTick(prices: { B: number; A: number; T?: string | number; LTP?: number; LTPV?: number }): this  // push a tick directly without an adapter; LTP/LTPV feed 'ltp' mode
 ```
 
 ### State Persistence

package/dist/{MACD-j_q5rnM0.d.cts → MACD-wDy-dPD_.d.cts}

@@ -848,6 +848,14 @@ interface ChartConfig {
      * to the bid.
      */
     tickClosePriceSource?: 'bid' | 'ask' | 'ltp';
+    /**
+     * Show the last-traded-price (LTP) marker — dashed price line + axis tag.
+     * Defaults to following `tickClosePriceSource`: the marker is shown only in
+     * `'ltp'` mode. Set `true` to always show it when the feed supplies an LTP
+     * (even on a bid/ask-driven chart), or `false` to hide it even in `'ltp'`
+     * mode (candles still build from the LTP).
+     */
+    showLtpPrice?: boolean;
     /**
      * When the combined count of open positions and pending orders exceeds this
      * number, the position render style auto-defaults to `'dot'` (compact).
@@ -879,8 +887,23 @@ interface ChartConfig {
      * When `false` (default), only the `tickClosePriceSource` side is shown.
      * Only relevant when a live tick stream is active.
      * Default: `false`.
+     * @deprecated Prefer the per-line checks `showAskLine` / `showBidLine`,
+     * which override this flag when set.
      */
     showBidAskLines?: boolean;
+    /**
+     * Show the Ask price line (dashed line + axis tag) independently of the
+     * Bid line. Unset falls back to the legacy `showBidAskLines` behavior
+     * (both sides when `true`, only the `tickClosePriceSource` side when
+     * `false`). Toggle at runtime with `setShowAskLine()`.
+     */
+    showAskLine?: boolean;
+    /**
+     * Show the Bid price line (dashed line + axis tag) independently of the
+     * Ask line. Unset falls back to the legacy `showBidAskLines` behavior.
+     * Toggle at runtime with `setShowBidLine()`.
+     */
+    showBidLine?: boolean;
     /**
      * Show the ACT logo watermark in the bottom-left corner of the price pane.
      * Default: `false`.

package/dist/{MACD-j_q5rnM0.d.ts → MACD-wDy-dPD_.d.ts}

@@ -848,6 +848,14 @@ interface ChartConfig {
      * to the bid.
      */
     tickClosePriceSource?: 'bid' | 'ask' | 'ltp';
+    /**
+     * Show the last-traded-price (LTP) marker — dashed price line + axis tag.
+     * Defaults to following `tickClosePriceSource`: the marker is shown only in
+     * `'ltp'` mode. Set `true` to always show it when the feed supplies an LTP
+     * (even on a bid/ask-driven chart), or `false` to hide it even in `'ltp'`
+     * mode (candles still build from the LTP).
+     */
+    showLtpPrice?: boolean;
     /**
      * When the combined count of open positions and pending orders exceeds this
      * number, the position render style auto-defaults to `'dot'` (compact).
@@ -879,8 +887,23 @@ interface ChartConfig {
      * When `false` (default), only the `tickClosePriceSource` side is shown.
      * Only relevant when a live tick stream is active.
      * Default: `false`.
+     * @deprecated Prefer the per-line checks `showAskLine` / `showBidLine`,
+     * which override this flag when set.
      */
     showBidAskLines?: boolean;
+    /**
+     * Show the Ask price line (dashed line + axis tag) independently of the
+     * Bid line. Unset falls back to the legacy `showBidAskLines` behavior
+     * (both sides when `true`, only the `tickClosePriceSource` side when
+     * `false`). Toggle at runtime with `setShowAskLine()`.
+     */
+    showAskLine?: boolean;
+    /**
+     * Show the Bid price line (dashed line + axis tag) independently of the
+     * Ask line. Unset falls back to the legacy `showBidAskLines` behavior.
+     * Toggle at runtime with `setShowBidLine()`.
+     */
+    showBidLine?: boolean;
     /**
      * Show the ACT logo watermark in the bottom-left corner of the price pane.
      * Default: `false`.

package/dist/index.cjs

@@ -23460,6 +23460,7 @@ var _ChartEngine = class _ChartEngine {
     this._targetViewport = { ...this.viewport };
     this.maxSubPanes = config.maxSubPanes ?? 3;
     this.tickClosePriceSource = config.tickClosePriceSource ?? "bid";
+    this.showLtpPrice = config.showLtpPrice;
     this.tradesThresholdForHorizontalLine = config.tradesThresholdForHorizontalLine ?? 2;
     if (config.positionRenderStyle === "line" || config.positionRenderStyle === "dot") {
       this.positionRenderStyleOverride = config.positionRenderStyle;
@@ -23479,6 +23480,8 @@ var _ChartEngine = class _ChartEngine {
     }
     this.recomputeRenderStyle();
     this.showBidAskLines = config.showBidAskLines ?? false;
+    this.showAskLine = config.showAskLine;
+    this.showBidLine = config.showBidLine;
     this.showActLogo = config.showActLogo ?? false;
     this.hideLevelConfirmCancel = config.hideLevelConfirmCancel ?? false;
     this.deselectActiveOnOutsideClick = config.deselectActiveOnOutsideClick ?? false;
@@ -25593,6 +25596,29 @@ var _ChartEngine = class _ChartEngine {
     this.streamAdapter = null;
     return this;
   }
+  /** Show/hide the LTP (last traded price) marker — dashed line + axis tag.
+   *  `true` always shows it when the feed supplies an LTP, `false` hides it
+   *  even in `'ltp'` mode; pass `undefined` to restore the default
+   *  (shown only when `tickClosePriceSource` is `'ltp'`). */
+  setShowLtpPrice(show) {
+    this.showLtpPrice = show;
+    this.scheduleRender();
+    return this;
+  }
+  /** Show/hide the Ask price line (dashed line + axis tag). Pass `undefined`
+   *  to restore the legacy `showBidAskLines` fallback. */
+  setShowAskLine(show) {
+    this.showAskLine = show;
+    this.scheduleRender();
+    return this;
+  }
+  /** Show/hide the Bid price line (dashed line + axis tag). Pass `undefined`
+   *  to restore the legacy `showBidAskLines` fallback. */
+  setShowBidLine(show) {
+    this.showBidLine = show;
+    this.scheduleRender();
+    return this;
+  }
   /** Push a live bid/ask tick directly — no adapter needed.
    *  Pass `T` from your feed as the server timestamp (ISO string or Unix ms)
    *  to avoid system clock skew causing premature candle formation.
@@ -27706,20 +27732,19 @@ var _ChartEngine = class _ChartEngine {
       let primaryPriceBoxW = 0;
       if (this.liveBidAsk) {
         const { bid, ask } = this.liveBidAsk;
-        const ltpPrice = this.tickClosePriceSource === "ltp" ? this.liveLtp ?? bid : null;
+        const isLtpMode = this.tickClosePriceSource === "ltp";
+        const ltpVisible = this.showLtpPrice ?? isLtpMode;
+        const ltpPrice = ltpVisible ? this.liveLtp ?? (isLtpMode ? bid : null) : null;
         const ltpColor = lastBar.close >= lastBar.open ? theme.candle.up : theme.candle.down;
-        if (this.showBidAskLines) {
-          const bidTag = drawPriceLine(bid, theme.candle.down, "");
-          const askTag = drawPriceLine(ask, theme.candle.up, "");
-          const primary = ltpPrice != null ? drawPriceLine(ltpPrice, ltpColor, "") : this.tickClosePriceSource === "ask" ? askTag : bidTag;
+        const askVisible = this.showAskLine ?? (this.showBidAskLines || this.tickClosePriceSource === "ask");
+        const bidVisible = this.showBidLine ?? (this.showBidAskLines || this.tickClosePriceSource === "bid" || isLtpMode && ltpPrice == null);
+        const bidTag = bidVisible ? drawPriceLine(bid, theme.candle.down, "") : null;
+        const askTag = askVisible ? drawPriceLine(ask, theme.candle.up, "") : null;
+        const ltpTag = ltpPrice != null ? drawPriceLine(ltpPrice, ltpColor, "") : null;
+        const primary = isLtpMode ? ltpTag ?? bidTag ?? askTag : this.tickClosePriceSource === "ask" ? askTag ?? ltpTag ?? bidTag : bidTag ?? ltpTag ?? askTag;
+        if (primary) {
           primaryPriceY = primary.y;
           primaryPriceBoxW = primary.boxW;
-        } else {
-          const price = ltpPrice ?? (this.tickClosePriceSource === "ask" ? ask : bid);
-          const color = ltpPrice != null ? ltpColor : this.tickClosePriceSource === "ask" ? theme.candle.up : theme.candle.down;
-          const tag = drawPriceLine(price, color, "");
-          primaryPriceY = tag.y;
-          primaryPriceBoxW = tag.boxW;
         }
       } else {
         const isUp = lastBar.close >= lastBar.open;