acttrader-charts 1.3.0-beta.5 → 1.3.0-beta.7

package/README.md

@@ -684,6 +684,9 @@ chart.loadData(newBars);
 chart.setSeries(series: SeriesType): this
 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 +891,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`

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

@@ -1001,6 +1001,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.
@@ -1226,6 +1244,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 {
@@ -1748,6 +1775,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
@@ -1901,4 +1945,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 DrawingToolbarLabels as $, type AnyDrawingStyle as A, BollingerBands as B, type ChartConfig as C, type Duration as D, DEFAULT_BOTTOM_BAR_CONFIG as E, DEFAULT_CROSSHAIR_CONFIG as F, DEFAULT_DRAWING_TOOLBAR_CONFIG as G, DEFAULT_INDICATOR_OVERLAY_CONFIG as H, type IIndicator as I, DEFAULT_LABELS as J, DEFAULT_LAYOUT_SYNC as K, type LayoutSyncState as L, DEFAULT_PRICE_AXIS_CONFIG as M, DEFAULT_TIME_AXIS_CONFIG as N, type OHLCVBar as O, type PriceRange as P, DEFAULT_TOP_BAR_CONFIG as Q, DEFAULT_TRADE_BUTTON_CONFIG as R, type SeriesType as S, type Timeframe as T, DEFAULT_UI_CONFIG as U, type Viewport as V, type DataLoaderParams as W, type DeepPartial$1 as X, type DeepPartialChartTheme as Y, type DialogLabels as Z, type DrawingToolbarColors as _, type IndicatorParams as a, type DrawingToolbarUiConfig 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 DrawingToolType as d, type IDrawing as e, type IWebSocketAdapter as f, type TradeLevelType as g, type ChartTheme as h, type AnyLevel as i, type DrawingPoint as j, type DrawingHandle as k, ScaleManager as l, type SerializedDrawing as m, type Tick as n, type StreamStatus as o, type ActiveIndicatorState as p, type BottomBarColors as q, type BottomBarLabels as r, type BottomBarUiConfig as s, type CanvasColorSettings as t, type ChartLabels as u, type ChartMiscLabels as v, type ChartThemeUi as w, type CrosshairPosition as x, type CrosshairUiConfig as y, DARK_THEME as z };

package/dist/{MACD-D1i-sEFR.d.ts → MACD-vpoNIMIp.d.ts}

@@ -1001,6 +1001,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.
@@ -1226,6 +1244,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 {
@@ -1748,6 +1775,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
@@ -1901,4 +1945,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 DrawingToolbarLabels as $, type AnyDrawingStyle as A, BollingerBands as B, type ChartConfig as C, type Duration as D, DEFAULT_BOTTOM_BAR_CONFIG as E, DEFAULT_CROSSHAIR_CONFIG as F, DEFAULT_DRAWING_TOOLBAR_CONFIG as G, DEFAULT_INDICATOR_OVERLAY_CONFIG as H, type IIndicator as I, DEFAULT_LABELS as J, DEFAULT_LAYOUT_SYNC as K, type LayoutSyncState as L, DEFAULT_PRICE_AXIS_CONFIG as M, DEFAULT_TIME_AXIS_CONFIG as N, type OHLCVBar as O, type PriceRange as P, DEFAULT_TOP_BAR_CONFIG as Q, DEFAULT_TRADE_BUTTON_CONFIG as R, type SeriesType as S, type Timeframe as T, DEFAULT_UI_CONFIG as U, type Viewport as V, type DataLoaderParams as W, type DeepPartial$1 as X, type DeepPartialChartTheme as Y, type DialogLabels as Z, type DrawingToolbarColors as _, type IndicatorParams as a, type DrawingToolbarUiConfig 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 DrawingToolType as d, type IDrawing as e, type IWebSocketAdapter as f, type TradeLevelType as g, type ChartTheme as h, type AnyLevel as i, type DrawingPoint as j, type DrawingHandle as k, ScaleManager as l, type SerializedDrawing as m, type Tick as n, type StreamStatus as o, type ActiveIndicatorState as p, type BottomBarColors as q, type BottomBarLabels as r, type BottomBarUiConfig as s, type CanvasColorSettings as t, type ChartLabels as u, type ChartMiscLabels as v, type ChartThemeUi as w, type CrosshairPosition as x, type CrosshairUiConfig as y, DARK_THEME as z };