@devexperts/dxcharts-lite 1.0.2 → 2.0.0

package/dist/chart/components/chart/chart.component.js

@@ -3,4 +3,411 @@
  * 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{CHART_UUID as l,CanvasElement as c}from"../../canvas/canvas-bounds-container";import{ChartBaseElement as g}from"../../model/chart-base-element";import{BackgroundDrawer as T}from"../../drawers/chart-background.drawer";import{AreaDrawer as M}from"../../drawers/chart-type-drawers/area.drawer";import{BarDrawer as v}from"../../drawers/chart-type-drawers/bar.drawer";import{BaselineDrawer as I}from"../../drawers/chart-type-drawers/baseline.drawer";import{CandleDrawer as y}from"../../drawers/chart-type-drawers/candle.drawer";import{HistogramDrawer as E}from"../../drawers/chart-type-drawers/histogram.drawer";import{LineDrawer as b}from"../../drawers/chart-type-drawers/line.drawer";import{ScatterPlotDrawer as A}from"../../drawers/chart-type-drawers/scatter-plot.drawer";import{CandleSeriesWrapper as P}from"../../drawers/data-series-drawers/candle-series-wrapper";import{ColorCandleDrawer as _}from"../../drawers/data-series-drawers/color-candle.drawer";import{DifferenceCloudDrawer as L}from"../../drawers/data-series-drawers/difference-cloud.drawer";import{HistogramDrawer as N}from"../../drawers/data-series-drawers/histogram.drawer";import{LinearDrawer as B}from"../../drawers/data-series-drawers/linear.drawer";import{PointsDrawer as R}from"../../drawers/data-series-drawers/points.drawer";import{TextDrawer as O}from"../../drawers/data-series-drawers/text.drawer";import{TriangleDrawer as H}from"../../drawers/data-series-drawers/triangle.drawer";import{DataSeriesDrawer as x}from"../../drawers/data-series.drawer";import{HIT_TEST_PREFIX as U}from"../../drawers/drawing-manager";import{HTDataSeriesDrawer as F}from"../../drawers/ht-data-series.drawer";import{BaselineModel as X}from"../../model/baseline.model";import{keys as k}from"../../utils/object.utils";import{PriceIncrementsUtils as m}from"../../utils/price-increments.utils";import{defaultCandleTransformer as V,hollowCandleTransformer as W,trendCandleTransformer as G}from"./candle-transformer.functions";import{deleteCandlesIndex as j}from"./candle.functions";import{TrendHistogramDrawer as K}from"../../drawers/data-series-drawers/trend-histogram.drawer";export class ChartInstrument{constructor(){this.symbol="MOCK",this.priceIncrements=[.01]}}export class ChartComponent extends g{constructor(e,r,t,a,i,s,n,D,C,w,d,h){super(),this.chartModel=e,this.canvasModel=r,this.config=t,this.scaleModel=a,this.canvasBoundsContainer=i,this.drawingManager=s,this.hitTestCanvasModel=n,this.canvasInputListener=D,this.dataSeriesDrawers={},this.strToBarType=f=>{var o;return(o=this.barTypeValues.find(S=>S===f))!==null&&o!==void 0?o:"candle"},this.addChildEntity(this.chartModel),this.registerDefaultCandlesTransformers(),this.baselineModel=new X(this.chartModel,w,this.canvasModel,this.canvasInputListener,this.config,this.canvasBoundsContainer,h),this.addChildEntity(this.baselineModel);const u=new F(this.dataSeriesDrawers,this.hitTestCanvasModel,d);this.drawingManager.addDrawerBefore(u,U+"DATA_SERIES","HIT_TEST_EVENTS"),this.dataSeriesDrawer=new x(d,r,this.dataSeriesDrawers),this.drawingManager.addDrawer(this.dataSeriesDrawer,"DATA_SERIES"),this.registerDefaultDataSeriesDrawers(),this.backgroundDrawer=new T(C,this.config),s.addDrawer(this.backgroundDrawer,"MAIN_BACKGROUND"),h.setCursorForCanvasEl(c.PANE_UUID(l),t.components.chart.cursor)}doActivate(){super.doActivate()}registerDefaultCandlesTransformers(){this.registerCandlesTransformer("candle",V),this.registerCandlesTransformer("trend",G),this.registerCandlesTransformer("hollow",W)}get barTypeValues(){return k(this.dataSeriesDrawers)}registerCandlesTransformer(e,r){this.chartModel.registerCandlesTransformer(e,r)}registerLastCandleLabelHandler(e,r){this.chartModel.registerLastCandleLabelHandler(e,r)}registerCandlesWidthCalculator(e,r){this.chartModel.registerCandlesWidthCalculator(e,r)}registerDefaultDataSeriesDrawers(){const e=new y(this.config.components.chart);this.registerDataSeriesTypeDrawer("candle",e),this.registerDataSeriesTypeDrawer("trend",e),this.registerDataSeriesTypeDrawer("hollow",e),this.registerDataSeriesTypeDrawer("bar",new v(this.config.components.chart)),this.registerDataSeriesTypeDrawer("line",new b(this.config.components.chart)),this.registerDataSeriesTypeDrawer("scatterPlot",new A(this.config.colors.scatterPlot)),this.registerDataSeriesTypeDrawer("area",new M(this.config.components.chart)),this.registerDataSeriesTypeDrawer("baseline",new I(this.baselineModel,this.canvasBoundsContainer)),this.registerDataSeriesTypeDrawer("histogram",new E(this.config.components.chart.histogram));const r=()=>this.canvasBoundsContainer.getBounds(c.PANE_UUID(l));this.registerDataSeriesTypeDrawer("LINEAR",new B),this.registerDataSeriesTypeDrawer("HISTOGRAM",new N),this.registerDataSeriesTypeDrawer("TREND_HISTOGRAM",new K),this.registerDataSeriesTypeDrawer("POINTS",new R),this.registerDataSeriesTypeDrawer("COLOR_CANDLE",new P(new _(this.chartModel),this.config,r)),this.registerDataSeriesTypeDrawer("TEXT",new O(this.config)),this.registerDataSeriesTypeDrawer("TRIANGLE",new H),this.registerDataSeriesTypeDrawer("DIFFERENCE",new L)}setChartType(e){this.config.components.chart.type=e,this.chartModel.rememberCurrentTimeframe(),this.chartModel.mainCandleSeries.setType(e),this.chartModel.mainCandleSeries.updateCandleSeriesColors(Object.assign({},this.config.colors)),this.chartModel.mainCandleSeries.recalculateVisualPoints(),this.chartModel.chartTypeChanged.next(e)}resetChartScale(){this.chartModel.doBasicScale()}setTimestampRange(e,r){return this.chartModel.setTimestampRange(e,r)}setXScale(e,r){return this.scaleModel.setXScale(e,r)}setShowWicks(e){this.config.components.chart.showWicks=e,this.canvasModel.fireDraw()}setMainSeries(e){var r;const t=(r=e.instrument)!==null&&r!==void 0?r:this.chartModel.mainCandleSeries.instrument;this.chartModel.mainCandleSeries.instrument=t,this.chartModel.setAllSeries({candles:e.candles,instrument:t},this.chartModel.getSecondarySeries().map(a=>{var i;const s=(i=a.instrument)!==null&&i!==void 0?i:this.chartModel.mainCandleSeries.instrument,n=a.dataPoints;return j(n),{candles:n,instrument:s}})),this.updatePriceIncrementsIfNeeded(t)}setSecondarySeries(e){var r;const t=(r=e.instrument)!==null&&r!==void 0?r:this.chartModel.mainCandleSeries.instrument,a=this.chartModel.setSecondaryCandleSeries(e.candles,t);if(this.updatePriceIncrementsIfNeeded(t),a)return a}setAllSeries(e,r=[]){var t;const a=(t=e.instrument)!==null&&t!==void 0?t:this.chartModel.mainCandleSeries.instrument;this.updatePriceIncrementsIfNeeded(a),r.forEach(i=>{var s;const n=(s=i.instrument)!==null&&s!==void 0?s:this.chartModel.mainCandleSeries.instrument;this.updatePriceIncrementsIfNeeded(n)}),this.chartModel.setAllSeries(e,r)}toXFromCandleIndex(e){return this.chartModel.toX(e)}toXFromTimestamp(e){return this.chartModel.candleFromTimestamp(e).xCenter(this.chartModel.scaleModel)}toY(e){return this.chartModel.toY(e)}updateAllSeries(e,r=[]){this.chartModel.updateAllSeries(e,r),this.canvasModel.fireDraw()}removeDataFrom(e){this.chartModel.removeDataFrom(e)}removeSecondarySeries(e){this.chartModel.removeSecondaryCandleSeries(e)}prependCandles(e,r){this.chartModel.prependCandles(e,r)}addLastCandle(e,r){this.chartModel.addLastCandle(e,r)}updateLastCandle(e,r){this.chartModel.updateLastCandle(e,r)}updateCandles(e,r){this.chartModel.updateCandles(e,r)}setOffsets(e){this.chartModel.setOffsets(e)}getDataSeriesDrawer(e){return this.dataSeriesDrawers[e]}registerDataSeriesTypeDrawer(e,r){this.dataSeriesDrawers[e]=r}updatePriceIncrementsIfNeeded(e){(!e.priceIncrements||!m.validatePriceIncrementsOrPrecisions(e.priceIncrements))&&(e.priceIncrements=[m.autoDetectIncrementOfValueRange(this.scaleModel.yEnd-this.scaleModel.yStart)])}observeOffsetsChanged(){return this.chartModel.offsetsChanged}observeChartTypeChanged(){return this.chartModel.chartTypeChanged}observeCandlesChanged(){return this.chartModel.observeCandlesChanged()}observeCandlesUpdated(){return this.chartModel.candlesUpdatedSubject}observeCandlesPrepended(){return this.chartModel.candlesPrependSubject}}
+import { CHART_UUID, CanvasElement } from '../../canvas/canvas-bounds-container';
+import { ChartBaseElement } from '../../model/chart-base-element';
+import { BackgroundDrawer } from '../../drawers/chart-background.drawer';
+import { AreaDrawer } from '../../drawers/chart-type-drawers/area.drawer';
+import { BarDrawer } from '../../drawers/chart-type-drawers/bar.drawer';
+import { BaselineDrawer } from '../../drawers/chart-type-drawers/baseline.drawer';
+import { CandleDrawer } from '../../drawers/chart-type-drawers/candle.drawer';
+import { HistogramDrawer as MainChartHistogramDrawer } from '../../drawers/chart-type-drawers/histogram.drawer';
+import { LineDrawer } from '../../drawers/chart-type-drawers/line.drawer';
+import { ScatterPlotDrawer } from '../../drawers/chart-type-drawers/scatter-plot.drawer';
+import { CandleSeriesWrapper } from '../../drawers/data-series-drawers/candle-series-wrapper';
+import { ColorCandleDrawer } from '../../drawers/data-series-drawers/color-candle.drawer';
+import { DifferenceCloudDrawer } from '../../drawers/data-series-drawers/difference-cloud.drawer';
+import { HistogramDrawer } from '../../drawers/data-series-drawers/histogram.drawer';
+import { LinearDrawer } from '../../drawers/data-series-drawers/linear.drawer';
+import { PointsDrawer } from '../../drawers/data-series-drawers/points.drawer';
+import { TextDrawer } from '../../drawers/data-series-drawers/text.drawer';
+import { TriangleDrawer } from '../../drawers/data-series-drawers/triangle.drawer';
+import { DataSeriesDrawer } from '../../drawers/data-series.drawer';
+import { HIT_TEST_PREFIX } from '../../drawers/drawing-manager';
+import { HTDataSeriesDrawer } from '../../drawers/ht-data-series.drawer';
+import { BaselineModel } from '../../model/baseline.model';
+import { keys } from '../../utils/object.utils';
+import { PriceIncrementsUtils } from '../../utils/price-increments.utils';
+import { defaultCandleTransformer, hollowCandleTransformer, trendCandleTransformer, } from './candle-transformer.functions';
+import { deleteCandlesIndex } from './candle.functions';
+import { TrendHistogramDrawer } from '../../drawers/data-series-drawers/trend-histogram.drawer';
+/**
+ * Represents a financial instrument to be displayed on a chart
+ * @class
+ * @property {string} symbol - The symbol of the instrument
+ * @property {string} [description] - The description of the instrument
+ * @property {Array<number>} [priceIncrements=[0.01]] - An array of possible price step values on the price axis
+ * @property {boolean} [bondFraction] - A flag indicating whether the instrument is a bond fraction or not
+ */
+export class ChartInstrument {
+    constructor() {
+        this.symbol = 'MOCK';
+        /**
+         * defines possible price step values on price axis
+         */
+        this.priceIncrements = [0.01];
+    }
+}
+export class ChartComponent extends ChartBaseElement {
+    constructor(chartModel, canvasModel, config, scale, canvasBoundsContainer, drawingManager, hitTestCanvasModel, canvasInputListener, backgroundCanvasModel, chartPanComponent, paneManager, cursorHandler, dynamicObjects) {
+        super();
+        this.chartModel = chartModel;
+        this.canvasModel = canvasModel;
+        this.config = config;
+        this.scale = scale;
+        this.canvasBoundsContainer = canvasBoundsContainer;
+        this.drawingManager = drawingManager;
+        this.hitTestCanvasModel = hitTestCanvasModel;
+        this.canvasInputListener = canvasInputListener;
+        this.paneManager = paneManager;
+        this.dynamicObjects = dynamicObjects;
+        this._dataSeriesDrawers = {};
+        this.strToBarType = (str) => { var _a; return (_a = this.barTypeValues.find(t => t === str)) !== null && _a !== void 0 ? _a : 'candle'; };
+        this.addChildEntity(this.chartModel);
+        this.registerDefaultCandlesTransformers();
+        this.baselineModel = new BaselineModel(this.chartModel, chartPanComponent, this.canvasModel, this.canvasInputListener, this.config, this.canvasBoundsContainer, cursorHandler);
+        this.addChildEntity(this.baselineModel);
+        //#region main chart drawers
+        const hTChartDrawer = new HTDataSeriesDrawer(this._dataSeriesDrawers, this.hitTestCanvasModel, paneManager);
+        this.drawingManager.addDrawerBefore(hTChartDrawer, HIT_TEST_PREFIX + 'DATA_SERIES', 'HIT_TEST_EVENTS');
+        //#endregion
+        //#region data series drawers
+        this.registerDefaultDataSeriesDrawers();
+        //#endregion
+        this.backgroundDrawer = new BackgroundDrawer(backgroundCanvasModel, this.config);
+        drawingManager.addDrawer(this.backgroundDrawer, 'MAIN_BACKGROUND');
+        cursorHandler.setCursorForCanvasEl(CanvasElement.PANE_UUID(CHART_UUID), config.components.chart.cursor);
+        this.dataSeriesDrawer = new DataSeriesDrawer(paneManager, this.dataSeriesDrawers);
+    }
+    /**
+     * This method overrides the doActivate method of the parent class and calls it.
+     * It does not take any parameters and does not return anything.
+     * @protected
+     * @returns {void}
+     */
+    doActivate() {
+        super.doActivate();
+        // TODO hack, main data series is created before doActivate, so we need to add it manually
+        this.dynamicObjects.model.addObject({ model: this.chartModel.mainCandleSeries, drawer: this.dataSeriesDrawer }, this.chartModel.mainCandleSeries.extentComponent.paneUUID);
+        this.addRxSubscription(this.paneManager.dataSeriesAddedSubject.subscribe(series => {
+            this.dynamicObjects.model.addObject({ model: series, drawer: this.dataSeriesDrawer }, series.extentComponent.paneUUID);
+        }));
+        this.addRxSubscription(this.paneManager.dataSeriesRemovedSubject.subscribe(series => {
+            this.dynamicObjects.model.removeObject(series, series.extentComponent.paneUUID);
+        }));
+    }
+    /**
+     * Registers default candle transformers.
+     * @private
+     * @function
+     * @returns {void}
+     */
+    registerDefaultCandlesTransformers() {
+        this.registerCandlesTransformer('candle', defaultCandleTransformer);
+        this.registerCandlesTransformer('trend', trendCandleTransformer);
+        this.registerCandlesTransformer('hollow', hollowCandleTransformer);
+    }
+    get barTypeValues() {
+        // @ts-ignore
+        return keys(this._dataSeriesDrawers);
+    }
+    get dataSeriesDrawers() {
+        return this._dataSeriesDrawers;
+    }
+    /**
+     * You can use this method to determine logic of visual candle transformation for specified chart type.
+     * @param chartType
+     * @param transformer
+     */
+    registerCandlesTransformer(chartType, transformer) {
+        this.chartModel.registerCandlesTransformer(chartType, transformer);
+    }
+    /**
+     * You can use this method to modify labels for last candle.
+     * @param chartType
+     * @param handler
+     */
+    registerLastCandleLabelHandler(chartType, handler) {
+        this.chartModel.registerLastCandleLabelHandler(chartType, handler);
+    }
+    /**
+     * You can use this method to determine chart width calculation for specified chart type.
+     * @param chartType
+     * @param calculator
+     */
+    registerCandlesWidthCalculator(chartType, calculator) {
+        this.chartModel.registerCandlesWidthCalculator(chartType, calculator);
+    }
+    /**
+     * In future this drawers should have same type as main series
+     */
+    registerDefaultDataSeriesDrawers() {
+        const candleDrawer = new CandleDrawer(this.config.components.chart);
+        this.registerDataSeriesTypeDrawer('candle', candleDrawer);
+        this.registerDataSeriesTypeDrawer('trend', candleDrawer);
+        this.registerDataSeriesTypeDrawer('hollow', candleDrawer);
+        this.registerDataSeriesTypeDrawer('bar', new BarDrawer(this.config.components.chart));
+        this.registerDataSeriesTypeDrawer('line', new LineDrawer(this.config.components.chart));
+        this.registerDataSeriesTypeDrawer('scatterPlot', new ScatterPlotDrawer(this.config.colors.scatterPlot));
+        this.registerDataSeriesTypeDrawer('area', new AreaDrawer(this.config.components.chart));
+        this.registerDataSeriesTypeDrawer('baseline', new BaselineDrawer(this.baselineModel, this.canvasBoundsContainer));
+        this.registerDataSeriesTypeDrawer('histogram', new MainChartHistogramDrawer(this.config.components.chart.histogram));
+        const mainChartBoundsProvider = () => this.canvasBoundsContainer.getBounds(CanvasElement.PANE_UUID(CHART_UUID));
+        this.registerDataSeriesTypeDrawer('LINEAR', new LinearDrawer());
+        this.registerDataSeriesTypeDrawer('HISTOGRAM', new HistogramDrawer());
+        this.registerDataSeriesTypeDrawer('TREND_HISTOGRAM', new TrendHistogramDrawer());
+        this.registerDataSeriesTypeDrawer('POINTS', new PointsDrawer());
+        this.registerDataSeriesTypeDrawer('COLOR_CANDLE', new CandleSeriesWrapper(new ColorCandleDrawer(this.chartModel), this.config, mainChartBoundsProvider));
+        this.registerDataSeriesTypeDrawer('TEXT', new TextDrawer(this.config));
+        this.registerDataSeriesTypeDrawer('TRIANGLE', new TriangleDrawer());
+        this.registerDataSeriesTypeDrawer('DIFFERENCE', new DifferenceCloudDrawer());
+    }
+    /**
+     * Sets the chart type of main candle series.
+     * @param type - new type
+     */
+    setChartType(type) {
+        this.config.components.chart.type = type;
+        this.chartModel.rememberCurrentTimeframe();
+        this.chartModel.mainCandleSeries.setType(type);
+        this.chartModel.mainCandleSeries.updateCandleSeriesColors(Object.assign({}, this.config.colors));
+        this.chartModel.mainCandleSeries.recalculateVisualPoints();
+        this.chartModel.chartTypeChanged.next(type);
+    }
+    /**
+     * Resets chart scale to default according to config.components.chart.defaultZoomCandleWidth.
+     */
+    resetChartScale() {
+        this.chartModel.doBasicScale();
+    }
+    /**
+     * 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, end) {
+        return this.chartModel.setTimestampRange(start, end);
+    }
+    /**
+     * Moves the viewport to exactly xStart..xEnd place.
+     * @param xStart - viewport start in units
+     * @param xEnd - viewport end in units
+     */
+    setXScale(xStart, xEnd) {
+        return this.scale.setXScale(xStart, xEnd);
+    }
+    /**
+     * Sets the visibility of the wicks in the chart.
+     * @param {boolean} isShow - A boolean value indicating whether to show or hide the wicks.
+     * @returns {void}
+     */
+    setShowWicks(isShow) {
+        this.config.components.chart.showWicks = isShow;
+        this.canvasModel.fireDraw();
+    }
+    /**
+     * Used to set the main series to chart.
+     * @param series
+     */
+    setMainSeries(series) {
+        var _a;
+        const instrument = (_a = series.instrument) !== null && _a !== void 0 ? _a : this.chartModel.mainCandleSeries.instrument;
+        this.chartModel.mainCandleSeries.instrument = instrument;
+        this.chartModel.setAllSeries({
+            candles: series.candles,
+            instrument,
+        }, this.chartModel.getSecondarySeries().map(series => {
+            var _a;
+            const instrument = (_a = series.instrument) !== null && _a !== void 0 ? _a : this.chartModel.mainCandleSeries.instrument;
+            const originalCandles = series.dataPoints;
+            // reset the idx of candles to calculate them again
+            deleteCandlesIndex(originalCandles);
+            return {
+                candles: originalCandles,
+                instrument,
+            };
+        }));
+        this.updatePriceIncrementsIfNeeded(instrument);
+    }
+    /**
+     * Adds new secondary chart series.
+     * @param series
+     */
+    setSecondarySeries(series) {
+        var _a;
+        const instrument = (_a = series.instrument) !== null && _a !== void 0 ? _a : this.chartModel.mainCandleSeries.instrument;
+        const candleSeriesModel = this.chartModel.setSecondaryCandleSeries(series.candles, instrument);
+        this.updatePriceIncrementsIfNeeded(instrument);
+        if (candleSeriesModel) {
+            return candleSeriesModel;
+        }
+    }
+    /**
+     * Sets the main and secondary series in one bulk operation.
+     * Reindexing and visual rerender happens at the same time.
+     * @param mainSeries
+     * @param secondarySeries
+     */
+    setAllSeries(mainSeries, secondarySeries = []) {
+        var _a;
+        const instrument = (_a = mainSeries.instrument) !== null && _a !== void 0 ? _a : this.chartModel.mainCandleSeries.instrument;
+        this.updatePriceIncrementsIfNeeded(instrument);
+        secondarySeries.forEach(series => {
+            var _a;
+            const instrument = (_a = series.instrument) !== null && _a !== void 0 ? _a : this.chartModel.mainCandleSeries.instrument;
+            this.updatePriceIncrementsIfNeeded(instrument);
+        });
+        this.chartModel.setAllSeries(mainSeries, secondarySeries);
+    }
+    /**
+     * Converts candle index to chart x coordinate
+     */
+    toXFromCandleIndex(idx) {
+        return this.chartModel.toX(idx);
+    }
+    /**
+     * Converts timestamp to chart x coordinate
+     */
+    toXFromTimestamp(timestamp) {
+        const xCandle = this.chartModel.candleFromTimestamp(timestamp);
+        return xCandle.xCenter(this.chartModel.scale);
+    }
+    /**
+     * Converts price to chart y coordinate
+     */
+    toY(price) {
+        return this.chartModel.toY(price);
+    }
+    /**
+     * Updates the main and secondary series in one bulk operation.
+     * Reindexing and visual rerender happens at the same time.
+     * @param mainSeries {CandleSeries}
+     * @param secondarySeries {CandleSeries[]}
+     */
+    updateAllSeries(mainSeries, secondarySeries = []) {
+        this.chartModel.updateAllSeries(mainSeries, secondarySeries);
+        this.canvasModel.fireDraw();
+    }
+    /**
+     * 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(timestamp) {
+        this.chartModel.removeDataFrom(timestamp);
+    }
+    /**
+     * Removes chart candles series.
+     * @param instrument
+     */
+    removeSecondarySeries(series) {
+        this.chartModel.removeSecondaryCandleSeries(series);
+    }
+    /**
+     * 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, prependUpdate) {
+        this.chartModel.prependCandles(target, prependUpdate);
+    }
+    /**
+     * Adds new candle to the chart
+     * @param candle - new candle
+     * @param instrument - name of the instrument to update
+     */
+    addLastCandle(candle, instrumentSymbol) {
+        this.chartModel.addLastCandle(candle, instrumentSymbol);
+    }
+    /**
+     * Updates last candle value
+     * @param candle - updated candle
+     * @param instrument - name of the instrument to update
+     */
+    updateLastCandle(candle, instrumentSymbol) {
+        this.chartModel.updateLastCandle(candle, instrumentSymbol);
+    }
+    /**
+     * Updates candle series for instrument. By default takes main instrument.
+     * @param candles
+     * @param instrument
+     */
+    updateCandles(candles, instrumentSymbol) {
+        this.chartModel.updateCandles(candles, instrumentSymbol);
+    }
+    /**
+     * Sets offsets to viewport.
+     * @param offsets - new offsets
+     */
+    setOffsets(offsets) {
+        this.chartModel.setOffsets(offsets);
+    }
+    /**
+     * Returns a SeriesDrawer object based on the provided drawerType.
+     * @param {BarType} drawerType - The type of the drawer to be returned.
+     * @returns {SeriesDrawer | undefined} - The SeriesDrawer object corresponding to the provided drawerType or undefined if not found.
+     */
+    getDataSeriesDrawer(drawerType) {
+        return this._dataSeriesDrawers[drawerType];
+    }
+    /**
+     * Registers a new chart type drawer or overrides default drawer if drawerType is {BarType}.
+     * @param drawerType {string} - a unique name for the drawer, could be {BarType} - in this case will override default drawer for the type
+     * @param drawer {ChartTypeDrawer} - an implementation of the drawer
+     */
+    registerDataSeriesTypeDrawer(drawerType, drawer) {
+        this._dataSeriesDrawers[drawerType] = drawer;
+    }
+    //#endregion
+    /**
+     * Updates the price increments of a given instrument if they are not valid or not defined.
+     * If the price increments are not valid or not defined, it will set them to a default value.
+     * @param {ChartInstrument} instrument - The instrument to update the price increments for.
+     */
+    updatePriceIncrementsIfNeeded(instrument) {
+        if (!instrument.priceIncrements ||
+            !PriceIncrementsUtils.validatePriceIncrementsOrPrecisions(instrument.priceIncrements)) {
+            instrument.priceIncrements = [
+                PriceIncrementsUtils.autoDetectIncrementOfValueRange(this.scale.yEnd - this.scale.yStart),
+            ];
+        }
+    }
+    //#region public events
+    /**
+     * Returns an Observable that emits a void value whenever the offsetsChanged event is triggered.
+     * @returns {Observable<void>} An Observable that emits a void value whenever the offsetsChanged event is triggered.
+     */
+    observeOffsetsChanged() {
+        return this.chartModel.offsetsChanged;
+    }
+    /**
+     * Returns an Observable that emits the BarType whenever the chart type is changed.
+     * @returns {Observable<BarType>} An Observable that emits the BarType whenever the chart type is changed.
+     */
+    observeChartTypeChanged() {
+        return this.chartModel.chartTypeChanged;
+    }
+    /**
+     * Returns an Observable that emits a void value when the candles in the chart model change.
+     * The Observable is obtained by calling the observeCandlesChanged method of the chartModel object.
+     * @returns {Observable<void>} An Observable that emits a void value when the candles in the chart model change.
+     */
+    observeCandlesChanged() {
+        return this.chartModel.observeCandlesChanged();
+    }
+    /**
+     * Returns an Observable that emits a void value when the candles are updated in the chart model.
+     * The Observable is obtained from the candlesUpdatedSubject of the chartModel.
+     * @returns {Observable<void>} Observable that emits a void value when the candles are updated.
+     */
+    observeCandlesUpdated() {
+        return this.chartModel.candlesUpdatedSubject;
+    }
+    /**
+     * Returns an Observable that emits a void value whenever the candlesPrependSubject is triggered.
+     * @returns {Observable<PrependedCandlesData>} An Observable that emits a PrependedCandlesData whenever the candles are added to the end.
+     */
+    observeCandlesPrepended() {
+        return this.chartModel.candlesPrependSubject;
+    }
+}

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

@@ -4,15 +4,14 @@
  * 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 { CanvasModel } from '../../model/canvas.model';
+import { ChartBaseElement } from '../../model/chart-base-element';
 import { DataSeriesType } from '../../model/data-series.config';
 import { ScaleModel } from '../../model/scale.model';
 import { Index, Pixel, Price, Timestamp, Unit } from '../../model/scaling/viewport.model';
@@ -37,7 +36,7 @@ export declare class ChartModel extends ChartBaseElement {
     bus: EventBus;
     private canvasModel;
     config: FullChartConfig;
-    scaleModel: ScaleModel;
+    scale: ScaleModel;
     formatterFactory: (format: string) => (timestamp: number) => string;
     mainCanvasParent: Element;
     private canvasBoundsContainer;
@@ -48,7 +47,6 @@ export declare class ChartModel extends ChartBaseElement {
     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>;
@@ -62,7 +60,7 @@ export declare class ChartModel extends ChartBaseElement {
     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);
+    constructor(chartBaseModel: ChartBaseModel<'candle'>, paneManager: PaneManager, bus: EventBus, canvasModel: CanvasModel, config: FullChartConfig, scale: 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>;
@@ -231,11 +229,6 @@ export declare class ChartModel extends ChartBaseElement {
      * @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