@devexperts/dxcharts-lite 1.0.1

package/dist/chart/components/chart/chart.model.d.ts

@@ -0,0 +1,448 @@
+/*
+ * Copyright (C) 2002 - 2023 Devexperts LLC
+ * This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
+ * If a copy of the MPL was not distributed with this file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+import { Observable, Subject } from 'rxjs';
+import { PriceAxisType } from '../labels_generator/numeric-axis-labels.generator';
+import { ChartBaseElement } from '../../model/chart-base-element';
+import { CanvasBoundsContainer } from '../../canvas/canvas-bounds-container';
+import { BarType, ChartConfigComponentsOffsets, FullChartConfig } from '../../chart.config';
+import { CanvasModel } from '../../model/canvas.model';
+import EventBus from '../../events/event-bus';
+import { ChartResizeHandler } from '../../inputhandlers/chart-resize.handler';
+import { CandleSeriesColors, CandleSeriesModel, PartialCandleSeriesColors } from '../../model/candle-series.model';
+import { Candle } from '../../model/candle.model';
+import { DataSeriesType } from '../../model/data-series.config';
+import { ScaleModel } from '../../model/scale.model';
+import { Index, Pixel, Price, Timestamp, Unit } from '../../model/scaling/viewport.model';
+import VisualCandle from '../../model/visual-candle';
+import { PaneManager } from '../pane/pane-manager.component';
+import { PaneComponent } from '../pane/pane.component';
+import { LabelGroup } from '../y_axis/price_labels/y-axis-labels.model';
+import { ChartBaseModel } from './chart-base.model';
+import { CandleSeries, ChartInstrument, PartialCandle } from './chart.component';
+import { SecondaryChartColorsPool } from './secondary-chart-colors-pool';
+export type VisualCandleCalculator = (candle: Candle, options: {
+    width: Unit;
+    x: Unit;
+    prevCandle?: Candle;
+    activeCandle?: Candle;
+}) => VisualCandle;
+export type LastCandleLabelHandler = (labels: LabelGroup, candleSeries: CandleSeriesModel) => void;
+export type CandleWidthCalculator = (candle: Candle) => Unit;
+export declare class ChartModel extends ChartBaseElement {
+    chartBaseModel: ChartBaseModel<'candle'>;
+    private paneManager;
+    bus: EventBus;
+    private canvasModel;
+    config: FullChartConfig;
+    scaleModel: ScaleModel;
+    formatterFactory: (format: string) => (timestamp: number) => string;
+    mainCanvasParent: Element;
+    private canvasBoundsContainer;
+    chartResizeHandler: ChartResizeHandler;
+    private prevChartWidth;
+    private prevYWidth;
+    candleSeries: Array<CandleSeriesModel>;
+    get mainCandleSeries(): CandleSeriesModel;
+    get secondaryCandleSeries(): Array<CandleSeriesModel>;
+    readonly nextCandleTimeStampSubject: Subject<void>;
+    readonly axisTypeSetSubject: Subject<PriceAxisType>;
+    readonly chartTypeChanged: Subject<BarType>;
+    readonly mainInstrumentChangedSubject: Subject<ChartInstrument>;
+    readonly scaleInversedSubject: Subject<void>;
+    readonly offsetsChanged: Subject<void>;
+    private candlesTransformersByChartType;
+    lastCandleLabelsByChartType: Partial<Record<BarType, LastCandleLabelHandler>>;
+    private candleWidthByChartType;
+    secondaryChartColors: SecondaryChartColorsPool;
+    lastTimeFrame: TimeFrameRange;
+    basicScaleViewportTransformer: (visualCandleSource: VisualCandle[]) => void;
+    timeFrameViewportTransformer: (timeframe: [number, number], zoomIn?: boolean | null) => void;
+    private FAKE_CANDLES_DEFAULT;
+    readonly pane: PaneComponent;
+    constructor(chartBaseModel: ChartBaseModel<'candle'>, paneManager: PaneManager, bus: EventBus, canvasModel: CanvasModel, config: FullChartConfig, scaleModel: ScaleModel, formatterFactory: (format: string) => (timestamp: number) => string, mainCanvasParent: Element, canvasBoundsContainer: CanvasBoundsContainer, chartResizeHandler: ChartResizeHandler);
+    get candlesUpdatedSubject(): Subject<void>;
+    get candlesSetSubject(): Subject<void>;
+    get candlesRemovedSubject(): Subject<void>;
+    get candlesPrependSubject(): Subject<import("./chart-base.model").PrependedCandlesData>;
+    /**
+     * Method that activates the canvas bounds container and subscribes to its bounds changes and bar resizer changes.
+     * @protected
+     * @returns {void}
+     */
+    protected doActivate(): void;
+    /**
+     * This method keeps the same candle width on chart canvas resize, so chart candles aren't squeezed when canvas becomes smaller
+     * If chart width was changed after Yaxis width changed, scale will be adjusted to right/left, and visually nothing will be changed
+     * @private
+     * @param nextCB - Next chart bounds
+     */
+    private handleChartResize;
+    /**
+     * Sets the main candle series with the provided candles and instrument.
+     * @param {Array<Candle>} candles - The array of candles to set as the main candle series.
+     * @param {ChartInstrument} instrument - The instrument to set for the main candle series.
+     * @returns {void}
+     */
+    setMainCandleSeries(candles: Array<Candle>, instrument: ChartInstrument): void;
+    /**
+     * Sets a secondary candle series based on the provided candles array and instrument.
+     * @param {Array<Candle>} candles - An array of candles to set as the secondary candle series.
+     * @param {ChartInstrument} instrument - The instrument to set as the secondary candle series. Defaults to the main candle series instrument.
+     * @param {boolean} recalculateAndUpdate - A boolean indicating whether to recalculate and update the candle series. Defaults to true.
+     * @returns {CandleSeriesModel | undefined} - The newly created secondary candle series model or undefined if it could not be created.
+     */
+    setSecondaryCandleSeries(candles: Array<PartialCandle>, instrument?: ChartInstrument, recalculateAndUpdate?: boolean): CandleSeriesModel | undefined;
+    /**
+     * Shouldn't be called outside chart-core, use ChartComponent#setAllSeries instead
+     * @param mainSeries
+     * @param secondarySeries
+     */
+    setAllSeries(mainSeries: CandleSeries, secondarySeries?: CandleSeries[]): void;
+    /**
+     * This function checks if the autoScaleOnCandles state is true. If it is, it calls the doBasicScale() function and then calls the autoScale() function with a true parameter.
+     * @function
+     * @name autoScaleOnCandles
+     * @memberof ClassName
+     * @returns {void}
+     */
+    autoScaleOnCandles(): void;
+    /**
+     * Applies the basic scale viewport transformer to the visual points of the main candle series and fires a draw event.
+     */
+    doBasicScale(): void;
+    /**
+     * Changes the time frame scale to the previous one and redraws the chart.
+     * @param {boolean | null} zoomIn - If true, zooms in the chart, if false, zooms out the chart, if null, does not zoom.
+     * @returns {void}
+     */
+    doPreviousTimeFrameScale(zoomIn?: boolean | null): void;
+    /**
+     * Saves the current timeframe by getting the start and end timestamps of the visual candles in the main candle series.
+     * If there are no visual candles, the last timeframe is not updated.
+     */
+    rememberCurrentTimeframe(): void;
+    /**
+     * Shouldn't be called outside chart-core, use ChartComponent#updateAllSeries instead
+     * @param mainSeries
+     * @param secondarySeries
+     */
+    updateAllSeries(mainSeries: CandleSeries, secondarySeries?: CandleSeries[]): void;
+    /**
+     * Removes all data points from the main candle series that are newer than the given timestamp.
+     * Can be useful for data replay.
+     * @param startTimestamp
+     */
+    removeDataFrom(startTimestamp: Timestamp): void;
+    /**
+     * Creates a secondary candle series model for a given instrument.
+     * @param {ChartInstrument} instrument - The instrument for which the secondary candle series model is created.
+     * @returns {CandleSeriesModel | undefined} - The created secondary candle series model or undefined if it cannot be created.
+     */
+    createSecondaryCandleSeriesModel(instrument: ChartInstrument): CandleSeriesModel | undefined;
+    /**
+     * Creates a new CandleSeriesModel object and adds it to the chart.
+     * @param {ChartInstrument} instrument - The instrument to be displayed in the chart.
+     * @param {CandleSeriesColors} [colors] - Optional colors for the candle series.
+     * @returns {CandleSeriesModel} - The newly created CandleSeriesModel object.
+     */
+    private createCandleSeriesModel;
+    /**
+     * Removes a secondary candle series from the chart and returns its colors.
+     * @param {CandleSeriesModel} series - The candle series to be removed.
+     * @returns {CandleSeriesColors | undefined} - The colors of the removed series or undefined if the series was not found.
+     */
+    removeSecondaryCandleSeries(series: CandleSeriesModel): CandleSeriesColors | undefined;
+    /**
+     * Adjusts secondary series to present them nicely with main series:
+     * - fill gaps in secondarySeries with fake candles OHLC of same price (=close price)
+     * - do not add any candles which are not in main series
+     * @param mainSeries - main series
+     * @param secondarySeries - secondarySeries to adjust
+     */
+    private secondarySeriesAdjustments;
+    /**
+     * Updates the configuration of the secondary candle series with the provided colors and instrument symbol.
+     * @param {PartialCandleSeriesColors} config - The partial configuration object containing the colors to update.
+     * @param {string} instrumentSymbol - The symbol of the instrument to update the colors for.
+     * @param {DataSeriesType} chartType - The type of chart to update the series to.
+     * @returns {void}
+     */
+    updateSecondaryCandleSeriesConfig(config: PartialCandleSeriesColors, instrumentSymbol: string, chartType: DataSeriesType): void;
+    /**
+     * Sets the autoScale property of the scaleModel object.
+     * @param {boolean} auto - The value to be set for the autoScale property.
+     * @returns {void}
+     */
+    setAutoScale(auto: boolean): void;
+    /**
+     * Returns the effective width of the Y axis.
+     *
+     * @function
+     * @name getEffectiveYAxisWidth
+     * @returns {number} The effective width of the Y axis.
+     */
+    getEffectiveYAxisWidth(): number;
+    /**
+     * Returns the effective width of the chart.
+     *
+     * @function
+     * @returns {number} The effective width of the chart.
+     */
+    getEffectiveChartWidth(): number;
+    /**
+     * Returns the effective height of the chart.
+     *
+     * @returns {number} The effective height of the chart.
+     */
+    getEffectiveChartHeight(): number;
+    /**
+     * Updates the offsets of the chart components and redraws the chart.
+     * @param {Partial<ChartConfigComponentsOffsets>} offsets - The new offsets to be applied to the chart components.
+     * @returns {void}
+     */
+    setOffsets(offsets: Partial<ChartConfigComponentsOffsets>): void;
+    /**
+     * Returns the offsets of the chart components.
+     * @returns {ChartConfigComponentsOffsets} The offsets of the chart components.
+     */
+    getOffsets(): ChartConfigComponentsOffsets;
+    /**
+     * Converts "y" in pixels to: price / percent / other value.
+     * @param y - source value in pixels
+     */
+    fromY(y: Pixel): Unit;
+    /**
+     * Converts "y" in pixels to price
+     * @param y - source value in pixels
+     * @param candleSeriesModel - (optional) candle series
+     */
+    priceFromY(y: Pixel, candleSeriesModel?: CandleSeriesModel): Price;
+    /**
+     * Converts "x" in pixels to timestamp
+     * @param x - source value in pixels
+     */
+    fromX(x: Pixel): Timestamp;
+    toY: (value: Price) => Pixel;
+    /**
+     * Converts index to pixel.
+     * @param idx - index of candle
+     */
+    toX(idx: Index): Pixel;
+    /**
+     * Returns the baseline of the main candle series.
+     * @returns {Unit} The baseline of the main candle series.
+     */
+    getBaseLine(): Unit;
+    /**
+     * Transforms X coordinate (relative to canvas element) to Candle object.
+     * If extrapolate = false, then it takes leftmost/rightmost existing candle
+     */
+    candleFromX(x: Pixel, extrapolate?: boolean, selectedCandleSeries?: CandleSeriesModel): Candle;
+    /**
+     * Returns a candle object based on the provided unit, which is searched for in the visualPoints array of the selectedCandleSeries.
+     * If extrapolate is true and the unit is outside the visualPoints array, a fake candle is returned.
+     * If extrapolate is false and the unit is outside the visualPoints array, null is returned.
+     * If the unit is within the visualPoints array, the corresponding candle object is returned.
+     *
+     * @param {Unit} unit - The unit to search for in the visualPoints array.
+     * @param {boolean} extrapolate - Whether to extrapolate a fake candle if the unit is outside the visualPoints array.
+     * @param {CandleSeriesModel} selectedCandleSeries - The candle series to search in. Defaults to the mainCandleSeries.
+     * @returns {Candle} - The corresponding candle object, or null if extrapolate is false and the unit is outside the visualPoints array.
+     */
+    candleFromUnit(unit: Unit, extrapolate?: boolean, selectedCandleSeries?: CandleSeriesModel): Candle;
+    /**
+     * For given timestamp finds the closest candle in dataset.
+     * @param timestamp
+     */
+    candleFromTimestamp(timestamp: Timestamp, shouldExtrapolate?: boolean): VisualCandle;
+    /**
+     * For given index returns the closest visual candle, or fake candle with correct X coordinate.
+     * @param idx - index of candle
+     */
+    candleFromIdx(idx: Index): VisualCandle;
+    /**
+     * Check whether model is ready for drawing.
+     */
+    isReady(): boolean;
+    /**
+     * You can use this method to determine logic of visual candle transformation for specified chart type.
+     * @param chartType
+     * @param calculator
+     */
+    registerCandlesTransformer(chartType: BarType, calculator: VisualCandleCalculator): void;
+    /**
+     * You can use this method to determine chart width calculation for specified chart type.
+     * @param chartType
+     * @param calculator
+     */
+    registerCandlesWidthCalculator(chartType: BarType, calculator: CandleWidthCalculator): void;
+    /**
+     * You can use this method to modify labels for last candle.
+     * @param chartType
+     * @param handler
+     */
+    registerLastCandleLabelHandler(chartType: BarType, handler: LastCandleLabelHandler): void;
+    /**
+     * Checks if the main candle series has visual points.
+     * @returns {boolean} Returns true if the main candle series has visual points, otherwise false.
+     */
+    hasCandles(): boolean;
+    /**
+     * Returns a visual candle object from the main candle series based on the provided index.
+     * @param {Index} idx - The index of the visual candle to retrieve.
+     * @returns {VisualCandle|undefined} - The visual candle object or undefined if it doesn't exist.
+     */
+    getVisualCandle(idx: Index): VisualCandle | undefined;
+    /**
+     * Returns the index of the first data point in the main candle series.
+     *
+     * @returns {number} The index of the first data point in the main candle series.
+     */
+    getFirstIdx(): number;
+    /**
+     * Returns the last index of the data in the mainCandleSeries.
+     *
+     * @returns {number} - The last index of the data in the mainCandleSeries.
+     */
+    getLastIdx(): number;
+    /**
+     * Returns the timestamp of the first candle in the viewport dataset
+     * @param dataBased - if false will return timestamp which matches first viewport point even if candle is not available
+     * @returns {Timestamp} The timestamp of the first candle
+     */
+    getFirstTimestamp(dataBased?: boolean): Timestamp;
+    /**
+     * Returns the timestamp of the last candle in the viewport candle array
+     * @param dataBased - if false will return timestamp which matches first viewport point even if candle is not available
+     * @returns {Timestamp} The timestamp of the last candle
+     */
+    getLastTimestamp(dataBased?: boolean): Timestamp;
+    /**
+     * Sets the timestamp range of the chart by setting the x-axis scale.
+     * @param {Timestamp} start - The start timestamp of the range.
+     * @param {Timestamp} end - The end timestamp of the range.
+     * @returns {void}
+     */
+    setTimestampRange(start: Timestamp, end: Timestamp): void;
+    /**
+     * Returns the last candle of the main candle series.
+     * @returns {Candle | undefined} The last candle of the main candle series or undefined if the series is empty.
+     */
+    getLastCandle(): Candle | undefined;
+    /**
+     * Returns the last visual candle of the main candle series.
+     * @returns {VisualCandle | undefined} The last visual candle of the main candle series or undefined if the series is empty.
+      
+    */
+    getLastVisualCandle(): VisualCandle | undefined;
+    /**
+     * Calculates the maximum number of candles that can fit in the chart width based on the minimum candle width
+     * @returns {number} - The maximum number of candles that can fit in the chart width
+     */
+    getMaxCandlesFitLength(): number;
+    /**
+     * Returns an array of CandleSeriesModel objects representing the secondary candle series.
+     * @returns {Array<CandleSeriesModel>} An array of CandleSeriesModel objects representing the secondary candle series.
+     */
+    getSecondarySeries(): Array<CandleSeriesModel>;
+    /**
+     * Checks if a given symbol matches the symbol of a given CandleSeriesModel's instrument.
+     * @param {CandleSeriesModel} series - The CandleSeriesModel to check.
+     * @param {ChartInstrument['symbol']} symbol - The symbol to compare with the instrument's symbol.
+     * @returns {boolean} - Returns true if the symbol matches the instrument's symbol, false otherwise.
+     */
+    private isSeriesInstrument;
+    /**
+     * Returns an array of CandleSeriesModel objects that match the provided symbol.
+     *
+     * @param {string} symbol - The symbol to search for.
+     * @returns {CandleSeriesModel[]} - An array of CandleSeriesModel objects that match the provided symbol.
+     */
+    findSeriesBySymbol(symbol: ChartInstrument['symbol']): CandleSeriesModel[];
+    /**
+     * Finds a secondary candle series by symbol
+     *
+     * @param {string} symbol - The symbol of the chart instrument
+     * @returns {CandleSeriesModel | undefined} - The secondary candle series or undefined if not found
+     */
+    findSecondarySeriesBySymbol(symbol: ChartInstrument['symbol']): CandleSeriesModel | undefined;
+    /**
+     * Reindexes candles based on a given series.
+     * @private
+     * @param {Array<Candle>} baseSeries - The base series to search for candles.
+     * @param {Array<Candle>} series - The series to reindex.
+     * @returns {Array<Candle>} - The reindexed series.
+     */
+    private reindexCandlesBasedOnSeries;
+    getPeriod(): number;
+    /**
+     * Checks if a given candle is within the viewport.
+     * @param {number} idx - The index of the candle to check.
+     * @returns {boolean} - True if the candle is within the viewport, false otherwise.
+     */
+    isCandleInViewport(idx: number): boolean;
+    /**
+     * Updates candles in series. Default is main series.
+     * Any number of candles may be provided - they would be matched by their index and updated.
+     * @param candles - any list of new (updated) candles
+     * @param instrument - name of instrument to update
+     */
+    updateCandles(candles: Array<Candle>, instrumentSymbol?: string): void;
+    /**
+     * Triggers when candles set or updated
+     */
+    observeCandlesChanged(): Observable<void>;
+    /**
+     * Returns an array of Candle objects representing the data points of the main candle series.
+     * @returns {Array<Candle>} An array of Candle objects.
+     */
+    getCandles(): Array<Candle>;
+    /***
+     * Returns candles array which consists of real candles and fake candles if from and to can't be satisfied with real ones.
+     * @param from - if not specified set to first candle timestamp
+     * @param to - if not specified set to last candle timestamp + right offset
+     */
+    getCandlesWithFake(from?: number, to?: number): Candle[];
+    /**
+     * Returns the number of candles in the main candle series.
+     *
+     * @returns {number} The number of candles in the main candle series.
+     */
+    getCandlesCount(): number;
+    /**
+     * Returns the number of candles with the right offset.
+     * @returns {number} - The number of candles with the right offset.
+     */
+    getCandlesCountWithRightOffset(): number;
+    /**
+     * Clears the data of all candle series in the chart.
+     */
+    clearData(): void;
+    /**
+     * Adds new candles array to the existing one at the start, mostly used in lazy loading
+     * @param target - initial candles array
+     * @param prependUpdate - additional candles array, which will be added to the target array
+     */
+    prependCandles(target: Candle[], prependUpdate: Candle[]): UpdateCandlesResult;
+    /**
+     * Adds new candle to the chart
+     * @param candle - new candle
+     * @param instrument - name of the instrument to update
+     */
+    addLastCandle(candle: Candle, instrumentSymbol?: string): void;
+    /**
+     * Updates last candle value
+     * @param candle - updated candle
+     * @param instrument - name of the instrument to update
+     */
+    updateLastCandle(candle: Candle, instrumentSymbol?: string): void;
+}
+export interface UpdateCandlesResult {
+    prepended: number;
+    appended?: number;
+    candles: Candle[];
+}
+export type TimeFrameRange = [number, number];

package/dist/chart/components/chart/chart.model.js

@@ -0,0 +1,6 @@
+/*
+ * Copyright (C) 2002 - 2023 Devexperts LLC
+ * This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
+ * If a copy of the MPL was not distributed with this file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+import{Subject as p,merge as U}from"rxjs";import{distinctUntilChanged as A}from"rxjs/operators";import{ChartBaseElement as D}from"../../model/chart-base-element";import{CHART_UUID as C,CanvasElement as f,areBoundsChanged as W}from"../../canvas/canvas-bounds-container";import{getDefaultConfig as j}from"../../chart.config";import{MIN_SUPPORTED_CANVAS_SIZE as M}from"../../model/canvas.model";import{CandleSeriesModel as _}from"../../model/candle-series.model";import{copyCandle as O}from"../../model/candle.model";import{MainCandleSeriesModel as V}from"../../model/main-candle-series.model";import{candleEdgesConstrait as L}from"../../model/scaling/constrait.functions";import{pixelsToUnits as b}from"../../model/scaling/viewport.model";import{merge as X}from"../../utils/merge.utils";import{createBasicScaleViewportTransformer as Y,createTimeFrameViewportTransformer as R}from"./basic-scale";import{calculateCandleWidth as N}from"./candle-width-calculator.functions";import{deleteCandlesIndex as H,prepareCandle as S,reindexCandles as P}from"./candle.functions";import{ChartInstrument as k}from"./chart.component";import{fakeCandle as g}from"./fake-candles";import{SecondaryChartColorsPool as z}from"./secondary-chart-colors-pool";import{binarySearch as T,lastOf as w}from"../../utils/array.utils";import{searchCandleIndex as v}from"../../utils/candles.utils";import{floor as Z,round as K}from"../../utils/math.utils";export class ChartModel extends D{get mainCandleSeries(){return this.candleSeries[0]}get secondaryCandleSeries(){return this.candleSeries.filter(e=>e!==this.mainCandleSeries)}constructor(e,t,s,i,a,n,d,l,r,o){super(),this.chartBaseModel=e,this.paneManager=t,this.bus=s,this.canvasModel=i,this.config=a,this.scaleModel=n,this.formatterFactory=d,this.mainCanvasParent=l,this.canvasBoundsContainer=r,this.chartResizeHandler=o,this.prevChartWidth=0,this.prevYWidth=0,this.candleSeries=[],this.nextCandleTimeStampSubject=new p,this.axisTypeSetSubject=new p,this.chartTypeChanged=new p,this.mainInstrumentChangedSubject=new p,this.scaleInversedSubject=new p,this.offsetsChanged=new p,this.candlesTransformersByChartType={},this.lastCandleLabelsByChartType={},this.candleWidthByChartType={},this.lastTimeFrame=[0,0],this.FAKE_CANDLES_DEFAULT=100,this.toY=u=>this.mainCandleSeries.view.toY(u),this.chartTypeChanged.next(this.config.components.chart.type),this.secondaryChartColors=new z(this.config);const c=new V(this.chartBaseModel,this.paneManager.paneComponents[C].mainYExtentComponent,this.paneManager.hitTestController.getNewDataSeriesHitTestId(),this.bus,this.scaleModel,new k,this.candlesTransformersByChartType,this.candleWidthByChartType,Object.assign({},this.config.colors));c.config.type=this.config.components.chart.type,this.candleSeries.push(c),n.addXConstraint((u,m)=>L(m,this.mainCandleSeries.visualPoints,this.config.components.chart.minCandlesOffset,n.getBounds())),this.basicScaleViewportTransformer=Y(n),this.timeFrameViewportTransformer=R(n,this),this.pane=this.paneManager.paneComponents[C]}get candlesUpdatedSubject(){return this.chartBaseModel.dataUpdatedSubject}get candlesSetSubject(){return this.chartBaseModel.dataSetSubject}get candlesRemovedSubject(){return this.chartBaseModel.dataRemovedSubject}get candlesPrependSubject(){return this.chartBaseModel.dataPrependSubject}doActivate(){super.doActivate(),this.addRxSubscription(this.canvasBoundsContainer.observeBoundsChanged(f.PANE_UUID(C)).pipe(A(W)).subscribe(e=>{this.handleChartResize(e)}))}handleChartResize(e){if(e.width>M.width&&e.height>M.height){const t=this.getEffectiveChartWidth(),s=this.getEffectiveYAxisWidth();if(this.prevChartWidth===0){this.scaleModel.isViewportValid()?this.scaleModel.recalculateZoom():this.doBasicScale(),this.prevChartWidth=t,this.prevYWidth=s;return}if(s!==this.prevYWidth){if(this.config.scale.keepZoomXOnYAxisChange){const a=b(s-this.prevYWidth,this.scaleModel.zoomX);this.scaleModel.setXScale(this.scaleModel.xStart,this.scaleModel.xEnd-a)}else this.scaleModel.recalculateZoomX();this.prevYWidth=s,this.prevChartWidth=t;return}const i=b(t-this.prevChartWidth,this.scaleModel.zoomX);this.scaleModel.setXScale(this.scaleModel.xStart-i,this.scaleModel.xEnd),this.scaleModel.recalculateZoomY(),this.prevYWidth=s,this.prevChartWidth=t}}setMainCandleSeries(e,t){this.mainCandleSeries.instrument=t,this.setAllSeries({candles:e,instrument:t},this.getSecondarySeries().map(s=>{const i=s.dataPoints;return H(i),{candles:i,instrument:s.instrument}}))}setSecondaryCandleSeries(e,t=this.mainCandleSeries.instrument,s=!0){const i=y(e.map(S)),a=this.reindexCandlesBasedOnSeries(this.mainCandleSeries.dataPoints,i),n=this.secondarySeriesAdjustments(this.mainCandleSeries.dataPoints,a),l=this.secondaryCandleSeries.some(r=>r.instrument.symbol===t.symbol)?this.secondaryCandleSeries.find(r=>r.instrument.symbol===t.symbol):this.createSecondaryCandleSeriesModel(t);if(l)return l.dataPoints=n,s&&(this.scaleModel.doAutoScale(),l.recalculateVisualPoints(),this.candlesSetSubject.next(),this.bus.fireDraw([this.canvasModel.canvasId])),l}setAllSeries(e,t=[]){var s;this.mainCandleSeries.instrument=(s=e.instrument)!==null&&s!==void 0?s:this.mainCandleSeries.instrument,e.instrument&&this.mainInstrumentChangedSubject.next(e.instrument),this.rememberCurrentTimeframe();const i=y(e.candles.map(S));this.mainCandleSeries.clearData(),P(i),this.mainCandleSeries.dataPoints=i,this.secondaryCandleSeries.filter(a=>t.filter(n=>{var d;return((d=n.instrument)===null||d===void 0?void 0:d.symbol)===a.instrument.symbol}).length===0).forEach(a=>this.removeSecondaryCandleSeries(a)),t.map(a=>this.setSecondaryCandleSeries(a.candles,a.instrument,!1)),this.candleSeries.forEach(a=>{a.recalculateDataViewportIndexes(),a.recalculateVisualPoints()}),this.chartBaseModel.recalculatePeriod(),this.autoScaleOnCandles(),this.scaleModel.doAutoScale(),this.candlesSetSubject.next(),this.bus.fireDraw([this.canvasModel.canvasId])}autoScaleOnCandles(){this.scaleModel.state.autoScaleOnCandles&&(this.doBasicScale(),this.scaleModel.autoScale(!0))}doBasicScale(){this.basicScaleViewportTransformer(this.mainCandleSeries.visualPoints),this.bus.fireDraw()}doPreviousTimeFrameScale(e=null){this.timeFrameViewportTransformer(this.lastTimeFrame,e),this.scaleModel.state.autoScaleOnCandles&&this.scaleModel.doAutoScale(!0),this.bus.fireDraw()}rememberCurrentTimeframe(){this.mainCandleSeries.visualPoints.length!==0&&(this.lastTimeFrame=[this.candleFromX(this.scaleModel.toX(this.scaleModel.xStart),!0).timestamp,this.candleFromX(this.scaleModel.toX(this.scaleModel.xEnd),!0).timestamp])}updateAllSeries(e,t=[]){e=Object.assign({},e),e.instrument||(e.instrument=this.mainCandleSeries.instrument);const s=[e,...t];if(!this.candleSeries.every(l=>s.find(r=>{var o;return((o=r.instrument)===null||o===void 0?void 0:o.symbol)===l.instrument.symbol}))||t.length!==this.secondaryCandleSeries.length){console.error("All series update failed. Instruments for series are different.");return}const i=y(e.candles.map(S)),a=I(this.mainCandleSeries.dataPoints,i),n=a.candles;P(n),this.mainCandleSeries.dataPoints=n,t.map(l=>{var r,o,c,u;const m=y(l.candles.map(S)),x=I((u=(c=this.findSecondarySeriesBySymbol((o=(r=l.instrument)===null||r===void 0?void 0:r.symbol)!==null&&o!==void 0?o:""))===null||c===void 0?void 0:c.dataPoints)!==null&&u!==void 0?u:[],m).candles;return this.setSecondaryCandleSeries(x,l.instrument,!1)}),this.candleSeries.forEach(l=>{l.recalculateVisualPoints(),l.recalculateDataViewportIndexes()});const d=this.chartBaseModel.mainVisualPoints.slice(0,a.prepended).reduce((l,r)=>l+r.width,0);this.scaleModel.moveXStart(this.scaleModel.xStart+d),this.candlesPrependSubject.next({prependedCandlesWidth:d,preparedCandles:i}),this.chartBaseModel.recalculatePeriod(),this.candlesUpdatedSubject.next(),this.bus.fireDraw()}removeDataFrom(e){Object.values(this.paneManager.paneComponents).forEach(t=>{t.dataSeries.forEach(s=>{const i=T(s.dataPoints,e,n=>n.timestamp),a=i.exact?i.index:i.index+1;s.dataPoints=s.dataPoints.slice(0,a)})}),this.candlesRemovedSubject.next(),this.candlesUpdatedSubject.next(),this.canvasModel.fireDraw()}createSecondaryCandleSeriesModel(e){const t=Object.assign(Object.assign({},this.config.colors),this.secondaryChartColors.takeColorFromPool(e.symbol));return this.createCandleSeriesModel(e,t)}createCandleSeriesModel(e,t){const s=new _(this.paneManager.paneComponents[C].mainYExtentComponent,this.paneManager.hitTestController.getNewDataSeriesHitTestId(),this.bus,this.scaleModel,e,this.candlesTransformersByChartType,this.candleWidthByChartType,t);return s.config.type="line",this.candleSeries.push(s),s}removeSecondaryCandleSeries(e){return this.secondaryChartColors.addColorToPool(e.instrument.symbol),this.candleSeries=this.candleSeries.filter(t=>t!==e),e.deactivate(),this.paneManager.paneComponents[C].removeDataSeries(e),this.scaleModel.doAutoScale(),e.colors}secondarySeriesAdjustments(e,t){const s=[];return e.forEach(i=>{var a;const n=(a=i.idx)!==null&&a!==void 0?a:0,d=t[n];if(d)s.push(d);else{let l=B(t,n,-1);if(l||(l=B(t,n,1)),l){const r=O(l,n,!0);s.push(r)}}}),s}updateSecondaryCandleSeriesConfig(e,t,s){const i=X(e,j().colors);this.secondaryChartColors.updateColorConfig(t,i);const a=this.findSecondarySeriesBySymbol(t);a&&(a.config.type=s,a.updateCandleSeriesColors(i),this.bus.fireDraw([this.canvasModel.canvasId])),this.bus.fireDraw([this.canvasModel.canvasId])}setAutoScale(e){this.scaleModel.autoScale(e)}getEffectiveYAxisWidth(){return this.canvasBoundsContainer.getBounds(f.PANE_UUID_Y_AXIS(C)).width}getEffectiveChartWidth(){return this.canvasBoundsContainer.getBounds(f.PANE_UUID(C)).width}getEffectiveChartHeight(){return this.canvasBoundsContainer.getBounds(f.PANE_UUID(C)).height}setOffsets(e){this.scaleModel.updateOffsets(e);const t=this.getCandlesCountWithRightOffset(),s=this.mainCandleSeries.visualPoints;this.hasCandles()&&t>=s.length&&this.scaleModel.setXScale(this.scaleModel.xStart,this.candleFromIdx(t).startUnit),this.offsetsChanged.next(),this.bus.fireDraw()}getOffsets(){return this.scaleModel.getOffsets()}fromY(e){return this.scaleModel.fromY(e)}priceFromY(e,t){return(t!=null?t:this.mainCandleSeries).view.priceFromY(e)}fromX(e){return this.scaleModel.fromX(e)}toX(e){const t=this.candleFromIdx(e);return this.scaleModel.toX(t.centerUnit)}getBaseLine(){return this.mainCandleSeries.getBaseLine()}candleFromX(e,t=!1,s=this.mainCandleSeries){const i=this.scaleModel.fromX(e);return this.candleFromUnit(i,t,s)}candleFromUnit(e,t=!1,s=this.mainCandleSeries){var i,a;const n=T(s.visualPoints,e,c=>c.startUnit),d=s.visualPoints,l=this.getLastVisualCandle();d[n.index]!==void 0&&(e<0||l&&e>l.startUnit+l.width)&&(n.index+=K((e-d[n.index].centerUnit)/this.mainCandleSeries.meanCandleWidth));const r=n.index,o=Math.max(Math.min(d.length-1,r),0);return(r<0||r>=d.length)&&t?g(this.mainCandleSeries.dataPoints,r,this.chartBaseModel.period):(a=(i=d[o])===null||i===void 0?void 0:i.candle)!==null&&a!==void 0?a:g(this.mainCandleSeries.dataPoints,o,this.chartBaseModel.period)}candleFromTimestamp(e,t=!0){return this.chartBaseModel.dataFromTimestamp(e,t)}candleFromIdx(e){return this.chartBaseModel.dataFromIdx(e)}isReady(){return this.canvasModel.isReady()&&this.hasCandles()}registerCandlesTransformer(e,t){this.candlesTransformersByChartType[e]=t}registerCandlesWidthCalculator(e,t){this.candleWidthByChartType[e]=t}registerLastCandleLabelHandler(e,t){this.lastCandleLabelsByChartType[e]=t}hasCandles(){return this.mainCandleSeries.visualPoints.length!==0}getVisualCandle(e){var t,s,i;const a=e-((i=(s=(t=this.mainCandleSeries.visualPoints[0])===null||t===void 0?void 0:t.candle)===null||s===void 0?void 0:s.idx)!==null&&i!==void 0?i:0);return this.mainCandleSeries.visualPoints[a]}getFirstIdx(){return this.mainCandleSeries.dataIdxStart}getLastIdx(){return this.mainCandleSeries.dataIdxEnd}getFirstTimestamp(e=!0){return e?this.candleFromIdx(this.getFirstIdx()).candle.timestamp:this.candleFromUnit(this.scaleModel.xStart,!0).timestamp}getLastTimestamp(e=!0){return e?this.candleFromIdx(this.getLastIdx()).candle.timestamp:this.candleFromUnit(this.scaleModel.xEnd,!0).timestamp}setTimestampRange(e,t){const s=this.candleFromTimestamp(e).startUnit,i=this.candleFromTimestamp(t),a=i.startUnit+i.width;return this.scaleModel.setXScale(s,a)}getLastCandle(){const e=this.mainCandleSeries.dataPoints;return w(e)}getLastVisualCandle(){const e=this.mainCandleSeries.visualPoints;return w(e)}getMaxCandlesFitLength(){return Z(this.getEffectiveChartWidth()/this.config.components.chart.minWidth)}getSecondarySeries(){return this.secondaryCandleSeries}isSeriesInstrument(e,t){return e.instrument.symbol===t}findSeriesBySymbol(e){return this.candleSeries.filter(t=>this.isSeriesInstrument(t,e))}findSecondarySeriesBySymbol(e){return this.secondaryCandleSeries.find(t=>this.isSeriesInstrument(t,e))}reindexCandlesBasedOnSeries(e,t){return t.reduce((s,i)=>{const a=i.timestamp,n=v(a,!1,e,this.chartBaseModel.period);return n.index>=0&&n.index<e.length&&(i.idx=n.index,s[n.index]=i),s},[])}getPeriod(){return this.chartBaseModel.period}isCandleInViewport(e){return this.getFirstIdx()<=e&&e<=this.getLastIdx()}updateCandles(e,t=this.mainCandleSeries.instrument.symbol){const s=this.mainCandleSeries.instrument.symbol===t,i=this.findSeriesBySymbol(t);if(i.length===0){console.warn("updateCandles failed. Can't find series",t);return}i.forEach(a=>{const n=a.dataPoints;let d=!1,l=!1,r;e.forEach(o=>{var c;if(!o)return;const u=v(o.timestamp,!0,n,this.getPeriod()),m=Math.min(u.index,n.length);d=d||m===n.length,n[m]=o,o.idx=m,a.dataPoints=n,a.recalculateDataViewportIndexes(),l=l||this.isCandleInViewport(m);const x=m>=n.length-1,E=r&&o.timestamp<r.timestamp;if(x&&!E&&(r=o),d&&r&&s&&l){const F=(c=this.candleWidthByChartType[this.config.components.chart.type])!==null&&c!==void 0?c:N;this.scaleModel.moveXStart(this.scaleModel.xStart+F(r))}}),r&&a.updateCurrentPrice(r.close),l&&r&&e.length===1?this.bus.fireDraw([this.canvasModel.canvasId]):a.recalculateVisualPoints()}),this.scaleModel.doAutoScale(),this.candlesUpdatedSubject.next()}observeCandlesChanged(){return U(this.candlesSetSubject,this.candlesUpdatedSubject)}getCandles(){return this.mainCandleSeries.dataPoints}getCandlesWithFake(e=0,t){let s=this.getCandles().slice();const i=this.getCandlesCount(),a=t!=null?t:i+this.FAKE_CANDLES_DEFAULT;s=s.slice(Math.max(0,e),Math.min(i,a));const n=[],d=[];for(let r=i;r<a;r++)n.push(g(this.mainCandleSeries.dataPoints,r,this.getPeriod()));const l=Math.min(0,a);for(let r=e;r<l;r++)d.push(g(this.mainCandleSeries.dataPoints,r,this.getPeriod()));return[...d,...s,...n]}getCandlesCount(){return this.mainCandleSeries.dataPoints.length}getCandlesCountWithRightOffset(){return this.getCandlesCount()+this.getOffsets().right}clearData(){this.candleSeries.forEach(e=>e.clearData())}prependCandles(e,t){const s=e.slice(),i=[];return t.forEach(a=>{const d=v(a.timestamp,!1,e).index;d<0?i.push(a):e[d].timestamp===a.timestamp?s[d]=a:console.warn(`Couldn't update candle with timestamp ${a.timestamp}`)}),{prepended:i.length,candles:[...i,...s]}}addLastCandle(e,t=this.mainCandleSeries.instrument.symbol){this.updateCandles([e],t)}updateLastCandle(e,t=this.mainCandleSeries.instrument.symbol){this.updateCandles([e],t)}}const y=h=>h.slice().sort((e,t)=>e.timestamp===t.timestamp?0:e.timestamp>t.timestamp?1:-1),B=(h,e,t)=>{if(e>=h.length)return h[h.length-1];for(let s=e;s<h.length&&s>=0;s+=t){const i=h[s];if(i)return i}},I=(h,e)=>{const t=h.slice(),s=[],i=[];return e.forEach(a=>{const d=v(a.timestamp,!0,h).index;d<0?s.push(a):d>=h.length?i.push(a):h[d].timestamp===a.timestamp?t[d]=a:console.warn(`Couldn't update candle with timestamp ${a.timestamp}`)}),{prepended:s.length,appended:i.length,candles:[...s,...t,...i]}};

package/dist/chart/components/chart/data-series.high-low-provider.d.ts

@@ -0,0 +1,25 @@
+/*
+ * Copyright (C) 2002 - 2023 Devexperts LLC
+ * This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
+ * If a copy of the MPL was not distributed with this file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+import { ChartConfigComponentsOffsets } from '../../chart.config';
+import { HighLow, HighLowProvider } from '../../model/scaling/auto-scale.model';
+/**
+ * Constraint on top of high low provider - makes additional offset bounds.
+ * @doc-tags viewport,scaling
+ * @param offsetsProvider
+ * @doc-tags viewport,scaling,offsets
+ */
+export declare const createHighLowOffsetCalculator: (offsetsProvider: () => ChartConfigComponentsOffsets) => (highLow: HighLow) => {
+    low: number;
+    high: number;
+};
+/**
+ * Constraint on top of high low provider - makes additional offset bounds.
+ * @doc-tags viewport,scaling
+ * @param offsetsProvider
+ * @param highLowProvider
+ * @doc-tags viewport,scaling,offsets
+ */
+export declare const createCandlesOffsetProvider: (offsetsProvider: () => ChartConfigComponentsOffsets, highLowProvider: HighLowProvider) => HighLowProvider;

package/dist/chart/components/chart/data-series.high-low-provider.js

@@ -0,0 +1,6 @@
+/*
+ * Copyright (C) 2002 - 2023 Devexperts LLC
+ * This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
+ * If a copy of the MPL was not distributed with this file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+export const createHighLowOffsetCalculator=e=>t=>{const{top:c,bottom:s}=e(),o=t.high-t.low,n=o===0?1:o,r=n*c/100,l=n*s/100,a=t.low-l,f=t.high+r;return{low:a,high:f}},createCandlesOffsetProvider=(e,t)=>{const c=createHighLowOffsetCalculator(e);return{isHighLowActive:()=>!0,calculateHighLow:s=>{const o=t.calculateHighLow(s);return c(o)}}};

package/dist/chart/components/chart/fake-candles.d.ts

@@ -0,0 +1,18 @@
+/*
+ * Copyright (C) 2002 - 2023 Devexperts LLC
+ * This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
+ * If a copy of the MPL was not distributed with this file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+import { Candle } from '../../model/candle.model';
+import { DataSeriesPoint, VisualSeriesPoint } from '../../model/data-series.model';
+import { Index } from '../../model/scaling/viewport.model';
+import VisualCandle from '../../model/visual-candle';
+/**
+ * Generates fake candle for left and right "out of data range" zones.
+ * Requires period to calculate the fake timestamp.
+ * The timestamp won't take session breaks or holidays into account.
+ */
+export declare const fakeVisualCandle: (dataPoints: Candle[], visualCandles: VisualCandle[], candleWidth: number, index: Index, period?: number) => VisualCandle;
+export declare const fakeVisualPoint: (dataPoints: DataSeriesPoint[], visualPoints: VisualSeriesPoint[], meanDataWidth: number, index: Index, period?: number) => VisualSeriesPoint;
+export declare const fakeCandle: (candles: Candle[], index: Index, period?: number) => Candle;
+export declare const fakeDataPoint: (candles: DataSeriesPoint[], index: Index, period?: number) => DataSeriesPoint;

package/dist/chart/components/chart/fake-candles.js

@@ -0,0 +1,6 @@
+/*
+ * Copyright (C) 2002 - 2023 Devexperts LLC
+ * This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
+ * If a copy of the MPL was not distributed with this file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+import{nameDirection as u}from"../../model/candle.model";import{VisualSeriesPoint as g}from"../../model/data-series.model";import C from"../../model/visual-candle";import{firstOf as N,lastOf as w}from"../../utils/array.utils";import{round as h}from"../../utils/math.utils";const m=60;export const fakeVisualCandle=(n,t,o,e,l=m)=>{const r=fakeCandle(n,e,l);r.volume=o;let s;if(t.length===0)s=0;else if(e>=t.length){const c=t[t.length-1],f=(e-(t.length-1))*o;s=c.centerUnit+f}else{const c=t[0],f=-e*o;s=c.centerUnit-f}return new C(s,o,r.open,r.close,r.lo,r.hi,u(r.open,r.close),r)},fakeVisualPoint=(n,t,o,e,l=m)=>{const r=fakeDataPoint(n,e,l);let s;if(t.length===0)s=0;else if(e>=t.length){const c=t[t.length-1],f=(e-(t.length-1))*o;s=c.centerUnit+f}else{const c=t[0],f=-e*o;s=c.centerUnit-f}return new g(s,r.close)},fakeCandle=(n,t,o=m)=>({hi:NaN,lo:NaN,open:NaN,close:NaN,timestamp:i(n,t,o),volume:NaN,expansion:!0,idx:t}),fakeDataPoint=(n,t,o=m)=>({close:NaN,timestamp:i(n,t,o)});function i(n,t,o=m){var e,l;const r=h(t);if(n.length===0)return 0;const s=w(n);if(r>=n.length&&s)return p(s,n.length-1,r,o);const c=N(n);return r<0&&c?p(c,0,r,o):(l=(e=n[r])===null||e===void 0?void 0:e.timestamp)!==null&&l!==void 0?l:0}const p=(n,t,o,e=m)=>n.timestamp+(o-(t!=null?t:0))*e;

package/dist/chart/components/chart/price.formatter.d.ts

@@ -0,0 +1,12 @@
+/*
+ * Copyright (C) 2002 - 2023 Devexperts LLC
+ * This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
+ * If a copy of the MPL was not distributed with this file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+import { DataSeriesModel } from '../../model/data-series.model';
+import { Unit } from '../../model/scaling/viewport.model';
+import { YExtentComponent } from '../pane/extent/y-extent-component';
+import { YExtentFormatters } from '../pane/pane.component';
+export declare const createRegularPriceFormatter: (extent: YExtentComponent) => (value: unknown) => string;
+export declare const createPercentFormatter: (extent: YExtentComponent) => (value: Unit, dataSeries?: DataSeriesModel) => string;
+export declare const createYExtentFormatters: (extent: YExtentComponent) => YExtentFormatters;

package/dist/chart/components/chart/price.formatter.js

@@ -0,0 +1,6 @@
+/*
+ * Copyright (C) 2002 - 2023 Devexperts LLC
+ * This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
+ * If a copy of the MPL was not distributed with this file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+import{unitToPercent as a}from"../../model/scaling/viewport.model";import{PriceIncrementsUtils as s}from"../../utils/price-increments.utils";export const createRegularPriceFormatter=t=>r=>{let e;if(typeof r=="number")e=r;else if(typeof r=="string")e=Number(r);else return"\u2014";const[n]=t.dataSeries;if(n!==void 0){const i=s.getPricePrecision(e,n.pricePrecisions);return e.toFixed(i)}return`${e}`},createPercentFormatter=t=>(r,e)=>{const[n]=t.dataSeries;let i=r;const o=e!=null?e:n;o!==void 0&&(i=a(r,o.getBaseLine()));const c=i.toFixed(s.DEFAULT_PRECISION).replace("-","\u2212")+" %";return c==="\u22120.00 %"?"0.00 %":c},createYExtentFormatters=t=>({percent:createPercentFormatter(t),regular:createRegularPriceFormatter(t)});

package/dist/chart/components/chart/secondary-chart-colors-pool.d.ts

@@ -0,0 +1,43 @@
+/*
+ * Copyright (C) 2002 - 2023 Devexperts LLC
+ * This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
+ * If a copy of the MPL was not distributed with this file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+import { FullChartColors, FullChartConfig } from '../../chart.config';
+import { CandleSeriesColors } from '../../model/candle-series.model';
+export declare class SecondaryChartColorsPool {
+    private config;
+    private secondaryChartColorsPool;
+    private usedChartColors;
+    private symbolsToColorKeys;
+    constructor(config: FullChartConfig);
+    /**
+     * Creates a color pool object based on the provided color array
+     * @param {SecondaryChartTheme[]} colorArray - An array of SecondaryChartTheme objects
+     * @returns {Object} - An object containing a key-value pair for each color in the colorArray
+     * The key is a string in the format "colorX" where X is the index of the color in the array
+     * The value is an object containing the FullChartColors for the color, with lineTheme and areaTheme properties
+     */
+    private createColorPool;
+    /**
+     * Takes a color from the secondaryChartColorsPool and assigns it to a symbol.
+     * @param {string} symbol - The symbol to assign the color to.
+     * @returns {string} The color assigned to the symbol.
+     */
+    takeColorFromPool(symbol: string): FullChartColors;
+    /**
+     * Adds a color to the chart color pool.
+     *
+     * @param {string} symbol - The symbol of the color to be added.
+     *
+     * @returns {void}
+     */
+    addColorToPool(symbol: string): void;
+    /**
+     * Updates the color configuration for a given symbol in the chart.
+     * @param {string} symbol - The symbol for which the color configuration needs to be updated.
+     * @param {CandleSeriesColors} config - The new color configuration for the symbol.
+     * @returns {void}
+     */
+    updateColorConfig(symbol: string, config: CandleSeriesColors): void;
+}

package/dist/chart/components/chart/secondary-chart-colors-pool.js

@@ -0,0 +1,6 @@
+/*
+ * Copyright (C) 2002 - 2023 Devexperts LLC
+ * This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
+ * If a copy of the MPL was not distributed with this file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+import{cloneUnsafe as a}from"../../utils/object.utils";export class SecondaryChartColorsPool{constructor(e){this.config=e,this.usedChartColors={},this.symbolsToColorKeys={},this.secondaryChartColorsPool=this.createColorPool(this.config.colors.secondaryChartTheme),this.usedChartColors=Object.keys(this.secondaryChartColorsPool).reduce((o,s)=>Object.assign(Object.assign({},o),{[s]:0}),{})}createColorPool(e){return e.reduce((o,s,r)=>(o[`color${r}`]=Object.assign(Object.assign({},a(this.config.colors)),{lineTheme:Object.assign({},s.lineTheme),areaTheme:Object.assign({},s.areaTheme)}),o),{})}takeColorFromPool(e){let o=Number.MAX_SAFE_INTEGER,s="";for(const[r,t]of Object.entries(this.usedChartColors))t<o&&(o=t,s=r);return this.usedChartColors[s]=this.usedChartColors[s]+1,this.symbolsToColorKeys[e]=s,this.secondaryChartColorsPool[s]}addColorToPool(e){const o=this.symbolsToColorKeys[e];this.usedChartColors[o]&&(this.usedChartColors[o]=this.usedChartColors[o]-1)}updateColorConfig(e,o){var s,r;const t=this.secondaryChartColorsPool[this.usedChartColors[e]];if(t){const l=o;this.secondaryChartColorsPool[this.usedChartColors[e]]=Object.assign(Object.assign({},o),{lineTheme:Object.assign(t.lineTheme,(s=l.lineTheme)!==null&&s!==void 0?s:{}),areaTheme:Object.assign(t.areaTheme,(r=l.areaTheme)!==null&&r!==void 0?r:{})})}}}