acttrader-charts 1.3.0-beta.1 → 1.3.0-beta.11

package/README.md

@@ -152,6 +152,9 @@ const dealingChart = new ChartEngine({
     container,
     // "Show chart by" toggle: 'ltp' | 'ask' | 'bid' (candle close/high/low source)
     tickClosePriceSource: 'ltp',
+    // Header dropdown so the user can switch the source on the chart itself
+    // (rendered next to the timeframe dropdown; omit to hide):
+    priceSourceSelector: ['ltp', 'bid'],
     // Chart line checkboxes — each price line is independent:
     showAskLine: true,   // Show AskLine
     showBidLine: true,   // Show BidLine
@@ -161,6 +164,11 @@ const dealingChart = new ChartEngine({
 dealingChart.setShowAskLine(false);   // hide the ask line
 dealingChart.setShowBidLine(true);    // show the bid line
 dealingChart.setShowLtpPrice(true);   // show the LTP line
+// Switch the candle source programmatically (e.g. from a trade-settings page);
+// the header dropdown label follows automatically:
+dealingChart.setTickClosePriceSource('bid');
+// A user pick from the dropdown emits `priceSourceChange` — persist it:
+dealingChart.on('priceSourceChange', ({ source }) => saveTradeSetting(source));
 ```
 
 ### Compare symbols
@@ -378,6 +386,9 @@ chart.on('orderLineMoved', ({ label, fromTimestamp, toTimestamp, data }) => {
 | `timeframe` | | `"1D"` | Initial timeframe |
 | `duration` | | — | Initial active duration button |
 | `symbol` | | — | Symbol name shown in the top bar |
+| `features` | | `{}` | Opt-in feature gates. See [Feature flags](#feature-flags) |
+| `instrument` | | — | Contract specs for `symbol` — pip size, contract size, money conversion. See [`InstrumentSpec`](#instrumentspec) |
+| `account` | | — | Account equity and per-trade risk used to size the position tools. See [`AccountSpec`](#accountspec) |
 | `isins` | | — | Symbol list for the picker modal |
 | `onIsinSelect` | | — | Called when user picks a symbol from the picker modal |
 | `padding` | | `{top:8,right:0,bottom:0,left:0}` | Canvas padding (px) |
@@ -403,6 +414,7 @@ chart.on('orderLineMoved', ({ label, fromTimestamp, toTimestamp, data }) => {
 | `labels` | | `DEFAULT_LABELS` | Deep-partial string overrides for i18n/translation |
 | `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)` |
+| `priceSourceSelector` | | unset | Show a price-source dropdown in the chart header listing the given sources, e.g. `["ltp", "bid"]` (dealing feeds). A user pick switches the live candle source and emits `priceSourceChange`; sync it programmatically with `chart.setTickClosePriceSource(source)`. Hidden when unset/empty. Default header layout only |
 | `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)` |
@@ -437,6 +449,111 @@ chart.on('orderLineMoved', ({ label, fromTimestamp, toTimestamp, data }) => {
 | `onLotsChange` | | — | Called when user changes qty on a draft order |
 | `onLevelDragEnd` | | — | *(deprecated — use `onLevelEdit`)* |
 
+### `InstrumentSpec`
+
+The chart reads prices, never contract specs — so a tool that reports a distance
+in **pips**, or converts one to money, has to be told how. Pass `instrument` at
+construction and swap it with `setInstrument()` whenever the symbol changes.
+
+```ts
+const chart = new ChartEngine({
+    container,
+    symbol: 'EURUSD',
+    instrument: {
+        pipSize:        0.0001,   // 0.01 for JPY crosses
+        contractSize:   100_000,  // units per lot
+        valuePerPoint:  1,        // account-currency value of one price unit per unit
+        currencySymbol: '$',
+    },
+});
+
+chart.setSymbol('USDJPY').setInstrument({ pipSize: 0.01, contractSize: 100_000 });
+```
+
+| Field | Default | Description |
+|---|---|---|
+| `pipSize` | inferred | Price distance counted as one pip |
+| `contractSize` | `1` | Units per lot (`100` for XAUUSD, `100000` for most FX pairs) |
+| `valuePerPoint` | `1` | Account-currency value of one price unit per contract unit |
+| `currencySymbol` | `'$'` | Prefixed to money figures |
+
+**Every field is optional and the whole block can be omitted** — tools fall back
+to price-only readouts, so existing integrations keep working untouched.
+
+When `pipSize` is absent it is inferred from how many decimals the feed quotes:
+five-decimal (`1.08531`) and three-decimal (`151.234`) feeds carry fractional
+pips, so the pip is the second-to-last digit; two- and four-decimal feeds quote
+whole pips. **That convention is wrong for metals, indices and crypto** — pass
+`pipSize` explicitly if pips matter.
+
+The same fallbacks are exported for hosts that want to compute alongside the
+chart:
+
+```ts
+import { resolveInstrument, inferPipSize, toPips, toMoney } from 'acttrader-charts';
+```
+
+> Per-position values still travel on the individual `TradeLevel`
+> (`contractSize` / `valuePerPoint`). `InstrumentSpec` is the chart-wide default
+> for tools that aren't attached to a position.
+
+### Feature flags
+
+Newer tools ship behind `ChartConfig.features` so each host opts in. **Every flag
+defaults to `false`** — a chart that sets none behaves exactly as it did before
+the flag existed, including its toolbar contents.
+
+```ts
+const chart = new ChartEngine({
+    container,
+    features: { enableForecasting: true },
+});
+```
+
+| Flag | Default | What it changes |
+|---|---|---|
+| `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) |
+
+`enableForecasting` turns on three things together:
+
+- **Long Position** / **Short Position** in a new **Forecasting** group in the
+  drawing toolbar. With the flag off the group is not rendered at all.
+- **Brush** and **Highlighter** draw freehand — press, drag, release. Off, they
+  keep the click-per-point gesture ended by a double-click.
+- **Ruler** reports percent, pips, calendar duration and volume. Off, it reports
+  the bar count and raw price delta as before.
+
+They share one flag because they ship and roll back together: a broker either has
+the reworked drawing tools or it doesn't.
+
+Related config, independent of the flag: the position tools show quantity and
+money only when [`account`](#accountspec) is supplied, and pips on both the
+position tools and the ruler come from [`instrument`](#instrumentspec) — without
+it, pip size is inferred from the feed's decimal count.
+
+### `AccountSpec`
+
+What the **Long / Short position** tools size themselves against.
+
+TradingView asks the user to type these because it has no broker connection. We
+do have one — so pass real equity and keep it current.
+
+```ts
+chart.setAccount({ size: 10_000, riskPercent: 1 });
+```
+
+| Field | Default | Description |
+|---|---|---|
+| `size` | — | Account equity in the account currency |
+| `riskPercent` | `1` | Percent of the account risked per trade |
+
+Omit the block and the position tools still draw — price, percent, pips and
+risk/reward all render; only the quantity and money amounts are left out.
+
+> A sketch drawn against a stale balance reports the wrong quantity rather than
+> failing visibly, so push `setAccount()` whenever equity moves.
+
 ### `OHLCVBar`
 
 | Field | Required | Type | Description |
@@ -673,7 +790,7 @@ chart.resetData(): this
 
 **Symbol switch pattern:**
 ```ts
-chart.setSymbol('GBPUSD').resetData();
+chart.setSymbol('GBPUSD').setInstrument({ pipSize: 0.0001 }).resetData();
 // … fetch new bars …
 chart.loadData(newBars);
 ```
@@ -682,8 +799,15 @@ chart.loadData(newBars);
 
 ```ts
 chart.setSeries(series: SeriesType): this
+chart.setInstrument(spec: InstrumentSpec | undefined): this     // contract specs for pips / money readouts
+chart.getInstrument(): ResolvedInstrument                       // specs with fallbacks applied
+chart.setAccount(account: AccountSpec | undefined): this        // equity + risk for the position tools
+chart.getAccount(): AccountSpec | undefined
 chart.setTheme('dark' | 'light'): this
 chart.setTimeframe(tf: Timeframe): this                         // change timeframe and reload data
+chart.setDuration(d: Duration, timeframe?: Timeframe): this     // select a duration; pairs the timeframe and reloads
+chart.getDuration(): Duration | null                            // currently selected duration
+chart.setBracketLabelMode(mode, currencySymbol?): this          // SL/TP pills: 'price' (default) or 'amount'
 chart.setThemeOverrides(overrides: ThemeOverrides): this               // update per-theme color overrides at runtime
 chart.setTimezone(tz: string): this                                // change display timezone at runtime
 chart.setVolume(show: boolean): this
@@ -888,6 +1012,37 @@ Sub-pane heights are user-resizable by dragging the separator between panes.
 | `flatChannel` | Flat Channel | 2 clicks |
 | `disjointChannel` | Disjoint Channel | 3 clicks |
 
+### SL/TP bracket labels — price or amount
+
+By default an SL/TP pill reads `SL 4159.00`. With `bracketLabelMode: 'amount'`
+it reads `SL -$290.80` — the money the position gains or loses if that bracket
+is hit, currency symbol in front.
+
+The chart has no access to contract specs or the account currency, so each level
+supplies what the maths needs:
+
+```ts
+new ChartEngine({ container, bracketLabelMode: 'amount', currencySymbol: '$' });
+
+chart.setLevels([{
+  label: 'POS-1', price: 4173.54, side: 'buy', lots: 0.20,
+  stopLossPrice: 4159.00, takeProfitPrice: 4183.00,
+  contractSize: 100,     // units per lot (100 for XAUUSD, 100000 for most FX)
+  valuePerPoint: 1,      // account-currency value of one price unit
+  currencySymbol: '$',   // optional per-level override
+}], 'label', 'price', 'position');
+// pills render: SL -$290.80   TP +$189.20
+```
+
+```
+amount = (bracket − entry) × direction × lots × contractSize × valuePerPoint
+```
+
+`valuePerPoint` is where a quote → account currency conversion goes. A level
+missing `lots` or `contractSize` keeps showing its price, so a partial rollout
+degrades level by level rather than rendering `NaN`. Toggle at runtime with
+`chart.setBracketLabelMode('amount')`.
+
 ### Fibonacci & Gann
 
 `fibRetracement` · `fibExtension` · `fibChannel` · `fibTimezone` · `fibCircles` · `fibSpiral` · `fibFan` · `fibProjection` · `gannFan` · `gannSquare` · `gannBox`
@@ -920,10 +1075,78 @@ In a **per-drawing** style (`SerializedDrawing.style.levels`), a level may also
 
 `rectangle` · `rotatedRectangle` · `ellipse` · `triangle` · `circle` · `arc` · `polyline` · `path` · `brush` · `highlighter`
 
+**`brush` and `highlighter` draw freehand** when `features.enableForecasting` is on
+(see [Feature flags](#feature-flags)): press, drag, release — the pointer
+path is sampled continuously and the finished stroke is thinned to the points
+that carry its shape. (`polyline` and `path` remain click-per-point, ended with a
+double-click.)
+
 ### Measurements & Annotations
 
 `priceRange` · `dateRange` · `datePriceRange` · `ruler` · `priceLabel` · `priceNote` · `priceProjection` · `projection` · `arrowUp` · `arrowDown` · `arrowMarker` · `text` · `callout` · `anchoredNote` · `flag` · `sineLine` · `regressionTrend` · `ghostFeed`
 
+**`ruler`**, with `features.enableForecasting` on (see [Feature flags](#feature-flags)),
+draws a direction-tinted box over the span it measures and reports:
+
+```
+0.00455 (0.80%) 45.5
+43 bars, 9d 4h
+Vol 102.27K
+```
+
+Price delta, percent, and **pips**; bar count and calendar duration; volume
+traded across the span.
+
+A pip figure is always shown — but it is only *correct* when the host supplies
+[`instrument.pipSize`](#instrumentspec). Without it the chart infers pip size
+from how many decimals the feed quotes, which follows the usual FX convention
+and is wrong for metals, indices and crypto.
+
+Duration needs bar timestamps, and the volume line is omitted entirely when the
+bars carry no volume, rather than showing a `0` that would read as "no volume
+traded".
+
+The box takes its colour from `candle.up` / `candle.down` so a measurement never
+disagrees with the candles underneath it; picking a colour in the style popover
+overrides that. All four corners resize.
+
+With the flag off it reports the bar count and raw price delta, as it always has.
+
+### Forecasting
+
+`longPosition` · `shortPosition`
+
+> Requires `features.enableForecasting` — see [Feature flags](#feature-flags).
+> With the flag off the group is not rendered, on the desktop toolbar or in the
+> mobile tools sheet.
+>
+> `ghostFeed` and `projection` stay in **Advanced Tools** and are ungated — they
+> predate this group.
+
+**`longPosition` / `shortPosition`** sketch a trade that hasn't been placed: a
+green profit zone from entry to target, a red risk zone from entry to stop, and
+live readouts.
+
+```
+Target: 0.00313 (0.549%) 31.3, Amount: 5622.13
+Open PnL: 0.00146, Qty: 11323
+Risk/reward ratio: 1.84
+Stop: 0.00170 (0.298%) 17.0, Amount: 2887.5
+```
+
+Two clicks place it — entry, then target — and the stop lands at a 2:1
+reward:risk for you to drag. All three prices have handles.
+
+Quantity is sized so that hitting the stop costs exactly `riskPercent` of the
+account, which needs [`account`](#accountspec); the money amounts and pips also
+need [`instrument`](#instrumentspec). Without them the tool still draws and still
+reports price, percent and risk/reward.
+
+> **This is a drawing, not an order.** Trade-From-Chart (`setLevels`) is what
+> puts real broker orders on the chart — see [Trade From Chart
+> (TFC)](#trade-from-chart-tfc--setlevels). Nothing on a position tool reaches
+> the broker.
+
 ### Volume Profile
 
 `volumeProfile` · `anchoredVP` · `fixedRangeVP`
@@ -932,6 +1155,10 @@ In a **per-drawing** style (`SerializedDrawing.style.levels`), a level may also
 
 `cyclicLines` · `timeCycles`
 
+> `ghostFeed` and `projection` remain here and are ungated. TradingView files
+> them under Forecasting, but moving them would have reshuffled the toolbar for
+> hosts that never enabled the new group.
+
 ### Harmonic & Elliott Patterns
 
 `abcdPattern` · `headShoulders` · `trianglePattern` · `batPattern` · `butterflyPattern` · `crabPattern` · `gartleyPattern` · `cypherPattern` · `sharkPattern` · `threeDrives` · `elliottImpulse` · `elliottCorrective` · `elliottTriangle` · `elliottCombination` · `elliottWxy`
@@ -952,6 +1179,7 @@ chart.on('pan',            ({ viewport }) => {});
 chart.on('timeframeChange',({ timeframe }) => {});
 chart.on('durationChange', ({ duration, timeframe }) => {});
 chart.on('seriesChange',   ({ series }) => {});
+chart.on('priceSourceChange', ({ source }) => {});   // header BID/ASK/LTP dropdown pick
 chart.on('streamStatus',   ({ status }) => {}); // 'connected' | 'reconnecting' | 'disconnected'
 chart.on('dataLoaded',     ({ timeframe, interval, start, end }) => {});
 chart.on('newBar',         ({ completedBar, openingBar, intervalMs }) => {});

package/dist/{MACD-D1i-sEFR.d.cts → MACD-C42nYzfa.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;
@@ -262,6 +262,7 @@ interface DrawingToolbarLabels {
         elliott: string;
         brushes: string;
         advanced: string;
+        forecasting: string;
         priceProjection: string;
     };
     /** Individual drawing tool names (used in flyout rows). */
@@ -618,6 +619,50 @@ 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;
+}
 interface ChartConfig {
     container: HTMLElement;
     theme?: Theme;
@@ -633,6 +678,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 +912,14 @@ 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'>;
     /**
      * When the combined count of open positions and pending orders exceeds this
      * number, the position render style auto-defaults to `'dot'` (compact).
@@ -1001,6 +1065,24 @@ interface ChartConfig {
      * Clamped to `[1, 3]`. Default: `1`.
      */
     tradeLevelButtonScale?: number;
+    /**
+     * 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.
@@ -1123,6 +1205,27 @@ interface ChartConfig {
          * 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;
     };
     /**
      * Fetches historical OHLC bars for a compare symbol. When provided, the
@@ -1215,7 +1318,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 +1329,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 +1378,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 +1405,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 +1567,12 @@ 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. */
+    priceSourceChange: {
+        source: 'bid' | 'ask' | 'ltp';
+    };
     streamStatus: {
         status: StreamStatus;
     };
@@ -1748,6 +1892,23 @@ interface PositionLevel {
     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
@@ -1840,6 +2001,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 +2117,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 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 };