@devexperts/dxcharts-lite 1.0.2 → 2.0.0

package/dist/chart/components/x_axis/x-axis.component.js

@@ -3,4 +3,122 @@
  * 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{merge as n}from"rxjs";import{distinctUntilChanged as v,map as d,throttleTime as f,filter as h}from"rxjs/operators";import{CanvasElement as w}from"../../canvas/canvas-bounds-container";import{ChartBaseElement as C}from"../../model/chart-base-element";import{CompositeDrawer as S}from"../../drawers/composite.drawer";import{XAxisLabelsDrawer as g}from"./x-axis-labels.drawer";import{XAxisTimeLabelsGenerator as x}from"./x-axis-labels.generator";import{XAxisLabelsModel as D}from"./x-axis-labels.model";import{XAxisScaleHandler as G}from"./x-axis-scale.handler";import{XAxisTimeLabelsDrawer as M}from"./x-axis-time-labels.drawer";import{lastOf as X}from"../../utils/array.utils";import{notEmpty as H}from"../../utils/function.utils";import{availableBarTypes as R}from"../../chart.config";export class XAxisComponent extends C{constructor(e,s,i,t,r,a,m,c,b,l,p,A,u){super(),this.eventBus=e,this.config=s,this.canvasModel=i,this.chartComponent=t,this.scaleModel=r,this.chartResizeHandler=c,this.timeZoneModel=l;const L=new x(e,s,t.chartModel,r,l,this.canvasModel);this.xAxisLabelsGenerator=L,this.xAxisLabelsModel=new D(e,[]);const o=new S;b.addDrawer(o,"X_AXIS"),this.xAxisDrawer=new M(s,i,r,a,()=>this.xAxisLabelsGenerator.labels,()=>s.components.xAxis.visible),o.addDrawer(this.xAxisDrawer),this.xAxisLabelsDrawer=new g(u,s,i,a,this.xAxisLabelsModel),o.addDrawer(this.xAxisLabelsDrawer),this.xAxisScaleHandler=new G(r,m,a,p,this.chartComponent.chartModel),this.addChildEntity(this.xAxisScaleHandler),A.setCursorForCanvasEl(w.X_AXIS,s.components.xAxis.cursor)}doActivate(){super.doActivate(),this.addRxSubscription(n(this.chartComponent.chartModel.candlesSetSubject,this.timeZoneModel.observeTimeZoneChanged()).subscribe(()=>{this.xAxisLabelsGenerator.generateLabels()})),this.addRxSubscription(this.chartComponent.chartModel.candlesPrependSubject.pipe(h(({preparedCandles:e})=>e.length!==0),d(({preparedCandles:e})=>this.chartComponent.chartModel.mainCandleSeries.visualPoints.slice(0,e.length))).subscribe(e=>{R.includes(this.config.components.chart.type)&&this.xAxisLabelsGenerator.updateHistoryLabels&&this.xAxisLabelsGenerator.updateHistoryLabels(e)})),this.addRxSubscription(n(this.scaleModel.xChanged,this.chartResizeHandler.canvasResized).pipe(f(50,void 0,{trailing:!0,leading:!0})).subscribe(()=>{this.xAxisLabelsGenerator.recalculateLabels()})),this.addRxSubscription(this.chartComponent.chartModel.candlesUpdatedSubject.pipe(d(()=>X(this.chartComponent.chartModel.mainCandleSeries.visualPoints)),v((e,s)=>{var i,t;return((i=e==null?void 0:e.candle)===null||i===void 0?void 0:i.timestamp)===((t=s==null?void 0:s.candle)===null||t===void 0?void 0:t.timestamp)}),h(H)).subscribe(e=>{this.xAxisLabelsGenerator.updateLastLabel&&this.xAxisLabelsGenerator.updateLastLabel(e)}))}getDrawer(){return this.xAxisDrawer}registerXAxisLabelsProvider(e){this.xAxisLabelsModel.labelProviders.push(e)}setVisible(e){var s;!((s=this.config.components)===null||s===void 0)&&s.xAxis&&(this.config.components.xAxis.visible=e,this.eventBus.fireDraw())}setFormatsForLabelsConfig(e){this.xAxisLabelsGenerator instanceof x?this.xAxisLabelsGenerator.setFormatsForLabelsConfig(e):console.error("Format config for x-axis is not available")}isVisible(){var e,s;return(s=(e=this.config.components)===null||e===void 0?void 0:e.xAxis.visible)!==null&&s!==void 0?s:!1}}
+import { merge } from 'rxjs';
+import { distinctUntilChanged, map, throttleTime, filter } from 'rxjs/operators';
+import { CanvasElement } from '../../canvas/canvas-bounds-container';
+import { ChartBaseElement } from '../../model/chart-base-element';
+import { CompositeDrawer } from '../../drawers/composite.drawer';
+import { XAxisLabelsDrawer } from './x-axis-labels.drawer';
+import { XAxisTimeLabelsGenerator } from './x-axis-labels.generator';
+import { XAxisLabelsModel } from './x-axis-labels.model';
+import { XAxisScaleHandler } from './x-axis-scale.handler';
+import { XAxisTimeLabelsDrawer } from './x-axis-time-labels.drawer';
+import { lastOf } from '../../utils/array.utils';
+import { notEmpty } from '../../utils/function.utils';
+import { availableBarTypes } from '../../chart.config';
+/**
+ * X-axis component, contains all x-axis calculation and rendering logic.
+ */
+export class XAxisComponent extends ChartBaseElement {
+    constructor(eventBus, config, canvasModel, chartComponent, scale, canvasBoundsContainer, canvasInputListener, chartResizeHandler, drawingManager, timeZoneModel, chartPanComponent, cursorHandler, backgroundCanvasModel) {
+        super();
+        this.eventBus = eventBus;
+        this.config = config;
+        this.canvasModel = canvasModel;
+        this.chartComponent = chartComponent;
+        this.scale = scale;
+        this.chartResizeHandler = chartResizeHandler;
+        this.timeZoneModel = timeZoneModel;
+        const xAxisLabelsGenerator = new XAxisTimeLabelsGenerator(eventBus, config, chartComponent.chartModel, scale, timeZoneModel, this.canvasModel);
+        this.xAxisLabelsGenerator = xAxisLabelsGenerator;
+        this.xAxisLabelsModel = new XAxisLabelsModel(eventBus, []);
+        const xAxisCompositeDrawer = new CompositeDrawer();
+        drawingManager.addDrawer(xAxisCompositeDrawer, 'X_AXIS');
+        this.xAxisDrawer = new XAxisTimeLabelsDrawer(config, canvasModel, scale, canvasBoundsContainer, () => this.xAxisLabelsGenerator.labels, () => config.components.xAxis.visible);
+        xAxisCompositeDrawer.addDrawer(this.xAxisDrawer);
+        this.xAxisLabelsDrawer = new XAxisLabelsDrawer(backgroundCanvasModel, config, canvasModel, canvasBoundsContainer, this.xAxisLabelsModel);
+        xAxisCompositeDrawer.addDrawer(this.xAxisLabelsDrawer);
+        this.xAxisScaleHandler = new XAxisScaleHandler(scale, canvasInputListener, canvasBoundsContainer, chartPanComponent, this.chartComponent.chartModel);
+        this.addChildEntity(this.xAxisScaleHandler);
+        cursorHandler.setCursorForCanvasEl(CanvasElement.X_AXIS, config.components.xAxis.cursor);
+    }
+    /**
+     * This method is used to activate the chart and update the labels if there is a new data set or equivolume type.
+     * It subscribes to the chart type change, candles set subject, candles updated subject, and time zone change to generate new labels.
+     * It also subscribes to the x-axis scale change and canvas resize to recalculate the labels.
+     * @protected
+     * @returns {void}
+     */
+    doActivate() {
+        super.doActivate();
+        // do update labels if new data set
+        this.addRxSubscription(merge(this.chartComponent.chartModel.candlesSetSubject, this.timeZoneModel.observeTimeZoneChanged()).subscribe(() => {
+            this.xAxisLabelsGenerator.generateLabels();
+        }));
+        this.addRxSubscription(this.chartComponent.chartModel.candlesPrependSubject
+            .pipe(filter(({ preparedCandles }) => preparedCandles.length !== 0), map(({ preparedCandles }) => {
+            return this.chartComponent.chartModel.mainCandleSeries.visualPoints.slice(0, preparedCandles.length);
+        }))
+            .subscribe(newCandles => {
+            //@ts-ignore
+            if (availableBarTypes.includes(this.config.components.chart.type)) {
+                this.xAxisLabelsGenerator.updateHistoryLabels &&
+                    this.xAxisLabelsGenerator.updateHistoryLabels(newCandles);
+            }
+        }));
+        this.addRxSubscription(merge(this.scale.xChanged, this.chartResizeHandler.canvasResized)
+            .pipe(throttleTime(50, undefined, { trailing: true, leading: true }))
+            .subscribe(() => {
+            this.xAxisLabelsGenerator.recalculateLabels();
+        }));
+        this.addRxSubscription(this.chartComponent.chartModel.candlesUpdatedSubject
+            .pipe(map(() => lastOf(this.chartComponent.chartModel.mainCandleSeries.visualPoints)), distinctUntilChanged((a, b) => { var _a, _b; return ((_a = a === null || a === void 0 ? void 0 : a.candle) === null || _a === void 0 ? void 0 : _a.timestamp) === ((_b = b === null || b === void 0 ? void 0 : b.candle) === null || _b === void 0 ? void 0 : _b.timestamp); }), filter(notEmpty))
+            .subscribe(x => {
+            this.xAxisLabelsGenerator.updateLastLabel && this.xAxisLabelsGenerator.updateLastLabel(x);
+        }));
+    }
+    /**
+     * Returns the xAxisDrawer object.
+     *
+     * @returns {Object} The xAxisDrawer object.
+     */
+    getDrawer() {
+        return this.xAxisDrawer;
+    }
+    //#region public methods
+    /**
+     * You can add a custom labels provider for additional labels on XAxis (like for drawings)
+     * @param provider
+     */
+    registerXAxisLabelsProvider(provider) {
+        this.xAxisLabelsModel.labelProviders.push(provider);
+    }
+    /**
+     * Controls visibility of the x-axis
+     */
+    setVisible(isVisible) {
+        var _a;
+        if ((_a = this.config.components) === null || _a === void 0 ? void 0 : _a.xAxis) {
+            this.config.components.xAxis.visible = isVisible;
+            this.eventBus.fireDraw();
+        }
+    }
+    /**
+     * Set new config for x labels formatting
+     */
+    setFormatsForLabelsConfig(newFormatsByWeightMap) {
+        if (this.xAxisLabelsGenerator instanceof XAxisTimeLabelsGenerator) {
+            this.xAxisLabelsGenerator.setFormatsForLabelsConfig(newFormatsByWeightMap);
+        }
+        else {
+            console.error('Format config for x-axis is not available');
+        }
+    }
+    /**
+     * If visible, when you can see the x-axis on the chart
+     */
+    isVisible() {
+        var _a, _b;
+        return (_b = (_a = this.config.components) === null || _a === void 0 ? void 0 : _a.xAxis.visible) !== null && _b !== void 0 ? _b : false;
+    }
+}

package/dist/chart/components/y_axis/label-color.functions.js

@@ -3,4 +3,56 @@
  * 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 DEFAULT_LABEL_COLOR="#FF00FF",getPrimaryLabelTextColor=(r,o)=>r==="down"?o.lastPrice.textNegative:r==="up"?o.lastPrice.textPositive:o.lastPrice.textSelected,resolveColorForBar=(r,o)=>{const e=o.barTheme[`${r}Color`];return e!=null?e:DEFAULT_LABEL_COLOR},resolveColorForLine=(r,o)=>{const e=o.lineTheme[`${r}Color`];return e!=null?e:DEFAULT_LABEL_COLOR},resolveColorForCandle=(r,o)=>{const e=o.candleTheme[`${r}Color`];return e!=null?e:DEFAULT_LABEL_COLOR},resolveColorForArea=(r,o)=>{const e=o.areaTheme.lineColor;return e!=null?e:DEFAULT_LABEL_COLOR},resolveColorForScatterPlot=(r,o)=>{const e=o.scatterPlot.mainColor;return e!=null?e:DEFAULT_LABEL_COLOR},resolveColorForHistogram=(r,o)=>{const e=o.histogram[`${r}Cap`];return e!=null?e:DEFAULT_LABEL_COLOR},resolveColorForBaseLine=(r,o)=>{const e=r==="up"?o.baseLineTheme.upperSectionStrokeColor:o.baseLineTheme.lowerSectionStrokeColor;return e!=null?e:DEFAULT_LABEL_COLOR},resolveColorForTrendAndHollow=(r,o)=>{const e=o.candleTheme[`${r}WickColor`];return e!=null?e:DEFAULT_LABEL_COLOR},resolveDefaultColorForLabel=()=>(console.warn("Fallback for label default color"),DEFAULT_LABEL_COLOR);
+export const DEFAULT_LABEL_COLOR = '#FF00FF';
+export const getPrimaryLabelTextColor = (lastPriceMovement, colors) => {
+    if (lastPriceMovement === 'down') {
+        return colors.lastPrice.textNegative;
+    }
+    else if (lastPriceMovement === 'up') {
+        return colors.lastPrice.textPositive;
+    }
+    else if (lastPriceMovement === 'none') {
+        return colors.lastPrice.textSelected;
+    }
+    else {
+        return colors.lastPrice.textSelected;
+    }
+};
+export const resolveColorForBar = (priceMovement, colors) => {
+    const resolvedColor = colors.barTheme[`${priceMovement}Color`];
+    return resolvedColor !== null && resolvedColor !== void 0 ? resolvedColor : DEFAULT_LABEL_COLOR;
+};
+export const resolveColorForLine = (priceMovement, colors) => {
+    const resolvedColor = colors.lineTheme[`${priceMovement}Color`];
+    return resolvedColor !== null && resolvedColor !== void 0 ? resolvedColor : DEFAULT_LABEL_COLOR;
+};
+export const resolveColorForCandle = (priceMovement, colors) => {
+    const resolvedColor = colors.candleTheme[`${priceMovement}Color`];
+    return resolvedColor !== null && resolvedColor !== void 0 ? resolvedColor : DEFAULT_LABEL_COLOR;
+};
+export const resolveColorForArea = (priceMovement, colors) => {
+    const resolvedColor = colors.areaTheme.lineColor;
+    return resolvedColor !== null && resolvedColor !== void 0 ? resolvedColor : DEFAULT_LABEL_COLOR;
+};
+export const resolveColorForScatterPlot = (priceMovement, colors) => {
+    const resolvedColor = colors.scatterPlot.mainColor;
+    return resolvedColor !== null && resolvedColor !== void 0 ? resolvedColor : DEFAULT_LABEL_COLOR;
+};
+export const resolveColorForHistogram = (priceMovement, colors) => {
+    const resolvedColor = colors.histogram[`${priceMovement}Cap`];
+    return resolvedColor !== null && resolvedColor !== void 0 ? resolvedColor : DEFAULT_LABEL_COLOR;
+};
+export const resolveColorForBaseLine = (priceMovement, colors) => {
+    const resolvedColor = priceMovement === 'up'
+        ? colors.baseLineTheme.upperSectionStrokeColor
+        : colors.baseLineTheme.lowerSectionStrokeColor;
+    return resolvedColor !== null && resolvedColor !== void 0 ? resolvedColor : DEFAULT_LABEL_COLOR;
+};
+export const resolveColorForTrendAndHollow = (priceMovement, colors) => {
+    const resolvedColor = colors.candleTheme[`${priceMovement}WickColor`];
+    return resolvedColor !== null && resolvedColor !== void 0 ? resolvedColor : DEFAULT_LABEL_COLOR;
+};
+export const resolveDefaultColorForLabel = () => {
+    console.warn('Fallback for label default color');
+    return DEFAULT_LABEL_COLOR;
+};

package/dist/chart/components/y_axis/numeric-y-axis-labels.generator.d.ts

@@ -3,15 +3,15 @@
  * 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 { ChartModel } from '../chart/chart.model';
-import { NumericAxisLabelsGenerator, PriceAxisType } from '../labels_generator/numeric-axis-labels.generator';
+import { DataSeriesModel } from '../../model/data-series.model';
 import { ViewportModel } from '../../model/scaling/viewport.model';
+import { NumericAxisLabelsGenerator, PriceAxisType } from '../labels_generator/numeric-axis-labels.generator';
 /**
  * Y axis labels generator for prices. Respects price increment from instrument.
  */
 export declare class NumericYAxisLabelsGenerator extends NumericAxisLabelsGenerator {
-    private chartModel;
-    constructor(increment: number | null, chartModel: ChartModel | undefined, viewportModel: ViewportModel, valueFormatter: (value: number) => string, axisTypeProvider?: () => PriceAxisType, baseLineProvider?: () => number, singleLabelHeightPixels?: number);
+    private dataSeriesProvider;
+    constructor(increment: number | null, dataSeriesProvider: () => DataSeriesModel | undefined, viewportModel: ViewportModel, valueFormatter: (value: number) => string, axisTypeProvider?: () => PriceAxisType, singleLabelHeightPixels?: number);
     getLargestLabel(): string;
     /**
      * Calculates the increment to be used on the chart axis based on the length of the value and the instrument's price increments.

package/dist/chart/components/y_axis/numeric-y-axis-labels.generator.js

@@ -3,4 +3,36 @@
  * 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{PriceIncrementsUtils as i}from"../../utils/price-increments.utils";import{NumericAxisLabelsGenerator as l}from"../labels_generator/numeric-axis-labels.generator";import{lastOf as o}from"../../utils/array.utils";export class NumericYAxisLabelsGenerator extends l{constructor(r,t,e,n,s=()=>"regular",c=()=>1,a=23){super(r,()=>[e.yStart,e.yEnd],()=>e.getBounds().height,n,!1,s,c,void 0,a),this.chartModel=t}getLargestLabel(){var r;return((r=this.labelsCache.getLastCachedValue())!==null&&r!==void 0?r:[]).reduce((t,e)=>e.text.length>t.length?e.text:t,"")}calculateIncrement(r){var t;const e=(t=this.chartModel)===null||t===void 0?void 0:t.mainCandleSeries.instrument;if(this.chartModel&&e&&Array.isArray(e.priceIncrements)){const n=o(this.chartModel.getCandles()),s=n&&n.close?n.close:0,c=i.getPriceIncrement(s,e.priceIncrements);return this.adjustIncrementOnAxisType(c)}return super.calculateIncrement(r)}}
+import { lastOf } from '../../utils/array.utils';
+import { precisionsToIncrement } from '../../utils/price-increments.utils';
+import { NumericAxisLabelsGenerator } from '../labels_generator/numeric-axis-labels.generator';
+/**
+ * Y axis labels generator for prices. Respects price increment from instrument.
+ */
+export class NumericYAxisLabelsGenerator extends NumericAxisLabelsGenerator {
+    constructor(increment, dataSeriesProvider, viewportModel, valueFormatter, axisTypeProvider = () => 'regular', singleLabelHeightPixels = 23) {
+        super(increment, () => [viewportModel.yStart, viewportModel.yEnd], () => viewportModel.getBounds().height, valueFormatter, false, axisTypeProvider, () => { var _a, _b; return (_b = (_a = dataSeriesProvider()) === null || _a === void 0 ? void 0 : _a.getBaseline()) !== null && _b !== void 0 ? _b : 1; }, undefined, singleLabelHeightPixels);
+        this.dataSeriesProvider = dataSeriesProvider;
+    }
+    getLargestLabel() {
+        var _a;
+        return ((_a = this.labelsCache.getLastCachedValue()) !== null && _a !== void 0 ? _a : []).reduce((maxLengthText, label) => (label.text.length > maxLengthText.length ? label.text : maxLengthText), '');
+    }
+    /**
+     * Calculates the increment to be used on the chart axis based on the length of the value and the instrument's price increments.
+     * @param {number} valueLength - The length of the value.
+     * @returns {number} - The calculated increment.
+     */
+    calculateIncrement(valueLength) {
+        var _a;
+        const dataSeries = this.dataSeriesProvider();
+        if (dataSeries) {
+            const lastCandle = lastOf(dataSeries.dataPoints);
+            const priceIncrementBasis = (_a = lastCandle === null || lastCandle === void 0 ? void 0 : lastCandle.close) !== null && _a !== void 0 ? _a : 0;
+            const increment = precisionsToIncrement(priceIncrementBasis, dataSeries.pricePrecisions);
+            return this.adjustIncrementOnAxisType(increment);
+        }
+        // auto-generated increment
+        return super.calculateIncrement(valueLength);
+    }
+}

package/dist/chart/components/y_axis/price_labels/data-series-y-axis-labels.provider.d.ts

@@ -3,7 +3,7 @@
  * 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 { ChartConfigComponentsYAxis } from '../../../chart.config';
+import { YAxisConfig } from '../../../chart.config';
 import { BoundsProvider } from '../../../model/bounds.model';
 import { DataSeriesConfig } from '../../../model/data-series.config';
 import { DataSeriesModel } from '../../../model/data-series.model';
@@ -12,8 +12,8 @@ export declare class DataSeriesYAxisLabelsProvider implements YAxisLabelsProvide
     private series;
     private config;
     yAxisBoundsProvider: BoundsProvider;
-    axisState?: ChartConfigComponentsYAxis | undefined;
-    constructor(series: DataSeriesModel, config: DataSeriesConfig, yAxisBoundsProvider: BoundsProvider, axisState?: ChartConfigComponentsYAxis | undefined);
+    axisState?: YAxisConfig | undefined;
+    constructor(series: DataSeriesModel, config: DataSeriesConfig, yAxisBoundsProvider: BoundsProvider, axisState?: YAxisConfig | undefined);
     /**
      * Returns an array of LabelGroup objects that contain VisualYAxisLabel objects.
      * The labels are unordered and are based on the last data series point or the last visual series point, depending on the configuration.

package/dist/chart/components/y_axis/price_labels/data-series-y-axis-labels.provider.js

@@ -3,4 +3,70 @@
  * 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{DEFAULT_DATA_SERIES_PAINT_CONFIG as c}from"../../../model/data-series.config";import{getLabelTextColorByBackgroundColor as d}from"../../../utils/canvas/canvas-text-functions.utils";export class DataSeriesYAxisLabelsProvider{constructor(i,e,s,t){this.series=i,this.config=e,this.yAxisBoundsProvider=s,this.axisState=t}getUnorderedLabels(){if(this.config.visible){const e=this.config.labelLastValue==="series"?this.series.getLastDataSeriesPoint:this.series.getLastVisualSeriesPoint,s=this.yAxisBoundsProvider(),t=this.config.labelMode,a=this.config.labelAppearanceType,o=e();if(o!==void 0){const n=this.series.view.toY(o.close);if(isFinite(n)){const r=this.series.valueFormatter(o.close),l=this.getLabelDrawConfig();return[{labels:[Object.assign({y:n,description:this.series.name,mode:t,labelType:a,labelText:r},l)],axisState:this.axisState,bounds:s}]}}}return[]}getLabelDrawConfig(){var i;const e=this.series.config,t=((i=e.paintConfig[0])!==null&&i!==void 0?i:c).color;return{textColor:d(t,"white","black"),bgColor:t,paddingBottom:e.labelPaddingBottom,paddingEnd:e.labelPaddingEnd,paddingTop:e.labelPaddingTop}}}
+import { DEFAULT_DATA_SERIES_PAINT_CONFIG } from '../../../model/data-series.config';
+import { getLabelTextColorByBackgroundColor } from '../../../utils/canvas/canvas-text-functions.utils';
+export class DataSeriesYAxisLabelsProvider {
+    constructor(series, config, yAxisBoundsProvider, axisState) {
+        this.series = series;
+        this.config = config;
+        this.yAxisBoundsProvider = yAxisBoundsProvider;
+        this.axisState = axisState;
+    }
+    /**
+     * Returns an array of LabelGroup objects that contain VisualYAxisLabel objects.
+     * The labels are unordered and are based on the last data series point or the last visual series point, depending on the configuration.
+     * The labels are formatted using the series value formatter.
+     * The label appearance type and draw configuration are also based on the configuration.
+     * @returns {LabelGroup[]} An array of LabelGroup objects that contain VisualYAxisLabel objects.
+     */
+    getUnorderedLabels() {
+        const visible = this.config.visible;
+        if (visible) {
+            const getLastPointForLabel = this.config.labelLastValue === 'series'
+                ? this.series.getLastDataSeriesPoint
+                : this.series.getLastVisualSeriesPoint;
+            const bounds = this.yAxisBoundsProvider();
+            const mode = this.config.labelMode;
+            const appearanceType = this.config.labelAppearanceType;
+            const lastPoint = getLastPointForLabel();
+            if (lastPoint !== undefined) {
+                const lastPointY = this.series.view.toY(lastPoint.close);
+                if (isFinite(lastPointY)) {
+                    const label = this.series.valueFormatter(lastPoint.close);
+                    const drawConfig = this.getLabelDrawConfig();
+                    return [
+                        {
+                            labels: [
+                                Object.assign({ y: lastPointY, description: this.series.name, mode, labelType: appearanceType, labelText: label }, drawConfig),
+                            ],
+                            axisState: this.axisState,
+                            bounds,
+                        },
+                    ];
+                }
+            }
+        }
+        return [];
+    }
+    /**
+     * Retrieves the `config` object from the `series` object and then retrieves the `paintConfig` object from the `config` object.
+     * If `paintConfig` is null or undefined, it uses the `DEFAULT_DATA_SERIES_PAINT_CONFIG`. It then retrieves the `bgColor`
+     * from the `paintConfig` object and calculates the `textColor` based on the `bgColor` using the `getLabelTextColorByBackgroundColor` function.
+     * Finally, it returns an object with `textColor`, `bgColor`, `paddingBottom`, `paddingEnd`, and `paddingTop` properties.
+     * @returns {YAxisLabelDrawConfig}
+     */
+    getLabelDrawConfig() {
+        var _a;
+        const config = this.series.config;
+        const paintConfig = (_a = config.paintConfig[0]) !== null && _a !== void 0 ? _a : DEFAULT_DATA_SERIES_PAINT_CONFIG;
+        const bgColor = paintConfig.color;
+        const textColor = getLabelTextColorByBackgroundColor(bgColor, 'white', 'black');
+        return {
+            textColor,
+            bgColor,
+            paddingBottom: config.labelPaddingBottom,
+            paddingEnd: config.labelPaddingEnd,
+            paddingTop: config.labelPaddingTop,
+        };
+    }
+}

package/dist/chart/components/y_axis/price_labels/labels-positions-calculator.js

@@ -3,4 +3,59 @@
  * 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{notEmpty as d}from"../../../utils/function.utils";export function calcLabelsYCoordinates(o,a){if(o.filter(t=>t!==null).length<=1)return o.map(t=>t.y);const e=a-2,l=o.map((t,s)=>f(t,s,e)).filter(d).sort(m),i=new Array(l.length);return l.forEach((t,s)=>{if(t===null)return;const n=l[s+1];if(n&&n.top<t.bottom){const b=n.labelWeight-t.labelWeight===1?2:0,r=t.bottom-n.top+b;n.top+=r,n.bottom+=r}i[t.actualIndex]=(t.top+t.bottom)/2}),i}const f=(o,a,e)=>o?{top:o.y-e/2,bottom:o.y+e/2,labelWeight:o.weight,actualIndex:a}:null,m=(o,a)=>{const e=o.top,l=a.top;return e>l?1:e<l||e===l&&o.labelWeight<a.labelWeight?-1:0};
+import { notEmpty } from '../../../utils/function.utils';
+/**
+ * Calculates the Y coordinates for the labels of a chart based on the provided points and label height.
+ * @param {PositionAndWeight[]} points - An array of objects containing the position and weight of each point.
+ * @param {number} labelHeight - The height of the label.
+ * @returns {number[]} An array of Y coordinates for the labels.
+ * @doc-tags tricky
+ */
+export function calcLabelsYCoordinates(points, labelHeight) {
+    if (points.filter(it => it !== null).length <= 1) {
+        return points.map(p => p.y);
+    }
+    const adjustedLabelHeight = labelHeight - 2; // -2 to remove paddings between labels
+    const formattedCoordinates = points
+        .map((point, index) => toLabel(point, index, adjustedLabelHeight))
+        .filter(notEmpty)
+        .sort(sortLabels); // sort labels in ascending order, top -> down
+    const newCoordinates = new Array(formattedCoordinates.length);
+    formattedCoordinates.forEach((current, idx) => {
+        if (current === null) {
+            return;
+        }
+        const next = formattedCoordinates[idx + 1];
+        if (next && next.top < current.bottom) {
+            /**
+             * adjust padding if weight diff is 1, used for countdown label padding
+             * @doc-tags tricky
+             */
+            const paddingAdjust = next.labelWeight - current.labelWeight === 1 ? 2 : 0;
+            const delta = current.bottom - next.top + paddingAdjust;
+            next.top += delta;
+            next.bottom += delta;
+        }
+        newCoordinates[current.actualIndex] = (current.top + current.bottom) / 2;
+    });
+    return newCoordinates;
+}
+const toLabel = (point, index, labelHeight) => point
+    ? {
+        top: point.y - labelHeight / 2,
+        bottom: point.y + labelHeight / 2,
+        labelWeight: point.weight,
+        actualIndex: index,
+    }
+    : null;
+const sortLabels = (a, b) => {
+    const aVal = a.top;
+    const bVal = b.top;
+    if (aVal > bVal) {
+        return 1;
+    }
+    if (aVal < bVal || (aVal === bVal && a.labelWeight < b.labelWeight)) {
+        return -1;
+    }
+    return 0;
+};

package/dist/chart/components/y_axis/price_labels/last-candle-labels.provider.js

@@ -3,4 +3,98 @@
  * 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{getPrimaryLabelTextColor as b}from"../label-color.functions";import{lastOf as d}from"../../../utils/array.utils";import{getLabelTextColorByBackgroundColor as h}from"../../../utils/canvas/canvas-text-functions.utils";export class LastCandleLabelsProvider{constructor(e,o,t,s){this.chartModel=e,this.config=o,this.lastCandleLabelsByChartType=t,this.resolveLabelColorFn=s}getUnorderedLabels(){const e=[];if(this.config.components.yAxis.labels.settings.lastPrice.mode!=="none"){const t=this.getYAxisVisualLabel(this.chartModel.mainCandleSeries),s=t&&Object.assign(Object.assign({},t),this.getLabelDrawConfig(this.chartModel.mainCandleSeries,!0));if(s){const l={labels:[s]},a=this.lastCandleLabelsByChartType[this.config.components.chart.type];a==null||a(l,this.chartModel.mainCandleSeries),e.push(l)}this.chartModel.candleSeries.forEach((l,a)=>{if(a===0)return;const i=this.getYAxisVisualLabel(l),n=i&&Object.assign(Object.assign({},i),this.getLabelDrawConfig(l,!1));if(n){const c={labels:[n]},r=this.lastCandleLabelsByChartType[l.config.type];r==null||r(c,this.chartModel.mainCandleSeries),e.push(c)}})}return e}getYAxisVisualLabel(e){const o=d(e.dataPoints);if(o){const t=e.view.toY(o.close);if(isFinite(t)){const s=this.config.components.yAxis.labels.settings.lastPrice.mode,l=this.config.components.yAxis.labels.settings.lastPrice.type;return{y:t,labelWeight:0,labelText:this.chartModel.pane.valueFormatter(o.close,e),mode:s,labelType:l,description:e.instrument.symbol}}}return null}getLabelDrawConfig(e,o){const t=e.colors.labels,s=this.resolveLabelColorFn(e.config.type),{rectLabelTextColor:l,rectLabelInvertedTextColor:a}=this.chartModel.config.colors.yAxis;let i="#FFFFFF",n="#FFFFFF";return t&&(i=s(e.lastPriceMovement,e.colors),n=o?b(e.lastPriceMovement,t):l),{bgColor:i,textColor:h(i,n,a),rounded:!0}}}
+import { getPrimaryLabelTextColor } from '../label-color.functions';
+import { lastOf } from '../../../utils/array.utils';
+import { getLabelTextColorByBackgroundColor } from '../../../utils/canvas/canvas-text-functions.utils';
+export class LastCandleLabelsProvider {
+    constructor(chartModel, config, lastCandleLabelsByChartType, resolveLabelColorFn) {
+        this.chartModel = chartModel;
+        this.config = config;
+        this.lastCandleLabelsByChartType = lastCandleLabelsByChartType;
+        this.resolveLabelColorFn = resolveLabelColorFn;
+    }
+    /**
+     * Returns an array of LabelGroup objects that contain the labels for the yAxis of the chart.
+     * @returns {LabelGroup[]} An array of LabelGroup objects that contain the labels for the yAxis of the chart.
+     */
+    getUnorderedLabels() {
+        const collectedLabels = [];
+        const visible = this.config.components.yAxis.labels.settings.lastPrice.mode !== 'none';
+        if (visible) {
+            // main candle series
+            const yAxisVisualLabel = this.getYAxisVisualLabel(this.chartModel.mainCandleSeries);
+            const mainCandleSeriesVisualLabel = yAxisVisualLabel
+                ? Object.assign(Object.assign({}, yAxisVisualLabel), this.getLabelDrawConfig(this.chartModel.mainCandleSeries, true)) : yAxisVisualLabel;
+            if (mainCandleSeriesVisualLabel) {
+                const mainCandleSeriesLabels = { labels: [mainCandleSeriesVisualLabel] };
+                const handler = this.lastCandleLabelsByChartType[this.config.components.chart.type];
+                handler === null || handler === void 0 ? void 0 : handler(mainCandleSeriesLabels, this.chartModel.mainCandleSeries);
+                collectedLabels.push(mainCandleSeriesLabels);
+            }
+            // compare candle series
+            this.chartModel.candleSeries.forEach((series, index) => {
+                if (index === 0) {
+                    return;
+                }
+                const yAxisVisualLabel = this.getYAxisVisualLabel(series);
+                const secondarySeriesVisualLabel = yAxisVisualLabel
+                    ? Object.assign(Object.assign({}, yAxisVisualLabel), this.getLabelDrawConfig(series, false)) : yAxisVisualLabel;
+                if (secondarySeriesVisualLabel) {
+                    const secondarySeriesLabel = {
+                        labels: [secondarySeriesVisualLabel],
+                    };
+                    const handler = this.lastCandleLabelsByChartType[series.config.type];
+                    handler === null || handler === void 0 ? void 0 : handler(secondarySeriesLabel, this.chartModel.mainCandleSeries);
+                    collectedLabels.push(secondarySeriesLabel);
+                }
+            });
+        }
+        return collectedLabels;
+    }
+    /**
+     * Returns the visual label for the Y axis of a candle series.
+     * @param {CandleSeriesModel} series - The candle series model.
+     * @returns {Omit<VisualYAxisLabel, 'bgColor'> | null} - The visual label for the Y axis or null if there is no data.
+     */
+    getYAxisVisualLabel(series) {
+        const lastCandle = lastOf(series.dataPoints);
+        if (lastCandle) {
+            const y = series.view.toY(lastCandle.close);
+            if (isFinite(y)) {
+                const mode = this.config.components.yAxis.labels.settings.lastPrice.mode;
+                const appearanceType = this.config.components.yAxis.labels.settings.lastPrice.type;
+                return {
+                    y,
+                    labelWeight: 0,
+                    labelText: this.chartModel.pane.valueFormatter(lastCandle.close, series),
+                    mode,
+                    labelType: appearanceType,
+                    description: series.instrument.symbol,
+                };
+            }
+        }
+        return null;
+    }
+    /**
+     * Returns the configuration object for drawing the label of the Y-axis.
+     * @param {CandleSeriesModel} series - The series model for which the label configuration is to be returned.
+     * @param {boolean} primary - A boolean value indicating whether the label is primary or not.
+     * @returns {YAxisLabelDrawConfig} - The configuration object for drawing the label of the Y-axis.
+     */
+    getLabelDrawConfig(series, primary) {
+        const colors = series.colors.labels;
+        const getLabelBoxColor = this.resolveLabelColorFn(series.config.type);
+        const { rectLabelTextColor, rectLabelInvertedTextColor } = this.chartModel.config.colors.yAxis;
+        let boxColor = '#FFFFFF';
+        let textColor = '#FFFFFF';
+        if (colors) {
+            boxColor = getLabelBoxColor(series.lastPriceMovement, series.colors);
+            textColor = primary ? getPrimaryLabelTextColor(series.lastPriceMovement, colors) : rectLabelTextColor;
+        }
+        return {
+            bgColor: boxColor,
+            textColor: getLabelTextColorByBackgroundColor(boxColor, textColor, rectLabelInvertedTextColor),
+            rounded: true,
+        };
+    }
+}

package/dist/chart/components/y_axis/price_labels/price-label.drawer.d.ts

@@ -4,7 +4,7 @@
  * If a copy of the MPL was not distributed with this file, You can obtain one at https://mozilla.org/MPL/2.0/.
  */
 import { CanvasBoundsContainer } from '../../../canvas/canvas-bounds-container';
-import { ChartConfigComponentsYAxis, FullChartColors, YAxisLabelAppearanceType } from '../../../chart.config';
+import { YAxisConfig, FullChartColors, YAxisLabelAppearanceType } from '../../../chart.config';
 import { Bounds } from '../../../model/bounds.model';
 import { drawBadgeLabel, drawPlainLabel, drawRectLabel } from '../y-axis-labels.drawer';
 import { VisualYAxisLabel, YAxisVisualLabelType } from './y-axis-labels.model';
@@ -19,5 +19,5 @@ export declare const priceLabelDrawersMap: Record<YAxisVisualLabelType, LabelDra
  * @param canvasBoundsContainer
  * @param config
  */
-export declare function drawLabel(ctx: CanvasRenderingContext2D, backgroundCtx: CanvasRenderingContext2D, bounds: Bounds, paneBounds: Bounds, visualLabel: VisualYAxisLabel, canvasBoundsContainer: CanvasBoundsContainer, config: ChartConfigComponentsYAxis, colors: FullChartColors['yAxis']): void;
+export declare function drawLabel(ctx: CanvasRenderingContext2D, backgroundCtx: CanvasRenderingContext2D, bounds: Bounds, paneBounds: Bounds, visualLabel: VisualYAxisLabel, canvasBoundsContainer: CanvasBoundsContainer, config: YAxisConfig, colors: FullChartColors['yAxis']): void;
 export {};