acttrader-charts 1.3.0-beta.16 → 1.3.0-beta.18

package/README.md

@@ -378,6 +378,88 @@ chart.on('orderLineMoved', ({ label, fromTimestamp, toTimestamp, data }) => {
 
 ---
 
+### Trade action bar — `features.tradeActionBar`
+
+With the flag on, the floating trade button opens a segmented bar at the clicked
+price instead of the two-row Buy/Sell popup:
+
+```
+Alert | Pending | SL | TP | TSL | ×
+```
+
+- No price readout — the axis already shows the price at that point.
+- **Alert** calls `onAddAlert(price)`. The chip is only rendered when that callback is set.
+- **Pending** opens a sub-menu just above the bar — an `Above · 1.17586` / `Below · …`
+  header, then the two orders that make sense at that price (`Buy Limit` / `Sell Stop`
+  below the market, `Sell Limit` / `Buy Stop` above), each with its `@ price`. Picking a
+  row creates the draft order exactly as before and closes both.
+- **SL / TP / TSL** emit `bulkLevelsRequested` with `{ kind, price }` and close the
+  bar — the host opens its Bulk Levels dialog pre-focused on that kind. The chart
+  never calls a broker.
+- **×**, a click elsewhere, Escape, TFC off and `dismissAllUI()` all close it.
+
+Chip labels and the × tooltip live under `labels.trade` (`actionAlert`, `actionPending`,
+`actionSl`, `actionTp`, `actionTsl`, `actionCloseTitle`).
+
+### On-chart P/L pill — `features.pnlPill`
+
+A floating summary of the open positions on the chart, for the trader who wants
+the total without opening the positions panel:
+
+```
+⋮⋮  3 POS  +72.65 USD  |  ◎  ✕
+```
+
+- **`3 POS`** — how many position levels are on the chart. Pending orders,
+  position-style entry orders (`entryPriceEditable`) and an unconfirmed draft
+  are not counted.
+- **`+72.65 USD`** — the sum of the numeric `pnl` those levels carry, i.e. the
+  `pnlKey` column you pass to `setLevels`. The chart computes no money itself;
+  while no position has a `pnl` yet the pill shows `—`. Profit is drawn in the
+  buy colour, loss in the sell colour.
+- **Click the body** (the grip, the count or the amount) to fan every position
+  badge out on the chart — clustered levels expand, and TFC is switched on if it
+  was off — with an accent ring on the pill while they are shown. Click again to
+  collapse.
+- **◎** (the same target glyph as the Bulk Levels dialog header) emits
+  `bulkLevelsRequested` with `source: 'pill'` and a `null` price, so your Bulk Levels
+  dialog opens pre-scoped to every open position on the symbol. Tooltip:
+  "Set SL · TP · TSL on all N {symbol} positions".
+- **✕** (amber) emits `pnlPillCloseAll` with every counted position. Your app
+  confirms and closes them; the chart never calls a broker.
+
+The pill sits top-right of the plot, clear of the price axis. Drag it anywhere
+inside the plot; double-click puts it back. It hides itself while the chart has
+no positions and follows the chart theme. Every element sits on one shared row
+height, and the grip and both buttons have fixed widths, so a long or negative
+amount never shifts or squeezes them.
+
+With the feature on, the header (advanced toolbar and default top bar) also gets a
+**P/L** switch — wallet icon, `P/L`, the same 24px `rounded-sm` button tinted while the
+pill is shown. It hides or shows the pill on the user's say-so, wins over the position
+count, and emits `pnlPillToggle` so you can persist the choice; `pnlPill.visible` seeds
+it and `setPnlPillVisible()` drives it from code.
+
+```ts
+const chart = new ChartEngine({
+    container,
+    features: { pnlPill: true },
+    pnlPill:  { currency: 'USD' },   // → "+72.65 USD"; or format: (pnl) => myMoney(pnl)
+});
+
+chart.setLevels(positions, 'TradeID', 'Price', 'position', 'pnl', 'pnlText');
+
+chart.on('pnlPillCloseAll', async ({ count, pnl, data }) => {
+    if (!(await confirmDialog(`Close all ${count} positions?`))) return;
+    for (const row of data) closeTrade(row);
+});
+```
+
+Labels live under `labels.pnlPill`: `positionsAbbrev` (`'POS'`), `showPositionsTitle`,
+`hidePositionsTitle`, `bulkLevelsTitle`, `closeAllTitle` — titles may
+use `{symbol}` and `{count}`. The maths behind the pill is exported as
+`summarisePositionLevels(levels, draftLabel?)` and `formatPnlPillValue(pnl, currency?)`.
+
 ## Default Configuration
 
 ### `ChartConfig`
@@ -392,7 +474,8 @@ chart.on('orderLineMoved', ({ label, fromTimestamp, toTimestamp, data }) => {
 | `hideHeader` | | `false` | Hide only the chart header (TopBar / AdvancedToolbar / CompactToolbar, per `headerLayout`). Bottom bar, left drawing tools, and on-canvas overlays remain on their own flags. Drive the chart from your own UI via `setTimeframe(tf)`, `setSeries(type)`, `addIndicatorByName(name)`, `removeIndicator(name)` |
 | `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 |
+| `timeframe` | | `"1D"` | Initial timeframe. Values: `1m` `3m` `4m` `5m` `10m` `15m` `30m` `1h` `2h` `4h` `8h` `1D` `1W` `1M`; `3m` / `4m` / `10m` / `30m` are requested from `dataLoader` as `3min` / `4min` / `10min` / `30min`. If your API lacks them, point `aggregateFrom` at a finer interval it does serve, e.g. `{ '3m': '1m', '4m': '1m', '10m': '5m', '30m': '15m' }` — the chart merges the candles |
+| `timeframes` | | classic set | Timeframes offered in the header, in order: the advanced row's pills, the classic dropdown, and the rest of the reference header's ⌄ menu after its six fixed pills. Omit to keep `1m 5m 15m 1h 4h 1D 1W` (row) / `… 30m 2h 8h 1M` (dropdown, ⌄), so the newer minute timeframes only appear for hosts that list them |
 | `duration` | | — | Initial active duration button |
 | `symbol` | | — | Symbol name shown in the top bar |
 | `features` | | `{}` | Opt-in feature gates. See [Feature flags](#feature-flags) |
@@ -434,12 +517,18 @@ chart.on('orderLineMoved', ({ label, fromTimestamp, toTimestamp, data }) => {
 | `showPriceAxisCountdown` | | `false` | Show candle countdown timer on the right price axis, just below the live price tag. Honours `candleCountdownTimeframes`. Toggleable from the Settings dialog (Appearance tab). |
 | `maxSubPanes` | | `3` | Max simultaneous oscillator sub-panes |
 | `tradeDisplayFilter` | | `"all"` | Which TFC levels are visible: `"all"` · `"positions"` · `"orders"` · `"none"` |
+| `pnlPill` | | — | `{ currency?, format?, visible? }` for the on-chart P/L pill — currency code appended to the amount, or your own formatter. Only read when `features.pnlPill` is on |
 | `positionRenderStyle` | | auto | Force position render style: `"line"` or `"dot"` |
 | `hideLevelConfirmCancel` | | `false` | Hide on-canvas ✓/✗ confirm-cancel buttons for TFC level edits |
 | `deselectActiveOnOutsideClick` | | `false` | When `true`, clicking/tapping anywhere outside a selected trade level dismisses it (reverting any pending edits, mirroring ✗ Cancel). Default `false` keeps the level active so incidental clicks — price-axis resize, taps outside the QTY input — don't drop an in-progress edit. The level can still be dismissed via ✓/✗, tapping the level again, or `setLevels()` removing it |
 | `showTradeLevelsAlways` | | `false` | Always render SL/TP bracket lines + price pills, even when the parent level is not hovered or selected. The close (×) button stays hover-only so the chart isn't cluttered. Toggleable from the Settings dialog (Trading tab). Persisted in `localStorage`. |
 | `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)` |
+| `tradeLevelBadgeScale` | | `1` | Shrinks the on-chart position / order tag — font, padding, grip, ✎ × buttons and their hit areas together. `0.6` is about half the default area. Clamped `[0.5, 1]` |
+| `tradeLevelBadgeAnchor` | | `"auto"` | `"left"` homes the tag at the plot's left edge like an axis label, whatever the open price or time anchor, so it never covers candles until the trader drags it. With `features.orderLineTimeDrag` the tag stays draggable along the time axis and the drop is remembered as before |
 | `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 |
+| `crosshairEnabled` | | `true` | Draw the mouse crosshair. `false` hides it **and** the floating "place order at this price" button that rides on its horizontal line, ignores mirrored `setCrosshair()` calls and keeps the mobile long-press crosshair from arming. Trade levels, drawings and TFC are unaffected. Runtime: `chart.setCrosshairEnabled(enabled)` |
+| `enableCrosshairToggle` | | `false` | Crosshair on/off switch in the header (advanced toolbar and default top bar): the reference 24px `rounded-sm` button, tinted while on. Clicking it calls `setCrosshairEnabled()` and emits `crosshairToggle` so the host can persist the choice |
+| `headerOverflowMenu` | | `false` | Advanced header only: the reference Hanko header. A 32px bar with six lowercase timeframe pills (`1m 5m 15m 1h 4h 1d`) and a ⌄ for the rest, then crosshair · P/L · Layout (grid icon) · ⋯ · fullscreen at 24px. Draw, Chart type, Indicators, Compare, Snapshot and Chart settings fold into the ⋯ menu; each keeps its behaviour |
 | `features.orderLineTimeDrag` | | `false` | Enable **horizontal (time-axis) order-line dragging**. A level with `timeDraggable: true` can have its info-box badge dragged left/right to re-anchor the order to a different candle — **price stays locked**. Emits `orderLineMoved` on release. Off by default; intended to be enabled per broker (e.g. Hankotrade) by the host app |
 | `orderLineDragSnap` | | `true` | When horizontal dragging is enabled, snap the badge to the nearest candle on release. Set `false` to keep the exact released time |
 | `orderLineAnchorPersistence` | | `true` | When horizontal dragging is enabled, remember where each badge was dropped in `localStorage` (key `finchart.orderLineTimeAnchors`, keyed by level label) so it comes back to the same candle after a reload. A persisted anchor overrides the level's `timestamp` until the badge is dragged again. Set `false` to persist anchors yourself |
@@ -526,6 +615,8 @@ const chart = new ChartEngine({
 |---|---|---|
 | `enableForecasting` | `false` | The reworked drawing tools, as one switch — see below |
 | `orderLineTimeDrag` | `false` | Horizontal (time-axis) order-line dragging — see [Horizontal order-line dragging](#horizontal-time-axis-order-line-dragging) |
+| `pnlPill` | `false` | Floating on-chart P/L pill — count and summed P/L of the positions on the chart — see [On-chart P/L pill](#on-chart-pl-pill--featurespnlpill) |
+| `tradeActionBar` | `false` | The trade button opens a segmented `Alert · Pending · SL · TP · TSL · ×` bar at the clicked price instead of the two-row Buy/Sell popup — see [Trade action bar](#trade-action-bar--featurestradeactionbar) |
 
 `enableForecasting` turns on three things together:
 
@@ -606,7 +697,7 @@ import { DEFAULT_UI_CONFIG } from 'acttrader-charts';
 
 | Component key | Configurable properties |
 |---|---|
-| `drawingToolbar` | `iconBtnSize`, `iconFontSize`, `iconFontFamily`, `flyoutLabelFontSize`, `flyoutLabelFontFamily`, `shortcutFontSize`, `soonBadgeFontSize`, `flyoutHeadingFontSize`, `flyoutHeadingLetterSpacing`, `scrollBtnHeight`, `scrollBtnFontSize`, `barPadding`, `btnGap` |
+| `drawingToolbar` | `iconBtnSize`, `iconFontSize`, `iconFontFamily`, `flyoutLabelFontSize`, `flyoutLabelFontFamily`, `shortcutFontSize`, `soonBadgeFontSize`, `flyoutHeadingFontSize`, `flyoutHeadingLetterSpacing`, `scrollBtnHeight`, `scrollBtnFontSize`, `barPadding`, `btnGap`, `modernIcons`, `actionsButtonIcon` (`'default'` \| `'lock'` — lock glyph on the Actions button, for hosts that relabel Lock All as "Save Charts") |
 | `topBar` | `height`, `dropBtnFontSize`, `dropBtnFontFamily`, `drawBtnSize`, `drawBtnIconFontSize`, `iconBtnSize`, `mobileIconBtnSize`, `mobileDrawBtnIconSize`, `flyoutRowFontSize`, `flyoutRowFontFamily`, `flyoutCategoryFontSize`, `flyoutCategoryLetterSpacing`, `flyoutCheckFontSize`, `streamDotSize` |
 | `bottomBar` | `height`, `btnFontSize`, `btnFontFamily` |
 | `priceAxis` | `fontSize`, `fontFamily` |
@@ -684,6 +775,11 @@ new ChartEngine({
 | `topBar.series` | `area` | `'Area'` | |
 | `topBar` | `indicatorsBtn` | `'Indicators'` | Indicators button (no active) |
 | `topBar` | `indicatorsBtnActive` | `'Indicators ({count})'` | `{count}` replaced at runtime |
+| `topBar` | `disableCrosshairTitle` | `'Disable crosshair'` | Header crosshair switch tooltip while on (`enableCrosshairToggle`) |
+| `topBar` | `enableCrosshairTitle` | `'Enable crosshair'` | Header crosshair switch tooltip while off |
+| `topBar` | `pnlPillBtn` | `'P/L'` | Header P/L pill switch label (`features.pnlPill`) |
+| `topBar` | `hidePnlPillTitle` | `'Hide P/L pill for {symbol}'` | P/L switch tooltip while the pill is shown |
+| `topBar` | `showPnlPillTitle` | `'Show P/L pill for {symbol}'` | P/L switch tooltip while the pill is hidden |
 | `topBar` | `toggleDrawingTitle` | `'Toggle Drawing Tools'` | Toolbar toggle tooltip |
 | `topBar` | `toggleFullscreenTitle` | `'Toggle Fullscreen'` | Fullscreen button tooltip |
 | `topBar` | `exitFullscreenTitle` | `'Exit Fullscreen'` | |
@@ -726,6 +822,14 @@ new ChartEngine({
 | `trade` | `market` | `'Market'` | |
 | `trade` | `qty` | `'Qty'` | Draft order qty input label |
 | `trade` | `placeOrderTitle` | `'Place order at this price'` | Trade button tooltip |
+| `trade` | `actionAlert` … `actionTsl` | `'Alert'`, `'Pending'`, `'SL'`, `'TP'`, `'TSL'` | Trade action bar chips (`features.tradeActionBar`) |
+| `trade` | `actionCloseTitle` | `'Close'` | Trade action bar × tooltip |
+| `trade` | `directionAbove`, `directionBelow` | `'Above'`, `'Below'` | Pending sub-menu header — side of the market the clicked price is on |
+| `pnlPill` | `positionsAbbrev` | `'POS'` | On-chart P/L pill — word after the count (`3 POS`), shown uppercase |
+| `pnlPill` | `showPositionsTitle` | `'Show positions on chart · drag handle to move · double-click to reset'` | Pill tooltip while collapsed — a body click fans the positions out |
+| `pnlPill` | `hidePositionsTitle` | `'Hide positions on chart · drag handle to move · double-click to reset'` | Pill tooltip while fanned out |
+| `pnlPill` | `bulkLevelsTitle` | `'Set SL · TP · TSL on all {count} {symbol} positions'` | ◎ tooltip — opens the host's Bulk Levels dialog |
+| `pnlPill` | `closeAllTitle` | `'Close all {symbol} positions'` | Amber ✕ tooltip; `{symbol}` and `{count}` are filled in |
 | `dialogs.settings` | `title` | `'Chart Settings'` | Dialog title |
 | `dialogs.settings` | `tfcSection` | `'Trade from Charts'` | Section heading |
 | `dialogs.settings` | `showLabel` | `'Show'` | Radio group label |
@@ -858,6 +962,7 @@ chart.cancelCurrentEdit(): this   // cancel the active draft order or any in-pro
 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 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
+chart.setPnlPillVisible(visible: boolean): this   // show/hide the on-chart P/L pill (features.pnlPill) — what the header's P/L switch does; emits pnlPillToggle
 ```
 
 > **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.
@@ -866,8 +971,14 @@ chart.setTfcActive(enabled: boolean): this   // toggle TFC on/off at runtime; hi
 
 ```ts
 chart.setOrderLots(lots: number): void   // update default qty at runtime
+chart.setCrosshairEnabled(enabled: boolean): this   // off hides the crosshair AND this button — it rides on the crosshair line, so it has no place once the line is gone
 ```
 
+The button follows the crosshair's horizontal line, so it is only ever shown while the
+crosshair is (`crosshairEnabled`, default `true`). Hosts with a crosshair on/off control
+should call `setCrosshairEnabled()` rather than painting the crosshair transparent — the
+latter leaves the button riding an invisible line.
+
 ### Viewport
 
 ```ts
@@ -1216,6 +1327,10 @@ chart.on('tradeLevelEditCancelled', ({ label, type, isFullscreen }) => {}); // E
 chart.on('draftInitiated',     ({ side, price, orderType, isFullscreen }) => {}); // new draft order shown — open buy/sell form
 chart.on('draftCancelled',     ({ label, isFullscreen }) => {}); // draft order dismissed without confirming
 chart.on('tfcToggle',         ({ enabled }) => {}); // TFC toggled on or off via top bar button or setTfcActive()
+chart.on('crosshairToggle',   ({ enabled }) => {}); // crosshair switched on or off — header switch (enableCrosshairToggle) or setCrosshairEnabled(); persist it here
+chart.on('pnlPillCloseAll',   ({ count, pnl, labels, data, isFullscreen }) => {}); // the on-chart P/L pill's ✕ — close these positions (features.pnlPill)
+chart.on('pnlPillToggle',     ({ visible }) => {}); // the header's P/L switch showed or hid the pill — persist it here (features.pnlPill)
+chart.on('bulkLevelsRequested', ({ kind, price, source, isFullscreen }) => {}); // action-bar chip (price) or the P/L pill's ◎ (price null) — open your Bulk Levels dialog for `kind`
 chart.on('tradeLevelDragEnd',  ({ label, type, newPrice, data }) => {}); // deprecated — use tradeLevelEdit
 chart.on('tradeLevelBracketDrag', ({ label, bracketType, newPrice, data }) => {}); // deprecated
 

package/dist/{MACD-lXwCQ5We.d.cts → MACD-OBa3OUGO.d.cts}

@@ -89,6 +89,15 @@ interface DrawingToolbarUiConfig {
      * Default: `false` (original icons, unchanged for all existing consumers).
      */
     modernIcons?: boolean;
+    /**
+     * Glyph on the toolbar's Actions button — the one that opens Undo / Redo /
+     * Delete / Clear / Hide / Lock All. `'lock'` uses the same lock as the Lock
+     * All action, so the button reads as the place where drawings get locked and
+     * saved (the Hanko reference; pair it with a `labels.drawingToolbar.actions.lockAll`
+     * override such as "Save Charts"). Default `'default'`: the classic ⋯, or the
+     * Lucide pointer when `modernIcons` is on — unchanged for existing consumers.
+     */
+    actionsButtonIcon?: 'default' | 'lock';
 }
 interface TopBarUiConfig {
     /** Height of the top bar strip */
@@ -243,6 +252,16 @@ interface TopBarLabels {
     settingsTitle: string;
     /** Tooltip on the TFC (Trade from Charts) toggle button. */
     tfcToggleTitle: string;
+    /** Crosshair switch tooltip while the crosshair is on (`enableCrosshairToggle`). */
+    disableCrosshairTitle: string;
+    /** Crosshair switch tooltip while the crosshair is off. */
+    enableCrosshairTitle: string;
+    /** Header P/L pill switch label (`features.pnlPill`). */
+    pnlPillBtn: string;
+    /** P/L pill switch tooltip while the pill is shown. `{symbol}` is filled in. */
+    hidePnlPillTitle: string;
+    /** P/L pill switch tooltip while the pill is hidden. */
+    showPnlPillTitle: string;
 }
 interface BottomBarLabels {
     /** Duration selector button labels. */
@@ -316,6 +335,16 @@ interface TradeLabels {
     qty: string;
     /** Tooltip on the floating trade button (⊕). */
     placeOrderTitle: string;
+    /** Trade action bar (`features.tradeActionBar`) chips — Alert · Pending · SL · TP · TSL — and its × tooltip. */
+    actionAlert: string;
+    actionPending: string;
+    actionSl: string;
+    actionTp: string;
+    actionTsl: string;
+    actionCloseTitle: string;
+    /** Pending sub-menu header: which side of the market the clicked price is on. */
+    directionAbove: string;
+    directionBelow: string;
 }
 interface DialogLabels {
     /** Chart Settings dialog. */
@@ -363,6 +392,19 @@ interface ChartMiscLabels {
      *  are active.  Use `{count}` as a placeholder for the count. */
     nIndicators: string;
 }
+/** On-chart P/L pill (`features.pnlPill`). Titles may use `{symbol}` and `{count}`. */
+interface PnlPillLabels {
+    /** Short word after the count — `3 POS`. Rendered uppercase. */
+    positionsAbbrev: string;
+    /** Pill tooltip while the positions are collapsed — a click on the body fans them out. */
+    showPositionsTitle: string;
+    /** Pill tooltip while the positions are fanned out. */
+    hidePositionsTitle: string;
+    /** ◎ tooltip — it opens the host's Bulk Levels dialog. `{count}` and `{symbol}` are filled in. */
+    bulkLevelsTitle: string;
+    /** Amber ✕ tooltip. */
+    closeAllTitle: string;
+}
 interface ChartLabels {
     topBar: TopBarLabels;
     bottomBar: BottomBarLabels;
@@ -371,6 +413,7 @@ interface ChartLabels {
     trade: TradeLabels;
     dialogs: DialogLabels;
     chart: ChartMiscLabels;
+    pnlPill: PnlPillLabels;
 }
 declare const DEFAULT_LABELS: ChartLabels;
 /**
@@ -582,7 +625,7 @@ interface PriceRange {
 }
 type SeriesType = "candlestick" | "hollow" | "line" | "area" | "ohlc" | "heikinashi" | "volumecandles" | "linemarkers" | "step" | "hlcarea" | "baseline" | "columns" | "highlow";
 type Theme = "dark" | "light";
-type Timeframe = "1m" | "5m" | "15m" | "30m" | "1h" | "2h" | "4h" | "8h" | "1D" | "1W" | "1M";
+type Timeframe = "1m" | "3m" | "4m" | "5m" | "10m" | "15m" | "30m" | "1h" | "2h" | "4h" | "8h" | "1D" | "1W" | "1M";
 type Duration = "1D" | "5D" | "1M" | "3M" | "6M" | "1Y" | "5Y" | "All";
 interface Padding {
     top: number;
@@ -672,6 +715,23 @@ interface AccountSpec {
     /** Percent of the account risked per trade. Default `1`. */
     riskPercent?: number;
 }
+/**
+ * Text options for the on-chart P/L pill (`features.pnlPill`). The chart sums the
+ * numeric `pnl` each position level carries (`setLevels`' `pnlKey`); these only
+ * decide how that total is written.
+ */
+interface PnlPillConfig {
+    /** Currency code the default formatter appends after a space — `+72.65 USD`. Omit for none. */
+    currency?: string;
+    /** Replaces the default `+72.65 USD` formatter. Receives the summed P/L. */
+    format?: (pnl: number) => string;
+    /**
+     * Whether the pill starts shown. The header's P/L switch (rendered with the
+     * feature) and `setPnlPillVisible()` change it at runtime; `pnlPillToggle`
+     * reports the change so a host can persist it. Default: true.
+     */
+    visible?: boolean;
+}
 interface ChartConfig {
     container: HTMLElement;
     theme?: Theme;
@@ -1082,6 +1142,22 @@ interface ChartConfig {
      * Clamped to `[1, 3]`. Default: `1`.
      */
     tradeLevelButtonScale?: number;
+    /**
+     * Shrinks the main-level info box — the on-chart position / order tag with its P/L,
+     * side, lots and ✎ × buttons. Font, padding, row height, grip and buttons scale
+     * together, hit areas included; `0.6` is roughly half the area of the default tag.
+     * SL/TP bracket pills are unaffected. Clamped to `[0.5, 1]`. Default: `1`.
+     */
+    tradeLevelBadgeScale?: number;
+    /**
+     * Where the main-level info box sits horizontally. `'auto'` (default): centred on the
+     * chart, or over the level's time anchor with `features.orderLineTimeDrag`. `'left'`:
+     * the tag's home is the plot's left edge, like an axis label, whatever the open price
+     * or time — so it never covers the candles until the trader decides otherwise. With
+     * `features.orderLineTimeDrag` a `timeDraggable` tag can still be dragged along the
+     * time axis, and the drop is remembered exactly as before. Default: `'auto'`.
+     */
+    tradeLevelBadgeAnchor?: 'auto' | 'left';
     /**
      * What the SL/TP bracket pills show.
      *
@@ -1132,7 +1208,10 @@ interface ChartConfig {
      *                   (preferred for branded designs that still want a link affordance)
      */
     symbolNameDecoration?: 'underline' | 'none' | 'hover';
-    /** Called when the user clicks "Add alert" in the trade popover. Omit to hide the alert row. */
+    /**
+     * Called with the clicked price when the user picks **Alert** on the trade
+     * action bar (`features.tradeActionBar`). Omit to leave the Alert chip out.
+     */
     onAddAlert?: (price: number) => void;
     /**
      * Header layout variant. Default `'simple'`.
@@ -1203,6 +1282,32 @@ interface ChartConfig {
      * (a one-time `console.warn` is logged at init).
      */
     enableSnapshot?: boolean;
+    /**
+     * Put a crosshair on/off switch in the header (advanced toolbar and default
+     * top bar). Clicking it calls `setCrosshairEnabled()`, so the crosshair and
+     * the floating "place order at this price" button go together, and emits
+     * `crosshairToggle` for the host to persist the choice. Starts from
+     * `crosshairEnabled`. Default: false.
+     */
+    enableCrosshairToggle?: boolean;
+    /**
+     * Advanced header only (`headerLayout: 'advanced'`): fold Indicators, Compare,
+     * Snapshot and Chart settings into one ⋯ menu at the right end of the bar, and
+     * make the Layout button icon-only, so the right cluster stays short next to
+     * the crosshair and P/L switches. Each folded item keeps its behaviour — the
+     * Indicators entry opens the same searchable list. Default: false.
+     */
+    headerOverflowMenu?: boolean;
+    /** Currency code and formatter for the on-chart P/L pill — see `features.pnlPill`. */
+    pnlPill?: PnlPillConfig;
+    /**
+     * Timeframes offered in the header, in this order — the advanced toolbar's pill row,
+     * the classic top bar's dropdown, and the compact header's ⌄ menu (its six fixed pills
+     * come first; the rest of this list fills the menu). Omit to keep the classic set, so
+     * `3m` / `4m` / `10m` / `30m` only appear for hosts that list them. Every value must be
+     * a `Timeframe` the chart can load or aggregate (see `aggregateFrom`).
+     */
+    timeframes?: Timeframe[];
     /**
      * Opt-in feature flags.  All flags default to `false` / disabled so existing
      * consumers are completely unaffected when this field is omitted.
@@ -1243,6 +1348,27 @@ interface ChartConfig {
          * pips on both the position tools and the ruler come from `instrument`.
          */
         enableForecasting?: boolean;
+        /**
+         * Floating on-chart P/L pill — `⋮⋮ 3 POS +72.65 USD | ◎ ✕` — summarising the
+         * open positions passed through `setLevels`: their count and the sum of the
+         * numeric `pnl` each carries (the chart computes no money of its own).
+         * A click on the body fans every position badge out on the chart (clustered
+         * levels expand, TFC is switched on if needed) and lights the accent ring;
+         * click again to collapse. Draggable within the plot, double-click puts it
+         * back top-right. ◎ emits `bulkLevelsRequested` for the host's Bulk Levels dialog; the amber ✕ emits `pnlPillCloseAll` and the host closes the
+         * positions. Hidden while there are no positions. Text is shaped by
+         * top-level `pnlPill`. Default: false.
+         */
+        pnlPill?: boolean;
+        /**
+         * Replace the two-row pending-order popup that the trade button opens with a
+         * segmented action bar at the clicked price — `Alert | Pending | SL | TP | TSL | ×`,
+         * no price readout (the axis shows it). Alert calls `onAddAlert` (chip only
+         * shown when that is set); Pending opens the Buy/Sell Limit/Stop list as a
+         * sub-menu above the bar; SL / TP / TSL emit `bulkLevelsRequested` for the
+         * host's Bulk Levels dialog. Default: false.
+         */
+        tradeActionBar?: boolean;
     };
     /**
      * Fetches historical OHLC bars for a compare symbol. When provided, the
@@ -1306,6 +1432,16 @@ interface ChartConfig {
      * allowing the user to enable/disable TFC at runtime.
      */
     tfcEnabled?: boolean;
+    /**
+     * Draw the mouse crosshair and, with it, the floating "place order at this
+     * price" button that rides along its horizontal line. `false` hides both: no
+     * crosshair lines or axis readouts, `crosshair` events carry `null`, mirrored
+     * `setCrosshair()` calls are ignored, the mobile long-press crosshair does not
+     * arm, and the trade button stays hidden until the crosshair is enabled again.
+     * Trade levels, drawings and the TFC state are unaffected. Runtime toggle:
+     * `setCrosshairEnabled()`. Default: true.
+     */
+    crosshairEnabled?: boolean;
     /**
      * Snap a horizontally-dragged order line to the nearest candle on drag release.
      * Only relevant when `features.orderLineTimeDrag` is enabled. When `false`, the badge
@@ -1739,6 +1875,40 @@ type ChartEventMap = {
     tfcToggle: {
         enabled: boolean;
     };
+    /** Crosshair switched on or off — via the header switch (`enableCrosshairToggle`) or `setCrosshairEnabled()`. */
+    crosshairToggle: {
+        enabled: boolean;
+    };
+    /** The P/L pill was shown or hidden — via the header's P/L switch or `setPnlPillVisible()` (`features.pnlPill`). */
+    pnlPillToggle: {
+        visible: boolean;
+    };
+    /**
+     * Open the host's Bulk Levels dialog — one SL / TP / TSL for every open position of
+     * the symbol. From the trade action bar (`source: 'actionBar'`) `kind` is the chip
+     * clicked and `price` the clicked price; from the P/L pill's ◎ (`source: 'pill'`)
+     * `kind` is `'sl'` and `price` is `null` — no level was clicked, so the dialog opens
+     * with an empty price. The chart never calls a broker.
+     */
+    bulkLevelsRequested: {
+        kind: 'sl' | 'tp' | 'tsl';
+        price: number | null;
+        isFullscreen: boolean;
+        source: 'actionBar' | 'pill';
+    };
+    /**
+     * The on-chart P/L pill's ✕ (`features.pnlPill`). Carries every position the pill
+     * counted — the host closes them; the chart never calls a broker. `pnl` is the
+     * summed P/L, or null when no position carried one. `data` are the rows given to
+     * `setLevels`, in the same order as `labels`.
+     */
+    pnlPillCloseAll: {
+        count: number;
+        pnl: number | null;
+        labels: string[];
+        data: unknown[];
+        isFullscreen: 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. */
@@ -2158,4 +2328,4 @@ declare class MACD implements IIndicator {
     render(ctx: CanvasRenderingContext2D, results: IndicatorResult[], scale: ScaleManager, viewport: Viewport, paneHeight: number, rangeOverride?: PriceRange): void;
 }
 
-export { type DeepPartial$1 as $, type AccountSpec as A, BollingerBands as B, type ChartConfig as C, type Duration as D, type CrosshairPosition as E, type CrosshairUiConfig as F, DARK_THEME as G, DEFAULT_BOTTOM_BAR_CONFIG as H, type IIndicator as I, DEFAULT_CROSSHAIR_CONFIG as J, DEFAULT_DRAWING_TOOLBAR_CONFIG as K, type LayoutSyncState as L, DEFAULT_INDICATOR_OVERLAY_CONFIG as M, DEFAULT_LABELS as N, type OHLCVBar as O, type PriceRange as P, DEFAULT_LAYOUT_SYNC as Q, type ResolvedInstrument as R, type SeriesType as S, type Timeframe as T, DEFAULT_PRICE_AXIS_CONFIG as U, type Viewport as V, DEFAULT_TIME_AXIS_CONFIG as W, DEFAULT_TOP_BAR_CONFIG as X, DEFAULT_TRADE_BUTTON_CONFIG as Y, DEFAULT_UI_CONFIG as Z, type DataLoaderParams as _, type IndicatorParams as a, type DeepPartialChartTheme as a0, type DialogLabels as a1, type DrawingToolbarColors as a2, type DrawingToolbarLabels as a3, type DrawingToolbarUiConfig as a4, EMA as a5, type IndicatorOverlayColors as a6, type IndicatorOverlayUiConfig as a7, type IndicatorResult as a8, type IndicatorStateEntry as a9, type TradeLevelColors as aA, type TradePanelColors as aB, type UiConfig as aC, deepMergeTheme as aD, formatDuration as aE, formatVolume as aF, getAllPresets as aG, getCustomPresets as aH, getPreset as aI, inferPipSize as aJ, registerCustomPreset as aK, resolveCssVarsInTheme as aL, resolveInstrument as aM, resolveLabels as aN, resolveUiConfig as aO, toMoney as aP, toPips as aQ, unregisterCustomPreset as aR, type PriceSource as aS, LAYOUT_PRESETS as aa, LIGHT_THEME as ab, type LayoutPreset as ac, MACD as ad, type OhlcLabels as ae, type OrderSubmit as af, PRESETS_BY_COUNT as ag, PRESET_COUNTS as ah, PRESET_LABEL as ai, type Padding as aj, type PendingOrderLevel as ak, type PositionLevel as al, type PositionRenderStyle as am, type PriceAxisUiConfig as an, RSI as ao, SMA as ap, type Theme as aq, type ThemeOverrides as ar, type TimeAxisUiConfig as as, type TopBarColors as at, type TopBarLabels as au, type TopBarUiConfig as av, type TradeButtonUiConfig as aw, type TradeDisplayFilter as ax, type TradeLabels as ay, type TradeLevel as az, type ChartEventMap as b, type ChartState as c, type InstrumentSpec as d, type DrawingToolType as e, type IDrawing as f, type AnyDrawingStyle as g, type IWebSocketAdapter as h, type TradeLevelType as i, type ChartTheme as j, type AnyLevel as k, type DrawingPoint as l, ScaleManager as m, type DrawingHandle as n, type DrawingRenderContext as o, type SerializedDrawing as p, type Tick as q, type StreamStatus as r, type ActiveIndicatorState as s, type BottomBarColors as t, type BottomBarLabels as u, type BottomBarUiConfig as v, type CanvasColorSettings as w, type ChartLabels as x, type ChartMiscLabels as y, type ChartThemeUi as z };
+export { type DataLoaderParams as $, type AccountSpec as A, BollingerBands as B, type ChartConfig as C, type Duration as D, type ChartThemeUi as E, type CrosshairPosition as F, type CrosshairUiConfig as G, DARK_THEME as H, type IIndicator as I, DEFAULT_BOTTOM_BAR_CONFIG as J, DEFAULT_CROSSHAIR_CONFIG as K, type LayoutSyncState as L, DEFAULT_DRAWING_TOOLBAR_CONFIG as M, DEFAULT_INDICATOR_OVERLAY_CONFIG as N, type OHLCVBar as O, type PositionLevel as P, DEFAULT_LABELS as Q, type ResolvedInstrument as R, type SeriesType as S, type Timeframe as T, DEFAULT_LAYOUT_SYNC as U, type Viewport as V, DEFAULT_PRICE_AXIS_CONFIG as W, DEFAULT_TIME_AXIS_CONFIG as X, DEFAULT_TOP_BAR_CONFIG as Y, DEFAULT_TRADE_BUTTON_CONFIG as Z, DEFAULT_UI_CONFIG as _, type IndicatorParams as a, type DeepPartial$1 as a0, type DeepPartialChartTheme as a1, type DialogLabels as a2, type DrawingToolbarColors as a3, type DrawingToolbarLabels as a4, type DrawingToolbarUiConfig as a5, EMA as a6, type IndicatorOverlayColors as a7, type IndicatorOverlayUiConfig as a8, type IndicatorResult as a9, type TradeLabels as aA, type TradeLevel as aB, type TradeLevelColors as aC, type TradePanelColors as aD, type UiConfig as aE, deepMergeTheme as aF, formatDuration as aG, formatVolume as aH, getAllPresets as aI, getCustomPresets as aJ, getPreset as aK, inferPipSize as aL, registerCustomPreset as aM, resolveCssVarsInTheme as aN, resolveInstrument as aO, resolveLabels as aP, resolveUiConfig as aQ, toMoney as aR, toPips as aS, unregisterCustomPreset as aT, type PriceSource as aU, type IndicatorStateEntry as aa, LAYOUT_PRESETS as ab, LIGHT_THEME as ac, type LayoutPreset as ad, MACD as ae, type OhlcLabels as af, type OrderSubmit as ag, PRESETS_BY_COUNT as ah, PRESET_COUNTS as ai, PRESET_LABEL as aj, type Padding as ak, type PendingOrderLevel as al, type PnlPillConfig as am, type PnlPillLabels as an, type PositionRenderStyle as ao, type PriceAxisUiConfig as ap, RSI as aq, SMA as ar, type Theme as as, type ThemeOverrides as at, type TimeAxisUiConfig as au, type TopBarColors as av, type TopBarLabels as aw, type TopBarUiConfig as ax, type TradeButtonUiConfig as ay, type TradeDisplayFilter as az, type ChartEventMap as b, type ChartState as c, type InstrumentSpec as d, type DrawingToolType as e, type IDrawing as f, type AnyDrawingStyle as g, type IWebSocketAdapter as h, type TradeLevelType as i, type ChartTheme as j, type AnyLevel as k, type DrawingPoint as l, ScaleManager as m, type PriceRange as n, type DrawingHandle as o, type DrawingRenderContext as p, type SerializedDrawing as q, type Tick as r, type StreamStatus as s, type ActiveIndicatorState as t, type BottomBarColors as u, type BottomBarLabels as v, type BottomBarUiConfig as w, type CanvasColorSettings as x, type ChartLabels as y, type ChartMiscLabels as z };