scichart 2.0.0-alpha.1971 → 2.0.0-alpha.1991

package/Charting/ChartModifiers/LegendModifier.d.ts

@@ -33,6 +33,10 @@ export interface ILegendModifierOptions extends IChartModifierBaseOptions {
      * Sets the margin for the legend control
      */
     margin?: number;
+    /**
+     * The parent div element Id, the Legend will be appended to this element
+     */
+    placementDivId?: string;
 }
 /**
  * The LegendModifier provides interactive legend behavior on a 2D {@link SciChartSurface}

package/Charting/ChartModifiers/LegendModifier.js

@@ -37,7 +37,7 @@ var LegendModifier = /** @class */ (function (_super) {
      * @param options Optional parameters {@link ILegendModifierOptions} used to configure the modifier
      */
     function LegendModifier(options) {
-        var _a, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d, _e, _f, _g;
         var _this = _super.call(this, options) || this;
         _this.type = ChartModifierType_1.EChart2DModifierType.Legend;
         _this.includedSeriesMap = new Map();
@@ -48,6 +48,7 @@ var LegendModifier = /** @class */ (function (_super) {
         _this.sciChartLegend.showSeriesMarkers = (_d = options === null || options === void 0 ? void 0 : options.showSeriesMarkers) !== null && _d !== void 0 ? _d : _this.sciChartLegend.showSeriesMarkers;
         _this.sciChartLegend.placement = (_e = options === null || options === void 0 ? void 0 : options.placement) !== null && _e !== void 0 ? _e : _this.sciChartLegend.placement;
         _this.sciChartLegend.margin = (_f = options === null || options === void 0 ? void 0 : options.margin) !== null && _f !== void 0 ? _f : _this.sciChartLegend.margin;
+        _this.sciChartLegend.placementDivId = (_g = options === null || options === void 0 ? void 0 : options.placementDivId) !== null && _g !== void 0 ? _g : _this.sciChartLegend.placementDivId;
         return _this;
     }
     /**

package/Charting/ChartModifiers/SeriesSelectionModifier.d.ts

@@ -1,10 +1,18 @@
+import { EventHandler } from "../../Core/EventHandler";
+import { EChart2DModifierType } from "../../types/ChartModifierType";
 import { HoveredChangedArgs } from "../Visuals/RenderableSeries/HoveredChangedArgs";
-import { ChartModifierBase2D, IChartModifierBaseOptions } from "./ChartModifierBase2D";
-import { ModifierMouseArgs } from "./ModifierMouseArgs";
 import { IRenderableSeries } from "../Visuals/RenderableSeries/IRenderableSeries";
-import { EventHandler } from "../../Core/EventHandler";
 import { SelectionChangedArgs } from "../Visuals/RenderableSeries/SelectionChangedArgs";
-import { EChart2DModifierType } from "../../types/ChartModifierType";
+import { ChartModifierBase2D, IChartModifierBaseOptions } from "./ChartModifierBase2D";
+import { ModifierMouseArgs } from "./ModifierMouseArgs";
+/**
+ * The type of the {@link ISeriesSelectionModifierOptions.onSelectionChanged } callback function
+ */
+export declare type TSelectionChangedCallback = (args: SelectionChangedArgs) => void;
+/**
+ * The type of the {@link ISeriesSelectionModifierOptions.onHoverChanged } callback function
+ */
+export declare type THoveredChangedCallback = (args: HoveredChangedArgs) => void;
 export interface ISeriesSelectionModifierOptions extends IChartModifierBaseOptions {
     /**
      * A hit-test radius in pixels used when selecting series. Defaults to 7
@@ -25,12 +33,12 @@ export interface ISeriesSelectionModifierOptions extends IChartModifierBaseOptio
      * Optional callback for when any series is selected or deselected
      * @param arg Argument of
      */
-    onSelectionChanged?: ((args: SelectionChangedArgs) => void) | string;
+    onSelectionChanged?: TSelectionChangedCallback | string;
     /**
      * Optional callback for when any series is hovered or unhovered
      * @param arg
      */
-    onHoverChanged?: ((args: HoveredChangedArgs) => void) | string;
+    onHoverChanged?: THoveredChangedCallback | string;
 }
 export declare class SeriesSelectionModifier extends ChartModifierBase2D {
     readonly type = EChart2DModifierType.SeriesSelection;

package/Charting/ChartModifiers/SeriesSelectionModifier.js

@@ -14,14 +14,16 @@ var __extends = (this && this.__extends) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SeriesSelectionModifier = void 0;
+var classFactory_1 = require("../../Builder/classFactory");
+var EventHandler_1 = require("../../Core/EventHandler");
+var BaseType_1 = require("../../types/BaseType");
+var ChartModifierType_1 = require("../../types/ChartModifierType");
+var array_1 = require("../../utils/array");
 var BaseHitTestProvider_1 = require("../Visuals/RenderableSeries/HitTest/BaseHitTestProvider");
 var HoveredChangedArgs_1 = require("../Visuals/RenderableSeries/HoveredChangedArgs");
+var SelectionChangedArgs_1 = require("../Visuals/RenderableSeries/SelectionChangedArgs");
 var ChartModifierBase2D_1 = require("./ChartModifierBase2D");
 var constants_1 = require("./constants");
-var EventHandler_1 = require("../../Core/EventHandler");
-var SelectionChangedArgs_1 = require("../Visuals/RenderableSeries/SelectionChangedArgs");
-var array_1 = require("../../utils/array");
-var ChartModifierType_1 = require("../../types/ChartModifierType");
 var SeriesSelectionModifier = /** @class */ (function (_super) {
     __extends(SeriesSelectionModifier, _super);
     /**
@@ -58,22 +60,20 @@ var SeriesSelectionModifier = /** @class */ (function (_super) {
         if (options === null || options === void 0 ? void 0 : options.onSelectionChanged) {
             if (typeof options.onSelectionChanged === "string") {
                 _this.typeMap.set("onSelectionChanged", options.onSelectionChanged);
-                //@ts-ignore
-                _this.selectionChanged.subscribe(getFunction(EBaseType.OptionFunction, options.onSelectionChanged));
+                var onSelectionChangedCallback = classFactory_1.getFunction(BaseType_1.EBaseType.OptionFunction, options.onSelectionChanged);
+                _this.selectionChanged.subscribe(onSelectionChangedCallback);
             }
             else {
-                //@ts-ignore
                 _this.selectionChanged.subscribe(options.onSelectionChanged);
             }
         }
         if (options === null || options === void 0 ? void 0 : options.onHoverChanged) {
             if (typeof options.onHoverChanged === "string") {
                 _this.typeMap.set("onHoverChanged", options.onHoverChanged);
-                //@ts-ignore
-                _this.hoverChanged.subscribe(getFunction(EBaseType.OptionFunction, options.onHoverChanged));
+                var onHoverChangedCallback = classFactory_1.getFunction(BaseType_1.EBaseType.OptionFunction, options.onHoverChanged);
+                _this.hoverChanged.subscribe(onHoverChangedCallback);
             }
             else {
-                //@ts-ignore
                 _this.hoverChanged.subscribe(options.onHoverChanged);
             }
         }

package/Charting/ChartModifiers/ZoomExtentsModifier.d.ts

@@ -1,7 +1,12 @@
 import { TEasing } from "../../Core/Animations/EasingFunctions";
 import { EChart2DModifierType } from "../../types/ChartModifierType";
+import { SciChartSurface } from "../Visuals/SciChartSurface";
 import { ChartModifierBase2D, IChartModifierBaseOptions } from "./ChartModifierBase2D";
 import { ModifierMouseArgs } from "./ModifierMouseArgs";
+/**
+ * A function to execute when zoomExtents is activated.  If this exists and returns false, the builtin behaviour is ignored;
+ */
+export declare type TZoomExtentsCallback = (sciChartSurface: SciChartSurface) => boolean;
 /**
  * Optional parameters used to configure a {@link ZoomExtentsModifier} at construct time
  */
@@ -18,6 +23,10 @@ export interface IZoomExtentsModifierOptions extends IChartModifierBaseOptions {
      * Defines the easing function for animation. See {@link TEasing} for a range of functions
      */
     easingFunction?: TEasing | string;
+    /**
+     * A function to execute when zoomExtents is activated.  If this exists and returns false, the builtin behaviour is ignored;
+     */
+    onZoomExtents?: TZoomExtentsCallback | string;
 }
 /**
  * The ZoomExtentsModifier provides double-tap or double-click to zoom-to-fit (Zoom Extents) behavior
@@ -49,6 +58,10 @@ export declare class ZoomExtentsModifier extends ChartModifierBase2D {
      * Defines the easing function for animation. See {@link TEasing} for a range of functions
      */
     easingFunction: TEasing;
+    /**
+     * A function to execute when zoomExtents is activated.  If this exists and returns false, the builtin behaviour is ignored;
+     */
+    onZoomExtents?: (sciChartSurface: SciChartSurface) => boolean;
     constructor(options?: IZoomExtentsModifierOptions);
     /**
      * @inheritDoc

package/Charting/ChartModifiers/ZoomExtentsModifier.js

@@ -14,7 +14,9 @@ var __extends = (this && this.__extends) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZoomExtentsModifier = void 0;
+var classFactory_1 = require("../../Builder/classFactory");
 var EasingFunctions_1 = require("../../Core/Animations/EasingFunctions");
+var BaseType_1 = require("../../types/BaseType");
 var ChartModifierType_1 = require("../../types/ChartModifierType");
 var ZoomState_1 = require("../../types/ZoomState");
 var ChartModifierBase2D_1 = require("./ChartModifierBase2D");
@@ -58,6 +60,13 @@ var ZoomExtentsModifier = /** @class */ (function (_super) {
             options.easingFunction = EasingFunctions_1.easing[options.easingFunction];
         }
         _this.easingFunction = (_c = options === null || options === void 0 ? void 0 : options.easingFunction) !== null && _c !== void 0 ? _c : EasingFunctions_1.easing.outExpo;
+        if (options === null || options === void 0 ? void 0 : options.onZoomExtents) {
+            if (typeof options.onZoomExtents === "string") {
+                _this.typeMap.set("onZoomExtents", options.onZoomExtents);
+                options.onZoomExtents = classFactory_1.getFunction(BaseType_1.EBaseType.OptionFunction, options.onZoomExtents);
+            }
+        }
+        _this.onZoomExtents = options === null || options === void 0 ? void 0 : options.onZoomExtents;
         return _this;
     }
     /**
@@ -66,9 +75,11 @@ var ZoomExtentsModifier = /** @class */ (function (_super) {
     ZoomExtentsModifier.prototype.modifierDoubleClick = function (args) {
         var scs = this.parentSurface;
         if (scs !== undefined) {
-            var animationDuration = this.isAnimated ? this.animationDuration : 0;
-            scs.zoomExtents(animationDuration, this.easingFunction, function () { return scs.setZoomState(ZoomState_1.EZoomState.AtExtents); });
-            args.handled = true;
+            if (!this.onZoomExtents || this.onZoomExtents(scs)) {
+                var animationDuration = this.isAnimated ? this.animationDuration : 0;
+                scs.zoomExtents(animationDuration, this.easingFunction, function () { return scs.setZoomState(ZoomState_1.EZoomState.AtExtents); });
+                args.handled = true;
+            }
         }
     };
     ZoomExtentsModifier.prototype.toJSON = function () {
@@ -76,7 +87,8 @@ var ZoomExtentsModifier = /** @class */ (function (_super) {
         var options = {
             animationDuration: this.animationDuration,
             easingFunction: this.easingFunction.name,
-            isAnimated: this.isAnimated
+            isAnimated: this.isAnimated,
+            onZoomExtents: this.typeMap.get("onZoomExtents")
         };
         Object.assign(json.options, options);
         return json;

package/Charting/Drawing/BrushCache.js

@@ -47,20 +47,18 @@ var BrushCache = /** @class */ (function (_super) {
      * @param fillLinearGradient
      */
     BrushCache.prototype.create = function (fill, opacity, fillLinearGradient) {
-        if (this.cachedEntity
-            && fill === this.fill
-            && opacity === this.opacity
-            && fillLinearGradient === this.fillLinearGradient) {
+        if (this.cachedEntity &&
+            fill === this.fill &&
+            opacity === this.opacity &&
+            fillLinearGradient === this.fillLinearGradient) {
             return this.cachedEntity;
         }
         this.invalidateCache();
         this.fill = fill;
         this.opacity = opacity;
         this.fillLinearGradient = fillLinearGradient;
-        var brush = fillLinearGradient
-            ? this.createGradientBrush()
-            : this.createSolidBrush(fill, opacity);
-        return this.cachedEntity = new WebGlBrush_1.WebGlBrush(brush);
+        var brush = fillLinearGradient ? this.createGradientBrush() : this.createSolidBrush(fill, opacity);
+        return (this.cachedEntity = new WebGlBrush_1.WebGlBrush(brush));
     };
     BrushCache.prototype.invalidateCache = function () {
         _super.prototype.invalidateCache.call(this);

package/Charting/LayoutManager/BottomAlignedOuterHorizontallyStackedAxisLayoutStrategy.js

@@ -57,6 +57,7 @@ var BottomAlignedOuterHorizontallyStackedAxisLayoutStrategy = /** @class */ (fun
             leftOffset += additionalLeftSize;
             axis.offset = leftOffset - left;
             axis.axisLength = rightOffset - leftOffset;
+            axis.isStackedAxis = true;
             axis.isPrimaryAxis = true;
             axis.viewRect = Rect_1.Rect.createWithCoords(leftOffset, topOffset, rightOffset, bottomOffset);
             leftOffset = rightOffset + additionalRightSize;

package/Charting/LayoutManager/LeftAlignedOuterVerticallyStackedAxisLayoutStrategy.js

@@ -57,6 +57,7 @@ var LeftAlignedOuterVerticallyStackedAxisLayoutStrategy = /** @class */ (functio
             topOffset += additionalTopSize;
             axis.offset = topOffset - top;
             axis.axisLength = bottomOffset - topOffset;
+            axis.isStackedAxis = true;
             axis.isPrimaryAxis = true;
             axis.viewRect = Rect_1.Rect.createWithCoords(leftOffset, topOffset, rightOffset, bottomOffset);
             topOffset = bottomOffset + additionalBottomSize;

package/Charting/LayoutManager/RightAlignedOuterVerticallyStackedAxisLayoutStrategy.js

@@ -57,6 +57,7 @@ var RightAlignedOuterVerticallyStackedAxisLayoutStrategy = /** @class */ (functi
             topOffset += additionalTopSize;
             axis.offset = topOffset - top;
             axis.axisLength = bottomOffset - topOffset;
+            axis.isStackedAxis = true;
             axis.isPrimaryAxis = true;
             axis.viewRect = Rect_1.Rect.createWithCoords(leftOffset, topOffset, rightOffset, bottomOffset);
             topOffset = bottomOffset + additionalBottomSize;

package/Charting/LayoutManager/TopAlignedOuterHorizontallyStackedAxisLayoutStrategy.js

@@ -57,6 +57,7 @@ var TopAlignedOuterHorizontallyStackedAxisLayoutStrategy = /** @class */ (functi
             leftOffset += additionalLeftSize;
             axis.offset = leftOffset - left;
             axis.axisLength = rightOffset - leftOffset;
+            axis.isStackedAxis = true;
             axis.isPrimaryAxis = true;
             axis.viewRect = Rect_1.Rect.createWithCoords(leftOffset, topOffset, rightOffset, bottomOffset);
             leftOffset = rightOffset + additionalRightSize;

package/Charting/Model/BaseDataSeries.d.ts

@@ -2,7 +2,8 @@ import { TSeriesDataDefinition } from "../../Builder/buildDataSeries";
 import { EventHandler } from "../../Core/EventHandler";
 import { NumberRange } from "../../Core/NumberRange";
 import { DoubleVector, TSciChart } from "../../types/TSciChart";
-import { EDataChangeType, EDataSeriesType, IDataChangeArgs, IDataSeries } from "./IDataSeries";
+import { BaseAnimation } from "../Visuals/RenderableSeries/Animations/BaseAnimation";
+import { EDataChangeType, EDataSeriesType, EDataSeriesValueType, IDataChangeArgs, IDataSeries } from "./IDataSeries";
 import { IMetadataGenerator, IPointMetadata } from "./IPointMetadata";
 /**
  * Options to pass to the {@link BaseDataSeries} constructor
@@ -45,13 +46,9 @@ export interface IBaseDataSeriesOptions {
  * See derived types of {@link IRenderableSeries} to find out what 2D JavaScript Chart types are available.
  */
 export declare abstract class BaseDataSeries implements IDataSeries {
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     abstract readonly type: EDataSeriesType;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     readonly dataChanged: EventHandler<IDataChangeArgs>;
     minXSpacing: number;
     /**
@@ -62,6 +59,22 @@ export declare abstract class BaseDataSeries implements IDataSeries {
      * The {@link TSciChart | SciChart WebAssembly Context} containing native methods and access to our WebGL2 Engine
      */
     readonly webAssemblyContext: TSciChart;
+    /**
+     * X vector with initial animation values
+     */
+    xInitialAnimationValues: DoubleVector;
+    /**
+     * Y vector with initial animation values
+     */
+    yInitialAnimationValues: DoubleVector;
+    /**
+     * X vector with final animation values
+     */
+    xFinalAnimationValues: DoubleVector;
+    /**
+     * Y vector with final animation values
+     */
+    yFinalAnimationValues: DoubleVector;
     protected xValues: DoubleVector;
     protected yValues: DoubleVector;
     protected indexes: DoubleVector;
@@ -78,70 +91,42 @@ export declare abstract class BaseDataSeries implements IDataSeries {
      * @param options the {@link IBaseDataSeriesOptions} which can be passed to config the DataSeries at construct time
      */
     protected constructor(webAssemblyContext: TSciChart, options?: IBaseDataSeriesOptions);
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     get containsNaN(): boolean;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     set containsNaN(containsNaN: boolean);
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     get isSorted(): boolean;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     set isSorted(isSorted: boolean);
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     get dataSeriesName(): string;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     set dataSeriesName(dataSeriesName: string);
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     count(): number;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     getIsDeleted(): boolean;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     getNativeIndexes(): DoubleVector;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     getNativeXValues(): DoubleVector;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     getNativeYValues(): DoubleVector;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     delete(): void;
     /**
      * Call to notify subscribers of {@link dataChanged} that the data has changed and {@link SciChartSurface} needs redrawing
      */
     notifyDataChanged(changeType: EDataChangeType, index: number, count: number, name?: string): void;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     get xRange(): NumberRange;
-    /**
-     * @inheritDoc
-     */
-    getWindowedYRange(xRange: NumberRange, getPositiveRange: boolean, isXCategoryAxis?: boolean): NumberRange;
+    /** @inheritDoc */
+    getXRange(dataSeriesValueType?: EDataSeriesValueType): NumberRange;
+    /** @inheritDoc */
+    getWindowedYRange(xRange: NumberRange, getPositiveRange: boolean, isXCategoryAxis?: boolean, dataSeriesValueType?: EDataSeriesValueType): NumberRange;
     getIndicesRange(xRange: NumberRange): NumberRange;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     get hasValues(): boolean;
     /**
      * Check if the series has an existing metadaGenerator
@@ -161,6 +146,27 @@ export declare abstract class BaseDataSeries implements IDataSeries {
      * Gets the metadata array length
      */
     getMetadataLength(): number;
+    /**
+     * Sets initial values for the data animation
+     * @param dataSeries The {@link BaseDataSeries} to be used for initial values
+     */
+    setInitialAnimationVectors(dataSeries?: BaseDataSeries): void;
+    /**
+     * Sets final values for the data animation
+     * @param dataSeries The {@link BaseDataSeries} to be used for final values
+     */
+    setFinalAnimationVectors(dataSeries?: BaseDataSeries): void;
+    /**
+     * Validates the length of the animation vectors
+     */
+    validateAnimationVectors(): void;
+    /**
+     * Updates the {@link BaseDataSeries} values for the animation
+     * @param progress The animation progress from 0 to 1
+     * @param animation The animation
+     */
+    updateAnimationProperties(progress: number, animation: BaseAnimation): void;
+    /** @inheritDoc */
     toJSON(excludeData?: boolean): TSeriesDataDefinition;
     protected validateIndex(index: number, message?: string): void;
     protected setMetadataAt(index: number, metadata: IPointMetadata): void;
@@ -171,6 +177,8 @@ export declare abstract class BaseDataSeries implements IDataSeries {
     protected removeMetadataAt(index: number): void;
     protected removeMetadataRange(startIndex: number, count: number): void;
     protected setMetadata(value: IPointMetadata[]): void;
+    protected getXValues(dataSeriesValueType: EDataSeriesValueType): DoubleVector;
     private fillMetadataIfUndefined;
+    private getYValues;
 }
 export declare const getWindowedYRange: (webAssemblyContext: TSciChart, xValues: DoubleVector, yValues: DoubleVector, xRange: NumberRange, getPositiveRange: boolean, isXCategoryAxis: boolean, isSorted: boolean) => NumberRange;

package/Charting/Model/BaseDataSeries.js

@@ -26,6 +26,7 @@ var NumberRange_1 = require("../../Core/NumberRange");
 var BaseType_1 = require("../../types/BaseType");
 var fillDoubleVectorFromJsArray_1 = require("../../utils/ccall/fillDoubleVectorFromJsArray");
 var isRealNumber_1 = require("../../utils/isRealNumber");
+var animationHelpers_1 = require("../Visuals/RenderableSeries/Animations/animationHelpers");
 var IDataSeries_1 = require("./IDataSeries");
 var IPointMetadata_1 = require("./IPointMetadata");
 /**
@@ -47,9 +48,7 @@ var BaseDataSeries = /** @class */ (function () {
      */
     function BaseDataSeries(webAssemblyContext, options) {
         var _a, _b, _c;
-        /**
-         * @inheritDoc
-         */
+        /** @inheritDoc */
         this.dataChanged = new EventHandler_1.EventHandler();
         this.minXSpacing = 0;
         this.isSortedProperty = true;
@@ -59,6 +58,10 @@ var BaseDataSeries = /** @class */ (function () {
         this.xValues = new webAssemblyContext.DoubleVector();
         this.yValues = new webAssemblyContext.DoubleVector();
         this.indexes = new webAssemblyContext.DoubleVector();
+        this.xInitialAnimationValues = new webAssemblyContext.DoubleVector();
+        this.yInitialAnimationValues = new webAssemblyContext.DoubleVector();
+        this.xFinalAnimationValues = new webAssemblyContext.DoubleVector();
+        this.yFinalAnimationValues = new webAssemblyContext.DoubleVector();
         this.dataSeriesNameProperty = (_a = options === null || options === void 0 ? void 0 : options.dataSeriesName) !== null && _a !== void 0 ? _a : this.dataSeriesNameProperty;
         this.isSorted = (options === null || options === void 0 ? void 0 : options.dataIsSortedInX) !== undefined ? options === null || options === void 0 ? void 0 : options.dataIsSortedInX : this.isSortedProperty;
         this.containsNaN = (_b = options === null || options === void 0 ? void 0 : options.containsNaN) !== null && _b !== void 0 ? _b : this.containsNaNProperty;
@@ -74,15 +77,11 @@ var BaseDataSeries = /** @class */ (function () {
         }
     }
     Object.defineProperty(BaseDataSeries.prototype, "containsNaN", {
-        /**
-         * @inheritDoc
-         */
+        /** @inheritDoc */
         get: function () {
             return this.containsNaNProperty;
         },
-        /**
-         * @inheritDoc
-         */
+        /** @inheritDoc */
         set: function (containsNaN) {
             this.containsNaNProperty = containsNaN;
             this.notifyDataChanged(IDataSeries_1.EDataChangeType.Property, undefined, undefined, "containsNaN");
@@ -91,15 +90,11 @@ var BaseDataSeries = /** @class */ (function () {
         configurable: true
     });
     Object.defineProperty(BaseDataSeries.prototype, "isSorted", {
-        /**
-         * @inheritDoc
-         */
+        /** @inheritDoc */
         get: function () {
             return this.isSortedProperty;
         },
-        /**
-         * @inheritDoc
-         */
+        /** @inheritDoc */
         set: function (isSorted) {
             this.isSortedProperty = isSorted;
             this.notifyDataChanged(IDataSeries_1.EDataChangeType.Property, undefined, undefined, "isSorted");
@@ -108,15 +103,11 @@ var BaseDataSeries = /** @class */ (function () {
         configurable: true
     });
     Object.defineProperty(BaseDataSeries.prototype, "dataSeriesName", {
-        /**
-         * @inheritDoc
-         */
+        /** @inheritDoc */
         get: function () {
             return this.dataSeriesNameProperty;
         },
-        /**
-         * @inheritDoc
-         */
+        /** @inheritDoc */
         set: function (dataSeriesName) {
             this.dataSeriesNameProperty = dataSeriesName;
             this.notifyDataChanged(IDataSeries_1.EDataChangeType.Property, undefined, undefined, "dataSeriesName");
@@ -124,24 +115,18 @@ var BaseDataSeries = /** @class */ (function () {
         enumerable: false,
         configurable: true
     });
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     BaseDataSeries.prototype.count = function () {
         if (this.xValues) {
             return this.xValues.size();
         }
         return 0;
     };
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     BaseDataSeries.prototype.getIsDeleted = function () {
         return this.isDeleted;
     };
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     BaseDataSeries.prototype.getNativeIndexes = function () {
         if (!this.indexes) {
             return undefined;
@@ -154,25 +139,23 @@ var BaseDataSeries = /** @class */ (function () {
         }
         return this.indexes;
     };
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     BaseDataSeries.prototype.getNativeXValues = function () {
         return this.xValues;
     };
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     BaseDataSeries.prototype.getNativeYValues = function () {
         return this.yValues;
     };
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     BaseDataSeries.prototype.delete = function () {
         this.xValues = Deleter_1.deleteSafe(this.xValues);
         this.yValues = Deleter_1.deleteSafe(this.yValues);
         this.indexes = Deleter_1.deleteSafe(this.indexes);
+        this.xInitialAnimationValues = Deleter_1.deleteSafe(this.xInitialAnimationValues);
+        this.yInitialAnimationValues = Deleter_1.deleteSafe(this.yInitialAnimationValues);
+        this.xFinalAnimationValues = Deleter_1.deleteSafe(this.xFinalAnimationValues);
+        this.yFinalAnimationValues = Deleter_1.deleteSafe(this.yFinalAnimationValues);
         this.setMetadata(undefined);
         this.isDeleted = true;
     };
@@ -183,60 +166,61 @@ var BaseDataSeries = /** @class */ (function () {
         this.dataChanged.raiseEvent({ changeType: changeType, index: index, count: count });
     };
     Object.defineProperty(BaseDataSeries.prototype, "xRange", {
-        /**
-         * @inheritDoc
-         */
+        /** @inheritDoc */
         get: function () {
-            var nativeValues = this.getNativeXValues();
-            var temp;
-            if (this.count() === 1) {
-                var min = nativeValues.get(0) - 1;
-                var max = nativeValues.get(0) + 1;
-                return new NumberRange_1.NumberRange(min, max);
-            }
-            else if (this.count() > 1) {
-                var min = nativeValues.get(0);
-                var max = nativeValues.get(this.count() - 1);
-                if (!this.isSorted) {
-                    for (var i = 0; i < this.count(); i++) {
-                        if (nativeValues.get(i) < min) {
-                            min = nativeValues.get(i);
-                        }
-                        if (nativeValues.get(i) > max) {
-                            max = nativeValues.get(i);
-                        }
-                    }
-                }
-                if (min === max) {
-                    return new NumberRange_1.NumberRange(min - 1, max + 1);
-                }
-                else if (min > max) {
-                    temp = min;
-                    min = max;
-                    max = temp;
-                }
-                return new NumberRange_1.NumberRange(min, max);
-            }
-            return new NumberRange_1.NumberRange();
+            return this.getXRange();
         },
         enumerable: false,
         configurable: true
     });
-    /**
-     * @inheritDoc
-     */
-    BaseDataSeries.prototype.getWindowedYRange = function (xRange, getPositiveRange, isXCategoryAxis) {
+    /** @inheritDoc */
+    BaseDataSeries.prototype.getXRange = function (dataSeriesValueType) {
+        var xValues = this.getXValues(dataSeriesValueType);
+        var temp;
+        if (this.count() === 1) {
+            var min = xValues.get(0) - 1;
+            var max = xValues.get(0) + 1;
+            return new NumberRange_1.NumberRange(min, max);
+        }
+        else if (this.count() > 1) {
+            var min = xValues.get(0);
+            var max = xValues.get(this.count() - 1);
+            if (!this.isSorted) {
+                for (var i = 0; i < this.count(); i++) {
+                    if (xValues.get(i) < min) {
+                        min = xValues.get(i);
+                    }
+                    if (xValues.get(i) > max) {
+                        max = xValues.get(i);
+                    }
+                }
+            }
+            if (min === max) {
+                return new NumberRange_1.NumberRange(min - 1, max + 1);
+            }
+            else if (min > max) {
+                temp = min;
+                min = max;
+                max = temp;
+            }
+            return new NumberRange_1.NumberRange(min, max);
+        }
+        return new NumberRange_1.NumberRange();
+    };
+    /** @inheritDoc */
+    BaseDataSeries.prototype.getWindowedYRange = function (xRange, getPositiveRange, isXCategoryAxis, dataSeriesValueType) {
         if (isXCategoryAxis === void 0) { isXCategoryAxis = false; }
-        return exports.getWindowedYRange(this.webAssemblyContext, this.xValues, this.yValues, xRange, getPositiveRange, isXCategoryAxis, this.isSorted);
+        if (dataSeriesValueType === void 0) { dataSeriesValueType = IDataSeries_1.EDataSeriesValueType.Default; }
+        var xValues = this.getXValues(dataSeriesValueType);
+        var yValues = this.getYValues(dataSeriesValueType);
+        return exports.getWindowedYRange(this.webAssemblyContext, xValues, yValues, xRange, getPositiveRange, isXCategoryAxis, this.isSorted);
     };
     BaseDataSeries.prototype.getIndicesRange = function (xRange) {
         // TODO SearchMode downSearchMode = SearchMode.RoundDown, SearchMode upSearchMode = SearchMode.RoundUp
         return getIndicesRange(this.webAssemblyContext, this.xValues, xRange, this.isSorted);
     };
     Object.defineProperty(BaseDataSeries.prototype, "hasValues", {
-        /**
-         * @inheritDoc
-         */
+        /** @inheritDoc */
         get: function () {
             return this.count() > 0;
         },
@@ -284,6 +268,58 @@ var BaseDataSeries = /** @class */ (function () {
         }
         return this.metadataProperty.length;
     };
+    /**
+     * Sets initial values for the data animation
+     * @param dataSeries The {@link BaseDataSeries} to be used for initial values
+     */
+    BaseDataSeries.prototype.setInitialAnimationVectors = function (dataSeries) {
+        if (!dataSeries) {
+            this.xInitialAnimationValues.resize(0, 0);
+            this.yInitialAnimationValues.resize(0, 0);
+            return;
+        }
+        animationHelpers_1.animationHelpers.copyVector(dataSeries.getNativeXValues(), this.xInitialAnimationValues);
+        animationHelpers_1.animationHelpers.copyVector(dataSeries.getNativeYValues(), this.yInitialAnimationValues);
+    };
+    /**
+     * Sets final values for the data animation
+     * @param dataSeries The {@link BaseDataSeries} to be used for final values
+     */
+    BaseDataSeries.prototype.setFinalAnimationVectors = function (dataSeries) {
+        if (!dataSeries) {
+            this.xFinalAnimationValues.resize(0, 0);
+            this.yFinalAnimationValues.resize(0, 0);
+            return;
+        }
+        animationHelpers_1.animationHelpers.copyVector(dataSeries.getNativeXValues(), this.xFinalAnimationValues);
+        animationHelpers_1.animationHelpers.copyVector(dataSeries.getNativeYValues(), this.yFinalAnimationValues);
+    };
+    /**
+     * Validates the length of the animation vectors
+     */
+    BaseDataSeries.prototype.validateAnimationVectors = function () {
+        var size = this.xInitialAnimationValues.size();
+        if (size !== this.yInitialAnimationValues.size() ||
+            size !== this.xFinalAnimationValues.size() ||
+            size !== this.yFinalAnimationValues.size()) {
+            throw Error("initialAnimationValues and finalAnimationValues must have the same length");
+        }
+    };
+    /**
+     * Updates the {@link BaseDataSeries} values for the animation
+     * @param progress The animation progress from 0 to 1
+     * @param animation The animation
+     */
+    BaseDataSeries.prototype.updateAnimationProperties = function (progress, animation) {
+        if (animation.isOnStartAnimation) {
+            animation.calculateAnimationValues(this.webAssemblyContext, this.yFinalAnimationValues, this.getNativeYValues(), progress);
+        }
+        else if (animation.isDataSeriesAnimation) {
+            animation.calculateDataSeriesAnimationValues(this.webAssemblyContext, this.xInitialAnimationValues, this.xFinalAnimationValues, this.getNativeXValues(), progress);
+            animation.calculateDataSeriesAnimationValues(this.webAssemblyContext, this.yInitialAnimationValues, this.yFinalAnimationValues, this.getNativeYValues(), progress);
+        }
+    };
+    /** @inheritDoc */
     BaseDataSeries.prototype.toJSON = function (excludeData) {
         if (excludeData === void 0) { excludeData = false; }
         var options = __assign({ containsNaN: this.containsNaN, dataIsSortedInX: this.isSorted, dataSeriesName: this.dataSeriesName, 
@@ -379,12 +415,40 @@ var BaseDataSeries = /** @class */ (function () {
     BaseDataSeries.prototype.setMetadata = function (value) {
         this.metadataProperty = value;
     };
+    BaseDataSeries.prototype.getXValues = function (dataSeriesValueType) {
+        var xValues;
+        switch (dataSeriesValueType) {
+            case IDataSeries_1.EDataSeriesValueType.FinalAnimationValues:
+                xValues = this.xFinalAnimationValues;
+                break;
+            case IDataSeries_1.EDataSeriesValueType.InitialAnimationValues:
+                xValues = this.xInitialAnimationValues;
+                break;
+            default:
+                xValues = this.xValues;
+        }
+        return xValues;
+    };
     BaseDataSeries.prototype.fillMetadataIfUndefined = function () {
         if (this.metadataProperty === undefined) {
             var length_1 = this.count();
             this.metadataProperty = Array(length_1).fill(undefined);
         }
     };
+    BaseDataSeries.prototype.getYValues = function (dataSeriesValueType) {
+        var yValues;
+        switch (dataSeriesValueType) {
+            case IDataSeries_1.EDataSeriesValueType.FinalAnimationValues:
+                yValues = this.yFinalAnimationValues;
+                break;
+            case IDataSeries_1.EDataSeriesValueType.InitialAnimationValues:
+                yValues = this.yInitialAnimationValues;
+                break;
+            default:
+                yValues = this.yValues;
+        }
+        return yValues;
+    };
     return BaseDataSeries;
 }());
 exports.BaseDataSeries = BaseDataSeries;