@devexperts/dxcharts-lite 1.0.1

package/dist/chart/components/y_axis/price_labels/price-label.drawer.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{CanvasElement as V,CHART_UUID as q}from"../../../canvas/canvas-bounds-container";import{getFontFromConfig as I}from"../../../chart.config";import{redrawBackgroundArea as z}from"../../../drawers/chart-background.drawer";import{avoidAntialiasing as J,drawLine as K}from"../../../utils/canvas/canvas-drawing-functions.utils";import{calculateSymbolHeight as N,calculateTextWidth as R}from"../../../utils/canvas/canvas-font-measure-tool.utils";import{floor as O}from"../../../utils/math.utils";import{drawBadgeLabel as Q,drawPlainLabel as Z,drawRectLabel as $}from"../y-axis-labels.drawer";export const DEFAULT_LABEL_APPEARANCE_TYPE="badge";const X=4;export const priceLabelDrawersMap={badge:Q,rectangle:$,plain:Z};export function drawLabel(o,n,e,m,t,B,l,_){var s,d,c,r,a;const p=t.y,f=t.labelText,T=(s=t.mode)!==null&&s!==void 0?s:"label",x=(d=t.labelType)!==null&&d!==void 0?d:DEFAULT_LABEL_APPEARANCE_TYPE,g=t.description,A=(c=t.textFont)!==null&&c!==void 0?c:I(l),w=t.bgColor,b=(r=t.lineColor)!==null&&r!==void 0?r:w,h=R(g!=null?g:"",o,A)+8,D=O(t.y),y=N(A,o),E=p-y/2,j=p+y/2-E;o.save(),o.fillStyle=w,o.strokeStyle=b;const i=B.getBounds(V.PANE_UUID(q)),G=priceLabelDrawersMap[x],C=l.labels.descriptions,M=v(e,D,j),Y=()=>C&&L(n,o,e,m,t,l.align,l);let F,P;const U=2;l.align==="right"?(F=i.x,P=C?i.x+i.width-h:i.x+i.width+U):(F=C?i.x+h:i.x-U,P=i.x+i.width);const k=(a=t.lineY)!==null&&a!==void 0?a:t.y,H=()=>M&&J(o,()=>K(o,F,k,P,k,1)),W=()=>G(o,e,f,p,t,l,_,!1,n);switch(T){case"line":H(),Y();break;case"line-label":H(),Y(),W();break;case"label":Y(),W();break;case"none":break}o.restore()}const v=(o,n,e)=>n>o.y+e/2&&n<o.y+o.height-e/2;function L(o,n,e,m,t,B="right",l){var _,s,d;const c=t.description;if(!c||c.length===0)return;const r=t.y,a=I(l),p=R(c,n,a),f=N(a,n),T=(_=t.paddingTop)!==null&&_!==void 0?_:X,x=(s=t.paddingBottom)!==null&&s!==void 0?s:X,g=r-f/2-T,w=r+f/2+x-g;if(r<e.y+w/2||r>e.y+e.height-w/2)return;n.save();const b=p+5,h=4,D=p+h*2,y=m.x+m.width,E=B==="right"?y-D:m.x+h;z(o,n,E,g,b,w,.8),n.fillStyle=(d=t.descColor)!==null&&d!==void 0?d:t.bgColor,n.font=a;const S=B==="right"?y-p-h*2:m.x+h*2;n.fillText(c,S,r+f/2-1),n.restore()}

package/dist/chart/components/y_axis/price_labels/y-axis-labels.model.d.ts

@@ -0,0 +1,159 @@
+/*
+ * 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 } from 'rxjs';
+import { CanvasBoundsContainer } from '../../../canvas/canvas-bounds-container';
+import { ChartConfigComponentsYAxis, FullChartConfig, YAxisLabelMode } from '../../../chart.config';
+import EventBus from '../../../events/event-bus';
+import { Bounds } from '../../../model/bounds.model';
+import { CanvasModel } from '../../../model/canvas.model';
+import { ChartBaseElement } from '../../../model/chart-base-element';
+import { Unit } from '../../../model/scaling/viewport.model';
+import { ChartModel } from '../../chart/chart.model';
+import { YAxisLabelDrawConfig } from '../y-axis-labels.drawer';
+export type YAxisVisualLabelType = 'badge' | 'rectangle' | 'plain';
+export interface VisualYAxisLabel extends YAxisLabelDrawConfig {
+    y: Unit;
+    labelText: string;
+    mode?: YAxisLabelMode;
+    labelType?: YAxisVisualLabelType;
+    lineY?: number;
+    labelWeight?: number;
+    description?: string;
+    subGroupId?: number;
+}
+export interface LabelGroup {
+    labels: VisualYAxisLabel[];
+    bounds?: Bounds;
+    axisState?: ChartConfigComponentsYAxis;
+}
+export type ProviderGroups = Record<string, YAxisLabelsProvider[]>;
+export declare const LabelsGroups: {
+    readonly MAIN: "MAIN";
+};
+/**
+ * Different labels on Y axis:
+ * - last candle price
+ * - bid/ask
+ * - countdown
+ * - prev.day price
+ * - high low in viewport
+ * - drawings
+ * - studies
+ * - ...
+ * Anything but the base labels which are generated in other component {@link YAxisBaseLabelsModel}
+ */
+export declare class YAxisLabelsModel extends ChartBaseElement {
+    eventBus: EventBus;
+    private chartModel;
+    private canvasBoundsContainer;
+    private config;
+    private canvasModel;
+    private updateYAxisWidth;
+    orderedLabels: LabelGroup[];
+    /**
+     * an easier way to manage custom y-axis labels, than y-axis labels providers, but doesn't support overlapping avoidance
+     */
+    readonly customLabels: Record<string, VisualYAxisLabel>;
+    private labelsProviders;
+    private labelsPositionRecalculatedSubject;
+    private animFrameId;
+    constructor(eventBus: EventBus, chartModel: ChartModel, canvasBoundsContainer: CanvasBoundsContainer, config: FullChartConfig, canvasModel: CanvasModel, updateYAxisWidth: () => void);
+    /**
+     * This method is used to activate the chart and subscribe to the observables that will trigger the update of the labels.
+     * It calls the parent method doActivate() and adds a new Rx subscription to the merge of the following observables:
+     * - chartModel.observeCandlesChanged()
+     * - canvasBoundsContainer.observeBoundsChanged(CanvasElement.CHART)
+     * - chartModel.nextCandleTimeStampSubject
+     * - canvasBoundsContainer.barResizerChangedSubject
+     * - chartModel.scaleModel.changed
+     * When any of these observables emit a new value, the updateLabels() method is called.
+     * @protected
+     */
+    protected doActivate(): void;
+    /**
+     * Initializes the model by calling the methods to initialize the label groups and recalculate the labels.
+     * Then, it fires the draw event on the canvas model.
+     * @private
+     */
+    private initModel;
+    /**
+     * Initializes the labels groups.
+     * If there are labels providers, it creates a group for each one and adds the providers to their respective groups.
+     * @returns {void}
+     */
+    private initLabelsGroups;
+    /**
+     * Updates YAxis ordered labels.
+     * @param adjustYAxisWidth - provide "true", if you need to adjust width after new labels will be calculated.
+     */
+    updateLabels(adjustYAxisWidth?: boolean): void;
+    /**
+     * Recalculates the labels based on the current configuration and label providers.
+     * It generates label groups and calculates their coordinates based on their weight and the label height.
+     * The coordinates are generated in the order they were passed to the generator.
+     * The ordered labels are then updated with the new coordinates and reversed.
+     * @returns {void}
+     */
+    recalculateLabels(): void;
+    /**
+     * Creates a new group with the given name if it doesn't exist yet.
+     * @param {string} groupName - The name of the group to be created.
+     * @returns {void}
+     */
+    private createGroup;
+    /**
+     * Adds a YAxisLabelsProvider component to a group.
+     *
+     * @param {YAxisLabelsProvider} component - The component to add to the group.
+     * @param {string} groupName - The name of the group to add the component to.
+     * @param {string} id - The id of the component to add to the group.
+     * @returns {void}
+     */
+    private addToGroup;
+    /**
+     * Updates the coordinates of the labels in a LabelGroup object based on an array of points.
+     * @param {LabelGroup} labels - The LabelGroup object containing the labels to be updated.
+     * @param {number[]} points - An array of points to be used to update the y-coordinate of each label.
+     * @returns {LabelGroup} - A new LabelGroup object with updated label coordinates.
+     */
+    private updateLabelsCoordinates;
+    /**
+     * Returns an Observable that emits a void value whenever the labels position is recalculated.
+     * The Observable is created from the labelsPositionRecalculatedSubject Subject.
+     * @returns {Observable<void>} An Observable that emits a void value whenever the labels position is recalculated.
+     */
+    observeLabelsPositionsRecalculated(): Observable<void>;
+    /**
+     * Registers a Y axis labels provider for a given group name and ID.
+     *
+     * @param {string} groupName - The name of the group to which the provider belongs.
+     * @param {YAxisLabelsProvider} provider - The provider to be registered.
+     * @param {string} id - The ID of the provider to be registered.
+     * @returns {void}
+     */
+    registerYAxisLabelsProvider(groupName: string, provider: YAxisLabelsProvider, id: string): void;
+    /**
+     * Unregisters a Y axis labels provider.
+     *
+     * @param {string} groupName - The name of the group to which the provider belongs.
+     * @param {string} id - The ID of the provider to unregister.
+     *
+     * @returns {void}
+     */
+    unregisterYAxisLabelsProvider(groupName: string, id: string): void;
+}
+/**
+ * YAxisLabelsProvider interface used to write price labels providers
+ * for YAxisLabelsModel.
+ * Under the hood, YAxisLabelsModel calls Provider.getUnorderedLabels method
+ * on each provider, and generates Y coordinates for each label
+ * according to non-overlapping condition
+ * Then, with the info which was got from the Providers and Y coordinates
+ * follows the draw cycle of labels
+ */
+export interface YAxisLabelsProvider {
+    readonly getUnorderedLabels: () => LabelGroup[];
+}

package/dist/chart/components/y_axis/price_labels/y-axis-labels.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{merge as h,Subject as b}from"rxjs";import{CanvasElement as c,CHART_UUID as v}from"../../../canvas/canvas-bounds-container";import{ChartBaseElement as u}from"../../../model/chart-base-element";import{animationFrameThrottledPrior as p}from"../../../utils/perfomance/request-animation-frame-throttle.utils";import{uuid as m}from"../../../utils/uuid.utils";import{calcLabelsYCoordinates as f}from"./labels-positions-calculator";import{flat as d}from"../../../utils/array.utils";export const LabelsGroups={MAIN:"MAIN"};export class YAxisLabelsModel extends u{constructor(e,s,t,i,r,l){super(),this.eventBus=e,this.chartModel=s,this.canvasBoundsContainer=t,this.config=i,this.canvasModel=r,this.updateYAxisWidth=l,this.orderedLabels=[],this.customLabels={},this.labelsProviders={},this.labelsPositionRecalculatedSubject=new b,this.animFrameId=`anim_cache_${m()}`,this.initModel()}doActivate(){super.doActivate(),this.addRxSubscription(h(this.chartModel.observeCandlesChanged(),this.canvasBoundsContainer.observeBoundsChanged(c.PANE_UUID(v)),this.chartModel.nextCandleTimeStampSubject,this.canvasBoundsContainer.barResizerChangedSubject,this.chartModel.scaleModel.changed).subscribe(()=>{this.updateLabels()}))}initModel(){this.initLabelsGroups(),this.recalculateLabels(),this.canvasModel.fireDraw()}initLabelsGroups(){if(Object.keys(this.labelsProviders).length!==0)for(const e of Object.keys(this.labelsProviders))this.createGroup(e),Object.entries(this.labelsProviders[e]).forEach(([s,t])=>{this.addToGroup(t,e,s)})}updateLabels(e=!1){this.recalculateLabels(),p(this.animFrameId,()=>{e&&this.updateYAxisWidth(),this.canvasModel.fireDraw()})}recalculateLabels(){var e,s;this.orderedLabels=[];const t=this.config.components.yAxis.fontSize+((e=this.config.components.yAxis.labelBoxMargin.top)!==null&&e!==void 0?e:0)+((s=this.config.components.yAxis.labelBoxMargin.bottom)!==null&&s!==void 0?s:0);for(const i of Object.values(this.labelsProviders)){const r=d(Object.values(i).map(a=>a.getUnorderedLabels())),l=d(r.map(a=>a.labels)).map(a=>{var o;return{y:a.y,weight:(o=a.labelWeight)!==null&&o!==void 0?o:Number.POSITIVE_INFINITY}}),n=f(l,t);r.forEach(a=>{const o=n.splice(0,a.labels.length);this.orderedLabels.push(this.updateLabelsCoordinates(a,o))})}this.orderedLabels=this.orderedLabels.reverse()}createGroup(e){!this.labelsProviders[e]&&(this.labelsProviders[e]={})}addToGroup(e,s,t){this.labelsProviders[s]&&(Object.values(this.labelsProviders[s]).includes(e)||(this.labelsProviders[s][t]=e))}updateLabelsCoordinates(e,s){return Object.assign(Object.assign({},e),{labels:e.labels.map((t,i)=>Object.assign(Object.assign({},t),{lineY:t.y,y:s[i]}))})}observeLabelsPositionsRecalculated(){return this.labelsPositionRecalculatedSubject.asObservable()}registerYAxisLabelsProvider(e,s,t){var i;const r=(i=this.labelsProviders[e])!==null&&i!==void 0?i:{};r[t]=s,this.labelsProviders[e]=r,this.initModel()}unregisterYAxisLabelsProvider(e,s){var t;const i=(t=this.labelsProviders[e])!==null&&t!==void 0?t:{};delete i[s],this.labelsProviders[e]&&Object.keys(this.labelsProviders[e]).length===0&&delete this.labelsProviders[e],this.initModel()}}

package/dist/chart/components/y_axis/price_labels/y-axis-price-labels.drawer.d.ts

@@ -0,0 +1,23 @@
+/*
+ * 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 { CanvasBoundsContainer } from '../../../canvas/canvas-bounds-container';
+import { ChartConfigComponentsYAxis, FullChartColors } from '../../../chart.config';
+import { Drawer } from '../../../drawers/drawing-manager';
+import { CanvasModel } from '../../../model/canvas.model';
+import { LabelGroup, VisualYAxisLabel } from './y-axis-labels.model';
+export declare class YAxisPriceLabelsDrawer implements Drawer {
+    private labelsProvider;
+    private yAxisLabelsCanvasModel;
+    private backgroundCanvasModel;
+    private yAxisState;
+    private canvasBoundsContainer;
+    private yAxisColors;
+    private readonly customLabels;
+    constructor(labelsProvider: () => LabelGroup[], yAxisLabelsCanvasModel: CanvasModel, backgroundCanvasModel: CanvasModel, yAxisState: ChartConfigComponentsYAxis, canvasBoundsContainer: CanvasBoundsContainer, yAxisColors: FullChartColors['yAxis'], customLabels: Record<string, VisualYAxisLabel>);
+    draw(): void;
+    drawHighlightedBackgroundBetweenLabels(): void;
+    getCanvasIds(): Array<string>;
+}

package/dist/chart/components/y_axis/price_labels/y-axis-price-labels.drawer.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{CanvasElement as c,CHART_UUID as h,limitYToBounds as u}from"../../../canvas/canvas-bounds-container";import{fillRect as C}from"../../../utils/canvas/canvas-drawing-functions.utils";import{drawLabel as b}from"./price-label.drawer";export class YAxisPriceLabelsDrawer{constructor(t,d,e,i,r,o,a){this.labelsProvider=t,this.yAxisLabelsCanvasModel=d,this.backgroundCanvasModel=e,this.yAxisState=i,this.canvasBoundsContainer=r,this.yAxisColors=o,this.customLabels=a}draw(){const t=this.yAxisLabelsCanvasModel.ctx,d=this.backgroundCanvasModel.ctx,e=this.canvasBoundsContainer.getBounds(c.PANE_UUID_Y_AXIS(h)),i=this.canvasBoundsContainer.getBounds(c.ALL_PANES);this.drawHighlightedBackgroundBetweenLabels(),this.labelsProvider().forEach(o=>{var a;const l=(a=o.bounds)!==null&&a!==void 0?a:e;o.labels.forEach(s=>{var n;return b(t,d,l,i,s,this.canvasBoundsContainer,(n=o.axisState)!==null&&n!==void 0?n:this.yAxisState,this.yAxisColors)})}),Object.values(this.customLabels).forEach(o=>b(t,d,e,i,o,this.canvasBoundsContainer,this.yAxisState,this.yAxisColors))}drawHighlightedBackgroundBetweenLabels(){const t=this.yAxisLabelsCanvasModel.ctx,d=this.labelsProvider(),e={};d.forEach(i=>{i.labels.forEach(r=>{var o,a,l;if(r.subGroupId){const s=(o=e[r.subGroupId])!==null&&o!==void 0?o:[];if(e[r.subGroupId]=s,s.push(r),s.length===2){const n=(a=i.bounds)!==null&&a!==void 0?a:this.canvasBoundsContainer.getBounds(c.PANE_UUID_Y_AXIS(h));t.save(),t.fillStyle=(l=s[0].highlightColor)!==null&&l!==void 0?l:s[0].bgColor;const[v,x]=s[0].y>s[1].y?[s[1].y,s[0].y]:[s[0].y,s[1].y];C(t,{x:n.x,y:u(v,n)},{x:n.x+n.width-6,y:u(x,n)}),t.restore()}}})})}getCanvasIds(){return[this.yAxisLabelsCanvasModel.canvasId]}}

package/dist/chart/components/y_axis/y-axis-base-labels.model.d.ts

@@ -0,0 +1,31 @@
+/*
+ * 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 { NumericAxisLabel, NumericAxisLabelsGenerator } from '../labels_generator/numeric-axis-labels.generator';
+import { CanvasBoundsContainer } from '../../canvas/canvas-bounds-container';
+import { ChartBaseElement } from '../../model/chart-base-element';
+import { ScaleModel } from '../../model/scale.model';
+export declare class YAxisBaseLabelsModel extends ChartBaseElement {
+    private scaleModel;
+    private yAxisLabelsGenerator;
+    private canvasBoundsContainer;
+    labels: Array<NumericAxisLabel>;
+    private prevYAxisHeight;
+    private animFrameId;
+    constructor(scaleModel: ScaleModel, yAxisLabelsGenerator: NumericAxisLabelsGenerator, canvasBoundsContainer: CanvasBoundsContainer);
+    /**
+     * This method is used to activate the component. It calls the parent's doActivate method and subscribes to the merge of two observables:
+     * - this.scaleModel.yChanged
+     * - this.canvasBoundsContainer.observeBoundsChanged
+     * The merge of these two observables is used to update the labels of the component when either the y-axis scale model changes or the canvas bounds change.
+     * If the height of the canvas bounds changes by more than 1.5 times the previous height, the labels cache is invalidated and the previous y-axis height is updated.
+     */
+    protected doActivate(): void;
+    /**
+     * Updates the labels of the chart's y-axis by generating new numeric labels using the yAxisLabelsGenerator object.
+     * Then, it calls the updateYAxisWidth method to update the width of the y-axis.
+     */
+    updateLabels(): void;
+}

package/dist/chart/components/y_axis/y-axis-base-labels.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{merge as t}from"rxjs";import{filter as a,map as r,tap as o}from"rxjs/operators";import{CanvasElement as n}from"../../canvas/canvas-bounds-container";import{ChartBaseElement as h}from"../../model/chart-base-element";import{uuid as m}from"../../utils/uuid.utils";import{animationFrameThrottledPrior as l}from"../../utils/perfomance/request-animation-frame-throttle.utils";import{isDiffersBy as d}from"../../utils/math.utils";export class YAxisBaseLabelsModel extends h{constructor(e,s,i){super(),this.scaleModel=e,this.yAxisLabelsGenerator=s,this.canvasBoundsContainer=i,this.labels=[],this.prevYAxisHeight=0,this.animFrameId=`anim_cache_${m()}`}doActivate(){super.doActivate(),this.addRxSubscription(t(this.scaleModel.yChanged,this.canvasBoundsContainer.observeBoundsChanged(n.Y_AXIS).pipe(r(e=>e.height),a(e=>d(e,this.prevYAxisHeight,1.5)),o(e=>{this.yAxisLabelsGenerator.labelsCache.invalidate(),this.prevYAxisHeight=e}))).subscribe(()=>this.updateLabels()))}updateLabels(){this.labels=this.yAxisLabelsGenerator.generateNumericLabels(),l(this.animFrameId,()=>this.canvasBoundsContainer.updateYAxisWidths())}}

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

@@ -0,0 +1,70 @@
+/*
+ * 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 { ChartConfigComponentsYAxis, FullChartColors } from '../../chart.config';
+import { Bounds } from '../../model/bounds.model';
+export interface YAxisLabelDrawProps {
+    ctx: CanvasRenderingContext2D;
+    bounds: Bounds;
+    text: string;
+    centralY: number;
+    config: YAxisLabelDrawConfig;
+    subGroupId?: number;
+}
+export interface YAxisLabelDrawConfig {
+    textFont?: string;
+    textColor?: string;
+    bgColor: string;
+    highlightColor?: string;
+    descColor?: string;
+    lineColor?: string;
+    paddingTop?: number;
+    paddingBottom?: number;
+    paddingEnd?: number;
+    paddingStart?: number;
+    rounded?: boolean;
+}
+export declare const DEFAULT_PRICE_LABEL_PADDING = 4;
+/**
+ * Draws badge label on Y axis with provided parameters.
+ * @param ctx - canvas 2D context to draw on
+ * @param bounds - bounds of Y axis
+ * @param text - text to draw
+ * @param centralY - y
+ * @param config - label styles config
+ * @param align
+ * @param yAxisState
+ */
+export declare function drawBadgeLabel(ctx: CanvasRenderingContext2D, bounds: Bounds, text: string, centralY: number, config: YAxisLabelDrawConfig, yAxisState: ChartConfigComponentsYAxis, yAxisColors: FullChartColors['yAxis'], drawOutside?: boolean): void;
+/**
+ * Draws rectangle label on Y axis with provided parameters.
+ * @param ctx - canvas 2D context to draw on
+ * @param bounds - bounds of Y axis
+ * @param text - text to draw
+ * @param centralY - y
+ * @param config - label styles config
+ * @param align
+ * @param yAxisState
+ */
+export declare function drawRectLabel(ctx: CanvasRenderingContext2D, bounds: Bounds, text: string, centralY: number, config: YAxisLabelDrawConfig, yAxisState: ChartConfigComponentsYAxis, yAxisColors: FullChartColors['yAxis'], drawOutside?: boolean): void;
+/**
+ * Draws rectangle label on Y axis with provided parameters but with transparent background.
+ * @param ctx - canvas 2D context to draw on
+ * @param bounds - bounds of Y axis
+ * @param text - text to draw
+ * @param centralY - y
+ * @param config - label styles config
+ * @param align
+ * @param yAxisState
+ */
+export declare function drawPlainLabel(ctx: CanvasRenderingContext2D, bounds: Bounds, text: string, centralY: number, config: YAxisLabelDrawConfig, yAxisState: ChartConfigComponentsYAxis, yAxisColors: FullChartColors['yAxis'], drawOutside?: boolean, backgroundCtx?: CanvasRenderingContext2D): void;
+/**
+ * Offset from the center of label to the top/bottom.
+ *
+ * @param font Label font
+ * @param ctx Drawing context
+ * @param paddingTop - extra padding from top
+ */
+export declare function getLabelYOffset(font: string, ctx: CanvasRenderingContext2D, paddingTop?: number): number;

package/dist/chart/components/y_axis/y-axis-labels.drawer.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{getFontFromConfig as M}from"../../chart.config";import{redrawBackgroundArea as q}from"../../drawers/chart-background.drawer";import{drawPriceLabel as z,drawRoundedRect as J}from"../../utils/canvas/canvas-drawing-functions.utils";import{calculateSymbolHeight as D,calculateTextWidth as X}from"../../utils/canvas/canvas-font-measure-tool.utils";import{getLabelTextColorByBackgroundColor as j}from"../../utils/canvas/canvas-text-functions.utils";import{round as G}from"../../utils/math.utils";export const DEFAULT_PRICE_LABEL_PADDING=4;export function drawBadgeLabel(o,t,m,n,l,d,b,R=!1){var _,a,g,p,v,h,s;const r=d.align,f=(_=l.textFont)!==null&&_!==void 0?_:M(d),B=l.bgColor,E=(a=l.textColor)!==null&&a!==void 0?a:j(B,b.labelTextColor,b.labelInvertedTextColor),F=(g=l.paddingTop)!==null&&g!==void 0?g:DEFAULT_PRICE_LABEL_PADDING,x=(p=l.paddingBottom)!==null&&p!==void 0?p:DEFAULT_PRICE_LABEL_PADDING,L=(v=l.paddingEnd)!==null&&v!==void 0?v:DEFAULT_PRICE_LABEL_PADDING,i=G(D(f,o)/2),e=n-i-F,C=n+i+x-e;if((n<t.y+C/2||n>t.y+t.height-C/2)&&!R)return;o.save(),o.fillStyle=B,o.strokeStyle=B;const c=G(t.width/6),u=r==="right"?t.x:t.x+t.width,w=r==="right"?u+c:u-c,H=d.labelBoxMargin.end,k=H-L,T=t.width-c-k;z(o,w,e,u,e+G(C/2),w,e+C,T,(s=(h=d.typeConfig.badge)===null||h===void 0?void 0:h.rounded)!==null&&s!==void 0?s:!1,r),o.fillStyle=E,o.font=f;const I=r==="right"?t.x+t.width-X(m,o,f)-H:t.x+H;o.fillText(m,I,n+i-1),o.restore()}export function drawRectLabel(o,t,m,n,l,d,b,R=!1){var _,a,g,p,v,h,s,r,f,B,E;const F=d.align,x=(_=l.textFont)!==null&&_!==void 0?_:M(d),L=l.bgColor,i=(a=l.textColor)!==null&&a!==void 0?a:j(L,b.labelTextColor,b.labelInvertedTextColor),e=(g=d.typeConfig.rectangle)===null||g===void 0?void 0:g.paddings,W=(v=(p=l.paddingTop)!==null&&p!==void 0?p:e==null?void 0:e.top)!==null&&v!==void 0?v:DEFAULT_PRICE_LABEL_PADDING,C=(s=(h=l.paddingBottom)!==null&&h!==void 0?h:e==null?void 0:e.bottom)!==null&&s!==void 0?s:DEFAULT_PRICE_LABEL_PADDING,c=(f=(r=l.paddingEnd)!==null&&r!==void 0?r:e==null?void 0:e.end)!==null&&f!==void 0?f:DEFAULT_PRICE_LABEL_PADDING,u=l.paddingStart,w=D(x,o),H=n-w/2-W,T=n+w/2+C-H,I=(B=l.rounded)!==null&&B!==void 0?B:(E=d.typeConfig.rectangle)===null||E===void 0?void 0:E.rounded;if((n<t.y+T/2||n>t.y+t.height-T/2)&&!R)return;o.save(),o.fillStyle=L,o.strokeStyle=L;const y=d.labelBoxMargin.end;o.font=x;const O=X(m,o,x),P=y-c,S=u!==void 0?O+u+c:t.width-P,N=F==="right"?t.x+t.width-P-S:t.x+P,U=F==="right"?t.x+t.width-O-y:y;I?J(o,N,H,S,T,4,!0):o.fillRect(N,H,S,T),o.fillStyle=i,o.fillText(m,U,n+w/2-1),o.restore()}export function drawPlainLabel(o,t,m,n,l,d,b,R=!1,_){var a,g,p,v,h,s,r,f,B;const E=d.align,F=(a=l.textFont)!==null&&a!==void 0?a:M(d),x=l.bgColor,L=(g=l.textColor)!==null&&g!==void 0?g:j(x,b.labelTextColor,b.labelInvertedTextColor),i=(p=d.typeConfig.rectangle)===null||p===void 0?void 0:p.paddings,e=(h=(v=l.paddingTop)!==null&&v!==void 0?v:i==null?void 0:i.top)!==null&&h!==void 0?h:DEFAULT_PRICE_LABEL_PADDING,W=(r=(s=l.paddingBottom)!==null&&s!==void 0?s:i==null?void 0:i.bottom)!==null&&r!==void 0?r:DEFAULT_PRICE_LABEL_PADDING,C=(B=(f=l.paddingEnd)!==null&&f!==void 0?f:i==null?void 0:i.end)!==null&&B!==void 0?B:DEFAULT_PRICE_LABEL_PADDING,c=l.paddingStart,u=D(F,o),w=n-u/2-e,k=n+u/2+W-w;if((n<t.y+k/2||n>t.y+t.height-k/2)&&!R)return;o.save(),o.fillStyle=x,o.strokeStyle=x;const T=d.labelBoxMargin.end;o.font=F;const I=X(m,o,F),y=T-C,O=c!==void 0?I+c+C:t.width-y,P=E==="right"?t.x+t.width-y-O:t.x+y,S=E==="right"?t.x+t.width-I-T:T;_&&q(_,o,P,w,O,k),o.fillStyle=L,o.fillText(m,S,n+u/2-1),o.restore()}export function getLabelYOffset(o,t,m=DEFAULT_PRICE_LABEL_PADDING){return D(o,t)/2+m}

package/dist/chart/components/y_axis/y-axis-scale.handler.d.ts

@@ -0,0 +1,32 @@
+/*
+ * 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 } from 'rxjs';
+import { CanvasBoundsContainer, HitBoundsTest } from '../../canvas/canvas-bounds-container';
+import { ChartConfigComponentsYAxis } from '../../chart.config';
+import EventBus from '../../events/event-bus';
+import { ChartBaseElement } from '../../model/chart-base-element';
+import { CanvasInputListenerComponent } from '../../inputlisteners/canvas-input-listener.component';
+import { Pixel, Unit, ViewportModel } from '../../model/scaling/viewport.model';
+import { ChartPanComponent } from '../pan/chart-pan.component';
+/**
+ * Handles the mouse drag on Y axis - to zoom the viewport vertically.
+ * @doc-tags scaling,zoom,viewport
+ */
+export declare class YAxisScaleHandler extends ChartBaseElement {
+    private bus;
+    private viewportModel;
+    private canvasBoundsContainer;
+    private autoScaleCallback;
+    yAxisDragEndSubject: Subject<void>;
+    lastYStart: Unit;
+    lastYEnd: Unit;
+    lastYHeight: Unit;
+    lastYPxHeight: Pixel;
+    constructor(bus: EventBus, config: ChartConfigComponentsYAxis, chartPanComponent: ChartPanComponent, viewportModel: ViewportModel, canvasInputListener: CanvasInputListenerComponent, canvasBoundsContainer: CanvasBoundsContainer, hitTest: HitBoundsTest, autoScaleCallback: (auto: boolean) => void);
+    private onYDragStart;
+    private onYDragTick;
+    private onYDragEnd;
+}

package/dist/chart/components/y_axis/y-axis-scale.handler.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}from"rxjs";import{CanvasElement as m}from"../../canvas/canvas-bounds-container";import{ChartBaseElement as E}from"../../model/chart-base-element";import{DragNDropYComponent as b}from"../dran-n-drop_helper/drag-n-drop-y.component";const d=10;export class YAxisScaleHandler extends E{constructor(i,t,Y,g,n,D,h,l){if(super(),this.bus=i,this.viewportModel=g,this.canvasBoundsContainer=D,this.autoScaleCallback=l,this.yAxisDragEndSubject=new p,this.lastYStart=0,this.lastYEnd=0,this.lastYHeight=0,this.lastYPxHeight=0,this.onYDragStart=()=>{this.lastYStart=this.viewportModel.yStart,this.lastYEnd=this.viewportModel.yEnd,this.lastYHeight=this.viewportModel.yEnd-this.viewportModel.yStart,this.lastYPxHeight=this.canvasBoundsContainer.getBounds(m.Y_AXIS).height},this.onYDragTick=s=>{const{delta:e}=s;let a;e<0?a=1/(1+-e/this.lastYPxHeight*(d-1)):a=1+e/this.lastYPxHeight*(d-1);const c=(this.lastYHeight*a-this.lastYHeight)/2,u=this.lastYStart-c,S=this.lastYEnd+c;this.autoScaleCallback(!1),this.viewportModel.setYScale(u,S),this.bus.fireDraw()},this.onYDragEnd=()=>{this.yAxisDragEndSubject.next()},t.customScale){const s=()=>t.type!=="percent",e=new b(h,{onDragTick:r(this.onYDragTick,s),onDragStart:r(this.onYDragStart,s),onDragEnd:r(this.onYDragEnd,s)},n,Y,{disableChartPanning:!1});this.addChildEntity(e),t.customScaleDblClick&&n.observeDbClick(h).subscribe(()=>{l(!0),this.bus.fireDraw()})}}}const r=(o,i)=>(...t)=>i()&&o(...t);

package/dist/chart/components/y_axis/y-axis.component.d.ts

@@ -0,0 +1,158 @@
+/*
+ * 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 } from 'rxjs';
+import { CanvasBoundsContainer } from '../../canvas/canvas-bounds-container';
+import { CursorHandler } from '../../canvas/cursor.handler';
+import { BarType, ChartConfigComponentsYAxis, FullChartColors, FullChartConfig, YAxisAlign, YAxisLabelAppearanceType, YAxisLabelMode, YAxisLabelType } from '../../chart.config';
+import { CompositeDrawer } from '../../drawers/composite.drawer';
+import { DrawingManager } from '../../drawers/drawing-manager';
+import EventBus from '../../events/event-bus';
+import { CanvasInputListenerComponent } from '../../inputlisteners/canvas-input-listener.component';
+import { PriceMovement } from '../../model/candle-series.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 { ChartModel } from '../chart/chart.model';
+import { PriceAxisType } from '../labels_generator/numeric-axis-labels.generator';
+import { ChartPanComponent } from '../pan/chart-pan.component';
+import { PaneManager } from '../pane/pane-manager.component';
+import { VisualYAxisLabel, YAxisLabelsProvider } from './price_labels/y-axis-labels.model';
+import { YAxisScaleHandler } from './y-axis-scale.handler';
+import { YAxisModel } from './y-axis.model';
+import { YAxisWidthContributor } from '../../canvas/y-axis-bounds.container';
+export type LabelColorResolver = (priceMovement: PriceMovement, colors: FullChartColors) => string;
+/**
+ * Y axis component. Contains all Y axis related logic.
+ */
+export declare class YAxisComponent extends ChartBaseElement {
+    private eventBus;
+    private config;
+    private canvasModel;
+    private yAxisLabelsCanvasModel;
+    private backgroundCanvasModel;
+    private chartModel;
+    private scaleModel;
+    private canvasBoundsContainer;
+    private cursorHandler;
+    yAxisScaleHandler: YAxisScaleHandler;
+    yAxisModel: YAxisModel;
+    axisTypeSetSubject: Subject<PriceAxisType>;
+    readonly state: ChartConfigComponentsYAxis;
+    private labelsColorByChartTypeMap;
+    drawer: CompositeDrawer;
+    constructor(eventBus: EventBus, config: FullChartConfig, canvasModel: CanvasModel, yAxisLabelsCanvasModel: CanvasModel, backgroundCanvasModel: CanvasModel, chartModel: ChartModel, scaleModel: ScaleModel, canvasInputListeners: CanvasInputListenerComponent, canvasBoundsContainer: CanvasBoundsContainer, drawingManager: DrawingManager, chartPanComponent: ChartPanComponent, paneManager: PaneManager, cursorHandler: CursorHandler);
+    private updateCursor;
+    /**
+     * Updates labels visual appearance on canvas
+     */
+    updateOrderedLabels(adjustYAxisWidth?: boolean): void;
+    /**
+     * Calls the parent class's doActivate method
+     * @protected
+     * @returns {void}
+     */
+    protected doActivate(): void;
+    /**
+     * Registers default label color resolvers for different chart types.
+     * @private
+     * @function
+     * @name registerDefaultLabelColorResolver
+     * @returns {void}
+     */
+    private registerDefaultLabelColorResolver;
+    /**
+     * You can add a custom labels provider for additional labels on YAxis (like for drawings, symbol last price, studies, etc..)
+     * @param groupName - a group in which labels position recalculation algorithm will be applied, usually it's subchart name
+     * @param provider
+     * @param id
+     */
+    registerYAxisLabelsProvider(provider: YAxisLabelsProvider, groupName?: string, id?: string): string;
+    /**
+     * An easier way to manage custom y-axis labels, than y-axis labels providers.
+     * However, overlapping avoidance is not supported
+     * @param name
+     * @param label
+     */
+    addSimpleYAxisLabel(name: string, label: VisualYAxisLabel): void;
+    /**
+     * @param name
+     */
+    deleteSimpleYAxisLabel(name: string): void;
+    /**
+     * Unregister a Y axis labels provider from the specified group.
+     * @param {string} groupName - The name of the group from which to unregister the provider. Defaults to LabelsGroups.MAIN.
+     * @param {string} id - The ID of the provider to unregister.
+     * @returns {string} - The ID of the unregistered provider.
+     */
+    unregisterYAxisLabelsProvider(groupName: string | undefined, id: string): string;
+    /**
+     * If custom pane has y-axis it has to register width contributor to correctly calculate overall y-axis width.
+     * @param contributor
+     */
+    registerYAxisWidthContributor(contributor: YAxisWidthContributor): void;
+    /**
+     * Sets the type of axis: percent, regular or logarithmic.
+     * @param type - the type of axis
+     */
+    setAxisType(type: PriceAxisType): void;
+    /**
+     * Change YAxis position to left or to right
+     * @param align
+     */
+    setYAxisAlign(align: YAxisAlign): void;
+    /**
+     * Controls visibility of the y-axis
+     */
+    setVisible(isVisible: boolean): void;
+    /**
+     * If visible, when you can see the y-axis on the chart
+     */
+    isVisible(): boolean;
+    /**
+     * Controls lockPriceToBarRatio of the y-axis
+     */
+    setLockPriceToBarRatio(value?: boolean): void;
+    /**
+     * Changes the visual type of particular label.
+     * @param type - label type
+     * @param mode - visual mode
+     */
+    changeLabelMode(type: YAxisLabelType, mode: YAxisLabelMode): void;
+    /**
+     * Changes the visual type of particular label.
+     * @param type - label type
+     * @param mode - visual mode
+     */
+    changeLabelAppearance(type: YAxisLabelType, mode: YAxisLabelAppearanceType): void;
+    /**
+     * Sets the inverse price scale mode. Inverts Y axis vertically.
+     * Inversion also works for candles, drawings and overlay studies.
+     * @param inverse - true or false
+     */
+    togglePriceScaleInverse(inverse: boolean): void;
+    /**
+     * Changes the visibility of the labels' descriptions.
+     * @param {boolean} descVisibility - A boolean value indicating whether the descriptions should be visible or not.
+     * @returns {void}
+     */
+    changeLabelsDescriptionVisibility(descVisibility: boolean): void;
+    /**
+     * Registers a label color resolver for a specific chart type.
+     *
+     * @param {BarType} chartType - The type of chart for which the label color resolver is being registered.
+     * @param {LabelColorResolver} resolver - The function that will be used to resolve the color of the labels for the specified chart type.
+     * @returns {void}
+     */
+    registerLabelColorResolver(chartType: BarType, resolver: LabelColorResolver): void;
+    /**
+     * Returns a function that resolves the color for a label based on the type of data series.
+     * @param {DataSeriesType} candlesType - The type of data series.
+     * @returns {Function} - A function that resolves the color for a label.
+     * If there is no color mapping for the given data series type, it returns the default color resolver function.
+     */
+    getLabelsColorResolver(candlesType: DataSeriesType): LabelColorResolver;
+}

package/dist/chart/components/y_axis/y-axis.component.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 g}from"rxjs";import{CanvasElement as d,CHART_UUID as r}from"../../canvas/canvas-bounds-container";import{ClearCanvasDrawer as f}from"../../drawers/clear-canvas.drawer";import{CompositeDrawer as w}from"../../drawers/composite.drawer";import{ChartBaseElement as Y}from"../../model/chart-base-element";import{uuid as D}from"../../utils/uuid.utils";import{resolveColorForArea as S,resolveColorForBar as R,resolveColorForBaseLine as P,resolveColorForCandle as I,resolveColorForHistogram as B,resolveColorForLine as _,resolveColorForScatterPlot as T,resolveColorForTrendAndHollow as b,resolveDefaultColorForLabel as E}from"./label-color.functions";import{LastCandleLabelsProvider as F}from"./price_labels/last-candle-labels.provider";import{LabelsGroups as h}from"./price_labels/y-axis-labels.model";import{YAxisPriceLabelsDrawer as H}from"./price_labels/y-axis-price-labels.drawer";import{YAxisScaleHandler as U}from"./y-axis-scale.handler";import{YAxisDrawer as N}from"./y-axis.drawer";import{YAxisModel as X}from"./y-axis.model";export class YAxisComponent extends Y{constructor(e,s,t,A,x,l,a,C,i,c,L,n,p){super(),this.eventBus=e,this.config=s,this.canvasModel=t,this.yAxisLabelsCanvasModel=A,this.backgroundCanvasModel=x,this.chartModel=l,this.scaleModel=a,this.canvasBoundsContainer=i,this.cursorHandler=p,this.axisTypeSetSubject=new g,this.labelsColorByChartTypeMap={},this.state=s.components.yAxis;const o=new w;this.drawer=o;const y=new f(this.yAxisLabelsCanvasModel);o.addDrawer(y,"YAXIS_CLEAR"),this.registerDefaultLabelColorResolver(),c.addDrawer(o,"Y_AXIS"),this.yAxisScaleHandler=new U(e,this.state,L,a,C,i,i.getBoundsHitTest(d.PANE_UUID_Y_AXIS(r)),M=>a.autoScale(M)),this.addChildEntity(this.yAxisScaleHandler),this.yAxisModel=new X(n.paneComponents[r],e,this.config,i,t,l,a),this.addChildEntity(this.yAxisModel),n.paneComponents[r].yAxisLabelsGenerator=this.yAxisModel.yAxisLabelsGenerator;const u=new N(s,this.state,t,()=>this.yAxisModel.yAxisBaseLabelsModel.labels,()=>i.getBounds(d.Y_AXIS),()=>this.state.visible,l.pane.scaleModel.toY.bind(l.pane.scaleModel));o.addDrawer(u);const v=new H(()=>this.yAxisModel.yAxisLabelsModel.orderedLabels,this.yAxisLabelsCanvasModel,this.backgroundCanvasModel,this.state,this.canvasBoundsContainer,this.config.colors.yAxis,this.yAxisModel.yAxisLabelsModel.customLabels);o.addDrawer(v);const m=new F(this.chartModel,this.config,this.chartModel.lastCandleLabelsByChartType,this.getLabelsColorResolver.bind(this));this.registerYAxisLabelsProvider(m,h.MAIN),n.paneComponents[r].mainYExtentComponent.getAxisType=()=>this.state.type,this.updateCursor()}updateCursor(){this.state.type==="percent"?this.cursorHandler.setCursorForCanvasEl(d.PANE_UUID_Y_AXIS(r),this.config.components.yAxis.resizeDisabledCursor):this.cursorHandler.setCursorForCanvasEl(d.PANE_UUID_Y_AXIS(r),this.config.components.yAxis.cursor)}updateOrderedLabels(e=!1){this.yAxisModel.yAxisLabelsModel.updateLabels(e)}doActivate(){super.doActivate()}registerDefaultLabelColorResolver(){this.registerLabelColorResolver("candle",I),this.registerLabelColorResolver("bar",R),this.registerLabelColorResolver("line",_),this.registerLabelColorResolver("area",S),this.registerLabelColorResolver("scatterPlot",T),this.registerLabelColorResolver("histogram",B),this.registerLabelColorResolver("baseline",P),this.registerLabelColorResolver("trend",b),this.registerLabelColorResolver("hollow",b)}registerYAxisLabelsProvider(e,s=h.MAIN,t=D()){return this.yAxisModel.yAxisLabelsModel.registerYAxisLabelsProvider(s,e,t),t}addSimpleYAxisLabel(e,s){this.yAxisModel.yAxisLabelsModel.customLabels[e]=s,this.canvasModel.fireDraw()}deleteSimpleYAxisLabel(e){delete this.yAxisModel.yAxisLabelsModel.customLabels[e],this.canvasModel.fireDraw()}unregisterYAxisLabelsProvider(e=h.MAIN,s){return this.yAxisModel.yAxisLabelsModel.unregisterYAxisLabelsProvider(e,s),s}registerYAxisWidthContributor(e){this.canvasBoundsContainer.yAxisBoundsContainer.registerYAxisWidthContributor(e)}setAxisType(e){e!==this.state.type&&(this.state.type=e,this.axisTypeSetSubject.next(e),this.scaleModel.autoScale(!0),this.yAxisModel.yAxisLabelsModel.updateLabels(!0),this.updateCursor())}setYAxisAlign(e){this.state.align=e,this.canvasBoundsContainer.updateYAxisWidths(),this.eventBus.fireDraw()}setVisible(e){this.state.visible=e,this.eventBus.fireDraw()}isVisible(){return this.state.visible}setLockPriceToBarRatio(e=!1){this.scaleModel.setLockPriceToBarRatio(e)}changeLabelMode(e,s){this.state.labels.settings[e].mode=s,this.yAxisModel.yAxisLabelsModel.updateLabels()}changeLabelAppearance(e,s){this.state.labels.settings[e].type=s,this.yAxisModel.yAxisLabelsModel.updateLabels()}togglePriceScaleInverse(e){this.scaleModel.state.inverse=e,this.scaleModel.inverseY=e,this.scaleModel.scaleInversedSubject.next(e)}changeLabelsDescriptionVisibility(e){this.state.labels.descriptions=e,this.canvasModel.fireDraw()}registerLabelColorResolver(e,s){this.labelsColorByChartTypeMap[e]=s}getLabelsColorResolver(e){var s;return(s=this.labelsColorByChartTypeMap[e])!==null&&s!==void 0?s:E}}

package/dist/chart/components/y_axis/y-axis.drawer.d.ts

@@ -0,0 +1,72 @@
+/*
+ * 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 { ChartConfigComponentsYAxis, FullChartConfig } from '../../chart.config';
+import { CanvasModel } from '../../model/canvas.model';
+import { NumericAxisLabel } from '../labels_generator/numeric-axis-labels.generator';
+import { Drawer } from '../../drawers/drawing-manager';
+import { Unit, ViewportModel } from '../../model/scaling/viewport.model';
+import { Bounds, BoundsProvider } from '../../model/bounds.model';
+export interface YAxisLabel {
+    readonly text: string;
+    readonly value: Unit;
+}
+export interface YAxisAnimationParameters {
+    readonly removed: YAxisLabel[];
+    readonly added: YAxisLabel[];
+    readonly stay: YAxisLabel[];
+}
+/**
+ * Draws the Y_AXIS rectangle + it's base labels.
+ */
+export declare class YAxisDrawer implements Drawer {
+    private fullConfig;
+    private yAxisState;
+    private canvasModel;
+    private labelsProvider;
+    private axisBounds;
+    private drawPredicate;
+    private toY;
+    constructor(fullConfig: FullChartConfig, yAxisState: ChartConfigComponentsYAxis, canvasModel: CanvasModel, labelsProvider: () => Array<NumericAxisLabel>, axisBounds: BoundsProvider, drawPredicate: () => boolean, toY: ViewportModel['toY']);
+    /**
+     * Draws the axis on the canvas if the drawPredicate is true.
+     * It gets the labels from the labelsProvider and the bounds from the axisBounds.
+     * It sets the background color of the axis and fills the background rectangle.
+     * It gets the font from the yAxisState and calculates the font height.
+     * It saves the context, clips it to the bounds and draws the labels with the given font and text color.
+     * @function
+     */
+    draw(): void;
+    /**
+     * Draws labels on the Y-axis of a canvas chart.
+     * @param {CanvasRenderingContext2D} ctx - The 2D rendering context of the canvas.
+     * @param {YAxisLabel[]} labels - An array of objects containing the value and text of each label.
+     * @param {Bounds} axisBounds - An object containing the x, y, width, and height of the Y-axis.
+     * @param {number} fontHeight - The height of the font used for the labels.
+     * @param {string} font - The font used for the labels.
+     * @param {string} labelTextColor - The color of the label text.
+     */
+    drawLabels(ctx: CanvasRenderingContext2D, labels: YAxisLabel[], axisBounds: Bounds, fontHeight: number, font: string, labelTextColor: string): void;
+    /**
+     * Returns an array of canvas IDs.
+     *
+     * @returns {Array<string>} An array containing the canvas ID.
+     */
+    getCanvasIds(): Array<string>;
+    /**
+     * Returns the background color of the Y-axis.
+     *
+     * @protected
+     * @returns {string} The background color of the Y-axis.
+     */
+    protected getBackgroundColor(): string;
+    /**
+     * Returns the color of the label text for the chart area axis.
+     *
+     * @protected
+     * @returns {string} The color of the label text.
+     */
+    protected getLabelTextColor(): string;
+}