acttrader-charts 1.3.0-beta.2 → 1.3.0-beta.21

package/dist/{MACD-D1i-sEFR.d.cts → MACD-B6SoR6iH.d.cts}

@@ -1,3 +1,13 @@
+declare class ScaleManager {
+    private static readonly VERTICAL_PADDING_PX;
+    xToPixel(index: number, viewport: Viewport, chartWidth: number): number;
+    pixelToBarIndex(x: number, viewport: Viewport, chartWidth: number): number;
+    candleBodyWidth(viewport: Viewport, chartWidth: number): number;
+    yToPixel(price: number, range: PriceRange, chartHeight: number): number;
+    pixelToPrice(y: number, range: PriceRange, chartHeight: number): number;
+    volumeToPixel(volume: number, maxVolume: number, volumePanelHeight: number): number;
+}
+
 /**
  * Definition of a multi-chart layout preset (grid template).
  * Used by the chart-owned LayoutPopover and emitted via the `layoutChange` event.
@@ -45,16 +55,6 @@ declare const PRESET_LABEL: Record<string, string>;
 /** Default sync state — matches the host's current defaults in useChartLayout.ts. */
 declare const DEFAULT_LAYOUT_SYNC: LayoutSyncState;
 
-declare class ScaleManager {
-    private static readonly VERTICAL_PADDING_PX;
-    xToPixel(index: number, viewport: Viewport, chartWidth: number): number;
-    pixelToBarIndex(x: number, viewport: Viewport, chartWidth: number): number;
-    candleBodyWidth(viewport: Viewport, chartWidth: number): number;
-    yToPixel(price: number, range: PriceRange, chartHeight: number): number;
-    pixelToPrice(y: number, range: PriceRange, chartHeight: number): number;
-    volumeToPixel(volume: number, maxVolume: number, volumePanelHeight: number): number;
-}
-
 interface DrawingToolbarUiConfig {
     /** Icon button size (width = height) in px */
     iconBtnSize: number;
@@ -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. */
@@ -262,6 +281,7 @@ interface DrawingToolbarLabels {
         elliott: string;
         brushes: string;
         advanced: string;
+        forecasting: string;
         priceProjection: string;
     };
     /** Individual drawing tool names (used in flyout rows). */
@@ -315,6 +335,20 @@ 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;
+    /** SL / TP / TSL chips greyed out: no open positions on the symbol. `{symbol}` is filled in. */
+    actionBulkNoPositionsTitle: string;
+    /** SL / TP / TSL chips greyed out: buys and sells both open — one price cannot suit both. */
+    actionBulkMixedTitle: string;
 }
 interface DialogLabels {
     /** Chart Settings dialog. */
@@ -362,6 +396,21 @@ 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;
+    /** ◎ tooltip while greyed out because buys and sells are both open. */
+    bulkLevelsMixedTitle: string;
+    /** Amber ✕ tooltip. */
+    closeAllTitle: string;
+}
 interface ChartLabels {
     topBar: TopBarLabels;
     bottomBar: BottomBarLabels;
@@ -370,6 +419,7 @@ interface ChartLabels {
     trade: TradeLabels;
     dialogs: DialogLabels;
     chart: ChartMiscLabels;
+    pnlPill: PnlPillLabels;
 }
 declare const DEFAULT_LABELS: ChartLabels;
 /**
@@ -581,7 +631,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;
@@ -602,6 +652,15 @@ interface DataLoaderParams {
     start: Date;
     end: Date;
     interval: string;
+    /**
+     * Which price the chart is currently building candles from
+     * (`tickClosePriceSource`: `'bid'`, `'ask'` or `'ltp'`). Forward it to your
+     * history API (e.g. as a query parameter) so the fetched bars match the
+     * source the user picked in the header dropdown — the engine re-runs the
+     * loader with the new value whenever the source changes. Always set by the
+     * engine; optional only so callers that build params by hand keep compiling.
+     */
+    priceSource?: 'bid' | 'ask' | 'ltp';
 }
 /**
  * Params passed to `compareDataLoader`. Mirrors `DataLoaderParams` but also
@@ -618,6 +677,67 @@ type ThemeOverrides = {
     dark?: DeepPartialChartTheme;
     light?: DeepPartialChartTheme;
 };
+/**
+ * What a price *means* for this instrument.
+ *
+ * The chart reads prices, never contract specs — so a tool that wants to report
+ * a distance in pips, or convert it to money, has to be told how. Every field is
+ * optional and every one degrades to a documented fallback, so an existing
+ * integration that omits the block keeps working and simply shows price-only
+ * readouts.
+ *
+ * Per-position values still travel on the individual `TradeLevel`; this block is
+ * the instrument-wide default for tools that aren't attached to a position.
+ */
+interface InstrumentSpec {
+    /**
+     * Price distance counted as one pip — `0.0001` for most FX pairs, `0.01` for
+     * JPY crosses. Inferred from the feed's decimal count when omitted, which
+     * follows the usual FX convention and is wrong for metals, indices and
+     * crypto. Pass it explicitly if pips matter.
+     */
+    pipSize?: number;
+    /** Units per lot (e.g. `100` for XAUUSD, `100000` for most FX pairs). Default `1`. */
+    contractSize?: number;
+    /** Account-currency value of one price unit per contract unit. Default `1`. */
+    valuePerPoint?: number;
+    /** Symbol prefixed to money figures. Default `'$'`. */
+    currencySymbol?: string;
+}
+/**
+ * Account figures the position tools size themselves against.
+ *
+ * TradingView asks the user for these because it has no broker connection. A
+ * host that does know the live account should pass them here instead, and keep
+ * them current — the tool then sizes against real equity rather than a number
+ * the user typed once and forgot.
+ *
+ * Omit the block and the position tools still draw, showing price, percent,
+ * pips and risk/reward but no quantity or money amounts.
+ */
+interface AccountSpec {
+    /** Account equity in the account currency. */
+    size?: number;
+    /** 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;
@@ -633,6 +753,17 @@ interface ChartConfig {
     timeframe?: Timeframe;
     duration?: Duration;
     symbol?: string;
+    /**
+     * Contract specs for the current symbol. Lets measurement and position tools
+     * report pips and money instead of bare price distances. Swap it alongside
+     * the symbol via `setInstrument()`.
+     */
+    instrument?: InstrumentSpec;
+    /**
+     * Account equity and per-trade risk used to size the Long/Short position
+     * tools. Keep it current via `setAccount()`.
+     */
+    account?: AccountSpec;
     /** List of symbols/ISINs the user can switch between via the symbol picker modal. */
     isins?: string[];
     /** Called when the user picks a symbol from the picker modal. Parent should call setSymbol() + setData(). */
@@ -856,6 +987,22 @@ interface ChartConfig {
      * mode (candles still build from the LTP).
      */
     showLtpPrice?: boolean;
+    /**
+     * Show a price-source dropdown in the chart header listing the given
+     * sources (e.g. `['ltp', 'bid']` for dealing feeds). Selecting an option
+     * switches `tickClosePriceSource` at runtime and emits `priceSourceChange`
+     * so the host can persist the choice. Hidden when unset or empty.
+     * Rendered by the default header layout.
+     */
+    priceSourceSelector?: Array<'bid' | 'ask' | 'ltp'>;
+    /**
+     * Re-run `dataLoader` whenever the candle price source changes (a header
+     * dropdown pick or `setTickClosePriceSource()`), passing the new source as
+     * `params.priceSource`, so the historical candles are rebuilt from the
+     * selected price and not just the live one. Set `false` to keep the old
+     * behavior where only live ticks follow the new source. Default: `true`.
+     */
+    reloadOnPriceSourceChange?: boolean;
     /**
      * When the combined count of open positions and pending orders exceeds this
      * number, the position render style auto-defaults to `'dot'` (compact).
@@ -986,6 +1133,16 @@ interface ChartConfig {
      * Default: `true`. Set `false` to only show them on hover/selection.
      */
     showTradeLevelsAlways?: boolean;
+    /**
+     * When a level gains a new SL/TP — the host's order panel just placed it, so it
+     * arrives via `setLevels()`, `updateLevelBracket()` or `updateDraftOrderBracket()`
+     * — and that price sits outside the visible price range, widen (compress) the
+     * price axis so the new line comes into view together with the candles already
+     * on screen. Animated; the trader can drag or reset the axis afterwards as usual.
+     * A bracket dragged on the chart is visible by construction, so this never fires
+     * for it. Off in compare (percent) mode. Default: `false`.
+     */
+    revealNewBrackets?: boolean;
     /**
      * Show the candle countdown timer on the right price axis, just below
      * the live price tag. Subject to the same `candleCountdownTimeframes`
@@ -1001,6 +1158,40 @@ 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.
+     *
+     * `'price'` (default) renders the bracket price — `SL 4159.00`.
+     * `'amount'` renders the money the position gains or loses if that bracket
+     * is hit — `SL -$290.80` — computed from the level's `lots`, `contractSize`
+     * and `valuePerPoint`. Falls back to the price for any level lacking the
+     * data needed to compute it, so a partial rollout degrades gracefully.
+     * `'priceAndAmount'` keeps the price but puts the currency symbol in front
+     * of it — `SL $1.27859` — and appends the P/L while the bracket is being
+     * dragged: `SL $1.27859  -$29.08`.
+     */
+    bracketLabelMode?: 'price' | 'amount' | 'priceAndAmount';
+    /**
+     * Currency symbol for SL/TP amounts, used when `bracketLabelMode: 'amount'`
+     * and the level does not carry its own `currencySymbol`. Default `'$'`.
+     */
+    currencySymbol?: string;
     /**
      * When `true`, a theme toggle (Dark / Light) is shown in the Settings dialog.
      * Default: `false` — the toggle is hidden.
@@ -1033,7 +1224,12 @@ 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`), and with the current market price
+     * (live ask, else bid, else last close) from the **Alert** entry of the
+     * advanced header's ⋯ menu (`headerOverflowMenu`). Omit to leave both out.
+     */
     onAddAlert?: (price: number) => void;
     /**
      * Header layout variant. Default `'simple'`.
@@ -1104,6 +1300,39 @@ interface ChartConfig {
      * (a one-time `console.warn` is logged at init).
      */
     enableSnapshot?: boolean;
+    /**
+     * Put a crosshair on/off switch in the header (advanced toolbar, default top
+     * bar and the compact per-pane strip). The crosshair itself stays on by default (`crosshairEnabled`), so
+     * the icon starts tinted; clicking it calls `setCrosshairEnabled(false)` — the
+     * icon drops to its plain state and the crosshair (with the floating "place
+     * order at this price" button that rides on it) disappears until the icon is
+     * clicked again. Emits `crosshairToggle` for the host to persist the choice.
+     * Default: false.
+     */
+    enableCrossHairHeader?: boolean;
+    /**
+     * @deprecated Use `enableCrossHairHeader`. Kept as an alias so existing
+     * consumers keep their header switch — either flag being `true` renders it.
+     */
+    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.
@@ -1118,11 +1347,56 @@ interface ChartConfig {
          * Enable horizontal (time-axis) order-line dragging: a level whose `timeDraggable`
          * is true can have its info-box badge dragged left/right to re-anchor the order to
          * a different candle (price stays locked), emitting `orderLineMoved` on release.
+         * Levels that can also be price-dragged (pending orders, entry-editable positions)
+         * keep that: the first movement of a badge grab decides the axis — sideways moves
+         * the time anchor, up/down moves the price as before.
          * This is the broker-gating seam — hosts (e.g. the Hankotrade app) enable it only
          * for their flagged users. When `false` / omitted, behavior is unchanged.
          * Default: false.
          */
         orderLineTimeDrag?: boolean;
+        /**
+         * Enables the AWT-2642 forecasting/drawing work as one switch:
+         *
+         * - **Long Position** / **Short Position** in a new **Forecasting** group
+         *   in the drawing toolbar. Drawings only — nothing reaches the broker.
+         * - **Brush** and **Highlighter** draw freehand (press, drag, release)
+         *   instead of dropping one point per click.
+         * - **Ruler** reports percent, pips, calendar duration and volume instead
+         *   of just a bar count and raw price delta.
+         *
+         * One flag rather than three because they ship and roll back together —
+         * a broker either has the reworked drawing tools or it doesn't.
+         *
+         * Off by default: enabling it changes the toolbar and the gesture of two
+         * existing tools, so hosts opt in. With it off the chart behaves exactly
+         * as it did before these tools existed. Default: false.
+         *
+         * Position quantity and money amounts additionally need `account`, and
+         * 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
@@ -1186,12 +1460,42 @@ 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
      * keeps the exact (interpolated) time it was released at. Default: `true`.
      */
     orderLineDragSnap?: boolean;
+    /**
+     * Remember where each horizontally-dragged order-line badge was dropped in
+     * `localStorage` (keyed by the level's label, i.e. your order/trade id) so it comes back
+     * to the same candle after a page reload — even when the next `setLevels()` payload
+     * carries the order's original `timestamp`. A persisted anchor takes precedence over
+     * the level's `timestamp` until the label is dragged again. Bounded to the 500 most
+     * recently dragged labels. Only relevant when `features.orderLineTimeDrag` is enabled.
+     * Default: `true`.
+     */
+    orderLineAnchorPersistence?: boolean;
+    /**
+     * Where a `timeDraggable` level's badge sits before the user has dragged it:
+     * - `'timestamp'` (default): over the candle at the level's `timestamp`, as before.
+     * - `'center'`: at the chart's horizontal center, ignoring the level's `timestamp`, so a
+     *   freshly placed market order arrives mid-chart instead of pinned to the latest candle.
+     *   Once the user drags the badge it is anchored to (and persisted at) the dropped candle.
+     * Levels that are not `timeDraggable` always honor their `timestamp`.
+     * Only relevant when `features.orderLineTimeDrag` is enabled.
+     */
+    orderLineDefaultAnchor?: 'timestamp' | 'center';
 }
 interface IndicatorResult {
     index: number;
@@ -1215,7 +1519,7 @@ interface IIndicator {
     getValueRange?(results: IndicatorResult[]): PriceRange;
     render(ctx: CanvasRenderingContext2D, results: IndicatorResult[], scaleManager: ScaleManager, viewport: Viewport, chartHeight: number, rangeOverride?: PriceRange): void;
 }
-type DrawingToolType = "horizontalLine" | "verticalLine" | "trendLine" | "rectangle" | "ellipse" | "circle" | "triangle" | "fibRetracement" | "fibExtension" | "fibChannel" | "fibProjection" | "fibFan" | "fibCircles" | "fibSpiral" | "fibTimezone" | "flatChannel" | "parallelChannel" | "disjointChannel" | "pitchfork" | "schiffPitchfork" | "modifiedSchiff" | "insidePitchfork" | "crossLine" | "trendAngle" | "arc" | "sineLine" | "rotatedRectangle" | "path" | "polyline" | "brush" | "highlighter" | "text" | "callout" | "priceLabel" | "priceNote" | "anchoredNote" | "arrowUp" | "arrowDown" | "arrowMarker" | "flag" | "volumeProfile" | "anchoredVP" | "fixedRangeVP" | "abcdPattern" | "gartleyPattern" | "batPattern" | "butterflyPattern" | "crabPattern" | "sharkPattern" | "cypherPattern" | "headShoulders" | "trianglePattern" | "threeDrives" | "elliottImpulse" | "elliottCorrective" | "elliottTriangle" | "elliottWxy" | "elliottCombination" | "gannFan" | "gannSquare" | "gannBox" | "priceRange" | "dateRange" | "datePriceRange" | "ruler" | "regressionTrend" | "projection" | "cyclicLines" | "timeCycles" | "priceProjection" | "ghostFeed";
+type DrawingToolType = "horizontalLine" | "verticalLine" | "trendLine" | "rectangle" | "ellipse" | "circle" | "triangle" | "fibRetracement" | "fibExtension" | "fibChannel" | "fibProjection" | "fibFan" | "fibCircles" | "fibSpiral" | "fibTimezone" | "flatChannel" | "parallelChannel" | "disjointChannel" | "pitchfork" | "schiffPitchfork" | "modifiedSchiff" | "insidePitchfork" | "crossLine" | "trendAngle" | "arc" | "sineLine" | "rotatedRectangle" | "path" | "polyline" | "brush" | "highlighter" | "text" | "callout" | "priceLabel" | "priceNote" | "anchoredNote" | "arrowUp" | "arrowDown" | "arrowMarker" | "flag" | "volumeProfile" | "anchoredVP" | "fixedRangeVP" | "abcdPattern" | "gartleyPattern" | "batPattern" | "butterflyPattern" | "crabPattern" | "sharkPattern" | "cypherPattern" | "headShoulders" | "trianglePattern" | "threeDrives" | "elliottImpulse" | "elliottCorrective" | "elliottTriangle" | "elliottWxy" | "elliottCombination" | "gannFan" | "gannSquare" | "gannBox" | "priceRange" | "dateRange" | "datePriceRange" | "ruler" | "regressionTrend" | "projection" | "cyclicLines" | "timeCycles" | "priceProjection" | "ghostFeed" | "longPosition" | "shortPosition";
 interface DrawingPoint {
     barIndex: number;
     price: number;
@@ -1226,6 +1530,15 @@ interface DrawingPoint {
 interface DrawingHandle {
     pointIndex: number;
     cursor: string;
+    /**
+     * Corners that are a mixture of two stored points — a rectangle's top-right
+     * is `(p2.barIndex, p1.price)` — set these instead of relying on
+     * `pointIndex` alone. The drag then writes the x to `points[xPointIndex]`
+     * and the y to `points[yPointIndex]`, which is what makes all four corners
+     * of a two-point shape draggable rather than just the two stored ones.
+     */
+    xPointIndex?: number;
+    yPointIndex?: number;
 }
 /** Base per-instance style fields applicable to every drawing. */
 interface DrawingStyle {
@@ -1266,6 +1579,23 @@ interface DrawingFibStyle extends DrawingStyle {
 }
 /** Union of all drawing style shapes. */
 type AnyDrawingStyle = DrawingStyle | DrawingTextStyle | DrawingFibStyle;
+/**
+ * Extra context a drawing may need at render time, beyond geometry.
+ *
+ * Passed as one optional object rather than more positional parameters: almost
+ * no drawing needs any of it, and the ones that do (measurement and position
+ * tools) need several fields at once.
+ */
+interface DrawingRenderContext {
+    /** Resolved contract specs — pip size, contract size, money conversion. */
+    instrument?: ResolvedInstrument;
+    /** Bars currently loaded, for tools that summarise a range. */
+    bars?: readonly OHLCVBar[];
+    /** Account equity and per-trade risk, for tools that size a position. */
+    account?: AccountSpec;
+    /** Host feature gates, for tools whose output is flagged. */
+    features?: ChartConfig['features'];
+}
 interface IDrawing {
     id: string;
     type: DrawingToolType;
@@ -1276,8 +1606,17 @@ interface IDrawing {
     text?: string;
     /** Optional per-instance style override; falls back to theme defaults when absent. */
     style?: AnyDrawingStyle;
-    render(ctx: CanvasRenderingContext2D, scale: ScaleManager, viewport: Viewport, priceRange: PriceRange, chartW: number, chartH: number, isSelected: boolean, pricePrecision?: number, theme?: ChartTheme): void;
+    render(ctx: CanvasRenderingContext2D, scale: ScaleManager, viewport: Viewport, priceRange: PriceRange, chartW: number, chartH: number, isSelected: boolean, pricePrecision?: number, theme?: ChartTheme, context?: DrawingRenderContext): void;
     hitTest(x: number, y: number, scale: ScaleManager, viewport: Viewport, priceRange: PriceRange, chartW: number, chartH: number): boolean;
+    /**
+     * Called once, immediately after the drawing is completed.
+     *
+     * Lets a tool derive anchors it could not collect during placement — the
+     * position tools take entry and target from two clicks, then materialise a
+     * stop from the default risk/reward here rather than making the user click
+     * a third time.
+     */
+    onPlaced?(): void;
     /** Returns the handle under (x, y), or null if none */
     getHandle(x: number, y: number, scale: ScaleManager, viewport: Viewport, priceRange: PriceRange, chartW: number, chartH: number): DrawingHandle | null;
 }
@@ -1429,6 +1768,14 @@ type ChartEventMap = {
     seriesChange: {
         series: SeriesType;
     };
+    /** Emitted when the user picks a price source (BID / ASK / LTP) from the
+     *  header dropdown (`priceSourceSelector`). Not emitted for programmatic
+     *  `setTickClosePriceSource()` calls. By the time this fires the engine has
+     *  already switched the live source and (unless `reloadOnPriceSourceChange`
+     *  is `false`) started re-fetching history via `dataLoader`. */
+    priceSourceChange: {
+        source: 'bid' | 'ask' | 'ltp';
+    };
     streamStatus: {
         status: StreamStatus;
     };
@@ -1439,6 +1786,8 @@ type ChartEventMap = {
         interval: string;
         start: Date;
         end: Date;
+        /** Candle price source the bars were requested with (see `DataLoaderParams.priceSource`). */
+        priceSource: 'bid' | 'ask' | 'ltp';
     };
     /** Emitted when the user clicks the × button on a trade, position, or bracket (SL/TP) level. */
     tradeLevelClose: {
@@ -1554,6 +1903,40 @@ type ChartEventMap = {
     tfcToggle: {
         enabled: boolean;
     };
+    /** Crosshair switched on or off — via the header switch (`enableCrossHairHeader`) 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. */
@@ -1744,10 +2127,34 @@ interface PositionLevel {
     stopLossPrice?: number;
     /** Data object for the SL bracket — returned in SL-related events instead of the parent's `data`. */
     stopLossData?: unknown;
+    /**
+     * The stop-loss is a trailing stop. A trade with a trail always has a working stop
+     * at `stopLossPrice`, so the line still renders — its pill reads "TSL" instead of
+     * "SL" — but it is read-only on the chart (no drag handle, no ×): the trail lives
+     * in pips and is edited from the host's order panel. Default: false.
+     */
+    stopLossTrailing?: boolean;
     /** Take-profit price. Renders as a secondary dashed line above entry (buy) or below (sell). Draggable — emits `tradeLevelBracketDrag`. */
     takeProfitPrice?: number;
     /** Data object for the TP bracket — returned in TP-related events instead of the parent's `data`. */
     takeProfitData?: unknown;
+    /**
+     * Units per lot for this instrument (e.g. `100` for XAUUSD, `100000` for most
+     * FX pairs). Only used when `bracketLabelMode: 'amount'`, to convert an SL/TP
+     * price distance into money. Default `1`.
+     */
+    contractSize?: number;
+    /**
+     * Account-currency value of one price unit per contract unit — folds in any
+     * quote → account conversion. Only used when `bracketLabelMode: 'amount'`.
+     * Default `1`.
+     */
+    valuePerPoint?: number;
+    /**
+     * Currency symbol for this level's SL/TP amounts. Falls back to
+     * `ChartConfig.currencySymbol`, then `'$'`.
+     */
+    currencySymbol?: string;
     /**
      * When true, the entry price line becomes draggable — renders a grip handle and emits
      * `tradeLevelEdit` with `field: 'main'` on confirm. Use this for pending entry orders
@@ -1774,7 +2181,9 @@ interface PositionLevel {
     /**
      * When true (and `ChartConfig.features.orderLineTimeDrag` is enabled), the badge can be
      * dragged horizontally to re-anchor the order to a different candle (price stays locked).
-     * Emits `orderLineMoved` on release. Default: false.
+     * Emits `orderLineMoved` on release. An `entryPriceEditable` position keeps its vertical
+     * price drag too: the badge follows the drag direction (sideways = time, up/down = price).
+     * Default: false.
      */
     timeDraggable?: boolean;
     /**
@@ -1807,6 +2216,8 @@ interface PendingOrderLevel {
     stopLossPrice?: number;
     /** Data object for the SL bracket — returned in SL-related events instead of the parent's `data`. */
     stopLossData?: unknown;
+    /** The stop-loss is a trailing stop — pill reads "TSL", read-only on the chart. See `PositionLevel.stopLossTrailing`. */
+    stopLossTrailing?: boolean;
     /**
      * Take-profit price. Renders as a secondary dashed line above the order price
      * (for buy orders) or below (for sell orders). Draggable — emits `tradeLevelBracketDrag`.
@@ -1830,8 +2241,10 @@ interface PendingOrderLevel {
     timestamp?: number;
     /**
      * When true (and `ChartConfig.features.orderLineTimeDrag` is enabled), the badge can be
-     * dragged horizontally to re-anchor the order to a different candle (price stays locked).
-     * Emits `orderLineMoved` on release. Default: false.
+     * dragged horizontally to re-anchor the order to a different candle, emitting
+     * `orderLineMoved` on release. The order stays price-draggable: the badge follows the
+     * drag direction — sideways moves the time anchor (price locked), up/down moves the
+     * entry price exactly as without this flag. Default: false.
      */
     timeDraggable?: boolean;
     /** Your original order object. Returned as-is in events. The library never inspects this. */
@@ -1840,6 +2253,61 @@ interface PendingOrderLevel {
 /** Union of all level types — use this wherever a level is accepted or stored. */
 type AnyLevel = TradeLevel | PositionLevel | PendingOrderLevel;
 
+/**
+ * Instrument specs, with every gap filled in.
+ *
+ * The chart has never known what a price *means* — see `tradeMath.ts`, which
+ * takes contract specs per trade level for exactly this reason. Tools that
+ * report a distance in pips or in money need the same information at chart
+ * scope, so hosts supply an `instrument` block on `ChartConfig` and this module
+ * resolves it against sensible fallbacks.
+ */
+interface ResolvedInstrument {
+    /** Price distance counted as one pip. */
+    pipSize: number;
+    /** Units per lot (e.g. `100` for XAUUSD, `100000` for most FX pairs). */
+    contractSize: number;
+    /** Account-currency value of one price unit per contract unit. */
+    valuePerPoint: number;
+    /** Symbol prefixed to money figures. */
+    currencySymbol: string;
+    /** True when `pipSize` was guessed from price precision rather than supplied. */
+    pipSizeInferred: boolean;
+}
+/**
+ * Pip size guessed from how many decimals the feed quotes.
+ *
+ * Feeds that quote fractional pips carry one digit more than the pip itself —
+ * five decimals on EURUSD (1.08531) and three on USDJPY (151.234) both mean the
+ * pip is the second-to-last digit. Two- and four-decimal feeds quote whole pips,
+ * so the pip is the last digit.
+ *
+ * This is a convention, not a fact about the instrument: metals, indices and
+ * crypto all break it. Hosts that care should pass `pipSize` explicitly.
+ */
+declare function inferPipSize(pricePrecision: number): number;
+/** Fills in whatever the host left out. */
+declare function resolveInstrument(spec: InstrumentSpec | undefined, pricePrecision: number): ResolvedInstrument;
+/** A price distance expressed in pips. Sign follows the distance. */
+declare function toPips(priceDelta: number, pipSize: number): number;
+/**
+ * A price distance expressed in account currency for a given size, or `null`
+ * when the host hasn't supplied enough to convert. Callers fall back to showing
+ * the price rather than rendering a number that isn't money.
+ */
+declare function toMoney(priceDelta: number, lots: number, instrument: ResolvedInstrument): number | null;
+/**
+ * Compact volume for a readout — `102.27K`, `4.5M`. Full precision would push
+ * the label wider than the box it sits in.
+ */
+declare function formatVolume(volume: number): string;
+/**
+ * Calendar span between two timestamps, in the largest two units that apply —
+ * `9d 4h`, `4h 30m`, `45m`. Bar counts alone don't tell a trader how long a move
+ * actually took once weekends and session gaps are in the data.
+ */
+declare function formatDuration(ms: number): string;
+
 type PriceSource = 'open' | 'high' | 'low' | 'close';
 
 declare class SMA implements IIndicator {
@@ -1901,4 +2369,4 @@ declare class MACD implements IIndicator {
     render(ctx: CanvasRenderingContext2D, results: IndicatorResult[], scale: ScaleManager, viewport: Viewport, paneHeight: number, rangeOverride?: PriceRange): void;
 }
 
-export { type DrawingToolbarUiConfig as $, type AnyDrawingStyle as A, BollingerBands as B, type ChartConfig as C, type DrawingToolType as D, DEFAULT_CROSSHAIR_CONFIG as E, DEFAULT_DRAWING_TOOLBAR_CONFIG as F, DEFAULT_INDICATOR_OVERLAY_CONFIG as G, DEFAULT_LABELS as H, type IIndicator as I, DEFAULT_LAYOUT_SYNC as J, DEFAULT_PRICE_AXIS_CONFIG as K, type LayoutSyncState as L, DEFAULT_TIME_AXIS_CONFIG as M, DEFAULT_TOP_BAR_CONFIG as N, type OHLCVBar as O, type PriceRange as P, DEFAULT_TRADE_BUTTON_CONFIG as Q, DEFAULT_UI_CONFIG as R, type SeriesType as S, type Timeframe as T, type DataLoaderParams as U, type Viewport as V, type DeepPartial$1 as W, type DeepPartialChartTheme as X, type DialogLabels as Y, type DrawingToolbarColors as Z, type DrawingToolbarLabels as _, type IndicatorParams as a, type Duration as a0, EMA as a1, type IndicatorOverlayColors as a2, type IndicatorOverlayUiConfig as a3, type IndicatorResult as a4, type IndicatorStateEntry as a5, LAYOUT_PRESETS as a6, LIGHT_THEME as a7, type LayoutPreset as a8, MACD as a9, getAllPresets as aA, getCustomPresets as aB, getPreset as aC, registerCustomPreset as aD, resolveCssVarsInTheme as aE, resolveLabels as aF, resolveUiConfig as aG, unregisterCustomPreset as aH, type PriceSource as aI, type OhlcLabels as aa, type OrderSubmit as ab, PRESETS_BY_COUNT as ac, PRESET_COUNTS as ad, PRESET_LABEL as ae, type Padding as af, type PendingOrderLevel as ag, type PositionLevel as ah, type PositionRenderStyle as ai, type PriceAxisUiConfig as aj, RSI as ak, SMA as al, type Theme as am, type ThemeOverrides as an, type TimeAxisUiConfig as ao, type TopBarColors as ap, type TopBarLabels as aq, type TopBarUiConfig as ar, type TradeButtonUiConfig as as, type TradeDisplayFilter as at, type TradeLabels as au, type TradeLevel as av, type TradeLevelColors as aw, type TradePanelColors as ax, type UiConfig as ay, deepMergeTheme as az, type ChartEventMap as b, type ChartState as c, type IDrawing as d, type IWebSocketAdapter as e, type TradeLevelType as f, type ChartTheme as g, type AnyLevel as h, type DrawingPoint as i, ScaleManager as j, type DrawingHandle as k, type SerializedDrawing as l, type Tick as m, type StreamStatus as n, type ActiveIndicatorState as o, type BottomBarColors as p, type BottomBarLabels as q, type BottomBarUiConfig as r, type CanvasColorSettings as s, type ChartLabels as t, type ChartMiscLabels as u, type ChartThemeUi as v, type CrosshairPosition as w, type CrosshairUiConfig as x, DARK_THEME as y, DEFAULT_BOTTOM_BAR_CONFIG 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 };