scichart 2.0.2195 → 2.1.2261

package/Charting/Visuals/SciChartSurfaceBase.js

@@ -420,8 +420,7 @@ var SciChartSurfaceBase = /** @class */ (function () {
     return SciChartSurfaceBase;
 }());
 exports.SciChartSurfaceBase = SciChartSurfaceBase;
-var createChartDestination = function (canvasId) {
-    var canvas = document.querySelector("#".concat(canvasId));
+var createChartDestination = function (canvas) {
     if (!canvas)
         return undefined;
     return {
@@ -475,8 +474,9 @@ var getMasterCanvas = function () {
     return SciChartSurfaceBase.domMasterCanvas;
 };
 exports.getMasterCanvas = getMasterCanvas;
-var copyToCanvas = function (sourceCanvas) { return function (destinationId) {
-    var destinationCanvas = document.querySelector("#".concat(destinationId));
+var copyToCanvas = function (sourceCanvas, getDestinationById) { return function (destinationId) {
+    var destination = getDestinationById(destinationId);
+    var destinationCanvas = destination === null || destination === void 0 ? void 0 : destination.sciChartSurface.domCanvas2D;
     if (destinationCanvas) {
         var destinationCanvasContext = destinationCanvas.getContext("2d");
         destinationCanvasContext.clearRect(0, 0, destinationCanvasContext.canvas.width, destinationCanvasContext.canvas.height);

package/Charting/Visuals/createMaster.d.ts

@@ -2,6 +2,6 @@ import { I2DSurfaceOptions } from "./I2DSurfaceOptions";
 import { TWebAssemblyChart } from "./SciChartSurface";
 import { TSciChartDestination } from "./SciChartSurfaceBase";
 /** @ignore */
-export declare const createMultichart: (divElementId: string, options?: I2DSurfaceOptions) => Promise<TWebAssemblyChart>;
+export declare const createMultichart: (divElement: string | HTMLDivElement, options?: I2DSurfaceOptions) => Promise<TWebAssemblyChart>;
 /** @ignore */
 export declare const sciChartDestinations: TSciChartDestination[];

package/Charting/Visuals/createMaster.js

@@ -57,14 +57,14 @@ var sciChartMaster = {
 /** @ignore */
 var sciChartMasterPromise;
 /** @ignore */
-var createMultichart = function (divElementId, options) { return __awaiter(void 0, void 0, void 0, function () {
-    var canvases, loader, loaderDiv, master, createChildSurface, wasmContext_1, sciChartSurface_1, err_1;
+var createMultichart = function (divElement, options) { return __awaiter(void 0, void 0, void 0, function () {
+    var canvases, loader, loaderDiv, master, createChildSurface, wasmContext_1, divElementId, sciChartSurface_1, err_1;
     var _a, _b, _c;
     return __generator(this, function (_d) {
         switch (_d.label) {
             case 0:
-                sciChartInitCommon_1.default.checkChartDivExists(divElementId);
-                canvases = sciChartInitCommon_1.default.initCanvas(divElementId, (_a = options === null || options === void 0 ? void 0 : options.widthAspect) !== null && _a !== void 0 ? _a : 0, (_b = options === null || options === void 0 ? void 0 : options.heightAspect) !== null && _b !== void 0 ? _b : 0, sciChartInitCommon_1.default.ECanvasType.canvas2D);
+                sciChartInitCommon_1.default.checkChartDivExists(divElement);
+                canvases = sciChartInitCommon_1.default.initCanvas(divElement, (_a = options === null || options === void 0 ? void 0 : options.widthAspect) !== null && _a !== void 0 ? _a : 0, (_b = options === null || options === void 0 ? void 0 : options.heightAspect) !== null && _b !== void 0 ? _b : 0, sciChartInitCommon_1.default.ECanvasType.canvas2D);
                 loader = (_c = options === null || options === void 0 ? void 0 : options.loader) !== null && _c !== void 0 ? _c : new loader_1.DefaultSciChartLoader();
                 loaderDiv = loader.addChartLoader(canvases.domDivContainer, options === null || options === void 0 ? void 0 : options.theme);
                 _d.label = 1;
@@ -85,6 +85,7 @@ var createMultichart = function (divElementId, options) { return __awaiter(void
                 _d.label = 3;
             case 3:
                 createChildSurface = sciChartMaster.createChildSurface, wasmContext_1 = sciChartMaster.wasmContext;
+                divElementId = canvases.domChartRoot.id;
                 sciChartSurface_1 = createChildSurface(divElementId, canvases, options === null || options === void 0 ? void 0 : options.theme);
                 return [2 /*return*/, new Promise(function (resolve) {
                         setTimeout(function () {
@@ -147,7 +148,7 @@ var createMaster = function () {
         return sciChartSurface;
     };
     var addDestination = function (wasmContext, canvasElementId, sciChartSurface, width, height, chartInitObj) {
-        var newDestination = (0, SciChartSurfaceBase_1.createChartDestination)(canvasElementId);
+        var newDestination = (0, SciChartSurfaceBase_1.createChartDestination)(sciChartSurface.domCanvas2D);
         if (!newDestination) {
             sciChartSurface.delete();
             return;
@@ -212,7 +213,7 @@ var createMaster = function () {
             wasmContext.SCRTSetGlobalSampleChartInterface(chartInitObj);
             /// create an object that native side can trigger the copy to from...
             var canvasCopyObj = wasmContext.SCRTCopyToDestinationInterface.implement({
-                CopyToDestination: (0, SciChartSurfaceBase_1.copyToCanvas)(SciChartSurfaceBase_1.SciChartSurfaceBase.domMasterCanvas)
+                CopyToDestination: (0, SciChartSurfaceBase_1.copyToCanvas)(SciChartSurfaceBase_1.SciChartSurfaceBase.domMasterCanvas, getDestinationById)
             });
             wasmContext.SCRTSetGlobalCopyToDestinationInterface(canvasCopyObj);
             wasmContext.TSRSetDrawRequestsEnabled(true);
@@ -224,3 +225,7 @@ var createMaster = function () {
         });
     });
 };
+/** @ignore */
+var getDestinationById = function (destinationId) {
+    return exports.sciChartDestinations.find(function (dest) { return dest.canvasElementId === destinationId; });
+};

package/Charting/Visuals/createSingle.d.ts

@@ -6,6 +6,6 @@ import { TWebAssemblyChart } from "./SciChartSurface";
 import { TSciChartDestination } from "./SciChartSurfaceBase";
 export declare const sciChartSingleDestinations: TSciChartDestination[];
 /** @ignore */
-export declare const createSingleInternal: (divElementId: string, options?: I2DSurfaceOptions) => Promise<TWebAssemblyChart>;
+export declare const createSingleInternal: (divElement: string | HTMLDivElement, options?: I2DSurfaceOptions) => Promise<TWebAssemblyChart>;
 /** @ignore */
 export declare const initDrawEngineSingleChart: (wasmContext: TSciChart, canvases: TSciChartSurfaceCanvases, resolve: (value: TWebAssemblyChart) => void, theme: IThemeProvider) => void;

package/Charting/Visuals/createSingle.js

@@ -15,10 +15,10 @@ var SciChartSurfaceBase_1 = require("./SciChartSurfaceBase");
 // Global variables
 exports.sciChartSingleDestinations = [];
 /** @ignore */
-var createSingleInternal = function (divElementId, options) {
+var createSingleInternal = function (divElement, options) {
     return new Promise(function (resolve, reject) {
         var _a;
-        var canvases = sciChartInitCommon_1.default.initCanvas(divElementId, options === null || options === void 0 ? void 0 : options.widthAspect, options === null || options === void 0 ? void 0 : options.heightAspect);
+        var canvases = sciChartInitCommon_1.default.initCanvas(divElement, options === null || options === void 0 ? void 0 : options.widthAspect, options === null || options === void 0 ? void 0 : options.heightAspect);
         var loader = (_a = options === null || options === void 0 ? void 0 : options.loader) !== null && _a !== void 0 ? _a : new loader_1.DefaultSciChartLoader();
         var loaderDiv = loader.addChartLoader(canvases.domDivContainer, options === null || options === void 0 ? void 0 : options.theme);
         var webGLSupport = WebGlHelper_1.WebGlHelper.getWebGlSupport();

package/Charting/Visuals/licenseManager2D.js

@@ -40,17 +40,17 @@ exports.licenseManager = exports.updateLicenseDisplay = exports.getLicenseInfo =
 var app_1 = require("../../constants/app");
 var BuildStamp_1 = require("../../Core/BuildStamp");
 var Dictionary_1 = require("../../Core/Dictionary");
+var localStorageApi_1 = require("../../Core/storage/localStorageApi");
 var Color_1 = require("../../types/Color");
 var licensingClasses_1 = require("../../types/licensingClasses");
 var cookie_1 = require("../../utils/cookie");
+var licenseManager2dState_1 = require("./licenseManager2dState");
 var licenseWizardPort = 24278;
 var licenseWizardAlternatePort = 24279;
-if (typeof localStorage !== "undefined") {
-    var portOverride = localStorage.getItem("LICENSE_WIZARD_PORT");
-    if (portOverride) {
-        licenseWizardPort = Number(portOverride);
-        licenseWizardAlternatePort = licenseWizardPort + 1;
-    }
+var portOverride = localStorageApi_1.localStorageApi.getLicenseWizardPort();
+if (portOverride) {
+    licenseWizardPort = portOverride;
+    licenseWizardAlternatePort = licenseWizardPort + 1;
 }
 var fetchFromWizard = function (path) { return __awaiter(void 0, void 0, void 0, function () {
     var wizardUrl, response, err_1, maxport, wizardUrl, response, err_2;
@@ -67,8 +67,8 @@ var fetchFromWizard = function (path) { return __awaiter(void 0, void 0, void 0,
                 err_1 = _a.sent();
                 debug("Could not connect to license wizard on port " + licenseWizardPort.toString());
                 if (!(typeof localStorage !== "undefined")) return [3 /*break*/, 8];
-                maxport = Number(localStorage.getItem("LICENSE_WIZARD_MAXPORT"));
-                if (!(maxport > 0)) return [3 /*break*/, 8];
+                maxport = localStorageApi_1.localStorageApi.getLicenseWizardMaxPort();
+                if (!maxport) return [3 /*break*/, 8];
                 _a.label = 3;
             case 3:
                 if (!(licenseWizardAlternatePort <= maxport)) return [3 /*break*/, 8];
@@ -105,7 +105,7 @@ exports.setDependencies = setDependencies;
 var isDebug = null;
 var debug = function (message) {
     if (isDebug === null) {
-        isDebug = typeof localStorage !== "undefined" && localStorage.getItem("LICENSE_DEBUG") === "1";
+        isDebug = localStorageApi_1.localStorageApi.getIsLicenseDebug();
     }
     if (app_1.IS_TEST_ENV || isDebug) {
         licenseDependencies.debug(message);
@@ -255,7 +255,7 @@ var dolicenseChallenge = function () { return __awaiter(void 0, void 0, void 0,
     return __generator(this, function (_b) {
         switch (_b.label) {
             case 0:
-                server = isDev ? "license wizard" : "server";
+                server = licenseManager2dState_1.licenseManager2dState.getIsDev() ? "license wizard" : "server";
                 _b.label = 1;
             case 1:
                 _b.trys.push([1, 11, , 12]);
@@ -273,7 +273,7 @@ var dolicenseChallenge = function () { return __awaiter(void 0, void 0, void 0,
                 }
                 response = void 0;
                 queryString = "orderid=".concat(orderId, "&challenge=").concat(challenge);
-                if (!isDev) return [3 /*break*/, 3];
+                if (!licenseManager2dState_1.licenseManager2dState.getIsDev()) return [3 /*break*/, 3];
                 url = "/validate?".concat(queryString);
                 return [4 /*yield*/, licenseDependencies.fetchFromWizard(url)];
             case 2:
@@ -335,7 +335,7 @@ var dolicenseChallenge = function () { return __awaiter(void 0, void 0, void 0,
                 }
                 else {
                     expiry = (0, exports.getLicenseCookie)().expiry;
-                    msg = isDev
+                    msg = licenseManager2dState_1.licenseManager2dState.getIsDev()
                         ? "Please run the license wizard, ensure your license is activated, then refresh page to retry."
                         : "Please check that the endpoint is configured correctly.";
                     console.error("Failed to connect to ".concat(server, "/").concat(serverLicenseEndpoint, ".  License must be revalidated before ").concat(expiry.toLocaleString(), ". ").concat(msg));
@@ -359,7 +359,6 @@ var checkStatus = licensingClasses_1.LicenseCheckStatus.NoLicense;
 var licenseContext2D;
 var sciChartSurface2D;
 var isRuntimeKey = false;
-var isDev = false;
 var applyLicense2D = function (licenseContext, sciChartSurface, isSingle) {
     debug("applyLicense 2D");
     if (isSingle || shouldApplyLicense2D) {
@@ -377,7 +376,9 @@ var applyLicense = function (licenseContext) {
     debug("Initial license status is " + licensingClasses_1.LicenseType[convertLicenseType(lt, licenseContext)]);
     // Get from global store
     var runtimelicense = getRuntimeLicenseKey();
-    if ((checkStatus === licensingClasses_1.LicenseCheckStatus.NoLicense || checkStatus === licensingClasses_1.LicenseCheckStatus.LicenseOK) &&
+    if ((checkStatus === licensingClasses_1.LicenseCheckStatus.NoLicense ||
+        checkStatus === licensingClasses_1.LicenseCheckStatus.LicenseOK ||
+        checkStatus === licensingClasses_1.LicenseCheckStatus.LookingForLicenseWizard) &&
         lt === licenseContext.SCRTLicenseType.LICENSE_TYPE_NO_LICENSE &&
         runtimelicense) {
         debug("Runtime license found");
@@ -429,7 +430,7 @@ var applyLicense = function (licenseContext) {
             licenseContext.SCRTCredentials.SetRuntimeLicenseKeyW(licenseKey);
             lt = licenseContext.SCRTCredentials.GetLicenseType();
         }
-        isDev = licenseContext.SCRTCredentials.GetAllowDebugging();
+        licenseManager2dState_1.licenseManager2dState.setIsDev(licenseContext.SCRTCredentials.GetAllowDebugging());
         if (lt === licenseContext.SCRTLicenseType.LICENSE_TYPE_FULL ||
             lt === licenseContext.SCRTLicenseType.LICENSE_TYPE_TRIAL) {
             checkStatus = licensingClasses_1.LicenseCheckStatus.LicenseOK;
@@ -437,7 +438,7 @@ var applyLicense = function (licenseContext) {
         }
         else if (licenseContext.SCRTCredentials.RequiresValidation()) {
             debug("license requires validation");
-            if (isRuntimeKey && isDev) {
+            if (isRuntimeKey && licenseManager2dState_1.licenseManager2dState.getIsDev()) {
                 // clear key
                 licenseContext.SCRTCredentials.ResetRuntimeLicense();
                 (0, cookie_1.deleteCookie)("scLicense");
@@ -477,7 +478,7 @@ var applyLicense = function (licenseContext) {
     if (checkStatus === licensingClasses_1.LicenseCheckStatus.NoLicense && useLicenseWizard) {
         if (wizardTimer === undefined) {
             checkStatus = licensingClasses_1.LicenseCheckStatus.LookingForLicenseWizard;
-            isDev = true;
+            licenseManager2dState_1.licenseManager2dState.setIsDev(true);
             getlicenseFromWizard();
         }
     }
@@ -726,7 +727,7 @@ var updateLicenseDisplayInternal = function (licenseInfo, sciChartSurface, is2D,
             postMsg = "Instructions can be seen at ".concat(licensingLink, "</br>\n                    Please ").concat(contactSupportLink, " with your OrderID if you are experiencing issues.");
         }
         else if (licenseType === licensingClasses_1.LicenseType.Requres_Validation) {
-            if (isDev) {
+            if (licenseManager2dState_1.licenseManager2dState.getIsDev()) {
                 premsg = "Your developer license must be validated by the SciChart Licensing Wizard running locally";
             }
             else {
@@ -759,21 +760,21 @@ var updateLicenseDisplayInternal = function (licenseInfo, sciChartSurface, is2D,
             if (checkStatus === licensingClasses_1.LicenseCheckStatus.LookingForLicenseWizard)
                 chartmsg = "<br>Looking for Licensing Wizard...  <u>Please run it or click for download and installation instructions</u>.";
             else if (checkStatus === licensingClasses_1.LicenseCheckStatus.FailedToFindLicenseWizard)
-                if (isDev) {
+                if (licenseManager2dState_1.licenseManager2dState.getIsDev()) {
                     chartmsg = "<br><u>Could not connect to the Licensing Wizard.  Please run it or click for download and installation instructions, then reload this page.</u>";
                 }
                 else {
                     chartmsg = "<br><u>Could not connect to the server licensing endpoint</u>";
                 }
             else if (checkStatus === licensingClasses_1.LicenseCheckStatus.ValidatingDeveloperLicense)
-                if (isDev) {
+                if (licenseManager2dState_1.licenseManager2dState.getIsDev()) {
                     chartmsg = "<br><u>Trying to validate your license...  Please run the Licensing Wizard or click for download and installation instructions</u>.";
                 }
                 else {
                     chartmsg = "<br><u>Trying to validate your license with the server...</u>.";
                 }
             else if (checkStatus === licensingClasses_1.LicenseCheckStatus.FailedToValidateDeveloperLicense)
-                if (isDev) {
+                if (licenseManager2dState_1.licenseManager2dState.getIsDev()) {
                     chartmsg = "<br><u>Failed to validate your developer license with the Licensing Wizard.  If you have changed your activated license, try clearing your cookies for this site.</u>.";
                 }
                 else {
@@ -793,6 +794,8 @@ var updateLicenseDisplayInternal = function (licenseInfo, sciChartSurface, is2D,
             if (premsg) {
                 licenseMessageDiv.style.width = "100%";
                 licenseMessageDiv.style.height = "100%";
+                licenseMessageDiv.style.top = "0";
+                licenseMessageDiv.style.left = "0";
                 licenseMessageDiv.style.position = "absolute";
                 licenseMessageDiv.style.pointerEvents = "auto";
                 licenseMessageDiv.style.cursor = "pointer";

package/Charting/Visuals/licenseManager2dState.d.ts

@@ -0,0 +1,4 @@
+export declare const licenseManager2dState: {
+    getIsDev: () => boolean;
+    setIsDev: (value: boolean) => void;
+};

package/Charting/Visuals/licenseManager2dState.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.licenseManager2dState = void 0;
+var isDev = false;
+var getIsDev = function () { return isDev; };
+var setIsDev = function (value) {
+    isDev = value;
+};
+exports.licenseManager2dState = {
+    getIsDev: getIsDev,
+    setIsDev: setIsDev
+};

package/Charting/Visuals/loader.js

@@ -26,6 +26,8 @@ var DefaultSciChartLoader = /** @class */ (function () {
         loaderContainerDiv.style.background = theme.loadingAnimationBackground;
         loaderContainerDiv.style.height = "100%";
         loaderContainerDiv.style.width = "100%";
+        loaderContainerDiv.style.position = "relative";
+        loaderContainerDiv.style.zIndex = "11";
         var loaderDiv = document.createElement("div");
         var spinnerChunk = "<div><span style=\"background: ".concat(theme.loadingAnimationForeground, "\"/></div>");
         loaderDiv.innerHTML = spinnerChunk.repeat(8);

package/Charting/Visuals/sciChartInitCommon.d.ts

@@ -7,10 +7,10 @@ declare enum ECanvasType {
     svg = 2
 }
 declare const sciChartInitCommon: {
-    checkChartDivExists: (divElementId: string) => void;
+    checkChartDivExists: (divElement: string | HTMLDivElement) => void;
     ECanvasType: typeof ECanvasType;
     getCanvas2dId: (divElementId: string) => string;
-    initCanvas: (divElementId: string, aspectWidth: number, aspectHeight: number, activeCanvas?: ECanvasType) => TSciChartSurfaceCanvases;
+    initCanvas: (divElement: string | HTMLDivElement, aspectWidth: number, aspectHeight: number, activeCanvas?: ECanvasType) => TSciChartSurfaceCanvases;
     subscribeToResize: (chartRoot: HTMLDivElement, aspect: number, sciChartSurface: ISciChartSurfaceBase) => IDeletable;
 };
 export default sciChartInitCommon;

package/Charting/Visuals/sciChartInitCommon.js

@@ -37,13 +37,13 @@ var getCanvasSizes = function (divWidth, divHeight, maxHeight, aspectWidth, aspe
         return { width: width, height: height, aspectRatio: aspectRatio };
     }
 };
-var getChartRootDomElement = function (divElementId) {
-    var chartRoot = document.querySelector("#".concat(divElementId));
+var getChartRootDomElement = function (divElement) {
+    var chartRoot = typeof divElement === "string" ? document.querySelector("#".concat(divElement)) : divElement;
     if (!chartRoot) {
-        throw new Error("Check div element with id \"".concat(divElementId, "\" exists"));
+        throw new Error("Check div element with id \"".concat(chartRoot.id, "\" exists"));
     }
     if (chartRoot.nodeName.toLowerCase() !== "div") {
-        throw new Error("Element with id \"".concat(divElementId, "\" should be of type div"));
+        throw new Error("Element with id \"".concat(chartRoot.id, "\" should be of type div"));
     }
     return chartRoot;
 };
@@ -68,12 +68,17 @@ var getMaxHeight = function (divElement) {
  * @param activeCanvas - ECanvasType.canvasWebGL for sciChartSurface.createSingle, ECanvasType.canvas2D for copy canvas,
  * ECanvasType.svg for SciChartPieSurface
  */
-var initCanvas = function (divElementId, aspectWidth, aspectHeight, activeCanvas) {
+var initCanvas = function (divElement, aspectWidth, aspectHeight, activeCanvas) {
     if (activeCanvas === void 0) { activeCanvas = ECanvasType.canvasWebGL; }
     WebGlHelper_1.WebGlHelper.initialize();
     DpiHelper_1.DpiHelper.initialize();
-    var chartRoot = getChartRootDomElement(divElementId);
+    var chartRoot = getChartRootDomElement(divElement);
     chartRoot.innerHTML = "";
+    // prevent unexpected behavior with no positioned element
+    if (chartRoot.style.position === "") {
+        chartRoot.style.position = "relative";
+    }
+    var divElementId = chartRoot.id;
     var divWidth = chartRoot.offsetWidth, divHeight = chartRoot.offsetHeight;
     var maxHeight = getMaxHeight(chartRoot);
     var _a = getCanvasSizes(divWidth, divHeight, maxHeight, aspectWidth, aspectHeight), width = _a.width, height = _a.height, aspectRatio = _a.aspectRatio;
@@ -215,13 +220,18 @@ var subscribeToResize = function (chartRoot, aspect, sciChartSurface) {
  * Check DOM element with specified ID exists and unique
  * @param divElementId
  */
-var checkChartDivExists = function (divElementId) {
-    var numberOfElements = document.querySelectorAll("[id=".concat(divElementId, "]")).length;
-    if (numberOfElements > 1) {
-        console.error("Please provide a unique ID for each chart div element, \"".concat(divElementId, "\" it is not a unique identifier"));
+var checkChartDivExists = function (divElement) {
+    if (typeof divElement === "string") {
+        var numberOfElements = document.querySelectorAll("[id=".concat(divElement, "]")).length;
+        if (numberOfElements > 1) {
+            console.error("Please provide a unique ID for each chart div element, \"".concat(divElement, "\" it is not a unique identifier"));
+        }
+        else if (numberOfElements === 0) {
+            console.error("Chart div element with the ID \"".concat(divElement, "\" is not present in the DOM"));
+        }
     }
-    else if (numberOfElements === 0) {
-        console.error("Chart div element with the ID \"".concat(divElementId, "\" is not present in the DOM"));
+    else if (!divElement) {
+        throw new Error("Provided div element doesn't exist!");
     }
 };
 var sciChartInitCommon = {

package/Charting3D/Model/DataSeries/XyzDataSeries3D.d.ts

@@ -1,5 +1,5 @@
 import { NumberRange } from "../../../Core/NumberRange";
-import { DoubleVector } from "../../../types/TSciChart";
+import { SCRTDoubleVector } from "../../../types/TSciChart";
 import { TSciChart3D } from "../../../types/TSciChart3D";
 import { BaseDataSeries3D, EDataSeriesType3D } from "./BaseDataSeries3D";
 import { IPointMetadata3D } from "./IPointMetadata3D";
@@ -39,9 +39,9 @@ export interface IXyzDataSeries3DOptions {
  */
 export declare class XyzDataSeries3D extends BaseDataSeries3D {
     readonly type: EDataSeriesType3D;
-    protected xValues: DoubleVector;
-    protected yValues: DoubleVector;
-    protected zValues: DoubleVector;
+    protected xValues: SCRTDoubleVector;
+    protected yValues: SCRTDoubleVector;
+    protected zValues: SCRTDoubleVector;
     protected metadata: IPointMetadata3D[];
     /**
      * Creates an instance of {@link XyzDataSeries3D}
@@ -53,15 +53,15 @@ export declare class XyzDataSeries3D extends BaseDataSeries3D {
     /**
      * Gets a native / WebAssembly vector of X-values in the DataSeries
      */
-    getNativeXValues(): DoubleVector;
+    getNativeXValues(): SCRTDoubleVector;
     /**
      * Gets a native / WebAssembly vector of Y-values in the DataSeries
      */
-    getNativeYValues(): DoubleVector;
+    getNativeYValues(): SCRTDoubleVector;
     /**
      * Gets a native / WebAssembly vector of Z-values in the DataSeries
      */
-    getNativeZValues(): DoubleVector;
+    getNativeZValues(): SCRTDoubleVector;
     /**
      * Gets a native / WebAssembly vector of {@link IPointMetadata3D | Metadata values} in the DataSeries
      */

package/Charting3D/Model/DataSeries/XyzDataSeries3D.js

@@ -44,9 +44,9 @@ var XyzDataSeries3D = /** @class */ (function (_super) {
     function XyzDataSeries3D(webAssemblyContext, options) {
         var _this = _super.call(this, webAssemblyContext) || this;
         _this.type = BaseDataSeries3D_1.EDataSeriesType3D.Xyz3D;
-        _this.xValues = new webAssemblyContext.DoubleVector();
-        _this.yValues = new webAssemblyContext.DoubleVector();
-        _this.zValues = new webAssemblyContext.DoubleVector();
+        _this.xValues = new webAssemblyContext.SCRTDoubleVector();
+        _this.yValues = new webAssemblyContext.SCRTDoubleVector();
+        _this.zValues = new webAssemblyContext.SCRTDoubleVector();
         _this.metadata = [];
         if ((options === null || options === void 0 ? void 0 : options.xValues) && (options === null || options === void 0 ? void 0 : options.yValues) && (options === null || options === void 0 ? void 0 : options.zValues)) {
             _this.appendRange(options.xValues, options.yValues, options.zValues, options === null || options === void 0 ? void 0 : options.metadata);

package/Charting3D/Visuals/SciChart3DSurface.d.ts

@@ -57,10 +57,10 @@ export interface ISciChart3DSurfaceOptions {
 export declare class SciChart3DSurface extends SciChartSurfaceBase {
     /**
      * USED INTERNALLY - performs a similar operation to {@link SciChart3DSurface.create} but used internally for testing
-     * @param divElementId
+     * @param divElement The Div Element ID or reference where the {@link SciChartSurface} will reside
      * @param options Optional parameters of type {@link I2DSurfaceOptions}
      */
-    static createSingle(divElementId: string, options?: I2DSurfaceOptions): Promise<TWebAssemblyChart3D>;
+    static createSingle(divElement: string | HTMLDivElement, options?: I2DSurfaceOptions): Promise<TWebAssemblyChart3D>;
     /**
      * Allows setting of web URL for Wasm and Data files, in the case you are loading SciChart outside of npm/webpack environment.
      * Note if loading from CDN the version number of data/wasm Urls must match the version number of SciChart.js you are using.

package/Charting3D/Visuals/SciChart3DSurface.js

@@ -113,11 +113,11 @@ var SciChart3DSurface = /** @class */ (function (_super) {
     }
     /**
      * USED INTERNALLY - performs a similar operation to {@link SciChart3DSurface.create} but used internally for testing
-     * @param divElementId
+     * @param divElement The Div Element ID or reference where the {@link SciChartSurface} will reside
      * @param options Optional parameters of type {@link I2DSurfaceOptions}
      */
-    SciChart3DSurface.createSingle = function (divElementId, options) {
-        return (0, createSingle3d_1.createSingle3dInternal)(divElementId, options);
+    SciChart3DSurface.createSingle = function (divElement, options) {
+        return (0, createSingle3d_1.createSingle3dInternal)(divElement, options);
     };
     /**
      * Allows setting of web URL for Wasm and Data files, in the case you are loading SciChart outside of npm/webpack environment.

package/Charting3D/Visuals/createMaster3d.d.ts

@@ -2,6 +2,6 @@ import { I2DSurfaceOptions } from "../../Charting/Visuals/I2DSurfaceOptions";
 import { TSciChartDestination } from "../../Charting/Visuals/SciChartSurfaceBase";
 import { TWebAssemblyChart3D } from "./SciChart3DSurface";
 /** @ignore */
-export declare const createMultichart3d: (divElementId: string, options?: I2DSurfaceOptions) => Promise<TWebAssemblyChart3D>;
+export declare const createMultichart3d: (divElement: string | HTMLDivElement, options?: I2DSurfaceOptions) => Promise<TWebAssemblyChart3D>;
 /** @ignore */
 export declare const sciChartDestinations: TSciChartDestination[];

package/Charting3D/Visuals/createMaster3d.js

@@ -55,15 +55,15 @@ var sciChartMaster3D = {
 /** @ignore */
 var sciChartMaster3DPromise;
 /** @ignore */
-var createMultichart3d = function (divElementId, options) { return __awaiter(void 0, void 0, void 0, function () {
-    var canvases, loader, loaderDiv, master, createChildSurface, wasmContext_1, sciChart3DSurface_1, err_1;
+var createMultichart3d = function (divElement, options) { return __awaiter(void 0, void 0, void 0, function () {
+    var canvases, loader, loaderDiv, master, createChildSurface, wasmContext_1, divElementId, sciChart3DSurface_1, err_1;
     var _a, _b, _c, _d, _e;
     return __generator(this, function (_f) {
         switch (_f.label) {
             case 0:
                 (0, chartBuilder_1.ensureRegistrations)();
-                sciChartInitCommon_1.default.checkChartDivExists(divElementId);
-                canvases = sciChartInitCommon_1.default.initCanvas(divElementId, (_a = options === null || options === void 0 ? void 0 : options.widthAspect) !== null && _a !== void 0 ? _a : 0, (_b = options === null || options === void 0 ? void 0 : options.heightAspect) !== null && _b !== void 0 ? _b : 0, sciChartInitCommon_1.default.ECanvasType.canvas2D);
+                sciChartInitCommon_1.default.checkChartDivExists(divElement);
+                canvases = sciChartInitCommon_1.default.initCanvas(divElement, (_a = options === null || options === void 0 ? void 0 : options.widthAspect) !== null && _a !== void 0 ? _a : 0, (_b = options === null || options === void 0 ? void 0 : options.heightAspect) !== null && _b !== void 0 ? _b : 0, sciChartInitCommon_1.default.ECanvasType.canvas2D);
                 loader = (_c = options === null || options === void 0 ? void 0 : options.loader) !== null && _c !== void 0 ? _c : new loader_1.DefaultSciChartLoader();
                 loaderDiv = loader.addChartLoader(canvases.domDivContainer, (_d = options === null || options === void 0 ? void 0 : options.theme) !== null && _d !== void 0 ? _d : SciChartSurfaceBase_1.SciChartSurfaceBase.DEFAULT_THEME);
                 _f.label = 1;
@@ -85,6 +85,7 @@ var createMultichart3d = function (divElementId, options) { return __awaiter(voi
                 _f.label = 3;
             case 3:
                 createChildSurface = sciChartMaster3D.createChildSurface, wasmContext_1 = sciChartMaster3D.wasmContext;
+                divElementId = canvases.domChartRoot.id;
                 sciChart3DSurface_1 = createChildSurface(divElementId, canvases, (_e = options === null || options === void 0 ? void 0 : options.theme) !== null && _e !== void 0 ? _e : SciChartSurfaceBase_1.SciChartSurfaceBase.DEFAULT_THEME);
                 return [2 /*return*/, new Promise(function (resolve) {
                         setTimeout(function () {
@@ -117,7 +118,7 @@ var createMaster = function () {
         return sciChart3DSurface;
     };
     var addDestination = function (wasmContext, canvasElementId, sciChartSurface, width, height, chartInitObj3D) {
-        var newDestination = (0, SciChartSurfaceBase_1.createChartDestination)(canvasElementId);
+        var newDestination = (0, SciChartSurfaceBase_1.createChartDestination)(sciChartSurface.domCanvas2D);
         if (!newDestination) {
             sciChartSurface.delete();
             return;
@@ -182,7 +183,7 @@ var createMaster = function () {
             wasmContext.SCRTSetGlobalSampleChartInterface3D(chartInitObj);
             // create an object that native side can trigger the copy to from...
             var canvasCopyObj = wasmContext.SCRTCopyToDestinationInterface.implement({
-                CopyToDestination: (0, SciChartSurfaceBase_1.copyToCanvas)(SciChartSurfaceBase_1.SciChartSurfaceBase.domMasterCanvas)
+                CopyToDestination: (0, SciChartSurfaceBase_1.copyToCanvas)(SciChartSurfaceBase_1.SciChartSurfaceBase.domMasterCanvas, getDestinationById)
             });
             wasmContext.SCRTSetGlobalCopyToDestinationInterface(canvasCopyObj);
             wasmContext.TSRSetDrawRequestsEnabled(true);
@@ -194,3 +195,7 @@ var createMaster = function () {
         });
     });
 };
+/** @ignore */
+var getDestinationById = function (destinationId) {
+    return exports.sciChartDestinations.find(function (dest) { return dest.canvasElementId === destinationId; });
+};

package/Charting3D/Visuals/createSingle3d.d.ts

@@ -1,3 +1,3 @@
 import { I2DSurfaceOptions } from "../../Charting/Visuals/I2DSurfaceOptions";
 import { TWebAssemblyChart3D } from "./SciChart3DSurface";
-export declare const createSingle3dInternal: (divElementId: string, options?: I2DSurfaceOptions) => Promise<TWebAssemblyChart3D>;
+export declare const createSingle3dInternal: (divElement: string | HTMLDivElement, options?: I2DSurfaceOptions) => Promise<TWebAssemblyChart3D>;

package/Charting3D/Visuals/createSingle3d.js

@@ -12,11 +12,11 @@ var WebGlHelper_1 = require("../../Core/WebGlHelper");
 var logger_1 = require("../../utils/logger");
 var licenseManager3D_1 = require("./licenseManager3D");
 var SciChart3DSurface_1 = require("./SciChart3DSurface");
-var createSingle3dInternal = function (divElementId, options) {
+var createSingle3dInternal = function (divElement, options) {
     (0, chartBuilder_1.ensureRegistrations)();
     return new Promise(function (resolve, reject) {
         var _a, _b, _c, _d;
-        var canvases = sciChartInitCommon_1.default.initCanvas(divElementId, (_a = options === null || options === void 0 ? void 0 : options.widthAspect) !== null && _a !== void 0 ? _a : 0, (_b = options === null || options === void 0 ? void 0 : options.heightAspect) !== null && _b !== void 0 ? _b : 0);
+        var canvases = sciChartInitCommon_1.default.initCanvas(divElement, (_a = options === null || options === void 0 ? void 0 : options.widthAspect) !== null && _a !== void 0 ? _a : 0, (_b = options === null || options === void 0 ? void 0 : options.heightAspect) !== null && _b !== void 0 ? _b : 0);
         var loader = (_c = options === null || options === void 0 ? void 0 : options.loader) !== null && _c !== void 0 ? _c : new loader_1.DefaultSciChartLoader();
         var loaderDiv = loader.addChartLoader(canvases.domDivContainer, (_d = options === null || options === void 0 ? void 0 : options.theme) !== null && _d !== void 0 ? _d : SciChartSurfaceBase_1.SciChartSurfaceBase.DEFAULT_THEME);
         var webGLSupport = WebGlHelper_1.WebGlHelper.getWebGlSupport();

package/Core/BuildStamp.d.ts

@@ -1,4 +1,4 @@
 import { TSciChart } from "../types/TSciChart";
 import { TSciChart3D } from "../types/TSciChart3D";
-export declare const libraryVersion = "2.0.2195";
+export declare const libraryVersion = "2.1.2261";
 export declare const checkBuildStamp: (wasmContext: TSciChart | TSciChart3D) => boolean;

package/Core/BuildStamp.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkBuildStamp = exports.libraryVersion = void 0;
-var buildStamp = "2022-01-05T00:00:00";
+var buildStamp = "2022-01-31T00:00:00";
 var result;
 // tslint:disable-next-line:no-var-requires
-exports.libraryVersion = "2.0.2195";
+exports.libraryVersion = "2.1.2261";
 var checkBuildStamp = function (wasmContext) {
     if (result !== undefined)
         return result;

package/Core/NumberRange.d.ts

@@ -51,4 +51,5 @@ export declare class NumberRange {
      * Returns true if the range min === range max
      */
     isZero(): boolean;
+    static areEqual(range1: NumberRange, range2: NumberRange): boolean;
 }

package/Core/NumberRange.js

@@ -117,6 +117,14 @@ var NumberRange = /** @class */ (function () {
     NumberRange.prototype.isZero = function () {
         return this.min === this.max;
     };
+    NumberRange.areEqual = function (range1, range2) {
+        if (range1 === range2)
+            return true;
+        if (range1) {
+            return range1.equals(range2);
+        }
+        return false;
+    };
     return NumberRange;
 }());
 exports.NumberRange = NumberRange;

package/Core/OneTimePerformanceWarning.d.ts

@@ -0,0 +1,6 @@
+export declare class OneTimePerformanceWarning {
+    private warnedProperty;
+    private messageProperty;
+    constructor(message: string);
+    warn(): void;
+}

package/Core/OneTimePerformanceWarning.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OneTimePerformanceWarning = void 0;
+var licenseManager2dState_1 = require("../Charting/Visuals/licenseManager2dState");
+var SciChartDefaults_1 = require("../Charting/Visuals/SciChartDefaults");
+var OneTimePerformanceWarning = /** @class */ (function () {
+    function OneTimePerformanceWarning(message) {
+        this.warnedProperty = false;
+        this.messageProperty = message;
+    }
+    OneTimePerformanceWarning.prototype.warn = function () {
+        if (!SciChartDefaults_1.SciChartDefaults.performanceWarnings || this.warnedProperty || !licenseManager2dState_1.licenseManager2dState.getIsDev())
+            return;
+        console.warn(this.messageProperty);
+        this.warnedProperty = true;
+    };
+    return OneTimePerformanceWarning;
+}());
+exports.OneTimePerformanceWarning = OneTimePerformanceWarning;