@devexperts/dxcharts-lite 1.0.1

package/dist/chart/components/cross_tool/cross-tool.component.d.ts

@@ -0,0 +1,69 @@
+/*
+ * 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 { FullChartConfig } from '../../chart.config';
+import { DrawingManager } from '../../drawers/drawing-manager';
+import { CrossEventProducerComponent } from '../../inputhandlers/cross-event-producer.component';
+import { HoverProducerComponent } from '../../inputhandlers/hover-producer.component';
+import { CanvasModel } from '../../model/canvas.model';
+import { ChartBaseElement } from '../../model/chart-base-element';
+import { PaneManager } from '../pane/pane-manager.component';
+import { CrossToolTypeDrawer } from './cross-tool.drawer';
+import { CrossToolModel, CrossToolType } from './cross-tool.model';
+export type MagnetTarget = 'O' | 'H' | 'L' | 'C' | 'OHLC' | 'none';
+/**
+ * Default bundled chart cross tool.
+ */
+export declare class CrossToolComponent extends ChartBaseElement {
+    private config;
+    private crossToolCanvasModel;
+    private canvasBoundsContainer;
+    private drawingManager;
+    private paneManager;
+    readonly model: CrossToolModel;
+    private readonly crossToolTypeDrawers;
+    constructor(config: FullChartConfig, crossToolCanvasModel: CanvasModel, canvasBoundsContainer: CanvasBoundsContainer, drawingManager: DrawingManager, paneManager: PaneManager, crossEventProducer: CrossEventProducerComponent, hoverProducer: HoverProducerComponent);
+    /**
+     * Registers default drawer types for the chart.
+     * @private
+     * @function
+     * @name registerDefaultDrawerTypes
+     *
+     * @returns {void}
+     */
+    private registerDefaultDrawerTypes;
+    /**
+     * Sets the cross tool visibility.
+     * @param visible
+     */
+    setVisible(visible: boolean): void;
+    /**
+     * Sets the crosstool type.
+     * - cross-and-labels - both the crosshair and X/Y labels
+     * - only-labels - only the X/Y label
+     * - none
+     * @param type
+     */
+    setType(type: CrossToolType): void;
+    /**
+     * Returns an Observable that emits the current hover subject.
+     */
+    observeCrossToolChanged(): import("rxjs").BehaviorSubject<import("./cross-tool.model").CrossToolHover | null>;
+    /**
+     * Sets magnet target for cross tool.
+     * Supported only for 'cross-and-labels' type.
+     * Default magnet target is none.
+     * @param target
+     */
+    setMagnetTarget(target: MagnetTarget): void;
+    /**
+     * Adds a new drawer type for cross tool, so you can add your own implementation of cross tool
+     * (or override existing)
+     * @param drawerName - an unique drawer type name
+     * @param drawerImpl - CrossToolTypeDrawer object
+     */
+    registerCrossToolTypeDrawer(drawerName: CrossToolType, drawerImpl: CrossToolTypeDrawer): void;
+}

package/dist/chart/components/cross_tool/cross-tool.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{ClearCanvasDrawer as p}from"../../drawers/clear-canvas.drawer";import{CompositeDrawer as c}from"../../drawers/composite.drawer";import{ChartBaseElement as d}from"../../model/chart-base-element";import{CrossToolDrawer as w}from"./cross-tool.drawer";import{CrossToolModel as C}from"./cross-tool.model";import{CrossAndLabelsDrawerType as o}from"./types/cross-and-labels.drawer";import{NoneDrawerType as m}from"./types/none.drawer";export class CrossToolComponent extends d{constructor(s,e,t,a,n,i,l){super(),this.config=s,this.crossToolCanvasModel=e,this.canvasBoundsContainer=t,this.drawingManager=a,this.paneManager=n,this.crossToolTypeDrawers={},this.model=new C(s.components.crossTool,this.crossToolCanvasModel,i,l),this.addChildEntity(this.model);const T=new p(this.crossToolCanvasModel);this.registerDefaultDrawerTypes();const h=new w(this.model,this.crossToolCanvasModel,this.crossToolTypeDrawers),r=new c;r.addDrawer(T,"CLEAR_CANVAS"),r.addDrawer(h,"CROSS_TOOL_DRAWER"),this.drawingManager.addDrawer(r,"CROSS_TOOL")}registerDefaultDrawerTypes(){this.registerCrossToolTypeDrawer("cross-and-labels",new o(this.config,this.canvasBoundsContainer,this.paneManager,()=>!0)),this.registerCrossToolTypeDrawer("just-labels",new o(this.config,this.canvasBoundsContainer,this.paneManager,()=>!0,!0)),this.registerCrossToolTypeDrawer("none",new m)}setVisible(s){this.model.setType(s?"cross-and-labels":"none")}setType(s){this.model.setType(s)}observeCrossToolChanged(){return this.model.currentHoverSubject}setMagnetTarget(s){this.config.components.crossTool.magnetTarget=s}registerCrossToolTypeDrawer(s,e){this.crossToolTypeDrawers[s]=e}}

package/dist/chart/components/cross_tool/cross-tool.drawer.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 { CanvasModel } from '../../model/canvas.model';
+import { Drawer } from '../../drawers/drawing-manager';
+import { CrossToolHover, CrossToolModel, CrossToolType } from './cross-tool.model';
+export interface CrossToolTypeDrawer {
+    draw: (ctx: CanvasRenderingContext2D, hover: CrossToolHover) => void;
+}
+export declare class CrossToolDrawer implements Drawer {
+    private model;
+    private crossToolCanvasModel;
+    private readonly crossToolTypeDrawers;
+    constructor(model: CrossToolModel, crossToolCanvasModel: CanvasModel, crossToolTypeDrawers: Record<CrossToolType, CrossToolTypeDrawer>);
+    /**
+     * Draws the cross tool on the canvas.
+     * @function
+     * @name draw
+     * @memberof CrossToolCanvasView
+     * @instance
+     * @returns {void}
+     */
+    draw(): void;
+    /**
+     * Returns an array of string containing the canvas ID of the crossToolCanvasModel.
+     *
+     * @returns {Array<string>} An array of string containing the canvas ID of the crossToolCanvasModel.
+     */
+    getCanvasIds(): Array<string>;
+}

package/dist/chart/components/cross_tool/cross-tool.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/.
+ */
+export class CrossToolDrawer{constructor(o,s,r){this.model=o,this.crossToolCanvasModel=s,this.crossToolTypeDrawers=r}draw(){const o=this.crossToolTypeDrawers[this.model.type];o?this.model.currentHover&&o.draw(this.crossToolCanvasModel.ctx,this.model.currentHover):console.error(`No cross tool drawer type registered for drawer type ${this.model.type}`)}getCanvasIds(){return[this.crossToolCanvasModel.canvasId]}}

package/dist/chart/components/cross_tool/cross-tool.model.d.ts

@@ -0,0 +1,63 @@
+/*
+ * 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 { BehaviorSubject } from 'rxjs';
+import { ChartConfigComponentsCrossTool } from '../../chart.config';
+import { CrossEventProducerComponent } from '../../inputhandlers/cross-event-producer.component';
+import { Hover, HoverProducerComponent } from '../../inputhandlers/hover-producer.component';
+import { CanvasModel } from '../../model/canvas.model';
+import { ChartBaseElement } from '../../model/chart-base-element';
+export type CrossToolType = 'cross-and-labels' | 'only-labels' | 'none' | string;
+export interface CrossToolHover {
+    x: number;
+    y: number;
+    time: string;
+    paneId: string;
+}
+export declare class CrossToolModel extends ChartBaseElement {
+    private config;
+    private crossToolCanvasModel;
+    private crossEventProducer;
+    private hoverProducer;
+    currentHoverSubject: BehaviorSubject<CrossToolHover | null>;
+    get currentHover(): CrossToolHover | null;
+    set currentHover(value: CrossToolHover | null);
+    type: CrossToolType;
+    constructor(config: Required<ChartConfigComponentsCrossTool>, crossToolCanvasModel: CanvasModel, crossEventProducer: CrossEventProducerComponent, hoverProducer: HoverProducerComponent);
+    /**
+     * Sets the type of the CrossTool object.
+     *
+     * @param {CrossToolType} type - The type of the CrossTool object.
+     * @returns {void}
+     */
+    setType(type: CrossToolType): void;
+    /**
+     * Method to activate the cross tool.
+     * It subscribes to the canvasInputListener's mouse move event and fires the draw event.
+     * It also subscribes to the eventBus's hover and close hover events and updates the hover and fires the draw event accordingly.
+     * It also subscribes to the chartModel's candlesSetSubject and timeZoneModel's observeTimeZoneChanged events and recalculates the cross tool X formatter.
+     */
+    protected doActivate(): void;
+    /**
+     * This method is used to fire the draw event of the crossToolCanvasModel if the type is not 'none'.
+     * @private
+     */
+    private fireDraw;
+    /**
+     * Updates the current hover position with the provided hover object.
+     * @param {Object} hover - The hover object containing the x and y coordinates and time formatted.
+     * @param {number} hover.x - The x coordinate of the hover.
+     * @param {number} hover.y - The y coordinate of the hover.
+     * @param {string} hover.timeFormatted - The formatted time of the hover.
+     * @param {Object} hover.candleHover - The candle hover object containing the open, close, high, low and closestOHLCY coordinates.
+     * @param {number} hover.candleHover.openY - The y coordinate of the open price of the candle.
+     * @param {number} hover.candleHover.closeY - The y coordinate of the close price of the candle.
+     * @param {number} hover.candleHover.highY - The y coordinate of the high price of the candle.
+     * @param {number} hover.candleHover.lowY - The y coordinate of the low price of the candle.
+     * @param {number} hover.candleHover.closestOHLCY - The y coordinate of the closest OHLC price of the candle.
+     * @returns {void}
+     */
+    updateHover(hover: Hover, magnetTarget?: import("./cross-tool.component").MagnetTarget): void;
+}

package/dist/chart/components/cross_tool/cross-tool.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{BehaviorSubject as c}from"rxjs";import{ChartBaseElement as o}from"../../model/chart-base-element";import{CHART_UUID as i}from"../../canvas/canvas-bounds-container";export class CrossToolModel extends o{get currentHover(){return this.currentHoverSubject.getValue()}set currentHover(e){this.currentHoverSubject.next(e)}constructor(e,r,t,s){super(),this.config=e,this.crossToolCanvasModel=r,this.crossEventProducer=t,this.hoverProducer=s,this.currentHoverSubject=new c(null),this.type="cross-and-labels",this.type=e.type}setType(e){this.type=e}doActivate(){super.doActivate(),this.addRxSubscription(this.hoverProducer.hoverSubject.subscribe(e=>{this.crossEventProducer.crossSubject.getValue()!==null&&e!==null?this.updateHover(e):this.currentHover=null,this.fireDraw()}))}fireDraw(){this.type!=="none"&&this.crossToolCanvasModel.fireDraw()}updateHover(e,r=this.config.magnetTarget){if(this.currentHover===null?this.currentHover={x:e.x,y:0,time:e.timeFormatted,paneId:e.paneId}:(this.currentHover.x=e.x,this.currentHover.time=e.timeFormatted),e.candleHover&&e.paneId===i)switch(r){case"O":this.currentHover.y=e.candleHover.openY;break;case"C":this.currentHover.y=e.candleHover.closeY;break;case"H":this.currentHover.y=e.candleHover.highY;break;case"L":this.currentHover.y=e.candleHover.lowY;break;case"OHLC":this.currentHover.y=e.candleHover.closestOHLCY;break;case"none":this.currentHover.y=e.y;break}else this.currentHover.y=e.y;this.currentHoverSubject.next(this.currentHover)}}

package/dist/chart/components/cross_tool/types/cross-and-labels.drawer.d.ts

@@ -0,0 +1,44 @@
+/*
+ * 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 { FullChartConfig } from '../../../chart.config';
+import { PaneManager } from '../../pane/pane-manager.component';
+import { CrossToolTypeDrawer } from '../cross-tool.drawer';
+import { CrossToolHover } from '../cross-tool.model';
+export declare class CrossAndLabelsDrawerType implements CrossToolTypeDrawer {
+    private config;
+    private canvasBoundsContainer;
+    private paneManager;
+    private crossDrawPredicate;
+    private noLines?;
+    constructor(config: FullChartConfig, canvasBoundsContainer: CanvasBoundsContainer, paneManager: PaneManager, crossDrawPredicate?: () => boolean, noLines?: boolean | undefined);
+    /**
+     * Draws a cross tool on a canvas context and its labels if the crossDrawPredicate is true.
+     * @param {CanvasRenderingContext2D} ctx - The canvas context to draw on.
+     * @param {CrossToolHover} hover - The hover object containing information about the cross tool's position.
+     */
+    draw(ctx: CanvasRenderingContext2D, hover: CrossToolHover): void;
+    /**
+     * This is a protected method called `drawCrossTool` that takes two parameters: `ctx` of type `CanvasRenderingContext2D` and `hover` of type `CrossToolHover`.
+     * The method draws a cross tool on the canvas using the provided context. It first gets the bounds of all panes and the hit test bounds of all panes. It then gets the top padding of the x-axis from the configuration and the left padding of the y-axis from the configuration based on the type of y-label.
+     * If the hit test bounds of all panes contain the hover coordinates, it draws a horizontal line and a vertical line using the provided coordinates and the bounds of all panes. It sets the stroke style to the line color from the configuration and sets the line dash to the line dash from the configuration. It then begins a new path, moves to the start of the horizontal line, draws a line to the end of the horizontal line, moves to the start of the vertical line, and draws a line to the end of the vertical line. Finally, it strokes the path.
+     */
+    protected drawCrossTool(ctx: CanvasRenderingContext2D, hover: CrossToolHover): void;
+    /**
+     * Draws the X axis label for the cross tool on the canvas.
+     * @param {CanvasRenderingContext2D} ctx - The 2D rendering context for the canvas.
+     * @param {CrossToolHover} hover - The hover object containing the x and y coordinates of the cross tool.
+     * @returns {void}
+     */
+    protected drawXLabel(ctx: CanvasRenderingContext2D, hover: CrossToolHover): void;
+    /**
+     * Draws the Y-axis label on the canvas context at the given point.
+     * @param {CanvasRenderingContext2D} ctx - The canvas context to draw on.
+     * @param {Point} point - The point where the label should be drawn.
+     * @returns {void}
+     */
+    protected drawYLabel(ctx: CanvasRenderingContext2D, point: CrossToolHover): void;
+}

package/dist/chart/components/cross_tool/types/cross-and-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 v}from"../../../canvas/canvas-bounds-container";import{avoidAntialiasing as w,drawRoundedRect as B}from"../../../utils/canvas/canvas-drawing-functions.utils";import{priceLabelDrawersMap as S}from"../../y_axis/price_labels/price-label.drawer";export class CrossAndLabelsDrawerType{constructor(o,s,t,e=()=>!0,i){this.config=o,this.canvasBoundsContainer=s,this.paneManager=t,this.crossDrawPredicate=e,this.noLines=i}draw(o,s){this.crossDrawPredicate()&&w(o,()=>this.drawCrossTool(o,s))}drawCrossTool(o,s){var t,e,i,a,l;const n=this.canvasBoundsContainer.getBounds(v.ALL_PANES),d=this.canvasBoundsContainer.getBoundsHitTest(v.ALL_PANES,{extensionY:1e-4}),g=(t=this.config.components.xAxis.padding.top)!==null&&t!==void 0?t:0,r=(i=this.config.components.yAxis.typeConfig[(e=this.config.components.crossTool.yLabel.type)!==null&&e!==void 0?e:"badge"])===null||i===void 0?void 0:i.paddings,p=(a=r==null?void 0:r.start)!==null&&a!==void 0?a:0,c=(l=this.paneManager.paneComponents[s.paneId])===null||l===void 0?void 0:l.ht;if(d(s.x,n.y)){const x={start:[n.x,s.y],end:[n.x+n.width+p,s.y]},f={start:[s.x,n.y],end:[s.x,n.y+n.height+g]},u=c==null?void 0:c(s.x,s.y);this.noLines||(o.strokeStyle=this.config.colors.crossTool.lineColor,o.setLineDash(this.config.components.crossTool.lineDash),o.beginPath(),u&&(o.moveTo(...x.start),o.lineTo(...x.end)),o.moveTo(...f.start),o.lineTo(...f.end),o.stroke()),u&&this.drawYLabel(o,s),this.drawXLabel(o,s)}}drawXLabel(o,s){var t,e,i,a,l;const n=this.config.components.crossTool.xLabel.padding,d=this.config.components.crossTool.xLabel.margin,g=this.config.colors.crossTool;if(this.config.components.xAxis.visible){o.font=this.config.components.xAxis.fontSize+"px "+this.config.components.xAxis.fontFamily;const r=s.x,p=s.time,c=o.measureText(p).width,x=this.config.components.xAxis.fontSize,f=this.canvasBoundsContainer.getBounds(v.X_AXIS);o.save(),o.fillStyle=g.labelBoxColor;const u=(t=n==null?void 0:n.left)!==null&&t!==void 0?t:0,T=(e=n==null?void 0:n.right)!==null&&e!==void 0?e:0,h=(i=n==null?void 0:n.top)!==null&&i!==void 0?i:0,y=(a=n==null?void 0:n.bottom)!==null&&a!==void 0?a:0,b=(l=d==null?void 0:d.top)!==null&&l!==void 0?l:0,m=c+u+T,L=x+h+y,C=Math.max(r-m/2,0),A=f.y+b;B(o,C,A,m,L),o.fillStyle=g.labelTextColor;const P=Math.max(r-c/2,u),_=f.y+b+x+h-1;o.fillText(p,P,_),o.restore()}}drawYLabel(o,s){var t,e;const i=this.config.components.crossTool.yLabel.padding,a=this.config.colors.crossTool;if(this.config.components.yAxis.visible){const l=this.paneManager.paneComponents[s.paneId],n=s.y;if(!l)return;for(const d of l.yExtentComponents){const g=d.regularValueFromY(n),r=d.valueFormatter(g),p=this.canvasBoundsContainer.getBounds(v.PANE_UUID_Y_AXIS(l.uuid,d.idx)),c=S[this.config.components.crossTool.yLabel.type];c(o,p,r,n,{textColor:a.labelTextColor,bgColor:a.labelBoxColor,paddingBottom:i==null?void 0:i.bottom,paddingEnd:i==null?void 0:i.end,paddingTop:i==null?void 0:i.top},(e=(t=d.yAxisComponent)===null||t===void 0?void 0:t.state)!==null&&e!==void 0?e:this.config.components.yAxis,this.config.colors.yAxis,!0)}}}}

package/dist/chart/components/cross_tool/types/none.drawer.d.ts

@@ -0,0 +1,9 @@
+/*
+ * 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 { CrossToolTypeDrawer } from '../cross-tool.drawer';
+export declare class NoneDrawerType implements CrossToolTypeDrawer {
+    draw(): void;
+}

package/dist/chart/components/cross_tool/types/none.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/.
+ */
+export class NoneDrawerType{draw(){}}

package/dist/chart/components/dran-n-drop_helper/drag-n-drop-x.component.d.ts

@@ -0,0 +1,27 @@
+/*
+ * 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 { HitBoundsTest } from '../../canvas/canvas-bounds-container';
+import { CanvasInputListenerComponent } from '../../inputlisteners/canvas-input-listener.component';
+import { ChartPanComponent } from '../pan/chart-pan.component';
+import { DragComponentOptions, DragNDropComponent, DragNDropComponentCallbacks } from './drag-n-drop.component';
+export declare class DragNDropXComponent extends DragNDropComponent {
+    constructor(hitTest: HitBoundsTest, dragCallbacks: DragNDropComponentCallbacks, canvasInputListener: CanvasInputListenerComponent, chartPanComponent: ChartPanComponent, dragComponentOptions?: DragComponentOptions);
+    /**
+     * This method is used to activate the component and add the necessary subscriptions to the canvasInputListener.
+     * It calls the super method doActivate() and then adds the following subscriptions:
+     * - observeXDragStart() subscription with hitTest() as parameter and onDragStart() as callback function
+     * - observeXDrag() subscription with onDragTick() as callback function
+     * - observeXDragEnd() subscription with onDragEnd() as callback function
+     * @returns {void}
+     */
+    protected doActivate(): void;
+    /**
+     * This method overrides the doDeactivate method of the parent class and calls it using the super keyword.
+     * It is used to deactivate the current object and perform any necessary cleanup operations.
+     * @protected
+     */
+    protected doDeactivate(): void;
+}

package/dist/chart/components/dran-n-drop_helper/drag-n-drop-x.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{defaultDragComponentOptions as a,DragNDropComponent as o}from"./drag-n-drop.component";export class DragNDropXComponent extends o{constructor(t,s,r,e,i=a){super(t,s,r,e,i)}doActivate(){super.doActivate(),this.addRxSubscription(this.canvasInputListener.observeXDragStart(this.hitTest).subscribe(this.onDragStart)),this.addRxSubscription(this.canvasInputListener.observeXDrag().subscribe(this.onDragTick)),this.addRxSubscription(this.canvasInputListener.observeXDragEnd().subscribe(this.onDragEnd))}doDeactivate(){super.doDeactivate()}}

package/dist/chart/components/dran-n-drop_helper/drag-n-drop-y.component.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 { HitBoundsTest } from '../../canvas/canvas-bounds-container';
+import { CanvasInputListenerComponent } from '../../inputlisteners/canvas-input-listener.component';
+import { ChartPanComponent } from '../pan/chart-pan.component';
+import { DragComponentOptions, DragNDropComponent, DragNDropComponentCallbacks } from './drag-n-drop.component';
+export declare class DragNDropYComponent extends DragNDropComponent {
+    constructor(hitTest: HitBoundsTest, dragCallbacks: DragNDropComponentCallbacks, canvasInputListener: CanvasInputListenerComponent, chartPanComponent: ChartPanComponent, dragComponentOptions?: DragComponentOptions);
+    /**
+     * This method activates the component and adds subscriptions to the canvasInputListener.
+     * @protected
+     * @returns {void}
+     */
+    protected doActivate(): void;
+    /**
+     * This method overrides the doDeactivate method of the parent class and calls the parent method before executing its own code.
+     * It is a protected method, which means it can only be accessed within the class and its subclasses.
+     */
+    protected doDeactivate(): void;
+}

package/dist/chart/components/dran-n-drop_helper/drag-n-drop-y.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{defaultDragComponentOptions as a,DragNDropComponent as o}from"./drag-n-drop.component";export class DragNDropYComponent extends o{constructor(t,s,r,e,i=a){super(t,s,r,e,i)}doActivate(){super.doActivate(),this.addRxSubscription(this.canvasInputListener.observeYDragStart(this.hitTest).subscribe(this.onDragStart)),this.addRxSubscription(this.canvasInputListener.observeYDrag().subscribe(this.onDragTick)),this.addRxSubscription(this.canvasInputListener.observeYDragEnd().subscribe(this.onDragEnd))}doDeactivate(){super.doDeactivate()}}

package/dist/chart/components/dran-n-drop_helper/drag-n-drop.component.d.ts

@@ -0,0 +1,46 @@
+/*
+ * 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 { HitBoundsTest } from '../../canvas/canvas-bounds-container';
+import { ChartBaseElement } from '../../model/chart-base-element';
+import { CanvasInputListenerComponent, Point } from '../../inputlisteners/canvas-input-listener.component';
+import { ChartPanComponent } from '../pan/chart-pan.component';
+export interface DragInfo {
+    delta: number;
+    draggedPixels: number;
+}
+export interface DragComponentOptions {
+    disableChartPanning: boolean;
+}
+export interface DragNDropComponentCallbacks {
+    onDragStart?: (point: Point) => void;
+    onDragTick: (dragInfo: DragInfo) => void;
+    onDragEnd?: (draggedPixels: number) => void;
+}
+export declare const defaultDragComponentOptions: DragComponentOptions;
+export declare class DragNDropComponent extends ChartBaseElement {
+    protected hitTest: HitBoundsTest;
+    protected dragCallbacks: DragNDropComponentCallbacks;
+    protected canvasInputListener: CanvasInputListenerComponent;
+    protected chartPanComponent: ChartPanComponent;
+    private dragComponentOptions;
+    dragging: boolean;
+    draggedPixels: number;
+    constructor(hitTest: HitBoundsTest, dragCallbacks: DragNDropComponentCallbacks, canvasInputListener: CanvasInputListenerComponent, chartPanComponent: ChartPanComponent, dragComponentOptions: DragComponentOptions);
+    /**
+     * Calls the parent class's doActivate method and performs any additional activation logic.
+     * This method is protected and can only be accessed by the class itself and its subclasses.
+     */
+    protected doActivate(): void;
+    /**
+     * This method overrides the doDeactivate method of the parent class and calls it using the super keyword.
+     * It is a protected method that can only be accessed within the class and its subclasses.
+     * This method is responsible for deactivating the current object.
+     */
+    protected doDeactivate(): void;
+    protected onDragStart: (point: Point) => void;
+    protected onDragTick: (yDelta: number) => void;
+    protected onDragEnd: () => void;
+}

package/dist/chart/components/dran-n-drop_helper/drag-n-drop.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{ChartBaseElement as e}from"../../model/chart-base-element";export const defaultDragComponentOptions={disableChartPanning:!0};export class DragNDropComponent extends e{constructor(t,s,i,n,r){super(),this.hitTest=t,this.dragCallbacks=s,this.canvasInputListener=i,this.chartPanComponent=n,this.dragComponentOptions=r,this.dragging=!1,this.draggedPixels=0,this.onDragStart=a=>{this.dragging=!0,this.draggedPixels=0,this.dragCallbacks.onDragStart&&this.dragCallbacks.onDragStart(a),this.dragComponentOptions.disableChartPanning&&this.chartPanComponent.deactivatePanHandlers()},this.onDragTick=a=>{this.dragging&&(this.draggedPixels+=a,this.dragCallbacks.onDragTick({delta:a,draggedPixels:this.draggedPixels}))},this.onDragEnd=()=>{this.dragging&&(this.dragging=!1,this.dragCallbacks.onDragEnd&&this.dragCallbacks.onDragEnd(this.draggedPixels),this.dragComponentOptions.disableChartPanning&&this.chartPanComponent.activateChartPanHandlers())}}doActivate(){super.doActivate()}doDeactivate(){super.doDeactivate()}}

package/dist/chart/components/events/events-hit-test.drawer.d.ts

@@ -0,0 +1,34 @@
+/*
+ * 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 { Drawer } from '../../drawers/drawing-manager';
+import { HitTestCanvasModel } from '../../model/hit-test-canvas.model';
+import { ChartModel } from '../chart/chart.model';
+import { FullChartConfig } from '../../chart.config';
+import { CanvasBoundsContainer } from '../../canvas/canvas-bounds-container';
+import { EventsModel } from './events.model';
+export declare class EventsHitTestDrawer implements Drawer {
+    private hitTestCanvasModel;
+    private chartModel;
+    private config;
+    private canvasBoundsContainer;
+    private model;
+    constructor(hitTestCanvasModel: HitTestCanvasModel, chartModel: ChartModel, config: FullChartConfig, canvasBoundsContainer: CanvasBoundsContainer, model: EventsModel);
+    /**
+     * Draws events on the hit test canvas.
+     * @function
+     * @name draw
+     * @memberof CanvasElement.EVENTS
+     * @instance
+     * @returns {void}
+      
+    */
+    draw(): void;
+    /**
+     * Returns an array of string containing the canvas ID of the hitTestCanvasModel.
+     * @returns {Array<string>} An array of string containing the canvas ID of the hitTestCanvasModel.
+     */
+    getCanvasIds(): Array<string>;
+}

package/dist/chart/components/events/events-hit-test.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 f}from"../../canvas/canvas-bounds-container";import{getEventSize as v}from"./events.drawer";const r=5;export class EventsHitTestDrawer{constructor(e,t,s,c,o){this.hitTestCanvasModel=e,this.chartModel=t,this.config=s,this.canvasBoundsContainer=c,this.model=o}draw(){const e=this.hitTestCanvasModel.ctx,t=this.canvasBoundsContainer.getBounds(f.EVENTS);e.save(),this.model.events.forEach((s,c)=>{const o=this.model.events[c-1],l=o&&this.chartModel.candleFromTimestamp(o.timestamp).xCenter(this.chartModel.scaleModel),i=this.chartModel.candleFromTimestamp(s.timestamp).xCenter(this.chartModel.scaleModel);if(i>t.x&&i<t.x+t.width){const h=this.config.colors.events[s.type].color;e.strokeStyle=h,e.fillStyle=h;const n=v(s);e.fillStyle=this.hitTestCanvasModel.idToColor(s.id);const a=(n+r)*2;if(l!==void 0){const d=v(o);if(l+d>i-a/2){const m=n*2+r;e.fillRect(l+d,t.y,m,t.height)}else e.fillRect(i-n-r,t.y,a,t.height)}else e.fillRect(i-n-r,t.y,a,t.height)}}),e.restore()}getCanvasIds(){return[this.hitTestCanvasModel.canvasId]}}

package/dist/chart/components/events/events.component.d.ts

@@ -0,0 +1,45 @@
+/*
+ * 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 { CursorHandler } from '../../canvas/cursor.handler';
+import { ChartBaseElement } from '../../model/chart-base-element';
+import { FullChartConfig } from '../../chart.config';
+import { CanvasModel } from '../../model/canvas.model';
+import { DrawingManager } from '../../drawers/drawing-manager';
+import { HitTestCanvasModel } from '../../model/hit-test-canvas.model';
+import { DateTimeFormatterFactory } from '../../model/date-time.formatter';
+import { ChartModel } from '../chart/chart.model';
+import { EconomicEvent, EventType, EventWithId, EventsModel } from './events.model';
+export declare class EventsComponent extends ChartBaseElement {
+    private config;
+    private canvasModel;
+    private canvasBoundsContainer;
+    private drawingManager;
+    private formatterFactory;
+    eventsModel: EventsModel;
+    private eventsXAxisLabelFormatterProvider;
+    constructor(config: FullChartConfig, canvasModel: CanvasModel, hitTestCanvasModel: HitTestCanvasModel, chartModel: ChartModel, canvasBoundsContainer: CanvasBoundsContainer, drawingManager: DrawingManager, formatterFactory: DateTimeFormatterFactory, cursorHandler: CursorHandler, backgroundCanvasModel: CanvasModel);
+    /**
+     * Sets the new event list.
+     * @param events
+     */
+    setEvents(events: EconomicEvent[]): void;
+    /**
+     * Changes the component visibility.
+     * @param visible
+     */
+    setVisible(visible: boolean): void;
+    /**
+     * Changes visibility for the specific event type.
+     * For example, to turn off dividends visibility you can call this method with { dividends: false } argument
+     */
+    setEventTypeVisible(eventsVisibility: Partial<Record<EventType, boolean>>): void;
+    /**
+     * Observes hovered event when mouse moves in, and provides null when mouse moves out.
+     */
+    observeEventHovered(): Observable<EventWithId | null>;
+}

package/dist/chart/components/events/events.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{CanvasElement as E}from"../../canvas/canvas-bounds-container";import{ChartBaseElement as h}from"../../model/chart-base-element";import{recalculateXFormatter as c}from"../../model/date-time.formatter";import{merge as f}from"../../utils/merge.utils";import{EventsHitTestDrawer as p}from"./events-hit-test.drawer";import{EventsDrawer as w}from"./events.drawer";import{EventsModel as b}from"./events.model";export class EventsComponent extends h{constructor(e,s,n,r,i,o,a,v,m){super(),this.config=e,this.canvasModel=s,this.canvasBoundsContainer=i,this.drawingManager=o,this.formatterFactory=a,this.eventsXAxisLabelFormatterProvider=()=>c(this.config.components.events.xAxisLabelFormat,r.getPeriod(),this.formatterFactory);const t=new b(s);this.eventsModel=t,this.addChildEntity(t),n.addSubscriber(t);const d=new w(m,s,r,e,i,t,this.eventsXAxisLabelFormatterProvider);this.drawingManager.addDrawer(d,"EVENTS");const l=new p(n,r,e,i,t);this.drawingManager.addDrawerBefore(l,"HIT_TEST_EVENTS","HIT_TEST_DRAWINGS"),v.setCursorForCanvasEl(E.EVENTS,e.components.events.cursor)}setEvents(e){this.eventsModel.setEvents(e),this.canvasModel.fireDraw()}setVisible(e){this.config.components.events.visible=e,this.canvasBoundsContainer.recalculateBounds(),this.canvasModel.fireDraw()}setEventTypeVisible(e){f(this.config.components.events.eventsVisibility,e,{overrideExisting:!0,addIfMissing:!1}),this.canvasModel.fireDraw()}observeEventHovered(){return this.eventsModel.hoveredEvent.asObservable()}}

package/dist/chart/components/events/events.drawer.d.ts

@@ -0,0 +1,87 @@
+/*
+ * 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 { Bounds } from '../../model/bounds.model';
+import { CanvasBoundsContainer } from '../../canvas/canvas-bounds-container';
+import { CustomIcon, FullChartConfig } from '../../chart.config';
+import { CanvasModel } from '../../model/canvas.model';
+import { Drawer } from '../../drawers/drawing-manager';
+import { DateTimeFormatter } from '../../model/date-time.formatter';
+import { ChartModel } from '../chart/chart.model';
+import { EconomicEvent, EventsModel, EventType, EventWithId } from './events.model';
+export declare class EventsDrawer implements Drawer {
+    private backgroundCanvas;
+    private canvasModel;
+    private chartModel;
+    private config;
+    private canvasBoundsContainer;
+    private model;
+    private formatterProvider;
+    private customIcons;
+    constructor(backgroundCanvas: CanvasModel, canvasModel: CanvasModel, chartModel: ChartModel, config: FullChartConfig, canvasBoundsContainer: CanvasBoundsContainer, model: EventsModel, formatterProvider: () => DateTimeFormatter);
+    /**
+     * Creates a custom icon for a given event type.
+     * @param {EventType} type - The type of the event.
+     * @param {CustomIcon} [icon] - The custom icon object containing the normal and hover images.
+     * @returns {void}
+     */
+    createCustomIcon(type: EventType, icon?: CustomIcon): void;
+    /**
+     * Creates an icon image from a string containing SVG data.
+     * @param {string} iconString - The string containing SVG data.
+     * @returns {Object} An object containing an Image object and the height of the SVG element.
+     */
+    createIconImage(iconString: string): {
+        img: HTMLImageElement;
+        svgHeight: number;
+    };
+    /**
+     * Draws events on the chart canvas if they are visible according to the configuration.
+     * The events are filtered by type and then iterated over to draw them on the chart.
+     * If a custom icon is available in the cache, it is used to draw the event, otherwise a default event is drawn.
+     * If the event is currently being hovered over, a vertical line is drawn and a label is added to the x-axis.
+     * @returns {void}
+     */
+    draw(): void;
+    /**
+     * Draws a custom SVG event on a canvas context.
+     * @param {CanvasRenderingContext2D} ctx - The canvas context to draw on.
+     * @param {number} x - The x coordinate of the event.
+     * @param {Bounds} bounds - The bounds of the event.
+     * @param {EventWithId} event - The event to draw.
+     * @returns {void}
+     */
+    drawCustomSvgEvent(ctx: CanvasRenderingContext2D, x: number, bounds: Bounds, event: EventWithId): void;
+    /**
+     * Draws a default event on a canvas context.
+     * @param {CanvasRenderingContext2D} ctx - The canvas context to draw on.
+     * @param {number} x - The x coordinate of the event.
+     * @param {Bounds} bounds - The bounds of the event.
+     * @param {EventWithId} event - The event to draw.
+     * @param {string} color - The color of the event.
+     * @returns {void}
+     */
+    drawDefaultEvent(ctx: CanvasRenderingContext2D, x: number, bounds: Bounds, event: EventWithId, color: string): void;
+    /**
+     * This function is responsible for drawing a label on the canvas at a given x coordinate. The label contains a formatted timestamp of a given event. The function takes two parameters: x, which is the x coordinate where the label will be drawn, and event, which is an object containing information about the event, including its timestamp and type.
+     * The function first gets the canvas context and the bounds of the x-axis. It then retrieves the font family, font height, and top padding from the configuration object. The y coordinate of the label is calculated based on the font height, top padding, and the y coordinate of the x-axis bounds. The font is set using the retrieved font family and font height.
+     * The timestamp of the event is formatted using a formatter provider function. The width of the label is calculated using the canvas context's measureText() method. The function then calls another function, redrawBackgroundArea(), to hide the regular x-axis label that may overlap with the event label.
+     * Finally, the function sets the fill style of the canvas context to the color associated with the event type in the configuration object. The label text is then drawn on the canvas context at the calculated x and y coordinates.
+     */
+    drawLabel(x: number, event: EventWithId): void;
+    /**
+     * Returns an array of canvas IDs.
+     *
+     * @returns {Array<string>} An array containing the ID of the canvas model.
+     */
+    getCanvasIds(): Array<string>;
+}
+/**
+ * Returns the size of an event based on its style
+ * @param {EconomicEvent} event - The event to get the size of
+ * @returns {number} - The size of the event
+ 
+*/
+export declare function getEventSize(event: EconomicEvent): number;

package/dist/chart/components/events/events.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 g}from"../../canvas/canvas-bounds-container";import{redrawBackgroundArea as v}from"../../drawers/chart-background.drawer";const f={"rhombus-small":4,rhombus:6,"rhombus-large":8},c=(h,t)=>`${h}_${t}`;export class EventsDrawer{constructor(t,e,o,s,n,i,a){this.backgroundCanvas=t,this.canvasModel=e,this.chartModel=o,this.config=s,this.canvasBoundsContainer=n,this.model=i,this.formatterProvider=a,this.customIcons={};const r=this.config.components.events.icons;r&&(this.createCustomIcon("earnings",r.earnings),this.createCustomIcon("dividends",r.dividends),this.createCustomIcon("splits",r.splits),this.createCustomIcon("conference-calls",r.conferenceCalls))}createCustomIcon(t,e){if(e){const o=this.createIconImage(e.normal),s=this.createIconImage(e.hover);this.customIcons[c(t,"normal")]=o,this.customIcons[c(t,"hover")]=s}}createIconImage(t){var e;const s=new DOMParser().parseFromString(t,"text/html").querySelector("svg");let n=0;s&&(n=parseInt((e=s.getAttribute("height"))!==null&&e!==void 0?e:"",10));const r="data:image/svg+xml;base64,"+btoa(t),l=new Image;return l.src=r,{img:l,svgHeight:n}}draw(){if(!this.config.components.events.visible)return;const t=this.canvasBoundsContainer.getBounds(g.EVENTS),e=this.canvasBoundsContainer.getBounds(g.ALL_PANES),o=this.canvasModel.ctx;o.save(),this.model.events.filter(s=>this.config.components.events.eventsVisibility[s.type]).forEach(s=>{const n=this.chartModel.candleFromTimestamp(s.timestamp).xCenter(this.chartModel.scaleModel);if(n>e.x&&n<e.x+e.width){const i=this.config.colors.events[s.type].color;o.strokeStyle=i,this.customIcons[c(s.type,"hover")]!==void 0?this.drawCustomSvgEvent(o,n,t,s):this.drawDefaultEvent(o,n,t,s,i),this.model.hoveredEvent.getValue()===s&&(o.beginPath(),o.moveTo(n,e.y),o.lineTo(n,t.y+t.height/2),o.stroke(),o.closePath(),this.config.components.xAxis.visible&&this.drawLabel(n,s))}}),o.restore()}drawCustomSvgEvent(t,e,o,s){const n=o.y+o.height/2,i=this.customIcons[c(s.type,"normal")],a=this.customIcons[c(s.type,"hover")];this.model.hoveredEvent.getValue()===s?t.drawImage(a.img,e-a.svgHeight/2,n-a.svgHeight/2):t.drawImage(i.img,e-i.svgHeight/2,n-i.svgHeight/2)}drawDefaultEvent(t,e,o,s,n){const i=o.y+o.height/2;t.fillStyle=n,t.lineWidth=1.5;const a=getEventSize(s);t.beginPath(),t.moveTo(e-a,i),t.lineTo(e,i-a),t.lineTo(e+a,i),t.lineTo(e,i+a),t.closePath(),this.model.hoveredEvent.getValue()===s?t.fill():t.stroke()}drawLabel(t,e){var o;const s=this.canvasModel.ctx,n=this.canvasBoundsContainer.getBounds(g.X_AXIS),i=this.config.components.xAxis.fontFamily,a=this.config.components.xAxis.fontSize,r=(o=this.config.components.xAxis.padding.top)!==null&&o!==void 0?o:0,l=n.y+a-1+r;s.font=`${a}px ${i}`;const d=this.formatterProvider()(e.timestamp),m=s.measureText(d).width;v(this.backgroundCanvas.ctx,s,t-m/2,n.y+1,m,n.height-1),s.fillStyle=this.config.colors.events[e.type].color,s.fillText(d,t-m/2,l)}getCanvasIds(){return[this.canvasModel.canvasId]}}export function getEventSize(h){return f[h.style]}