@combeenation/3d-viewer 6.5.0 → 7.0.0-beta2

package/dist/lib-cjs/api/classes/variantParameterizable.js

@@ -1,89 +1,89 @@
-"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.VariantParameterizable = void 0;
-const dottedPath_1 = require("./../classes/dottedPath");
-const event_1 = require("./../classes/event");
-const parameterizable_1 = require("./../classes/parameterizable");
-const resourceHelper_1 = require("./../util/resourceHelper");
-const stringHelper_1 = require("./../util/stringHelper");
-const lodash_es_1 = require("lodash-es");
-class VariantParameterizable extends parameterizable_1.Parameterizable {
-    constructor(variant, name) {
-        super();
-        this.variant = variant;
-        this.name = name;
-        this._parameterObservers = new Map();
-    }
-    /**
-     * Gets the inherited parameters from the {@link Variant} with cleaned {@link Parameterizable} prefix.
-     */
-    get inheritedParameters() {
-        const parameterBag = {};
-        for (const parameter in this.variant.inheritedParameters) {
-            const dpp = dottedPath_1.DottedPath.create(parameter);
-            if (dpp.parts.length !== 1) {
-                continue;
-            }
-            parameterBag[parameter] = this.variant.inheritedParameters[parameter];
-        }
-        for (const parameter in this.variant.inheritedParameters) {
-            const dpp = dottedPath_1.DottedPath.create(parameter);
-            if (dpp.firstPart !== this.name) {
-                continue;
-            }
-            dpp.shiftPart();
-            parameterBag[dpp.path] = this.variant.inheritedParameters[parameter];
-        }
-        return parameterBag;
-    }
-    /**
-     * Places the given {@link ParameterBag} in the {@link VariantParameterizable}'s parameters, replaces all patterns in
-     * the {@link StructureJson} and broadcasts all {@link ParameterObserver}s.
-     */
-    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.variant.assertParameter(this.variant.inheritedParameterDeclaration, 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(() => {
-                            const clsName = (0, stringHelper_1.camelToSnakeCase)(this.constructor.name).toUpperCase();
-                            this.broadcastEvent((0, lodash_es_1.get)(event_1.Event, clsName + '_PARAMETER_COMMITTED'), this, parameter, oldParameterValue, newParameterValue);
-                        });
-                        return observerPromise;
-                    }));
-                }
-            }
-            yield Promise.all(observerPromises);
-            return this;
-        });
-    }
-}
-exports.VariantParameterizable = VariantParameterizable;
+"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.VariantParameterizable = void 0;
+const dottedPath_1 = require("./../classes/dottedPath");
+const event_1 = require("./../classes/event");
+const parameterizable_1 = require("./../classes/parameterizable");
+const resourceHelper_1 = require("./../util/resourceHelper");
+const stringHelper_1 = require("./../util/stringHelper");
+const lodash_es_1 = require("lodash-es");
+class VariantParameterizable extends parameterizable_1.Parameterizable {
+    constructor(variant, name) {
+        super();
+        this.variant = variant;
+        this.name = name;
+        this._parameterObservers = new Map();
+    }
+    /**
+     * Gets the inherited parameters from the {@link Variant} with cleaned {@link Parameterizable} prefix.
+     */
+    get inheritedParameters() {
+        const parameterBag = {};
+        for (const parameter in this.variant.inheritedParameters) {
+            const dpp = dottedPath_1.DottedPath.create(parameter);
+            if (dpp.parts.length !== 1) {
+                continue;
+            }
+            parameterBag[parameter] = this.variant.inheritedParameters[parameter];
+        }
+        for (const parameter in this.variant.inheritedParameters) {
+            const dpp = dottedPath_1.DottedPath.create(parameter);
+            if (dpp.firstPart !== this.name) {
+                continue;
+            }
+            dpp.shiftPart();
+            parameterBag[dpp.path] = this.variant.inheritedParameters[parameter];
+        }
+        return parameterBag;
+    }
+    /**
+     * Places the given {@link ParameterBag} in the {@link VariantParameterizable}'s parameters, replaces all patterns in
+     * the {@link StructureJson} and broadcasts all {@link ParameterObserver}s.
+     */
+    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.variant.assertParameter(this.variant.inheritedParameterDeclaration, 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(() => {
+                            const clsName = (0, stringHelper_1.camelToSnakeCase)(this.constructor.name).toUpperCase();
+                            this.broadcastEvent((0, lodash_es_1.get)(event_1.Event, clsName + '_PARAMETER_COMMITTED'), this, parameter, oldParameterValue, newParameterValue);
+                        });
+                        return observerPromise;
+                    }));
+                }
+            }
+            yield Promise.all(observerPromises);
+            return this;
+        });
+    }
+}
+exports.VariantParameterizable = VariantParameterizable;
 //# sourceMappingURL=variantParameterizable.js.map

package/dist/lib-cjs/api/classes/viewer.d.ts

@@ -1,185 +1,199 @@
-import { AnimationManager } from '../manager/animationManager';
-import { GltfExportManager } from '../manager/gltfExportManager';
-import { SceneManager } from '../manager/sceneManager';
-import { VariantInstanceManager } from '../manager/variantInstanceManager';
-import { AnimationInterface } from './animationInterface';
-import { EventBroadcaster } from './eventBroadcaster';
-import { VariantInstance } from './variantInstance';
-import { Engine } from '@babylonjs/core/Engines/engine';
-import { Mesh } from '@babylonjs/core/Meshes/mesh';
-import { Scene } from '@babylonjs/core/scene';
-/**
- * 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 declare class Viewer extends EventBroadcaster {
-    readonly canvas: HTMLCanvasElement;
-    protected structureJson: string | StructureJson;
-    protected _scene: Scene | null;
-    protected _animationManager: AnimationManager | null;
-    protected _sceneManager: SceneManager | null;
-    protected _gltfExportManager: GltfExportManager | null;
-    protected _variantInstances: VariantInstanceManager | null;
-    protected _cloneMaterialsOnMutation: boolean;
-    protected _isRenderLoopPaused: boolean;
-    protected _inspectorLoaded: boolean;
-    static version: string;
-    private static readonly _autofocusConstants;
-    /**
-     * Help function for automatically creating a valid Spec from a list of variant names and dedicated GLB/Babylon URLs.
-     * This data is most likely coming from babylon assets from the Combeenation system but other sources are also valid.
-     */
-    static generateSpec(genData: SpecGenerationData[]): StructureJson;
-    /**
-     * Constructor
-     */
-    constructor(canvas: HTMLCanvasElement, structureJson: string | StructureJson);
-    /**
-     * Gets the BabylonJS Scene that is attached to the instance.
-     *
-     * @throws Error if the `scene` has not been initialized.
-     */
-    get scene(): Scene;
-    /**
-     * Gets the {@link SceneManager} attached to the viewer.
-     *
-     * @throws Error if the {@link SceneManager} has not been initialized.
-     */
-    get sceneManager(): SceneManager;
-    /**
-     * Gets the {@link GltfExportManager} attached to the viewer.
-     *
-     * @throws Error if the {@link GltfExportManager} has not been initialized.
-     */
-    get gltfExportManager(): GltfExportManager;
-    /**
-     * Gets the BabylonJS Engine that is attached to the viewer.
-     */
-    get engine(): Engine;
-    /**
-     * Gets the {@link VariantInstanceManager} attached to the viewer.
-     *
-     * @throws Error if the {@link VariantInstanceManager} has not been initialized.
-     */
-    get variantInstances(): VariantInstanceManager;
-    /**
-     * Gets the {@link AnimationManager} attached to the viewer.
-     *
-     * @throws Error if the {@link AnimationManager} has not been initialized.
-     */
-    get animationManager(): AnimationManager;
-    /**
-     * Gets the `cloneMaterialsOnMutation` flag, as defined in the spec
-     */
-    get cloneMaterialsOnMutation(): boolean;
-    /**
-     * 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(): Promise<Viewer>;
-    /**
-     * 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?: IInspectorOptions): Promise<void>;
-    /**
-     * Destroys all registered {@link VariantInstance}s that are registered
-     */
-    destroyVariantInstances(): Viewer;
-    /**
-     * Trigger a resize event for the `Engine`
-     */
-    resize(): Viewer;
-    /**
-     * A convenience method for directly getting a Node from a {@link VariantInstance} and an {@link Element} by its
-     * {@link DottedPath}s.
-     */
-    getNode(variantInstanceName: string, elementDottedPath: DottedPathArgument, nodeDottedPath: DottedPathArgument): Promise<TransformNode>;
-    /**
-     * A convenience method for directly getting a Node from a {@link VariantInstance} and an {@link Element} by its
-     * {@link DottedPath}s.
-     */
-    getMesh(variantInstanceName: string, elementDottedPath: DottedPathArgument, meshDottedPath: DottedPathArgument): Promise<Mesh | null>;
-    /**
-     * Switches the camera
-     *
-     * @emits {@link Event.CAMERA_SWITCHED}
-     */
-    switchCamera(newCamera: string, reset?: boolean): Viewer;
-    /**
-     * Moves or animates the active camera to given `placement`.
-     */
-    moveActiveCameraTo(placement: string | PlacementDefinition, animation?: string | AnimationDefinition): Promise<AnimationInterface>;
-    /**
-     * Takes a sceenshot the the current scene. The result is a string containing a base64 encoded image
-     */
-    screenshot(settings?: ScreenshotSettings): Promise<string>;
-    /**
-     * Checks whether the browser is capable of handling XR.
-     */
-    isBrowserARCapable(): Promise<boolean>;
-    /**
-     * Calculates the bounding box from all visible meshes on the scene.
-     */
-    calculateBoundingBox(excludeGeometry?: ExcludedGeometryList): Promise<Mesh>;
-    /**
-     * Focuses the camera to see every visible mesh in scene and tries to optimize wheel precision and panning
-     */
-    autofocusActiveCamera(settings?: AutofocusSettings): Promise<void>;
-    /**
-     * Resets everything by calling {@link destroy} to clear all references and {@link bootstrap} to setup a clean
-     * environment
-     */
-    reset(): Promise<Viewer>;
-    /**
-     * Destroys
-     *
-     * * all {@link VariantInstance}s using {@link destroyVariantInstances}
-     * * calling `dispose` on the `Engine` and `Scene`
-     */
-    destroy(): Viewer;
-    /**
-     * Show coordinate system with given dimension (for debugging purpose).
-     */
-    showWorldCoordinates(dimension: number): void;
-    /**
-     * Pause render loop.
-     */
-    pauseRendering(): void;
-    /**
-     * Resume render loop when paused.
-     */
-    resumeRendering(): void;
-    /**
-     * @emits {@link Event.SCENE_PROCESSING_START}
-     * @emits {@link Event.SCENE_PROCESSING_END}
-     */
-    protected initScene(): Promise<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".
-     */
-    protected initCbnBabylonLoaderPlugin(): void;
-    /**
-     * Batch creation of multiple {@link VariantInstance} objects with a {@link SetupJson} object passed
-     */
-    protected createVariantInstances(): Promise<VariantInstance[]>;
-}
+import { AnimationManager } from '../manager/animationManager';
+import { GltfExportManager } from '../manager/gltfExportManager';
+import { SceneManager } from '../manager/sceneManager';
+import { TagManager } from '../manager/tagManager';
+import { VariantInstanceManager } from '../manager/variantInstanceManager';
+import { AnimationInterface } from './animationInterface';
+import { EventBroadcaster } from './eventBroadcaster';
+import { VariantInstance } from './variantInstance';
+import { Engine } from '@babylonjs/core/Engines/engine';
+import { Mesh } from '@babylonjs/core/Meshes/mesh';
+import { Scene } from '@babylonjs/core/scene';
+/**
+ * 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 declare class Viewer extends EventBroadcaster {
+    readonly canvas: HTMLCanvasElement;
+    protected structureJson: string | StructureJson;
+    protected _scene: Scene | null;
+    protected _animationManager: AnimationManager | null;
+    protected _sceneManager: SceneManager | null;
+    protected _tagManager: TagManager | null;
+    protected _gltfExportManager: GltfExportManager | null;
+    protected _variantInstances: VariantInstanceManager | null;
+    protected _cloneMaterialsOnMutation: boolean;
+    protected _isRenderLoopPaused: boolean;
+    protected _inspectorLoaded: boolean;
+    protected _nodeNamingStrategyHandler: NodeNamingStrategyHandler | null;
+    static version: string;
+    private static readonly _autofocusConstants;
+    /**
+     * Help function for automatically creating a valid Spec from a list of variant names and dedicated GLB/babylon URLs.
+     * This data is most likely coming from babylon assets from the Combeenation system but other sources are also valid.
+     */
+    static generateSpec(genData: SpecGenerationData[]): AutoSpecStructureJson;
+    /**
+     * Constructor
+     */
+    constructor(canvas: HTMLCanvasElement, structureJson: string | StructureJson);
+    /**
+     * Gets the Babylon.js Scene that is attached to the instance.
+     *
+     * @throws Error if the `scene` has not been initialized.
+     */
+    get scene(): Scene;
+    /**
+     * Gets the {@link SceneManager} attached to the viewer.
+     *
+     * @throws Error if the {@link SceneManager} has not been initialized.
+     */
+    get sceneManager(): SceneManager;
+    /**
+     * Gets the {@link GltfExportManager} attached to the viewer.
+     *
+     * @throws Error if the {@link GltfExportManager} has not been initialized.
+     */
+    get gltfExportManager(): GltfExportManager;
+    /**
+     * Gets the Babylon.js Engine that is attached to the viewer.
+     */
+    get engine(): Engine;
+    /**
+     * Gets the {@link VariantInstanceManager} attached to the viewer.
+     *
+     * @throws Error if the {@link VariantInstanceManager} has not been initialized.
+     */
+    get variantInstances(): VariantInstanceManager;
+    /**
+     * Gets the {@link AnimationManager} attached to the viewer.
+     *
+     * @throws Error if the {@link AnimationManager} has not been initialized.
+     */
+    get animationManager(): AnimationManager;
+    get tagManager(): TagManager;
+    /**
+     * Gets the `cloneMaterialsOnMutation` flag, as defined in the spec
+     */
+    get cloneMaterialsOnMutation(): boolean;
+    /**
+     * Gets the strategy handler for naming cloned nodes.
+     */
+    get nodeNamingStrategyHandler(): NodeNamingStrategyHandler;
+    /**
+     * Sets the strategy handler for naming cloned nodes.\
+     * Check the docs of the tag managers [renaming](https://3dviewer.docs.combeenation.com/pages/documentation/Tag-Manager.html#uniqueness-of-node-and-tag-names)
+     * chapter for further details.
+     */
+    set nodeNamingStrategyHandler(value: NodeNamingStrategyHandler);
+    /**
+     * 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(tagManagerParameterValues?: TagManagerParameterValue[]): Promise<Viewer>;
+    /**
+     * Enables the Babylon.js [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?: IInspectorOptions): Promise<void>;
+    /**
+     * Destroys all registered {@link VariantInstance}s that are registered
+     */
+    destroyVariantInstances(): Viewer;
+    /**
+     * Trigger a resize event for the `Engine`
+     */
+    resize(): Viewer;
+    /**
+     * A convenience method for directly getting a Node from a {@link VariantInstance} and an {@link Element} by its
+     * {@link DottedPath}s.
+     */
+    getNode(variantInstanceName: string, elementDottedPath: DottedPathArgument, nodeDottedPath: DottedPathArgument): Promise<TransformNode>;
+    /**
+     * A convenience method for directly getting a Node from a {@link VariantInstance} and an {@link Element} by its
+     * {@link DottedPath}s.
+     */
+    getMesh(variantInstanceName: string, elementDottedPath: DottedPathArgument, meshDottedPath: DottedPathArgument): Promise<Mesh | null>;
+    /**
+     * Switches the camera
+     *
+     * @emits {@link Event.CAMERA_SWITCHED}
+     */
+    switchCamera(newCamera: string, reset?: boolean): Viewer;
+    /**
+     * Moves or animates the active camera to given `placement`.
+     */
+    moveActiveCameraTo(placement: string | PlacementDefinition, animation?: string | AnimationDefinition): Promise<AnimationInterface>;
+    /**
+     * Takes a sceenshot the the current scene. The result is a string containing a base64 encoded image
+     */
+    screenshot(settings?: ScreenshotSettings): Promise<string>;
+    /**
+     * Checks whether the browser is capable of handling XR.
+     */
+    isBrowserARCapable(): Promise<boolean>;
+    /**
+     * Calculates the bounding box from all visible meshes on the scene.
+     */
+    calculateBoundingBox(excludeGeometry?: ExcludedGeometryList): Promise<Mesh>;
+    /**
+     * Focuses the camera to see every visible mesh in scene and tries to optimize wheel precision and panning
+     */
+    autofocusActiveCamera(settings?: AutofocusSettings): Promise<void>;
+    /**
+     * Resets everything by calling {@link destroy} to clear all references and {@link bootstrap} to setup a clean
+     * environment
+     */
+    reset(): Promise<Viewer>;
+    /**
+     * Destroys
+     *
+     * * all {@link VariantInstance}s using {@link destroyVariantInstances}
+     * * calling `dispose` on the `Engine` and `Scene`
+     */
+    destroy(): Viewer;
+    /**
+     * Show coordinate system with given dimension (for debugging purpose).
+     */
+    showWorldCoordinates(dimension: number): void;
+    /**
+     * Pause render loop.
+     */
+    pauseRendering(): void;
+    /**
+     * Resume render loop when paused.
+     */
+    resumeRendering(): void;
+    /**
+     * @emits {@link Event.SCENE_PROCESSING_START}
+     * @emits {@link Event.SCENE_PROCESSING_END}
+     */
+    protected initScene(): Promise<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".
+     */
+    protected initCbnBabylonLoaderPlugin(): void;
+    /**
+     * Batch creation of multiple {@link VariantInstance} objects with a {@link SetupJson} object passed
+     */
+    protected createVariantInstances(): Promise<VariantInstance[]>;
+}