@combeenation/3d-viewer 5.1.2 → 5.2.0-alpha4

package/dist/lib-es6/api/classes/viewer.js

@@ -1,729 +1,587 @@
-import { __awaiter, __extends, __generator, __spreadArrays } from "tslib";
-import { ArcRotateCamera } from '@babylonjs/core/Cameras/arcRotateCamera';
-import { BoundingInfo } from '@babylonjs/core/Culling/boundingInfo';
-import { Engine } from '@babylonjs/core/Engines/engine';
-import { HighlightLayer } from '@babylonjs/core/Layers/highlightLayer';
-import { StandardMaterial } from '@babylonjs/core/Materials/standardMaterial';
-import { DynamicTexture } from '@babylonjs/core/Materials/Textures/dynamicTexture';
-import { Color3 } from '@babylonjs/core/Maths/math.color';
-import { Vector3 } from '@babylonjs/core/Maths/math.vector';
-import { Mesh } from '@babylonjs/core/Meshes/mesh';
-import { ScreenshotTools } from '@babylonjs/core/Misc/screenshotTools';
-import { WebXRSessionManager } from '@babylonjs/core/XR/webXRSessionManager';
-import { isMeshIncludedInExclusionList } from '../util/structureHelper';
-import { isString } from 'lodash-es';
-import { version } from '../../buildinfo.json';
-import { sceneSetup } from '../internal/sceneSetup';
-import { AnimationManager } from '../manager/animationManager';
-import { GltfExportManager } from '../manager/gltfExportManager';
-import { SceneManager } from '../manager/sceneManager';
-import { VariantInstanceManager } from '../manager/variantInstanceManager';
-import { SpecStorage } from '../store/specStorage';
-import { debounce, loadJavascript, loadJson } from '../util/resourceHelper';
-import { Event } from './event';
-import { EventBroadcaster } from './eventBroadcaster';
-import { Parameter } from './parameter';
-import { Variant } from './variant';
-import { DebugLayer } from '@babylonjs/core/Debug/debugLayer';
-import { backgroundDomeName, envHelperMetadataName } from '../util/babylonHelper';
-import { SceneLoader } from '@babylonjs/core/Loading/sceneLoader';
-import { getCustomCbnBabylonLoaderPlugin } from '../util/sceneLoaderHelper';
-/**
- * The main exposed object. This is the entry point into the application
- *
- * ```js
- * const canvas = document.getElementById( 'babylon-canvas' );
- * const viewer = Viewer( canvas, '/path/to/index.json' );
- * ```
- * The class does nothing on its own and needs to {@link bootstrap}
- */
-var Viewer = /** @class */ (function (_super) {
-    __extends(Viewer, _super);
-    /**
-     * Constructor
-     */
-    function Viewer(canvas, structureJson) {
-        var _this = _super.call(this) || this;
-        _this.canvas = canvas;
-        _this.structureJson = structureJson;
-        _this._scene = null;
-        _this._animationManager = null;
-        _this._sceneManager = null;
-        _this._gltfExportManager = null;
-        _this._variantInstances = null;
-        // default value is `true` ATM for compatibility reasons
-        // in the future material cloning should be the edge case
-        _this._cloneMaterialsOnMutation = true;
-        _this._isRenderLoopPaused = false;
-        _this._inspectorLoaded = false;
-        return _this;
-    }
-    Object.defineProperty(Viewer.prototype, "scene", {
-        /**
-         * Gets the BabylonJS Scene that is attached to the instance.
-         *
-         * @throws Error if the `scene` has not been initialized.
-         */
-        get: function () {
-            if (!this._scene) {
-                throw new Error("Scene has not been initialized.");
-            }
-            return this._scene;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    Object.defineProperty(Viewer.prototype, "sceneManager", {
-        /**
-         * Gets the {@link SceneManager} attached to the viewer.
-         *
-         * @throws Error if the {@link SceneManager} has not been initialized.
-         */
-        get: function () {
-            if (!this._sceneManager) {
-                throw new Error("SceneManager has not been initialized.");
-            }
-            return this._sceneManager;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    Object.defineProperty(Viewer.prototype, "gltfExportManager", {
-        /**
-         * Gets the {@link GltfExportManager} attached to the viewer.
-         *
-         * @throws Error if the {@link GltfExportManager} has not been initialized.
-         */
-        get: function () {
-            if (!this._gltfExportManager) {
-                throw new Error("GltfExportManager has not been initialized.");
-            }
-            return this._gltfExportManager;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    Object.defineProperty(Viewer.prototype, "engine", {
-        /**
-         * Gets the BabylonJS Engine that is attached to the viewer.
-         */
-        get: function () {
-            return this.scene.getEngine();
-        },
-        enumerable: false,
-        configurable: true
-    });
-    Object.defineProperty(Viewer.prototype, "variantInstances", {
-        /**
-         * Gets the {@link VariantInstanceManager} attached to the viewer.
-         *
-         * @throws Error if the {@link VariantInstanceManager} has not been initialized.
-         */
-        get: function () {
-            if (!this._variantInstances) {
-                throw Error("There is no variantInstanceManager.");
-            }
-            return this._variantInstances;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    Object.defineProperty(Viewer.prototype, "animationManager", {
-        /**
-         * Gets the {@link AnimationManager} attached to the viewer.
-         *
-         * @throws Error if the {@link AnimationManager} has not been initialized.
-         */
-        get: function () {
-            if (!this._animationManager) {
-                throw new Error("There is no animationManager instance.");
-            }
-            return this._animationManager;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    Object.defineProperty(Viewer.prototype, "cloneMaterialsOnMutation", {
-        /**
-         * Gets the `cloneMaterialsOnMutation` flag, as defined in the spec
-         */
-        get: function () {
-            return this._cloneMaterialsOnMutation;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    /**
-     * Starts the application. This will
-     * * load the given "index" JSON file
-     * * setup the scene with the "scene" JSON file
-     * * create an (optional) default setup with different variant settings
-     * * sets up resizing by attaching a debounced version of {@link resize}
-     *
-     * @throws Error if any of the files is not found/valid
-     *
-     * @emits {@link Event.BOOTSTRAP_START}
-     * @emits {@link Event.BOOTSTRAP_END}
-     */
-    Viewer.prototype.bootstrap = function () {
-        return __awaiter(this, void 0, void 0, function () {
-            var indexJson, sceneJson, _a, rootVariant, _b, setupJson, _c;
-            var _this = this;
-            return __generator(this, function (_d) {
-                switch (_d.label) {
-                    case 0:
-                        this.broadcastEvent(Event.BOOTSTRAP_START, this);
-                        if (!isString(this.structureJson)) return [3 /*break*/, 2];
-                        return [4 /*yield*/, loadJson(this.structureJson)];
-                    case 1:
-                        indexJson = _d.sent();
-                        return [3 /*break*/, 3];
-                    case 2:
-                        indexJson = this.structureJson;
-                        _d.label = 3;
-                    case 3:
-                        if (!indexJson.scene) {
-                            throw new Error("No \"scene\" property found for bootstrapping.");
-                        }
-                        // fill spec store
-                        SpecStorage.createFromSpec(indexJson);
-                        this.initCbnBabylonLoaderPlugin();
-                        if (!isString(indexJson.scene)) return [3 /*break*/, 5];
-                        return [4 /*yield*/, loadJson(indexJson.scene)];
-                    case 4:
-                        sceneJson = _d.sent();
-                        indexJson.scene = sceneJson;
-                        _d.label = 5;
-                    case 5:
-                        _a = this;
-                        return [4 /*yield*/, this.initScene()];
-                    case 6:
-                        _a._scene = _d.sent();
-                        return [4 /*yield*/, Variant.create('_', indexJson, this)];
-                    case 7:
-                        rootVariant = _d.sent();
-                        _b = this;
-                        return [4 /*yield*/, VariantInstanceManager.create(rootVariant)];
-                    case 8:
-                        _b._variantInstances = _d.sent();
-                        if (!indexJson.setup) return [3 /*break*/, 12];
-                        if (!isString(indexJson.setup)) return [3 /*break*/, 10];
-                        return [4 /*yield*/, loadJson(indexJson.setup)];
-                    case 9:
-                        setupJson = _d.sent();
-                        indexJson.setup = setupJson;
-                        _d.label = 10;
-                    case 10: return [4 /*yield*/, this.createVariantInstances()];
-                    case 11:
-                        _d.sent();
-                        _d.label = 12;
-                    case 12:
-                        // create gltf export manager
-                        _c = this;
-                        return [4 /*yield*/, GltfExportManager.create(this)];
-                    case 13:
-                        // create gltf export manager
-                        _c._gltfExportManager = _d.sent();
-                        // resize handler
-                        window.addEventListener('resize', debounce(this.resize.bind(this), 100));
-                        // wait until scene is completely ready
-                        return [4 /*yield*/, this.scene.whenReadyAsync()];
-                    case 14:
-                        // wait until scene is completely ready
-                        _d.sent();
-                        // event broadcasting
-                        this.broadcastEvent(Event.BOOTSTRAP_END, this);
-                        // render loop
-                        this.engine.runRenderLoop(function () {
-                            if (!_this._isRenderLoopPaused)
-                                _this.scene.render();
-                        });
-                        return [2 /*return*/, this];
-                }
-            });
-        });
-    };
-    /**
-     * Enables the BabylonJS [Inspector](https://doc.babylonjs.com/toolsAndResources/tools/inspector).\
-     * Due to the additional size of the inspector, the CDN version is used instead of shipping the required code with the viewer.\
-     * This means that the code will be downloaded only when needed and calling `enableDebugLayer` can take a little while depending on your internet connection etc.
-     */
-    Viewer.prototype.enableDebugLayer = function (options) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        if (!!this._inspectorLoaded) return [3 /*break*/, 2];
-                        // CDN version of inspector requires the BabylonJS core to be available as CDN module as well
-                        return [4 /*yield*/, loadJavascript('https://cdn.jsdelivr.net/npm/babylonjs@5.6.0/babylon.min.js')];
-                    case 1:
-                        // CDN version of inspector requires the BabylonJS core to be available as CDN module as well
-                        _a.sent();
-                        DebugLayer.InspectorURL =
-                            'https://cdn.jsdelivr.net/npm/babylonjs-inspector@5.6.0/babylon.inspector.bundle.max.min.js';
-                        this._inspectorLoaded = true;
-                        _a.label = 2;
-                    case 2: return [4 /*yield*/, this.scene.debugLayer.show(options)];
-                    case 3:
-                        _a.sent();
-                        return [2 /*return*/];
-                }
-            });
-        });
-    };
-    /**
-     * Destroys all registered {@link VariantInstance}s that are registered
-     */
-    Viewer.prototype.destroyVariantInstances = function () {
-        var _this = this;
-        this.variantInstances.all.forEach(function (variantInstance) {
-            _this.variantInstances.destroy(variantInstance.name);
-        });
-        return this;
-    };
-    /**
-     * Trigger a resize event for the `Engine`
-     */
-    Viewer.prototype.resize = function () {
-        this.engine.resize();
-        return this;
-    };
-    /**
-     * A convenience method for directly getting a Node from a {@link VariantInstance} and an {@link Element} by its
-     * {@link DottedPath}s.
-     */
-    Viewer.prototype.getNode = function (variantInstanceName, elementDottedPath, nodeDottedPath) {
-        return __awaiter(this, void 0, void 0, function () {
-            var variantInstance;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, this.variantInstances.get(variantInstanceName)];
-                    case 1:
-                        variantInstance = _a.sent();
-                        return [2 /*return*/, variantInstance.getNode(elementDottedPath, nodeDottedPath)];
-                }
-            });
-        });
-    };
-    /**
-     * A convenience method for directly getting a Node from a {@link VariantInstance} and an {@link Element} by its
-     * {@link DottedPath}s.
-     */
-    Viewer.prototype.getMesh = function (variantInstanceName, elementDottedPath, meshDottedPath) {
-        return __awaiter(this, void 0, void 0, function () {
-            var variantInstance;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, this.variantInstances.get(variantInstanceName)];
-                    case 1:
-                        variantInstance = _a.sent();
-                        return [2 /*return*/, variantInstance.getMesh(elementDottedPath, meshDottedPath)];
-                }
-            });
-        });
-    };
-    /**
-     * Switches the camera
-     *
-     * @emits {@link Event.CAMERA_SWITCHED}
-     */
-    Viewer.prototype.switchCamera = function (newCamera, reset) {
-        if (reset === void 0) { reset = true; }
-        var camera = this.scene.getCameraByName(newCamera);
-        if (camera) {
-            var activeCamera = this.scene.activeCamera;
-            if (activeCamera) {
-                activeCamera.detachControl(this.engine.getRenderingCanvas());
-            }
-            if (reset) {
-                camera.restoreState();
-            }
-            this.scene.setActiveCameraByName(newCamera);
-            camera.attachControl(this.engine.getRenderingCanvas());
-            this.broadcastEvent(Event.CAMERA_SWITCHED, camera);
-        }
-        else {
-            throw new Error("Given camera \"" + newCamera + "\" not found.");
-        }
-        // TODO: put traceable observers to new camera (@see element)
-        return this;
-    };
-    /**
-     * Moves or animates the active camera to given `placement`.
-     */
-    Viewer.prototype.moveActiveCameraTo = function (placement, animation) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.animationManager.animateToPlacement(this.sceneManager.activeCamera, placement, animation)];
-            });
-        });
-    };
-    /**
-     * Takes a sceenshot the the current scene. The result is a string containing a base64 encoded image
-     */
-    Viewer.prototype.screenshot = function (settings) {
-        var _this = this;
-        return new Promise(function (resolve, reject) {
-            var _a, _b, _c, _d, _e, _f;
-            if (!_this.engine) {
-                return reject('Engine is null');
-            }
-            if (!_this.scene) {
-                return reject('Scene is null');
-            }
-            _this.scene.render(); // in combination with a render target, we need to refresh the scene manually to get the latest view
-            ScreenshotTools.CreateScreenshotUsingRenderTarget(_this.engine, _this.sceneManager.activeCamera, (_a = settings === null || settings === void 0 ? void 0 : settings.size) !== null && _a !== void 0 ? _a : { width: _this.canvas.clientWidth, height: _this.canvas.clientHeight }, resolve, (_b = settings === null || settings === void 0 ? void 0 : settings.mimeType) !== null && _b !== void 0 ? _b : 'image/png', (_c = settings === null || settings === void 0 ? void 0 : settings.samples) !== null && _c !== void 0 ? _c : 1, (_d = settings === null || settings === void 0 ? void 0 : settings.antialiasing) !== null && _d !== void 0 ? _d : false, (_e = settings === null || settings === void 0 ? void 0 : settings.fileName) !== null && _e !== void 0 ? _e : 'screenshot.png', (_f = settings === null || settings === void 0 ? void 0 : settings.renderSprites) !== null && _f !== void 0 ? _f : false);
-        });
-    };
-    /**
-     * Checks whether the browser is capable of handling XR.
-     */
-    Viewer.prototype.isBrowserARCapable = function () {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, WebXRSessionManager.IsSessionSupportedAsync('immersive-ar')];
-                    case 1: return [2 /*return*/, _a.sent()];
-                }
-            });
-        });
-    };
-    /**
-     * Calculates the bounding box from all visible meshes on the scene.
-     */
-    Viewer.prototype.calculateBoundingBox = function (excludeGeometry) {
-        return __awaiter(this, void 0, void 0, function () {
-            var bbName, _a, max, min, boundingBox;
-            return __generator(this, function (_b) {
-                if (this.scene.meshes.length === 0) {
-                    throw new Error('There are currently no meshes on the scene.');
-                }
-                this.scene.render(); // CB-6062: workaround for BoundingBox not respecting render loop
-                bbName = '__bounding_box__';
-                _a = this.scene.meshes
-                    .filter(function (mesh) {
-                    var isEnabled = mesh.isEnabled();
-                    // ignore the existing bounding box mesh for calculating the current one
-                    var isNotBBoxMesh = bbName !== mesh.id;
-                    // ignore meshes with invalid bounding infos
-                    var hasValidBBoxInfo = mesh.getBoundingInfo().boundingSphere.radius > 0;
-                    // ignore excluded meshes
-                    var isExcluded = excludeGeometry ? isMeshIncludedInExclusionList(mesh, excludeGeometry) : false;
-                    return isEnabled && isNotBBoxMesh && hasValidBBoxInfo && !isExcluded;
-                })
-                    .reduce(function (accBBoxMinMax, curMesh, idx) {
-                    var bBox = curMesh.getBoundingInfo().boundingBox;
-                    // use the first entry in the array as default value and get the resulting maximum/minimum values
-                    var max = idx === 0 ? bBox.maximumWorld : Vector3.Maximize(accBBoxMinMax.max, bBox.maximumWorld);
-                    var min = idx === 0 ? bBox.minimumWorld : Vector3.Minimize(accBBoxMinMax.min, bBox.minimumWorld);
-                    return { max: max, min: min };
-                }, { max: new Vector3(), min: new Vector3() }), max = _a.max, min = _a.min;
-                boundingBox = this.scene.getMeshByName(bbName);
-                if (!boundingBox) {
-                    boundingBox = new Mesh(bbName, this.scene);
-                }
-                boundingBox.setBoundingInfo(new BoundingInfo(min, max));
-                return [2 /*return*/, boundingBox];
-            });
-        });
-    };
-    /**
-     * Focuses the camera to see every visible mesh in scene and tries to optimize wheel precision and panning
-     */
-    Viewer.prototype.autofocusActiveCamera = function (settings) {
-        var _a;
-        return __awaiter(this, void 0, void 0, function () {
-            var activeCamera, cameraClsName, exclude, photoDome, photoDomeMeshes, envHelper, boundingBox, helperCamera;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
-                    case 0:
-                        activeCamera = this.scene.activeCamera;
-                        if (!activeCamera) {
-                            throw new Error('No active camera found when using autofocus feature.');
-                        }
-                        if (!(activeCamera instanceof ArcRotateCamera)) {
-                            cameraClsName = activeCamera.getClassName();
-                            throw new Error("Camera of type \"" + cameraClsName + "\" is not implemented yet to use autofocus feature.");
-                        }
-                        exclude = (settings === null || settings === void 0 ? void 0 : settings.exclude) || [];
-                        photoDome = this.scene.getNodeByName(backgroundDomeName);
-                        photoDomeMeshes = photoDome === null || photoDome === void 0 ? void 0 : photoDome.getChildMeshes();
-                        if (photoDomeMeshes === null || photoDomeMeshes === void 0 ? void 0 : photoDomeMeshes.length) {
-                            exclude = __spreadArrays(exclude, photoDomeMeshes);
-                        }
-                        envHelper = (_a = this.scene.metadata) === null || _a === void 0 ? void 0 : _a[envHelperMetadataName];
-                        if (envHelper === null || envHelper === void 0 ? void 0 : envHelper.rootMesh) {
-                            exclude = __spreadArrays(exclude, [envHelper.rootMesh]);
-                        }
-                        return [4 /*yield*/, this.calculateBoundingBox(exclude)];
-                    case 1:
-                        boundingBox = _b.sent();
-                        helperCamera = this.getFocusedHelperCamera(boundingBox, settings);
-                        return [4 /*yield*/, this.applyFocusedHelperCameraData(activeCamera, helperCamera, settings)];
-                    case 2:
-                        _b.sent();
-                        // remove the helper camera
-                        helperCamera.dispose();
-                        return [2 /*return*/];
-                }
-            });
-        });
-    };
-    /**
-     * Resets everything by calling {@link destroy} to clear all references and {@link bootstrap} to setup a clean
-     * environment
-     */
-    Viewer.prototype.reset = function () {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, this.destroy()];
-                    case 1:
-                        _a.sent();
-                        return [2 /*return*/, this.bootstrap()];
-                }
-            });
-        });
-    };
-    /**
-     * Destroys
-     *
-     * * all {@link VariantInstance}s using {@link destroyVariantInstances}
-     * * calling `dispose` on the `Engine` and `Scene`
-     */
-    Viewer.prototype.destroy = function () {
-        this.destroyVariantInstances();
-        this.scene.dispose();
-        SpecStorage.destroy();
-        return this;
-    };
-    /**
-     * Show coordinate system with given dimension (for debugging purpose).
-     */
-    Viewer.prototype.showWorldCoordinates = function (dimension) {
-        var scene = this.scene;
-        var makeTextPlane = function (text, color, size) {
-            var dynamicTexture = new DynamicTexture('DynamicTexture', 50, scene, true);
-            dynamicTexture.hasAlpha = true;
-            dynamicTexture.drawText(text, 5, 40, 'bold 36px Arial', color, 'transparent', true);
-            var plane = Mesh.CreatePlane('TextPlane', size, scene, true);
-            plane.material = new StandardMaterial('TextPlaneMaterial', scene);
-            plane.material.backFaceCulling = false;
-            // @ts-ignore
-            plane.material.specularColor = new Color3(0, 0, 0);
-            // @ts-ignore
-            plane.material.diffuseTexture = dynamicTexture;
-            return plane;
-        };
-        var axisX = Mesh.CreateLines('axisX', [
-            Vector3.Zero(),
-            new Vector3(dimension, 0, 0),
-            new Vector3(dimension * 0.95, 0.05 * dimension, 0),
-            new Vector3(dimension, 0, 0),
-            new Vector3(dimension * 0.95, -0.05 * dimension, 0),
-        ], scene, false);
-        axisX.color = new Color3(1, 0, 0);
-        var xChar = makeTextPlane('X', 'red', dimension / 10);
-        xChar.position = new Vector3(0.9 * dimension, -0.05 * dimension, 0);
-        var axisY = Mesh.CreateLines('axisY', [
-            Vector3.Zero(),
-            new Vector3(0, dimension, 0),
-            new Vector3(-0.05 * dimension, dimension * 0.95, 0),
-            new Vector3(0, dimension, 0),
-            new Vector3(0.05 * dimension, dimension * 0.95, 0),
-        ], scene, false);
-        axisY.color = new Color3(0, 1, 0);
-        var yChar = makeTextPlane('Y', 'green', dimension / 10);
-        yChar.position = new Vector3(0, 0.9 * dimension, -0.05 * dimension);
-        var axisZ = Mesh.CreateLines('axisZ', [
-            Vector3.Zero(),
-            new Vector3(0, 0, dimension),
-            new Vector3(0, -0.05 * dimension, dimension * 0.95),
-            new Vector3(0, 0, dimension),
-            new Vector3(0, 0.05 * dimension, dimension * 0.95),
-        ], scene, false);
-        axisZ.color = new Color3(0, 0, 1);
-        var zChar = makeTextPlane('Z', 'blue', dimension / 10);
-        zChar.position = new Vector3(0, 0.05 * dimension, 0.9 * dimension);
-    };
-    /**
-     * Pause render loop.
-     */
-    Viewer.prototype.pauseRendering = function () {
-        this._isRenderLoopPaused = true;
-    };
-    /**
-     * Resume render loop when paused.
-     */
-    Viewer.prototype.resumeRendering = function () {
-        this._isRenderLoopPaused = false;
-    };
-    /**
-     * @emits {@link Event.SCENE_PROCESSING_START}
-     * @emits {@link Event.SCENE_PROCESSING_END}
-     */
-    Viewer.prototype.initScene = function () {
-        var _a, _b, _c;
-        return __awaiter(this, void 0, void 0, function () {
-            var sceneJson, engine, scene, _d, _e;
-            var _this = this;
-            return __generator(this, function (_f) {
-                switch (_f.label) {
-                    case 0:
-                        sceneJson = SpecStorage.get('scene');
-                        this.broadcastEvent(Event.SCENE_PROCESSING_START, sceneJson);
-                        engine = new Engine(this.canvas, (_b = (_a = sceneJson.engine) === null || _a === void 0 ? void 0 : _a.antialiasing) !== null && _b !== void 0 ? _b : false, (_c = sceneJson.engine) === null || _c === void 0 ? void 0 : _c.options);
-                        return [4 /*yield*/, sceneSetup(engine, sceneJson)];
-                    case 1:
-                        scene = _f.sent();
-                        if (sceneJson.meshPicking) {
-                            new HighlightLayer('default', scene);
-                            scene.onPointerPick = function (pointerEvent, pickInfo) {
-                                if (!pickInfo.hit) {
-                                    return;
-                                }
-                                var mesh = pickInfo.pickedMesh;
-                                _this.broadcastEvent(Event.MESH_PICKED, mesh, mesh === null || mesh === void 0 ? void 0 : mesh.metadata.element, mesh === null || mesh === void 0 ? void 0 : mesh.metadata.variant);
-                                if (mesh === null || mesh === void 0 ? void 0 : mesh.metadata.element) {
-                                    _this.broadcastEvent(Event.ELEMENT_PICKED, mesh.metadata.element);
-                                }
-                                if (mesh === null || mesh === void 0 ? void 0 : mesh.metadata.variant) {
-                                    if (mesh.metadata.variant.inheritedParameters[Parameter.HIGHLIGHT_ENABLED]) {
-                                        mesh.metadata.variant.toggleHighlight();
-                                    }
-                                    _this.broadcastEvent(Event.VARIANT_PICKED, mesh.metadata.variant);
-                                }
-                            };
-                        }
-                        _d = this;
-                        return [4 /*yield*/, SceneManager.create(scene)];
-                    case 2:
-                        _d._sceneManager = _f.sent();
-                        _e = this;
-                        return [4 /*yield*/, AnimationManager.create(scene)];
-                    case 3:
-                        _e._animationManager = _f.sent();
-                        if (sceneJson.cloneMaterialsOnMutation !== undefined) {
-                            this._cloneMaterialsOnMutation = sceneJson.cloneMaterialsOnMutation;
-                        }
-                        this.broadcastEvent(Event.SCENE_PROCESSING_END, scene);
-                        return [2 /*return*/, scene];
-                }
-            });
-        });
-    };
-    /**
-     * Register custom file loader for babylon files which adds "missing-material" metadata to meshes which reference
-     * materials that are not present in the `materials` section of the given babylon file.
-     *
-     * Required for babylon files & materials loaded from "Combeenation configurator assets".
-     */
-    Viewer.prototype.initCbnBabylonLoaderPlugin = function () {
-        var previousLoaderPlugin = SceneLoader.GetPluginForExtension('babylon');
-        var customLoaderPlugin = getCustomCbnBabylonLoaderPlugin(previousLoaderPlugin);
-        SceneLoader.RegisterPlugin(customLoaderPlugin);
-    };
-    /**
-     * Batch creation of multiple {@link VariantInstance} objects with a {@link SetupJson} object passed
-     */
-    Viewer.prototype.createVariantInstances = function () {
-        return __awaiter(this, void 0, void 0, function () {
-            var setupJson, instances, _i, _a, instanceDefinition, _b, _c;
-            return __generator(this, function (_d) {
-                switch (_d.label) {
-                    case 0:
-                        setupJson = SpecStorage.get('setup');
-                        instances = [];
-                        _i = 0, _a = setupJson.instances;
-                        _d.label = 1;
-                    case 1:
-                        if (!(_i < _a.length)) return [3 /*break*/, 4];
-                        instanceDefinition = _a[_i];
-                        if (instanceDefinition.lazy) {
-                            this.variantInstances.register(instanceDefinition);
-                            return [3 /*break*/, 3];
-                        }
-                        _c = (_b = instances).push;
-                        return [4 /*yield*/, this.variantInstances.create(instanceDefinition.variant, instanceDefinition.name, instanceDefinition.parameters)];
-                    case 2:
-                        _c.apply(_b, [_d.sent()]);
-                        _d.label = 3;
-                    case 3:
-                        _i++;
-                        return [3 /*break*/, 1];
-                    case 4: return [2 /*return*/, instances];
-                }
-            });
-        });
-    };
-    /**
-     * Help function for focusing a helper camera exactly onto the given bounding box
-     */
-    Viewer.prototype.getFocusedHelperCamera = function (boundingBox, settings) {
-        var _a, _b;
-        // use helper camera to get some default values and set the values of the real camera accordingly
-        var helperCamera = new ArcRotateCamera('__helper_camera__', 0, // camera angles will be overwritten after the target has been set
-        0, 0, // radius will be calculated, so we can set to 0 here
-        Vector3.Zero(), this.scene);
-        // this is required for automatically calculating the `lowerRadiusLimit`, so that we don't "dive" into meshes
-        // see https://doc.babylonjs.com/divingDeeper/behaviors/cameraBehaviors#framing-behavior
-        helperCamera.useFramingBehavior = true;
-        // `minZ` is the camera distance beyond which the mesh will be clipped
-        // this should be very low, but can't be zero
-        // a good value seems to be 1% of the bounding box size (= radius), whereas the value shouldn't go above 1, which is also the default value
-        var radius = boundingBox.getBoundingInfo().boundingSphere.radius;
-        helperCamera.minZ = Math.min(radius / 100, 1);
-        // set desired camera data, these won't be changed by the autofocus function!
-        // default values should focus the element exactly from the front (= XY Plane)
-        helperCamera.setTarget(boundingBox, true);
-        helperCamera.alpha = ((_a = settings === null || settings === void 0 ? void 0 : settings.alpha) !== null && _a !== void 0 ? _a : -90) * (Math.PI / 180);
-        helperCamera.beta = ((_b = settings === null || settings === void 0 ? void 0 : settings.beta) !== null && _b !== void 0 ? _b : 90) * (Math.PI / 180);
-        // finally zoom to the bounding box
-        // also apply a zoom factor, this adjusts the borders around the model in the viewport
-        helperCamera.zoomOnFactor = (settings === null || settings === void 0 ? void 0 : settings.radiusFactor) || 1;
-        helperCamera.zoomOn([boundingBox], true);
-        return helperCamera;
-    };
-    /**
-     * Help function for applying the relevant data of the focused helper camera to the real camera
-     */
-    Viewer.prototype.applyFocusedHelperCameraData = function (activeCamera, helperCamera, settings) {
-        return __awaiter(this, void 0, void 0, function () {
-            var newCameraPosition;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        // limits
-                        activeCamera.minZ = helperCamera.minZ;
-                        activeCamera.maxZ = helperCamera.maxZ;
-                        activeCamera.lowerRadiusLimit = helperCamera.lowerRadiusLimit;
-                        activeCamera.upperRadiusLimit = helperCamera.upperRadiusLimit;
-                        // additional settings
-                        if ((settings === null || settings === void 0 ? void 0 : settings.adjustWheelPrecision) !== false) {
-                            activeCamera.wheelPrecision = helperCamera.wheelPrecision;
-                        }
-                        if ((settings === null || settings === void 0 ? void 0 : settings.adjustPanningSensibility) !== false) {
-                            activeCamera.panningSensibility = helperCamera.panningSensibility;
-                        }
-                        if ((settings === null || settings === void 0 ? void 0 : settings.adjustPinchPrecision) !== false) {
-                            activeCamera.pinchPrecision = helperCamera.pinchPrecision;
-                        }
-                        newCameraPosition = {
-                            alpha: helperCamera.alpha,
-                            beta: helperCamera.beta,
-                            radius: helperCamera.radius,
-                            target: helperCamera.target,
-                        };
-                        return [4 /*yield*/, this.animationManager.animateToPlacement(activeCamera, newCameraPosition, settings === null || settings === void 0 ? void 0 : settings.animation)];
-                    case 1:
-                        _a.sent();
-                        return [2 /*return*/];
-                }
-            });
-        });
-    };
-    Viewer.version = version;
-    return Viewer;
-}(EventBroadcaster));
-export { Viewer };
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import version from '../../buildinfo.json';
+import { sceneSetup } from '../internal/sceneSetup';
+import { AnimationManager } from '../manager/animationManager';
+import { GltfExportManager } from '../manager/gltfExportManager';
+import { SceneManager } from '../manager/sceneManager';
+import { VariantInstanceManager } from '../manager/variantInstanceManager';
+import { SpecStorage } from '../store/specStorage';
+import { backgroundDomeName, envHelperMetadataName } from '../util/babylonHelper';
+import { debounce, loadJavascript, loadJson } from '../util/resourceHelper';
+import { getCustomCbnBabylonLoaderPlugin } from '../util/sceneLoaderHelper';
+import { isMeshIncludedInExclusionList } from '../util/structureHelper';
+import { Event } from './event';
+import { EventBroadcaster } from './eventBroadcaster';
+import { Parameter } from './parameter';
+import { Variant } from './variant';
+import { ArcRotateCamera } from '@babylonjs/core/Cameras/arcRotateCamera';
+import { BoundingInfo } from '@babylonjs/core/Culling/boundingInfo';
+import { DebugLayer } from '@babylonjs/core/Debug/debugLayer';
+import { Engine } from '@babylonjs/core/Engines/engine';
+import { HighlightLayer } from '@babylonjs/core/Layers/highlightLayer';
+import { SceneLoader } from '@babylonjs/core/Loading/sceneLoader';
+import { DynamicTexture } from '@babylonjs/core/Materials/Textures/dynamicTexture';
+import { StandardMaterial } from '@babylonjs/core/Materials/standardMaterial';
+import { Color3 } from '@babylonjs/core/Maths/math.color';
+import { Vector3 } from '@babylonjs/core/Maths/math.vector';
+import { Mesh } from '@babylonjs/core/Meshes/mesh';
+import { ScreenshotTools } from '@babylonjs/core/Misc/screenshotTools';
+import { WebXRSessionManager } from '@babylonjs/core/XR/webXRSessionManager';
+import { isString } from 'lodash-es';
+/**
+ * The main exposed object. This is the entry point into the application
+ *
+ * ```js
+ * const canvas = document.getElementById( 'babylon-canvas' );
+ * const viewer = Viewer( canvas, '/path/to/index.json' );
+ * ```
+ * The class does nothing on its own and needs to {@link bootstrap}
+ */
+export class Viewer extends EventBroadcaster {
+    /**
+     * Constructor
+     */
+    constructor(canvas, structureJson) {
+        super();
+        this.canvas = canvas;
+        this.structureJson = structureJson;
+        this._scene = null;
+        this._animationManager = null;
+        this._sceneManager = null;
+        this._gltfExportManager = null;
+        this._variantInstances = null;
+        // default value is `true` ATM for compatibility reasons
+        // in the future material cloning should be the edge case
+        this._cloneMaterialsOnMutation = true;
+        this._isRenderLoopPaused = false;
+        this._inspectorLoaded = false;
+    }
+    /**
+     * Gets the BabylonJS Scene that is attached to the instance.
+     *
+     * @throws Error if the `scene` has not been initialized.
+     */
+    get scene() {
+        if (!this._scene) {
+            throw new Error(`Scene has not been initialized.`);
+        }
+        return this._scene;
+    }
+    /**
+     * Gets the {@link SceneManager} attached to the viewer.
+     *
+     * @throws Error if the {@link SceneManager} has not been initialized.
+     */
+    get sceneManager() {
+        if (!this._sceneManager) {
+            throw new Error(`SceneManager has not been initialized.`);
+        }
+        return this._sceneManager;
+    }
+    /**
+     * Gets the {@link GltfExportManager} attached to the viewer.
+     *
+     * @throws Error if the {@link GltfExportManager} has not been initialized.
+     */
+    get gltfExportManager() {
+        if (!this._gltfExportManager) {
+            throw new Error(`GltfExportManager has not been initialized.`);
+        }
+        return this._gltfExportManager;
+    }
+    /**
+     * Gets the BabylonJS Engine that is attached to the viewer.
+     */
+    get engine() {
+        return this.scene.getEngine();
+    }
+    /**
+     * Gets the {@link VariantInstanceManager} attached to the viewer.
+     *
+     * @throws Error if the {@link VariantInstanceManager} has not been initialized.
+     */
+    get variantInstances() {
+        if (!this._variantInstances) {
+            throw Error(`There is no variantInstanceManager.`);
+        }
+        return this._variantInstances;
+    }
+    /**
+     * Gets the {@link AnimationManager} attached to the viewer.
+     *
+     * @throws Error if the {@link AnimationManager} has not been initialized.
+     */
+    get animationManager() {
+        if (!this._animationManager) {
+            throw new Error(`There is no animationManager instance.`);
+        }
+        return this._animationManager;
+    }
+    /**
+     * Gets the `cloneMaterialsOnMutation` flag, as defined in the spec
+     */
+    get cloneMaterialsOnMutation() {
+        return this._cloneMaterialsOnMutation;
+    }
+    /**
+     * Starts the application. This will
+     * * load the given "index" JSON file
+     * * setup the scene with the "scene" JSON file
+     * * create an (optional) default setup with different variant settings
+     * * sets up resizing by attaching a debounced version of {@link resize}
+     *
+     * @throws Error if any of the files is not found/valid
+     *
+     * @emits {@link Event.BOOTSTRAP_START}
+     * @emits {@link Event.BOOTSTRAP_END}
+     */
+    bootstrap() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.broadcastEvent(Event.BOOTSTRAP_START, this);
+            let indexJson;
+            if (isString(this.structureJson)) {
+                indexJson = yield loadJson(this.structureJson);
+            }
+            else {
+                indexJson = this.structureJson;
+            }
+            if (!indexJson.scene) {
+                throw new Error(`No "scene" property found for bootstrapping.`);
+            }
+            // fill spec store
+            SpecStorage.createFromSpec(indexJson);
+            this.initCbnBabylonLoaderPlugin();
+            // load scene
+            if (isString(indexJson.scene)) {
+                const sceneJson = yield loadJson(indexJson.scene);
+                indexJson.scene = sceneJson;
+            }
+            this._scene = yield this.initScene();
+            // create instance manager
+            const rootVariant = yield Variant.create('_', indexJson, this);
+            this._variantInstances = yield VariantInstanceManager.create(rootVariant);
+            // create optional default instances
+            if (indexJson.setup) {
+                if (isString(indexJson.setup)) {
+                    const setupJson = yield loadJson(indexJson.setup);
+                    indexJson.setup = setupJson;
+                }
+                yield this.createVariantInstances();
+            }
+            // create gltf export manager
+            this._gltfExportManager = yield GltfExportManager.create(this);
+            // resize handler
+            window.addEventListener('resize', debounce(this.resize.bind(this), 100));
+            // wait until scene is completely ready
+            yield this.scene.whenReadyAsync();
+            // event broadcasting
+            this.broadcastEvent(Event.BOOTSTRAP_END, this);
+            // render loop
+            this.engine.runRenderLoop(() => {
+                if (!this._isRenderLoopPaused)
+                    this.scene.render();
+            });
+            return this;
+        });
+    }
+    /**
+     * Enables the BabylonJS [Inspector](https://doc.babylonjs.com/toolsAndResources/tools/inspector).\
+     * Due to the additional size of the inspector, the CDN version is used instead of shipping the required code with the viewer.\
+     * This means that the code will be downloaded only when needed and calling `enableDebugLayer` can take a little while depending on your internet connection etc.
+     */
+    enableDebugLayer(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this._inspectorLoaded) {
+                // CDN version of inspector requires the BabylonJS core to be available as CDN module as well
+                yield loadJavascript('https://cdn.jsdelivr.net/npm/babylonjs@5.6.0/babylon.min.js');
+                DebugLayer.InspectorURL =
+                    'https://cdn.jsdelivr.net/npm/babylonjs-inspector@5.6.0/babylon.inspector.bundle.max.min.js';
+                this._inspectorLoaded = true;
+            }
+            yield this.scene.debugLayer.show(options);
+        });
+    }
+    /**
+     * Destroys all registered {@link VariantInstance}s that are registered
+     */
+    destroyVariantInstances() {
+        this.variantInstances.all.forEach(variantInstance => {
+            this.variantInstances.destroy(variantInstance.name);
+        });
+        return this;
+    }
+    /**
+     * Trigger a resize event for the `Engine`
+     */
+    resize() {
+        this.engine.resize();
+        return this;
+    }
+    /**
+     * A convenience method for directly getting a Node from a {@link VariantInstance} and an {@link Element} by its
+     * {@link DottedPath}s.
+     */
+    getNode(variantInstanceName, elementDottedPath, nodeDottedPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const variantInstance = yield this.variantInstances.get(variantInstanceName);
+            return variantInstance.getNode(elementDottedPath, nodeDottedPath);
+        });
+    }
+    /**
+     * A convenience method for directly getting a Node from a {@link VariantInstance} and an {@link Element} by its
+     * {@link DottedPath}s.
+     */
+    getMesh(variantInstanceName, elementDottedPath, meshDottedPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const variantInstance = yield this.variantInstances.get(variantInstanceName);
+            return variantInstance.getMesh(elementDottedPath, meshDottedPath);
+        });
+    }
+    /**
+     * Switches the camera
+     *
+     * @emits {@link Event.CAMERA_SWITCHED}
+     */
+    switchCamera(newCamera, reset = true) {
+        const camera = this.scene.getCameraByName(newCamera);
+        if (camera) {
+            const activeCamera = this.scene.activeCamera;
+            if (activeCamera) {
+                activeCamera.detachControl(this.engine.getRenderingCanvas());
+            }
+            if (reset) {
+                camera.restoreState();
+            }
+            this.scene.setActiveCameraByName(newCamera);
+            camera.attachControl(this.engine.getRenderingCanvas());
+            this.broadcastEvent(Event.CAMERA_SWITCHED, camera);
+        }
+        else {
+            throw new Error(`Given camera "${newCamera}" not found.`);
+        }
+        // TODO: put traceable observers to new camera (@see element)
+        return this;
+    }
+    /**
+     * Moves or animates the active camera to given `placement`.
+     */
+    moveActiveCameraTo(placement, animation) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.animationManager.animateToPlacement(this.sceneManager.activeCamera, placement, animation);
+        });
+    }
+    /**
+     * Takes a sceenshot the the current scene. The result is a string containing a base64 encoded image
+     */
+    screenshot(settings) {
+        return new Promise((resolve, reject) => {
+            var _a, _b, _c, _d, _e, _f;
+            if (!this.engine) {
+                return reject('Engine is null');
+            }
+            if (!this.scene) {
+                return reject('Scene is null');
+            }
+            this.scene.render(); // in combination with a render target, we need to refresh the scene manually to get the latest view
+            ScreenshotTools.CreateScreenshotUsingRenderTarget(this.engine, this.sceneManager.activeCamera, (_a = settings === null || settings === void 0 ? void 0 : settings.size) !== null && _a !== void 0 ? _a : { width: this.canvas.clientWidth, height: this.canvas.clientHeight }, resolve, (_b = settings === null || settings === void 0 ? void 0 : settings.mimeType) !== null && _b !== void 0 ? _b : 'image/png', (_c = settings === null || settings === void 0 ? void 0 : settings.samples) !== null && _c !== void 0 ? _c : 1, (_d = settings === null || settings === void 0 ? void 0 : settings.antialiasing) !== null && _d !== void 0 ? _d : false, (_e = settings === null || settings === void 0 ? void 0 : settings.fileName) !== null && _e !== void 0 ? _e : 'screenshot.png', (_f = settings === null || settings === void 0 ? void 0 : settings.renderSprites) !== null && _f !== void 0 ? _f : false);
+        });
+    }
+    /**
+     * Checks whether the browser is capable of handling XR.
+     */
+    isBrowserARCapable() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield WebXRSessionManager.IsSessionSupportedAsync('immersive-ar');
+        });
+    }
+    /**
+     * Calculates the bounding box from all visible meshes on the scene.
+     */
+    calculateBoundingBox(excludeGeometry) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.scene.meshes.length === 0) {
+                throw new Error('There are currently no meshes on the scene.');
+            }
+            this.scene.render(); // CB-6062: workaround for BoundingBox not respecting render loop
+            const bbName = '__bounding_box__';
+            const { max, min } = this.scene.meshes
+                .filter(mesh => {
+                const isEnabled = mesh.isEnabled();
+                // ignore the existing bounding box mesh for calculating the current one
+                const isNotBBoxMesh = bbName !== mesh.id;
+                // ignore meshes with invalid bounding infos
+                const hasValidBBoxInfo = mesh.getBoundingInfo().boundingSphere.radius > 0;
+                // ignore excluded meshes
+                const isExcluded = excludeGeometry ? isMeshIncludedInExclusionList(mesh, excludeGeometry) : false;
+                return isEnabled && isNotBBoxMesh && hasValidBBoxInfo && !isExcluded;
+            })
+                .reduce((accBBoxMinMax, curMesh, idx) => {
+                const bBox = curMesh.getBoundingInfo().boundingBox;
+                // use the first entry in the array as default value and get the resulting maximum/minimum values
+                const max = idx === 0 ? bBox.maximumWorld : Vector3.Maximize(accBBoxMinMax.max, bBox.maximumWorld);
+                const min = idx === 0 ? bBox.minimumWorld : Vector3.Minimize(accBBoxMinMax.min, bBox.minimumWorld);
+                return { max, min };
+            }, { max: new Vector3(), min: new Vector3() });
+            let boundingBox = this.scene.getMeshByName(bbName);
+            if (!boundingBox) {
+                boundingBox = new Mesh(bbName, this.scene);
+            }
+            boundingBox.setBoundingInfo(new BoundingInfo(min, max));
+            return boundingBox;
+        });
+    }
+    /**
+     * Focuses the camera to see every visible mesh in scene and tries to optimize wheel precision and panning
+     */
+    autofocusActiveCamera(settings) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            // first check some preconditions
+            const activeCamera = this.scene.activeCamera;
+            if (!activeCamera) {
+                throw new Error('No active camera found when using autofocus feature.');
+            }
+            if (!(activeCamera instanceof ArcRotateCamera)) {
+                const cameraClsName = activeCamera.getClassName();
+                throw new Error(`Camera of type "${cameraClsName}" is not implemented yet to use autofocus feature.`);
+            }
+            let exclude = (settings === null || settings === void 0 ? void 0 : settings.exclude) || [];
+            // Exclude shown photo dome or environment helper from bounding box calculation
+            const photoDome = this.scene.getNodeByName(backgroundDomeName);
+            const photoDomeMeshes = photoDome === null || photoDome === void 0 ? void 0 : photoDome.getChildMeshes();
+            if (photoDomeMeshes === null || photoDomeMeshes === void 0 ? void 0 : photoDomeMeshes.length) {
+                exclude = [...exclude, ...photoDomeMeshes];
+            }
+            const envHelper = (_a = this.scene.metadata) === null || _a === void 0 ? void 0 : _a[envHelperMetadataName];
+            if (envHelper === null || envHelper === void 0 ? void 0 : envHelper.rootMesh) {
+                exclude = [...exclude, envHelper.rootMesh];
+            }
+            // get bounding box of all visible meshes, this is the base for the autofocus algorithm
+            const boundingBox = yield this.calculateBoundingBox(exclude);
+            // focus the helper camera and set the calculated camera data to the real camera
+            const helperCamera = this.getFocusedHelperCamera(boundingBox, settings);
+            yield this.applyFocusedHelperCameraData(activeCamera, helperCamera, settings);
+            // remove the helper camera
+            helperCamera.dispose();
+        });
+    }
+    /**
+     * Resets everything by calling {@link destroy} to clear all references and {@link bootstrap} to setup a clean
+     * environment
+     */
+    reset() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.destroy();
+            return this.bootstrap();
+        });
+    }
+    /**
+     * Destroys
+     *
+     * * all {@link VariantInstance}s using {@link destroyVariantInstances}
+     * * calling `dispose` on the `Engine` and `Scene`
+     */
+    destroy() {
+        this.destroyVariantInstances();
+        this.scene.dispose();
+        SpecStorage.destroy();
+        return this;
+    }
+    /**
+     * Show coordinate system with given dimension (for debugging purpose).
+     */
+    showWorldCoordinates(dimension) {
+        const scene = this.scene;
+        const makeTextPlane = function (text, color, size) {
+            const dynamicTexture = new DynamicTexture('DynamicTexture', 50, scene, true);
+            dynamicTexture.hasAlpha = true;
+            dynamicTexture.drawText(text, 5, 40, 'bold 36px Arial', color, 'transparent', true);
+            const plane = Mesh.CreatePlane('TextPlane', size, scene, true);
+            plane.material = new StandardMaterial('TextPlaneMaterial', scene);
+            plane.material.backFaceCulling = false;
+            // @ts-ignore
+            plane.material.specularColor = new Color3(0, 0, 0);
+            // @ts-ignore
+            plane.material.diffuseTexture = dynamicTexture;
+            return plane;
+        };
+        const axisX = Mesh.CreateLines('axisX', [
+            Vector3.Zero(),
+            new Vector3(dimension, 0, 0),
+            new Vector3(dimension * 0.95, 0.05 * dimension, 0),
+            new Vector3(dimension, 0, 0),
+            new Vector3(dimension * 0.95, -0.05 * dimension, 0),
+        ], scene, false);
+        axisX.color = new Color3(1, 0, 0);
+        const xChar = makeTextPlane('X', 'red', dimension / 10);
+        xChar.position = new Vector3(0.9 * dimension, -0.05 * dimension, 0);
+        const axisY = Mesh.CreateLines('axisY', [
+            Vector3.Zero(),
+            new Vector3(0, dimension, 0),
+            new Vector3(-0.05 * dimension, dimension * 0.95, 0),
+            new Vector3(0, dimension, 0),
+            new Vector3(0.05 * dimension, dimension * 0.95, 0),
+        ], scene, false);
+        axisY.color = new Color3(0, 1, 0);
+        const yChar = makeTextPlane('Y', 'green', dimension / 10);
+        yChar.position = new Vector3(0, 0.9 * dimension, -0.05 * dimension);
+        const axisZ = Mesh.CreateLines('axisZ', [
+            Vector3.Zero(),
+            new Vector3(0, 0, dimension),
+            new Vector3(0, -0.05 * dimension, dimension * 0.95),
+            new Vector3(0, 0, dimension),
+            new Vector3(0, 0.05 * dimension, dimension * 0.95),
+        ], scene, false);
+        axisZ.color = new Color3(0, 0, 1);
+        const zChar = makeTextPlane('Z', 'blue', dimension / 10);
+        zChar.position = new Vector3(0, 0.05 * dimension, 0.9 * dimension);
+    }
+    /**
+     * Pause render loop.
+     */
+    pauseRendering() {
+        this._isRenderLoopPaused = true;
+    }
+    /**
+     * Resume render loop when paused.
+     */
+    resumeRendering() {
+        this._isRenderLoopPaused = false;
+    }
+    /**
+     * @emits {@link Event.SCENE_PROCESSING_START}
+     * @emits {@link Event.SCENE_PROCESSING_END}
+     */
+    initScene() {
+        var _a, _b, _c;
+        return __awaiter(this, void 0, void 0, function* () {
+            const sceneJson = SpecStorage.get('scene');
+            this.broadcastEvent(Event.SCENE_PROCESSING_START, sceneJson);
+            const engine = new Engine(this.canvas, (_b = (_a = sceneJson.engine) === null || _a === void 0 ? void 0 : _a.antialiasing) !== null && _b !== void 0 ? _b : false, (_c = sceneJson.engine) === null || _c === void 0 ? void 0 : _c.options);
+            const scene = yield sceneSetup(engine, sceneJson);
+            if (sceneJson.meshPicking) {
+                new HighlightLayer('default', scene);
+                scene.onPointerPick = (pointerEvent, pickInfo) => {
+                    if (!pickInfo.hit) {
+                        return;
+                    }
+                    const mesh = pickInfo.pickedMesh;
+                    this.broadcastEvent(Event.MESH_PICKED, mesh, mesh === null || mesh === void 0 ? void 0 : mesh.metadata.element, mesh === null || mesh === void 0 ? void 0 : mesh.metadata.variant);
+                    if (mesh === null || mesh === void 0 ? void 0 : mesh.metadata.element) {
+                        this.broadcastEvent(Event.ELEMENT_PICKED, mesh.metadata.element);
+                    }
+                    if (mesh === null || mesh === void 0 ? void 0 : mesh.metadata.variant) {
+                        if (mesh.metadata.variant.inheritedParameters[Parameter.HIGHLIGHT_ENABLED]) {
+                            mesh.metadata.variant.toggleHighlight();
+                        }
+                        this.broadcastEvent(Event.VARIANT_PICKED, mesh.metadata.variant);
+                    }
+                };
+            }
+            this._sceneManager = yield SceneManager.create(scene);
+            this._animationManager = yield AnimationManager.create(scene);
+            if (sceneJson.cloneMaterialsOnMutation !== undefined) {
+                this._cloneMaterialsOnMutation = sceneJson.cloneMaterialsOnMutation;
+            }
+            this.broadcastEvent(Event.SCENE_PROCESSING_END, scene);
+            return scene;
+        });
+    }
+    /**
+     * Register custom file loader for babylon files which adds "missing-material" metadata to meshes which reference
+     * materials that are not present in the `materials` section of the given babylon file.
+     *
+     * Required for babylon files & materials loaded from "Combeenation configurator assets".
+     */
+    initCbnBabylonLoaderPlugin() {
+        const previousLoaderPlugin = SceneLoader.GetPluginForExtension('babylon');
+        const customLoaderPlugin = getCustomCbnBabylonLoaderPlugin(previousLoaderPlugin);
+        SceneLoader.RegisterPlugin(customLoaderPlugin);
+    }
+    /**
+     * Batch creation of multiple {@link VariantInstance} objects with a {@link SetupJson} object passed
+     */
+    createVariantInstances() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const setupJson = SpecStorage.get('setup');
+            const instances = [];
+            for (const instanceDefinition of setupJson.instances) {
+                if (instanceDefinition.lazy) {
+                    this.variantInstances.register(instanceDefinition);
+                    continue;
+                }
+                instances.push(yield this.variantInstances.create(instanceDefinition.variant, instanceDefinition.name, instanceDefinition.parameters));
+            }
+            return instances;
+        });
+    }
+    /**
+     * Help function for focusing a helper camera exactly onto the given bounding box
+     */
+    getFocusedHelperCamera(boundingBox, settings) {
+        var _a, _b;
+        // use helper camera to get some default values and set the values of the real camera accordingly
+        const helperCamera = new ArcRotateCamera('__helper_camera__', 0, // camera angles will be overwritten after the target has been set
+        0, 0, // radius will be calculated, so we can set to 0 here
+        Vector3.Zero(), this.scene);
+        // this is required for automatically calculating the `lowerRadiusLimit`, so that we don't "dive" into meshes
+        // see https://doc.babylonjs.com/divingDeeper/behaviors/cameraBehaviors#framing-behavior
+        helperCamera.useFramingBehavior = true;
+        // `minZ` is the camera distance beyond which the mesh will be clipped
+        // this should be very low, but can't be zero
+        // a good value seems to be 1% of the bounding box size (= radius), whereas the value shouldn't go above 1, which is also the default value
+        const radius = boundingBox.getBoundingInfo().boundingSphere.radius;
+        helperCamera.minZ = Math.min(radius / 100, 1);
+        // set desired camera data, these won't be changed by the autofocus function!
+        // default values should focus the element exactly from the front (= XY Plane)
+        helperCamera.setTarget(boundingBox, true);
+        helperCamera.alpha = ((_a = settings === null || settings === void 0 ? void 0 : settings.alpha) !== null && _a !== void 0 ? _a : -90) * (Math.PI / 180);
+        helperCamera.beta = ((_b = settings === null || settings === void 0 ? void 0 : settings.beta) !== null && _b !== void 0 ? _b : 90) * (Math.PI / 180);
+        // finally zoom to the bounding box
+        // also apply a zoom factor, this adjusts the borders around the model in the viewport
+        helperCamera.zoomOnFactor = (settings === null || settings === void 0 ? void 0 : settings.radiusFactor) || 1;
+        helperCamera.zoomOn([boundingBox], true);
+        return helperCamera;
+    }
+    /**
+     * Help function for applying the relevant data of the focused helper camera to the real camera
+     */
+    applyFocusedHelperCameraData(activeCamera, helperCamera, settings) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // limits
+            activeCamera.minZ = helperCamera.minZ;
+            activeCamera.maxZ = helperCamera.maxZ;
+            activeCamera.lowerRadiusLimit = helperCamera.lowerRadiusLimit;
+            activeCamera.upperRadiusLimit = helperCamera.upperRadiusLimit;
+            // additional settings
+            if ((settings === null || settings === void 0 ? void 0 : settings.adjustWheelPrecision) !== false) {
+                activeCamera.wheelPrecision = helperCamera.wheelPrecision;
+            }
+            if ((settings === null || settings === void 0 ? void 0 : settings.adjustPanningSensibility) !== false) {
+                activeCamera.panningSensibility = helperCamera.panningSensibility;
+            }
+            if ((settings === null || settings === void 0 ? void 0 : settings.adjustPinchPrecision) !== false) {
+                activeCamera.pinchPrecision = helperCamera.pinchPrecision;
+            }
+            // finally move the camera
+            // do this at last, so that all camera settings are already considered
+            const newCameraPosition = {
+                alpha: helperCamera.alpha,
+                beta: helperCamera.beta,
+                radius: helperCamera.radius,
+                target: helperCamera.target,
+            };
+            yield this.animationManager.animateToPlacement(activeCamera, newCameraPosition, settings === null || settings === void 0 ? void 0 : settings.animation);
+        });
+    }
+}
+Viewer.version = version;
 //# sourceMappingURL=viewer.js.map