scichart 2.0.2186 → 2.0.2228

package/Charting/Visuals/SciChartSurfaceBase.d.ts

@@ -325,13 +325,14 @@ export declare abstract class SciChartSurfaceBase implements ISciChartSurfaceBas
     protected changeMasterCanvasViewportSize(wasmContext: TSciChart | TSciChart3D, pixelWidth: number, pixelHeight: number): void;
     protected changeWebGLCanvasViewportSize(wasmContext: TSciChart | TSciChart3D, pixelWidth: number, pixelHeight: number): void;
 }
-export declare const createChartDestination: (canvasId: string) => {
+export declare const createChartDestination: (canvas: HTMLCanvasElement) => {
     canvas: HTMLCanvasElement;
     GetHeight(): any;
     GetWidth(): any;
     GetID(): any;
 };
 export declare const getMasterCanvas: () => HTMLCanvasElement;
-export declare const copyToCanvas: (sourceCanvas: HTMLCanvasElement) => (destinationId: string) => void;
+export declare type TGetDestinationFn = (destinationId: string) => TSciChartDestination;
+export declare const copyToCanvas: (sourceCanvas: HTMLCanvasElement, getDestinationById: TGetDestinationFn) => (destinationId: string) => void;
 /** @ignore */
 export declare const getLocateFile: (sciChartConfig: TSciChartConfig) => (path: string, prefix: string) => string;

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

@@ -39,6 +39,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.sciChartDestinations = exports.createMultichart = void 0;
 // @ts-ignore
 var WasmModule2D = require("../../_wasm/scichart2d");
+var BuildStamp_1 = require("../../Core/BuildStamp");
 var Guard_1 = require("../../Core/Guard");
 var WebGlRenderContext2D_1 = require("../Drawing/WebGlRenderContext2D");
 var licenseManager2D_1 = require("./licenseManager2D");
@@ -56,37 +57,49 @@ 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, sciChartSurface;
+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);
-                if (!(!sciChartMaster.wasmContext || !sciChartMaster.createChildSurface || !sciChartMaster.getChildSurfaces)) return [3 /*break*/, 2];
+                _d.label = 1;
+            case 1:
+                _d.trys.push([1, 4, , 5]);
+                if (!(!sciChartMaster.wasmContext || !sciChartMaster.createChildSurface || !sciChartMaster.getChildSurfaces)) return [3 /*break*/, 3];
                 if (!sciChartMasterPromise) {
                     sciChartMasterPromise = createMaster();
                 }
                 return [4 /*yield*/, sciChartMasterPromise];
-            case 1:
+            case 2:
                 master = _d.sent();
                 sciChartMaster.wasmContext = master.wasmContext;
+                (0, BuildStamp_1.checkBuildStamp)(master.wasmContext);
                 sciChartMaster.createChildSurface = master.createChildSurface;
                 sciChartMaster.getChildSurfaces = master.getChildSurfaces;
                 monitorWebGL(sciChartMaster);
-                _d.label = 2;
-            case 2:
-                createChildSurface = sciChartMaster.createChildSurface, wasmContext = sciChartMaster.wasmContext;
-                sciChartSurface = createChildSurface(divElementId, canvases, options === null || options === void 0 ? void 0 : options.theme);
+                _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 () {
                             loader.removeChartLoader(canvases.domDivContainer, loaderDiv);
-                            resolve({ wasmContext: wasmContext, sciChartSurface: sciChartSurface });
+                            resolve({ wasmContext: wasmContext_1, sciChartSurface: sciChartSurface_1 });
                         }, 0);
                     })];
+            case 4:
+                err_1 = _d.sent();
+                console.error(err_1);
+                // replace with div with error message
+                loader.removeChartLoader(canvases.domDivContainer, loaderDiv);
+                return [2 /*return*/, Promise.reject(err_1)];
+            case 5: return [2 /*return*/];
         }
     });
 }); };
@@ -135,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;
@@ -145,12 +158,13 @@ var createMaster = function () {
         chartInitObj.SetFPSCounterEnabled(false);
         exports.sciChartDestinations.push({ canvasElementId: canvasElementId, sciChartSurface: sciChartSurface, width: width, height: height });
     };
-    return new Promise(function (resolve) {
+    return new Promise(function (resolve, reject) {
         // make sure canvas has event listener for context creation error
         var canvas = (0, SciChartSurfaceBase_1.getMasterCanvas)();
         var locateFile = (0, SciChartSurfaceBase_1.getLocateFile)(SciChartSurface_1.sciChartConfig);
         // @ts-ignore
-        new WasmModule2D({ locateFile: locateFile, noInitialRun: true }).then(function (wasmContext) {
+        new WasmModule2D({ locateFile: locateFile, noInitialRun: true })
+            .then(function (wasmContext) {
             var getChildSurfaces = function () { return exports.sciChartDestinations.map(function (el) { return el.sciChartSurface; }); };
             // Create of replace child surface
             var createChildSurface = function (divElementId, canvases, theme) {
@@ -199,12 +213,19 @@ 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);
             // @ts-ignore
             wasmContext.callMain();
+        })
+            .catch(function () {
+            reject("Could not load SciChart WebAssembly module.\n                Check your build process and ensure that your scichart2d.wasm, scichart2d.data and scichart2d.js files are from the same version");
         });
     });
 };
+/** @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

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.initDrawEngineSingleChart = exports.createSingleInternal = exports.sciChartSingleDestinations = void 0;
 // @ts-ignore
 var WasmModule2D = require("../../_wasm/scichart2d");
+var BuildStamp_1 = require("../../Core/BuildStamp");
 var Guard_1 = require("../../Core/Guard");
 var WebGlHelper_1 = require("../../Core/WebGlHelper");
 var logger_1 = require("../../utils/logger");
@@ -14,10 +15,10 @@ var SciChartSurfaceBase_1 = require("./SciChartSurfaceBase");
 // Global variables
 exports.sciChartSingleDestinations = [];
 /** @ignore */
-var createSingleInternal = function (divElementId, options) {
-    return new Promise(function (resolve) {
+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();
@@ -25,11 +26,17 @@ var createSingleInternal = function (divElementId, options) {
         if (webGLSupport === WebGlHelper_1.EWebGLSupport.WebGL2 || webGLSupport === WebGlHelper_1.EWebGLSupport.WebGL1) {
             var locateFile = (0, SciChartSurfaceBase_1.getLocateFile)(SciChartSurface_1.sciChartConfig);
             // @ts-ignore
-            new WasmModule2D({ locateFile: locateFile, noInitialRun: true }).then(function (wasmContext) {
+            new WasmModule2D({ locateFile: locateFile, noInitialRun: true })
+                .then(function (wasmContext) {
                 loader.removeChartLoader(canvases.domDivContainer, loaderDiv);
                 // @ts-ignore
                 wasmContext.doNotCaptureKeyboard = true;
                 (0, exports.initDrawEngineSingleChart)(wasmContext, canvases, resolve, options === null || options === void 0 ? void 0 : options.theme);
+                (0, BuildStamp_1.checkBuildStamp)(wasmContext);
+            })
+                .catch(function () {
+                loader.removeChartLoader(canvases.domDivContainer, loaderDiv);
+                reject("Could not load SciChart WebAssembly module.\n                    Check your build process and ensure that your scichart2d.wasm, scichart2d.data and scichart2d.js files are from the same version");
             });
         }
         else {

package/Charting/Visuals/licenseManager2D.js

@@ -38,6 +38,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.licenseManager = exports.updateLicenseDisplay = exports.getLicenseInfo = exports.applyLicense = exports.getLicenseCookie = exports.setCallbacks3D = exports.setUseLicenseWizard = exports.setRuntimeLicenseKey = exports.setLicenseCallback = exports.setDependencies = void 0;
 var app_1 = require("../../constants/app");
+var BuildStamp_1 = require("../../Core/BuildStamp");
 var Dictionary_1 = require("../../Core/Dictionary");
 var Color_1 = require("../../types/Color");
 var licensingClasses_1 = require("../../types/licensingClasses");
@@ -110,6 +111,7 @@ var debug = function (message) {
         licenseDependencies.debug(message);
     }
 };
+debug("SciChart version " + BuildStamp_1.libraryVersion);
 // tslint:disable: no-console
 var licenseCallback;
 var setLicenseCallback = function (callback) {
@@ -375,7 +377,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");

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,13 @@ 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 = "";
+    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 +216,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/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

@@ -43,6 +43,7 @@ var chartBuilder_1 = require("../../Builder/chartBuilder");
 var loader_1 = require("../../Charting/Visuals/loader");
 var sciChartInitCommon_1 = require("../../Charting/Visuals/sciChartInitCommon");
 var SciChartSurfaceBase_1 = require("../../Charting/Visuals/SciChartSurfaceBase");
+var BuildStamp_1 = require("../../Core/BuildStamp");
 var licenseManager3D_1 = require("./licenseManager3D");
 var SciChart3DSurface_1 = require("./SciChart3DSurface");
 /** @ignore */
@@ -54,38 +55,52 @@ 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, sciChart3DSurface;
+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);
-                if (!(!sciChartMaster3D.wasmContext || !sciChartMaster3D.createChildSurface || !sciChartMaster3D.getChildSurfaces)) return [3 /*break*/, 2];
+                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;
+            case 1:
+                _f.trys.push([1, 4, , 5]);
+                if (!(!sciChartMaster3D.wasmContext ||
+                    !sciChartMaster3D.createChildSurface ||
+                    !sciChartMaster3D.getChildSurfaces)) return [3 /*break*/, 3];
                 if (!sciChartMaster3DPromise) {
                     sciChartMaster3DPromise = createMaster();
                 }
-                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);
                 return [4 /*yield*/, sciChartMaster3DPromise];
-            case 1:
+            case 2:
                 master = _f.sent();
-                loader.removeChartLoader(canvases.domDivContainer, loaderDiv);
+                (0, BuildStamp_1.checkBuildStamp)(master.wasmContext);
                 sciChartMaster3D.wasmContext = master.wasmContext;
                 sciChartMaster3D.createChildSurface = master.createChildSurface;
                 sciChartMaster3D.getChildSurfaces = master.getChildSurfaces;
-                _f.label = 2;
-            case 2:
-                createChildSurface = sciChartMaster3D.createChildSurface, wasmContext = sciChartMaster3D.wasmContext;
-                sciChart3DSurface = createChildSurface(divElementId, canvases, (_e = options === null || options === void 0 ? void 0 : options.theme) !== null && _e !== void 0 ? _e : SciChartSurfaceBase_1.SciChartSurfaceBase.DEFAULT_THEME);
+                _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 () {
-                            sciChart3DSurface.setIsInitialized();
-                            resolve({ wasmContext: wasmContext, sciChart3DSurface: sciChart3DSurface });
+                            loader.removeChartLoader(canvases.domDivContainer, loaderDiv);
+                            sciChart3DSurface_1.setIsInitialized();
+                            resolve({ wasmContext: wasmContext_1, sciChart3DSurface: sciChart3DSurface_1 });
                         }, 0);
                     })];
+            case 4:
+                err_1 = _f.sent();
+                console.error(err_1);
+                // replace with div with error message
+                loader.removeChartLoader(canvases.domDivContainer, loaderDiv);
+                return [2 /*return*/, Promise.reject(err_1)];
+            case 5: return [2 /*return*/];
         }
     });
 }); };
@@ -103,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;
@@ -112,10 +127,11 @@ var createMaster = function () {
         chartInitObj3D.AddDestination(dest);
         exports.sciChartDestinations.push({ canvasElementId: canvasElementId, sciChartSurface: sciChartSurface, width: width, height: height });
     };
-    return new Promise(function (resolve) {
+    return new Promise(function (resolve, reject) {
         var locateFile3d = (0, SciChartSurfaceBase_1.getLocateFile)(SciChart3DSurface_1.sciChartConfig3D);
         // @ts-ignore
-        new WasmModule3D({ locateFile3d: locateFile3d, noInitialRun: true }).then(function (wasmContext) {
+        new WasmModule3D({ locateFile3d: locateFile3d, noInitialRun: true })
+            .then(function (wasmContext) {
             var getChildSurfaces = function () { return exports.sciChartDestinations.map(function (el) { return el.sciChartSurface; }); };
             // Create of replace child surface
             var createChildSurface = function (divElementId, canvases, theme) {
@@ -167,12 +183,19 @@ 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);
             // @ts-ignore
             wasmContext.callMain();
+        })
+            .catch(function () {
+            reject("Could not load SciChart WebAssembly module.\n            Check your build process and ensure that your scichart2d.wasm, scichart2d.data and scichart2d.js files are from the same version");
         });
     });
 };
+/** @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

@@ -7,28 +7,35 @@ var chartBuilder_1 = require("../../Builder/chartBuilder");
 var loader_1 = require("../../Charting/Visuals/loader");
 var sciChartInitCommon_1 = require("../../Charting/Visuals/sciChartInitCommon");
 var SciChartSurfaceBase_1 = require("../../Charting/Visuals/SciChartSurfaceBase");
+var BuildStamp_1 = require("../../Core/BuildStamp");
 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) {
+    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();
-        console.log("webGLSupport", webGLSupport);
+        // console.log("webGLSupport", webGLSupport);
         if (webGLSupport === WebGlHelper_1.EWebGLSupport.WebGL2 || webGLSupport === WebGlHelper_1.EWebGLSupport.WebGL1) {
             var locateFile3d = (0, SciChartSurfaceBase_1.getLocateFile)(SciChart3DSurface_1.sciChartConfig3D);
             // @ts-ignore
-            new WasmModule3D({ locateFile3d: locateFile3d, noInitialRun: true }).then(function (wasmContext) {
+            new WasmModule3D({ locateFile3d: locateFile3d, noInitialRun: true })
+                .then(function (wasmContext) {
                 var _a;
                 loader.removeChartLoader(canvases.domDivContainer, loaderDiv);
                 // @ts-ignore
                 wasmContext.doNotCaptureKeyboard = true;
                 initDrawEngineSingleChart(wasmContext, canvases, resolve, (_a = options === null || options === void 0 ? void 0 : options.theme) !== null && _a !== void 0 ? _a : SciChartSurfaceBase_1.SciChartSurfaceBase.DEFAULT_THEME);
+                (0, BuildStamp_1.checkBuildStamp)(wasmContext);
+            })
+                .catch(function () {
+                loader.removeChartLoader(canvases.domDivContainer, loaderDiv);
+                reject("Could not load SciChart WebAssembly module.\n                Check your build process and ensure that your scichart3d.wasm, scichart3d.data and scichart3d.js files are from the same version");
             });
         }
         else {

package/Core/BuildStamp.d.ts

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

package/Core/BuildStamp.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkBuildStamp = exports.libraryVersion = void 0;
+var buildStamp = "2022-01-24T00:00:00";
+var result;
+// tslint:disable-next-line:no-var-requires
+exports.libraryVersion = "2.0.2228";
+var checkBuildStamp = function (wasmContext) {
+    if (result !== undefined)
+        return result;
+    if (!wasmContext)
+        return false;
+    if (wasmContext.SCRTCredentials.GetBuildStamp) {
+        if (wasmContext.SCRTCredentials.GetBuildStamp() === buildStamp) {
+            result = true;
+            return result;
+        }
+    }
+    console.warn("The SciChart webassembly module is from a different version than the javascript that is calling it.\n    Ensure that your build process is copying the correct wasm and data files.");
+    result = false;
+    return result;
+};
+exports.checkBuildStamp = checkBuildStamp;

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;