@combeenation/3d-viewer 5.1.0-rc3 → 5.1.0-rc4

package/dist/lib-es6/api/manager/variantInstanceManager.js

@@ -0,0 +1,333 @@
+import { __awaiter, __extends, __generator } from "tslib";
+import { merge } from 'lodash-es';
+import { DottedPath } from '../classes/dottedPath';
+import { Event } from '../classes/event';
+import { EventBroadcaster } from '../classes/eventBroadcaster';
+import { Parameter } from '../classes/parameter';
+import { VariantInstance } from '../classes/variantInstance';
+/**
+ * There's usually no need to instantiate a {@link VariantInstanceManager} yourself as it is provided by each
+ * {@link Viewer} instance via its {@link Viewer.variantInstances}
+ */
+var VariantInstanceManager = /** @class */ (function (_super) {
+    __extends(VariantInstanceManager, _super);
+    /**
+     * Constructor.
+     */
+    function VariantInstanceManager(rootVariant) {
+        var _this = _super.call(this) || this;
+        _this.rootVariant = rootVariant;
+        _this.variantInstancePromises = new Map();
+        _this.variantInstances = new Map();
+        _this.variantInstanceDefinitions = new Map();
+        _this.parameters = {};
+        _this.queues = {};
+        return _this;
+    }
+    /**
+     * Creates a {@link VariantInstanceManager} based on given root Variant.
+     */
+    VariantInstanceManager.create = function (rootVariant) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, new VariantInstanceManager(rootVariant)];
+            });
+        });
+    };
+    Object.defineProperty(VariantInstanceManager.prototype, "all", {
+        /**
+         * Gets all instances.
+         */
+        get: function () {
+            var all = [];
+            this.variantInstances.forEach(function (variantInstance) { return all.push(variantInstance); });
+            return all;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(VariantInstanceManager.prototype, "allDefinitions", {
+        /**
+         * Gets all instance definitions.
+         */
+        get: function () {
+            var all = [];
+            this.variantInstanceDefinitions.forEach(function (definition) { return all.push(definition); });
+            return all;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Checks whether a {@link VariantInstance} is either registered or created.
+     */
+    VariantInstanceManager.prototype.has = function (name) {
+        return this.variantInstances.has(name) || this.variantInstanceDefinitions.has(name);
+    };
+    /**
+     * Retrieves a {@link VariantInstance}.
+     * If the instance has been created, the created instance will be returned.
+     * If the instance is registered, the instance will be created and returned.
+     * if the instance has already been requested and is currently pending, the dedicated promise will be returned.
+     * If none of these apply, an Error is thrown.
+     *
+     * @emits {@link Event.VARIANT_INSTANCE_CREATED}
+     */
+    VariantInstanceManager.prototype.get = function (name) {
+        return __awaiter(this, void 0, void 0, function () {
+            var definition, vip;
+            var _this = this;
+            return __generator(this, function (_a) {
+                // 1) see if we have an instance of that name already and return it if found
+                if (this.variantInstances.has(name)) {
+                    return [2 /*return*/, this.variantInstances.get(name)]; // cannot be null, hence the exclamation mark
+                }
+                // 2) try to get promise from list of requested instances and return it if found
+                if (this.variantInstancePromises.has(name)) {
+                    return [2 /*return*/, this.variantInstancePromises.get(name)];
+                }
+                // 3) see if there's a definition of that name, create an instance from it and store the related promise
+                if (this.variantInstanceDefinitions.has(name)) {
+                    definition = this.variantInstanceDefinitions.get(name);
+                    vip = this.createFromDefinition(definition);
+                    this.variantInstancePromises.set(name, vip);
+                    // remove promise after it has been finished
+                    vip.then(function () { return _this.variantInstancePromises.delete(name); });
+                    return [2 /*return*/, vip];
+                }
+                //* if we are here, no instance definition of that name exists. throw error.
+                throw Error("VariantInstance with name \"" + name + "\" neither created nor configured.");
+            });
+        });
+    };
+    /**
+     * Creates and registers a unique {@link VariantInstance}.
+     *
+     * @emits {@link Event.VARIANT_INSTANCE_CREATED}
+     */
+    VariantInstanceManager.prototype.create = function (dottedPath, name, parameters) {
+        return __awaiter(this, void 0, void 0, function () {
+            var variant, definition;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        variant = DottedPath.create(dottedPath).path;
+                        definition = {
+                            name: this.ensureUniqueName(name ? name : variant),
+                            variant: variant,
+                            parameters: parameters,
+                        };
+                        return [4 /*yield*/, this.createFromDefinition(definition)];
+                    case 1: return [2 /*return*/, _a.sent()];
+                }
+            });
+        });
+    };
+    /**
+     * Registers a unique {@link VariantInstanceDefinition}.
+     *
+     * @emits {@link Event.VARIANT_INSTANCE_REGISTERED}
+     */
+    VariantInstanceManager.prototype.register = function (instanceDefinition) {
+        var name = instanceDefinition.name ? instanceDefinition.name : DottedPath.create(instanceDefinition.variant).path;
+        instanceDefinition.name = this.ensureUniqueName(name);
+        this.variantInstanceDefinitions.set(instanceDefinition.name, instanceDefinition);
+        this.broadcastEvent(Event.VARIANT_INSTANCE_REGISTERED, instanceDefinition);
+        return instanceDefinition;
+    };
+    /**
+     * Commits the {@link ParameterBag} to all registered and created {@link VariantInstance}s.
+     */
+    VariantInstanceManager.prototype.commitParameters = function (parameters, onlyVisible) {
+        if (parameters === void 0) { parameters = {}; }
+        if (onlyVisible === void 0) { onlyVisible = true; }
+        return __awaiter(this, void 0, void 0, function () {
+            var instances, promises;
+            var _this = this;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        this.parameters = merge(this.parameters, parameters);
+                        this.allDefinitions.forEach(function (definition) { return (definition.parameters = merge(definition.parameters, _this.parameters)); });
+                        instances = this.all;
+                        if (onlyVisible) {
+                            instances = this.all.filter(function (instance) { return instance.variant.visible; });
+                        }
+                        promises = instances.map(function (instance) { return instance.variant.commitParameters(_this.parameters); });
+                        return [4 /*yield*/, Promise.all(promises)];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/, this];
+                }
+            });
+        });
+    };
+    /**
+     * Show one {@link VariantInstance}. If `exclusive` is set to `true` it will hide all other
+     * instances handled by this {@link VariantInstanceManager}. If the function is called synchronously,
+     * the calls end up in a queue according to the FIFO principle (the last one wins).
+     */
+    VariantInstanceManager.prototype.show = function (name, exclusive) {
+        if (exclusive === void 0) { exclusive = false; }
+        return __awaiter(this, void 0, void 0, function () {
+            var promise, i, instance;
+            var _this = this;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        promise = new Promise(function (resolve) { return __awaiter(_this, void 0, void 0, function () {
+                            var instance;
+                            return __generator(this, function (_a) {
+                                switch (_a.label) {
+                                    case 0:
+                                        if (!exclusive) return [3 /*break*/, 2];
+                                        this.allDefinitions
+                                            .filter(function (definition) { return definition.name !== name; })
+                                            .forEach(function (definition) {
+                                            var parameters = {};
+                                            parameters[Parameter.VISIBLE] = false;
+                                            definition.parameters = merge(definition.parameters, parameters);
+                                        });
+                                        return [4 /*yield*/, Promise.all(this.all
+                                                .filter(function (_instance) { return _instance.name !== name; })
+                                                .map(function (_instance) {
+                                                return _instance.variant.hide();
+                                            }))];
+                                    case 1:
+                                        _a.sent();
+                                        _a.label = 2;
+                                    case 2: return [4 /*yield*/, this.get(name)];
+                                    case 3:
+                                        instance = _a.sent();
+                                        return [4 /*yield*/, instance.variant.show()];
+                                    case 4:
+                                        _a.sent();
+                                        resolve(instance);
+                                        return [2 /*return*/];
+                                }
+                            });
+                        }); });
+                        if (!this.queues['show']) {
+                            this.queues['show'] = [];
+                        }
+                        this.queues['show'].push(promise);
+                        i = 0;
+                        _a.label = 1;
+                    case 1:
+                        if (!(i < this.queues['show'].length)) return [3 /*break*/, 5];
+                        return [4 /*yield*/, this.queues['show'][i]];
+                    case 2:
+                        instance = _a.sent();
+                        if (!exclusive) return [3 /*break*/, 4];
+                        if (!(i + 1 < this.queues['show'].length)) return [3 /*break*/, 4];
+                        return [4 /*yield*/, instance.variant.hide()];
+                    case 3:
+                        _a.sent();
+                        _a.label = 4;
+                    case 4:
+                        i++;
+                        return [3 /*break*/, 1];
+                    case 5:
+                        this.queues['show'] = [];
+                        return [2 /*return*/, promise];
+                }
+            });
+        });
+    };
+    /**
+     * Clones and registers a new {@link VariantInstance} with a new, unique name.
+     *
+     * @emits {@link Event.VARIANT_INSTANCE_CLONED}
+     */
+    VariantInstanceManager.prototype.clone = function (name, newName, parameters) {
+        return __awaiter(this, void 0, void 0, function () {
+            var variantInstance, definition, living, variantInstanceClone;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!this.variantInstances.has(name)) {
+                            throw Error("VariantInstance with name \"" + name + "\" does not exist.");
+                        }
+                        variantInstance = this.variantInstances.get(name);
+                        definition = {
+                            name: this.ensureUniqueName(newName ? newName : name),
+                            variant: variantInstance.variant.id,
+                            parameters: parameters,
+                        };
+                        return [4 /*yield*/, variantInstance.variant.createLiving(definition.parameters)];
+                    case 1:
+                        living = _a.sent();
+                        variantInstanceClone = new VariantInstance(living, definition.name);
+                        this.variantInstances.set(definition.name, variantInstanceClone);
+                        variantInstance.broadcastEvent(Event.VARIANT_INSTANCE_CLONED, variantInstanceClone);
+                        return [2 /*return*/, variantInstanceClone];
+                }
+            });
+        });
+    };
+    /**
+     * Destroys the instance by removing the {@link Variant} and de-registering the instance.
+     *
+     * @emits {@link Event.VARIANT_INSTANCE_DESTROYED}
+     */
+    VariantInstanceManager.prototype.destroy = function (name) {
+        if (!this.variantInstances.has(name)) {
+            throw Error("VariantInstance with name \"" + name + "\" does not exist.");
+        }
+        var variantInstance = this.variantInstances.get(name);
+        variantInstance.variant.destroy();
+        this.variantInstances.delete(name);
+        variantInstance.broadcastEvent(Event.VARIANT_INSTANCE_DESTROYED, variantInstance);
+        return this;
+    };
+    /**
+     * Creates and registers a unique {@link VariantInstance} from `definition`.
+     *
+     * @emits {@link Event.VARIANT_INSTANCE_CREATED}
+     */
+    VariantInstanceManager.prototype.createFromDefinition = function (definition) {
+        return __awaiter(this, void 0, void 0, function () {
+            var variant, living, variantInstance;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!definition.name) {
+                            throw new Error("Given VariantInstanceDefinition " + definition.variant + " is missing a name property.");
+                        }
+                        if (this.variantInstances.has(definition.name)) {
+                            throw new Error("VariantInstance with name \"" + definition.name + "\" is already created.");
+                        }
+                        if (!this.rootVariant) {
+                            throw new Error("Viewer has not been properly bootstrapped (rootVariant missing).");
+                        }
+                        return [4 /*yield*/, this.rootVariant.getDescendant(definition.variant)];
+                    case 1:
+                        variant = _a.sent();
+                        return [4 /*yield*/, variant.createLiving(definition.parameters)];
+                    case 2:
+                        living = _a.sent();
+                        variantInstance = new VariantInstance(living, definition.name);
+                        this.variantInstances.set(definition.name, variantInstance);
+                        this.broadcastEvent(Event.VARIANT_INSTANCE_CREATED, variantInstance);
+                        return [2 /*return*/, variantInstance];
+                }
+            });
+        });
+    };
+    /**
+     * Creates a unique instance name based on already registered instance names on the {@link VariantInstanceManager}.
+     * Appends an `_i` to the name where `i = 0` and increments as long as the name is not registered.
+     */
+    VariantInstanceManager.prototype.ensureUniqueName = function (name) {
+        var instanceName = name;
+        var i = 1;
+        while (this.has(instanceName)) {
+            instanceName = name + "_" + i;
+            i++;
+        }
+        return instanceName;
+    };
+    return VariantInstanceManager;
+}(EventBroadcaster));
+export { VariantInstanceManager };
+//# sourceMappingURL=variantInstanceManager.js.map

package/dist/lib-es6/api/manager/variantInstanceManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variantInstanceManager.js","sourceRoot":"","sources":["../../../../src/api/manager/variantInstanceManager.ts"],"names":[],"mappings":"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"}

package/dist/lib-es6/api/store/specStorage.d.ts

@@ -0,0 +1,24 @@
+export declare class SpecStorage {
+    protected spec: StructureJson;
+    static instance: SpecStorage | undefined;
+    /**
+     * Constructor.
+     */
+    protected constructor(spec: StructureJson);
+    /**
+     * Creates {@link SpecStorage} from spec.
+     */
+    static createFromSpec(structureJson: StructureJson): SpecStorage;
+    /**
+     * Destroys the current instance to allow reinstantiating the SpecStorage.
+     */
+    static destroy(): void;
+    /**
+     * Gets spec from key.
+     */
+    static get<T>(key?: string): T;
+    /**
+     * Sets value for spec for given key.
+     */
+    static set<T>(key: string, value: T): typeof SpecStorage;
+}

package/dist/lib-es6/api/store/specStorage.js

@@ -0,0 +1,49 @@
+import { get, set } from 'lodash-es';
+var SpecStorage = /** @class */ (function () {
+    /**
+     * Constructor.
+     */
+    function SpecStorage(spec) {
+        this.spec = spec;
+    }
+    /**
+     * Creates {@link SpecStorage} from spec.
+     */
+    SpecStorage.createFromSpec = function (structureJson) {
+        if (this.instance) {
+            throw new Error("SpecStorage has already been created.");
+        }
+        return (this.instance = new this(structureJson));
+    };
+    /**
+     * Destroys the current instance to allow reinstantiating the SpecStorage.
+     */
+    SpecStorage.destroy = function () {
+        this.instance = undefined;
+    };
+    /**
+     * Gets spec from key.
+     */
+    SpecStorage.get = function (key) {
+        if (!this.instance || !this.instance.spec) {
+            throw new Error("SpecStore has not been properly created.");
+        }
+        if (key) {
+            return get(this.instance.spec, key);
+        }
+        return this.instance.spec;
+    };
+    /**
+     * Sets value for spec for given key.
+     */
+    SpecStorage.set = function (key, value) {
+        if (!this.instance || !this.instance.spec) {
+            throw new Error("SpecStore has not been properly created.");
+        }
+        set(this.instance.spec, key, value);
+        return SpecStorage;
+    };
+    return SpecStorage;
+}());
+export { SpecStorage };
+//# sourceMappingURL=specStorage.js.map

package/dist/lib-es6/api/store/specStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specStorage.js","sourceRoot":"","sources":["../../../../src/api/store/specStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC;IAGE;;OAEG;IACH,qBAAgC,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEvD;;OAEG;IACW,0BAAc,GAA5B,UAA6B,aAA4B;QACvD,IAAI,IAAI,CAAC,QAAQ,EAAE;YACjB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;SAC1D;QACD,OAAO,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACW,mBAAO,GAArB;QACE,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;IAC5B,CAAC;IAED;;OAEG;IACW,eAAG,GAAjB,UAAqB,GAAY;QAC/B,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;YACzC,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;SAC7D;QACD,IAAI,GAAG,EAAE;YACP,OAAO,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAM,CAAC;SAC1C;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAS,CAAC;IACjC,CAAC;IAED;;OAEG;IACW,eAAG,GAAjB,UAAqB,GAAW,EAAE,KAAQ;QACxC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;YACzC,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;SAC7D;QACD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACpC,OAAO,WAAW,CAAC;IACrB,CAAC;IACH,kBAAC;AAAD,CAAC,AAhDD,IAgDC"}

package/dist/lib-es6/api/util/babylonHelper.d.ts

@@ -0,0 +1,174 @@
+import { HighlightLayer } from '@babylonjs/core/Layers/highlightLayer';
+import { ShadowGenerator } from '@babylonjs/core/Lights/Shadows/shadowGenerator';
+import { Material } from '@babylonjs/core/Materials/material';
+import { Color3 } from '@babylonjs/core/Maths/math.color';
+import { AbstractMesh } from '@babylonjs/core/Meshes/abstractMesh';
+import { TransformNode } from '@babylonjs/core/Meshes/transformNode';
+import { Node } from '@babylonjs/core/node';
+import { Scene } from '@babylonjs/core/scene';
+import { DottedPath } from '../classes/dottedPath';
+declare const backgroundDomeName = "BackgroundDome_ViewerGenerated";
+declare const envHelperMetadataName = "viewerEnvHelper";
+/**
+ * @param node
+ * @return Node
+ */
+declare const getRootNode: (node: Node) => Node;
+/**
+ * @param nodes
+ * @param predicate
+ * @return Map<DottedPath, T>
+ */
+declare const mapToDottedNodes: <T>(nodes: Node[], predicate?: ((node: Node) => boolean) | undefined) => Map<DottedPath, T>;
+/**
+ * @param node
+ * @return DottedPath
+ */
+declare const getDottedPathForNode: (node: Node) => DottedPath;
+/**
+ * @param node
+ * @param predicate
+ * @param deep
+ * @return TransformNode | null
+ */
+declare const cloneTransformNode: (node: TransformNode, predicate?: ((node: TransformNode) => boolean) | undefined, deep?: boolean) => TransformNode | null;
+/**
+ * @param node
+ */
+declare const cloneNodeWithParents: (node: Node | null) => Node | null;
+/**
+ * @param node
+ * @param deep
+ * @param prefix
+ * @return TransformNode
+ */
+declare const cloneTransformNodeMaterial: (node: TransformNode, prefix?: DottedPathArgument, deep?: boolean) => TransformNode;
+/**
+ * @param node
+ * @param deep
+ * @param metadata
+ */
+declare const injectNodeMetadata: (node: Node, metadata: {}, deep?: boolean) => void;
+/**
+ * @param node
+ * @param assertCallable
+ * @param callableParameters
+ * @param deep
+ */
+declare const assertTransformNode: (node: TransformNode, assertCallable: CallableFunction, callableParameters?: any[], deep?: boolean) => void;
+/**
+ * @param node
+ * @param deep
+ */
+declare const activateTransformNode: (node: TransformNode, deep?: boolean) => void;
+/**
+ * @param node
+ * @param deep
+ */
+declare const deactivateTransformNode: (node: TransformNode, deep?: boolean) => void;
+/**
+ * @param node
+ */
+declare const enableNodeWithParents: (node: Node) => void;
+/**
+ * @param node
+ */
+declare const disableNodeWithParents: (node: Node) => void;
+/**
+ * Applies a {@link TransformationDefinition} consecutively to ensure dependencies in positioning etc.
+ * @param node
+ * @param transformation
+ */
+declare const transformTransformNode: (node: TransformNode, transformation: TransformationDefinition) => void;
+/**
+ * Apply changes of environment (background texture, etc.) consecutively in order to avoid dependency related issues.
+ * @param scene
+ * @param envDef
+ */
+declare const changeEnvironment: (scene: Scene, envDef: EnvironmentDefinition) => void;
+/**
+ * @param node
+ * @param materialName
+ * @param deep
+ */
+declare const setMaterial: (variant: Variant, node: TransformNode, materialName: string, deep?: boolean) => void;
+/**
+ * !!! Warning !!!
+ * This function is not public API. Whilst it can help solving certain problems, it only works reliably in well defined
+ * situations and can cause unwanted side effects under some conditions. Use carefully at your own risk!
+ *
+ * See https://combeenation.myjetbrains.com/youtrack/issue/CB-5906 for further details regarding this warning.
+ *
+ * Set material of an instanced meshes source mesh.
+ * Changes the material of all instanced meshes which have the same source mesh.
+ *
+ * @param node
+ * @param material
+ * @param deep
+ *
+ * @ignore
+ */
+declare const setSourceNodeMaterial: (node: TransformNode, material: Material, deep?: boolean) => void;
+/**
+ * @param node
+ * @param color
+ * @param deep
+ */
+declare const setMaterialColor: (node: TransformNode, color: Color3, deep?: boolean) => void;
+/**
+ * @param node
+ * @param texture
+ * @param deep
+ */
+declare const setMaterialTexture: (node: TransformNode, texture: Texture, deep?: boolean) => void;
+/**
+ * @param node
+ * @param metallness
+ * @param deep
+ */
+declare const setMaterialMetallness: (node: TransformNode, metallness: number, deep?: boolean) => void;
+/**
+ * @param node
+ * @param roughness
+ * @param deep
+ */
+declare const setMaterialRoughness: (node: TransformNode, roughness: number, deep?: boolean) => void;
+/**
+ * @param node
+ * @param layer
+ * @param color
+ * @param deep
+ */
+declare const addToHighlightLayer: (layer: HighlightLayer, color: Color3, node: TransformNode, deep?: boolean) => void;
+/**
+ * @param node
+ * @param layer
+ * @param deep
+ */
+declare const removeFromHighlightLayer: (layer: HighlightLayer, node: TransformNode, deep?: boolean) => void;
+/**
+ * @param node
+ * @param receiveShadows
+ * @param deep
+ */
+declare const setReceiveShadows: (node: TransformNode, receiveShadows: boolean, deep?: boolean) => void;
+/**
+ * @param node
+ * @param generator
+ * @param deep
+ */
+declare const addToShadowGenerator: (generator: ShadowGenerator, node: TransformNode, deep?: boolean) => void;
+/**
+ * @param node
+ * @param generator
+ * @param deep
+ */
+declare const removeFromShadowGenerator: (generator: ShadowGenerator, node: TransformNode, deep?: boolean) => void;
+/**
+ * https://forum.babylonjs.com/t/get-mesh-bounding-box-position-and-size-in-2d-screen-coordinates/1058/3
+ * @param mesh
+ * @param scene
+ * @param canvas
+ */
+declare const getClientRectFromMesh: (mesh: AbstractMesh, scene: Scene, canvas: HTMLCanvasElement) => ClientRect;
+export { getRootNode, mapToDottedNodes, getDottedPathForNode, cloneTransformNode, cloneNodeWithParents, cloneTransformNodeMaterial, injectNodeMetadata, assertTransformNode, activateTransformNode, deactivateTransformNode, enableNodeWithParents, disableNodeWithParents, transformTransformNode, setMaterial, setSourceNodeMaterial, setMaterialColor, setMaterialTexture, setMaterialMetallness, setMaterialRoughness, addToHighlightLayer, removeFromHighlightLayer, setReceiveShadows, addToShadowGenerator, removeFromShadowGenerator, getClientRectFromMesh, changeEnvironment, backgroundDomeName, envHelperMetadataName, };