@combeenation/3d-viewer 6.0.0 → 6.1.0-beta2

package/dist/lib-cjs/api/manager/sceneManager.js

@@ -1,128 +1,131 @@
-"use strict";
-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());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SceneManager = void 0;
-const event_1 = require("../classes/event");
-const parameter_1 = require("../classes/parameter");
-const parameterObservable_1 = require("../classes/parameterObservable");
-const specStorage_1 = require("../store/specStorage");
-const babylonHelper_1 = require("../util/babylonHelper");
-const resourceHelper_1 = require("../util/resourceHelper");
-const lodash_es_1 = require("lodash-es");
-class SceneManager extends parameterObservable_1.ParameterObservable {
-    /**
-     * Constructor.
-     */
-    constructor(scene) {
-        super();
-        this.scene = scene;
-        this._parameterObservers = new Map();
-        this.addParameterObservers();
-    }
-    /**
-     * Creates a {@link SceneManager} based on given BabylonJS scene.
-     */
-    static create(scene) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const sceneManager = new SceneManager(scene);
-            yield sceneManager.bootstrapParameters(specStorage_1.SpecStorage.get('scene.parameters'));
-            return sceneManager;
-        });
-    }
-    /**
-     * The active `Camera`.
-     */
-    get activeCamera() {
-        if (!this.scene.activeCamera) {
-            throw new Error('Scene has no active camera.');
-        }
-        return this.scene.activeCamera;
-    }
-    /**
-     * Places the given {@link ParameterBag} in the {@link SceneManager}'s parameters, replaces all patterns in the
-     * {@link StructureJson} and broadcasts all {@link ParameterObserver}s.
-     *
-     * @emit {@link Event.SCENE_PARAMETER_COMMITTED}
-     */
-    commitParameters(parameters) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (!parameters) {
-                parameters = {};
-            }
-            const oldParameters = (0, lodash_es_1.cloneDeep)(this.parameters);
-            (0, lodash_es_1.merge)(this.parameters, parameters);
-            // handle parameter observers
-            let observerPromises = [];
-            for (const parameter in this.parameters) {
-                const oldParameterValue = oldParameters[parameter];
-                const newParameterValue = this.parameters[parameter];
-                this.assertParameter(parameter_1.Parameter.declarations, parameter, newParameterValue);
-                if (oldParameterValue === newParameterValue) {
-                    continue;
-                }
-                // parameter changed
-                const parameterObservers = (0, resourceHelper_1.mergeMaps)(this._parameterObservers, this.parameterObservers);
-                if (parameterObservers.has(parameter)) {
-                    const observers = parameterObservers.get(parameter);
-                    observerPromises = (0, lodash_es_1.concat)(observerPromises, observers.map(observer => {
-                        const observerResult = observer(this, oldParameterValue, newParameterValue);
-                        const observerPromise = Promise.resolve(observerResult);
-                        observerPromise.then(() => {
-                            this.broadcastEvent(event_1.Event.SCENE_PARAMETER_COMMITTED, this, parameter, oldParameterValue, newParameterValue);
-                        });
-                        return observerPromise;
-                    }));
-                }
-            }
-            yield Promise.all(observerPromises);
-            return this;
-        });
-    }
-    addParameterObservers() {
-        const handleEnvParamChange = (manager, oldValue, newValue) => {
-            const params = {
-                color: manager.parameters[parameter_1.Parameter.ENVIRONMENT_COLOR],
-                intensity: manager.parameters[parameter_1.Parameter.ENVIRONMENT_INTENSITY],
-                env: manager.parameters[parameter_1.Parameter.ENVIRONMENT],
-                background: manager.parameters[parameter_1.Parameter.ENVIRONMENT_BACKGROUND],
-                rotation: manager.parameters[parameter_1.Parameter.ENVIRONMENT_ROTATION],
-                useDefault: manager.parameters[parameter_1.Parameter.ENVIRONMENT_USEDEFAULT],
-            };
-            const envDef = {
-                environmentColor: params.color ? parameter_1.Parameter.parseColor(params.color) : undefined,
-                environmentIntensity: params.intensity !== undefined ? parameter_1.Parameter.parseNumber(params.intensity) : undefined,
-                environment: params.env ? params.env : undefined,
-                environmentBackground: params.background ? params.background : undefined,
-                environmentRotation: params.rotation !== undefined ? parameter_1.Parameter.parseNumber(params.rotation) : undefined,
-                environmentUseDefault: params.useDefault ? parameter_1.Parameter.parseBoolean(params.useDefault) : undefined,
-            };
-            (0, babylonHelper_1.changeEnvironment)(manager.scene, envDef);
-        };
-        this._parameterObservers.set(parameter_1.Parameter.ENVIRONMENT_COLOR, [handleEnvParamChange]);
-        this._parameterObservers.set(parameter_1.Parameter.ENVIRONMENT_ROTATION, [handleEnvParamChange]);
-        this._parameterObservers.set(parameter_1.Parameter.ENVIRONMENT_USEDEFAULT, [handleEnvParamChange]);
-        this._parameterObservers.set(parameter_1.Parameter.ENVIRONMENT, [handleEnvParamChange]);
-        this._parameterObservers.set(parameter_1.Parameter.ENVIRONMENT_BACKGROUND, [handleEnvParamChange]);
-        this._parameterObservers.set(parameter_1.Parameter.ENVIRONMENT_INTENSITY, [handleEnvParamChange]);
-        return this;
-    }
-    /**
-     * Bootstrapping for parameters. It sets the `parametersInitialized` to true for all ancestors.
-     */
-    bootstrapParameters(parameters) {
-        return __awaiter(this, void 0, void 0, function* () {
-            yield this.commitParameters((0, lodash_es_1.merge)((0, lodash_es_1.cloneDeep)(this.parameters), parameters));
-            return this;
-        });
-    }
-}
-exports.SceneManager = SceneManager;
+"use strict";
+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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SceneManager = void 0;
+const event_1 = require("../classes/event");
+const parameter_1 = require("../classes/parameter");
+const parameterObservable_1 = require("../classes/parameterObservable");
+const specStorage_1 = require("../store/specStorage");
+const babylonHelper_1 = require("../util/babylonHelper");
+const resourceHelper_1 = require("../util/resourceHelper");
+const textureLoadManager_1 = require("./textureLoadManager");
+const lodash_es_1 = require("lodash-es");
+class SceneManager extends parameterObservable_1.ParameterObservable {
+    /**
+     * Constructor.
+     */
+    constructor(scene) {
+        super();
+        this.scene = scene;
+        this._parameterObservers = new Map();
+        this._textureLoadManager = null;
+        this._textureLoadManager = textureLoadManager_1.TextureLoadManager.create(scene);
+        this.addParameterObservers();
+    }
+    /**
+     * Creates a {@link SceneManager} based on given BabylonJS scene.
+     */
+    static create(scene) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const sceneManager = new SceneManager(scene);
+            yield sceneManager.bootstrapParameters(specStorage_1.SpecStorage.get('scene.parameters'));
+            return sceneManager;
+        });
+    }
+    /**
+     * The active `Camera`.
+     */
+    get activeCamera() {
+        if (!this.scene.activeCamera) {
+            throw new Error('Scene has no active camera.');
+        }
+        return this.scene.activeCamera;
+    }
+    /**
+     * Places the given {@link ParameterBag} in the {@link SceneManager}'s parameters, replaces all patterns in the
+     * {@link StructureJson} and broadcasts all {@link ParameterObserver}s.
+     *
+     * @emit {@link Event.SCENE_PARAMETER_COMMITTED}
+     */
+    commitParameters(parameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!parameters) {
+                parameters = {};
+            }
+            const oldParameters = (0, lodash_es_1.cloneDeep)(this.parameters);
+            (0, lodash_es_1.merge)(this.parameters, parameters);
+            // handle parameter observers
+            let observerPromises = [];
+            for (const parameter in this.parameters) {
+                const oldParameterValue = oldParameters[parameter];
+                const newParameterValue = this.parameters[parameter];
+                this.assertParameter(parameter_1.Parameter.declarations, parameter, newParameterValue);
+                if (oldParameterValue === newParameterValue) {
+                    continue;
+                }
+                // parameter changed
+                const parameterObservers = (0, resourceHelper_1.mergeMaps)(this._parameterObservers, this.parameterObservers);
+                if (parameterObservers.has(parameter)) {
+                    const observers = parameterObservers.get(parameter);
+                    observerPromises = (0, lodash_es_1.concat)(observerPromises, observers.map(observer => {
+                        const observerResult = observer(this, oldParameterValue, newParameterValue);
+                        const observerPromise = Promise.resolve(observerResult);
+                        observerPromise.then(() => {
+                            this.broadcastEvent(event_1.Event.SCENE_PARAMETER_COMMITTED, this, parameter, oldParameterValue, newParameterValue);
+                        });
+                        return observerPromise;
+                    }));
+                }
+            }
+            yield Promise.all(observerPromises);
+            return this;
+        });
+    }
+    addParameterObservers() {
+        const handleEnvParamChange = (manager, oldValue, newValue) => {
+            const params = {
+                color: manager.parameters[parameter_1.Parameter.ENVIRONMENT_COLOR],
+                intensity: manager.parameters[parameter_1.Parameter.ENVIRONMENT_INTENSITY],
+                env: manager.parameters[parameter_1.Parameter.ENVIRONMENT],
+                background: manager.parameters[parameter_1.Parameter.ENVIRONMENT_BACKGROUND],
+                rotation: manager.parameters[parameter_1.Parameter.ENVIRONMENT_ROTATION],
+                useDefault: manager.parameters[parameter_1.Parameter.ENVIRONMENT_USEDEFAULT],
+            };
+            const envDef = {
+                environmentColor: params.color ? parameter_1.Parameter.parseColor(params.color) : undefined,
+                environmentIntensity: params.intensity !== undefined ? parameter_1.Parameter.parseNumber(params.intensity) : undefined,
+                environment: params.env ? params.env : undefined,
+                environmentBackground: params.background ? params.background : undefined,
+                environmentRotation: params.rotation !== undefined ? parameter_1.Parameter.parseNumber(params.rotation) : undefined,
+                environmentUseDefault: params.useDefault ? parameter_1.Parameter.parseBoolean(params.useDefault) : undefined,
+            };
+            (0, babylonHelper_1.changeEnvironment)(manager.scene, envDef);
+        };
+        this._parameterObservers.set(parameter_1.Parameter.ENVIRONMENT_COLOR, [handleEnvParamChange]);
+        this._parameterObservers.set(parameter_1.Parameter.ENVIRONMENT_ROTATION, [handleEnvParamChange]);
+        this._parameterObservers.set(parameter_1.Parameter.ENVIRONMENT_USEDEFAULT, [handleEnvParamChange]);
+        this._parameterObservers.set(parameter_1.Parameter.ENVIRONMENT, [handleEnvParamChange]);
+        this._parameterObservers.set(parameter_1.Parameter.ENVIRONMENT_BACKGROUND, [handleEnvParamChange]);
+        this._parameterObservers.set(parameter_1.Parameter.ENVIRONMENT_INTENSITY, [handleEnvParamChange]);
+        return this;
+    }
+    /**
+     * Bootstrapping for parameters. It sets the `parametersInitialized` to true for all ancestors.
+     */
+    bootstrapParameters(parameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.commitParameters((0, lodash_es_1.merge)((0, lodash_es_1.cloneDeep)(this.parameters), parameters));
+            return this;
+        });
+    }
+}
+exports.SceneManager = SceneManager;
 //# sourceMappingURL=sceneManager.js.map

package/dist/lib-cjs/api/manager/sceneManager.js.map

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

package/dist/lib-cjs/api/manager/textureLoadManager.d.ts

@@ -0,0 +1,22 @@
+import { EventBroadcaster } from '../classes/eventBroadcaster';
+import { Scene as BabylonScene } from '@babylonjs/core/scene';
+/**
+ * Keeps track of all texture loading/ready states and fires {@link Event.TEXTURE_LOADING_START} and
+ * {@link Event.TEXTURE_LOADING_END} events.
+ */
+export declare class TextureLoadManager extends EventBroadcaster {
+    scene: BabylonScene;
+    private readonly _loadingTextures;
+    private _readyStatePollingIntervalMs;
+    private _readyStatePollingId;
+    private constructor();
+    static create(scene: BabylonScene): TextureLoadManager;
+    private startReadyStatePollingIfNeeded;
+    private endReadyStatePollingIfNeeded;
+    /**
+     * Checks the "ready state" of all textures inside the `this._loadingTextures` map, removes the ready ones and fires
+     * the {@link Event.TEXTURE_LOADING_END} event if no more textures are loading (i.e. "not ready").
+     */
+    private checkLoadingTexturesState;
+    private onTextureAdded;
+}

package/dist/lib-cjs/api/manager/textureLoadManager.js

@@ -0,0 +1,98 @@
+"use strict";
+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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextureLoadManager = void 0;
+const event_1 = require("../classes/event");
+const eventBroadcaster_1 = require("../classes/eventBroadcaster");
+const babylonHelper_1 = require("../util/babylonHelper");
+const resourceHelper_1 = require("../util/resourceHelper");
+/**
+ * Keeps track of all texture loading/ready states and fires {@link Event.TEXTURE_LOADING_START} and
+ * {@link Event.TEXTURE_LOADING_END} events.
+ */
+class TextureLoadManager extends eventBroadcaster_1.EventBroadcaster {
+    constructor(scene) {
+        super();
+        this.scene = scene;
+        // We're keeping track of all "loading textures" in this map ourselves instead of relying on information from
+        // `scene.textures` as that proved to be rather unreliable for our use cases.
+        // E.g. see this forums post for some more information:
+        // https://forum.babylonjs.com/t/using-scene-createdefaultenvironment-removes-textures-from-scene/35267
+        this._loadingTextures = new Map();
+        // Whenever we fire the {@link Event.TEXTURE_LOADING_START} event, we're starting a polling service which checks all
+        // x ms if all awaited textures are in "ready state" or not.
+        // This is basically just an additional safety net in addition to our `onLoadObservable`s and was added to prevent
+        // situations where a {@link Event.TEXTURE_LOADING_START} event is fired without an accompanying
+        // {@link Event.TEXTURE_LOADING_EVENT} as that is a situation which can lead to load masks being endlessly shown in a
+        // cfgr.
+        // In theory this shouldn't be necessary, but we've already discovered some quirks and inconsistent behavior around
+        // the texture load observables etc. and I felt more save with this safety net in place.
+        this._readyStatePollingIntervalMs = 200;
+        this._readyStatePollingId = 0;
+        this.scene.onNewTextureAddedObservable.add(this.onTextureAdded.bind(this));
+    }
+    static create(scene) {
+        const loadMgr = new TextureLoadManager(scene);
+        return loadMgr;
+    }
+    startReadyStatePollingIfNeeded() {
+        if (!this._readyStatePollingId) {
+            this._readyStatePollingId = window.setInterval(this.checkLoadingTexturesState.bind(this), this._readyStatePollingIntervalMs);
+        }
+    }
+    endReadyStatePollingIfNeeded() {
+        if (this._readyStatePollingId) {
+            window.clearInterval(this._readyStatePollingId);
+            this._readyStatePollingId = 0;
+        }
+    }
+    /**
+     * Checks the "ready state" of all textures inside the `this._loadingTextures` map, removes the ready ones and fires
+     * the {@link Event.TEXTURE_LOADING_END} event if no more textures are loading (i.e. "not ready").
+     */
+    checkLoadingTexturesState() {
+        const allTexturesReadyBefore = !this._loadingTextures.size;
+        if (allTexturesReadyBefore)
+            return;
+        // Remove textures which are in "ready state" from the map
+        for (const [id, texture] of this._loadingTextures) {
+            if (texture.isReady())
+                this._loadingTextures.delete(id);
+        }
+        const allTexturesReadyAfter = !this._loadingTextures.size;
+        if (allTexturesReadyAfter) {
+            this.broadcastEvent(event_1.Event.TEXTURE_LOADING_END);
+            this.endReadyStatePollingIfNeeded();
+        }
+    }
+    onTextureAdded(texture) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Workaround:
+            // The texture object is not fully created when the added observable is called. E.g. the function
+            // `onLoadObservable` is not there at that point.
+            // More details: https://forum.babylonjs.com/t/basetexture-whenallready-returns-too-early/34501/4
+            yield (0, resourceHelper_1.sleep)(0);
+            // Some textures are already in "ready state" after the sleep -> We don't care for them anymore as well as for
+            // textures which don't come with an `onLoadObservable` (i.e. not of class {@link Texture}).
+            if (texture.isReady() || !(0, babylonHelper_1.isFullyInitializedTexture)(texture))
+                return;
+            const noCurrentLoadingTextures = this._loadingTextures.size <= 0;
+            if (noCurrentLoadingTextures) {
+                this.broadcastEvent(event_1.Event.TEXTURE_LOADING_START);
+                this.startReadyStatePollingIfNeeded();
+            }
+            this._loadingTextures.set(texture.uniqueId, texture);
+            texture.onLoadObservable.addOnce((texture) => this.checkLoadingTexturesState());
+        });
+    }
+}
+exports.TextureLoadManager = TextureLoadManager;
+//# sourceMappingURL=textureLoadManager.js.map

package/dist/lib-cjs/api/manager/textureLoadManager.js.map

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

package/dist/lib-cjs/api/manager/variantInstanceManager.d.ts

@@ -1,92 +1,92 @@
-import { EventBroadcaster } from '../classes/eventBroadcaster';
-import { Variant } from '../classes/variant';
-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}
- */
-export declare class VariantInstanceManager extends EventBroadcaster {
-    protected rootVariant: Variant;
-    protected variantInstancePromises: Map<string, Promise<VariantInstance>>;
-    protected variantInstances: Map<string, VariantInstance>;
-    protected variantInstanceDefinitions: Map<string, VariantInstanceDefinition>;
-    protected parameters: ParameterBag;
-    protected queues: {
-        [name: string]: Promise<VariantInstance>[];
-    };
-    /**
-     * Constructor.
-     */
-    protected constructor(rootVariant: Variant);
-    /**
-     * Creates a {@link VariantInstanceManager} based on given root Variant.
-     */
-    static create(rootVariant: Variant): Promise<VariantInstanceManager>;
-    /**
-     * Gets all instances.
-     */
-    get all(): VariantInstance[];
-    /**
-     * Gets all instance definitions.
-     */
-    get allDefinitions(): VariantInstanceDefinition[];
-    /**
-     * Checks whether a {@link VariantInstance} is either registered or created.
-     */
-    has(name: string): boolean;
-    /**
-     * 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}
-     */
-    get(name: string): Promise<VariantInstance>;
-    /**
-     * Creates and registers a unique {@link VariantInstance}.
-     *
-     * @emits {@link Event.VARIANT_INSTANCE_CREATED}
-     */
-    create(dottedPath: DottedPathArgument, name?: string, parameters?: ParameterBag): Promise<VariantInstance>;
-    /**
-     * Registers a unique {@link VariantInstanceDefinition}.
-     *
-     * @emits {@link Event.VARIANT_INSTANCE_REGISTERED}
-     */
-    register(instanceDefinition: VariantInstanceDefinition): VariantInstanceDefinition;
-    /**
-     * Commits the {@link ParameterBag} to all registered and created {@link VariantInstance}s.
-     */
-    commitParameters(parameters?: ParameterBag, onlyVisible?: boolean): Promise<VariantInstanceManager>;
-    /**
-     * 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).
-     */
-    show(name: string, exclusive?: boolean): Promise<VariantInstance>;
-    /**
-     * Clones and registers a new {@link VariantInstance} with a new, unique name.
-     *
-     * @emits {@link Event.VARIANT_INSTANCE_CLONED}
-     */
-    clone(name: string, newName: string, parameters?: ParameterBag): Promise<VariantInstance>;
-    /**
-     * Destroys the instance by removing the {@link Variant} and de-registering the instance.
-     *
-     * @emits {@link Event.VARIANT_INSTANCE_DESTROYED}
-     */
-    destroy(name: string): VariantInstanceManager;
-    /**
-     * Creates and registers a unique {@link VariantInstance} from `definition`.
-     *
-     * @emits {@link Event.VARIANT_INSTANCE_CREATED}
-     */
-    protected createFromDefinition(definition: VariantInstanceDefinition): Promise<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.
-     */
-    protected ensureUniqueName(name: string): string;
-}
+import { EventBroadcaster } from '../classes/eventBroadcaster';
+import { Variant } from '../classes/variant';
+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}
+ */
+export declare class VariantInstanceManager extends EventBroadcaster {
+    protected rootVariant: Variant;
+    protected variantInstancePromises: Map<string, Promise<VariantInstance>>;
+    protected variantInstances: Map<string, VariantInstance>;
+    protected variantInstanceDefinitions: Map<string, VariantInstanceDefinition>;
+    protected parameters: ParameterBag;
+    protected queues: {
+        [name: string]: Promise<VariantInstance>[];
+    };
+    /**
+     * Constructor.
+     */
+    protected constructor(rootVariant: Variant);
+    /**
+     * Creates a {@link VariantInstanceManager} based on given root Variant.
+     */
+    static create(rootVariant: Variant): Promise<VariantInstanceManager>;
+    /**
+     * Gets all instances.
+     */
+    get all(): VariantInstance[];
+    /**
+     * Gets all instance definitions.
+     */
+    get allDefinitions(): VariantInstanceDefinition[];
+    /**
+     * Checks whether a {@link VariantInstance} is either registered or created.
+     */
+    has(name: string): boolean;
+    /**
+     * 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}
+     */
+    get(name: string): Promise<VariantInstance>;
+    /**
+     * Creates and registers a unique {@link VariantInstance}.
+     *
+     * @emits {@link Event.VARIANT_INSTANCE_CREATED}
+     */
+    create(dottedPath: DottedPathArgument, name?: string, parameters?: ParameterBag): Promise<VariantInstance>;
+    /**
+     * Registers a unique {@link VariantInstanceDefinition}.
+     *
+     * @emits {@link Event.VARIANT_INSTANCE_REGISTERED}
+     */
+    register(instanceDefinition: VariantInstanceDefinition): VariantInstanceDefinition;
+    /**
+     * Commits the {@link ParameterBag} to all registered and created {@link VariantInstance}s.
+     */
+    commitParameters(parameters?: ParameterBag, onlyVisible?: boolean): Promise<VariantInstanceManager>;
+    /**
+     * 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).
+     */
+    show(name: string, exclusive?: boolean): Promise<VariantInstance>;
+    /**
+     * Clones and registers a new {@link VariantInstance} with a new, unique name.
+     *
+     * @emits {@link Event.VARIANT_INSTANCE_CLONED}
+     */
+    clone(name: string, newName: string, parameters?: ParameterBag): Promise<VariantInstance>;
+    /**
+     * Destroys the instance by removing the {@link Variant} and de-registering the instance.
+     *
+     * @emits {@link Event.VARIANT_INSTANCE_DESTROYED}
+     */
+    destroy(name: string): VariantInstanceManager;
+    /**
+     * Creates and registers a unique {@link VariantInstance} from `definition`.
+     *
+     * @emits {@link Event.VARIANT_INSTANCE_CREATED}
+     */
+    protected createFromDefinition(definition: VariantInstanceDefinition): Promise<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.
+     */
+    protected ensureUniqueName(name: string): string;
+}