acttrader-charts 1.2.0-beta.5 → 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-BdHIBbmq.d.cts → MACD-wDy-dPD_.d.cts}

@@ -841,11 +841,21 @@ interface ChartConfig {
      */
     targetCandleWidth?: number;
     /**
-     * Which side of the quote to use for candle close/high/low during live
-     * tick updates. Defaults to `'bid'` (forex convention). Set to `'ask'`
-     * if your broker streams ask-based OHLCV bars.
+     * Which price to use for candle close/high/low during live tick updates.
+     * Defaults to `'bid'` (forex convention). Set to `'ask'` if your broker
+     * streams ask-based OHLCV bars, or `'ltp'` for exchange/dealing feeds
+     * that stream a last-traded price — ticks without a valid LTP fall back
+     * to the bid.
      */
-    tickClosePriceSource?: 'bid' | 'ask';
+    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).
@@ -877,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`.
@@ -1255,6 +1280,8 @@ interface Tick {
     bid: number;
     ask: number;
     volume: number;
+    /** Last traded price (exchange/dealing feeds). Absent on pure quote feeds. */
+    ltp?: number;
 }
 interface IWebSocketAdapter {
     connect(): void;

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

@@ -841,11 +841,21 @@ interface ChartConfig {
      */
     targetCandleWidth?: number;
     /**
-     * Which side of the quote to use for candle close/high/low during live
-     * tick updates. Defaults to `'bid'` (forex convention). Set to `'ask'`
-     * if your broker streams ask-based OHLCV bars.
+     * Which price to use for candle close/high/low during live tick updates.
+     * Defaults to `'bid'` (forex convention). Set to `'ask'` if your broker
+     * streams ask-based OHLCV bars, or `'ltp'` for exchange/dealing feeds
+     * that stream a last-traded price — ticks without a valid LTP fall back
+     * to the bid.
      */
-    tickClosePriceSource?: 'bid' | 'ask';
+    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).
@@ -877,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`.
@@ -1255,6 +1280,8 @@ interface Tick {
     bid: number;
     ask: number;
     volume: number;
+    /** Last traded price (exchange/dealing feeds). Absent on pure quote feeds. */
+    ltp?: number;
 }
 interface IWebSocketAdapter {
     connect(): void;

package/dist/index.cjs

@@ -22212,6 +22212,8 @@ var _ChartEngine = class _ChartEngine {
     // Streaming
     this.streamAdapter = null;
     this.liveBidAsk = null;
+    /** Last traded price from the most recent tick that carried one ('ltp' source mode). */
+    this.liveLtp = null;
     this.tickClosePriceSource = "bid";
     /** True while an async data fetch is in-flight; suppresses tick processing to
      *  prevent stale ticks from corrupting newly-loaded bars. */
@@ -23337,10 +23339,11 @@ var _ChartEngine = class _ChartEngine {
       if (all.length === 0) return;
       if (this._suppressTicks) return;
       this.liveBidAsk = { bid: tick.bid, ask: tick.ask };
+      if (tick.ltp != null && tick.ltp > 0) this.liveLtp = tick.ltp;
       this.setDotTickActive();
       const last = all[all.length - 1];
       const intervalMs = this.timeframeToMs(this.timeframe);
-      const tickPrice = this.tickClosePriceSource === "ask" ? tick.ask : tick.bid;
+      const tickPrice = this.tickClosePriceSource === "ltp" ? this.liveLtp ?? tick.bid : this.tickClosePriceSource === "ask" ? tick.ask : tick.bid;
       if (tick.time < last.time + intervalMs) {
         const updated = {
           ...last,
@@ -23457,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;
@@ -23476,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;
@@ -24318,6 +24324,7 @@ var _ChartEngine = class _ChartEngine {
     this._suppressTicks = false;
     if (bars.length > 0) this.setNoData(false);
     this.liveBidAsk = null;
+    this.liveLtp = null;
     this.pricePanOffset = 0;
     this.priceScaleFactor = 1;
     this._displayedPriceRange = null;
@@ -25371,6 +25378,7 @@ var _ChartEngine = class _ChartEngine {
     if (this.siStreamDot)
       this.siStreamDot.style.background = this.theme.ui.stream[this.streamStatus];
     this.liveBidAsk = null;
+    this.liveLtp = null;
     return this;
   }
   /**
@@ -25588,12 +25596,43 @@ 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. */
+   *  to avoid system clock skew causing premature candle formation.
+   *  `LTP`/`LTPV` (last traded price/volume) are optional — sent by
+   *  exchange/dealing feeds and consumed when `tickClosePriceSource: 'ltp'`. */
   pushTick(prices) {
     const time = prices.T != null ? typeof prices.T === "string" ? new Date(prices.T).getTime() : prices.T : Date.now();
-    this.onTick({ time, bid: prices.B, ask: prices.A, volume: 0 });
+    this.onTick({
+      time,
+      bid: prices.B,
+      ask: prices.A,
+      volume: prices.LTPV != null && prices.LTPV > 0 ? prices.LTPV : 0,
+      ltp: prices.LTP != null && prices.LTP > 0 ? prices.LTP : void 0
+    });
     return this;
   }
   // ── Trade / Position level API ────────────────────────────────────────────
@@ -27693,18 +27732,19 @@ var _ChartEngine = class _ChartEngine {
       let primaryPriceBoxW = 0;
       if (this.liveBidAsk) {
         const { bid, ask } = this.liveBidAsk;
-        if (this.showBidAskLines) {
-          const bidTag = drawPriceLine(bid, theme.candle.down, "");
-          const askTag = drawPriceLine(ask, theme.candle.up, "");
-          const primary = this.tickClosePriceSource === "ask" ? askTag : bidTag;
+        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;
+        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 = this.tickClosePriceSource === "ask" ? ask : bid;
-          const color = 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;