acttrader-charts 1.2.0-beta.1 → 1.2.0-beta.2

package/README.md

@@ -84,6 +84,35 @@ chart.removeIndicator('SMA');
 
 Indicator pills appear inline above the chart (up to 2 visible; beyond that collapses into a dropdown).
 
+#### Multiple instances of the same study
+
+Parameterized studies support **multiple simultaneous instances** — e.g. EMA-20, EMA-50 and
+EMA-200, or RSI-14 alongside RSI-7. Each instance gets an auto-cycled color so they're visually
+distinct, and oscillators (RSI, MACD, …) each render in their own stacked sub-pane.
+
+```ts
+chart.addIndicatorByName('EMA');                 // EMA-20 (default)
+chart.addIndicatorByName('EMA');                 // a 2nd EMA, different color
+// or build instances directly with different params:
+chart.addIndicator(new EMA(50, '#22c55e'));
+chart.addIndicator(new EMA(200, '#ef4444'));
+```
+
+Selecting an already-active study in the Studies dropdown **adds another instance**. Remove a
+specific instance via its pill **×** or the settings dialog's Remove button.
+
+Each instance has a unique `instanceId` (e.g. `"EMA#3"`). Listen for it via the `indicatorAdded`
+event and pass it to `removeIndicator` to target one instance:
+
+```ts
+chart.on('indicatorAdded', ({ instanceId, shortName, params }) => { /* track it */ });
+chart.removeIndicator('EMA#3');   // remove that one instance
+chart.removeIndicator('EMA');     // (back-compat) remove ALL EMA instances
+```
+
+A handful of studies remain **single-instance** (re-selecting toggles them off): `VOL`, `OBV`,
+`A/D`, `AO`, `VWAP`, `Ichimoku`, `PSAR`, `Pivot`, and Heikin-Ashi.
+
 ### Drawing Tools
 
 ```ts
@@ -603,10 +632,16 @@ chart.setVolume(show: boolean): this
 ### Indicators
 
 ```ts
-chart.addIndicator(indicator: IIndicator): this
-chart.removeIndicator(name: string): this
+chart.addIndicator(indicator: IIndicator, initialParams?: IndicatorParams): this
+chart.addIndicatorByName(shortName: string, params?: IndicatorParams): void
+chart.removeIndicator(idOrShortName: string): this
 ```
 
+- `addIndicator` / `addIndicatorByName` — add a study. Multi-instance studies add a new instance
+  per call (auto-cycled color); single-instance studies toggle. `params` overrides period/color/source.
+- `removeIndicator` — pass an `instanceId` (e.g. `"EMA#3"`, from the `indicatorAdded` event) to remove
+  that one instance, or a `shortName` (e.g. `"EMA"`) to remove **all** instances of that type.
+
 ### Drawing Tools
 
 ```ts
@@ -834,6 +869,8 @@ chart.on('seriesChange',   ({ series }) => {});
 chart.on('streamStatus',   ({ status }) => {}); // 'connected' | 'reconnecting' | 'disconnected'
 chart.on('dataLoaded',     ({ timeframe, interval, start, end }) => {});
 chart.on('newBar',         ({ completedBar, openingBar, intervalMs }) => {});
+chart.on('indicatorAdded',   ({ instanceId, shortName, params }) => {}); // a study instance was added — keep instanceId to remove it later
+chart.on('indicatorRemoved', ({ instanceId, shortName }) => {});
 chart.on('stateChange',    ({ symbol, state }) => {
     // Fires after every user-driven config change (timeframe, series, theme,
     // indicators, drawings, volume). `state` is a full serializable snapshot.

package/dist/{MACD-B42iJOWq.d.cts → MACD-BBW1QO3M.d.cts}

@@ -1228,6 +1228,13 @@ interface IWebSocketAdapter {
 }
 type IndicatorParams = Record<string, number | string>;
 interface ActiveIndicatorState {
+    /**
+     * Unique per-instance identifier (e.g. "EMA#3"). Distinguishes multiple
+     * active instances of the same indicator type. All per-instance state and
+     * UI (results cache, sub-pane overlays, scale factors, pills) is keyed by
+     * this, not by `shortName` — so e.g. EMA-20, EMA-50 and EMA-200 can coexist.
+     */
+    instanceId: string;
     indicator: IIndicator;
     shortName: string;
     currentParams: IndicatorParams;
@@ -1250,6 +1257,12 @@ interface IndicatorStateEntry {
     shortName: string;
     params: IndicatorParams;
     visible?: boolean;
+    /**
+     * Per-instance id captured at serialization time. Optional for backward
+     * compatibility — configs saved before multi-instance support omit it, and
+     * `setState` mints a fresh id when it's absent.
+     */
+    instanceId?: string;
 }
 /** Color overrides for the chart canvas elements (background, grid, candles, etc.). */
 interface CanvasColorSettings {
@@ -1558,6 +1571,22 @@ type ChartEventMap = {
         symbol: string;
         message: string;
     };
+    /**
+     * Emitted after an indicator instance is added. `instanceId` uniquely
+     * identifies the instance (e.g. "EMA#3") so callers can later remove that
+     * specific instance via `removeIndicator(instanceId)` — important now that
+     * multiple instances of the same `shortName` can coexist.
+     */
+    indicatorAdded: {
+        instanceId: string;
+        shortName: string;
+        params: IndicatorParams;
+    };
+    /** Emitted after an indicator instance is removed (pill ×, settings dialog, or `removeIndicator`). */
+    indicatorRemoved: {
+        instanceId: string;
+        shortName: string;
+    };
 };
 /** Distinguishes level types: historical trade, open position, or pending order. */
 type TradeLevelType = 'trade' | 'position' | 'pending';
@@ -1749,4 +1778,4 @@ declare class MACD implements IIndicator {
     render(ctx: CanvasRenderingContext2D, results: IndicatorResult[], scale: ScaleManager, viewport: Viewport, paneHeight: number, rangeOverride?: PriceRange): void;
 }
 
-export { type Duration as $, type AnyDrawingStyle as A, BollingerBands as B, type ChartConfig as C, type DrawingToolType as D, DEFAULT_DRAWING_TOOLBAR_CONFIG as E, DEFAULT_INDICATOR_OVERLAY_CONFIG as F, DEFAULT_LABELS as G, DEFAULT_LAYOUT_SYNC as H, type IIndicator as I, DEFAULT_PRICE_AXIS_CONFIG as J, DEFAULT_TIME_AXIS_CONFIG as K, type LayoutSyncState as L, DEFAULT_TOP_BAR_CONFIG as M, DEFAULT_TRADE_BUTTON_CONFIG as N, type OHLCVBar as O, type PriceRange as P, DEFAULT_UI_CONFIG as Q, type DataLoaderParams as R, type SeriesType as S, type Timeframe as T, type DeepPartial$1 as U, type Viewport as V, type DeepPartialChartTheme as W, type DialogLabels as X, type DrawingToolbarColors as Y, type DrawingToolbarLabels as Z, type DrawingToolbarUiConfig as _, type ChartEventMap as a, EMA as a0, type IndicatorOverlayColors as a1, type IndicatorOverlayUiConfig as a2, type IndicatorParams 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 ChartState as b, type IDrawing as c, type IWebSocketAdapter as d, type TradeLevelType as e, type ChartTheme as f, type AnyLevel as g, type DrawingPoint as h, ScaleManager as i, type DrawingHandle as j, type SerializedDrawing as k, type Tick as l, type StreamStatus as m, type ActiveIndicatorState as n, type BottomBarColors as o, type BottomBarLabels as p, type BottomBarUiConfig as q, type CanvasColorSettings as r, type ChartLabels as s, type ChartMiscLabels as t, type ChartThemeUi as u, type CrosshairPosition as v, type CrosshairUiConfig as w, DARK_THEME as x, DEFAULT_BOTTOM_BAR_CONFIG as y, DEFAULT_CROSSHAIR_CONFIG as z };
+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 };

package/dist/{MACD-B42iJOWq.d.ts → MACD-BBW1QO3M.d.ts}

@@ -1228,6 +1228,13 @@ interface IWebSocketAdapter {
 }
 type IndicatorParams = Record<string, number | string>;
 interface ActiveIndicatorState {
+    /**
+     * Unique per-instance identifier (e.g. "EMA#3"). Distinguishes multiple
+     * active instances of the same indicator type. All per-instance state and
+     * UI (results cache, sub-pane overlays, scale factors, pills) is keyed by
+     * this, not by `shortName` — so e.g. EMA-20, EMA-50 and EMA-200 can coexist.
+     */
+    instanceId: string;
     indicator: IIndicator;
     shortName: string;
     currentParams: IndicatorParams;
@@ -1250,6 +1257,12 @@ interface IndicatorStateEntry {
     shortName: string;
     params: IndicatorParams;
     visible?: boolean;
+    /**
+     * Per-instance id captured at serialization time. Optional for backward
+     * compatibility — configs saved before multi-instance support omit it, and
+     * `setState` mints a fresh id when it's absent.
+     */
+    instanceId?: string;
 }
 /** Color overrides for the chart canvas elements (background, grid, candles, etc.). */
 interface CanvasColorSettings {
@@ -1558,6 +1571,22 @@ type ChartEventMap = {
         symbol: string;
         message: string;
     };
+    /**
+     * Emitted after an indicator instance is added. `instanceId` uniquely
+     * identifies the instance (e.g. "EMA#3") so callers can later remove that
+     * specific instance via `removeIndicator(instanceId)` — important now that
+     * multiple instances of the same `shortName` can coexist.
+     */
+    indicatorAdded: {
+        instanceId: string;
+        shortName: string;
+        params: IndicatorParams;
+    };
+    /** Emitted after an indicator instance is removed (pill ×, settings dialog, or `removeIndicator`). */
+    indicatorRemoved: {
+        instanceId: string;
+        shortName: string;
+    };
 };
 /** Distinguishes level types: historical trade, open position, or pending order. */
 type TradeLevelType = 'trade' | 'position' | 'pending';
@@ -1749,4 +1778,4 @@ declare class MACD implements IIndicator {
     render(ctx: CanvasRenderingContext2D, results: IndicatorResult[], scale: ScaleManager, viewport: Viewport, paneHeight: number, rangeOverride?: PriceRange): void;
 }
 
-export { type Duration as $, type AnyDrawingStyle as A, BollingerBands as B, type ChartConfig as C, type DrawingToolType as D, DEFAULT_DRAWING_TOOLBAR_CONFIG as E, DEFAULT_INDICATOR_OVERLAY_CONFIG as F, DEFAULT_LABELS as G, DEFAULT_LAYOUT_SYNC as H, type IIndicator as I, DEFAULT_PRICE_AXIS_CONFIG as J, DEFAULT_TIME_AXIS_CONFIG as K, type LayoutSyncState as L, DEFAULT_TOP_BAR_CONFIG as M, DEFAULT_TRADE_BUTTON_CONFIG as N, type OHLCVBar as O, type PriceRange as P, DEFAULT_UI_CONFIG as Q, type DataLoaderParams as R, type SeriesType as S, type Timeframe as T, type DeepPartial$1 as U, type Viewport as V, type DeepPartialChartTheme as W, type DialogLabels as X, type DrawingToolbarColors as Y, type DrawingToolbarLabels as Z, type DrawingToolbarUiConfig as _, type ChartEventMap as a, EMA as a0, type IndicatorOverlayColors as a1, type IndicatorOverlayUiConfig as a2, type IndicatorParams 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 ChartState as b, type IDrawing as c, type IWebSocketAdapter as d, type TradeLevelType as e, type ChartTheme as f, type AnyLevel as g, type DrawingPoint as h, ScaleManager as i, type DrawingHandle as j, type SerializedDrawing as k, type Tick as l, type StreamStatus as m, type ActiveIndicatorState as n, type BottomBarColors as o, type BottomBarLabels as p, type BottomBarUiConfig as q, type CanvasColorSettings as r, type ChartLabels as s, type ChartMiscLabels as t, type ChartThemeUi as u, type CrosshairPosition as v, type CrosshairUiConfig as w, DARK_THEME as x, DEFAULT_BOTTOM_BAR_CONFIG as y, DEFAULT_CROSSHAIR_CONFIG as z };
+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 };